IBM Engineering Lifecycle Management version 7.0.1 Installation and Upgrade Notes

Note: The following changes are related to installation and upgrade procedures. Other changes and fixes are not included.

Installation notes


Upgrade notes


Installation notes

Description
Administering Configuring authentication session timeout

To control the authentication timeout behavior, you must set multiple configuration options in your application server and the ELM applications that you have installed. For details, see Configuring authentication session timeout.
All applications Adding a new application to an existing Jazz Team Server

You can use the Interactive Guide to add one or more applications to an existing Jazz Team Server. You can use the Jazz Team Server administration web UI or the registerApp repository tools command to register new applications. Using the Jazz Team Server administration web UI is the most common method of registering new applications with an existing Jazz Team Server. After you register a new application, if applicable, a link to the setup wizard page in the message box will be provided. Click this link to go to the setup wizard page to configure the application registration such as the database connections and so on. For details, see Add new applications to an existing Jazz Team Server Interactive Guide.
Renaming the IBM Continuous Engineering Portfolio

The CE/CLM products were renamed in version 7.0. For details on the name change, read this blog.

Note: To avoid breaking the products, URLs, context roots, application war files, configuration directories, script file names, or error codes did not change.
Launchpad program updates
In this release, the Launchpad program has been redesigned as follows:
  • The server Evaluation Installation and Custom Installation sections contain updated guidance on planning installations for multiple server topologies.
  • A section has been added for the Document Builder application.
  • A section has been added for the Distributed Cache Microservice application.
  • A section has been added to help users find additional download content (.zip files and other non-Installation Manager artifacts) for several ELM products.
  • The version of Installation Manager bundled with the launchpad in the ELM web installer has been updated from 1.8.x to 1.9.1.2.
Clustering Quality Management clustered environment

Now you can set up a clustered environment to host a Jazz Team Server and multiple Quality Management (QM) WebSphere Liberty nodes. For details and installation instructions, see the Interactive Installation Guide.
Link Index Provider Installing LDX on a dedicated server

Starting in version 7.x, the Link Index Provider application can be installed on its own dedicated server. For details, see this Deployment wiki document.
Oracle database Troubleshooting Oracle password requirements

If during the Jazz Team Server setup wizard you encounter the error SQLSTATE: 99999, SQLCODE: 17067, you might have Oracle database password issues.

Oracle password complexity policy requires that passwords have minimum of 12 characters in length. In addition, the password must contain at least one uppercase character, one lowercase character, and one digit. If your password contains special characters, multibyte characters, or starts with numbers or special characters, you must enclose it in double quotation marks. For details, see the Oracle documentation.
Reporting Document Builder now available as an optional install

Document Builder, which previously was only available by installing IBM Engineering Lifecycle Optimization - Publishing (PUB), is now available to install as part of the IBM Engineering Lifecycle Management launchpad. If you use PUB to create customized printable documents, you can generate documents from Document Builder. See information about architecturedeployingtutorialsadministering, and generating documents.

Note: If you are deploying Document Builder along with IBM Engineering Lifecycle Management, Document Builder must be deployed on a separate application server profile from ELM. See this technote for details.
Rhapsody Model Manager Architecture Management Extension for Change and Configuration Management

The IBM Engineering Systems Design Rhapsody - Model Manager application is shipped as an extension to the Change and Configuration Management application. The extension can be installed in two deployment modes: Model Management Server and Model and Code Management Server. To understand the difference between these two modes as well as to define a list of required licenses, see Client access license management. The extension must be installed together with the Change and Configuration Management application when any deployment mode is selected, or on top of the previously installed instance of this application in the Model and Code Management Server mode only. Make sure the Change and Configuration Management application and the Architecture Management extension are at the same version.


Upgrade notes

Description
All applications Base paths are not included in the commands generated by the interactive upgrade guide

The upgrade commands that are generated by the interactive upgrade guide do not always correctly include the base paths that the user enters. This affects all applications. For example, if you select JTS and RM as the applications to upgrade, you must enter the full path of the previous installation directory and new installation directory in the following fields:

  Previous JTS installation location
  Previous RM installation location

  JTS version 7.x installation location
  RM version 7.x installation location

The base paths might not be included in the commands generated by the interactive upgrade guide.
In the preceding example, when you enter the base paths, the upgrade commands are generated similar to the following:

JTS upgrade command
cd \server
upgrade\jts\jts_upgrade.bat -oldJTSHome "\server\conf" -noPrompt -noVerify -noStepPrompt -noEditor -noResumePrompt


Note that in the line, cd \server, the path is not prefixed with the value entered for JTS version 7.x installation location.
Also, note that the -oldJTSHome value is not prefixed with the path entered for Previous JTS installation location.

RM upgrade command
cd \server
upgrade\rm\rm_upgrade.bat -oldApplicationHome "\server\conf" -newJTSHome "\server\conf" -noPrompt -noVerify -noStepPrompt -noEditor -noResumePrompt


