Stopping an application server ends a server process based
on the process definition settings in the current application server
configuration.
Before you begin
Make sure you understand the impact of stopping a particular
server has on your ability to handle work requests, especially if
you need to maintain a highly available environment.
About this task
There are times you need to stop an application server.
For example, you might have to apply service to an application running
on that server, or you might want to change one of the application
server's configuration setting. Use one of the following options when
you need to stop an application server.
Avoid trouble: During the Application Server shutdown procecess,
com.ibm.ejs.util.am._Alarm might launch new threads that cause unnecessary
exceptions from varied components. For example, you might receive
the following Connection Pool Manager exception:
J2CA0020E: Connection Pool Manager could not allocate a Managed Connection:
java.lang.IllegalStateException: Internal
Error: cannot find the PoolManager Reference.
These exceptions
might occur because an application server must shut down all of the
components under that application server’s control before the stop
process can complete. You can ignore these exceptions. After the application
server stops, all running threads from the application server automatically
end.
gotcha
Procedure
- You can use the Start menu to stop your
application server. In the administrative
console, click Start > Programs > IBM WebSphere > WebSphere® Application Server, Network Deployment v. n > Stop the server. When the server stops
successfully, the stopServer.log file contains
the following in the last two lines:
Server stop request issued. Waiting for stop status.
Server server1 stop completed.
The server name varies depending
on your settings.
- If a Windows® service has been created for the application server,
optionally use the Windows Services utility to start, stop, and monitor the basic status of
the server.
- To launch the Services utility, click Start > Settings
Control Panel.
The Control Panel folder displays.
- Double-click the Administrative Tools icon.
The Administrative tools folder displays.
- Double-click the Services icon.
Read about
the Services utility in the Windows online help.
Read the topic about the WASService command for information
about adding and removing Windows services.
- You can issue a stopServer command to stop a single server or the
stopManager command to stop the deployment manager.
Read the stopServer and stopManager topics for information about
the commands, including such information as running the commands and
defining the log file names.
Read the topic on using command-line
tools for information such as determining from what directory to run
the stopServer and stopManager commands.
You can check that
the server or deployment manager has successfully stopped by checking
the appropriate log file.
You should not use
the CANCEL appserver_proc_name command to stop a
server. Every time a server is started, a new temp directory is created off of the servant process token, such as profile_root/default/temp/node_name/server_name. When the server is cleanly stopped, these temp directories are normally removed. However, if the
server is frequently not stopped cleanly, which happens if you cancel
rather than stop the server, these temp directories
are not removed and the HFS used for these temp directories eventually becomes full. You can also prevent this storage
problem from occurring if you precompile your JavaServer pages when
you install an application or if you use the JspBatchCompiler function
to precompile them before they are invoked.
- You can use the administrative
console to stop an application server:
- In the administrative console, click .
- Select the application server that you want stopped
and click Stop.
- Confirm that you want to stop the application server.
- View the Status value and any messages or logs
to see whether the application server stops.
- You can use the stopserver Qshell
script to stop an application server:
- You can use the End Job (ENDJOB)
CL command to stop an application server: To use
the ENDJOB CL command, enter:
ENDJOB JOB(jobNumber/QEJBSVR/jobName) OPTION(*CNTRLD) DELAY(delayTime)
where jobNumber is the job number, jobName is
the name of the application server job, and delayTime is the
amount of time to wait for the job to end in seconds. You can initially
set delayTime be 600 seconds and then adjust it, if necessary, to
a value that is more appropriate for your environment. To more information
about specifying a value for delayTime , see the topic Stop the WebSphere Application Server environment in the i5/OS® Information Center.
Results
The specified server stops as soon as requests assigned to
that server finish processing. To verify that the server is in stop
state, in the administrative console, click .