The serverStatus script

Use the serverStatus script to obtain the status of one or all of the servers configured for an instance (node).

Product

This script is available in WebSphere Application Server and WebSphere Application Server Network Deployment.

Authority

No special authority is required to run this script.

Syntax

The syntax of the serverStatus script is:

serverStatus server | -all [ -instance instance ]
 [ -logfile filename ] [ -replacelog ] [ -trace ] [ -username username ]
 [ -password password ] [ -help | -? ]

Parameters

The parameters of the serverStatus script are:

• server
  The value server is name of the server for which you want to display status. You must specify either a server name or the -all parameter. This value is case sensitive.

• -all
  If you specify this parameter, the script displays the status of all of the servers in the instance. You must specify either the -all parameter or a server name.

• -instance
  Optional. The value instance specifies the name of the instance that contains the server or servers for which you want to display status. If you do not specify this parameter, the script displays the status of servers in the default instance.

• -logfile
  Optional. The value filename specifies the location and name of the log file for the script. The default value is /QIBM/UserData/WebAS5/edition/instance/logs/serverStatus.log where edition is Base or ND depending on which product you are running and instance is the name of the instance that contains to which the server for which you want to display status.

• -replacelog
  Optional. If you specify this parameter, the script replaces the log file if it exists. By default the script appends to the log file if it exists.

• -trace
  Optional. If you specify this parameter, the script outputs additional trace information to the log file for the script. You should only specify this parameter if errors occur when you try to display server status. The default is to not log additional trace information.

• -username
  This parameter is required if security is enabled for the server. The value username specifies the user name for authentication.

• -password
  This parameter is required if security is enabled for the server. The value password specifies the password for authentication.

• -help or -?
  This optional paramter prints the usage statement for the script.

Examples

These examples demonstrate correct syntax:

serverStatus server1

This example displays the status for the server1 application server in the default instance.

serverStatus -all -instance devinst

This example displays the status for all of the application servers in the instance devinst.