How to relocate the Rational Test Control Panel workspace

Technote (FAQ)


Question

How do you move the IBM Rational Test Control Panel (RTCP) workspace area?

Cause

  • You have installed Rational Test Control Panel on a server.
  • You wish to know where the workspace is stored, where the deployed projects are located.
  • You need to relocate the workspace files to a new location where there is more free storage.
  • Installation Manager modifying Rational Test Control Panel updates an incorrect security.config file.

Answer

1. Stop Installation Manager, if running.

2. The locations that Installation Manager updates are saved in the following files:

On Windows:
drive\Program Data\IBM\Installation Manager\installRegistry.xml
drive\Program Data\IBM\Installation Manager\installed.xml

On non-Windows:
var/ibm/Installation Manager/installRegistry.xml
var/ibm/Installation Manager/installed.xml

Ensure that you have a backup of these files.

3. Find and replace all the occurrences of the workspace location and save the files.

4. Stop the Rational Test Control Panel process or service.

On all Windows systems, stop the service IBM Rational Test Control Panel.
On non-Windows systems, run bin/shutdown.sh or consult your system administrator.

5. Locate the container.server.properties file in the classes folder under the Rational Test Control Panel installation directory.

For versions 8.5.1.0 and newer

On Windows systems, the file is typically found at:
C:\Program Files\IBM\RationalTestControlPanel\usr\servers\RTCPServer\apps\RTCP.war\WEB-INF\classes

On non-Windows systems, the file is typically found at:
/opt/IBM/RationalTestControlPanel/usr/servers/RTCPServer/apps/RTCP.war/WEB-INF/classes

For versions before 8.5.1.0

On Windows systems, the file is typically found at:
C:\Program Files\IBM\RationalTestControlPanel\webapps\RTCP\WEB-INF\classes

On non-Windows systems, the file is typically found at:
/opt/IBM/RationalTestControlPanel/webapps/RTCP/WEB-INF/classes

6. Edit container.server.properties and modify the value of workingDirectory as required.

For example, on Windows systems: workingDirectory=C\:\\IBM\\RTCP-Workspace
For example, on non-Windows systems: workingDirectory=/var/rtcp

7. Move the workspace files to the new location.

8. Restart the Rational Test Control Panel process or service.

On non-Windows systems, run bin/startup.sh or consult your system administrator.
On Windows systems, start the service IBM Rational Test Control Panel.

9. Restart Installation Manager.



NOTES

Alternatively, you can stop the Rational Test Control Panel process or service, move the workspace to a new location, create a symbolic link from the original folder to point to the new folder, and then restart Rational Test Control Panel. Consult your system administrator for assistance.

Document information


More support for:

Rational Test Workbench
Rational Test Control Panel

Software version:

8.0, 8.5, 8.6, 8.7, 9.0

Operating system(s):

AIX, Linux, Solaris, Windows

Reference #:

1648258

Modified date:

2016-04-20

Translate my page

Content navigation