Running the adapter

To use Engineering Test Management with HCL OneTest™ Embedded Studio or HCL OneTest™ Embedded for Eclipse IDE, the HCL OneTest™ Embedded adapter must be running on the computer.

Before you begin

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

Before running the adapter, ensure that both the PATH and JAVA_HOME environment variables are properly set to the correct location of a Java Runtime Environment (JRE) version 1.5 or later.

From HCL OneTest™ Embedded 8.3.2, Engineering Test Management 7.0.2 must be used.

Procedure

To start the HCL OneTest™ Embedded and Engineering Test Management adapters, follow these steps:

Run the command prompt as an administrator user on Windows. On Linux open the command shell and enter sudo to have root rights.
Start the Engineering Test Management 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 you run the adapter for the first time, you must configure the adapter in the command window when prompted as follows:
1. Enter the base URL of the Engineering Test Management server.
  For example: https://hostname:9443/jazz
2. Enter your login and password for Engineering Test Management account.
3. Enter the Engineering Test Management project area name.
4. Enter 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 Engineering Test Management adapter service is started.