Child pages
  • Building the Client Installer - 6.0

This space has moved to IU's Confluence.
It is located at

Skip to end of metadata
Go to start of metadata

You are viewing an old version of this page. View the current version.

Compare with Current View Page History

« Previous Version 7 Current »

Building the Client Installer

How to configure the installers for the installation of the Variations client



After making the appropriate changes to the Variations client configuration files in the previous step. You can now configure the installer for the installation of the Variation's Client

For Windows, NSIS can be used to build installers for end user clients and for digitizer clients. Mac OSX clients are packaged into a .dmg file through Disk Utility. Only end user clients are supported at the moment for Mac OSX.

A technical description of the steps taken by the default NSIS Windows installer and uninstaller can be used for creating an alternative installer using another installer technology.

Create Config / Build Environment



The Mac installation's disk image will need to be created on the Mac OS using the Disk Utility.

Configure Installer



  • In the download directory that contains the Variations folder


  • setup.nsi - End User Client
  • digitizer-setup.nsi - Digitizer/Cataloger Client

Modification Instructions

  • Edit the Values
      • The Company value is used to display information to the users in Windows Explorer
      • The Company value is displayed under the installer filename in the titles view by default
    • URL
      • The url value used to display that information to users in Windows Explorer.
      • The installer uses the userguide url value to add a shortcut to that page from the Start Menu

Also make sure to modify Eula.rtf to reflect the policies of your institution.

See for more information to make broader changes to the installer.


Review the terms of use and installation instructions that accompany the Mac client files to verify that the information is correct for your institution.

  • Modify
    • Important-Installation-Instructions.html
      • Update the user guide link
    • Terms-of-Use.html
      • You will only need to update the terms of use section

Build Installer



  • setup.nsi - used to make end user client installer
  • digitizer.nsi - used to create digitizer/cataloger client installer

Creation Instructions

  • Run NSIS->MakeNSISW from the Start Menu. In newer versions, just start NSIS and pick Compile NSI Scripts from the NSIS window.
  • Load the modified nsi files (setup.nsi and digitizer.nsi): File->Load Script... or by Drag and Drop.

The compiled installers should be created in the directory that contains the nsi scripts.

Installer files

  • setup.exe (result of the setup.nsi script)
  • digitizer-setup.exe (result of the digitizer.nsi script)
    • The digitizer installer file will install the digitizer/cataloger client as well as links to the MP4 GUI Encoder, and the DjVu Standalone Encoder


The Mac client should now be turned into a disk image (DMG) for distribution to other machines.

Make sure that you have any anti-virus software turned off while creating the disk image.

Creation Instructions

  • Run Disk Utility from /Applications/Utilities.
  • Select File -> New -> Disk Image from Folder...
  • Select the folder that contains the software and configuration files (created on previous page) and accept the default Image Format and Encryption options.

Next Steps

You have now successfully created the client installer. Next try installing and running the client. There should already be music files loaded into the system to test the streaming and access capabilities.

For an overview of the windows installer see the information below.

Current Windows Installer Overview

The default installer script for end user clients, setup.nsi, builds an installer which does the following:

  • Displays a welcome page
  • Displays the text of Eula.rtf
  • Prompts the user for an install directory (e.g. C:\Program Files\Variations)
  • Prompts the user for a Start Menu Folder (e.g. Variations)
  • Installs Variations
    • Extracts the Variations folder to the selected install directory (excluding the standalone encoders and dml-digitizer.conf)
    • Creates an uninstaller and places it in the Variations folder
    • Creates on the desktop a shortcut to Variations
    • Creates in the Start Menu folder selected above a shortcut to Variations, the online userguide, and the uninstaller
    • Creates mime type associations in the system registry
    • Creates VARIATIONSDIR system environment variable which points to the install directory
  • Reports the success or failure of the installer
  • (If successful) Reports completed and allows the user to view the Readme.rtf after closing the installer

The default installer script for digitizer clients, digitizer-setup.nsi, builds an installer similar to the end user client installer except that the installation does the following in addition:

  • Creates Desktop shortcuts for the mp4 and djvu encoders
  • Creates Start Menu shortcuts for the mp4 and djvu encoders

The uninstaller generated as part of the installation does the following cleanup steps when run:

  • Prompts the user before uninstalling, displaying the install directory of Variations
  • Uninstalls Variations
    • Deletes system environment variable and system registry values
    • Deletes the install directory
    • Deletes Desktop and Start Menu shortcuts and the Start Menu Folder
  • Reports the success or failure of the uninstall
  • No labels