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.
  • It is not supported to restart the scautolistener process using the restart command.

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