A node agent is a lightweight process running on each machine that participates in an administrative domain. The node agent is responsible for starting and stopping server instances on the host. It also communicates with the Domain Administration Server to create new instances.
You can use node agents only on domains with the cluster profile or enterprise profile. If you are running only a developer domain, you need to create a domain with cluster profile before you can create and use node agents. For information on creating domains, type asadmin create-domain --help or see the create-domain(1) man page.
One node agent is needed on a machine for each administrative domain that the machine belongs to. A default node agent called hostname may be created during installation. If not, create a node agent, using the create-node-agent(1) command.
In a terminal window, type this command:
asadmin start-node-agent nodeagentname
Replace the variable nodeagentname with the name of the node agent you created. If your default domain on port 4848 (domain1) is not running on cluster profile or enterprise profile, use the --port option to specify the port of the cluster or enterprise domain.
When you are prompted, provide the master password.
The node agent starts and connects with the Domain Administration Server.
Ensure that the Domain Administration Server is running before you start the node agent. Check the server.log file of a cluster instance to identify problems related to starting node agents or cluster instances.
If you have problems while starting a node agent or a cluster on Windows, see the Sun GlassFish Enterprise Server 2.1 Release Notes for possible solutions to the problem.
After the node agent has been started once, you can view it in the Admin Console.
In this section you started the Domain Administration Server and confirmed that it is running. You also logged in to the Admin Console and used the Log Viewer. You started the node agent. You can stop the Quick Start trail here if you do not wish to continue, or you can go on to the next section.