2.5.12 validate-dcom
Tests the connection over DCOM to a remote host.
Synopsis
asadmin [asadmin-options] validate-dcom [--help] [--windowsuser windows-user] [--windowsdomain windows-domain] [--remotetestdir remote-test-directory] [--verbose={false|true}] host-name
Storage location
Application Server installation directory/javaee/glassfish/bin
Function
The validate-dcom subcommand of asadmin tests the connection over the Distributed Component Object Model (DCOM) remote protocol to the remote host that is specified as the operand of the subcommand. This subcommand verifies whether the prerequisites for creating a DCOM node or creating a server instance on a DCOM node are met. If this subcommand fails, any attempt to create a DCOM node or create an instance on a DCOM node will also fail. The subcommand tests the connection over DCOM to the remote host by performing the following operations on the remote host:
-
Resolving the host name.
-
Connecting to DCOM through port 135 or 139.
-
Connecting to Windows Shares through port 445.
-
Copying a script that is named delete_me.bat in the folder that is specified by the --remotetestdir option.
-
Running the script to obtain a listing of the folder in which the delete_me.bat was written.
This subcommand is supported in remote mode only.
Precondition
-
DCOM must be configured on the host where the Domain Administration Server (DAS) is running and on the remote host that is specified as the operand of the subcommand.
-
DCOM port 135 or 139 and Windows Shares port 445 must be open on the remote host.
-
The Server Windows Service is enabled on the remote host.
-
Domain Administration Server (DAS) is running.
Arguments
- --help | -?
-
Displays the help text for the subcommand.
- {--windowsuser|-w} windows-user
-
Specifies the user on the remote host that is to run the process for connecting to that host, through DCOM.
Type: String
The following values can be specified:
-
Name of the user
Default value: The user running the DAS process.
-
- {--windowsdomain|-d} windows-domain
-
Specifies the name of the Windows domain that contains the user which the --windowsuser option specifies.
Type: String
The following values can be specified:
-
Domain name
Default value: The name of the host on which the subcommand is run.
-
- --remotetestdir remote-test-directory
-
Specifies the folder on the remote host in which the subcommand creates the delete_me.bat file. The user which the --windowsuser option specifies must have write access to this folder. Else, an error occurs.
Type: String
The following values can be specified:
-
Path of the test directory
Default value: C:\
-
- {--verbose|-v}={false|true}
-
Specifies whether the subcommand displays information about the operations that are performed to test the connection to the remote host.
To display more detailed results for the -verbose option, you need to specify the AS_DEBUG environment variable as true.
Type: Boolean
The following values can be specified:
-
false
No information about the operations that are performed to test the connection is displayed. This is the default value.
-
true
The subcommand displays information about the operations that are performed to test the connection.
If the --verbose option is true and the AS_DEBUG environment variable is set, the subcommand also displays the command line for each process that is running on the remote host.
Default value: false
-
- host-name
-
Specifies the name of the host to which to test the connection over DCOM.
Type: String
The following values can be specified:
-
Name of the hosts
Default value: N/A
-
Examples
The following example tests the connection over DCOM to the host wpmdl2.
asadmin validate-dcom wpmdl2
Exit Status
Exit Status |
Explanation |
---|---|
0 |
command executed successfully. |
1 |
error in executing the command. |