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

- Previous: Prerequisites
- Next: Configuring a Cluster for High Availability

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

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

### To 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`

### To 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:

   - HADB_ROOT is the HADB installation directory, HADB_install_dir.

   - HADB_MA_CFG is the location of the management agent configuration file. For more information, see Customizing Management Agent Configuration

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

### To 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`

- Previous: Prerequisites
- Next: Configuring a Cluster for High Availability

- © 2010, Oracle Corporation and/or its affiliates