Starting and stopping the administrative agent

In your flexible management environment, you can start the administrative agent by using the startServer command. You can stop the administrative agent by using the stopServer command.

Before you begin

Before you can start or stop the administrative agent, you must first install the product.

About this task

Start the administrative agent so that you can manage multiple application servers. Stop the administrative agent as needed, such as when migrating to a new version of the product, when uninstalling the product, and so on.

Procedure

  • Start the administrative agent.
    Use one of these methods to start the administrative agent:
    • Use the startServer command:
      startServer <administrative_agent>

      where administrative_agent is name of the administrative agent that you want to start.

      [IBM i]Use the startServer Qshell script.

      [Windows]For example, from a command dialog at the bin directory of the administrative agent profile, run the serverStatus -all command. Suppose running the command shows that the administrative agent profile is named adminagent. To start the administrative agent, run the following command from a command dialog at the bin directory of the administrative agent profile:
      startServer adminagent
    • [IBM i]Use the Submit Job (SBMJOB) CL command.
      You can run the CL command from an IBM® i command line:
      SBMJOB CMD(CALL PGM(product_library/QWASSTRSVR) PARM('-profilePath'
        'profile_root' '-server' 'administrative agent')) JOB(server)
        JOBD(QWAS85/QWASJOBD) JOBQ(QWAS85/QWASJOBQ) USER(QEJBSVR) LANGID(*USRPRF)
        CNTRYID(*USRPRF) CCSID(*USRPRF) OUTQ(QWAS85/QWASOUTQ) ALWMLTTHD(*YES)
      • The profile_root element is the profile root of the administrative agent.
      • The administrative agent element is the name of the administrative agent server that you want to start.
    • [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.

    • [Windows]Use the administrative agent First steps dialog.
      1. Click Start > [All] Programs > IBM WebSphere > product_name > Profiles > administrative_agent_profile_name > First steps.
      2. In the First steps dialog, click Start the admin agent.
  • Stop the administrative agent.
    Use one of these methods to stop the administrative agent:
    • Use the stopServer command:
      stopServer <administrative_agent>

      where administrative_agent is name of the administrative agent that you want to stop.

      [IBM i]Use the stopServer Qshell script.

      [Windows]For example, from a command dialog at the bin directory of the administrative agent profile, run the serverStatus -all command. Suppose running the command shows that the administrative agent profile is named adminagent. To stop the administrative agent, run the following command from a command dialog at the bin directory of the administrative agent profile:
      stopServer adminagent
    • [IBM i]Use the end job (ENDJOB) CL command.
      To use the ENDJOB CL command to end an administrative agent, enter this command on an IBM i command line:
      ENDJOB JOB(jobNumber/QEJBSVR/jobName) OPTION(*CNTRLD) DELAY(delayTime)
      
      The jobNumber element is the job number, the jobName element is the name of administrative agent job, and the delayTime element is the amount of time to wait for the job to end in seconds. Use a value of 600 seconds initially. Read about the appropriate delay time in the topic on shutting down the product subsystem.
    • [Windows]Use the Windows operating system Taskbar.

      Click Start > [All] Programs > IBM WebSphere > product_name > Profiles > administrative_agent_profile_name > Stop the administrative agent management server.

    • [Windows]Use the administrative agent First steps dialog.
      1. Click Start > [All] Programs > IBM WebSphere > product_name > Profiles > administrative_agent_profile_name > First steps.
      2. In the First steps dialog, click Stop the admin agent.

Results

You have started the administrative agent and have optionally stopped it.

What to do next

Administer application servers using the administrative agent. You can do such tasks as configure the administrative agent, view or change properties for a node registered to the administrative agent, or view and change the job manager configuration for a registered node.