Upgrade to Version 3.7.1

If you are upgrading Pulse from the version 3.5.0 or lower, make sure to export all the custom dashboards from the Pulse UI. For details, see Exporting Dashboards.

Prerequisite

Upgrade the Docker version to 20.10.x or above.

Steps to upgrade the Docker version:

Uninstall the current Docker:

Bash
    
xxxxxxxxxx
 
yum remove -y docker-ce docker-ce-cli containerd.io
Copy

Install the latest version of Docker:

Bash
    
xxxxxxxxxx
 
yum install -y docker-ce docker-ce-cli containerd.io
Copy

To install a specific version of Docker:

Bash
    
xxxxxxxxxx
 
yum install -y docker-ce-24.0.5 docker-ce-cli-24.0.5 containerd.io
Copy

Replace 24.0.5 with the appropriate version string
To list specific versions of docker

Bash
    
xxxxxxxxxx
 
yum list docker-ce --showduplicates | sort -r
Copy

Start Docker:

Bash
    
xxxxxxxxxx
 
systemctl start docker
Copy

Migration Steps from Version 3.7.0 to 3.7.1

Follow these steps to upgrade Pulse.

Update Configuration:
- Update ImageTag in the $AcceloHome/config/accelo.yml file to 3.7.1.
Push Updated Configuration to Database:
- Run the following command:

Bash
    
xxxxxxxxxx
 
accelo admin database push-config -a
Copy

Take a backup of the accelo file and download the latest version for accelo.linux CLI.
Move and make the latest accelo CLI file as an executable. Also, check the updated Pulse information for the following.

Bash
    
xxxxxxxxxx
 
mv accelo.linux accelochmod +x ./accelo
Copy

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

Bash
    
xxxxxxxxxx
 
accelo login dockeraccelo pull all
Copy

For the Offline Installations, download all the latest image packs and run the following command to upload the latest images.

Bash
    
xxxxxxxxxx
 
docker load -i
Copy

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

Bash
    
xxxxxxxxxx
 
accelo reconfig cluster
Copy

[Optional: If AD-LDAP is deployed] Run the following command to generate an encrypted password for the LDAP server connection.

Bash
    
xxxxxxxxxx
 
accelo admin encrypt
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.

Run the below command to push acceldata.conf and other updated files to MongoDB.

Bash
    
xxxxxxxxxx
 
accelo admin database push-config
Copy

Restart all containers including database(s) with the following command.

Bash
    
xxxxxxxxxx
 
accelo restart all -d
Copy

Uninstall the Hydra Agent.

Bash
    
xxxxxxxxxx
 
accelo uninstall remote
Copy

Install the Hydra Agent.

Bash
    
xxxxxxxxxx
 
accelo deploy hydra
Copy

Reconfigure the cluster to get the updated configurations for Agents.

Bash
    
xxxxxxxxxx
 
accelo reconfig cluster -a
Copy

Migration Steps from Version 3.6.x to 3.7.1

Follow these steps to upgrade Pulse.

Update Configuration:
- Update ImageTag in the $AcceloHome/config/accelo.yml file to 3.7.1.
Push Updated Configuration to Database:
- Run the following command:

Bash
    
xxxxxxxxxx
 
accelo admin database push-config
Copy

Ensure that you have downloaded and loaded all the necessary Docker images for 3.7.1.
Download a new accelo binary and replace the existing one with the new accelo binary.

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:
1. -v 3.7.0 : The version you are migrating to.
2. -i 3.6.2 : The version you are migrating from.
3. To migrate from version 3.6.2 to 3.7.1, the migration command looks as shown below.

Ensure that you run the following command from $AcceloHome.

For a single cluster:

Bash
    
xxxxxxxxxx
 
accelo migrate -v 3.7.0 -i 3.6.2 -b
Copy

For multi-cluster:

Bash
    
xxxxxxxxxx
 
accelo migrate -v 3.7.0 -i 3.6.2 -a -b
Copy

Run the same command again, If any issue occurs during migration on any step.
If YARN optimizer is deployed, append the feature flag "enableStaticQueue": true to the ad-graphql section in the ad-core.yml file.

Bash
    
xxxxxxxxxx
 
vi $AcceloHome/config/docker/ad-core.yml
Copy

After adding the mentioned feature flag, the FEATURE_FLAG environment must look as below. If you have additional FEATURE_FLAG entries, do not need to remove them, just append "enableStaticQueue": true at the end . For example:

Bash
    
 
'FEATURE_FLAGS={ "ui_regex": { "regex": "ip-([^.]+)", "index": 1 }, "rename_nav_labels":{}, "timezone": "", "experimental": true, "themes": false, "hive_const":{ "HIVE_QUERY_COST_ENABLED": false, "HIVE_MEMORY_GBHOUR_COST": 0, "HIVE_VCORE_HOUR_COST": 0 }, "spark_const": { "SPARK_QUERY_COST_ENABLED": false, "SPARK_MEMORY_GBHOUR_COST": 0, "SPARK_VCORE_HOUR_COST": 0 }, "queryRecommendations": false, "hostIsTrialORLocalhost": false, "data_temp_string": "", "enableStaticQueue" : true }'
Copy

Restart all the containers so that they use the updated images.

Bash
    
xxxxxxxxxx
 
accelo restart all -d
Copy

Uninstall the Hydra Agent.

Bash
    
xxxxxxxxxx
 
accelo uninstall remote
Copy

Install the Hydra Agent.

Bash
    
xxxxxxxxxx
 
accelo deploy hydra
Copy

If Logsearch is deployed in standalone mode, verify whether the yarn app es_urls parameter is present in the override.yml file. If it exists, update the port number from 19013 to 19051.

