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
systemdservices
- write to
systemdavailable 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 /tmpvi pulseaxn_env.shAdd the following content:
x
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:19009export AXN_EVENTS_URL="ad-events_hostname:19009"# If Pulse is running on Kubernetes, provide the ad-axnserver ingress routeexport 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 uniqueexport 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.shsource pulseaxn_env.shStep 4: Install Pulseaxn agent
Run the installation command from the same directory as hystaller:
./hystaller install -i pulseaxnStep 5: Validation
Check Pulseaxn service status
systemctl status pulseaxnExpected 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/pulseaxnDec 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 pulseaxnWas this page helpful?