2.5.2 create-node-dcom

Synopsis

asadmin [asadmin-options] create-node-dcom [--help]
    --nodehost node-host [--installdir as-install-parent]
    [--nodedir node-dir] [--windowsuser windows-user]
    [--windowsdomain windows-domain] [--force={false|true}]
    node-name

Storage location

Application Server installation directory/javaee/glassfish/bin

Function

The create-node-dcom subcommand creates a node that is enabled for communication over the Distributed Component Object Model (DCOM) remote protocol. The DCOM protocol is available only on Windows systems. A node represents a host on which Application Server software is installed. A node must exist for every host on which server instances reside. In a DCOM-enabled network, the domain administration server (DAS) contacts a node's host through the DCOM connector to manage server instances that reside on the node. DCOM is used only for communications between hosts. DCOM is never used for communications within a single host. This command cannot create a node that represents the local host, that is, the host on which the command is run. The command fails regardless of how the local host is specified, for example, by using the keyword localhost, the Internet Protocol (IP) address of the host, or the host name. This command is supported in remote mode only.

To force the node to be created in the DAS configuration even if the host cannot be contacted through DCOM, set the --force option to true.

Precondition

DAS has to be in a running state.

A node must exist for every host on which server instances reside.

Arguments

--help | -?

Displays the help text for the subcommand.

--nodehost node-host

Specifies the name of the host that the node represents. The name of the host must be specified. Otherwise, an error occurs.

Type: String

The following values can be specified:

• Specify node host name

Default value: N/A

--installdir as-install-parent

Specifies the full path to Application Server installation directory/javaee.

Type: String

The following values can be specified:

• The full path to Application Server installation directory/javaee

Default value: Application Server installation directory/javaee directory for the DAS.

--nodedir node-dir

Specifies the path to the directory that is to contain server instances that are created on the node. If a relative path is specified, the path is relative to Application Server installation directory/javaee/glassfish directory.

Type: String

The following values can be specified:

• Specify the path to the directory that contain server instance

Default value: Application Server installation directory/javaee/glassfish/nodes

--windowsuser windows-user | -w windows-user

Specifies the user on this node's host that is to run the process for connecting to the host through DCOM. If the --nodehost option is set to localhost-domain, the --windowsuser option is ignored

Type: String

The following values can be specified:

• Specify the name of the window user

Default value: The default is the user that is running the DAS process

--windowsdomain windows-domain | -d windows-domain

Specifies the name of the Windows domain that contains the user that the --windowsuser option specifies.

Type: String

The following values can be specified:

• Specify the name of the Windows domain that contains the user

Default value: name of the host on which the subcommand is run

--force={false|true}

Specifies whether the node is created in the DAS configuration even if validation of the node's parameters fails.

To validate a node's parameters, the DAS must be able to contact the node's host through DCOM.

Type: Boolean

The following values can be specified:

• true

  The node is created even if validation of the node's parameters fails.

• false

  The node is not created if validation of the node's parameters fails (default).

Default value: false

node-name

Specifies the name of the node.

The name must meet the following requirements:

• The name may contain only ASCII characters.

• The name must start with a letter, a number, or an underscore. The name may contain only the following characters:

  Lowercase letters

  Uppercase letters

  Numbers

  Hyphen

  Period

  Underscore

• The name must be unique in the domain and must not be the name of another node, a cluster, a named configuration, or a server instance.

• The name must not be domain, server, or any other keyword that is reserved by Java EE Server.

Type: String

The following values can be specified:

• Specify the node name

Default Value: N/A

asadmin create-node-dcom --nodehost wpmdl1.example.com wpmdl1

Exit Status

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