MSI Package enaio® client

enaio® 9.10 »

This MSI package allows enaio® client to be conveniently installed and updated. It is ideally suited for installation using software distribution tools on the computers of multiple users without any user input.

MSI installations require administrator rights and should be carried out using an administrator command line when user account control is enabled.

For installation of the MSI package, the enaio® server that is set up and all services are running and accessible, and the MSI package to be installed must have the same version as the running system.

The MSI package enaio clientinstallation.msi is located under \ClientMSI\ in the installation data.

Only the standard installation procedure is described in this document. For project-specific installations, please contact the OPTIMAL SYSTEMS support department.

Note that configuration with command line parameters is not supported by all software distribution tools. For example, policy-based software distribution in an Active Directory does not support passing command line parameters.

Installation Requirements

Before installing the MSI package, the Microsoft Visual C++ 2015 SP1 Redistributable Package (x86) must be installed on all computers in the version corresponding to your operating system language.

In addition, .NET Framework 4.6 (or higher) is required for the installation of the MSI package.

By default, the installation will not check whether these requirements are met. You can enable the requirement check with the command line parameter CHECK_PREREQUISITE=1.

Installation – The Configuration File asinit.cfg

The installation installs the asinit.cfg configuration file from the same directory. This file requires the connection data to the server and may contain other optional parameters (The Configuration File 'asinit.cfg'):

  • The 'SERVER#PORT' placeholder can be replaced by the connection data in the enclosed configuration file. The configuration file may contain other optional parameters. It is then installed as edited.

  • If no changes are made, localhost#4000 is entered in the installed configuration file. The server and port must be added.
  • Alternatively, the server and port can be entered via command line parameters during installation. The data is entered into the installed configuration file: msiexec.exe /i "C:\enaio Clientinstallation.msi" SERVER_IP=10.10.10.10 SERVER_PORT=4000

Installation

The MSI package installs in the directory C:\Program Files\OPTIMAL SYSTEMS\OSECM\clients\client32 by default.

The following command line parameters allow you to individually configure the installation.

INSTALLDIR=C:\enaio

Specify installation directory

Default: C:\enaio

The specified path will automatically be appended with \clients\client32.

CLIENT_LOGPATH=d:\client-logs

Specify log directory

Default: <Installationdirectory>\log_client

/qb

Show progress bar

/qn

Do not show installation dialogs

/log D:\msi.log

Specify MSI log directory

REGISTER_MSDEBUGGER=1

Register Microsoft Debugger files

Necessary for debugging events.

Command line parameters can be freely combined with other command line parameters.

More command line parameters can be found on the following web page:

https://docs.microsoft.com/de-de/windows/win32/msi/command-line-options

After successful installation, the MSI package offers a maintenance mode. You can update or remove the software in maintenance mode. The latter is also possible via the Windows Control Panel.

It was also possible, up until version 8.50, to install additional components using the MSI package for enaio client. This is no longer the case. This also applies to updates.

Uninstalling

Uninstallation is performed using the software distribution tool of your choice, similar to the installation of the MSI package.