Installation and start of ApplicGate on Windows with .NET Framework 4.8
- Copy ApplicGate.exe to a new directory (e.g. C:\ApplicGate).
- Within a command window change to this directory and issue one of following commands:
- Note: If not running as Administrator, the User Account Control window will be shown.
-- For standard example (with the configuration files routing.csv and groups.csv): ApplicGate.exe /install
-- For sample EAS configuration (with the configuration files routing.csv and groups.csv): ApplicGate.exe /install:EAS
-- For sample RSP remote configuration (with the configuration files routing.csv and groups.csv): ApplicGate.exe /install:RSPremote!DestinationIP!DestinationPort!certificate
--- DestinationIP, DestinationPort and certificate are parameters for the autologon routing entry:
---- Default DestinationIP is vpn.testcomp.com
---- Default DestinationPort is 441
---- Default certificate for the keyword SSLTARGET is snnn.rsp@testcomp.com.pfx/snnnrsp, the certificate must be created separately.
-- For sample RSP VPN Server configuration (with the configuration files routing.csv and groups.csv): ApplicGate.exe /install:RSPvpnServer!GatewayIP!Port1!Port2!certificate
--- GatewayIP, Port1 and Port2 are parameters for the reverselogon routing entries:
---- Default GatewayIP is *
---- Default Port1 (logon of remote servers) is 441
---- Default Port2 (logon of clients) is 442
--- certificate is a parameter for the SSL keywords:
---- Default certificate is vpn.testcomp.com.pfx/vpntest, the certificate must be created separately.
- The scheduled task ApplicGate will be created and started (runs as SYSTEM).
- Start your browser as displayed to access ApplicGate:
-- The first manage entry of routing.csv will be shown (usually http://127.0.0.1:98).
- During installation the license will be checked: The license must be stored in group License!
- All necessary files 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.
Detailed description:
Start of ApplicGate:
Argument 1: File name of Routing Table (if full path is omitted, path of exe 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. ApplicGate.exe routing.csv groups.csv
Usually the Application Gateway runs within a Scheduled Task:
Build a .bat file, eg. ApplicGate.bat (example see below):
@echo off
set AGstart=ApplicGate.exe routing.csv groups.csv
echo %Date% %Time% ApplicGate starting: %AGstart%
:restart
%AGstart%
echo %Date% %Time% Errorlevel: %errorlevel%
if not "%errorlevel%" == "1" goto exit
echo %Date% %Time% ApplicGate restarting: %AGstart%
goto restart
:exit
echo %Date% %Time% ApplicGate stopped!
Then let it start every 5 minutes during the whole day (to allow automatic recovery from unhandled exceptions),
for error logging redirect the output of the batch file to a .txt file.
The content of ApplicGate.xml for import into the Task Scheduler can be found here.
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
Commmon ports (services) should be disabled on the system.
Hint to install a new version of the program:
- Rename old program file(s)
- Copy new version of program files(s)
- Issue restart via web interface
