2.5.2 create-node-dcom
Creates a node that is enabled for communication over 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
-
Examples
The following example creates a node.
asadmin create-node-dcom --nodehost wpmdl1.example.com wpmdl1
Exit Status
Exit Status |
Explanation |
---|---|
0 |
command executed successfully. |
1 |
error in executing the command. |