Upgrade to Version 3.5.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.4.x to 3.5.0

Follow these steps to upgrade Pulse.

• Update Configuration:
  • Update ImageTag in the $AcceloHome/config/accelo.yml file to 3.5.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.5.0.
• Update Accelo Binary:
  • Download the new Accelo binary.
  • Replace the older Accelo binary with the new one.
• Run Migration Command:

• -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

• 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

• 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

• 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

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

---

Migration Steps from Version 3.3.x to 3.5.0

Follow these steps to upgrade Pulse.

• Update Configuration:

• Update ImageTag in the $AcceloHome/config/accelo.yml file to 3.5.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.5.0.
• Update Accelo Binary:
  • Download the new Accelo binary.
  • Replace the older Accelo binary with the new one.
• Run Migration Command:

• -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 command below 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

• 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 the Hydra Agent:

accelo uninstall remote

• Install the Hydra agent:

accelo deploy hydra

• Restart Containers:
  • Restart all containers to use the updated images:

accelo restart all -d

• 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

• 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

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