Help us improve your experience.

Let us know what you think.

Do you have time for a two-minute survey?

Guide That Contains This Content
[+] Expand All
[-] Collapse All

    Network Connect installer Overview

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

    Network Connect Installation Process Dependencies

    During installation, Network Connect 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 Network Connect installation process.

    1. Start Pre-Installation Process:
      1. Parse command line arguments.
      2. Set appropriate variables via command line.
      3. Process commands, as necessary.
      4. If the command line entry responds with help or version information, the Network Connect installation program quits, following the command line processing. Typically occurs when you run the Network Connect installer as a standalone installer.
    2. Validate System:
      1. Check OS. Network Connect support for Windows 98, Windows 2K, and Windows XP only. If OS is 95, ME or NT 4.0, display error and abort validation process.
      2. Check Administrator privileges.
      3. 3rd-party GINA component – if GINA is to be registered, check whether there is any existing registered GINA component. If yes, abort installation.
    3. If there is an existing Network Connect installation, trigger the uninstall in upgrade mode of the existing Network Connect.
    4. Wait until the existing Network Connect un-installation process completes (in upgrade mode).
    5. If the un-installation process times-out, display error message and abort the Network Connect installation, otherwise, continue the Network Connect installation.
    6. Write logging registry keys for Network Connect components.
    7. Start Network Connect installation.
    8. Shared component installation:
      1. Check sharedDll registry value of the shared components to see if this is the first instance of shared component installation.
      2. Check if Neo_CleanInst flag is set.
      3. If steps a or b are true, ensure the sharedDll registry value is clean.
      4. Stop service if still running.
      5. 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).
    9. Network Connect component installation:
      1. If the driver install flag is set or if it is a clean install, install the driver.
      2. Call the shared component installation macro for the Network Connect service and GINA component. This macro performs a version comparison, ensures a proper upgrade, and increments the sharedDll registry key value.
      3. Copy other Network Connect binary files.
      4. 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.
      5. Register GINA if GINA flag is set.
    10. Save locale and GINA settings in user’s config.ini file.
    11. Start the NCService.
    12. Create program shortcut.
    13. Create Uninstall registry keys.
    14. Start Network Connect user interface.
    15. End Network Connect installation process.
    16. Start Post-Installation Process:
      1. Print product version and append the install log to admin log file
      2. Reboot, if the reboot flag was set.

    Network Connect Un-installation Process Dependencies

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

    1. Start Pre-Uninstall Process:
      1. Parse command line inputs, including:
        • Locale
        • Clean uninstall flag
        • Upgrade flag
    2. Start uninstall operation.
    3. Check Administrator privileges.
    4. Un-register GINA if already registered.
    5. If un-installing in upgrade mode, stop the Network Connect service.
    6. If the un-installation 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:
      1. Uninstall the driver.
      2. Delete the driver file.
      3. Stop and un-register the Network Connect service.
    7. Call the shared components macro to uninstall shared components. This macro decrements the SharedDLL registry key value and removes the source file.

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

    8. Delete other Network Connect files, including:
      • dsNcAdmin.dll
      • dsNcDiag.dll
      • versioninfo.ini
    9. Call the NCDeleteFile macro to delete the files that may be locked by msGINA.
    10. Delete Network Connect registry keys.
    11. Remove Network Connect program file directories.
    12. End the uninstall process.
    13. Print the product version and append the Network Connect installation log to the Admin log.
    14. Reboot, if the reboot flag was set.

    Published: 2011-03-14