An administrative agent environment consists of an administrative
agent and the stand-alone application servers that it manages. Setting
up an administrative agent environment involves creating an administrative
agent profile and one or more stand-alone application server profiles,
called nodes, on the same computer and then registering the
node profiles with the administrative agent.
Before you begin
Install the WebSphere® Application Server product.
newfeatMake sure that the nodes that you want the
administrative agent to manage have the same products as the administrative
agent, and the products are at the same version levels on these node
and the administrative agent. Starting with Version 7.0.0.13, this requirement is enforced
because the administrative agent must have a matching environment
in order to handle all of the administrative capabilities of the registered
node. A node is not allowed to register with an administrative agent
unless that node has an identical set of products and versions.
newfeatIf you were previously running on Version
7.0.0.11 or earlier, and have an administrative agent with a managed
node that has mismatched products or versions, when you apply Version
7.0.0.13 or later to the administrative agent, that administrative
agent will not be able to start the subsystem for any mismatched nodes.
You must update these nodes to have the same products and versions
as the administrative agents, restart the servers on the node and
then restart the administrative agent, before the administrative agent
can resume managing these registered nodes
About this task
You can use an administrative agent to manage base (stand-alone)
application servers that are on the same computer.
Administrative
agents and the managed nodes are part of the flexible management environment.
To
add an administrative agent to your environment, create an administrative
agent profile using the manageprofiles command or the Profile Management
Tool. To add a node, create a stand-alone application server profile
and then register the stand-alone application server with the administrative
agent. The nodes must be on the same computer as the administrative
agent.
Ensure that the
profiles in the flexible management environment either all have security
enabled or all have security disabled.
- Determine the topology for your administrative agent environment.
Determine which machines, stand-alone application server
nodes, and node resources such as applications that you want to use.
To
manage stand-alone application servers, use an administrative agent
on each computer where the stand-alone application servers reside.
For more information, see Scenarios 5 in the Planning to install WebSphere Application Server topic.
- Determine the security roles needed for your administrative
agent environment.
For an administrative agent environment,
you typically have one administrative agent profile and one or more
stand-alone application server profiles on the same computer. The
stand-alone application server nodes are registered to the administrative
agent. Profiles in the environment must either all have security enabled
or all have security disabled. When you create the profiles, you can
specify security options, user names, and passwords.
You must
have security roles that authorize you to work with an administrative
agent and to manage registered nodes and resources on those nodes.
For more information, see the administrative agent security topic.
- Create a management profile for the administrative agent.
You can use the Profile Management Tool or the manageprofiles command.
For
example, in the Profile Management Tool, select the Management environment
and click Next, select the Administrative
agent server type, and select options that create the
profile. By default, an administrative agent has its own administrative
console, administrative security is enabled, and the console port
is 9065. To disable administrative security, to specify a security
certificate, or to change the default ports, use the advanced profile
creation option when creating the administrative agent profile.
By
default, the first administrative agent profile in a product installation
is named AdminAgent01 and its server name is adminagent.
For
more information, see the topic on creating management profiles for
administrative agents.
For manageprofiles examples,
see the topic on the manageprofiles command. For -templatePath,
specify the management template. For -serverType,
specify ADMIN_AGENT.
- Create profiles for the stand-alone application server
nodes that you intend to have in your flexible management environment.
Create profiles for one or more stand-alone application server
nodes that reside on the same computer as the administrative agent
profile. You can use the Profile Management Tool or the manageprofiles command.
For
example, in the Profile Management Tool, select the Application
server environment and click Next,
and then select options that create the profile. By default, an application
server has its own administrative console, administrative security
is enabled, and the console port is 9060. To disable administrative
security, to specify a security certificate, to specify to install
sample application, or to change the default ports, select the advanced
profile creation option when creating the application server profile.
By
default, the first application server profile in a product installation
is named AppSrv01 and its server name is server1.
For
more information, see the topic on creating application server profiles.
For manageprofiles examples,
see the topic on the manageprofiles command. For -templatePath,
specify the default template. Do not specify a -serverType parameter.
- Start the administrative agent server.
If the administrative agent starts successfully, the open
for e-business message displays and is written to the administrative
agent startServer.log file:
Server launched. Waiting for initialization status.
Server adminagent open for e-business; process id is 1932.
For
more information, see the topic on starting and stopping the administrative
agent.
- Register the stand-alone application server nodes with
the administrative agent.
Run the registerNode command
of the administrative agent.
When you run the registerNode command,
you can optionally specify parameters such as -node to
assign a node name and -port to assign an administrative
agent connector port. If security is enabled for the node that you
are registering and the node user name and node password are different
than those used for the administrative agent, specify values for -nodeusername and -nodepassword.
For more information, see the topic on the registerNode command.
To
register the AppSrv01 profile with the administrative agent, run the
following command from the bin directory of the
administrative agent profile:
registerNode -profilePath user_data_root/profiles/AppSrv01
For more information, see the topic on the registerNode command.
- Verify that the nodes have been registered to the administrative
agent.
You can use the administrative agent console
or wsadmin scripting commands to see a list of nodes that are registered
with the administrative agent.
- Start the stand-alone application server nodes.
Run
the startServer command.
startServer server1
If the
server starts successfully, the open for e-business message
displays and is written to the startServer.log file.
For
more information, see topics on the startServer command and on starting
application servers.