2.5.8 ping-node-dcom
Tests nodes enabled for communication over DCOM to determine if they are usable.
Synopsis
asadmin [asadmin-options] ping-node-dcom [--help] [--validate={false|true}] node-name
Storage location
Application Server installation directory/javaee/glassfish/bin
Function
The ping-node-dcom subcommand of asadmin tests if a node that is enabled for communication over DCOM is usable. The DCOM protocol is available only on Windows systems. If the node is usable, the command displays a confirmation that the command could connect to the node through DCOM. This confirmation includes the name of the host which the node represents. This subcommand is supported in remote mode only.
Precondition
-
Domain Administration Server (DAS) is running.
-
This command requires DCOM to be configured on the machine where the domain administration server (DAS) is running, and on the machine where the node resides. You may run this command from any machine that can contact the DAS.
-
The node must be enabled for communication over DCOM. Otherwise, an error occurs.
Arguments
- --help | -?
-
Displays the help text for the subcommand.
- --validate={false|true}
-
Specifies whether the subcommand validates the node.
Type: Boolean
The following values can be specified:
-
true
The node is validated.
-
false
The node is not validated. This is the default value.
Default value: false
-
- node_name
-
Specifies the name of the node to test.
Type: String
The following values can be specified:
-
Name of the node
Default value: N/A
-
Examples
The following example tests if the DCOM-enabled node wpmd2 is usable.
asadmin ping-node-dcom wpmdl2
Exit Status
Exit Status |
Explanation |
---|---|
0 |
subcommand executed successfully. |
1 |
error in executing the subcommand. |