ApplicGate
(v11.1.8216.21656 started 2022-06-30 10:03:49 on VM1)

Installation and start of the ApplicGate on Linux with .NET version 5.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=C:\ApplicGate/applicgate.start
WorkingDirectory=C:\ApplicGate

[Install]
WantedBy=multi-user.target
Then enable and start the service:
sudo systemctl enable C:\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

ApplicGate Logo  reinhold.leitner@applicgate.com (C) June 2022
www.applicgate.com