ADMIN-mode INSTALLATION
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
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