Versions Compared

Version Old Version 5 New Version 6
Changes made by

Sudhir Kv

Sudhir Kv

Saved on

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

Problem

After transferring a project using Configuration Manager for Jira (CMJ), users have observed that epic names appear unlabelled, disrupting project tracking and management.

Symptoms

  1. Epic names display correctly in the source Jira instance but appear unlabelled in the target instance after migration.

  2. The issue occurs irrespective of the language of the epic names, affecting both English and Korean labels.

  3. The problem persists even after multiple migrations.

Root Cause Analysis

The root cause was identified through detailed logs and user reports:

  • The source Jira instance uses default field names for epic, epic name, and epic link.

  • The target Jira instance uses custom field names in Korean (e.g., 에픽, 에픽의 이름, 에픽 연결).

  • The discrepancy in field names between source and target instances leads to unlabelled epic names post-migration.

Resolution

To resolve the issue, the following steps are recommended:

  1. Verify Jira and CMJ Versions
    Ensure that both source and target Jira instances have the same versions.

    • Source Jira Version: 9.4.14

    • Target Jira Version: 9.4.14

    • CMJ Version: 6.15.3

  2. Collect Support Logs
    Navigate to the "Logging and Profiling" section in Jira Administration, configure `com.botronsoft` to the DEBUG level, and perform the project migration to collect relevant logs.

  3. Review Audit Logs
    Follow instructions from [Configuration Manager for Jira Audit Logging](https://appfire.atlassian.net/wiki/spaces/CMJ/pages/198246829/Audit+Logging#Audit-Log-Details ) to obtain detailed audit logs.

  4. Execute Database Queries
    Run these SQL queries on both source and target databases to verify epic labels and colors:

    Code Block
    languagesql
    SELECT * FROM customfield;

SELECT * FROM customfieldvalue

WHERE customfield = ANY (

SELECT id FROM customfield

WHERE customfieldtypekey LIKE 'com.pyxis.greenhopper.jira:gh-epic-label'

OR customfieldtypekey LIKE 'com.pyxis.greenhopper.jira:gh-epic-color'

);

  5. Manual Field Updates
    Update the epic name values in the target instance by copying them into the appropriate custom fields (e.g., 에픽의 이름).

  6. Replicate and Analyze
    Perform the migration in a controlled environment and analyze the behavior. This includes setting up conditions similar to those in the production environment to replicate the issue accurately.

Example Screenshots Before and After Deployment

Here are example screenshots illustrating the issue and its resolution:

...