Upgrade a single node AMI or OVA installation of Splunk UBA

Before upgrading Splunk UBA on a single server, be sure you have verified the Upgrade Splunk UBA prerequisites.

Single server upgrade steps

Perform the following tasks to upgrade Splunk UBA on a single server.

1. Download the new version of Splunk UBA from Splunkbase. The file name is splunk-uba-software-upgrade-package_500.tgz. See Splunk UBA Software Update on Splunkbase.
2. Copy the Splunk UBA package to /home/caspida directory.
3. Log in to the Splunk UBA server as the caspida user using SSH.
4. 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

5. Stop Splunk UBA with the following command:

   /opt/caspida/bin/Caspida stop

6. 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.
7. Run the following commands 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
   

8. 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
   

9. 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 &
   

10. 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

Verify a successful upgrade of Splunk UBA.