OEE Coach Software Help
Print
Table of Contents

ADMIN-mode INSTALLATION

MSI Installer

OEE Coach installer is build using MS open source software WIX Toolset, which provides the same install experience as Windows installer (msi).

Setup Files

OEE Coach setup is done by using only one file:

  • OEECoach.exe

This is the main setup application that first checks whether OEE Coach is already installed. If so, it gives you the choice (after selecting the Language) to reinstall, modify or remove the software.

Rights needed

In order to install or update OEE Coach, the OEE Coach installer needs elevated privileges.

OEE Coach will by default install itself in the %ProgramFiles (x86)% folder. Application specific settings are stored in %AppData% folder. Upon completion of installation procedure, system does not need to be restarted, unless prompted to do so by operating system itself.

After the installation process has completed, running the OEE Coach software does not require elevated rights.

Overview Setup Process

Step Action
1 By default, OEE Coach will be installed in %ProgramFiles% \OEECoach folder, but user can change the installation folder.
2 Setup copies all the files OEE Coach software requires to run correctly
3 Setup also places shortcuts on the desktop and start menu
4 Language files are placed in %ProgramFiles% \OEECoach. If your business requires specific translations for the software, all future updates of language files need to be handled manually. This means placing the language files on the network share, and setting all clients to read language files from that location. Upon installing each new version, administrator must check for and translate all new language terms (keys) that can appear in new versions.
5 Upon completion operating system does not need to be restarted, unless prompted to do so by the operating system itself.
6 When OEE Coach is started for the first time, it will prompt user to enter SQL Server credentials required to connect to database (DatabaseTool will be started).
7 If database does not exist, the OEE Coach DatabaseTool can be used to create one. When a new database is created, initial data can be inserted (recommended)
8 The application configuration, along with other, is stored in C:\ProgramData\OEECoach\OEECoach.xml file. (Database) passwords are written encrypted. This means all settings can be configured on one machine, and then distributed on all other machines in network. Make sure the user has Write-priveleges.
9 OEE Coach can be set to update itself automatically, and it can use FTP server or a network share (preferable) as a source for new version. OEE Coach will check for new version on each application start. If it detects new version, it will install new update. By default, auto-update is turned OFF in System preferences. When software update requires database update also, administrator should manually upgrade it using the Database Tool.
10 OEE Coach software is by default configured to send information about any unexpected problems that could occur during the run. It uses file transfer protocol to send this information, so all clients should have their firewall adjusted to allow OEE Coach to send this information to external FTP server. Information that is send contains data about the exception itself, and can optionally contain dump file that contains information about the operating system and hardware that this exception occurred in.

Setup Modes

OEE Coach setup can run in three modes:

  • user-interactive
  • passive
  • silent

User-interactive mode is the default mode, where the user uses a graphical interface to navigate through setup wizard.

Passive mode is the mode where installation is unattended, but user can still monitor the setup process status.

Silent mode is the mode where installation is unattended, and nothing is displayed to user. Setup process is running in the background.

Both passive and silent modes supports command line arguments, which can be used to set the setup options. You can use most standard windows installer arguments, like:

Installer Switches

Switch Description
/quiet Quiet installation, no user interaction is required.
/passive Only a progress bar is displayed
/norestart After setup is completed, system will not be restarted. If not used, system will be automatically restarted after setup is completed, if required.
/promptrestart After setup is completed, if system needs to be restarted, a message box will pop out, asking user to restart the system.
/log Setting a path to log file (also applicable in manual mode)
/uninstall Starts the uninstall process
/repair Starts the repair process.
/modify Modifies the existing installation, by adding / removing features
InstallFolder Sets a folder path where OEE Coach will be installed
InstallDatabaseTools yes: Database tools will be installed

no: Database tools will not be installed (default), or will be uninstalled, if already installed.

InstallConnectionTools yes: Connection tools will be installed

no: Connection tools will not be installed (default), or will be uninstalled, if already installed.

InstallLanguageTools yes: Language tools will be installed

no: Language tools will not be installed (default), or will be uninstalled, if already installed.

Examples of passive/silent Installation

  • silent install, system will not be automatically restarted (if required), database tools will be installed, providing a path to a folder where to install the software:

Setup.exe /quiet /norestart InstallDatabaseTools=yes InstallFolder=Path

  • silent install, uninstall database tools (if installed) and install language tools

Setup.exe /quiet /modify InstallDatabaseTools=no InstallLanguageTools=yes

  • silent uninstall

Setup.exe /quiet /uninstall

  • silent repair

Setup.exe /quiet /repair

  • passive install, install language tools

Setup.exe /passive InstallLanguageTools=yes

  • passive install, create a log file in the same folder where setup is

Setup.exe /passive /log log.txt

Previous USER-interactive INSTALLATION
Next How to connect to the DATABASE