Question & Answer
Question
Which files do you preserved before you upgrade the software to a new version?
Cause
You are planning to upgrade one or more of the following products:
- IBM Rational Integration Tester (RIT)
- IBM Rational Test Control Panel (RTCP)
- IBM Rational Integration Tester Agent (RIT-Agent)
- Intercept Agents such as HTTP Proxy or IBM WebSphere MQ Exit
You need to preserve any configuration and customizations you made to your existing versions.
Often the upgrade procedure is to reinstall. Even an update procedure overwrites configuration files.
Answer
Always refer to the IBM Knowledge Centers at the start of upgrade planning.
A good place to start is the IBM Fix List
The Fix List contains a list of issues that are fixed in the various versions of the product. It also contains links to the Download documents and the What's New section of the IBM Knowledge Center.
General Notes
The upgrade process might require reinstallation of the programs due to major internal code changes.
Do not attempt to mix versions of program.
The release testing process is performed with programs of the same version.
You might find that program A version 9.5 works with program B version 10.0, but the combination was not tested and is not supported.
Check the following technote to verify your results database schema version is suitable: RIT project database schema versions
Some features might be changed or deprecated.
Install the new version on a test server and verify that you can run your tests and virtual services satisfactorily.
Do not copy saved configuration files over new ones.
New files might contain extra or changed sections and parameters that would be lost.
Use a text editor to review the old and new files and make appropriate changes.
RIT
RIT customization is performed by running Library Manager. Library manager is used to configure third-party libraries and options such as memory and network port allocation.
Library Manager saves its configuration to the file librarysettings.xml in the RIT installation folder.
It also updates various INI files in the same location.
Another copy of librarysettings.xml is saved to your home directory at: <user profile>/.integrationtester
Save:
- <RIT installation>/librarysettings.xml or <user profile>/.integrationtester
- Copies of third-party library JAR files that you copied to the RIT installation folders.
When you upgrade or reinstall RIT, run Library Manager and click OK to save the changes.
If the user profile copy of librarysettings.xml is available, Library Manager reads it and displays the previously selected options.
The settings might look correct, but the files in the RIT installation are only updated when you click OK.
Ensure you have librarysettings.xml in <user profile>/.integrationtester before you start the upgrade or reinstallation.
Newer versions of RIT work with projects that were created in older versions.
Read the Release Notes to see whether behavior is changed, or features are removed.
Do not modify a project in a newer version of RIT and later open it in the older version. The newer version might make changes to the project that are not understood.
Keep backups of RIT projects before you modify them in the new version.
RIT-Agent
RIT-Agent customization also uses Library Manager.
Refer to the RIT section.
RIT-Agent has further configuration options in Agent.config.
Save:
- <RIT-Agent installation>/config/Agent.config
- <RIT-Agent installation>/agent-logging-properties
- <RIT-Agent installation>/logs (optional)
Note: logging configuration changed in version 9.2.1. Older logging configuration files are no longer relevant.
Newer versions of RIT-Agent work with projects that were created in older versions.
Read the Release Notes to see whether behavior is changed, or features are removed.
RTCP
The RTCP workspace is preserved by default during uninstall or upgrade.
The workspace contains all published stubs and RTCP login details. It also contains stub execution statistics.
Save the workspace before you install the new version.
Location on Windows® typically: C:\IBM\RTCP-Workspace
On non-Windows typically: /var/ibm/rtcp-workspace
If you are unsure where your workspace resides, refer to this technote: How to relocate the Rational Test Control Panel workspace
A new version of RTCP upgrades the workspace metadata.
You cannot downgrade the workspace. If you need to downgrade RTCP, reinstate the saved workspace before you start the program.
Also save:
- <RTCP installation>/config/server.custom.xml
- JDBC drivers you added to enable RTCP access to results databases.
- <RTCP installation>/logs (optional)
- Java™ keystore when using your own server certificate
HTTP Proxy
The HTTP Proxy is installed as part of RTCP in the httptcp subfolder.
The main Proxy configuration is in registration.xml.
Save:
- <RTCP installation>/httptcp/registration.xml
- <RTCP installation>/httptcp/proxy-logging.properties
- Java keystores that you added or customized with your own HTTPS certificates.
Note: logging configuration changed in version 9.2.1. Older logging configuration files are no longer relevant.
Intercept Agents
There are various technology intercept agents supplied in the Tools section of RTCP.
For example, JDBC Proxy, Java Agent and IBM WebSphere MQ Exit.
For example, JDBC Proxy, Java Agent and IBM WebSphere MQ Exit.
Upgrade these programs to the same version as RIT/RTCP/RIT-Agent.
The software release testing process is always performed with programs of the same version.
Read the IBM Knowledge Center on each intercept you are using.
The configuration file locations depend on your individual installation.
Often, the main configuration to preserve is registration.xml.
[{"Business Unit":{"code":"BU053","label":"Cloud & Data Platform"},"Product":{"code":"SSBLQQ","label":"IBM Rational Test Workbench"},"Component":"Rational Integration Tester;Rational Test Control Panel","Platform":[{"code":"PF016","label":"Linux"},{"code":"PF033","label":"Windows"}],"Version":"All Versions","Edition":"","Line of Business":{"code":"LOB45","label":"Automation"}},{"Business Unit":{"code":"BU053","label":"Cloud & Data Platform"},"Product":{"code":"SSBLXN","label":"Rational Test Virtualization Server"},"Component":"Rational Test Control Panel;Rational Integration Tester Agent","Platform":[{"code":"PF016","label":"Linux"},{"code":"PF033","label":"Windows"}],"Version":"All Versions","Edition":"","Line of Business":{"code":"LOB45","label":"Automation"}}]
Was this topic helpful?
Document Information
Modified date:
02 March 2020
UID
ibm12801085