Question & Answer
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
The recommended method is to stop RTCP, move the workspace, and re-install RTCP pointing to the new location. If this is not possible, see the following instructions.
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 9.2 and newer
On Windows systems, the file is typically found at:
C:\Program Files\IBM\RationalTestControlPanel\usr\servers\defaultServer\apps\RTCP.war\WEB-INF\classes
On non-Windows systems, the file is typically found at:
/opt/IBM/RationalTestControlPanel/usr/servers/defaultServer/apps/RTCP.war/WEB-INF/classes
For versions 8.5.1.0 to 9.1
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.
For versions 9.1.0 and newer an additional step is required.
This version introduced stub usage which is implemented using KairosDB.
Locate the file <RTCP install>/usr/servers/RTCPServer/server.generated.xml and edit the entries that define the location:
<jndiEntry id="kairosdb/datastore/h2/database_path" jndiName="kairosdb/datastore/h2/database_path" value=""D:/IBM/RTCPWorkspace911/kairosdb/h2db""/>
<jndiEntry jndiName="reports/user/dir" value=""D:/IBM/RTCPWorkspace911/results""/>
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.
Was this topic helpful?
Document Information
Modified date:
29 September 2018
UID
swg21648258