Using the adapter to connect to Rational® Quality Manager through a proxy server
You can use the adapter to connect to the Rational® Quality Manager server through a proxy server. You must configure the credentials for the proxy server from the command-line interface.
Before you begin
If you are a Rational® Quality Manager user, ensure that you have the appropriate permissions, including execute permissions, to access the HCL OneTest™ UI adapter for Rational® Quality Manager. If you do not have administrator rights then use the Connector Client Access license. You can obtain this license from the Rational® Quality Manager administrator.
If the host name of the Rational® Quality Manager server is not registered with the DNS server, modify the hosts file and map the host name of the Rational® Quality Manager server to its IP address. Additionally, map the host name of the proxy server through which the adapter connects to the Rational® Quality Manager server to the proxy IP address.
About this task
Procedure
- At the prompt, type the following command-line arguments
to run the configureadapter.bat configuration
batch file:
configureadapter.bat -repository https://<rqmserver>:<port>/qm -user <userid> -password <password> -adapter <adapter name> [-projectArea <projectArea>] -proxy <proxy server name> -proxyPort <proxy port number> -proxyUser <proxy server userid> -proxyPassword <proxy server password> [-configfile <configuration file>] [-interactive <true/false>]
where:- <rqmserver> is the host name of the Rational® Quality Manager server.
- <port> is the port where the Rational® Quality Manager server is running.
- <userid> is a registered user ID in Rational® Quality Manager that has the license to run the adapter
- <password> is the password for the user ID that was used.
- <adapter name> is the name you give your adapter and by which the Rational® Quality Manager web UI will identify this instance of the adapter.
- <projectArea> is the name or alias of the project to which you are logging on. If the name contains spaces, enclose the name in double quotation marks.
- <proxy server name> is the host name of the proxy server through which the adapter connects to the Rational® Quality Manager server.
- <proxy port number> is the port where the proxy server is running.
- <proxy server userid> is the user ID that is used to authenticate the proxy server.
- <proxy server password> is the password for the proxy server authentication user ID
- <configuration file> is the file from which the settings for this adapter must be read. The adapter name is mandatory when you use this option.
- [-interactive <true/false>]: If you set this value to true, the HCL OneTest™ UI Adapter dialog box opens if you have not specified values for any of the command-line arguments. You can then specify the missing value in the HCL OneTest™ UI Adapter dialog box.
Note: If the Rational® Quality Manager server is renamed, complete these steps:- If you have an entry for the Rational® Quality Manager server in the hosts file, update it with the new server name.
- Update the <rqmserver> argument with the new server name.
- Configure the adapter again to point to the new URL
- Start the adapter by running the startadapter.bat batch
file, which is in the same location as the configureadapter.bat file.
Type the following command-line arguments at the prompt:
startadapter.bat -repository https://<rqmserver>:<port>/qm -user <userid> -password <password> -adapter <adapter name> -projectArea <project area> -proxy <proxy server name> -proxyPort <proxy port number> -proxyUser <proxy server userid> -proxyPassword <proxy server password> [-configfile <configuration file>]
where:- <rqmserver> is the host name of the Rational® Quality Manager server.
- <port> is the port where the Rational® Quality Manager server is running.
- <userid> is a registered user ID in Rational® Quality Manager that has the license to run the adapter.
- <password> is the password for the user ID that was used
- <adapter name> is the name you give your adapter and by which the Rational® Quality Manager web UI will identify this instance of the adapter.
- <projectArea> is the name or alias of the project to which you are logging on. If the name contains spaces, enclose the name in double quotation marks.
- <proxy server name> is the host name of the proxy server through which the adapter connects to the Rational® Quality Manager server.
- <proxy port number> is the port where the proxy server is running.
- <proxy server userid> is the user ID that is used to authenticate the proxy server.
- <proxy server password> is the password for the proxy server authentication user ID
- <configuration file> is the file from which the settings for this adapter must be read. The adapter name is mandatory when you use this option.
Note:- For the adapter to connect to the Rational® Quality Manager server through the proxy server, you must specify the proxy server name, port number and user ID.
- If the proxy server is renamed, complete these steps:
- If you have an entry for the proxy server in the hosts file, update it with the new proxy server name.
- Update the <proxy server name> argument with the new proxy server name.