Documentation Center

Service Host

Version 1.0 | Published November 15, 2017 ©

Installers

The Service Host installer comes in two flavors 

  • ServiceHostBundle-x64*.exe and
  • ServiceHost-x64*.msi

The main difference is that the bundle installer takes care of upgrading an existing installation and installs the required operating system run-times if not already present whereas the msi installer just installs the Service Host.

images/download/attachments/32277465/install_bundle.png
Bundle Installer

Installation

The bundle installer itself is using the msi installer. The msi and other files can be extracted from the bundle. This is mostly used for silent and unattended installs. Please run the bundle with -h command line switch to get all the available options.

Command Line Options for Bundle Installer
Z:\my_path> ServiceHostBundle-x64-1.0.0.68324 -h
 
Z:\my_path>
Running with no parameters will install the product
-s, --silent Runs the installer with no user interaction
 
--msi Extracts all .msi files to a subdirectory
--dump Extracts all files to a subdirectory
--dumpTo=VALUE Extracts all files to the specified path
-h, -?, --help Prints this help

msi Installer

Z:\my_path> msiexec /package ServiceHost-x64-1.99.0.68094.msi /l*vx! install.log

Pre Condition

  • no Service Host is installed prior to the procedure

Post condition

  • Service Host is installed at the indicated location. the default value is %ProgramFiles%/vizrt/ServiceHost

  • configuration and log files are located at %ProgramData%/vizrt/ServiceHost

  • if the configuration of the Control Mode does not exist, then a default one will be created at %ProgramData%/vizrt/ServiceHost/ServiceHost.control.xml

  • the Control Mode is registered as Windows Service and started

  • a shortcut, ServiceHost.control, is created in %ProgramData%/vizrt/ServiceHost to point to the web GUI of the Control Mode

Use this shortcut to verify the installation.

Upgrade an Existing Installation

msi Installer

Upgrade of an existing installation by using the msi installer is possible when doing an uninstall of the old package followed by an install procedure of the new package.

Pre Condition

  • Service Host is installed

  • the Control Mode is running

The uninstallation process write the current configuration and state into Reinstall.profile. This file is then used by the installer of the new package to re-establish the state and configuration.

Post Condition

  • the new version of Service Host is installed

  • the existing configuration and state of the Service Host services is re-established

Uninstall

msi Installer

Z:\my_path> msiexec /uninstall ServiceHost-x64-1.99.0.68094.msi /l*vx! uninstall.log

Pre Condition

  • Service Host is installed

  • zero, one or more services may be registered with this Service Host

  • zero, one or more services may be registered with this Service Host and running

  • the Control Mode has to be running. otherwise the uninstall silently fails

Post Condition

  • The configuration and status of services under this Service Host are stored as the config file location in Reinstall.profile. They can be later used for further installations.

  • any running services are stopped

  • any registered services are unregistered

  • the files under %ProgramFiles%/vizrt/ServiceHost are removed

Note

If the Control Mode is unreachable during uninstallation, it is still possible to uninstall. The dialog will inform users that the Control Mode is unreachable and prompt users to decide to force uninstall, or cancel. But if users decide to do force uninstall, users have do unregister all Service Host services registered as Windows services manually.

images/download/attachments/32277465/image2017-10-24_9-21-7.png

Control Mode

if one wants to register/unregister and start/stop Service Host plugin instances manually please take a look at Control Mode.