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
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.