Update of the active .exe file (Windows) or .dll and .runtimeconfig.json file (Windows and Linux) of the Application Gateway using keyword
UPDATE[:!Switches]
UPDATE:version[!Switches]
UPDATE:auto[restart][!Switches]
UPDATE:auto[restart]!Switches!TimeOfDay
version is on optional parameter and should be specified only if an upgrade of ApplicGate to a new .NET version is requested, e.g. UPDATE:4.8.
- If the parameter version is specified the current ApplicGate version will not be checked by the server and the files will be downloaded in any case (if found).
- The installation of the correct version of .NET must be done before updating ApplicGate! Switching between .NET Framework and .NET 10.0 or higher is not supported.
- If the parameter version is not specified the update process will request a new version of ApplicGate with the same .NET version as currently used.
auto ... check version after establishment of an autologon link. If there is a new version available, download and copy the files[s].
- Restart must be done manually. A notification can bee seen at the home and UID list windows.
autorestart ... download and restart automatically
Switches (separated by ,):
CKS ... optional switch to check the signature of the downloaded file by PowerShell
CKH ... optional switch to check the hash of the downloaded file
- The correct hash is retrieved from download.applicgate.com and compared with the actual SHA256 hash of the file.
CTU[~directory] ... optional switch to copy the downloaded file(s) to the subdirectory Update with filename format as shown below
- If directory does not exist or if it is not specified, the default directory will be used. The subdirectory Update will be created if it does not exist.
TimeOfDay ... time to start update automatically
Examples:
UPDATE ... manual activation and restart, no checks enabled
UPDATE"!CKS,CKH,CTU" ... manual activation and restart, all checks enabled, file copied for distribution
UPDATE:"auto!CKS,CKH,CTU" ... automatic activation and manual restart, all checks enabled, file copied for distribution
UPDATE:"autorestart!CKS,CKH,CTU" ... automatic activation and restart, all checks enabled, file copied for distribution
UPDATE:autorestart ... automatic activation and restart, no checks enabled
UPDATE:autorestart!!03:00 ... Check availabilty of new version at 03:00 and restart if new version could be downloaded
Prerequisites for the server (sends the new file(s) ):
- The new version of the file(s) must be stored in the subdirectory Update of the default directory of the server (Windows or Linux).
- Syntax for builds with .NET Framework (running on Windows only):
-- ApplicGate_NETvnetversion_MajorVersion.MinorVersion.BuildNumber.Revision.exe
-- e.g. ApplicGate_NETv4.8_12.0.9036.21357.exe
- Syntax for builds with .NET 10.0 or higher (running on Windows and Linux):
-- ApplicGate_NETvnetversion_MajorVersion.MinorVersion.BuildNumber.Revision.dll and
-- ApplicGate_NETvnetversion_MajorVersion.MinorVersion.BuildNumber.Revision.runtimeconfig.json
-- e.g. ApplicGate_NETv10.0_12.0.8999.41774.dll and ApplicGate_NETv10.0_12.0.8999.41774.runtimeconfig.json
- Note: ApplicGate versions built without the symbol "Srv" request the client version for update:
-- File names must start with ApplicGateClient_NET....
- A reverselogon rule must exist.
- If the reverselogon rule should allow only the update function: DestinationIP must contain the string updonly. e.g.SourceIP ;GatewayIP ;GatewayPort;GatewayIP2 ;DestinationIP;DestinationPort;Expiration;Type ;UID;Comment ;eMail
* ;* ;447 ;reverselogon;updonly ; ; ;SSL:server.cer; ;Repository for Updates;
Prerequisites for the client to receive the new .exe file (Windows) or .dll and .runtimeconfig.json files (Linux):
- a autologon rule must exist (GatewayIP can be "client", any rule or "*"), the keyword UPDATE must be specified.
- Note: If GatewayIP is "*" this autologon rule can be used only for the UPDATE function. e.g. get the update from the ApplicGate web site via the InternetSourceIP ;GatewayIP;GatewayPort;GatewayIP2;DestinationIP ;DestinationPort;Expiration;Type ;UID;Comment ;eMail
autologon;* ;* ; ;download.applicgate.com;447 ; ;UPDATE,SSLTARGET:download.applicgate.com; ;Update ApplicGate;
Download of new version:
- At the client: Click the UPDATE keyword in the routing table (you must have manage rights on the client).
- Then the client sends a download request to the server with the requested .NET version and the current version of ApplicGate.
- The server checks if there is a newer version available that is built for the requested .NET Framework.
- After successful download the temporary .exe/.dll file will be executed on the client to see if it is ok.
The download status can be checked via Status of Update
When the download is complete the activation can/must be done manually via the offered "Restart" link (command updres):
Following functions will be executed:
.NET Framework (Windows only):
- Renaming of the active .exe file to .exe_yyyy-MM-dd_HHmmss_old
- Renaming of the new temporary .exe file to the correct target file
- Restart to activate the new .exe file.
.NET 10.0 or higher (Windows and Linux):
- Renaming of the active .dll file to .dll_yyyy-MM-dd_HHmmss_old and .runtimeconfig.json file to .runtimeconfig.json_yyyy-MM-dd_HHmmss_old
- Renaming of the new temporary .dll and .runtimeconfig.json file to the correct target file
- Restart to activate the new .dll file .
Remark:
- The .exe/.dll file may have any name.
- If ApplicGate has not been started as client:
-- ApplicGate has to be started via a bat/bash file that restarts ApplicGate.exe or ApplicGate.dll when it terminates with exit code 1, see installation on Windows and Linux.
