registerNode command


Use registerNode to register a standalone node with an administrative agent so that the administrative agent can manage the node.

Run the registerNode command from the bin directory of the administrative agent server to register a node with the administrative agent. When you run the command, the standalone node is converted into a node that the administrative agent manages. The administrative agent and the node being registered must be on the same system. We can only run the command on an unfederated node. If the command is run on a federated node, the command exits with an error.

When you run the registerNode command, the command stops all running appservers on the node. We can optionally stop application servers on the node that we are registering prior to running the registerNode command.

If the admin console or the management EJB applications of the application server being registered are enabled, the node registration process disables them.

 

Syntax

The registerNode command syntax is as follows:

registerNode [options]

 

Parameters

The following options are available for the registerNode command:

-conntype<JSR160RMI|IPC|RMI|SOAP>

The optional connector type used to connect to the administrative agent to initiate node registration. The default is SOAP.

Deprecated feature: You should eventually switch from the RMI connector to the JSR160RMI connector because support for the RMI connector is deprecated.

-host host_name

An optional parameter that specifies the host name of the administrative agent.

-name managed_node_name

An optional parameter that specifies the name of the managed node after the node is registered with the administrative agent.

-nodepassword node_password

An optional parameter that specifies the password of the node that we are registering. Specify if security is on at the node and the password is different than the administrative agent password. Use this parameter with the -nodeusername parameter. The -nodeusername and -nodepassword parameters are used to stop all servers on the node.

-nodeusername node_user_name

An optional parameter that specifies the use name of the node that we are registering. Specify if security is on at the node and the user name is different than the administrative agent user name. Use this parameter with the -nodepassword parameter. The -nodeusername and -nodepassword parameters are used to stop all servers on the node.

-openConnectors connectors

An optional parameter that specifies a list of connectors separated by commas of connectors that the administrative agent will open. By default, all connectors are opened.

-port port_number

An optional parameter that specifies the port number of the administrative agent connector port.

The default port number is 8878 for the default SOAP port of the administrative agent. SOAP is the default Java Management Extensions (JMX) connector type for the command. If we have multiple product installations or multiple profiles, the SOAP port might be different than 8878. Examine the administrative agent SystemOut.log file to see the current ports in use.

-profilePath profile_path

A required parameter that specifies the path to the profile of the appserver node to be registered.

-trace

An optional parameter that provides tracing output for the registerNode command.

-portsFile ports_file

An optional parameter that specifies the path to a file that defines port settings for the newly registered node.

During node registration, the registerNode command uses an automatically generated set of recommended ports if we do not specify the -portsFile parameter. The recommended port values can be different than the default port values based on the availability of the default ports.

The format of the ports_file file specified is the same as the portdef.props file, except that only the following ports are used: SOAP_CONNECTOR_ADDRESS, RMI_CONNECTOR_ADDRESS, JSR160RMI_CONNECTOR_ADDRESS, and IPC_CONNECTOR_ADDRESS.

-profileName profile_name

An optional parameter that specifies the profile name of the administrative agent.

-username username

An optional parameter that specifies the user ID to log onto the administrative agent.

-password password

An optional parameter that specifies the password to log onto the administrative agent.

-help

An optional parameter that prints a usage statement.

-?

An optional parameter that prints a usage statement.

 

Usage scenarios

The following examples demonstrate correct syntax. Commands are split on multiple lines for printing purposes. [AIX] [HP-UX] [Linux] [Solaris]

registerNode.sh -conntype SOAP -port 8878 
 -profilePath APP_ROOT/profiles/AppSrv01


(Windows)

registerNode.bat -conntype SOAP -port 8878 
 -profilePath APP_ROOT\profiles\AppSrv01





 

Related tasks


Administer nodes using the administrative agent
Use command line tools

 

Related


deregisterNode