Installation and start of the ApplicGate on Linux with .NET version 6.0 or higher
- Copy ApplicGate.dll and ApplicGate.runtimeconfig.json to a new directory (e.g. /home/GateAdmin/ApplicGate)
- Change to this directory and issue the command "dotnet ApplicGate.dll /install"
- Then all necessary files (with a sample configuration of routing.csv and groups.csv) will be written to the directory where ApplicGate.exe is stored.
- Hint:
-- You can store your customized routing.csv and groups.csv files before you start the installation because existing files will not be overwritten.
-- "dotnet ApplicGate.dll /install:EAS" installs sample configuration files for EAS: routing.csv and groups.csv
- The service applicgate.service will be enabled and started.
- Start your browser with http://127.0.0.1:99 to access ApplicGate!
Detailed description:
Start of program:
Argument 1: File name of Routing Table (if full is path omitted, path of dll file will be used) or /help
Argument 2 (optional): File name of Group Table (full path or path of argument 1 is used)
Argument 3 (optional): File name for Backup configuration
e.g. dotnet ApplicGate.dll routing.csv groups.csv
Usually the Application Gateway is started using systemd:
Build a bash file, eg. applicgate.start (example see below):
#!/bin/bash
# Start ApplicGate
#
echo Starting ApplicGate ...
%export%
dotnet ApplicGate.dll routing.csv groups.csv
while [ $? -eq 1 ]
do
echo Restarting ApplicGate ...
dotnet ApplicGate.dll routing.csv groups.csv
done
echo ApplicGate stopped: exit code $?
Do not forget to set the protection e.g. chmod o+x,g+x,u+x applicgate.start
Then define a configuration file for systemd, e.g. applicgate.service
[Unit]
Description=ApplicGate
After=network-online.target
Wants=network-online.target
[Service]
ExecStart=/home/GateAdmin/ApplicGate/applicgate.start
WorkingDirectory=/home/GateAdmin/ApplicGate
[Install]
WantedBy=multi-user.target
Then enable and start the service:
sudo systemctl enable /home/GateAdmin/ApplicGate/applicgate.service
sudo systemctl start applicgate.service
List of Error Levels of ApplicGate.exe:
0 ... Stopped via web interface
1 ... Restart request via web interface
2 ... Cannot load Routing table (see log file)
3 ... Cannot load Group table (see log file)
4 ... Arguments are missing, usage will be displayed
6 ... Cannot open log file in default directory
Hint to install a new version of the program:
- Rename old program files
- Copy new version of program files
- Issue restart via web interface
