2.5.11 update-node-dcom
Updates the configuration data of a node.
Synopsis
asadmin [asadmin-options] update-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 update-node-dcom subcommand of asadmin updates the configuration data of a node. This subcommand requires the Distributed Component Object Model (DCOM) remote protocol to be configured on the host where the domain administration server (DAS) is running and on the host where the node resides. You may run this subcommand from any host that can contact the DAS. This subcommand can update any node, regardless of whether the node is enabled for remote communication. If the node is not enabled for remote communication, the subcommand enables DCOM communication for the node and updates any other specified configuration data. If this subcommand is run to enable DCOM communication for a node, default values are applied if --windowsuser --windowsdomain is omitted. This subcommand is supported in remote mode only.
Precondition
-
DCOM is configured on the host where the DAS is running and on the host that the node represents.
-
The node that you are updating exists.
-
Domain Administration Server (DAS) is running.
Arguments
- --help | -?
-
Displays the help text for the subcommand.
- --nodehost node-host
-
Specifies the name of the host that the node is to represent after the node is updated.
Type: String
The following values can be specified:
-
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: N/A
-
- --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 the Application Server installation directory/javaee/glassfish directory, where Application Server installation directory/javaee/glassfish is the base installation directory of Application Server software on the host.
Type: String
The following values can be specified:
-
Path to the directory containing the server instances of the node
Default value: N/A
-
- {--windowsuser|-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, the --windowsuser option is ignored.
Type: String
The following values can be specified:
-
User name
Default value: If the node is already enabled for communication over DCOM, the default is to leave the user unchanged. If this subcommand is run to enable DCOM communication for the node, the default is the user that is running the DAS process.
-
- {--windowsdomain|-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:
-
Name of the windows domain
Default value: If the node is already enabled for communication over DCOM, the default is to leave the domain unchanged. If this subcommand is run to enable DCOM communication for the node, the default is the name of the host on which the subcommand is run.
-
- --force={false|true}
-
Specifies whether the node is updated 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:
-
false
The node is not updated if validation of the node's parameters fails. This is the default value.
-
true
The node is updated even if validation of the node's parameters fails.
Default value: false
-
- node-name
-
Specifies the name of the node to update.
Type: String
The following values can be specified:
-
Name of the node
Default value: N/A
-
Examples
The following example updates the host that the node wpmdl1 represents to wj01.
asadmin update-node-dcom --nodehost wj01 wpmdl1
Exit Status
Exit Status |
Explanation |
---|---|
0 |
command executed successfully. |
1 |
error in executing the command. |