Changing the Installation and Environment Variables

As is the case with Windows, you can change the Innovator installation in the system at a later stage. You can change environment variables in the administration program.

Changing the Installation at a Later Stage

The Programs and Features function can be used in the system control for changing entries made upon installation at a later stage - as is often the case in Windows.

You have the following options for an existing installation:

Repair should be required only rarely since this replaces the installation files.
Change can be used after an incorrect installation to correct or expand the installation, e.g. from a single client installation to a complete installation.
Uninstall deletes Innovator from the computer. Modified files such as your license file, repositories that you have created, configuration files for the client in the home directory and temp directories are retained.

User-specified settings can also be removed during interactive removal of Innovator. Click on Change in the control panel to do this.

Note

If you use the InnovatorEnterprise-en-US.exe bundle installer for installation, then no modification option appears in the interface for Modify.

You must use the InnovatorEnterprise.msi MSI file for this; this was stored in the C:\ProgramData\Package Cache directory on your system upon installation.

It can be found here in a sub directory with the same name as the UUID and the installation version number (e.g. {4561E94B-D563-44A9-A713-E2FD8CE0081D}v16.0.20225). Search for "v16.0" or for the MSI file in the Package Cache directory and use the newest version.

Double-click on the MSI file to see the options described above.

Changing the Environment Variables

To change the values of the Innovator environment, use the Environment backstage view in the Administration Program or the Options dialog.

The current environment variables are displayed and managed separately for the system and the user. User settings have priority over system settings.

Note

System variables can only be changed, created or copied from the user variables if you start the program as a Windows administrator.

Note

The relevant directories are not copied when you change the environment, which means that the specifications can only be a reconstruction of a change at file level.

You can use buttons to add or delete environment variables and to copy the value of the selected environment variable to the user or system variable. (The last option requires the Administration program to be run as Windows administrator.)

Windows environment variables in the form %EnvironmentVariable% can also be used for directory specifications, e.g. %APPDATA% or %HOMEPATH%.

Note

You can also make use of UNC notation for path specifications.
Example: \\userver\innovator\16.0\rep

The environment variables are stored in the Windows registry.

Attention

All Innovator programs must be shut down on the computer so that changes can be implemented. The next time an Innovator program is called, the new settings will be used.

