Startup parameter: quiesce

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

quiesce

Valid if set from

Server's operating system command prompt

Description

This parameter sets login restrictions to prevent users from logging on to Service Manager processes. This gives System Administrators a way to stop users from logging on to Service Manager processes, and wait for existing users to gracefully log off before starting system maintenance or testing tailoring activities.

There are three levels of login restrictions. Quiesce level 1 restricts all users, except System Administrators, from logging on to Service Manager processes. Quiesce level 2 restricts all users from logging on to Service Manager processes. Quiesce level 0 (zero) sets Service Manager processes to allow user logins. In the vertical scaled or horizontal scaled environment, Service Manager loadBalancer does not forward any client connection requests to Service Manager processes that are in quiesce level 1 or 2. If System Administrators want to connect to a Service Manager process in quiesce level 1, they must connect directly to the Service Manager process without connecting through Service Manager loadBalancer.

For detailed information on when quiesce mode can be set and how logins are restricted in a vertical scaled environment and a horizontal scaled environment, see the related topics.

Note If the "-group" or "-host" option is not specified, the quiesce command applies to all Service Manager processes on the local host.

Requires restart of the Service Manager server?

No

Default value

0

Possible values

0 (Allows all users, no restrictions)

1 (Restricts all user logins, except System administrators)

2 (Restricts all user logins)

Example usage

Example 1: The System Administrator runs the following command to set quiesce mode 1 on all Service Manager processes on the local host. All users are restricted from these processes, except the System Administrator.

Command line: sm -quiesce:1

Example 2: The System Administrator runs the following command to set quiesce mode 1 on the host whose IP address is 15.28.113.121 in the horizontal scaled group.

Command line: sm -quiesce:1 -host:15.28.113.121

Example 3: The System Administrator runs the following command to set quiesce mode 2 for all Service Manager processes in the horizontal scaled group. This restricts all users from accessing Service Manager processes in the entire cluster.

Command line: sm -quiesce:2 -group

Example 4: The System Administrator has completed system maintenance and runs the following command to bring the system back to non-quiesce mode. All Service Manager processes in the horizontal scaled group that were quiesced can now accept user logins.

Command line: sm -quiesce:0 -group

Example 5: The System Administrator runs the following command to set Service Manager processes on host 15.28.113.121 to non-quiesce mode. Service Manager processes on host 15.28.113.121 now accept user logins.

Command line: sm -quiesce:0 -host:15.28.113.121

Related topics

System quiesce: Login restrictions

Related topics

Enter a parameter in the sm.ini file

Related topics

Connection parameters