Setting up the administrative agent environment

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.

[Fix Pack 13 or later] 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 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.

[Fix Pack 13 or later] If 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.

Procedure

  1. 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.

  2. 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.

  3. 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.

  4. 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.

  5. Start the administrative agent server.
    • Run the startServer command.

      For example, suppose the AdminAgent01 profile has the server name adminagent. Run the following command from the bin directory of the AdminAgent01 profile:

      startServer adminagent
    • [Windows] Use the Windows® operating system Taskbar.

      Click Start > [All] Programs > IBM WebSphere > product_name > Profiles > administrative_agent_profile_name > Start the administrative agent management 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.

  6. 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:

    [AIX] [HP-UX] [Linux] [Solaris]
    registerNode.sh -profilePath app_server_root/profiles/AppSrv01
    [Windows]
    registerNode -profilePath app_server_root\profiles\AppSrv01
    [Windows] For example, to register the AppSrv01 profile with the administrative agent and specify other values, such as 8877 for the administrative agent port and nodeA for the AppSrv01 node name, run the following command from the bin directory of the administrative agent profile:
    registerNode -profilePath C:\v70_WAS\IBM\WebSphere\AppServer\profiles\AppSrv01 -host localhost -conntype SOAP -port 8877 -name nodeA

    For more information, see the topic on the registerNode command.

  7. 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.

    • Use the administrative agent console to see a list of managed nodes.
      1. Start the administrative agent console.

        [Windows] Click Start > [All] Programs > IBM WebSphere > product_name > Profiles > administrative_agent_profile_name > Administrative console.

      2. On the opening page of the administrative agent console, select to administer the administrative agent. The administrative agent has a name such as host_nameAANode01.
      3. Log in to the administrative agent console.
      4. Examine the Nodes page.
        1. Click System administration > Administrative agent.
        2. On the Configuration tab of the Administrative agent page, click Nodes.
      5. Ensure that the Nodes page lists nodes that have been registered with the administrative agent.
    • Use the AdminConfig list command to see a list of managed nodes. Run the following wsadmin scripting commands from the administrative agent bin directory.
      • To use the Jython scripting language, enter the following two commands in succession:
        wsadmin -lang jython
        
        print AdminConfig.list('ManagedNode')
      • To use the Jacl scripting language, enter the following two commands in succession:
        wsadmin
        
        $AdminConfig list ManagedNode

      After you verify that the stand-alone application server nodes are registered with the administrative agent, enter quit to exit the wsadmin scripting tool.

  8. Start the stand-alone application server nodes.

    Run the startServer command.

    [AIX] [HP-UX] [Linux] [Solaris] [Windows] For example, suppose the AppSrv01 stand-alone application server profile has the server name server1. From the bin directory of the AppSrv01 profile, run the following command:

    startServer server1

    [Windows] You can also use the Windows operating system Taskbar. Click Start > [All] Programs > IBM WebSphere > product_name > Profiles > application_server_profile_name > Start the server.

    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.

Results

The administrative agent environment is set up and the nodes are running.

What to do next

Use the administrative agent to monitor and configure the stand-alone application server nodes.

Avoid trouble: Even though the administrative agent console navigation implies that you can specify SIP application router settings for the administrative agent, if you have the Feature Pack for Communications Enabled Applications (CEA) Version 1.0.0.7 or higher installed on your system, you must use either the administrative console or wsadmin commands for the managed server to specify SIP application router settings.gotcha



In this information ...


IBM Redbooks, demos, education, and more

(Index)

Use IBM Suggests to retrieve related content from ibm.com and beyond, identified for your convenience.

This feature requires Internet access.

Task topic    

Terms of Use | Feedback

Last updated: Oct 21, 2010 1:44:59 AM CDT
http://www14.software.ibm.com/webapp/wsbroker/redirect?version=compass&product=was-express-dist&topic=tagt_adminagent_setup
File name: tagt_adminagent_setup.html