Post-Installation Steps for Pulseaxn Agent

Configure Pulse to recognize and execute actions on standalone Pulseaxn agents by:

  1. Updating hydra_host.yml

  2. Pushing configuration to Pulse

  3. Enabling standalone actions mode in ad-axnserver

Prerequisites

  • Pulseaxn agent installation is completed and running

  • You know the PULSE_HOSTNAME values configured in:

    • pulseaxn_env.sh (VM)

    • or Kubernetes deployment env (PULSE_HOSTNAME)

  • Access to:

    • Manager Server API (for Kubernetes Pulse)

    • accelo CLI (for non-Kubernetes Pulse)


Step 1: Update hydra_host.yml

On the node where Pulse is installed (VM or Kubernetes cluster), edit the host section of hydra_host.yml.

Example:

cluster: hosts: "adaxn.standalone": "" "adaxn.agent": ""

Important notes:

  • Hostnames must exactly match the value of PULSE_HOSTNAME configured in the Pulseaxn agent.

  • If multiple standalone Pulseaxn agents exist, list all of them under cluster.hosts.

Step 2: Push hydra_host.yml configuration to Pulse

A. Pulse running on Kubernetes

Use the push-config API to update the configuration in MongoDB:

curl --request PUT \ --url http://<Ingress API for the Manager Server>/api/v1/mserver/dbpush/<clustername> \ --header 'Authorization: Basic cHVsc2U6MjYzZjlmNTE2ZjdmNTA5OTE5NGI5MjZlZGJkZmY0ZmY='

This pushes the updated hydra_host.yml to the cluster configuration store.

B. Non-Kubernetes Pulse installation (VM / Docker)

Run the following command on the Pulse node:

accelo admin database push-config

Ensure you are pushing the config for the correct cluster where the standalone Pulseaxn agent is configured.

Step 3: Enable standalone actions mode in ad-axnserver

Pulse must be explicitly configured to read hosts from hydra_host.yml instead of Victoria Metrics.

A. Pulse on Kubernetes

Edit the ad-axnserver deployment:

kubectl edit deployment ad-axnserver -n <pulse_namespace>

Add the following environment variable under env:

- name: STANDALONE_ACTIONS_ENABLED - value: "true"

Save and exit.

Kubernetes automatically rolls out a new pod with updated configuration.

B. Non-Kubernetes Pulse deployment

Step 1: Ensure the config file exists

If the file does not exist, create it:

accelo admin makeconfig ad-axnserver

This creates:

$AcceloHome/config/docker/addons/ad-axnserver.yml

Step 2: Edit the config file

Add the following under the environment: section:

- STANDALONE_ACTIONS_ENABLED=true

Step 3: Restart ad-axnserver

accelo restart ad-axnserver