Upgrade to Version 3.8.4

Prerequisite

Upgrade the Docker version to 20.10.x or above.

Steps to upgrade the Docker version:

  1. Uninstall the current Docker:
Bash
Copy
  1. Install the latest version of Docker:
Bash
Copy
  • To install a specific version of Docker:
Bash
Copy
  • Replace 24.0.5 with the appropriate version string
  • To list specific versions of docker
Bash
Copy
  1. Start Docker:
Bash
Copy

Migration Steps from Version 3.8.0 to 3.8.4

Follow these steps to upgrade Pulse.

  1. Update Configuration:

    • Update ImageTag in the $AcceloHome/config/accelo.yml file to 3.8.4.

  2. Push Updated Configuration to Database:

    • Run the following command:
Bash
Copy
  1. Take a backup of the accelo file and download the latest version for accelo.linux CLI.
  2. Move and make the latest accelo CLI file as an executable. Also, check the updated Pulse information for the following.
Bash
Copy
  1. For the Online installations, run the following command and press 'Y' at the prompt to get the most recent binaries.
Bash
Copy
  1. For the Offline Installations, download all the latest image packs and run the following command to upload the latest images.
Bash
Copy
  1. Run the command below to update and add new keys in vars.yml.
Bash
Copy
  1. [Optional: If AD-LDAP is deployed] Run the following command to generate an encrypted password for the LDAP server connection.
Bash
Copy
  • 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 and add the encryptedPassword = true flag in the same configuration file.
  1. Run the below command to push acceldata.conf and other updated files to MongoDB.
Bash
Copy
  1. Restart all containers, including database(s,) with the following command.
Bash
Copy
  1. Uninstall the Hydra Agent.
Bash
Copy
  1. Install the Hydra Agent.
Bash
Copy
  1. (Optional for Spark Standalone Deployment) If you are upgrading from Pulse 3.8.0 and the Spark master URL is blocked, add the list of Spark worker URLs to the $AcceloHome/config/acceldata_<clustername>.conf file in the following format:
Bash
Copy

For example:

Bash
Copy

Add the above field in group.configuration in the $AcceloHome/config/acceldata_<clustername>.conf file. The group.configuration section should be in the following format:

Bash
Copy

If the Spark master URL is accessible and you want to use it to retrieve the list of worker URLs, add SYNC_SPARK_MASTER="true" to the /etc/profile.d/ad.sh file and run source /etc/profile.d/ad.sh to apply the changes.
  1. Reconfigure the cluster to get the updated configurations for Agents.
Bash
Copy

Migration Steps from Version 3.7.x to 3.8.4

Follow these steps to upgrade Pulse.

  1. Take a backup of the accelo file and download the latest version for accelo.linux CLI.
  2. Move and make the latestaccelo CLI file as an executable. Also, check the updated Pulse information for the following:
Bash
Copy
  1. For the Offline Installations, download all the latest image packs and run the following command to upload the latest images.
Bash
Copy
  1. Push the updated configuration to the database.
    • Run the following command:
Bash
Copy
  1. Follow the manual steps in the document below to update MongoDB to the latest version, 8.0.8.

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

  1. Update Configuration:

    • Update ImageTag in the $AcceloHome/config/accelo.yml file to 3.8.4.

  2. For the Online installations, run the following command and press 'Y' at the prompt to get the most recent binaries.

Bash
Copy
  1. Run the command below to update and add new keys in vars.yml
Bash
Copy

If your ODP cluster has Kafka 3 installed, run accelo config cluster before performing this step.
  1. [Optional: If AD-LDAP is deployed] Run the following command to generate an encrypted password for the LDAP server connection.
Bash
Copy
  • 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 and add the encryptedPassword = true flag in the same configuration file.
  1. Run the below command to push acceldata.conf and other updated files to MongoDB.
Bash
Copy

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

Ensure that you do not change the value of v from 3.8.0 to anything else unless explicitly advised by Acceldata. The following command needs to be 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.
  1. Run the migration command. For example:
    1. -v 3.8.0 : The version you are migrating to. Note Keep the version as -v 3.8.0, even when you are migrating to any update release version in 3.8.x.
    2. -i 3.7.0 : The version you are migrating from.
    3. To migrate from version 3.7.0 to 3.8.4, the migration command looks as shown below.

Ensure that you run the following command from $AcceloHome.

For a single cluster:

Bash
Copy

For multi-cluster:

Bash
Copy
  1. Run the same command again if any issue occurs during migration on any step.
  2. Restart all the containers so that they use the updated images
Bash
Copy
  1. Uninstall the Hydra Agent.
Bash
Copy
  1. Install the Hydra Agent.
Bash
Copy
  1. (Optional for Spark Standalone Deployment) If you are upgrading from Pulse 3.8.0 and the Spark master URL is blocked, add the list of Spark worker URLs to the $AcceloHome/config/acceldata_<clustername>.conf file in the following format.
Bash
Copy

For example:

Bash
Copy

Add the above field in group.configuration in the $AcceloHome/config/acceldata_<clustername>.conf file. The group.configuration section should be in the following format:

