mngsvrctl (start, stop, or setup Management Server)

Format

To start Management Server:
In Windows:

mngsvrctl start [-sync [-timeout synchronous-execution-timeout-time]]

In UNIX:

mngsvrctl start [-sync [-timeout synchronous-execution-timeout-time]] [-daemon]

To stop Management Server:
In Windows:

mngsvrctl stop [-sync [-timeout synchronous-execution-timeout-time]]

In UNIX:

mngsvrctl stop [-sync [-timeout synchronous execution timeout time]]

To set up Management Server:
In Windows:

mngsvrctl setup [server-name] [-u management-user-ID] [-p management-user-password] [-np new-management-user-password] [-nu new-user-ID]

In UNIX:

mngsvrctl setup [server-name] [-u management-user-ID] [-p management-user-password] [-np new-user-password] [-nu new-user-ID]

Function

This command starts or stops Management Server or specifies the settings as required for running Management Server on the machine on which Application Server was first configured.

You can setup the management user account (management user ID and management user password) for logging in to Management Server simultaneously while performing setup, when the functionality for omitting the admin user account is disabled. If the admin user account is not specified during setup , you must specify the admin user account while starting or stopping Management Server. Also, you can change the already setup admin user account by setting a different user account.

If the functionality for omitting the management user account is enabled and if the functionality for integrating JP1 user authentication is enabled on the virtual server, you need not setup the management user account while executing this command and after starting Management Server.

For the functionality to omit the admin user account, see 4.1.15(3) Settings when the management user account is not setup in the uCosminexus Application Server System Setup and Operation Guide.

To execute this command, you must have Administrator privileges (in Windows) or root permission (in UNIX). In UNIX, you can also specify the command execution permission for specific users who do not have the root permission. For details on the setup, see mngenvsetup (setup management group).

Arguments

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

start
Starts Management Server.
stop
Stops Management Server.
-sync
Enables the command processing and also the synchronous execution of start or stop processing for Management Server. In the following cases, a synchronous execution is executed, even if you omit this option. However, you cannot specify this option when you specify the -timeout option.
  • When stopping Management Server
  • When starting Management Server in Windows
When starting Management Server in UNIX, if you specify this option, a synchronous execution is performed as a background job and if you omit this option, a synchronous execution is executed as a foreground job.
-timeout synchronous-execution-timeout-time
Specify the waiting time (unit: seconds) from performing a synchronous execution of this command until Management Server starts or stops, with the integer 0 or from 61 through 2147483. This option is enabled when specified with the -sync option.
When you specify 0, the system continues to wait until Management Server starts or stops, without an occurrence of a timeout. When you omit this option, the synchronous execution timeout time is set as 120 (seconds).
-daemon
Starts Management Server as a daemon process. The same operations are executed as are executed when starting as a daemon process by using the daemon command. For details on the daemon command, see daemon (starting the daemon process).
setup
Sets up Management Server.
Server-name
Specifies the name of Management Server (server name of the J2EE Server). If the server name is omitted, cosmi_m is assumed.
-u management-user-ID
Specifies the management user ID of Management Server.
-p management-user-password
Specifies the management user password of Management Server.
-np new-management-user-password
Specifies the management user password of the new Management Server.
-nu management-user-ID-after change
Specifies the management user ID of the new Management Server.
When canceling the already specified management user password, you specify a null character ("").

Return value

0:
The command terminated normally.
1 or more:
An execution error is occurred. However if the return value is 2, it indicates that a syntax error might have occurred and if the return value is 3, the value indicates that a synchronous execution error might have occurred.
2:
A syntax error has occurred.
3:
A synchronous execution error has occurred.

Input example

Notes common to OS

Notes on setting up Management Server are as follows:

Notes for UNIX

The precautions to be taken when you setup Management Server are as follows: