This document is an example of how to repackage the AppGate Client. Here we put together with a agclient.properties file and the IP-tunneling driver. The result will be a file called agpkg.exe that may help in streamlining the user experience.

It should be quite easy to modify it to do other custimizations, e.g adding preinstalled hostkeys etc.  

To be able to do this you need a Windows (2K or XP) machine.

This is the procedure:

• Create a new empty folder on your windows machine - this will be  the build folder.
• Put a appkg.nsi file in the build folder. You'l find it here: agpkg.nsi .
• Examine the agpkg.nsi file and make any additions or changes you need.
• Put a suitable icon.ico file in the build folder. You can use this one icon.ico . (It is the icon shown for the resulting installation .exe-file)
• Put the template agclient.properties file in the build folder. Typically you can copy such a file from your "C:\Documents and Settings\home folder\appgate\version\agclient.properties" Using this file will give each user the same settings as yours as default. You may also take look at it with e.g. wordpad to make sure it contains only the settings you like. Check the AppGate documentation for more information on the available configuration options.
• Fetch an agclient.exe and an agiptd.exe file and put them into the build folder. You can fetch them from your AppGate's built in web server to get the correct version.
• Install Nullsofts Install System, NSIS which can be downloaded from http://sourceforge.net/projects/nsis/ Version 2.0 or later is needed.
• Change directory, possibly using the Windows explorer, into the build folder. Using the right click menu on the agpkg.nsi file you should be able to "Compile NSIS Script".

The last step should create a new agpkg.exe in the build folder. This file could then be uploaded to the AppGate and moved into a suitable position in the /var/opt/appgate/webroot directory or deployed by other means to the client machines.

 

The above example is using an agpkg.nsi that basically requires you to supply the three files agclient.exe, agiptd.exe and agclient.properties. Other packaging combinations are possible but requires a slightly different agpkg.nsi. However, the agpkg.nsi is a text file that is easy to modify.

The installer section in the last 20 lines in the agpkg.nsi is already prepared for other packaging combinations. Simply comment/uncomment the relevant lines to include or exclude other files.

Otherwise please contact support@appgate.com if you want assistance with another akpkg.nsi.