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

Go to License Portal → Download Links
Select the correct Pulse version from the dropdown
Click Generate Links and download the hystaller binary
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

Last updated on

Was this page helpful?