Home
Administrator Guide
Typically, a user with the administrator role is responsible for certain tasks including installation, configuration, and integration of the product. This guide lists all such topics.
Administering Rational® Test Control Panel
IBM® Rational® Test Control Panel is a server-based web application providing a central repository for virtualized services. The Rational Test Control Panel allows you to use virtual services published with Rational Integration Tester to create, share, and deploy virtualized test environments in IBM Rational Test Virtualization Server.
Configuring IBM® Rational® Test Control Panel
You might need to configure the Rational® Test Control Panel after the application is installed.
Modifying security model settings after installation
This section explains how to modify IBM® Rational® Test Control Panel security model settings after installation.

Administrator Guide
Typically, a user with the administrator role is responsible for certain tasks including installation, configuration, and integration of the product. This guide lists all such topics.
- Installation of Rational® Integration Tester Agent
  You can find information about installing IBM® Rational® Integration Tester Agent from the IBM Rational Test Workbench, IBM Rational Test Virtualization Server, or package.
- Installation of Rational® Test Control Panel
  You can find information about installing IBM® Rational® Test Control Panel from the IBM Rational Test Workbench, IBM Rational Test Virtualization Server, or IBM Rational Performance Test Server package.
- Upgrading Rational® Integration Tester Agent
  In general, you can upgrade from earlier versions of Rational® Integration Tester Agent to the most recent version without having to uninstall the software. Use the IBM® Installation Manager Update option to upgrade the software.
- License management
  As a purchaser of an IBM® Rational® software product, you can choose from the different types of product licenses that you can deploy to use the product.
- Configuring Rational® Integration Tester Agent
  After you install Rational® Integration Tester Agent, you must edit or modify the attributes in the Agent.config file for the features that you want to test by using the agent. You need to configure the libraries to enable testing the SUT based on certain technologies and also set up the required proxies for enabling testing.
- Running Rational® Integration Tester Agent on Microsoft™ Windows™
  On computers running Microsoft™ Windows™, the agent is typically installed and run as a Windows service.
- Running Rational® Integration Tester Agent on Unix-like systems
  On Unix-like systems, you can start Rational® Integration Tester Agent by running the Agent executable in the root of the Rational Integration Tester Agent installation directory (for example, /opt/IBM/RIT-Agent/).
- Rational® Integration Tester Agent
  You can use workarounds to common problems that you might encounter when you install and run the Rational® Integration Tester Agent.
- HTTP/TCP proxy setup
  The process of configuring applications to use the HTTP/TCP proxy varies according to the application.
- Setting up the JDBC proxy
  After you install the JDBC proxy, you must deploy the proxy into the Java™ virtual machine (JVM) of the relevant applications, set up the proxy for use, and verify that it is deployed.
