Sun Java System Application Server Enterprise Edition 8.1 2005Q2 Reference Manual

## create-node-agent(1)

NAME | SYNOPSIS | DESCRIPTION | OPTIONS | OPERANDS | EXAMPLES | EXIT STATUS | SEE ALSO

#### NAME

create-node-agent– creates a node agent

#### SYNOPSIS

`create-node-agent` ––host DAS_host ––port DAS_port [––user DAS_user] [––terse=false] [––echo=false] [––interactive=true] [––agentdir nodeagent_path] [––agentport port_number] [`––agentproperties (name=value)[:name=value]*`] ––passwordfile password [––savemasterpassword=false] [nodeagent_name]

#### DESCRIPTION

The node agent facilitates remote server instance management. It is the responsibility of the node agent to create, start, stop, and delete a server instance. Every node agent must have a unique name and every new server instance must be created with a reference to a node agent name defining the machine on which the instance will reside. A node agent must be present on every machine that hosts server instances, including the machine hosting the Domain Administration Server (DAS).

The domain administration server connection options identify the agent's initial target domain. The DAS does not need to be running when the node agent is being created.

#### OPTIONS

`––host`

  Specifies the connection attributes to the DAS. The agent attempts to contact the DAS and join the domain when it is started.

`––port`

  Specifies the connection attributes to the DAS. The agent attempts to contact the DAS and join the domain when it is started.

`––user`

  The username associated with the administrative instance. Specifies the connection attributes to the DAS. The agent attempts to contact the DAS and join the domain when it is started.

`–` `–adminpassword`

  The domain application server password associated with the administrative instance.

`–t` `––terse`

  Indicates that any output data must be very concise, typically avoiding human-friendly sentences and favoring well-formatted data for consumption by a script. Default is false.

`–e` `––echo`

  Setting to true will echo the command line statement on to the standard output. Default is false.

`–I` `––interactive`

  If set to true (default), only the required options are prompted.

`` `––agentdir`

  Like a DAS, each node agent resides in a top level directory named /. If the agentdir is not specified, then the default install_dir/nodeagents is used.

`` `––agentport`

  The port on which the node agent's JMX connector will listen and accept requests. If not specified, then a random unused port is choosen.

`` `––agentproperties`

  The following agentproperties are available:

  Property | Definition
  --- | ---
  listenaddress | The address used by the JMX connector to listen for requests or notifications. The default is 0.0.0.0.
  remoteclientaddress | The address used by DAS to connect to the Node Agent. The default is the hostname of the server.
  loglevel | The initial log level at which messages are logged. The default is INFO.

`–W` `––passwordfile`

  The file containing the domain application server password associated with the administrative instance. The password is defined in the following form: AS_ADMIN_PASSWORD=password. Where password is the actual administrator password for the domain.

`––savemasterpassword`

  Setting this option to true allows the `masterpassword` to be written to the file system. This is necessary so that the `start-domain` command can start the server without having to prompt the user. However, for security purposes, the default setting is false because saving the master password on the disk is an insecure practice.

#### OPERANDS

nodeagent_name

  The name of the node agent must be unique in the domain. If not specified, the nodeagent_name defaults to the machine's host name.

#### EXAMPLES

##### Example 1 Using create-node-agent

    asadmin>create-node-agent --host dance --port 4848 --user admin1 --passwordfile pass2 nodeagent1
    Node Agent nodeagent1 created.

Where: nodeagent1 was created in the default install_dir/nodeagents directory.

#### EXIT STATUS

0

  command executed successfully

1

  error in executing the command

#### SEE ALSO

delete-node-agent(1), list-node-agents(1), start-node-agent(1), stop-node-agent(1)

J2EE SDK 1.4 Last Revised 22 Dec 2004

NAME | SYNOPSIS | DESCRIPTION | OPTIONS | OPERANDS | EXAMPLES | EXIT STATUS | SEE ALSO

- © 2010, Oracle Corporation and/or its affiliates