Acceldata
 Pulse
Search documentation… ⌘K

Last updated: Sep 27, 2026 19:52 UTC

Upgrade to Version 3.4.0

Prerequisite

Upgrade the Docker version to 20.10.x or above.

Steps to upgrade the Docker version:

  • Uninstall the current Docker:
yum remove -y docker-ce docker-ce-cli containerd.io
  • Install the latest version of Docker:
yum install -y docker-ce docker-ce-cli containerd.io
  • To install a specific version of Docker:
yum install -y docker-ce-24.0.5 docker-ce-cli-24.0.5 containerd.io
  • Replace 24.0.5 with the appropriate version string
  • To list specific versions of docker
yum list docker-ce --showduplicates | sort -r
  • Start Docker:
systemctl start docker

Execute the migration steps according to your current version to upgrade to version 3.4.0 as outlined in the following sections:

  • Migration Steps from Version 3.3.X to 3.4.0
  • Migration Steps from Version 3.0.X to 3.4.0
  • Migration Steps from Version 3.2.X to 3.4.0
  • Migration Steps from Version 3.3.2X to 3.4.0

Migration Steps from Version 3.3.X to 3.4.0

Pulse Upgrade Steps (Core Services Server / Addon Services Server)

  • Update Configuration:
  • Update the ImageTag in the $AcceloHome/config/accelo.yml file to 3.4.0.
  • Push Updated Configuration to Database:
  • Run the following command:
accelo admin database push-config
  • Download Necessary Images:
  • Ensure you have downloaded or loaded all the necessary Docker images for version 3.4.0.
  • Update Accelo Binary:
  • Download the new Accelo binary.
  • Replace the older Accelo binary with the new one.
  • Run Migration Command:

Important

  • Make sure you run the command from $AcceloHome.
  • Do not change the value of -v from 3.4.0 unless explicitly advised by Engineering. The following command needs to run on all Pulse nodes including standalone nodes i.e. nodes where PULSE_SA_NODE is true. Examples of such nodes include but aren’t limited to Logsearch, FS Analytics V2, Dashplot .
  • To migrate from 3.3.8 to 3.4.0, run:
accelo migrate -v 3.4.0 -i 3.3.8 -b
  • For Multi-Cluster:
accelo migrate -v 3.4.0 -i 3.3.8 -a -b
  • Handle Migration Issues:
  • If any issues occur during migration, rerun the same command.
  • Restart Containers:
  • Restart all containers to use the updated images:
accelo restart all -d
  • Uninstall Hydra Agent:
  • Run the following command:
accelo uninstall remote
  • Install Hydra Agent:
  • Run the following command:
accelo deploy hydra
  • Reconfigure Cluster:
  • To get the updated configuration for agents, run:
accelo reconfig cluster -a
  • Push Updated Configuration to Database:
  • Run the following command:
accelo admin database push-config -a
  • Configure MongoDB Cleanup & Compaction:
  • To configure when Gauntlet Snap will run MongoDB cleanup and compaction, run:
accelo config retention
  • Create Indices for Database Collections:
  • Finally, run the following command:
accelo admin database index-db

Migration Steps from Version 3.0.X to 3.4.0

Cluster Specific Changes

The following components are introduced in version 3.4.0 and are not present in version 3.0.X:

  • ad-events
  • ad-gauntlet

To accommodate the ad-events component, you need to make certain changes related to hooks on the cluster side. For configuring Hive/Tez hooks, refer to the document, [Configure HDP for Pulse Deployment](Configure HDP for Pulse Deployment).

Pulse Upgrade Steps (Core Services Server / Addon Services Server)

  • Update Configuration:
  • Update the ImageTag in the $AcceloHome/config/accelo.yml file to 3.4.0.
  • Push Updated Configuration to Database:
  • Run the following command:
accelo admin database push-config
  • Download Necessary Images:
    • Ensure you have downloaded or loaded all the necessary Docker images for version 3.4.0, including:
191579300362.dkr.ecr.us-east-1.amazonaws.com/acceldata/ad-database:migrate-4.4.20
191579300362.dkr.ecr.us-east-1.amazonaws.com/acceldata/ad-database:migrate-5.0.16
  • Update Accelo Binary:
    • Download the new Accelo binary.
    • Replace the older Accelo binary with the new one.
  • Run Migration Command:
  • To migrate from 3.0.16 to 3.4.0, run:
accelo migrate -v 3.4.0 -i 3.0.16 -b
  • For Multi-Cluster:
accelo migrate -v 3.4.0 -i 3.0.16 -a -b

Do not change the value of -v from 3.4.0 unless explicitly advised by Engineering.

  • Handle Migration Issues:
  • If any issues occur during migration, rerun the same command.
  • Generate Notifications Configuration:
  • Skip this step on nodes that don't have Core services running on them.
  • After migration completes successfully, generate notifications.yml by running:
