Basic windows installer
Switch branches/tags
Clone or download
Latest commit 8dc0fd0 Oct 14, 2016
Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
Branches.txt - Add a file describing how we organize the branches for this reposit… Oct 14, 2016
CONTRIBUTING.md
License.txt
OSVR_logo.ico
README.md Minor updates Jul 16, 2015
RzUninstaller.xml - Preparing to stabilize the branch master to stable. Oct 14, 2016
SetupService.nsi
buildInstaller.bat
makeInstaller.bat
osvr_finish.ini - Preparing to stabilize the branch master to stable. Oct 14, 2016
osvr_includes.nsh - Preparing to stabilize the branch master to stable. Oct 14, 2016
osvr_server.ico Importing into OSVR Jun 11, 2015
osvr_user_settings.json
register_osvr_driver.cmd
sm_splash.bmp - Preparing to stabilize the branch master to stable. Oct 14, 2016
splash.bmp
unregister_osvr_driver.cmd - Preparing to stabilize the branch master to stable. Oct 14, 2016

README.md

OSVR-win-installer

Windows installer for OSVR server application Installer script built with NSIS.

NSIS script: setup.nsi##

  • Uses the following plugins
    • LogEx.dll
    • nsProcess.dll
    • newadvsplash.dll
    • SimpleSC.dll
    • AccessControl.dll

Requirements for running the script:##

  • Name of the script is: setup.nsi
  • Desired distribution directory can be specified at compile time by defining distroDirectory
  • If distroDirectory is not passed in at compile time, the value is defaulted to ../Distro
  • Uses registry value to determine if installed version is newer or older than version contained in the installer
  • The following items must be in the script directory
    • splash.bmp
    • osvr_server.ico
    • license.txt (Apache 2.0 license)
  • A batchfile is provided for Continuous Integration convenience. It takes as its only argument the path that you would like to pass on to define as the distroDirectory
    • the batch file must be modified on the CI target such that the path to makensis.exe is properly set

Installer capabilities:

  • checks for free drive space before installing
  • checks that installed version is less than the version about to be installed
  • logs messages with timestamps to diagnose installer/uninstaller issues
  • uses osvr.ico for start menu and uninstaller entry in the control panel
  • uninstall shows up in the control panel
  • deletes all OSVR files upon uninstall
  • cleans up registry upon uninstall
  • stops osvr_server.exe before uninstalling or updating without user intervention
  • install and uninstall do not require restart
  • starts osvr_server.exe after installer completes
  • starts osvr_server.exe upon login for all users
  • read version number from osvr_server.exe in the distribution
  • read distro install size from distribution to use to check for available disk space
  • installs a registry key to facilitate plugin installations: HKLM/Software/OSVR/installationDirectory
  • installs an environment variable to facilitate plugin installations: OSVR_INSTALL_DIR

Improvements:

  • osvr_server.exe needs to be converted into a service