The startServer command reads the configuration file for the specified
application server and starts the server. Depending on the options you specify,
you can launch a new Java virtual machine (JVM) API to run the server process,
or write the launch command data to a file. For more information about where
to run this command, see the Using command
tools article.
If you are using the Windows platform and the you have the application
server running as a Windows service, the startServer command will start
the associated Windows service and it will be responsible for starting the
application server.
Syntax
The command syntax is as follows:
startServer <server> [options]
where
server is
the name of the application server you want to start. This argument is required.
Parameters
The following options are available for
the startServer command:
- -nowait
- Tells the startServer command not to wait for successful initialization
of the launched server process.
- -quiet
- Suppresses the progress information that the startServer command
prints in normal mode.
- -logfile <fileName>
- Specifies the location of the log file to which information is written.
- -profileName
- Defines the profile of the Application Server process in a multi-profile
installation. The -profileName option is not required for running in a single
profile environment. The default for this option is the default profile.
- -replacelog
- Replaces the log file instead of appending to the current log.
- -trace
- Generates trace information to the log file for debugging purposes.
- -timeout <seconds>
- Specifies the waiting time before server initialization times out and
returns an error.
- -statusport <portNumber>
- Specifies that an administrator can set the port number for server status
callback.
- -script [<script fileName>] -background
- Generates a launch script with the startServer command instead
of launching the server process directly. The launch script name is an optional
argument. If you do not supply the launch script name, the default script
file name is start_<server> based on the <server> name
passed as the first argument to the startServer command. The -background parameter
is an optional parameter that specifies that the generated script will run
in the background when you execute it.
- -J <java_option>
- Specifies options to pass through to the Java interpreter.
- -recovery
- Specifies that the server will start in recovery mode, perform a transactional
recovery, and shut down. The server will not accept any new transactions while
it is in recovery mode. When you start the server again, resources that were
unavailable due to questionable transactions will be available.
Use this
option if a server fails and you do not want to accept new transactions during
the recovery process.
- -help
- Prints a usage statement.
- -?
- Prints a usage statement.
Usage scenario
The following examples demonstrate
correct syntax:
startServer server1
startServer server1 -script (produces the start_server1.sh or .bat files)
startServer server1 -trace (produces the startserver.log file)