Post-Installation Steps for Pulseaxn Agent
Configure Pulse to recognize and execute actions on standalone Pulseaxn agents by:
- Updating hydra_host.yml
- Pushing configuration to Pulse
- 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