Note that in the line, cd \server, the path is not prefixed with the value entered for RM version 7.x installation location.
Also, note that the -oldApplicationHome value is not prefixed with the path entered for Previous RM installation location.

If the generated interactive guide does not include the full paths in the commands, make sure you modify the paths for the commands to work correctly when you perform the upgrade.
Upgrade order

The upgrade order for an ELM solution is Jazz Team Server first followed by the Global Configuration Management application, and then other applications. The reason for this order is that the GC SDK which is bundled with the other applications, makes calls to the GCM server. If the GCM server is not newer or at the same level as the other applications, these calls could fail.
Upgrading from version 5.x

Upgrading to version 7.x is only supported from a version 6 release. Upgrading from a version 5 release to version 7.x, is a two-step process. You must first upgrade your server to the latest fix pack of the version 6 release, start the server, ensure that the version 6 upgrade was successful, and then upgrade to version 7.x.

For instructions on upgrading from a version 5 release to the latest version 6 release, see the latest version 6 documentation.
Full-text search indexes must be rebuilt when you upgrade from 6.0.6.1 or earlier

Full-text search indexes must be rebuilt for both the ELM servers and the IBM Engineering Workflow Management Client for Eclipse IDE.

Typically, when you upgrade an installation by using the upgrade scripts, the full-text search indexes from the earlier installation are copied to the new installation. However, the upgrade scripts in 7.0 and later do not copy previous indexes from version 6.0.6.1 or earlier (including interim fixes). Instead, the new server automatically rebuilds the indexes in the background after you start it. Results of full-text searches might be incomplete until the reindexing operation is finished; the progress of the reindex is periodically written to the server log file.

Alternatively, instead of allowing the server to rebuild full-text search indexes online, you can rebuild them manually by running the repotools-<app> -rebuildTextIndices command after the upgrade is complete, but before you start the server, where <app> is one of am, ccm, or qm. Note that reindexing might be a lengthy process and can take many hours for a large database. In the web client, a system alert in the banner states that reindexing is in progress.

If you follow a manual upgrade procedure instead of running the upgrade scripts, you must ensure that the full-text indexes are not copied from the old installation to the new installation. If the new installation is configured to use the same full-text index location as the old installation (the value of the com.ibm.team.fulltext.indexLocation property in the old and new teamserver.properties file is the same absolute path name), you must either run the repotools-<app> -rebuildTextIndices command before you start the server, or delete the contents of the folder at that location before you start the server. You might want to preserve the old contents if you decide to abandon the upgrade and roll back to the previous release.

If an application is clustered, the offline reindexing procedure (using repotools) or the online procedure (ensuring that the full-text index folder is empty before starting the server) must be performed on each node in the cluster.

The IBM Engineering Workflow Management Client for Eclipse maintains a local full-text search index for the Team Artifact History view. When you upgrade the IBM Engineering Workflow Management Client for Eclipse to version 6.0.6.1 or later, the full-text search index is automatically deleted, which means the artifact history is cleared and will accumulate artifacts again after the upgrade.

For ELM servers, complete one of these steps:
  • For online background indexing, no action is required except to ensure that the full-text index folder is empty before you start the server
  • For offline indexing before you start the server, run the appropriate repotools-<app> -rebuildTextIndices command.
Apache Tomcat Apache Tomcat is not supported

Starting in version 6.0.1, Apache Tomcat was replaced by WebSphere Liberty as the default application server. In version 7.x, to migrate your Apache Tomcat to WebSphere Liberty, see the Interactive Upgrade Guide.
 
Jazz Authorization Server Upgrading Jazz Authorization Server when used in a cluster environment

The Interactive Upgrade Guide in version 7.0.1 includes steps to upgrade the Jazz Authorization Server when used in a Change and Configuration Management or Quality Management cluster environment. For details, see the Interactive Upgrade Guide.
Jazz Reporting Service The Reporting applications must be at the same level as Jazz Team Server

If you upgrade Jazz Team Server to version 7.0.1 at this time and leave the Reporting applications at previous version, the Jazz Reporting Service will not work until it is upgraded to the same level as Jazz Team Server.
Licensing New licenses are required in version 7.0.1

You must obtain new licenses for version 7.x applications if you are upgrading from any release of version 6. Version 7.x applications do not work with version 6.x licenses. However, version 6.x applications work with version 7.x licenses. For details, see the Interactive Upgrade Guide.
Microsoft SQL Server database Resolving the CRJAZ1431E error message

If during the upgrade you encounter the following error message: CRJAZ1431E - The model COMPONENT_ID_IDX was illegally changed to be unique, you can use the SQL Server Management Studio to resolve the issue.
  1. Log into SQL Server Management Studio.
  2. Set the indices property to Unique for both VVCMODEL_CHANGE_SET_ID_IDX and VVC_MODEL_COMPONENT_ID_IDX.
