Task 3: Upgrade QC Integration Configuration

1. Go back to PPM, check that background service QC Integration Migration Service is up.

2. On the Integration Configurations Summary page, click the Upgrade icon for the QC integration configuration entry you want to upgrade.

   The QC username and password dialog opens.

3. Provide values for the QC/ALM Username and QC/ALM Password fields.

4. Click Verify QC/ALM Connection.

   Wait for the verification to complete, and click OK when the verification success prompt pops up.

5. Click OK in the QC/ALM username and password dialog.

   The Configure QC/ALM Integration for Request Type section for upgrade purpose appears.

   For sample tab pages for requirement request type or defect request type, see Configuring Integration with ALM 11.00 and Later.

6. Check and reconfigure field mappings if necessary.

   By default, the Configure QC/ALM Integration for Request Type section loads all settings from the old configuration automatically, including all field mappings.

   On the Step 2: Map PPM—QC/ALM Fields tab page, a Map Values button in the Current Field Mappings table indicates that this mapping contains mappings of multi-value fields or drop-down list fields. Click Map Values to open the Map Values dialog, check and make sure the mappings and directions between QC/ALM Values and the PPM Values are correct.

7. Click OK to save your changes and close the Map Values dialog.

8. Click Next on the Step 2: Map PPM—QC/ALM Fields tab page.

9. Click Save or Save & Migrate.

   If you click Save & Migrate, the Configure QC/ALM Integration for Request Type section jumps back to the Step 1: Configure Server Details tab page.

   Wait for the saving and migration process to complete. The Migration Status line disappears when all records are successfully migrated and all previously editable fields become read-only. In average it takes around one minute to migrate 1,000 records.

   When the Migration Status line disappears, move to the Step 3: Complete Configuration tab page, the Cancel button to the right end changes to Done (during the migration, the button changed to Back).

10. Click Done.

    The Integration Configurations page refreshes.

    Now the status for the integration configuration you just upgraded already changed. By default, the migrated integration is Disabled.

11. You can now click the Disabled icon to enable the integration configuration that you just successfully migrated.

    Tip: For a migrated integration configuration, clicking the Delete icon removes the new integration configuration only. The original integration configuration still exists.

12. After you have successfully upgraded all integration configurations with QC 10 to with ALM 11.x, make sure you comment out the following line from the server.conf file:

    com.kintana.core.server.ENABLE_QUALITY_CENTER_INTEGRATION=true

    The ENABLE_QUALITY_CENTER_INTEGRATION parameter is not needed anymore after you upgrade the integration configuration to ALM 11.x.

13. Go to PPM database, you should find some new records in the PPM_INT_QC_ENTITY_MAP table.