Starting and stopping the HTTP/TCP proxy

To route and record HTTP(S) and TCP traffic with HCL Quality Server and HCL OneTest™ API, you must start the HTTP/TCP proxy. If the proxy is installed as a Windows service, you can configure it for automatic startup on boot or for manual startup on demand.

Before you begin

Ensure that you have root permissions.

About this task

On Windows systems, the HTTP/TCP proxy is, by default, configured to be installed as a service, and for automatic startup on boot. If you cleared these selections during the installation, then use the Modify option of IBM® Installation Manager to update the installation.

Procedure

Starting and stopping 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 named startup.bat file from the default location.
Stop the proxy. Close the Terminal window.

Starting and stopping the HTTT/TCP proxy if the proxy is installed as a Windows service:

Start the service from the Start menu. Click All Programs > HCL OneTest > Start HTTP Proxy.
Note: By default, the proxy is configured to start automatically on boot.
Stop the service from the Start menu. Click All Programs > HCL OneTest > Stop HTTP Proxy.
Tip: You can also open the Services window in Control Panel by right-clicking HCL OneTest HTTP/TCP Proxy > Stop.
Follow these steps to modify the Windows service from automatic startup to manual startup:
1. Go to Control Panel, and select Administrative Tools > Services.
2. Right-click HCL OneTest HTTP/TCP Proxy Windows service.
3. 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.

Starting and stopping the HTTP/TCP proxy on non-Windows systems:

Start the proxy from the command line by using a start-up script (init shell script or systemd script) that you can find in C:\Program Files\HCL\HCLProducts\QualityServer\httptcp. Run the init shell script named startup.sh file from the default location or run the systemd script named proxy.service from an Administrator command prompt. If you want to run the systemd script, follow these steps:
1. Install the file and set permissions:
```
sudo cp proxy.service /etc/systemd/system/proxy.service
sudo chmod 644 /etc/systemd/system/proxy.service
```
2. Start the service:
```
sudo systemctl start proxy
```
  For more information about systemd, see the systemd documentation.
Stop the proxy. Close the Terminal window.

Configuring automatic start on boot on non-Windows systems:

Follow these steps to configure automatic start on boot for the init shell script:
1. Add the startup.sh script to the path /etc/init.d.
2. Create symbolic links to the script in the run-level folders, for example, /etc/rc3.d.
Follow these steps to configure automatic start on boot for the systemd script:
1. Enable automatic startup:
```
sudo systemctl enable proxy
```
2. Check the status:
```
sudo systemctl status proxy 
```

Feedback