Remedio Proxy Server - Setting up and Requirements
Introduction
This document provides the system requirements and installation guide for the Remedio Proxy component. The primary function of the proxy is to facilitate clients' access to the backend in disconnected or air-gapped environments, ensuring minimal interaction with production networks.
Installation Requirements
Verify all the following Remedio requirements are met prior to installation of the Remedio Validator software:
Server Sizing – configurations for the server where the proxy is installed.
OS – operating system for the Remedio Proxy server.
Ports – the required open ports on both the server and client sides.
Antivirus – implement antivirus exclusions to ensure the unimpeded execution of Remedio Proxy.
Server Sizing
A dedicated server is not mandatory; you can utilize any existing server. However, ensure that the selected server possesses a minimum of 4 cores and 8GB of RAM.
OS
Supported operating systems include Windows Server 2016 Standard and newer versions.
Windows Server language settings:
The Windows Server operating system must be configured to use the English (United States) language.
The Windows Server language for non-Unicode programs must be set to use the English (United States) language.
Ports
From | To | Port number | Purpose |
Remedio Clients | Remedio Proxy Server | If Remedio on-prem: 9093 (TCP) | Tunnel connections from clients to Remedio Proxy. (Port 9094 is used to maintain compatibility with older clients.) |
If Remedio SaaS: 9093 (TCP), 9094 (TCP) | |||
Remedio Proxy Server | Remedio On-Prem Server | 9093 (TCP), 8443 (HTTPS) | Tunnel connections and S3-related actions to the backend. |
Remedio SaaS | 443 (TCP) |
Antivirus
If whitelisting is required, please consider the relevant paths:
C:\Program Files\gytpol (including subfolders and files)
Installation
Download the Proxy MSI file provided by the Remedio team and save it on the server.
Log in to the server using an administrative account.
Double-click on the MSI file to initiate the installation process. The following screen will be displayed:
Continue with the installation process until you reach the DNS Configuration screen:
By default, the Remedio proxy server communicates with 8.8.8.8 for name resolution. Customers looking to use other DNS servers need to edit this configuration.
To confirm a successful installation of the proxy, open Windows Services and verify the presence of the "Remedio Proxy" service. Ensure that it is in the "Running" state.
Uninstalling
If you intend to uninstall the Remedio Proxy, please remove it from "Programs and Features" by selecting "Uninstall".
Upgrading
If you intend to upgrade the Remedio Proxy, please stop Remedio Proxy Service from the services MMC and run the installation of the new version. This will perform an in-place upgrade.
Logging and Debugging
You can configure logging for the Remedio Proxy in the file:C:\Program Files\gytpol\gytpol Proxy\proxy.conf
To enable debugging:
Open the configuration file.
Locate the logging section:
# uncomment for debug:
error_log error_log.log debug;
log_format upstreamlog '[$time_local] $remote_addr - $remote_user - $server_name $host to: $upstream_addr: $request $status upstream_response_time $upstream_response_time msec $msec request_time $request_time';
access_log access_log.log upstreamlog; Uncomment these lines to activate detailed logging. This enables:
error_log with debug level for detailed error tracking.
access_log with
upstreamlogformat to capture:Request details
Upstream response times
Overall request duration
Restart the Remedio Proxy service after making changes.
This operation will create detailed logs in:
C:\Program Files\gytpol\gytpol Proxy\logs
If requested, please zip the logs folder and email it to support@Remedio.com or your Remedio TAM.