accelo config actions notifications
  • Deploy Core Containers:
    • Skip this step on nodes that don't have Core services running on them.
    • Deploy all core containers by running:
accelo deploy core
  • If you see the following error, just answer y and proceed:
ERROR: Looks like core setup is missing the services '[ad-events ad-gauntlet]' from the stack 'default'.
  • Restart Containers:
    • Restart all containers to use the updated images:
accelo restart all -d
  • Uninstall Hydra Agent:
  • Run the following command:
accelo uninstall remote
  • Install Hydra Agent:
    • Run the following command:
accelo deploy hydra
  • Reconfigure Cluster:
    • To get the updated configuration for agents, run:
accelo reconfig cluster -a
  • Push Updated Configuration to Database:
    • Run the following command:
accelo admin database push-config -a
  • Configure MongoDB Cleanup & Compaction:
    • To configure when Gauntlet Snap will run MongoDB cleanup and compaction, run:
accelo config retention
  • Create Indices for Database Collections:
    • Finally, run the following command:
accelo admin database index-db

Migration Steps from Version 3.2.X to 3.4.0

Pulse Upgrade Steps (Core Services Server / Addon Services Server)

  • Update Configuration:
  • Update the ImageTag in the $AcceloHome/config/accelo.yml file to 3.4.0.
  • Push Updated Configuration to Database:
  • Run the following command:
accelo admin database push-config
  • Download Necessary Images:
  • Ensure you have downloaded or loaded all the necessary Docker images for version 3.4.0, including:
191579300362.dkr.ecr.us-east-1.amazonaws.com/acceldata/ad-database:migrate-4.4.20
191579300362.dkr.ecr.us-east-1.amazonaws.com/acceldata/ad-database:migrate-5.0.16
  • Update Accelo Binary:
  • Download the new Accelo binary.
  • Replace the older Accelo binary with the new one.
  • Run Migration Command:
  • To migrate from 3.2.14 to 3.4.0, run:
accelo migrate -v 3.4.0 -i 3.2.14 -b
  • For Multi-Cluster: 
accelo migrate -v 3.4.0 -i 3.2.14 -a -b
  • Handle Migration Issues:
  • If any issues occur during migration, rerun the same command.
  • Restart Containers:
  • Restart all containers to use the updated images:
accelo restart all -d
  • Uninstall Hydra Agent:
  • Run the following command:
accelo uninstall remote
  • Install Hydra Agent:
  • Run the following command:
accelo deploy hydra
  • Reconfigure Cluster:
  • To get the updated configuration for agents, run:
accelo reconfig cluster -a
  • Push Updated Configuration to Database:
  • Run the following command:
accelo admin database push-config -a
  • Configure MongoDB Cleanup & Compaction:
  • To configure when Gauntlet Snap will run MongoDB cleanup and compaction, run:
accelo config retention
  • Create Indices for Database Collections:
  • Finally, run the following command:
accelo admin database index-db

Migration Steps from Version 3.3.2X to 3.4.0

Pulse Upgrade Steps (Core Services Server / Addon Services Server)

  • Update Configuration:
  • Update the ImageTag in the $AcceloHome/config/accelo.yml file to 3.4.0.
  • Push Updated Configuration to Database:
  • Run the following command:
accelo admin database push-config
  • Download Necessary Images:
  • Ensure you have downloaded or loaded all the necessary Docker images for version 3.4.0.
  • Update Accelo Binary:
  • Download the new Accelo binary.
  • Replace the older Accelo binary with the new one.
  • Run Migration Command:

Important

  • Make sure you run the command from $AcceloHome.
  • Do not change the value of -v from 3.4.0 unless explicitly advised by Engineering. The following command needs to run on all Pulse nodes including standalone nodes i.e. nodes where PULSE_SA_NODE is true. Examples of such nodes include but aren’t limited to Logsearch, FS Analytics V2, Dashplot .
  • To migrate from 3.3.20 to 3.4.0, run:
accelo migrate -v 3.4.0 -i 3.3.20 -b
  • For Multi-Cluster: 
accelo migrate -v 3.4.0 -i 3.3.20 -a -b
  • Handle Migration Issues:
  • If any issues occur during migration, rerun the same command.
  • Restart Containers:
  • Restart all containers to use the updated images:
accelo restart all -d
  • Uninstall Hydra Agent:
  • Run the following command:
accelo uninstall remote
  • Install Hydra Agent:
  • Run the following command:
accelo deploy hydra
  • Reconfigure Cluster:
  • To get the updated configuration for agents, run:
accelo reconfig cluster -a
  • Push Updated Configuration to Database:
  • Run the following command:
accelo admin database push-config -a
  • Configure MongoDB Cleanup & Compaction:
  • To configure when Gauntlet Snap will run MongoDB cleanup and compaction, run:
accelo config retention
  • Create Indices for Database Collections:
  • Finally, run the following command:
accelo admin database index-db