Bash
Copy

If the Spark master URL is accessible and you want to use it to retrieve the list of worker URLs, add SYNC_SPARK_MASTER="true" to the /etc/profile.d/ad.sh file and run source /etc/profile.d/ad.sh to apply the changes.
  1. Reconfigure the cluster to get the updated configuration for Agents.
Bash
Copy
  1. To push the updated configuration to the database, execute the following command.
Bash
Copy
  1. To configure when gauntlet snap must run the MongoDB cleanup and compaction, run the following command.
Bash
Copy
  1. Finally, execute the following command to create indices for database collections.
Bash
Copy
Bash
Copy
  1. If the older playbooks are already present in the node where Ad-Director is deployed, delete them, and download the latest playbooks tar from the License UI.
    1. Delete the older playbooks using the command: rm -rf $AcceloHome/work/<cluster_name>/director/playbook/*.Replace <cluster_name> with the name of the cluster where the playbooks are present.
    2. Download the playbooks tar from the License UI. For details, see Deploy Playbooks.

Migration Steps from Version 3.6.x to 3.8.4

Follow these steps to upgrade Pulse.

  1. Take a backup of the accelo file and download the latest version for accelo.linux CLI.
  2. Move and make the latestaccelo CLI file as an executable. Also, check the updated Pulse information for the following:
Bash
Copy
  1. For the Offline Installations, download all the latest image packs and run the following command to upload the latest images.
Bash
Copy
  1. Run the following command to push the updated configuration to the database.
Bash
Copy
  1. Follow the manual steps in the document below to update MongoDB to the latest version, 8.0.8.

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

  1. Update Configuration:

    • Update ImageTag in the $AcceloHome/config/accelo.yml file to 3.8.4.

  2. For the Online installations, run the following command and press 'Y' at the prompt to get the most recent binaries.

Bash
Copy
  1. Run the command below to update and add new keys in vars.yml
Bash
Copy

If your ODP cluster has Kafka 3 installed, you need to run accelo config cluster before performing this step.
  1. [Optional: If AD-LDAP is deployed] Run the following command to generate an encrypted password for the LDAP server connection.
Bash
Copy
  • 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 and add the encryptedPassword = true flag in the same configuration file.
  1. Run the below command to push acceldata.conf and other updated files to MongoDB.
Bash
Copy

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

Ensure that you do not change the value of v from 3.8.0 to anything else unless explicitly advised by Acceldata. The following command needs to be 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.
  1. Run the migration command. For example:
    1. -v 3.8.0 : The version you are migrating to. Note Keep the version as -v 3.8.0, even when you are migrating to any update release version in 3.8.x.
    2. -i 3.6.6 : The version you are migrating from.
    3. To migrate from version 3.6.6 to 3.8.4, the migration command looks as shown below.

Ensure that you run the following command from $AcceloHome.

For a single cluster:

Bash
Copy

For multi-cluster:

Bash
Copy
  1. Run the same command again if any issue occurs during migration on any step.
  2. Restart all the containers so that they use the updated images
Bash
Copy
  1. Uninstall the Hydra Agent.
Bash
Copy
  1. Install the Hydra Agent.
Bash
Copy
  1. (Optional for Spark Standalone Deployment) If you are upgrading from Pulse 3.8.0 and the Spark master URL is blocked, add the list of Spark worker URLs to the $AcceloHome/config/acceldata_<clustername>.conf file in the following format.
Bash
Copy

For example:

Bash
Copy

Add the above field in group.configuration in the $AcceloHome/config/acceldata_<clustername>.conf file. The group.configuration section should be in the following format:

Bash
Copy

If the Spark master URL is accessible and you want to use it to retrieve the list of worker URLs, add SYNC_SPARK_MASTER="true" to the /etc/profile.d/ad.sh file and run source /etc/profile.d/ad.sh to apply the changes.
  1. Reconfigure the cluster to get the updated configuration for Agents.
Bash
Copy
  1. To push the updated configuration to the database, execute the following command.
Bash
Copy
  1. To push the updated configuration to the database, execute the following command.
Bash
Copy
  1. Finally, execute the following command to create indices for database collections.
Bash
Copy
Bash
Copy
  1. If the older playbooks are already present in the node where ad-director is deployed, delete them, and download the latest playbooks tar from the License UI.
    1. Delete the older playbooks using the command: rm -rf $AcceloHome/work/<cluster_name>/director/playbook/*.Replace <cluster_name> with the name of the cluster where the playbooks are present.
    2. Download the playbooks tar from the License UI. For details, see Deploy Playbooks.
Type to search, ESC to discard
Type to search, ESC to discard
Type to search, ESC to discard
Next to read:
Upgrade to Version 3.8.3

For additional help, contact www.acceldata.force.com OR call our service desk +1 844 9433282

Copyright © 2026

On This Page
Upgrade to Version 3.8.4PrerequisiteMigration Steps from Version 3.8.0 to 3.8.4Migration Steps from Version 3.7.x to 3.8.4Migration Steps from Version 3.6.x to 3.8.4