Workarounds: Lifecycle Project Administration problems in Jazz Foundation 4.0.1

David Murray
Last Updated: March 1, 2013
Build Basis: Rational Jazz Foundation 4.0.1

Problem Summary

After the Requirements Management (RM) application is upgraded to version 4.0.1, the Base project template cannot be used to create the Requirements project for a lifecycle project.

Problem

This problem occurs in applications of the Rational solution for Collaborative Lifecycle Management (CLM) that were upgraded from version 4.0 to version 4.0.1. When you create a lifecycle project in the Lifecycle Project Administration (LPA) application, you can select a project template for the Requirements project. If you select the Base project template, the lifecycle project cannot be created, and this error is displayed: Error instantiating the template: CRJCA0003E. The details of the error message state that a project template with the “Base” ID does not exist.

Workaround

This issue occurs because the Base project template is renamed in version 4.0.1. However, lifecycle project templates are persisted in the database for Jazz Team Server, and a predefined set of templates were imported when the LPA application was set up, before version 4.0.1. Therefore, the Base project template is still listed as an available template, even though it was renamed in version 4.0.1.

If you did not make changes to the set of predefined lifecycle project templates, in the LPA application, go to the Templates page and click Deploy Predefined Templates. When you create a lifecycle project by using one of the predefined templates, the Requirements Template for Testers template is in the list of project templates. That template is equivalent to the Base template.

If you wrote custom lifecycle project templates that refer to the Base project template, update the custom templates to refer to a different project template, such as the Requirements Template for Testers template. To update a lifecycle project template, complete these steps:

1. In the LPA application, go to the Templates page.
2. Hover over a template and click the Download icon. Save the XML file for the template to your computer.
3. Open the file in a text or XML editor, and look for a projectTemplate element whose child dc:identifier has “Base” as its text content.
4. Change both the dc:identifier and dc:title to a different value, or if other project templates are available, delete the projectTemplate element.
5. On the Templates page, for the template that you downloaded, click the Delete icon.
6. Click Import Template and select the XML file that you modified.

Related Information

The following links point to related information:

• Work Item 215689
• Work Item 51730

Problem Summary

After you upgrade the Rational solution for Collaborative Lifecycle Management (CLM) applications from a release of version 3.0 to version 4.0 or later, you cannot create the Money That Matters sample

Problem

This situation affects CLM applications that were upgraded from a release of version 3.0 to version 4.0 or later. After the upgrade, the Lifecycle Project Administration (LPA) application fails to create the Money That Matters sample. The failure differs depending on whether the sample application was created in a release of version 3.0:

• If the sample was created in a release of version 3.0, the failure occurs in the “Creating sample artifacts in /ccm” step. The error message includes this text: CRJCA0003E The Lifecycle Project Administration (LPA) application made a request that was answered by an unexpected response code. The request was: https://.../ccm/clmSampleProject. The response was: HTTP/1.1 400 Bad Request. In addition, the ccm.log file includes this entry: ERROR com.ibm.team.calm.foundation.sample with a java.lang.NullPointerException in com.ibm.team.workitem.common.internal.model.impl.WorkItemImpl.hasBuiltInAttribute.
• If the sample was not created in a release of version 3.0, the failure occurs in the “Creating sample artifacts in /qm” step. The error message includes this text: CRJCA0003E The Lifecycle Project Administration (LPA) application made a request that was answered by an unexpected response code. The request was: https://.../qm/clmSampleProject. The response was: HTTP/1.1 400 Bad Request. In addition, the qm.log file indicates that permission to save a test case execution record was denied.

Workaround

If the sample was created in a release of version 3.0, you must modify the process templates for the Change and Configuration Management (CCM) and Quality Management (QM) applications so that updated versions of those templates are imported for the version 4.0 or later sample. For each of the applications, complete these steps:

1. Go to the administration page for the application.
   • For the CCM application, go to https://server:port/ccm/admin or https://server:port/jazz/admin.
   • For the QM application, go to https://server:port/qm/admin.
2. Click the Templates tab.
3. Hover over the Money That Matters Sample Process row and click the edit icon.
4. Modify the ID of the template. For example, add .v3 to the end of the template. Then, click Save. Any project areas that were created by using the sample process templates will not be affected by the change to the template ID.

Whether or not the sample was created in a release of version 3.0, to create the sample in version 4.0 or later, you must redeploy the predefined lifecycle project templates for the LPA application:

1. Open the LPA application at https://server:port/admin.
2. Click the Templates tab.
3. If you modified any of the predefined lifecycle project templates and retained their identifiers, download the templates that were customized as a backup. If you did not customize templates, or if you changed the identifier of your customized templates, skip this step.
4. Click Deploy Pre-defined Templates.
5. If you downloaded any customized templates, delete the corresponding predefined templates and then import the downloaded templates. Any lifecycle projects that were created by using the lifecycle project templates will not be affected by redeploying the predefined templates.

Because the lifecycle project templates that are used to create the sample are not listed on the Templates page, you will not notice a change in the list of templates. However, you can now create the sample. If the sample was created in a release of version 3.0, on the Sample page where you create the Money That Matters sample, select Optionally, customize the sample project area names.

Related Information

The following links point to related information:

• Work Item 240793