Acceldata
 Pulse
Search documentation… ⌘K

Upgrade to Version 3.5.0

Prerequisite

Upgrade the Docker version to 20.10.x or above.

Steps to upgrade the Docker version:

  1. Uninstall the current Docker:
yum remove -y docker-ce docker-ce-cli containerd.io
  1. 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
  1. Start Docker:
systemctl start docker

Migration Steps from Version 3.4.x to 3.5.0

Follow these steps to upgrade Pulse.

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

Important

  • Make sure you run the command from $AcceloHome.
  • Do not change the value of -v from 3.5.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 .
  • -v: This indicates the version you are migrating to.
  • -i : This indicates the version you are migrating from. For example, to migrate from 3.4.1 to 3.5.0, make sure to run the below command from $AcceloHome.
accelo migrate -v 3.5.0 -i 3.4.1 -b
  • For Multi-Cluster:
accelo migrate -v 3.5.0 -i 3.4.1 -a -b
  1. Handle Migration Issues:
    • If any issues occur during migration, rerun the same command.
  2. Restart Containers:
    • Restart all containers to use the updated images:
accelo restart all -d
  1. Uninstall Hydra Agent:
    • Run the following command:
accelo uninstall remote
  1. Install Hydra Agent:
    • Run the following command:
accelo deploy hydra
  1. If Logsearch is deployed in standalone mode:
    • Check if yarn_app_es_urls is present in override.yml
    • If the above is present, change the port number from 19013 to 19051.
yarn_app_es_urls: <http://<LOG_SEARCH_HOSTNAME>>:19051
  1. Reconfigure Cluster:
    • To get the updated configuration for agents, run:
accelo reconfig cluster -a
  1. Push Updated Configuration to Database:
    • Run the following command:
accelo admin database push-config -a
  1. Configure MongoDB Cleanup & Compaction:
    • To configure when Gauntlet Snap will run MongoDB cleanup and compaction, run:
accelo config retention
  1. Create Indices for Database Collections:
    • Finally, run the following command.

Important

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.

  1. Run accelo admin database push-config
  2. Run accelo restart all -d.
  3. Run accelo admin database index-db.
  4. Open $AcceloHome/config/accelo.yml and set the value of readOnlyRootFSEnabled to true.
  5. Run accelo admin database push-config.
  6. Run accelo restart all -d.
accelo admin database index-db
  1. If the old 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 old 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.

Migration Steps from Version 3.3.x to 3.5.0

Follow these steps to upgrade Pulse.

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

Important

  • Make sure you run the command from $AcceloHome.
  • Do not change the value of -v from 3.5.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, and Dashplot.
  • -v: This indicates the version you are migrating to.
  • -i : This indicates the version you are migrating from. For example, to migrate from 3.3.8 to 3.5.0, make sure to run the below command from $AcceloHome.
accelo migrate -v 3.5.0 -i 3.3.8 -b
  • For Multi-Cluster:
accelo migrate -v 3.5.0 -i 3.3.8 -a -b
  1. Handle Migration Issues:
    • If any issues occur during migration, rerun the same command.
  2. Restart Containers:
    • Restart all containers to use the updated images:
accelo restart all -d
  1. Uninstall the Hydra Agent:
accelo uninstall remote
  1. Install the Hydra agent:
accelo deploy hydra
  1. Restart Containers:
    • Restart all containers to use the updated images:
accelo restart all -d
  1. If Logsearch is deployed in standalone mode:
    • Check if yarn_app_es_urls is present in override.yml
    • If the above is present, change the port number from 19013 to 19051.
yarn_app_es_urls: <http://<LOG_SEARCH_HOSTNAME>>:19051
  1. Reconfigure Cluster:
    • To get the updated configuration for agents, run:
accelo reconfig cluster -a
  1. Push Updated Configuration to Database:
    • Run the following command:
accelo admin database push-config -a
  1. Configure MongoDB Cleanup & Compaction:
    • To configure when Gauntlet Snap will run MongoDB cleanup and compaction, run:
accelo config retention
  1. Create Indices for Database Collections:
    • Finally, run the following command.

Important

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.

  1. Run accelo admin database push-config
  2. Run accelo restart all -d.
  3. Run accelo admin database index-db.
  4. Open $AcceloHome/config/accelo.yml and set the value of readOnlyRootFSEnabled to true.
  5. Run accelo admin database push-config.
  6. Run accelo restart all -d.
accelo admin database index-db
  1. If the old 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 old 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.