Sun Microsystems Logo
Products and Services
 
Support and Training
 
 

A  B  C  D  E  F  G  H  I  J  K  L  M  N  O  P  Q  R  S  T  U  V  W  X  Y  Z  
 
User Commandsstart-node-agent(1)


NAME

 start-node-agent - starts a node agent

SYNOPSIS

 start-node-agent [user user] [passwordfile passwordfile] [secure=true] [terse=false] [echo=false] [interactive=true] [agentdir nodeagent_path] [startinstances=true] [nodeagent_name]

DESCRIPTION

Use the start-node-agent command start a node agent. The comand will return control to the user before instances are actually started. The list-instances command can be executed to see if they have actually started. This command may take a while to execute since the node agent may need to create and start a number of server instances.

This command is supported in local mode only.

OPTIONS

u user

The authorized domain application server administrative username.

w password

The password option is deprecated. Use passwordfile instead.

passwordfile

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 application server password, use an entry with the following format: AS_ADMIN_PASSWORD=password, where password is the actual administrator password. Other passwords that can be specified include AS_ADMIN_MAPPEDPASSWORD, AS_ADMIN_USERPASSWORD, AS_ADMIN_SAVEDMASTERPASSWORD, AS_ADMIN_MQPASSWORD, AS_ADMIN_ALIASPASSWORD, and so on.

s secure

If set to true, uses SSL/TLS to communicate with the domain application server.

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 the standard output. Default is false.

I interactive

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

agentdir

Like a Domain Application Server (DAS), each node agent resides in a top level directory named agentdir/nodeagent_name. If specified, the path must be accessible in the filesystem. If not specified, the node agent is created in the default install_dir/nodeagents directory.

startinstances

If set to true, all server instances that are not currently running are started. If set to false, instances are not started. If the option is omitted, it defaults to the value of the node agent's start-servers-in-startup attribute, located in the domain.xml.

OPERANDS

nodeagent_name

The name of the node agent to be started.

EXAMPLES

Example 1. Using the start-node-agent

This is a basic example of how the cammand is used.

asadmin>start-node-agent --user admin --passwordfile passwordfile nodeagent1
Nodeagent1 started.

Where: nodeagent1 is started in the default install_dir/nodeagentsdirectory.

EXIT STATUS

0

command executed successfully

1

error in executing the command

SEE ALSO

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


J2EE SDK 1.4Go To TopLast Changed 31 Jan 2005