Update Alation Connector Manager

Customer Managed Applies to customer-managed instances of Alation

Applies from release 2021.1

After updating your Alation instance to a newer release, use these steps to update Alation Connector Manager. This instruction applies when Alation Connector Manager and OCF connectors are installed on the same host with the Alation application.

Note

Alation Connector Manager only needs to be updated when an Alation release or a patch release includes changes that affected it. This is usually called out in the update instructions for a specific release.

RHEL and RHEL-Based SystemsUbuntu and Debian

To update Alation Connector Manager:

1. On the Alation host, outside of the Alation shell, stop Alation Connector Manager (ACM).

   • REGULAR DOCKER

     sudo service hydra stop
     

   • ROOTLESS DOCKER

     • On any operating system except Oracle Linux 7, use this command:

       systemctl stop --user hydra
       

     • On Oracle Linux 7 only, use this command:

       hydra stop
       

2. Make sure that the corresponding container is stopped.

   • REGULAR DOCKER

     sudo docker ps --filter name=agent
     

   • ROOTLESS DOCKER

     docker ps --filter name=agent
     

3. Stop Docker.

   • REGULAR DOCKER

     sudo systemctl stop docker
     

   • ROOTLESS DOCKER

     • On any operating system except Oracle Linux 7, use this command:

       systemctl stop --user hydra
       

     • On Oracle Linux 7, skip this step. For Oracle Linux 7, Docker in rootless mode is managed entirely by ACM itself.

4. Determine the new available version of Alation Container Service.

   ls /opt/alation/alation/opt/addons/alation_container_service
   

5. Update the Alation Container Service. In the command below, substitute the placeholder value <version_number> with the version number you found out.

   sudo yum upgrade -y /opt/alation/alation/opt/addons/alation_container_service/alation-container-service-<version_number>-1.x86_64.rpm
   

6. Copy and paste the script below into the console and run it. The script will update the alation-hydra package on the host. Respond to the prompt in the console to confirm the update.

   if sudo yum list install hydra &> /dev/null; then
   sudo yum install /opt/alation/alation/opt/addons/hydra/hydra.rpm
   else
   sudo yum update /opt/alation/alation/opt/addons/hydra/hydra.rpm
   fi
   

7. Start Docker.

   • REGULAR DOCKER

     sudo systemctl start docker
     

   • ROOTLESS DOCKER

     • On any operating system except Oracle Linux 7, use these command:

       systemctl start --user docker
       

     • On Oracle Linux 7 only, skip this step.

8. Start ACM.

   • REGULAR DOCKER

     sudo service hydra start
     

   • ROOTLESS DOCKER

     • On any operating system except Oracle Linux 7, use this command:

       systemctl start --user docker
       

     • On Oracle Linux 7 only, use this command:

       hydra start
       

9. Confirm that the agent and connector containers are running by listing the containers.

   • REGULAR DOCKER

     sudo docker ps
     

   • ROOTLESS DOCKER

     docker ps
     

10. Enter the Alation shell.

    sudo /etc/init.d/alation shell
    

11. Change the user to alation.

    sudo su alation
    

12. Verify that the Django OCF Connector service ypireti can reach ACM.

    alation_ypireti list --fields id name hydra
    

    The output will confirm connection to ACM at the configured port and print the current OCF connector metadata if any OCF connectors are installed.

13. Exit from the user and the Alation shell by using exit two times.

Check Version of Alation Connector Manager

To find out the version of Alation Connector Manager that is installed on the Alation host:

1. Use SSH to connect to the Alation host.

2. On the host, outside of the Alation shell, check the version with this command:

   sudo hydra version
   

The output will look similar to the following:

[ssh-user@ip-172-31-27-47]$ sudo hydra version

Hydra version 1.2.0-766, by Alation
Built on Fri, 22 Apr 2022 17:56:24 +0000
Key Generation and Encryption Provided by OpenSSL 1.1.1n
Git Commit                  21b02e4
Hydra Agent                 603c031b177d
Hydra Remote Proxy          f70f79b10b4c

Check Alation Connector Manager Package Version

From version 2022.2, you can find the version number in the name of the Alation Connector Manager package in /opt/alation/alation/opt/addons/hydra (ouside of the Alation shell), for example: /opt/alation/alation/opt/addons/hydra/hydra-1.2.0-766.rpm.

Note

This directory also contains symlinks hydra.deb and hydra.rpm, which is expected.

In versions before 2022.2, the package version is not present in the package name.