Table: Overview of Environment Variables
Meaning	Variable	Description
Interface Language	INOLANG	Language in which to work with Innovator. The installation file language is used as default.
License Server Computer	INOHOST	Computer on which the license server is to run and details of the communication channels in the format <License server host name>.<port number>
Settings (Parameter Files)	INODIR	Directory path that the parameter files are or will be stored on; icons and the Java files for engineering actions etc. can also be found here. You can use a shared workgroup directory and, in doing so, use common settings.
License directory	INOLIC	Directory path where license repositories are stored as standard.
Project Directory	INOPRJ	Directory path where you will find or can store repositories as standard. Configuration files for the model server can be found here.
Working Directory for Notification Service	INONOTIFY	Optional: The `innonotify.json` configuration file's directory path for the notification service. If the environment variable is not set and notifications are set-up, then the configuration file is set in the `$INOPRJ\inonotify` directory. The notification service's database and log files are also stored in the directory.
Temporary Directory	INOTMP	Optional: In Windows, Innovator stores temporary files to the directory specified in the `TEMP` environment variable by default. If this variable is not set, if this causes problems or if you want Innovator to use another directory for storing temporary files, set the `INOTMP` variable.
User-Specific Settings	INOHOME	Optional: The parameters in the `INODIR` directory are intended as central defaults. The individual user can override these specifications using their special settings. These are stored in the `INOHOME` directory. If this variable is not explicitly set, then a subdirectory is automatically used in the operating system's %APPDATA% directory.
Custom Icons	INOICON	Optional: Innovator manages the icons used in the model editor and administration program, in icon libraries. It manages the bitmap icons used in the Configuration Editor in subdirectories in from `$INODIR\icons`. You can specify further directories (preferably one) as the source for your own icons with `INOICON` Create the icon directories locally if network access takes too long.
Central Path for Your Own Icons in the Network	ICON_DEPLOYMENT_PATH	Optional: If your own icons are also stored locally as are the Innovator icons: `INOICON` i.e. on a local drive, then your own icons can be automatically updated on a central icon directory when an update is carried out upon program start for the model editor. Set the `ICON_DEPLOYMENT_PATH` and `ICON_PATH` environment variables for this. Longterm use of both variables delays program start by a few seconds so that the directories can be compared.
Local Path for Your Own Icons	ICON_PATH	Optional: See `ICON_DEPLOYMENT_PATH`
Central Path for Plug-Ins in the Network	PLUGINS_DEPLOYMENT_PATH	Optional: If plug-ins which were not included within the scope of delivery of Innovator are used, then you can use environment variables to simplify the central provision and updates of this plug-in. The environment variable specifies a central directory for all plug-ins and allow the local plug-in directory to be updated when the model editor is started. The central directory must contain the directories for all plug-ins which should be available to the clients. Longterm use of variables may delay program start by a few seconds so that the directories can be compared.
Local Path for Plug-Ins	PLUGINS_PATH	Optional: Specifies a central directory for all plug-ins and allow the local plug-in directory to be updated from the central plug-in directory when the model editor is started. Longterm use of variables may delay program start by a few seconds so that the directories can be compared.
Deleting Plug-Ins in the Target Directory	PLUGINS_DELETE_WHEN_COPYING	Optional: In conjunction with the `PLUGINS_DEPLOYMENT_PATH` and `PLUGINS_PATH` plug-ins, enables a complete comparison of the plug-in's source and target directories.
Directory for the Innovator Help	HELP	Optional: Storage location for local help files if Internet access is not possible.
Server Response Interval	INOSRV_INFORM_TIME	Optional: If the connection between the client and the servers in distributed environments is provided by network elements that close the connection between client and server if it has been inactive for a certain period of time, then an interval can be set here, after which time the client will send a dummy telegram to the server. The value is the time in seconds. The usual intervals are 300 to 1200 seconds.
NAT Host Name	INO_NAT_HOSTNAME	Optional: Enables environment integration with Network Address Translation (NAT). You only need to set the environment variable on computers which the license server is not running on. The external computer with the host name given as the environment variable must be released to a valid IP address via DNS. All components use this host name when communicating, regardless of the host name logged-in to that computer. The set NAT host name is shown as host name in the administration program and in all interfaces. Innovator does not support implementation of communication ports via NAT.
Network Card	INO_NAT_IPADR	Optional: Sets the network card for communication with the model server or agents for a computer with multiple network cards which a model server or agent is running on. Must be set in the system variable. If environment variables should be used for an agent, then the agent should be installed as a service once the environment variables have been set.

Attention

A change to the computer name in the INOHOST entry means that the computer which the license server is running on has changed. You should bear in mind when using a license file that in this case the Innovator licenses will have to be re-activated by MID GmbH. With subscription licenses, the user can activate the license repository in the administration program's Help & Support backstage view themselves.

Restriction

If INOPRJ is changed once an agent service has been installed on the system environment, then the agent service needs to be uninstalled and reinstalled. This is because INOPRJ is set for the agent upon service installation (inoagent does not read the registration).

If INOLIC (or INODIR if INOLIC is not set) is changed once a bus service has been installed on the system environment, then the bus service needs to be uninstalled and reinstalled. This is because the log directory is set for the bus upon service installation (inobus does not read the registration).

Environment Variables for Innovator Services

You can run license and model servers as services in Windows.

Use the Administration Program (InnoAdministration.exe) to manage services.

Note

The Innovator services can only be added, copied, applied, removed or changed if you start the program as a Windows administrator.

To manage the services, open the Services backstage view in the Administration Program.

You can define the following as the start type:

Automatically (with Windows start)
Automatically (delayed start) or
Manual

Note

The Automatic start type is recommended for the license server, Automatic (Delayed Start) start type for the model server.

If problems arise, you can increase the waiting time value for the automatic start type in seconds using the environment variables.

Table: Environment Variables for Innovator Services
Meaning	Variable	Description
Waiting time upon automatic service start	INO_SERVICE_START_WAIT_TIME	You can set the time an Innovator service with the Automatic or Automatic (Delayed Start) start type waits upon starting before it accesses other services. The value sets the time in seconds that an Innovator service waits upon starting before it enables other services to launch before it, e.g. "30" (seconds).