Sun Java System Application Server Enterprise Edition 8.1 2005Q2 High Availability Administration Guide

Starting the HADB Management Agent

The management agent, ma, executes management commands on HADB hosts and ensures availability of the HADB node supervisor processes by restarting them if they fail.

For a production deployment, start the management agent as a service to ensure its availability. This section provides abbreviated instructions for starting the management agent as a service with its default configuration.

For more details, including instructions on starting the management agent in console mode for testing or evaluation and information on customizing its configuration, see Using the HADB Management Agent.

This section describes how to start the management agent as a service with default configuration when using Java Enterprise System.

ProcedureTo Start the Management Agent with Java Enterprise System on Solaris or Linux

  1. Create the following softlinks to the file /etc/init.d/ma-initd:


    /etc/rc0.d/K20ma-initd
    /etc/rc1.d/K20ma-initd
    /etc/rc2.d/K20ma-initd
    /etc/rc3.d/S99ma-initd
    /etc/rc5.d/S99ma-initd
    /etc/rcS.d/K20ma-initd
  2. Reboot the machine.

    To deactivate automatic start and stop of the agent, remove the links or change the letters K and S in the link names to lowercase.

ProcedureTo Start the Management Agent with Java Enterprise System on Windows

  1. Open a command window.

  2. Enter the command: HADB_install_dir\bin\ma -i.

    This installs and starts the management agent with its default configuration.

Next Steps

To stop the management agent and remove (deregister) it as a service, use the command: HADB_install_dir\bin\ma -r

ProcedureTo Start the Management Agent with Standalone Application Server on Solaris or Linux

  1. In a shell, change your current directory to HADB_install_dir /bin.

  2. Edit the shell script ma-initd .

    Replace the default values of HADB_ROOT and HADB_MA_CFG in the script to reflect your installation:

  3. Copy ma-initd to the directory /etc/init.d

  4. Create the following soft links to the file /etc/init.d/ma-initd:


    /etc/rc0.d/K20ma-initd
    /etc/rc1.d/K20ma-initd
    /etc/rc2.d/K20ma-initd
    /etc/rc3.d/S99ma-initd
    /etc/rc5.d/S99ma-initd
    /etc/rcS.d/K20ma-initd

ProcedureTo Start the Management Agent with Standalone Application Server on Windows

  1. Open a command window.

  2. Enter the command: HADB_install_dir\bin\ma -i ma.cfg

    Now if the process fails or the machine reboots, the management agent will automatically restart.

Next Steps

To stop the management agent and remove (deregister) it as a service, use the command: HADB_install_dir\bin\ma -r ma.cfg