Acceldata
 Pulse
Search documentation… ⌘K

Last updated: Sep 27, 2026 11:49 UTC

Upgrade to Version 3.8.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

Migration Steps from Version 3.7.x to 3.8.0

Follow these steps to upgrade Pulse.

  • Take a backup of the accelo file and download the latest version for accelo.linux CLI.
  • Move and make the latestaccelo CLI file as an executable. Also, check the updated Pulse information for the following:
mv accelo.linux accelo
chmod +x ./accelo
  • Push the updated configuration to database.
    • Run the following command:
accelo admin database push-config
  • Follow the manual steps in the document below to update MongoDB to the latest version, 8.0.8.

Note

For information about migrating MongoDB manually, see Upgrade MongoDB Manually.

  • Update Configuration:
    • Update ImageTag in the $AcceloHome/config/accelo.yml file to 3.8.0.
  • For the Online installations, run the following command and press 'Y' at the prompt to get the most recent binaries.
accelo login docker
accelo pull all
  • For the Offline Installations download all the latest image packs and run the following command to upload the latest images
docker load -i
  • Run the below command to update and add new keys in vars.yml 
accelo reconfig cluster
  • [Optional: If AD-LDAP is deployed] Run the following command to generate an encrypted password for the LDAP server connection.
accelo admin encrypt
  • Enter the plain-text password to generate the encrypted password.
  • Update the bindPW field in /data01/acceldata/config/ldap/ldap.conf with the encrypted value add the encryptedPassword = true flag in the same configuration file.
  • Run the below command to push acceldata.conf and other updated files to MongoDB.
accelo admin database push-config

Info

Once the above command is executed, move the license from local work directory to a backup directory.

Important

Ensure that you do not change the value of v from 3.7.0 to anything else unless explicitly advised by Acceldata. The following command needs to run on all the Pulse nodes including standalone nodes i.e. nodes where PULSE_SA_NODE is true. The examples of such nodes include, but aren’t limited to Logsearch, FS Analytics V2, and Dashplot.

  • Run the migration command. For example:
    • -v 3.8.0 : The version you are migrating to.
    • -i 3.7.0 : The version you are migrating from.
    • To migrate from the version 3.7.0 to 3.8.0, the migration command looks as shown below.

Info

Ensure that you run the following command from $AcceloHome.

For a single cluster:

accelo migrate -v 3.8.0 -i 3.7.0 -b

For multi-cluster:

accelo migrate -v 3.8.0 -i 3.7.0 -a -b
  • Run the same command again, If any issue occurs during migration on any step.
  • Restart all the containers so that they use the updated images
accelo restart all -d
  • Uninstall the Hydra Agent.
accelo uninstall remote
  • Install the Hydra Agent.
accelo deploy hydra
  • Reconfigure the cluster to get the updated configuration for Agents.
accelo reconfig cluster -a

Info

If your ODP cluster has Kafka 3 installed, you need to run accelo config cluster before performing this step.

  • To push the updated configuration to database, execute the following command.
accelo admin database push-config -a
  • To configure when gauntlet snap must run the MongoDB cleanup and compaction, run the following command.
accelo config retention
  • Finally execute the following command to create indices for database collections.
If readOnlyRootFSEnabled is set to true in $AcceloHome/config/accelo.yml, then follow the steps listed below instead of running the command directly.

1. Open $AcceloHome/config/accelo.yml and set the value of readOnlyRootFSEnabled to false.
2. Run accelo admin database push-config 
3. Run accelo restart all -d.
4. Run accelo admin database index-db.
5. Open $AcceloHome/config/accelo.yml and set the value of readOnlyRootFSEnabled to true.
6. Run accelo admin database push-config.
7. Run accelo restart all -d.

