Upgrade a single node OEL installation of Splunk UBA
Perform the following steps to upgrade a single node OEL installation of Splunk UBA.
OEL Leapp regularly updates its base operating system to the latest version of OEL 8.x. If you are a Splunk UBA customer using OEL, refrain from upgrading OEL until you verify the OEL version Leapp will upgrade your environment to is supported by the target UBA version. For information on the latest OEL version, see https://docs.oracle.com/en/operating-systems/oracle-linux/8 /.
Before you begin
Before upgrading Splunk UBA on a single server, confirm you meet the Upgrade Splunk UBA prerequisites
If you have enabled the integration that sends UBA audit data to Splunk Enterprise Security (ES), preserve the associated certificate before upgrading. For more info on sending audit data to ES see, Send Splunk UBA audit events to Splunk ES. Use the following command to export the certificate:
. /opt/caspida/bin/CaspidaCommonEnv.sh sudo keytool -exportcert -alias "splunk es" -keystore $JAVA_HOME/lib/security/cacerts -rfc -file ~/splunk-es_cacert.pem
Perform UBA upgrade
Ensure that Splunk UBA is running before you upgrade, then perform the following tasks to upgrade Splunk UBA on a single server.
- Obtain the Splunk UBA Software Update and download the file to the home/caspida directory. Select version 5.1.0.1 from the drop-down list. The downloadable archive file is named
splunk-uba-software-upgrade-package_5101.tgz
. - Extract the archive with the following command:
The following files are extracted:
tar xfz /home/caspida/splunk-uba-software-upgrade-package_5101.tgz -C /home/caspida
splunk-uba-software-update-000009-5101.tgz
splunk-uba-software-update-000009-5101.tgz.md5sum
- Extract the software update package in the /home/caspida directory:
tar xfz /home/caspida/splunk-uba-software-update-000009-5101.tgz -C /home/caspida
- Run the following command:
sed -i 's|\\$? -ne 0|\\$? -e 100|g' /home/caspida/patch_uba_5101/bin/utils/patch_uba.sh
- Apply the patch with the following command:
The command installs the new Splunk UBA software, restarts Splunk UBA, and then restarts the data sources.
/home/caspida/patch_uba_5101/bin/utils/patch_uba.sh -p /home/caspida/patch_uba_5101
Re-import the certificate used for sending UBA audit events to Splunk ES
If you have enabled the integration that sends UBA audit data to Splunk Enterprise Security (ES), and you preserved the associated certificate in the Before you begin step, you can now re-import that certificate. Use the following command to re-import the certificate:
. /opt/caspida/bin/CaspidaCommonEnv.sh sudo keytool -import -alias "splunk es" -keystore $JAVA_HOME/lib/security/cacerts -file ~/splunk-es_cacert.pem
Next steps
Upgrade a single node RHEL installation of Splunk UBA | Upgrade a distributed AMI or OVA installation of Splunk UBA |
This documentation applies to the following versions of Splunk® User Behavior Analytics: 5.1.0.1
Feedback submitted, thanks!