Acceldata
 Pulse
Search documentation… ⌘K

Install PulseAXN Agent on Standalone VM

Install the PulseAxn (Pulse Actions) agent on a standalone VM using the hystaller binary.

Prerequisites

  • Access to License Portal
  • SSH access to the target VM
  • Permissions to:
    • write to /opt
    • manage systemd services
  • systemd available on the VM

Step 1: Download the hystaller binary

  1. Go to License Portal → Download Links
  2. Select the correct Pulse version from the dropdown
  3. Click Generate Links and download the hystaller binary
  4. Copy the binary to the target standalone VM

Example:

scp hystaller <user>@<vm-host>:/tmp/

Step 2: Create pulseaxn_env.sh

On the VM, ensure the script is created in the same directory as the hystaller binary.

cd /tmp
vi pulseaxn_env.sh
Add the following content:

#!/bin/sh
export PULSE_HOME="/opt/pulse"
export PATH="/usr/local/sbin:/usr/local/bin:/usr/sbin:/usr/bin:/sbin:/bin"
export AXN_PLUGIN_DIR="/opt/pulse/actions/plugins"
# If ad-events is a cluster, provide comma-separated hostnames
# Example: hostname1:19009,hostname2:19009
export AXN_EVENTS_URL="ad-events_hostname:19009"
# If Pulse is running on Kubernetes, provide the ad-axnserver ingress route
export AXN_SERVER_URL="ad-axnserver_hostname:19999"
export AXN_LOG_LEVEL="ERROR"
export AXN_HEARTBEAT_DURATION="10"
export AXN_PLAN_FETCH_INTERVAL="60"
export AXN_MAX_WORKERS="10"
export AXN_MAX_TASK_SIZE="10000"
export AXN_HOSTNAME_METHOD="ENV"
export PULSE_HOSTNAME="adaxn-standalone" # Change as required; must be unique
export AXN_HOSTNAME_CASE="lower"
export AXN_REQUEST_TIMEOUT="120"
export AXN_REQUEST_MAX_RETRIES="10"
export AXN_EVENTS_STREAM_NAME="pulse_axn"
export AXN_EVENTS_CONSUMER_NAME="pulse_axn_plan"
export TMPDIR="/opt/pulse/actions/tmp"
export PULSEAXN_HOME_DIR="/opt/pulse"
export EXECUTION_MODE="client-mode"

Step 3: Apply environment variables

chmod +x pulseaxn_env.sh
source pulseaxn_env.sh

Step 4: Install Pulseaxn agent

Run the installation command from the same directory as hystaller:

./hystaller install pulseaxn

Step 5: Validation

Check Pulseaxn service status

systemctl status pulseaxn
Expected status:

● pulseaxn.service - Acceldata Pulse Actions Agent - pulseaxn
Loaded: loaded (/etc/systemd/system/pulseaxn.service; enabled; preset: disabled)
Active: active (running) since Tue 2025-12-23 06:06:18 UTC; 2 days ago
Main PID: 1556736 (pulseaxn)
Tasks: 15 (limit: 201004)
Memory: 2.3G
CPU: 1d 4h 19min 7.660s
CGroup: /system.slice/pulseaxn.service
└─1556736 /opt/pulse/bin/pulseaxn
Dec 23 06:06:18 ip-10-0-6-46.ap-south-2.compute.internal systemd[1]: Started Acceldata Pulse Actions Agent - pulseaxn.
In case the systemd service status is inactive, check if the parent directory has proper permissions and restart the systemd service.

systemctl restart pulseaxn