VPN Tunneling Installer Overview

To download the VPN tunneling application as a Windows executable file, go to Maintenance > System > Installers.

VPN tunneling Installation Process Dependencies

During installation, VPN tunneling interacts with a number of system components, performing checks and validations along the way. The following list provides the order of execution during installation, which may be helpful if you need to debug a VPN tunneling installation process.

Start Pre-Installation Process:

Parse command line arguments.

Set appropriate variables via command line.

Process commands, as necessary.

If the command line entry responds with help or version information, the VPN tunneling installation program quits, following the command line processing. Typically occurs when you run the VPN tunneling installer as a standalone installer.

Validate System:

Check OS. If VPN Tunneling does not support this OS version, display error and abort validation process.

Check Administrator privileges.

3rd-party GINA component - if GINA is to be registered, check whether there is any existing registered GINA component. If yes, abort installation.

If there is an existing VPN tunneling installation, trigger the uninstall in upgrade mode of the existing VPN tunneling.

Wait until the existing VPN tunneling uninstallation process completes (in upgrade mode).

If the uninstallation process times-out, display error message and abort the VPN tunneling installation, otherwise, continue the VPN tunneling installation.

Write logging registry keys for VPN tunneling components.

Start VPN tunneling installation.

Shared component installation:

Check sharedDll registry value of the shared components to see if this is the first instance of shared component installation.

Check if Neo_CleanInst flag is set.

If steps a or b are true, ensure the sharedDll registry value is clean.

Stop service if still running.

Check installation and driver

If driver is installed and it is a clean installation, uninstall the driver.

If driver is installed and it is not a clean installation, compare driver versions.

If it is an upgrade, set the driver install flag, otherwise, do not install the driver (keep the current higher version driver).

VPN tunneling component installation:

If the driver install flag is set or if it is a clean install, install the driver.

Call the shared component installation macro for the VPN tunneling service and GINA component. This macro performs a version comparison, ensures a proper upgrade, and increments the sharedDll registry key value.

Copy other VPN tunneling binary files.

Call the NCCopyFile macro for the files that might be locked by msGINA. This macro takes care of renaming old files and mark them delete on reboot.

Save locale and GINA settings in user's config.ini file.

Start the NCService.

Create program shortcut.

Create Uninstall registry keys.

Start VPN tunneling user interface.

End VPN tunneling installation process.

Start Post-Installation Process:

Print product version and append the install log to admin log file

Reboot, if the reboot flag was set.

VPN Tunneling Uninstallation Process Dependencies

During uninstallation, VPN tunneling interacts with a number of system components, performing checks and validations along the way. The following list provides the order of execution during uninstallation, which may be helpful if you need to debug a VPN tunneling uninstallation process.

Start Pre-Uninstall Process:

Parse command line inputs, including:

Locale

Clean uninstall flag

Upgrade flag

Start uninstall operation.

Check Administrator privileges.

Unregister GINA if already registered.

If uninstalling in upgrade mode, stop the VPN tunneling service.

If the uninstallation is not in upgrade mode, check the current sharedDll registry key value. If the value is 1, this is the only instance using the shared components, so:

Uninstall the driver.

Delete the driver file.

Stop and unregister the VPN tunneling service.

Call the shared components macro to uninstall shared components. This macro decrements the SharedDLL registry key value and removes the source file.

If the uninstall process is in upgrade mode, this step is not executed because the uninstall is triggered from a VPN tunneling installation process and the shared component macro in the installation process will handle the shared component upgrade operations.

Delete other VPN tunneling files, including:

dsNcAdmin.dll

dsNcDiag.dll

versioninfo.ini

Call the NCDeleteFile macro to delete the files that may be locked by msGINA.

Delete VPN tunneling registry keys.

Remove VPN tunneling program file directories.

End the uninstall process.

Print the product version and append the VPN tunneling installation log to the Admin log.

Reboot, if the reboot flag was set.