How to install a Cluster ActiveGate
Cluster ActiveGate can be installed either on Linux or Windows.
Before you begin
Please check the hardware and system requirements for ActiveGate.
Download the installer
Downloading the installer is easy—just follow the steps below.
-
Log into your DESK Server and select Home from the navigation menu to enter the DESK Cluster Management Console.
-
Click the browse [...] button and select Add new Cluster ActiveGate.
-
Choose the operating system on which you would like to install the Cluster ActiveGate.
-
Select the purpose of the ActiveGate. You can choose from the following purposes:
- Route traffic: Routes OneAgent traffic.
- Run synthetic monitors from a private location: Use your Cluster ActiveGate to run synthetic monitors from a private location. A synthetic-enabled ActiveGate is used exclusively to run synthetic monitors. The clean ActiveGate installation set to Synthetic monitoring will disable all other ActiveGate features, including communication with OneAgents.
- Download the installer. For Windows, click Download the installer. For Linux, copy the
wget
command line and paste it into your terminal window. Make sure to copy the command directly from the cluster page because the command contains your cluster master address.
Run the installer
You'll need root rights to install a Cluster ActiveGate. You can use su
or sudo
to run the installation script.
Since version 1.155, the user running the ActiveGate service doesn't require root rights. If you don't specify your own user to run the ActiveGate service, existing or not, the installer by default creates the dtuserag
user. For more information see Customize ActiveGate installation on Linux
To install ActiveGate, type one of the following commands into the directory where you downloaded the installation script.
- If you’re on an Ubuntu Server:
sudo /bin/bash psg-installer.sh
- If you’re using Red Hat Enterprise Linux:
su -c '/bin/bash psg-installer.sh'
- If you start a root session:
/bin/bash psg-installer.sh
After a few validation steps, ActiveGate is automatically installed and connected to the cluster nodes.
What are the default settings?
- Distribution path:
/opt/desk/gateway_<id>
- DESK Server data files:
/var/opt/desk-managed
- Cluster ActiveGate configuration:
/var/lib/desk/gateway/config
- Log files directory:
/var/log/desk/gateway
What happens during installation?
The installer also optimizes operating system settings:
- Swap is turned off (using
swapoff
). iptables
"PREROUTING
" rules are enhanced to enable communication forwarding to DESK Server (HTTPS to port 8021). To see the exact rules, typeiptables -L -vt nat
in your terminal.readahead
page cache is set to 512.- Limits for users are changed globally (unlimited locked-in-memory address space, unlimited address space, increased limit for number of processes and open files).
See/etc/security/limits.conf
for details. max_map_count
is modified.
To install a cluster ActiveGate on MS Windows, run the executable file using administrator rights and follow the displayed instructions. For a synthetic-enabled Cluster ActiveGate, make sure you use the exact command displayed in the DESK web UI.
After a few validation steps, ActiveGate is automatically installed and connected to the cluster nodes.