Hitachi

Hitachi Application Server V10 Command Reference Guide (For UNIX® Systems)


2.5.1 create-node-config

Creates a node that is not enabled for remote communication.

Synopsis

asadmin [asadmin-options] create-node-config [--help]
    [--nodehost node-host] [--installdir as-install-parent]
    [--nodedir node-dir] node-name

Storage location

Application Server installation directory/javaee/glassfish/bin

Function

The create-node-config subcommand creates a node that is not enabled for remote communication.

This command does not require the secure shell (SSH) to be configured to create the node.

A node represents a host on which Application Server software is installed. A node must exist for every host on which server instances reside. All administration of instances on a node that is not enabled for remote communication must be performed on the host that the node represents. The domain administration server (DAS) on a remote host cannot contact the node. This command is supported in remote mode only.

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. If this option is omitted, no host is specified for the node.

Type: String

The following values can be specified:

  • Specify the name of the host

Default value: N/A

--installdir as-install-parent

Specifies the full path to Application Server installation directory/javaee. If this option is omitted, no Application Server installation directory/javaee is specified for the node.

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 directory. If this option is omitted, no directory for instances is specified for the node.

Type: String

The following values can be specified:

  • File path of a directory where the node resides

Default value: N/A

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 config:

asadmin create-node-config--nodehost sj03.example.com sj03

Exit Status

Exit Status

Explanation

0

command executed successfully.

1

error in executing the command.