Integrated Service Management Under Windows

Use the administration program to install, start, exit or remove services.

Managing Services Under Windows

You can use the Services backstage view in the Administration Program to install, start, close and remove Innovator services. This also sets how the system is started. You can enter a description for each Innovator service.

Installed services appear in the list of known Innovator services.

You can also manage and delete services for older or already uninstalled Innovator versions here.

Restriction

Managed models (model versions) do not need to be set up manually as services. The agent carries out this task automatically. It ensures that model versions started via the agent are entered as services. This ensures that model versions that were not explicitly closed are available when a system is restarted.

Installing Services for Servers, Agents and Buses

Options for Services

To execute an Innovator server as a service, the server must first be made known to the system.

License server addresses (<Inohost>) always need to be specified as

<License server host name>.<Port number>

The following programs can be installed as services with their corresponding options:

License server: inolsrv [options]

If a license server is started as a service, then the bus cannot be implicitly started due to technical reasons. It also needs to be started as a service.
- /I <Inohost>
  
  Use the specified Innovator host.
  
  Is used for setting your own address for a license server. Only needs to be filled if the INOHOST configured system variable should not be used for this Innovator version.
- /L <Inohost_main>
  
  Use the specified main license server.
  
  Only used for starting a project license server.
Model server: inosrv [options] <repository>

The model server options take affect as of /N for previous settings in the repository's settings if the /l (read-only mode) is not set. Otherwise they are used for the service without overwriting the properties.
- /L <Inohost>
  
  If this deviates from the $INOHOST environment variable, use given Innovator host.
  
  Used for setting the license server the model server should be registered on. Is only used if the main and project license servers are the same version.
- /E <Inoprj>
  
  If this deviates from the $INOPRJ environment variable, use project directory.
  
  The complete \config directory needs to be in this directory!
- /t <Port>
  
  Use port entered.
  
  If the port is not available, an error message appears and the process is canceled.
- /l (lower case L)
  
  Use read-only mode.
- /N <Time>
  
  Log-out non-active users after this time (at least 10 minutes). 0 deletes existing settings.
- /n <Time>
  
  Mark non-active users as 'inactive' after this time (at least 10 minutes). 0 deletes existing settings.
- /u <Time>
  
  Time intervals the update will be carried out in (in minutes).
- /U <Time>
  
  Time the update will be carried out in (hhmm format). Option can be entered more than once.
- /U none
  
  Deletes existing update times.
- /O <Mode>
  
  Deactivate (false) or activate (true) single sign-on. Single sign-on is the default for a newly-created repository.
Agent: inoagent [options]
- /L <Inohost>
  
  Use license server entered.
- /E <Inoprj>
  
  Monitor project directory entered.
- /t <Port>
  
  Use port entered.
Bus: inobus [options]

If a license server is started as a service, then the bus cannot be implicitly started due to technical reasons. It also needs to be started as a service.
- /L <Inohost>
  
  Use license server entered.

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).

Example Calls

Installing an Innovator Server as a Service

Prerequisites

The Administration Program needs to be started as Windows administrator to be able to add services.

Context

Services are primarily installed for automatic preparation of license and model servers for the current Innovator version in the network. Preparation as a service can only occur once for each server.

Note

If you do not install the service using Innovator's integrated service management, activate the Allow service to interact with desktop check box in the respective property dialog in the Login tab in Window's service management.

You can make the following selection for service start type:

Automatic (Delayed Start)

The service is started automatically with a delay when the system is started up.
Automatic

The service is started automatically when the system is started up.
Manual

The service can be started by a user. These services are not started automatically when the system starts up.
Disabled

This prevents a service from being started by the system or a user.

Note

Automatic start type is recommended for the license server.

Automatic (delayed start) start type is recommended for the model server.

How to proceed

Jump to the Services backstage view in the administration program.
Click on Add....

The Install Service dialog appears.
Enter the command line for installing the service in the Command field (see above).
In the drop-down list of the same name, select the start-up type for the service.
To specify a name that deviates from the recommended default, enter a unique name into the Display name text box.
Enter a comment about the service in the Description text box, e.g. for use and state.
Confirm your entry with OK.

The server is then installed as a service and appears in the list of known services, e.g.
Innovator 16.0: inosrv RO Demo.

To change specifications, click on Properties.

Copying or Adopting Services

Prerequisites

The Administration Program needs to be started as Windows administrator to be able to copy or add services.

The service to be adopted in the current version needs to belong to a previous version.

Context

You can copy a service from the current Innovator version to reuse existing specifications as defaults.

The Copy... button opens the dialog for installing a service. The dialog is prefilled with the data of the selected service. These specifications must be adjusted for the new service.

How to proceed

Jump to the Services backstage view in the administration program.
Select the service that you want to use as a template.
Click on Copy....

The Copy inosrv Service dialog appears.
Enter the name of the repository whose model server you want to set up as a service in the input field and confirm with OK.

The Install Service dialog appears. The repository name replaces the name of the repository from the previously selected service.
Correct and change the command line for installing the service in the Command field (see above).
In the drop-down list of the same name, select the start-up type for the service.
To specify a name that deviates from the recommended default, enter a unique name into the Display name text box.
Enter a comment about the service in the Description text box, e.g. for use and state.
Confirm your entry with OK.

The server is then installed as a service and appears in the list of known services, e.g.
Innovator 16.0: inolsrv [<inohost_prj>].

Starting an Installed Innovator Service

Context

Services with the Automatic or Automatic (Delayed Start) start type are started automatically when Windows is started

How to proceed

Jump to the Services backstage view in the administration program.
Select a service in the table which has an empty status field.
Click on Start.

The service is started.

Exiting and Removing an Installed Innovator Service

Prerequisites

The Administration Program tool needs to be started as Windows administrator to be able to remove services.

Context

Before a service can be removed, it must be stopped.

Removed services are no longer available. However, this does not mean that repository data is deleted. The server can be reinstalled as a service at any time.

How to proceed

Jump to the Services backstage view in the administration program.
Select a service with the Started status in the table.
If you want to end the service, click on Stop.

The service is stopped.
If you want to remove the service, click on Remove.

The service is removed.

Displaying Log Files

A log file is generated for each Innovator server.

The log file of a server can be displayed in the right-hand information area in the administration program if a license or model server is selected. The log since the last time the server was started is displayed directly, and the entire log can be saved to a file. Log files are only shown for services which have the same release as the program running.

A model server's log file can also be opened under Windows using a button in the server dialog.

The log files also contain error messages from the server; you should therefore check these files when a server fails to start.