Installing Resilient Package (RP) Proxy on Linux or Unix and Windows

The following section describes the steps to install the RP Proxy on Linux or Unix and Windows.

Installing RP Proxy on Linux or Unix

The following section describes the steps to install the RP Proxy on a Linux or Unix platform using the Interactive or Silent mode of installation.

By default, the RP Proxy is installed in the /opt/protegrity directory. You can choose to install the RP Proxy in a different directory by specifying the -d or --dir argument in the installation command. If you change the base installation directory, then the installation path will also change accordingly.

Use the --help argument if you need any help with installing the RP Proxy, as shown in the following command.

./pty-rpproxy-setup-linux64-<version>.sh --help

The following snippet displays the output.

Install:
./pty-rpproxy-setup-linux64-<version>.sh (-u <user> -p <password> | -t <token> | --nocert) [-h <hostname>] [--port <port>] [-d <dir>]
 
Options:
 -h, --host      Host or IP of the upstream
     --port      Port to connect to on the upstream (default: 25400)
 -u, --user      ESA user. Must be a user with the Export Certificates role.
 -p, --password  ESA user's password.
 -t, --token     ESA token. Must be a token with the Export Certificates role.
 -d, --dir       Path to base directory for installation (default: /opt/protegrity)
   , --nocert    Disable certificates

Important: The -t or --token parameter is currently not applicable.

Installing RP Proxy on Linux or Unix using Interactive Mode

To install the RP Proxy on a Linux or Unix platform using the Interactive mode:

1. Run the RP Proxy installer using the following command.

   ./pty-rpproxy-setup-linux64-<version>.sh
   

   The prompt to enter the upstream hostname or IP address appears.

   Please enter upstream host name or IP address
   []:
   

2. Type the ESA Host Name or IP Address, and press ENTER.

   The prompt to enter the username for downloading certificates appears.

   Please enter the user name for downloading certificates
   []:
   

3. Type the username for downloading the certificates, and press ENTER.

   The prompt to enter the password for downloading the certificates appears.

   Please enter the password for downloading certificates
   []:
   

4. Type the password, and press ENTER to install into the destination directory.

   Directories are created under /opt/protegrity/rpproxy by default, and the required installation files are installed in these directories.

   Ensure that the ESA is up and running with the HubController service in running status to enable automatic downloading of certificates.

5. If you have installed the RP Proxy using the --nocert parameter, then the ESA certificates are not downloaded during the installation. To manually install the certificates to the /opt/protegrity/rpproxy/data directory of the RP Proxy, perform the following steps.

   i. Navigate to the /opt/protegrity/rpproxy/bin directory and run the following command.

   ./GetCertificates -u <ESA User with the Export Certificates role> [-h <ESA host name or IP address>] [-p portno] [-d directory]
   

   This initiates a secure communication between the RP Proxy and the ESA.

   ii. Enter the password for the ESA user.

   iii. Verify that the following files have been copied to the /opt/protegrity/rpproxy/data directory:

   • CA.pem
   • cert.key
   • cert.pem
   • secret.txt

   Start the RP Proxy by using the following command.

   /opt/protegrity/rpproxy/bin/rpproxyctrl start
   

   The RP Proxy is successfully installed.

Installing RP Proxy on Linux or Unix using Silent Mode

You can also execute the RP Proxy installer without any manual intervention, which is also known as the Silent mode of installation. The following parameters must be provided to execute the installer in the Silent mode.

At the command prompt, type the following command from the installer directory.

./pty-rpproxy-setup-linux64-<version>.sh (-u <user> -p <password>) [-h <host>] [--port <port>] 

If you want to install the RP Proxy in a directory other than the default directory, then you can add the -d parameter to the command to specify the directory. The following command displays a sample snippet.

./pty-rpproxy-setup-linux64-<version>.sh (-u <user> -p <password>) [-h <host>] [--port <port>] [-d <dir>]

Installing RP Proxy on Windows

The following section describes the steps to install the RP Proxy on a Windows platform using the Windows wizard or through silent installation.

When you install the RP Proxy, the system automatically sets up a directory structure with the required files in the ..\Protegrity\rpproxy directory.

Installing RP Proxy on Windows using the Windows Wizard

To install the RP Proxy on a Windows platform using the Windows wizard:

1. Double-click or run the pty-rpproxy-setup-<OS>-<version>.exe file. The Setup Wizard appears.

2. Click Next. The screen to specify the RP Proxy location appears.

3. Browse to the directory in which you want to install the RP Proxy, or retain the default location. It is recommended to retain the default location.

4. Click Next.

   The Proxy config screen appears.

5. Specify the following details.

   Parameter	Description
   IP/hostname	Host name or IP address of the upstream server that is providing the resilient packages.
   Port	Port number of the upstream server that is providing the resilient packages. The default value is 25400.
   User	Name of the ESA user for downloading the certificates from the ESA. This is an optional parameter.
   Password	Password of the ESA user required for downloading the certificates from the ESA. This is an optional parameter.

   Note: Ensure that the ESA is up and running with the HubController service in running status to enable automatic downloading of certificates.

6. Click Next.

   The Ready to Install screen appears.

7. Click Install.

   The Windows wizard installs the RP Proxy on your machine.

8. Click Finish to close the rpproxy Setup Wizard and complete the installation.

   The directories are created under the installation directory that was defined and the installation files are installed in these directories.

9. If you have not specified the Certificate download user name and password in the Proxy config screen, then the ESA certificates are not downloaded during the installation. To manually install the certificates to the \Protegrity\rpproxy\data directory of the RP Proxy, perform the following steps.

   i. Navigate to the \Protegrity\rpproxy\bin directory and run the following command.

   .\GetCertificates.bat -u <ESA User with the Export Certificates role> -p <Password of the ESA user> [-h <ESA host name or IP address>] [--port portno] [-d directory]
   

   This initiates a secure communication between the RP Proxy and the ESA.

   ii. Verify that the following files have been copied to the \Protegrity\rpproxy\data directory:

   • CA.pem
   • cert.key
   • cert.pem
   • secret.txt

   iii. Restart the rpproxy service from the Windows Task Manager after editing the file.

Installing RP Proxy on Windows using Silent Mode

You can also execute the RP Proxy installer without any manual intervention, which is also known as the Silent mode of installation. The following parameters must be provided to execute the installer in the Silent Mode.

At the command prompt, type the following command from the installation directory.

.\pty-rpproxy-setup-<OS>-<version>.exe --host <ip address> --port <port number> --user <ESA user name> --password <ESA user password>

To install the RP Proxy in a directory other than the default directory, add the --dir parameter to the command to specify the RP Proxy installation directory. The following snippet displays a sample command.

.\pty-rpproxy-setup-<OS>-<version>.exe --host <ip address> --port <port number> --user <ESA user name> --password <ESA user password> --dir <RP Proxy installation directory>

Uninstalling the RP Proxy

1. Navigate to the \Protegrity\rpproxy\bin directory.

2. Double-click the uninstall.exe file.

   The Uninstall rpproxy dialog box appears. A message appears asking you to confirm whether you want to uninstall the RP Proxy.

3. Click Yes. The RP Proxy and all its components are uninstalled.