Parameter: host

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

host

Description

This parameter is intended for horizontally scaled implementations in which there are multiple servers. This parameter allows you to specify the member of the horizontal scaled group you want to shut down or quiesce.

Valid if set from

Server's operating system command prompt

Requires restart of the Service Manager server?

No

Default value

None

Possible values

A valid Service Manager host name

Example usage

The System Administrator can run the following commands to shut down or quiesce Service Manager server members in the horizontal scaled group.

Note When the host option is missing in the commands, the default is taken as the localhost or currenthost.

Example: To shut down the default host (localhost) in the horizontal scaled group:

Command line: sm -shutdown

Example: To shut down a specific host (not the default host) in the horizontal scaled group:

Command line: sm -shutdown -host:myserver1

Example: To shut down all hosts in the horizontal scaled group:

Command line: sm -shutdown -group

Example: To restrict Service Manager processes to administrators only on the local host.

Command line: sm -quiesce:1

Example: To restrict Service Manager processes for all users in the entire cluster.

Command line: sm -quiesce:2 -group

Example: To bring the system back to running mode (unquiesce). All users can now connect to the processes.

Command line: sm -quiesce:0 -group

Related topics

Servlet implementation
System parameters
Enter a parameter in the sm.ini file
Connection parameters
Servlet parameters
Startup parameter: quiesce