Update the Agent’s DNS Address Configuration

You may need to update the Agent’s DNS address configuration if the Agent is in a disconnected status. This may happen if the Agent was set up incorrectly or if you’re an Alation Cloud Service customer who’s been upgraded to the cloud native architecture (available starting in 2022.4).

To update the Agent’s DNS address configuration, first you need to get the correct DNS address of your Alation cloud instance. Then you need to enter the address into the Agent’s configuration file. This process is described in detail below.

Get the Alation Cloud Address

You can get the address used by the Agent within your Alation Cloud instance by starting, but not finishing, the Agent installation process:

  1. In Alation, click on the Settings gear icon in the top right corner. This opens the Admin Settings page.

    ../../_images/TopNavigationBar_Gear.png
  2. Under the Server Admin section, click Manage Connectors.

    ../../_images/AdminSettings_ManageConnectors.png
  3. Click the Agents tab. The Agents Dashboard appears.

  4. Click the Add New Agent button.

    ../../_images/Agent_AddNewAgentButton.png

    The Add New Agent dialog will appear.

  5. The first step of the installation process will show the address.

    ../../_images/Agent_AddNewAgent_Install_Address.png
  6. Select the address and save it in a secure location. Then click the X button to exit the Add New Agent dialog. (You should not install or reinstall an Agent now.)

Edit the Agent Configuration File

Now that you have the correct address of your Alation cloud instance, you need to enter the address into the Agent’s configuration file.

  1. The Agent configuration file is located on the Agent host machine at /etc/hydra/hydra.toml. Edit the file using your preferred text editor. You may need to use sudo privileges.

  2. In hydra.toml, you should see the following lines:

    [proxy]
    
    address = "your-alation-cloud-address"
    

    Replace the part inside the quotation marks with the Alation cloud address you obtained earlier. If the address is already correct, you don’t need to do anything else.

  3. Restart the agent by running the following command:

    sudo hydra restart
    
  4. In Alation, return to the Agents Dashboard and verify that the Agent is now connected to Alation. (For instructions on getting to the Agents Dashboard, see the first three steps under Get the Alation Cloud Address above.)