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.
Make
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 nodes and the administrative
agent. This requirement is enforced because the administrative agent
must have a matching environment to handle all the administrative
capabilities of the registered node. A node cannot register with
an administrative agent unless that node has an identical set of products
and versions.
A DMZ proxy does not work with the administrative
agent when security is enabled. Keep security enabled and do not use
the administrative agent in a DMZ proxy environment.
transition: If you were previously running
on Version 8.0 or earlier, and have an administrative agent with a
managed node that has mismatched products or versions, when you migrate
to Version 8.5, 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 node 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 computers, 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.
What to do next
Use the administrative agent to monitor and configure
the stand-alone application server nodes. For example, after a stand-alone
application server is registered with an administrative agent, you
must use the administrative agent console to work with the stand-alone
application server. On the login page of the administrative agent
console, select the stand-alone application server node to access
the application server console.