mngautorun (Set up/canceling the set up of autostart and autorestart)

Organization of this page

Format
Functionality
Arguments
Return values
Input examples
Notes

Format

When setting up the auto start of Management Server and Administration Agent

In Windows

mngautorun [once] {server|agent|both} [-sync [-timeout synchronous-execution-timeout-time]]

In UNIX

mngautorun [once] {server|agent|both} [-runlevel <run level>] [-sync [-timeout synchronous-execution-timeout-time]]

When setting the auto start and auto restart setting of Management Server and Administration Agent

In Windows

mngautorun respawn {server|agent|both} [-sync [-timeout synchronous-execution-timeout-time]]

In UNIX

mngautorun respawn {server|agent|both} [-runlevel run-level]

When cancelling the auto start and auto restart of Management Server and Administration Agent

In Windows

mngautorun -d

In UNIX

mngautorun -d

To Page Top

Functionality

Sets or cancels the auto start and auto restart settings of Management Server and Administration Agent. It can be used to do the following:

Set Management Server service and Administration Agent service to automatically start at the time of system startup.
Set a dependency relationship so that the Administration Agent starts automatically before Management Server starts when Management Server and Administration Agent services both start at the time of system startup.
Perform the setting such that Management Server and Administration Agent restart automatically at the time of failure.
Cancel the settings of auto start and auto restart for Management Server and Administration Agent.

Note that this command is for Windows only.

To Page Top

Arguments

When no arguments are specified, the command's usage is displayed.

-d

Disables the auto start and auto restart of Management Server and Administration Agent.

once

Enables the auto start of Management Server or Administration Agent. The auto restart setting is not enabled. When both the once and respawn options are omitted, operations are performed such that the once option is specified.

respawn

Enables the auto start and auto restart of Management Server and Administration Agent. When both the once and respawn options are omitted, operations are performed assuming that the once option is specified.

server

Enables the auto start or auto restart of Management Server.

agent

Enables the auto start or auto restart of Administration Agent.

both

Enables auto start and auto restart of Management Server service and Administration Agent service, and sets a dependency relationship so that the Administration Agent starts before Management Server starts.

-runlevel

Specifies the run level for executing the auto start and auto restart. You can specify multiple run levels. This option is valid only for UNIX. For run level, see the OS document.

The following is an example of specification:

Example:: -runlevel 23456

If this option is omitted, the command assumes that 2 is set.

-sync

When executing the auto start or auto restart, enables the synchronous execution with the startup of Management Server and Administration Agent. In UNIX, you cannot specify this option, when you specify the respawn option.

-timeout synchronous-execution-timeout-time

Specify the waiting time (unit: seconds) until Management Server and Administration Agent starts, during auto start and auto restart, with the integer 0 or from 61 through 2147483. The process continues until the auto start of Management Server and Administration Agent, without an occurrence of a timeout. If you omit this option, the synchronous execution timeout is 120 (seconds). In UNIX, you cannot specify this option, when you specify the respawn option.

To Page Top

Return values

0:: The command is terminated normally.
1:: An error occurred at the time of execution.
2:: A syntax error occurred.

To Page Top

Input examples

Input example 1

Start both Management Server service and the Administration Agent service when the OS starts:
```
mngautorun both
```
Input example 2

When performing the auto start and auto restart for both Management Server and Administration Agent.
```
mngautorun respawn both
```
Input example 3 (In UNIX)

When starting the auto start and auto restart for both Management Server and Administration Agent in run level 3
```
mngautorun respawn both -runlevel 3
```
Input example 4

When canceling the auto start and auto restart of Management Server and Administration Agent
```
mngautorun -d
```
Input example 5

When the auto start executes for Management Server and Administration Agent with a synchronous execution (setting the timeout as 180 seconds)
```
mngautorun once both -sync -timeout 180
```
Input example 6 (in Windows)

When the auto stat and auto restart executes for Management Server and Administration Agent with a synchronous execution (setting the timeout as 180 seconds)
```
mngautorun respawn both -sync -timeout 180
```

To Page Top

Notes

In Windows, take care of the following points in Management Server and Administration Agent for which a dependency relationship is set with the both option.
- When you specify the both option and execute the command, restart the machine. If you do not restart the machine, the dependency relationship of Management Server and Administration Agent is not set.
- When you specify the -d option and execute the command, restart the machine. If you do not restart the machine, the dependency relationship of Management Server and Administration Agent is not disabled.
- Stop Management Server when you stop Administration Agent for which auto restart setting is done. If you stop Administration Agent before Management Server, then the Administration Agent is restarted.
In UNIX, if you manually change the entry identifier registered in /etc/inittab in the mngautorun command, the settings might not get canceled even after executing the -d option of the mngautorun command.
In UNIX, the auto restart cannot be executed with a synchronous execution, depending on the specifications of the OS. If the auto restart is specified, a syntax error occurs.
In AIX, if you execute the mngautorun command, the auto start setting is performed and Management Server and Administration Agent change to operating status. Furthermore, if you execute the -d option of the mngautorun command when Management Server and Administration Agent started by inittab exist, Management Server and Administration Agent might change to stopped status.
If the Management Server startup settings are specified so that it automatically starts when the OS starts and all logical servers start at one time, a high load placed during the OS startup might slow down startup of the logical servers. Therefore, we recommend that you increase the timeout period for the startup of logical servers beforehand.

To Page Top