shutdown

Run the serverManager shutdown command to stop a runtime server or a development server. The command checks to make sure that pending server activities are complete before shutting down the server.

Purpose

To stop a runtime server or a development server, use the serverManager script with the shutdown command in the <InstallDir>/runtime/ia/bin directory instead of the Liberty server stop command. The shutdown command stops the server specified by the host and port parameters, pausing and shutting down server processes and components in the correct order. By default, the command checks the WebSphere® eXtreme Scale processes and waits for pending activities to complete before shutting down the server. You can change this behavior by adding the immediate parameter to the command.

The catalogServerHost and catalogServerPort parameters are required when you shutdown a runtime server in a multiple-server topology. As part of the shutdown process, communication is established with the catalog server to determine the status of WebSphere eXtreme Scale processes. The shutdown command waits until the WebSphere eXtreme Scale are complete on the catalog server and then finishes shutting down the runtime server.

On a development server, the runtime and the catalog are hosted on the same server, so you can specify the local host and port information, but the catalogServerHost and catalogServerPort parameters are not required.

Syntax

serverManager shutdown
--catalogServerHost=catalog_hostname
--catalogServerPort=catalog_port
[--propertiesFile=properties_file]
[--username=username]
[--password=password]
[--host=hostname] 
[--port=port]
[--keyStoreLocation=keystore_location]
[--keyStorePassword=keystore_password]
[--readTimeout=timeout_value]
[--sslProtocol=sslProtocol]
[--immediate=true|false] 
[--trustStorePassword=truststore_password]
[--trustStoreLocation=truststore_location]
[--disableSSLHostnameVerification=true|false]
[--disableServerCertificateVerification=true|false]

Description

Table 1. Mandatory parameters for serverManager shutdown
Mandatory parameter	Description
catalogServerHost	Required to shutdown a runtime server. The script communicates with the catalog server to make sure it is safe to shutdown the runtime server.
catalogServerPort	Required to shutdown a runtime server. The script communicates with the catalog server to make sure it is safe to shutdown the runtime server.

Table 2. Optional parameters for serverManager shutdown
Optional parameter	Description
propertiesFile	The path to a properties file from which to read properties. If you do not specify a value, the default path to the connection.properties file in the runtime/ia/etc directory is used.
username	The user name of a user who has the administrator role. If you do not specify a value, the value that is specified by the propertiesFile is used.
password	The password of a user who has the administrator role. If you do not specify a value, the value that is specified by the propertiesFile is used.
host	The default host name is localhost. To change the host name, specify the fully qualified name of the remote server. For example: myserver.mycompany.com.
port	The default port value is 9443. To change the port, specify the port of the remote server.
immediate	Overrides the default behavior and forces the shutdown to complete even if WebSphere eXtreme Scale processes are not complete.
trustStorePassword	The password for remote Secure Sockets Layer (SSL) authentication. If you do not specify a value, the value that is specified by the propertiesFile is used. If the property is not set, the truststore is not validated.
trustStoreLocation	Location of the truststore (javax.net.ssl.trustStore). Default is cisDev/resources/security/key.jks in the servers directory.
disableSSLHostnameVerification	If this value is set to `true`, SSL host name verification is disabled. If you do not specify a value, the value that is specified by the propertiesFile is used. If a value is not specified, either on the command line or in the properties file, the default value `false` is used.
disableServerCertificateVerification	This parameter is used to disable server certificate verification. If you set this parameter to true, the client does not check whether the certificate presented by the server is trusted. If the server is not trusted, authentication credentials and other user information might be passed on through the JMX connection. This parameter is optional. If not specified, it uses the value in the properties file specified by the --propertiesFile option. If no value is specified on the command line or in the properties file, it defaults to false.
keyStoreLocation	The location of the keystore. If you do not specify a value, this parameter uses the value in the properties file specified by the `--propertiesFile` option. If no value is specified on the command line or in the properties file, no keystore is used.
keyStorePassword	The keystore password. If you do not specify a value, this parameter uses the value in the properties file specified by the `--propertiesFile` option. If no value is specified on the command line or in the properties file, you are asked to provide a password interactively.
readTimeout	The amount of time expressed in milliseconds that the utility waits for a response from the server before closing a connection. This parameter is optional. If you do not specify a value, it uses the value that is specified by the --propertiesFile option. If no value is specified on the command line or in the properties file, the default value is 60000 (1 minute).
sslProtocol	The SSL protocol for the connection. If you do not specify a value, this parameter uses the value in the properties file specified by the `--propertiesFile` option. If no value is specified on the command line or in the properties file, the value "TLSv1.2" is used.