Skip to Content

Installing the Agent software on a Linux, HP-UX, AIX, or Solaris server

This section describes how to install the Agent software on a Linux, HP-UX, IBM AIX, or Oracle Solaris server.

Error
Warning

Do not copy or clone installations of BMC Database Automation agents. Doing so will result in an unsupported configuration.

To install the Agent software on a Linux, HP-UX, AIX, or Solaris server

Warning

Note

If the version you want to install contains a comprehensive patch file, start with files from BDA_<version>_<patch_number>_Agents.zip downloaded from the BMC Electronic Product Distribution (EPD) site. To run a base version with no patch updates, use the BDA_<version>_Agents.zip download (which contains installation files for the BMC Database Automation Agent software for all platforms). For more information, see Downloading-the-installation-files.

  1. Install the Agent software package:
    • (Linux) Perform either of the following options:
      • To install in the /app/clarity directory, run the rpm -Uvh clarity-dagent-x.y.z-1. i386.rpm command.

      • To install in a directory other than /app/clarity, create the directory and use a sym-link before installing the package. For example, enter the following commands:

        mkdir -p /opt/bmc/BDA /app

        ln -s /opt/bmc/BDA /app/clarity

        Warning

        Note

        On Linux systems, the --prefix option can be used to specify an alternate installation directory (for example, rpm -i --prefix /opt/clarity <rpm>). On other UNIX systems, symlinks can be created prior to installing the agent to install in an alternate installation directory (for example, mkdir /opt/clarity; ln -s /opt/clarity /app).

    • (HP-UX) Run the gunzip command to decompress the file, then use the swinstall command to include the full path to the depot file and the appropriate version number. For example: swinstall -s /tmp/clarity-dagentx.y.z.depot dagent
    • (Solaris) Run the gunzip command to decompress the file, and then use the pkgadd -d/tmp/clarity-dagent-x.y.z.pkg command.
    • (AIX) Run the installp -agYX -d clarity-dagent-x.x.x.x.bff all command.

  2. Run the Agent software configuration script:
    /app/clarity/dagent/bin/reconfigure_dagent.sh 
     

    Success

    Tip

    You can also run the script non-interactively as follows:

    /app/clarity/dagent/bin/reconfigure_dagent.sh fq.manager.host[,2nd.manager...]

    The script starts and displays a warning that the existing dagent configuration on the node will be erased.

  3. Press any key to begin entering data into the script.
     The script prompts you to enter the host name of the Manager.

  4. Enter the fully qualified name of the Manager.
     The script saves the changes to the dagent.conf file and prompts you to press any key to restart dagent.

    Warning

    Note

    When configuring the Agent in a Multi-Manager environment, the Manager name specified in this step must be the host name of the Satellite Manager. 

  5. Press any key.
    The script stops dagent.

  6. Press any key.

    The script checks the manager connection, displays the result, and starts the dagent.

    After the Manager and Agent software are installed and running, hosts are automatically discovered and appear in the Pending Approval page of the Manager web-based GUI.

  7. Verify that the software is installed and running by going to the Pending Approval page where hosts pending approval appear.
     See Discovering-databases.

 

Tip: For faster searching, add an asterisk to the end of your partial query. Example: cert*

BMC Database Automation 20.20