Bash
    
xxxxxxxxxx
 
yarn_app_es_urls: <http://<LOG_SEARCH_HOSTNAME>>:19051
Copy

Reconfigure the cluster to get the updated configuration for Agents.

Bash
    
xxxxxxxxxx
 
accelo reconfig cluster -a
Copy

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

[Optional: If AD-LDAP is deployed] Run the following command to generate an encrypted password for the LDAP server connection.

Bash
    
xxxxxxxxxx
 
accelo admin encrypt
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.

To push the updated configuration to database, execute the following command.

Bash
    
xxxxxxxxxx
 
accelo admin database push-config -a
Copy

To configure when gauntlet snap must run the MongoDB cleanup and compaction, run the following command.

Bash
    
xxxxxxxxxx
 
accelo config retention
Copy

Finally execute the following command to create indices for database collections.

Bash
    
​x
 
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.
Copy

Bash
    
xxxxxxxxxx
 
accelo admin database index-db
Copy

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.
1. 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.
2. Download the playbooks tar from the License UI. For details, see Deploy Playbooks.

Migration Steps from Version 3.5.x to 3.7.1

Follow these steps to upgrade Pulse.

Update Configuration:
- Update ImageTag in the $AcceloHome/config/accelo.yml file to 3.7.1.
Push Updated Configuration to Database:
- Run the following command:

Bash
    
xxxxxxxxxx
 
accelo admin database push-config
Copy

Ensure that you have downloaded and loaded all the necessary docker images for 3.7.1.
Download a new accelo binary and replace the existing one with the new accelo binary.

Run the migration command. For example:
1. -v 3.7.0 : The version you are migrating to.
2. -i 3.5.2 : The version you are migrating from.
3. To migrate from version 3.5.2 to 3.7.1, the migration command looks as shown below.

Ensure that you run the following command from $AcceloHome.

For a single cluster:

Bash
    
xxxxxxxxxx
 
accelo migrate -v 3.7.0 -i 3.5.2 -b
Copy

For multi-cluster:

Bash
    
xxxxxxxxxx
 
accelo migrate -v 3.7.0 -i 3.5.2 -a -b
Copy

Run the same command again, If any issue occurs during migration on any step.
Delete the following directories, if they are present.

This step is applicable only if you are upgrading Pulse from 3.5.0.

Bash
    
xxxxxxxxxx
 
rm -rf $AcceloHome/data/pg/*rm -rf $AcceloHome/data/pg-ui/*
Copy

Delete the metric groups from the alerts collection in MongoDB. Log into Mongo db and run the following commands. Note For details about logging into MongoDB, reach out to Acceldata Support.

Bash
    
xxxxxxxxxx
 
use alertsdb.metric_groups.deleteMany({})db.metrics.deleteMany({})
Copy

If YARN optimizer is deployed, append the feature flag "enableStaticQueue": true to the ad-graphql section in the ad-core.yml file.

After adding the mentioned feature flag, the FEATURE_FLAG environment must look like this. If you have additional FEATURE_FLAG entries, do not need to remove them, just append "enableStaticQueue": true at the end . For example:

Bash
    
xxxxxxxxxx
 
vi $AcceloHome/config/docker/ad-core.yml
Copy

Bash
    
 
'FEATURE_FLAGS={ "ui_regex": { "regex": "ip-([^.]+)", "index": 1 }, "rename_nav_labels":{}, "timezone": "", "experimental": true, "themes": false, "hive_const":{ "HIVE_QUERY_COST_ENABLED": false, "HIVE_MEMORY_GBHOUR_COST": 0, "HIVE_VCORE_HOUR_COST": 0 }, "spark_const": { "SPARK_QUERY_COST_ENABLED": false, "SPARK_MEMORY_GBHOUR_COST": 0, "SPARK_VCORE_HOUR_COST": 0 }, "queryRecommendations": false, "hostIsTrialORLocalhost": false, "data_temp_string": "", "enableStaticQueue" : true }'
Copy

Restart all the containers so that they use the updated images.

Bash
    
xxxxxxxxxx
 
accelo restart all -d
Copy

Uninstall the Hydra Agent.

Bash
    
xxxxxxxxxx
 
accelo uninstall remote
Copy

Install the Hydra Agent.

Bash
    
xxxxxxxxxx
 
accelo deploy hydra
Copy

If Logsearch is deployed in standalone mode, verify whether the yarn app es_urls parameter is present in the override.yml file. If it exists, update the port number from 19013 to 19051.

Bash
    
xxxxxxxxxx
 
yarn_app_es_urls: <http://<LOG_SEARCH_HOSTNAME>>:19051
Copy

Reconfigure the cluster to get the updated configuration for Agents.

Bash
    
xxxxxxxxxx
 
accelo reconfig cluster -a
Copy

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

[Optional: If AD-LDAP is deployed] Run the following command to generate an encrypted password for the LDAP server connection.

Bash
    
xxxxxxxxxx
 
accelo admin encrypt
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.

To push the updated configuration to database, execute the following command.

Bash
    
xxxxxxxxxx
 
accelo admin database push-config -a
Copy

To configure when gauntlet snap must run the MongoDB cleanup and compaction, run the following command.

Bash
    
xxxxxxxxxx
 
accelo config retention
Copy

Finally execute the following command to create indices for database collections.

Bash
    
 
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.
Copy

Bash
    
xxxxxxxxxx
 
accelo admin database index-db
Copy

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.
1. 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.
2. Download the playbooks tar from the License UI. For details, see Deploy Playbooks.

You can import the previously exported custom dashboards. For details, see Importing Dashboards.

Last updated on

Was this page helpful?