accelo admin database index-db
  • If the older playbooks already present in the node where ad-director is deployed, delete them, and download the latest playbooks tar from the License UI.
    • Delete the older playbooks using the command: rm -rf $AcceloHome/work/<cluster_name>/director/playbook/*.Replace <cluster_name> with name of the cluster where the playbooks are present.
    • Download the playbooks tar from the License UI. For details, see Deploy Playbooks.

Migration Steps from Version 3.6.x to 3.8.0

Follow these steps to upgrade Pulse.

  • Take a backup of the accelo file and download the latest version for accelo.linux CLI.
  • Move and make the latestaccelo CLI file as an executable. Also, check the updated Pulse information for the following:
mv accelo.linux accelo
chmod +x ./accelo
  • Run the following command to push the updated configuration to the database**.**
accelo admin database push-config
  • Follow the manual steps in the document below to update MongoDB to the latest version, 8.0.8.

Note

For information about migrating MongoDB manually, see Upgrade MongoDB Manually.

  • Update Configuration:
    • Update ImageTag in the $AcceloHome/config/accelo.yml file to 3.8.0.
  • For the Online installations, run the following command and press 'Y' at the prompt to get the most recent binaries.
accelo login docker
accelo pull all
  • For the Offline Installations download all the latest image packs and run the following command to upload the latest images
docker load -i
  • Run the below command to update and add new keys in vars.yml 
accelo reconfig cluster
  • [Optional: If AD-LDAP is deployed] Run the following command to generate an encrypted password for the LDAP server connection.
accelo admin encrypt
  • Enter the plain-text password to generate the encrypted password.
  • Update the bindPW field in /data01/acceldata/config/ldap/ldap.conf with the encrypted value add the encryptedPassword = true flag in the same configuration file.
  • Run the below command to push acceldata.conf and other updated files to MongoDB.
accelo admin database push-config

Info

Once the above command is executed, move the license from local work directory to a backup directory.

Important

Ensure that you do not change the value of v from 3.7.0 to anything else unless explicitly advised by Acceldata. The following command needs to run on all the Pulse nodes including standalone nodes i.e. nodes where PULSE_SA_NODE is true. The examples of such nodes include, but aren’t limited to Logsearch, FS Analytics V2, and Dashplot.

  • Run the migration command. For example:
    • -v 3.8.0 : The version you are migrating to.
    • -i 3.6.6 : The version you are migrating from.
    • To migrate from the version 3.6.6 to 3.8.0, the migration command looks as shown below.

Info

Ensure that you run the following command from $AcceloHome.

For a single cluster:

accelo migrate -v 3.8.0 -i 3.6.6 -b

For multi-cluster:

accelo migrate -v 3.8.0 -i 3.6.6 -a -b
  • Run the same command again, If any issue occurs during migration on any step.
  • Restart all the containers so that they use the updated images
accelo restart all -d
  • Uninstall the Hydra Agent.
accelo uninstall remote
  • Install the Hydra Agent.
accelo deploy hydra
  • Reconfigure the cluster to get the updated configuration for Agents.
accelo reconfig cluster -a

Info

If your ODP cluster has Kafka 3 installed, you need to run accelo config cluster before performing this step.

  • To push the updated configuration to database, execute the following command.
accelo admin database push-config -a
  • To configure when gauntlet snap must run the MongoDB cleanup and compaction, run the following command.
accelo config retention
  • Finally execute the following command to create indices for database collections.
If readOnlyRootFSEnabled is set to true in $AcceloHome/config/accelo.yml, then follow the steps listed below instead of running the command directly.

1. Open $AcceloHome/config/accelo.yml and set the value of readOnlyRootFSEnabled to false.
2. Run accelo admin database push-config 
3. Run accelo restart all -d.
4. Run accelo admin database index-db.
5. Open $AcceloHome/config/accelo.yml and set the value of readOnlyRootFSEnabled to true.
6. Run accelo admin database push-config.
7. Run accelo restart all -d.

accelo admin database index-db
  • If the older playbooks already present in the node where ad-director is deployed, delete them, and download the latest playbooks tar from the License UI.
    • Delete the older playbooks using the command: rm -rf $AcceloHome/work/<cluster_name>/director/playbook/*.Replace <cluster_name> with name of the cluster where the playbooks are present.
    • Download the playbooks tar from the License UI. For details, see Deploy Playbooks.