Upgrade a distributed AMI or OVA installation of Splunk UBA
Before upgrading Splunk UBA in a distributed deployment, be sure you have verified the Upgrade Splunk UBA prerequisites. Make sure that the prerequisites are verified on each server in the distributed deployment.
Distributed environment upgrade steps
Follow the procedure in this section to upgrade Splunk UBA in a distributed environment.
- Download the new version of Splunk UBA from Splunkbase to your management server. The file name is
splunk-uba-software-upgrade-package_500.tgz
. See Splunk UBA Software Update on Splunkbase. - Copy the Splunk UBA package to the
/home/caspida
directory of each server in the deployment. - Log in to each server in your deployment as the caspida user, and extract the downloaded file.
tar -xvf /home/caspida/splunk-uba-software-upgrade-package_500.tgz
The following files are extracted to the
splunk-uba-software-update_50
directory:
Splunk-UBA-Platform-5.0.0-20191015-000100.tgz
Splunk-UBA-Platform-5.0.0-20191015-000100.tgz.md5sum
uba-ext-pkgs-5.0.0.tgz
uba-ext-pkgs-5.0.0.tgz.md5sum
Move all of these files to the
/home/caspida
directory:mv splunk-uba-software-update_50/* /home/caspida
- Log in to the Splunk UBA management server as the caspida user using SSH.
- Stop Splunk UBA with the following command:
/opt/caspida/bin/Caspida stop
- If you are using the Splunk UBA Kafka Ingestion App, download and upgrade to version 1.2 of the Splunk UBA Kafka Ingestion App. During the upgrade, select the Upgrade app. Checking this will overwrite the app if it already exists. checkbox to upgrade the app without restarting Splunk Enterprise. See Install the Splunk UBA Kafka Ingestion App in the Splunk UBA Kafka Ingestion App manual.
- On each server in the deployment, perform the following steps to archive the previous version of Splunk UBA:
sudo mkdir -p /var/vcap/release_archives sudo mv /opt/caspida /var/vcap/release_archives/caspida-4.3.x sudo mkdir -p /opt/caspida && sudo chown caspida:caspida /opt/caspida sudo chown caspida:caspida /var/vcap/release_archives sudo chown caspida:caspida /var/vcap/release_archives/caspida-4.3.x
- On each server in the deployment, run the following command to extract the Splunk UBA platform package in the
/opt/caspida
directory.tar -C /opt/caspida -xvf /home/caspida/Splunk-UBA-Platform-5.0.0-20191015-000100.tgz
- On the Splunk UBA management server, run the upgrade script to upgrade Splunk UBA to the new version and migrate your configurations.
nohup /opt/caspida/upgrade/utils/upgrade_4.3_to_5.0.sh -p /var/vcap/release_archives/caspida-4.3.x -e /home/caspida/uba-ext-pkgs-5.0.0.tgz &
- After the upgrade script finishes running, use the following command and look for the "Upgrade completed & started Caspida" confirmation message:
tail -f /var/log/caspida/upgrade.out
Next steps
Upgrade a single node RHEL, CentOS, or Oracle Linux installation of Splunk UBA | Upgrade a distributed RHEL, CentOS, or Oracle Linux installation of Splunk UBA |
This documentation applies to the following versions of Splunk® User Behavior Analytics: 5.0.0
Feedback submitted, thanks!