Initializing the Rational® Quality Manager adapter

To use Rational® Quality Manager with a computer that uses HCL OneTest™ Embedded for Eclipse IDE, the HCL OneTest™ Embedded adapter service must be properly running and configured on the computer.

Before you begin

You need administrator privilege to run Rational® Quality Manager adapter service on Windows and Linux.

As an RQM user, you must have write access to a valid RQM Public URL and project and the appropriate RQM CALs.

From HCL OneTest™ Embedded for Eclipse IDE V8.2.0, Rational® Quality Manager V6.0.5 is required.

Procedure

To start the HCL OneTest™ Embedded for Eclipse IDE and Rational® Quality Manager adapter, follow these steps:

Run command prompt as an administrator user on Windows. On Linux open the command shell and enter sudo to have root rights.
Start the Rational® Quality Manager adapter service with the following command, located in the \RQMAdapter\TestRTadapter folder of the product installation directory:
- On Windows™, enter the following command: startTestRTAdapter.bat
```
C:\Program Files\HCL\HCLOneTest\Embedded\RQMAdapter\TestRTAdapter\"startTestRTAdapter.bat"  
```
- On UNIX™, enter startTestRTAdapter.sh
```
sudo startTestRTadapter.sh 
```
Note: The adapter requires access to a writable temporary directory. The %TEMP% variable is used to access to the default directory. If the adapter encounters permission problems with the default settings, add the following option to the command to specify a writable directory: -tempDir=temp_directory. For example: startTestRTAdapter.bat -tempDir=C:\temp.
If this is the first time you run the adapter, you must configure the adapter by typing the following information, when prompted, in the command window:
1. Type the base URL of the Rational® Quality Manager server.
  For example: https://hostname:9443/jazz
2. Type your login and password for the Rational® Quality Manager account.
3. Type the Rational® Quality Manager project area name.
4. Type a name for the adapter, or press Return to use the default name.
  
  Note: This step is not mandatory. If you don't enter any name, the default adapter name is taken into account.
The adapter only asks these questions the first time it is run. If you need to change the server URL or login information, run the adapter with the -reconfigure option as follows:
- On Windows, enter:
```
C:\Program Files\HCL\HCLOneTest\Embedded\RQMAdapter\TestRTAdapter\"startTestRTAdapter.bat" -reconfigure
```
- On Linux, enter:
```
sudo startTestRTadapter.sh -reconfigure
```

Results

The Rational® Quality Manager adapter service starts.