7.2.2 Stopping your system with a command
To stop your system with a command, use the disable subcommand of the asadmin utility command to stop the applications, use its stop-servers subcommand to stop Application Server, and then, use its stop-domain subcommand to stop the domain administration server. If you are using a hardware load balancer, block it first. If you are using a software load balancer, stop the web servers first.
Prerequisites
-
The domain administration server (DAS) is running.
-
Application Server is running.
-
An application is running.
Intended users
-
System operators
Procedure
If you are using a hardware load balancer, then block it.
For more information about blocking, refer to the hardware load balancer manual.
If you are using a software load balancer, run the stop-webserver subcommand of the asadmin utility command with the --graceful option specified to perform a planned termination of the web server.
asadmin stop-webserver --graceful true web_server_name
A planned termination of a web server occurs after completing processing of all requests currently accepted.
When this command is run, the result is displayed as follows:
Command stop-webserver executed successfully.
If you are using a software load balancer, run the list-webservers subcommand of the asadmin utility command to display a list of web servers.
asadmin list-webservers
When this command is run, the result is displayed as follows. Ensure that the statuses of the web servers are not running.
web_server_namenot running Command list-webservers executed successfully.
To stop the application, run the disable subcommand of the asadmin utility command.
asadmin disable --target server_instance_name_or_cluster_name application_name
-
In a configuration where only one Java EE server is deployed, specify the server instance name for the --target option.
-
In a cluster configuration where more than one Java EE server is deployed, specify the cluster name for the --target option.
- Important note
-
When an application is undeployed, its instance is released from memory, but when an application is disabled, its instance is not released. If many applications are disabled, more memory will be in use, easily leading to an out of memory error.
When this command is run, the result is displayed as follows:
Command disable executed successfully.
-
To stop all performance tracers, server instances, and web servers at the same time, execute the stop-servers subcommand of the asadmin utility command.
asadmin stop-servers
When this command is run, the result is displayed as follows:
Command stop-servers executed successfully.
To display a list of performance tracers, run the list-prfs subcommand of the asadmin utility command.
asadmin list-prfs
When this command is run, the result is displayed as follows. Ensure that the statuses of the performance tracers are not running.
performance_tracer_name not running Command list-prfs executed successfully.
To display a list of server instances, run the list-instances subcommand of the asadmin utility command with the --long option specified.
asadmin list-instances --long=true
When this command is run, the result is displayed as follows. Ensure that the statuses of the server instances are not running.
server_instance_name host_name port_number process_ID cluster_name not running Command list-instances executed successfully.
-
cluster_name is displayed only for cluster configurations that contain multiple Java EE servers.
-
To display a list of web servers, run the list-webservers subcommand of the asadmin utility command. If you are using a software load balancer, you can skip this step.
asadmin list-webservers
When this command is run, the result is displayed as follows. Ensure that the statuses of the web servers are not running.
web_server_name not running Command list-webservers executed successfully.
To stop the domain administration server, run the stop-domain subcommand of the asadmin utility command.
asadmin stop-domain
When this command is run, the result is displayed as follows:
Command stop-domain executed successfully.