Installing the Manager software in a Multi-Manager configuration

This topic describes how to install the BMC Database Automation (BDA) Manager software in a mesh on several servers. BDA uses the Slony-I enterprise-level replication system to provide the mesh for the Multi-Manager configuration. For more information on Slony-I, see http://www.slony.info/.

Before you begin

Make sure that the following prerequisites are met:

  • You have satisfied the OS requirements for Multi-Manager environments.
  • You must have root user privileges to perform this installation.
  • Slony-I must be compiled at your site (supported versions are 1.2 and 2.1). The following tools are required to compile Slony-I:
    • GNU make version 3.76 and later
    • An ISO/ANSI C compiler, such as GCC
    • PostgreSQL source version 7.3.3 and later

Note

For additional information on system requirements for Slony-I, see http://www.slony.info/documentation/1.2/requirements.html.

To install the Manager software in a Multi-Manager configuration

Perform the following steps on every manager that will be in the mesh:

  1. Install the Manager software on the servers that will comprise the mesh using the steps in Installing-the-Manager-software-in-a-stand-alone-configuration.
  2. To ensure that the changes made in this procedure are saved, make sure the dmanager, mtd and postgresql services are running.
  3. Download the Slony source file:
    • Red Hat Enterprise Linux 5 (RHEL 5):
      wget http://slony.info/downloads/1.2/source/slony1-1.2.14.tar.bz2
    • RHEL 6 and RHEL 7:
      wget http://slony.info/downloads/2.1/source/slony1-2.1.1.tar.bz2
    • RHEL 7.5 with PostgreSQL server 9.6.x:
      wget http://main.slony.info/downloads/2.2/source/slony1-2.2.7.tar.bz2
    • RHEL 6 and RHEL 7 with PostgreSQL server 11.x:
      wget http://main.slony.info/downloads/2.2/source/slony1-2.2.7.tar.bz2
  4. (Only if you are installing on RHEL 7.5 with PostgreSQL server 9.6.x)
    1. Use the command PATH=$PATH:/usr/pgsql-9.6/bin/ to set the path variable for PostgreSQL 9.6.x.
    2. Ensure that gcc is installed. If not, then install gcc-4.8.x or later.
    3. Link the PostgreSQL files from the /usr/pgsql-9.6/bin directory:
      ln -snf /usr/pgsql-9.6/bin/* /usr/bin/
  5. (Only if you are installing on RHEL 6 or RHEL 7 with PostgreSQL server 11.x)
    1. Use the command PATH=$PATH:/usr/pgsql-11/bin/ to set the path variable for PostgreSQL 11.x.
    2. Make sure that gcc is installed. If not, then install gcc-4.8.x or later.
    3. Link the PostgreSQL files from the /usr/pgsql-11/bin directory:
      ln -snf /usr/pgsql-11/bin/* /usr/bin/
  6. To unpack, compile, and install Slony, type the following commands and press <Enter>:
    1. tar xvjf <downloaded file from previous step>
    2. cd <extracted directory>
    3. ./configure --with-pgconfigdir=`which pg_config` --with-perltools=/var/lib/pgsql/data/slony
    4. make
    5. make install

      Note

      The Slony-I build requires the pg_config tool to run correctly. This tool is installed with the postgres-devel RPM. For example, the full name of the postgresql-devel tools RPM for Red Hat Enterprise Linux version 6 is postgresql-devel-8.4.4-2.el6.x86_64. If you find that the pg_config tool is missing, you must download and install the postgres-devel RPM. See http://www.postgresql.org/ for download information for the RPM.

  7. Link the Slony initialization script from the /etc/init.d directory:
    ln -s /app/clarity/manager_scripts/bin/slony.init /etc/init.d/slony

  8. Grant remote login privileges to the Multi-Manager postgres users for all managers in the mesh:

    Note

    The following changes should be added in addition to the BDA default entries (for example, tcrimi) that are already present in the postgres configuration files.

    1. If the Manager is to be used as a Content manager:
      1. Open the /var/lib/pgsql/data/pg_hba.conf file in a text editor.

      2. Add the the following lines at the beginning of the file:local   GridApp     megamesh_config                      trust

        host    GridApp     megamesh_config     127.0.0.1/32     trust
        host    GridApp     megamesh_config     ::1/128          trust
      3. Add the following lines under the lines that you added in the previous step (two-line entries for each Satellite manager in the mesh):
        host all megamesh <satellite1 IP> 255.255.255.255 password
        host all megamesh_config <satellite1 IP> 255.255.255.255 password
      4. Save the /var/lib/pgsql/data/pg_hba.conf file.
      5. Open the /var/lib/pgsql/data/postgresql.conf file in a text editor.
      6. Add the following line at the beginning of the file:
        listen_addresses = '*'
      7. Save the /var/lib/pgsql/data/postgresql.conf file.
      8. Restart the postgresql service:
        service postgresql restart
        For restarting the postgresql-9.6 service:
        service postgresql-9.6 restartFor restarting the postgresql-11 service:
        service postgresql-11 restart
      9. (BDA version 8.9.01 and later) Restart the middle tier service:
        service mtd restart
    2. If the Manager is to be used as a Satellite manager:
      1. Open the /var/lib/pgsql/data/pg_hba.conf file in a text editor.

      2. Add the the following lines at the beginning of the file:local   GridApp     megamesh_config                      trust

        host    GridApp     megamesh_config     127.0.0.1/32     trust
        host    GridApp     megamesh_config     ::1/128          trust
      3. Add the following lines immediately under the lines that you added in the previous step:
        host all megamesh <content manager IP> 255.255.255.255 password
        host all megamesh_config <content manager IP> 255.255.255.255 password

      4. Add the following lines immediately under the lines that you added in the previous step:

        Note

        satellite IP is the IP address of the server that you selected in step 7b (in other words, the server itself).

        host all megamesh <satellite IP> 255.255.255.255 password

        host all megamesh_config <satellite IP> 255.255.255.255 password

      5. Save the /var/lib/pgsql/data/pg_hba.conf file.
      6. Open the /var/lib/pgsql/data/postgresql.conf file in a text editor.
      7. Add the following line at the beginning of the file:
        listen_addresses = '*'
      8. Save the /var/lib/pgsql/data/postgresql.conf file.
      9. Restart the postgresql service:
        {{code language="none"}}
        service postgresql restart
        {{/code}}
        For restarting the postgresql-9.6 service:
        service postgresql-9.6 restart
        For restarting the postgresql-11 service:
        service postgresql-11 restart
      10. (BDA version 8.9.01 and later) Restart the middle tier service:
        service mtd restart

  9. To access the GUI by using the https protocol, install the Apache mod_ssl package on all servers where you have installed the Manager software, and run the following command: 
    {{code language="none"}}
    /app/clarity/var/www/mgmt/bin/enable_ssl.sh
    {{/code}}

    Note

    Running the enable_ssl script results in the use of the test Secure Sockets Layer (SSL) certificate that ships with the Apache server that came with Red Hat Enterprise Linux. For more information about how to replace this certificate with your own SSL certificate, refer to the Red Hat User documentation.

The software is now installed in the /app/clarity/dmanager directory and by default, GUI is available on port 80 (http protocol) and port 443 (https protocol) of the Manager server. For instructions to access the GUI, see Accessing-the-interface.

Where to go next

See Configuring-a-Multi-Manager-mesh.

Related topics

Performing-the-installation

Archiving-restoring-jobs-and-creating-backup-files

 

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