Quality Management Run the repository tools command to repair queryable tables

The CleanupUnreferencedCollectionRecordsAsyncTask can cause unintended deletion of rows from certain internal database tables resulting in the data not being displayed in some artifact section views. The CleanupUnreferencedCollectionRecordsAsyncTask is designed to remove rows that are no longer referenced from certain internal database tables. However, some rows that are still referenced might be incorrectly deleted. Though the rows are deleted, data is still available in the database and can be restored by using the repairQueryableTables command. For details, see Repository tools command to recreate incorrectly removed queryable table data.
Rational Rhapsody Design Manager End of support

Starting in version 7.x, the Rational Rhapsody Design Manager application is no longer delivered. However, you can keep your current Rational Rhapsody Design Manager version 6.0.6.1 in an upgraded ELM version 7.x. If you wish to keep your Rational Rhapsody Design Manager version 6.0.6.1 in your IBM Engineering Lifecycle Management version 7.x environment, read this article.
Requirements Management Disable the CleanupUnusedIndexesVersionsTask

There is an issue with this task in the Requirements Management application that will be addressed in a future release. As a result, this task must be disabled in version 7.x. For details on how to disable this task, see the Interactive Upgrade Guide.
Lifecycle Query Engine data sources must be reindexed when upgrading from any 6.x release

If you use Lifecycle Query Engine, you must reindex your Requirements Management application after the upgrade. All other applications do not require reindexing in this release. For details, see the Interactive Upgrade Guide.
Check the minimum client compatibility version

When you upgrade Requirements Management application and select the Upgrade script as the upgrade method, after the configuration files are merged, an editor opens where you can check the Requirements Management teamserver.properties file. Note that first the Jazz Team Server teamserver.properties file opens, then the application teamserver.properties opens for review. If the com.ibm.team.repository.minimumClientCompatibilityVersion property exists in the teamserver.properties file, review if the value is a supported version. If it is not a supported version, update the value or delete the entire property.
The upgrade is only supported from 6.0.2 and later

The Requirements Management application upgrade is only supported from version 6.0.2 and later. If your current Requirements Management application is at a different version, you must first upgrade to one of these supported versions and apply the latest interim fix for that version, before you can upgrade to version 7.x.
Run the -repairVersionsWithIdenticalTimestamp repotools command

If you are upgrading from release 7.0 to 7.0.1, you must apply the latest available 7.0 iFix before running the repair tool (repairVersionsWithIdenticalTimestamp) command.
If you used the Configuration Management feature of the IBM Engineering Requirements Management - DOORS Next application or the IBM Engineering Test Management application prior to version 7.x, there might be more than one version of an artifact in a configuration with the same timestamp. This could lead to ambiguity when determining the correct version of an artifact in a baseline.
Before you upgrade to version 7.x, run the repotools -repairVersionsWithIdenticalTimestamp command for each application.
For more details, see Repository tools command to repair versions with identical timestamps.
Rhapsody Model Manager Updating license keys

The Systems and Software Engineer license enables configuration management operations on your models in the Model Management Server deployment mode. Alternatively, if the Model and Code Management Server deployment mode is used, you are entitled to perform configuration management operations on both your models and code. To use the Model and Code Management Server deployment mode, Developer role is required in addition to the Systems and Software Engineer role. The Systems and Software Engineer license must be updated for use with 7.0.1. If you plan to use Engineering Rhapsody Design Manager 6.0.6.1 with applications from IBM Engineering Lifecycle Management 7.x, the license keys for Engineering Rhapsody Design Manager must be updated. See Working with Rhapsody Design Management 6.0.6.1 in Engineering Lifecycle Management 7.x for more information.
Upgrading from 6.x to 7.x Extension for CCM

In version 7.x, the IBM Engineering Systems Design Rhapsody - Model Manager application is removed from the solution as a standalone application and is replaced by an extension to the Change and Configuration Management application.

If your previous RMM application was installed on the same server as the CCM application, you must use server rename to move one of the applications to a new location before you can upgrade. See the Interactive Upgrade Guide for details.
Improving the Rhapsody Model Manager application upgrade performance and execution

If you have an AM application repository with a large number of artifacts, you can reduce the server downtime during migration by running the database migration tasks, while keeping the existing server active. See the Interactive Upgrade Guide for details.

WebSphere Application Server The required version of WebSphere Application Server is 9 (9.0.5 recommended)

In this release, the supported version of WebSphere Application Server is version 9. If you are using the traditional WebSphere Application Server rather than WebSphere Liberty installed by IBM Engineering Lifecycle Management, you must first upgrade your WebSphere Application Server to version 9, and then upgrade Jazz Team Server and ELM applications. For migrating WebSphere Application Server, see the WebSphere Application Server documentation. However, it is recommended to move to WebSphere Liberty server.

© Copyright IBM Corporation 2020  |  Contact  |  Privacy Policy  |  Terms of Use