isonline

Run the serverManager isonline command to determine if a server is running.

Purpose

The serverManager isonline command checks for running and active local or remote servers. Use the command to identify a local or remote server where you can deploy or activate solutions. You must provide administrator authentication credentials to run the script. Specify the server hostname and port to determine the status of a remote server.

Syntax

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

Description

Table 1. Optional parameters for serverManager isonline
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 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 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.
trustStorePassword	The password for remote Secure Sockets Layer (SSL) authentication. If you do not specify a value, the value 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	This parameter is used for remote connections only. If set to `true`, it disables SSL host name verification. If no value is specified, it defaults to the value in the properties file that is specified by the propertiesFile parameter. If no value is specified by that parameter, it defaults to `false`.
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.

The serverManager isonline command returns a status message to indicate whether the localhost or remote server is running. For example:

Server localhost is online.

This status message indicates that the localhost server is not running.

Cannot connect to localhost on port 9443.