- Administering Rational® Test Control Panel
  IBM® Rational® Test Control Panel is a server-based web application providing a central repository for virtualized services. The Rational Test Control Panel allows you to use virtual services published with Rational Integration Tester to create, share, and deploy virtualized test environments in IBM Rational Test Virtualization Server.
  - Configuring IBM® Rational® Test Control Panel
    You might need to configure the Rational® Test Control Panel after the application is installed.
    - Using your own truststore for server SSL connections
      The server by default provides a truststore but you might want to use your own truststore for server SSL connections.
    - Configuring the server HTTP Endpoint
      The server supports both HTTP and HTTPS connections but by default is HTTPS only. It is possible to enable, disable, and change the ports that are used by both HTTP and HTTPS server connections.
    - Registering Rational® Integration Tester Agent with Rational® Test Control Panel
      IBM® Rational® Test Control Panel runs stubs on agents. Agents can also be used to run scheduled tests. During the installation of the Rational Integration Tester Agent, the agent is configured to register with the server instances so that they are available for stubs and/or running scheduled tests.
    - Adding Microsoft™ SQL Server and MySQL drivers
      Microsoft™ SQL Server and MySQL drivers are not supplied with Rational® Test Control Panel. If you want to use SQL Server or MySQL with Rational Test Control Panel, you must copy the SQL Server or MySQL drivers to the Rational Test Control Panel installation directory.
    - Modifying security model settings after installation
      This section explains how to modify IBM® Rational® Test Control Panel security model settings after installation.
      - Configuring the security settings after installation by updating the security.config file
        When you configure Rational® Test Control Panel in GUI mode, the security settings are saved to the security.config file in the security folder in the Rational Test Control Panel workspace. To add or modify the security settings after installing the server in GUI mode or in console mode, use these instructions.
  - Getting started
    Start using the IBM® Rational® Test Control Panel.
  - Task flow: Working with the IBM® Rational® Test Control Panel Environments dashboard
    You can use the Rational® Test Control Panel Environments dashboard to perform various tasks such as starting, stopping stubs and scenarios, and modifying stub configurations after you have published stubs to Rational Test Control Panel. You can also lock the environment that contain the published stubs.
  - Task flow: Working with the IBM® Rational® Test Control Panel Infrastructure dashboard
    You can use the Rational® Test Control Panel Infrastructure dashboard to perform administrative tasks such as viewing agents and proxies registered with Rational Test Control Panel.
  - Task flow: Working with the IBM® Rational® Test Control Panel Network dashboard
    You can use the Rational® Test Control Panel Network dashboard to perform administrative tasks such as viewing recording or routing rules configured for agents and proxies.
  - Managing users
    IBM® Rational® Test Control Panel has multiple choices associated with its security model. Depending on the security option selected during installation of the Rational Test Control Panel, different options are available based on the user accounts.
  - Managing domains
    How to create and manage domains in IBM® Rational® Test Control Panel.
  - Working with Rational® Test Control Panel dashboards
    You can filter, search, sort, and choose the number of items to be displayed in IBM® Rational® Test Control Panel dashboards.
  - Deleting environments
    This topic explains how to delete environments.
  - Agent and Proxy administration
    Use IBM® Rational® Test Control Panel to view and control any of the Rational Integration Tester agents or proxies.
  - Viewing Rational® Test Control Panel logs
    If you are an IBM® Rational® Test Control Panel administrator, you can view the audit, activity, and diagnostic logs of Rational Test Control Panel.
  - Viewing reports in Rational® Test Automation Server
    All the project stakeholders can view test reports for multiple testing products from the Results page on IBM® Rational® Test Automation Server. You can access the Results page from a web browser. Therefore, there is no need to install the desktop client.
  - Configuring stubs to connect to Rational® Test Control Panel and the HTTP proxy
    A stub running on its own may not be sufficient in some cases, because it might have dependencies on services such as Rational® Test Control Panel or the HTTP proxy. If the stub is running on the public cloud and the services are running in the enterprise, you must configure the stub to connect to these services.
  - Troubleshooting: Rational® Test Control Panel
    You can use workarounds to troubleshoot common problems that you might encounter when you use IBM® Rational® Test Control Panel.

Modifying security model settings after installation

This section explains how to modify IBM® Rational® Test Control Panel security model settings after installation.

About this task

Before installing Rational® Test Control Panel, it is a good idea to consider whether and how users will be authenticated during login (for information about this, refer to Installation considerations for Rational Test Control Panel).

However, before and during installation of the Rational® Test Control Panel, you might be unsure of security model requirements, or you might have insufficient information to enable you to configure (fully) your chosen security model option.

After installation, Rational® Test Control Panel provides administrators with the means to modify security settings without having to reinstall the software.

To modify security model settings after installation:

Procedure

Open IBM® Installation Manager and click Modify.
Select Rational® Test Control Panel package from the list to modify the package and click Next.
In the Security Configuration page, select the required authentication mode from the Authentication Type list and click Next.
Click Modify and then click Finish.
Restart Rational® Test Control Panel service to ensure that any changes you have made take effect.

Results

The selected type of authentication mode is applied for the users to log in to the Rational® Test Control Panel.