2.5.12 validate-dcom

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

asadmin validate-dcom wpmdl2

Exit Status

Exit Status	Explanation
0	command executed successfully.
1	error in executing the command.