Install Agents in a Custom Directory

This page describes how to deploy the Hydra Agent in a custom directory (other than /opt/pulse). It applies to all supported Pulse deployment methods:

  • SSH-based deployment
  • Hydra MPack (ODP clusters)
  • Parcels (CDP clusters)

This is supported from Pulse 4.1.0 onwards.

  • Changing the Hydra Agent directory requires an uninstall and reinstall of the agent. This process results in service downtime and the loss of existing files, including historical data such as Hydra logs.
  • Before changing the agent directory, ensure that you take a backup of all required files, including Hydra logs and any other relevant data, to avoid permanent data loss.

Overview

To install Hydra Agents in a custom directory, you must:

  1. Uninstall the existing Hydra Agents installed in /opt/pulse.
  2. Update Pulse configuration files to point to the new custom directory.
  3. Reinstall Hydra Agents using the selected deployment method.

Update Pulse Configuration

Before installing Hydra Agents, update the Pulse configuration on the Pulse node.

Update hydra_hosts.yml

Edit the following file:

Bash
Copy

Update these values:

Bash
Copy

Update vars.yml Using override.yml

To update the agent directory, create an override.yml file with the following content:

Bash
Copy

After creating the override file, run the following command:

Bash
Copy

This updates vars.yml with the new Pulse home directory.

SSH-Based Hydra Agent Deployment

  1. Complete the Update Pulse Configuration steps.
  2. Deploy Hydra Agents using the following command:
Bash
Copy

After the deployment:

  • The Hydra Agent services start automatically.
  • You can see the status on the Auditing page in the Pulse UI.

Ambari MPack-Based Deployment (ODP Clusters)

  1. Complete the Update Pulse Configuration steps.
  2. Install the Hydra MPack on the Ambari cluster (refer to the MPack installation documentation).
  3. During Hydra Agent configuration, update the following parameters:
Bash
Copy
  1. Proceed with the installation.

Once installation is complete, the Hydra Agent services are up and running.

CDP Parcels-Based Deployment

  1. Complete the Update Pulse Configuration steps.
  2. Add the Pulse Hydra parcels to the CDP cluster (refer to the parcels documentation).
  3. During Hydra Agent parcel configuration, update the following parameters:
    • Actions Plugin Directory
    • Hydra Agent Directory
  1. Proceed with the installation.

After installation, the Hydra Agent service starts successfully.

Type to search, ESC to discard
Type to search, ESC to discard
Type to search, ESC to discard