IBM Support

IBM DevOps Test Virtualization – Configuration Files Backup Guide

General Page

On IBM DevOps Test Virtualization (formerly IBM Rational Test Virtualization Server), you may need to back up configuration files for migration or upgrade purposes. This document outlines the configuration files that should be backed up.

IBM DevOps Test Virtualization consists of three components:

  1. DevOps Test Virtualization Control Panel (RTCP)
    (formerly Rational Test Control Panel)
  2. DevOps Test Integrations and APIs Proxy (RIT Proxy)
    (formerly Rational Integration Tester Proxy)
  3. DevOps Test Integrations and APIs Agent (RIT Agent)
    (formerly Rational Integration Tester Agent)

Note: In this document, we assume the current directory is the component’s installation directory. All relative paths listed are relative to that directory.

RTCP

There are 2 parts of RTCP:  RTCP itself and RTCP workspace.

For RTCP itself, mainly consists of a web application server for web user interface and business processes.

Default installation directory:

On Windows:           C:\Program Files\IBM\DevOpsTestControlPanel

On non-Windows:  /opt/IBM/DevOpsTestControlPanel

Default installation directory of former name before version 11.0.0:

On Windows:           C:\Program Files\IBM\RationalTestControlPanel

On non-Windows:  /opt/IBM/RationalTestControlPanel

  • Main configuration file: config/server.custom.xml
  • Optional: key store files if using custom certificates
  • Optional: JDBC drivers if using custom JDBC drivers

The JDBC JAR files should be under 1 of below 2 directories

./lib

./usr/servers/defaultServer/apps/RTCP.war/WEB-INF/lib

  • Optional for highly customised configurations on RTCP workspace location and base URL:

./usr/servers/defaultServer/apps/RTCP.war/WEB-INF/classes/container.server.properties

For RTCP workspace, it stores RTCP runtime data including user authentication configuration, domain information, project and stub information. If possible and the volume is not too huge,  recommend to back up the whole directory.

Default workspace directory:

On Windows:           C:\IBM\RTCP-Workspace

On non-Windows:  /var/rtcp

  • User authentication configuration: whole directory of ./security

RIT Proxy

RIT proxy is installed as part of RTCP, default directory is <RTCP_installation>/httptcp

  • main configuration file: ./registration.xml
  • Optional: key store files if you are using your own certificate

RIT Agent

Default installation directory:

On Windows:           C:\Program Files\IBM\DevOpsTestAPIAgent

On non-Windows:  /opt/IBM/DevOpsTestAPIAgent

Default installation directory of former name before version 11.0.0:

On Windows:           C:\Program Files\IBM\RIT-Agent

On non-Windows:  /opt/IBM/RIT-Agent

  • Main configuration file: config/Agent.config
  • Optional for using RIT Agent only as a probe: config/Probe.config
  • Optional if exists for additional JDBC and 3rd parties’ library configuration: ./librarysettings.xml
  • Optional: key store files if you are using your own certificate for connecting RTCP
  • Optional: JDBC drivers and 3rd parties’ libraries if you are using your own JDBC drivers or other libraries, library locations may be defined in ./librarysettings.xml

Additional Recommendations

In addition to the files listed above, it is recommended to locate and back up any manually modified files such as:

  • .ini
  • .xml
  • .properties

These may contain important custom configurations.

[{"Type":"MASTER","Line of Business":{"code":"LOB77","label":"Automation Platform"},"Business Unit":{"code":"BU048","label":"IBM Software"},"Product":{"code":"SSKZXE","label":"IBM DevOps Test Virtualization"},"ARM Category":[{"code":"a8m0z000000bpmtAAA","label":"Integration Tester-\u003ERTVS-\u003EConfiguration"}],"Platform":[{"code":"PF025","label":"Platform Independent"}],"Version":"11.0.0;11.0.1;11.0.2;11.0.3;11.0.4;11.0.5;11.0.6"},{"Type":"MASTER","Line of Business":{"code":"LOB77","label":"Automation Platform"},"Business Unit":{"code":"BU048","label":"IBM Software"},"Product":{"code":"SSBLXN","label":"IBM Rational Test Virtualization Server"},"ARM Category":[{"code":"a8m0z000000bpmtAAA","label":"Integration Tester-\u003ERTVS-\u003EConfiguration"}],"Platform":[{"code":"PF025","label":"Platform Independent"}],"Version":"10.0.0;10.0.1;10.0.2;10.1.0;10.1.1;10.1.2;10.1.3;10.2.0;10.2.1;10.2.2;10.2.3;10.2.4;10.5.0;10.5.1;10.5.2;10.5.3;10.5.4"}]

Document Information

Modified date:
18 September 2025

UID

ibm17245219