2.6.19 list-webservers
The list-webservers subcommand lists the web servers.
Synopsis
asadmin [asadmin_options] list-webservers [--long={false|true} |
--nostatus={false|true}] [target]
Storage location
Application Server installation directory/javaee/glassfish/bin
Function
The list-webservers subcommand lists all the web servers that have been set up in the domain. You can use this subcommand to check the web server configuration information and operation status.
This subcommand is supported only in the remote mode.
You can simultaneously specify the --long and --nostatus options for the format only if one of these options is explicitly set to false.
Execution permission
General user
Arguments
- --long={false|true}
-
Specifies whether to display the detailed information, in a list, about the web server.
Type: Boolean
You can specify the following values:
-
true
Displays the web server name and its detailed information (host name, process ID, and status). The header information is also displayed.
-
false
Displays only the web server name and its status. The header information is not displayed.
Default value: false
-
- --nostatus={false|true}
-
Specifies whether to display the status of a web server.
Type: Boolean
You can specify the following values:
-
true
Does not display the status.
-
false
Displays the status.
Default value: false
-
- target
-
Specifies the name of the object for which information is displayed. Based on the specified name, the web servers are filtered and displayed.
Type: String
You can specify the following values:
-
domain
Displays information about all the web servers in a domain.
-
web_server_name
Displays information about the specified web server.
-
node_name
Displays information about the web servers that belong to the specified node.
Default value: domain
-
Output Format
The first line is the header of the output information and displays a fixed character string, which indicates the output format.
Between columns, the longest character string within a column is separated from the beginning of the next column by two spaces.
The status is displayed with one space at the beginning of the word.
NAME HOST PID STATE web_server_name host_name process_ID status
web_server_name: Displays the name of the web server.
host_name: Displays the name of the host on which the web server is created.
process_ID: Displays the process ID of the web server that is running. This column displays -- if the web server is not running.
status: Displays the status of the web server. This column displays the following values:
-
not running (Stopped)
-
running (Running)
Examples
The following example displays the names and statuses of web servers:
asadmin list-webservers
Example of output:
Web1 running Web2 not running Web4 running Web3 not running
The following example displays the complete information about a web server:
asadmin list-webservers --long true
Example of output:
NAME HOST PID STATE Web1 localhost 258 running Web2 localhost -- not running Web4 WINHOST1 526 running Web3 WINHOST1 -- not running
The following example does not display the status of web servers:
asadmin list-webservers --nostatus true
Example of output:
Web1 Web2 Web4 Web3
The following example displays information corresponding to the web server Web1:
asadmin list-webservers Web1
Example of output:
Web1 running
The following example displays information about the web servers that belong to the node winhost1-domain2 (host WINHOST1):
asadmin list-webservers winhost1-domain2
Example of output:
Web4 running Web3 not running
Exit Status
|
Exit Status |
Explanation |
|---|---|
|
0 |
Normal termination. |
|
1 |
Abnormal termination. |