The startServer script

The startServer script reads the configuration file for the specified server process and starts the server.

Product

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

Authority

To run this script, your user profile must have *ALLOBJ and *JOBCTL authority. For information on setting explicit authorities for a user profile that does not have *ALLOBJ authority, see Set explicit authorities for the startServer and stopServer scripts.

Syntax

The syntax of the startServer script is:

startServer [ server ] [ -instance instance ]
 [ -nowait ] [ -timeout seconds ] [ -trace ] [ -help | -? ]

where server is the name of the configuration directory of the server you want to start.

Parameters

The parameters of the startServer script are:

• server
  Optional that specifies the name of the server that you want to start.

  • If server is not specified and -instance is not specified or has a value of default, the default value of server is:
    • WebSphere Application Server: server1
    • WebSphere Application Server Network Deployment: dmgr

  • If server is not specified and a non-default instance is specified for the -instance parameter, the server name defaults to the value specified for the -instance parameter.

  This value is case sensitive.

• -instance
  Optional. The value instance specifies the name of the instance that contains the server that you want to start. The default value for this parameter is default.

• -nowait
  Optional. If you specify this parameter, the script returns control to the user without waiting for successful initialization of the server. The default is to wait for successful initialization.

• -timeout
  Optional. The value seconds specifies the amount of time in seconds to wait for successful initialization of the server. The script returns control to the user at the end of the timeout value. The default is to wait until the server initialization is complete.

• -trace
  Optional. If you specify this parameter, the trace function is turned on. The trace output is written to the JOBNAME.JOBUSER.JOBNUMBER file in the /QIBM/UserData/WebAS5/service/trace directory, where JOBNAME, JOBUSER, and JOBNUMBER are taken from the application server job. The job name is output when the job is submitted by the script.

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

Examples

These examples demonstrate correct syntax:

startServer

This example starts the default server for the default instance. For WebSphere Application Server, the default server is server1. For WebSphere Application Server Network Deployment, the default server is dmgr.

startServer server1

This example starts the server1 application server in the default instance.

startServer -instance myinst

This example starts the myinst application server in the myinst instance.

startServer test -instance devinst -nowait

This example starts the test application server in the devinst instance and returns control immediately to the user.