• 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)