Adding Satellite Managers to the mesh

Before you begin

Make sure that the following prerequisites are met:

• Make sure that you have configured the Content Manager.
• Make sure that the Manager software is installed on the target Satellite Managers as described in Installing-the-Manager-software-in-a-Multi-Manager-configuration.

To add Satellite Managers to the mesh

1. Log on to a server that you have designated as a Satellite Manager in your environment.
2. Open the /app/clarity/dmanager/etc/mesh.conf file in a text editor.

3. Add the following lines:
   manager_type=member
   mega_manager=Content_Manager_host_name
   nodenum=node_number
   
   The Content_Manager_host_name should be the fully qualified hostname of the Content Manager. The node_number should be a unique number other than 1 (1 is reserved for the Content Manager).

   Warning

   Important

   For megamesh to work correctly, the /home/clarity directory must exist and be owned by the clarity user.

4. Save the /app/clarity/dmanager/etc/mesh.conf file.

5. Link the PostgreSQL files from the corresponding directories using the following commands, depending on the RHEL version you are using:

   RHEL version	Directory	Command
   If you are installing on RHEL 9 or RHEL 8 with PostgreSQL server 15.x	/usr/pgsql-15/bin	ln -snf /usr/pgsql-15/bin/* /usr/bin/
   If you are installing on RHEL 8 or RHEL 7 with PostgreSQL server 11.x	/usr/pgsql-11/bin	ln -snf /usr/pgsql-11/bin/* /usr/bin/
   If you are installing on RHEL 8 or RHEL 7 with PostgreSQL server 12.4	/usr/pgsql-12/bin	ln -snf /usr/pgsql-12/bin/* /usr/bin/
   If you are installing on RHEL 7 with RH-PostgreSQL 12	/opt/rh/rh-postgresql12/root/usr	ln -snf /opt/rh/rh-postgresql12/root/usr/bin/* /usr/bin/ ln -snf /opt/rh/rh-postgresql12/root/usr/lib64/libpq.so.rh-postgresql12-5 /usr/lib64/

6. Run the configure_megamesh script:
   /app/clarity/manager_scripts/bin/configure_megameshThe first time this command is run on a Satellite Manager, an SSH key is generated in the
   /app/clarity/dmanager/etc/id_rsa.pub file. A message informs you of this and exits immediately afterward.

   Warning

   Important

   If the configure_megamesh script fails, do the following:

   1. Add the following lines to the /var/lib/pgsql/data/pg_hba.conf configuration file:host GridApp megamesh samenet password

      host GridApp megamesh_config samenet password
   2. Restart the postgresql service.

   Warning

   Important

   The public and private keys on the Satellite Manager are owned by the clarity (Satellite Manager) account.

7. Append the contents of the id_rsa.pub file to the /home/megamesh/.ssh/authorized_keys directory on the Content Manager.

   Warning

   Important

   If the /home/megamesh/.ssh directory does not exist on the Content Manager, create it, ensure that it has a change mode value of 0700 and is owned by the megamesh user. The authorized_keys file inside this directory should have a change mode value of 0600 and also be owned by the megamesh user.

8. To verify that you have completed the previous step successfully, log on as root and run the following on the Satellite (where <Content Manager hostname> is rh5-mm007-01.gridapp-dev.com, for example). This command attempts to ssh to the content manager and run the date command. If the current date and time are returned, the previous step has been completed successfully:
   su clarity -c 'ssh -i /app/clarity/dmanager/etc/id_rsa -o StrictHostKeyChecking=no -o UserKnownHostsFile=/app/clarity/dmanager/etc/ssh_known_hosts -l megamesh <Content Manager hostname> date'

   Warning

   Important

   If this command is successful, but the following error message appears: “Could not create directory '/home/clarity/.ssh'”, run the following two commands and proceed with the rest of the configuration steps:
   mkdir /home/clarity
   chown clarity -R /home/clarity.

9. Run the configure_megamesh script again:
   {{code language="none"}}
   /app/clarity/manager_scripts/bin/configure_megamesh
   
   {{/code}}

   Warning

   Important

   These are passwords that you used when you configured the Content Manager.

10. Open the /app/clarity/dmanager/etc/dmanager.conf file in a text editor.
11. Add the following lines:
    megamanager=Content_Manager_host_name
    service=static MegaManagerCommunicator "-t 1 -i 120 -f
    /app/clarity/dmanager/var/megamesh_failures"
    The Content_Manager_host_name should be the fully qualified hostname of the Content Manager.
12. Save the /app/clarity/dmanager/etc/dmanager.conf file.
13. Restart the dmanager service:
    service dmanager restart
14. Restart the Multi-Manager service on the Satellite Manager:
    service megamesh restart
15. Repeat steps 1 through 11 for the other Satellite Managers in the mesh.