NAME | SYNOPSIS | DESCRIPTION | OPTIONS | OPERANDS | EXAMPLES | EXIT STATUS | SEE ALSO
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 (such as host, port and user) identify the agent's initial target domain. The DAS does not need to be running when the node agent is being created.
The machine name where the domain administration server is running. The default value is localhost.
The port number of the domain administration server listening for administration requests. The default port number for Enterprise Edition is 4849.
The authorized domain administration server administrative username.
If set to true, uses SSL/TLS to communicate with the domain administration server.
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.
Setting to true will echo the command line statement on to the standard output. Default is false.
If set to true (default), only the required options are prompted.
Like a DAS, each node agent resides in a top level directory named agentdir/nodeagent_name. If the agentdir option is not specified, then the default install-dir/nodeagents is used.
The port on which the node agent's JMX connector will listen and accept requests. If not specified, a random unused port is chosen.
Use this option to override the default values of node agent properties. 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. |
This option replaces the –– password option. Using the ––password option on the command line or through the environment is deprecated. The ––passwordfile option specifies the name of a file containing the password entries in a specified format. The entry for the password must have the AS_ADMIN_ prefix followed by the password name in capital letters. For example, to specify the domain administration server password, use an entry with the following format: AS_ADMIN_PASSWORD=password, where password is the actual administrator password. Passwords that can be specified for this command are AS_ADMIN_PASSWORD and AS_ADMIN_MASTERPASSWORD.
Setting this option to true allows the master password to be written to the file system. This is necessary so that the start-node-agent 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.
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. Do not use any reserved words or characters in the node agent name.
The following command creates nodeagent1 in the default install-dir/nodeagents directory.
asadmin>create-node-agent --host dance --port 4849 --user admin1 --passwordfile /home/password.txt nodeagent1 Command create-node-agent executed successfully. |
NAME | SYNOPSIS | DESCRIPTION | OPTIONS | OPERANDS | EXAMPLES | EXIT STATUS | SEE ALSO