Starting and stopping the HTTP/TCP proxy
To route and record HTTP(S) and TCP traffic with Rational® Test Control Panel and Rational® Integration Tester, you must start the HTTP/TCP proxy. If the proxy is installed as a Windows service, you can configure it for an automatic start on start of the system or for a manual start on demand.
Before you begin
About this task
Note: If you use the SSL mode to connect to the HTTP/TCP proxy and use custom signed certificates to
authenticate this connection, you must ensure to use the certificate that is designated as a Certificate Authority (CA) entity and has the attribute set as BasicConstraint CA=true. If you attempt to start the proxy with any certificate that is not designated as a Certificate Authority, then the HTTP/TCP proxy shuts down and logs an error.
Procedure
Start and stop the HTTP/TCP proxy from a Windows™ command line:
-
Start the proxy from the command line by using a start-up script in
C:\Program Files\HCL\HCLProducts\QualityServer\httptcp
. Run the init shell script namedstartup.bat
file from the default location. - Stop the proxy. Close the Terminal window.
Start and stop the HTTT/TCP proxy if the proxy is installed as a Windows™ service:
-
Start the service from the Start menu. Click
.
Note: By default, the proxy is configured to start automatically on boot.
-
Stop the service from the Start menu. Click .
Tip: You can also open the Services window in Control Panel by right-clicking .
-
Follow these steps to modify the Windows™ service from
automatic startup to manual startup:
- Go to Control Panel, and select .
- Right-click HCL OneTest HTTP/TCP Proxy Windows service.
-
Click Properties and change the startup type from
Automatic to Manual. Click OK.
Tips:
- You can also use this Control Panel option to start, restart, or stop the service.
- You can also run
editProxyService.bat
from an Administrator command prompt and change the startup type, start, restart, or stop the service on the General page.
Start or stop the HTTP/TCP proxy on non-Windows systems. You can use either the
init shell script or the systemd script to start or stop the HTTP/TCP proxy. You can
find the scripts in the
httptcp
directory of your Rational® Test Control Panel installation. -
Start the proxy on non-Windows systems. Do one of the following steps:
- If you are using the init shell script, run the
startup.sh
file from the default location or where you installed Rational® Test Control Panel. - If you are using the systemd script, follow these steps:
- Install the file and set permissions:
sudo cp proxy.service /etc/systemd/system/proxy.service sudo chmod 644 /etc/systemd/system/proxy.service
- Start the service:
sudo systemctl start proxy
For more information about systemd, see the systemd documentation.
- Install the file and set permissions:
- If you are using the init shell script, run the
-
Stop the proxy on non-Windows systems. Do one of the following steps:
- If you are using the init shell script, use
^C
in the shell where you ranstartup.sh
. - If you are using the systemd script, use
sudo systemctl stop proxy.
- If you are using the init shell script, use
Configure automatic start on boot on non-Windows systems:
-
Follow these steps to configure automatic start on boot for the init shell script:
-
Add the
startup.sh
script to the path/etc/init.d
. -
Create symbolic links to the script in the run-level folders, for example,
/etc/rc3.d
.
-
Add the
-
Follow these steps to configure automatic start on boot for the systemd script: