KB5940: How to restart Microstrategy Intelligence Server automatically?

Restarter is a feature in Strategy Intelligence Server that restarts the Strategy Intelligence Server automatically if the process is terminated abnormally. The Restarter can be configured to restart the Intelligence Server service automatically if it fails, but the machine on which it is installed is still running. The Strategy Listener service must be running for the restarter feature to work.
 
This feature is turned on by default. Using the default setting, Strategy Intelligence Server is restarted within six seconds after the process is terminated abnormally. If the process is again terminated abnormally within ten minutes from the first occurrence, Strategy Intelligence Server does not restart automatically anymore.
 
This feature is turned on again if any of the following happens:

1. Ten-minute period from the first occurrence has passed.
2. Strategy Intelligence Server is started manually.
3. Strategy Listener is restarted.

 
To start Intelligence Server service automatically (when it fails unexpectedly) using the Restarter:

1. Go to Strategy-> Tools ->Service Manager
2. In the Server drop-down list, select the machine on which the Strategy Intelligence Server service is installed.
3. In the Service drop-down list, select Strategy Intelligence Server.
4. Click Options. The Service Options dialog box opens
5. On the Intelligence Server Options tab, select the Enabled check box for the Re-starter Option.

The governing settings for this feature are stored in the Windows registry. The procedure below describes how to adjust the settings.
 
Note: Remember to restart Strategy Listener after any changes that are made in this registry.
 
 
All the settings described below can be found in:
.
 

 
 
Turn automatic restarter on or off:
The following procedure describes how to turn on and off the restarter feature:

1. This setting is enabled by default. To turn off the restarter feature, set the 'EnableRestart"'dword to 0.
2. To turn it on, set the 'EnableRestart' dword to 1.
3. Restart Strategy Listener after the registry modification.

 
Additional Settings:
 
Maximum time before Strategy Intelligence Server is restarted:
The following procedure describes how to adjust the checking frequency. It specifies the time between two service checkings (during this time the restarter waits for the event log). In users' perspective, this setting can be thought of as the maximum time allowed before Strategy Intelligence Server is restarted.

1. Add the dword 'WaitEventTimeout'.
2. The time is specified in milliseconds. The default value is 6 seconds = 6000 ms.
3. The maximum values for this setting is 60000 ms (1 minute).
4. Restart Strategy Listener after the registry modification.

 
Maximum number of times server is restarted within the 'RestartTimeout' time:
The following procedure describes how to adjust the maximum number of times the restarter tries to restart the service within a given period of time (that is set by another setting: RestartTimeout ). The default value of this setting is '2', which means that the Strategy Intelligence Server is restarted only once during the period of time.

1. Add the dword 'MaxRestarts'.
2. Enter the number of retries.
3. Restart Strategy Listener after the registry modification.

 
Period of time where maximum number of Strategy Intelligence Server restarts apply:
The following procedure describes how to adjust the period of time where the MaxRestarts setting applies. After this period of time is exceeded, the MaxRestarts setting is reset. The default value is '10 min' (ten minutes) specified in multiple of WaitEventTimeout. As the default value of WaitEventTimeout is '6 seconds', then 10 minutes corresponds to 100 times this value.

1. Add the dword 'RestartTimeout'
2. Enter the period of time as the multiple of WaitEventTimeout. For example, if users enter '2', it means the period is only 2 * WaitEventTimeout.
3. Restart Strategy Listener after the registry modification.

 
Lock Timeout:
The following procedure describes how to adjust the time the restarter waits for the executable to be unlocked before trying to restart the service. The default value is '1 min' (one minute), expressed in multiple of 500 milliseconds.
 
Note: It is not recommended to modify this setting.

1. Add the dword 'LockTimeout'.
2. Enter the period of time as the multiple of WaitEventTimeout.
3. Restart Strategy Listener after the registry modification.

 
The restarter is controlled by two other registry values:
 
RestarterFrequencyInSeconds

 
 
This value controls how often the Strategy Listener checks the Intelligence Server's status for an unexpected shutdown.
 
RestartIfProcessUnexpectedlyQuit

 
 
This controls whether the restarter will apply to the production server instance, CastorServer. If this value is 0, the Intelligence Server will not restart automatically if it shuts down unexpectedly. If it is 1, automatic restarts are enabled.
 
 
WARNING:
Modifying registry values incorrectly may cause serious, system-wide problems that may require the re-installation of Microsoft Windows NT. Any edit of the registry is done at the user's own risk. Since these are user-initiated changes, they are not covered by any Strategy warranty. If using Microsoft Windows NT, the user should backup the registry and/or update an Emergency Repair Disk (ERD) prior to alterations.