Viscosity has been designed so it can be bundled with pre-configured connections and preferences so you can distribute a single installer, ready to go to your clients and customers, friends or family.

Requirements

You require a few things in order to bundle Viscosity for Windows:

• Inno Setup Unicode - http://www.jrsoftware.org/isdl.php#stable
• ISTool - http://sourceforge.net/projects/istool/
• The latest version of Viscosity for Windows.
• Your connections. We highly recommend you use connections that have been exported from Viscosity, or taken from your Viscosity Preferences folder, located at C:\Users\<Your username>\AppData\Roaming\Viscosity\OpenVPN or C:\Documents and Settings\<Your username>\Application Data\Viscosity\OpenVPN if you use Windows XP.

How To Compile Your Bundle

• Download the bundle package http://www.thesparklabs.com/data/kb_f.../win_bundle_example.zip
• Extract the bundle somewhere to your computer
• Place the latest version of the Viscosity for Windows installer in this folder, ensuring you rename it to "Viscosity Installer.exe".

• Go to the "Preconfigure" folder, there are three folders in here. Place your Settings.xml file in this folder, then place your connections in separate folders inside one or more of these folders. (After opening Viscosity for the first time, a Settings.xml file will be created with default settings. The Settings.xml is located at C:\Users\<Your username>\AppData\Roaming\Viscosity or C:\Documents and Settings\<Your username>\Application Data\Viscosity if you use Windows XP. Ensure you remove the Launch key and string before distributing it.)

• The folders represent the following and import in the following order:
  • Connections-Overwrite - Connections in this folder will overwrite connections of the same name already listed in Viscosity
  • Connections - If Viscosity already contains connections with the same name as connections in this folders, the user will get the choice if they with to overwrite those connections, or for them to be appended with an altered name (the original name followed by a number), or not imported at all.
  • Connections-Append - Any connections in this folder will be automatically appended with an altered name.

• Go back to the top directory of the bundle, right click "setup.iss" and select "Open with ISTool".
• You can alter the values of "AppName", "AppPublisher", "AppVersion", "AppPublisherURL", "AppSupportURL", "AppUpdatesURL" and the Languages section to reflect your company and requirements.

• Go to File->Save to save any changes you make.
• Go to Project->Compile Project
• Your bundled installer will now be located in the Output Folder.

We recommend you test the installer to ensure it has the desired effect.