Parameter: restart

Startup parameters change the behavior of the Service Manager server. You can always set a startup parameter from the server's operating system command prompt.

Parameter

restart

Description

This parameter restarts one or all Service Manager processes on a host after a specified waiting period and an optional quiesce grace period. This parameter uses the following syntax:

sm -restart:n [-host:host name or IP address] [-pid:process ID]

Use the host parameter to specify where the processes are located if they are not on the local system. If you do not specify a host, the server will restart processes on the local host. Use the pid parameter to specify a particular process ID you want to restart if you do not want to restart all processes on the host. If you do not specify a process ID, the server restarts all processes. Add restartGraceInterval to the sm.ini file to specify how many minutes you want to quiesce processes before they restart.

Note The restart command does not restart the load balancer process when restarting all processes on a host. The only way to restart a load balancer process is to specify it by process ID.

You can cancel a restart by using a value of -1 during the waiting period. You must specify the same host name or process ID you specified to restart. For example:

sm -restart:-1 -pid:1234

Note You cannot cancel a process restart after the restart waiting period has expired.

Valid if set from

Server's operating system command prompt

Requires restart of the Service Manager server?

Yes

Default value

0 minutes

Possible values

n (restart in n minutes)

0 (restart immediately)

-1 (cancel restart)

Example usage

Command line: sm -restart:10 -host:myserver.myhost.com -pid:1234

Related topics

System parameters
System quiesce: Login restrictions
Managing multiple servlet container processes
Enter a parameter in sm.cfg or the server’s OS command prompt

Parameter: restartGraceInterval
Parameter: restartRandMax