Upgrade an unprivileged Splunk Phantom Cluster

Perform the following tasks to upgrade your unprivileged Splunk Phantom cluster.

1. Read Splunk Phantom upgrade overview and prerequisites.
2. Prepare each node for upgrade:
   1. On each cluster node, update the operating system and installed packages: See Prepare your Splunk Phantom deployment for upgrade.
   2. On each cluster node, install the Splunk Phantom source repositories and signing keys. See Splunk Phantom repositories and signing keys packages.
3. Upgrade the PostgreSQL database. See Upgrade PostgreSQL for Splunk Phantom deployments with external databases.
4. Upgrade the GlusterFS-based file share. See Upgrade GlusterFS for Splunk Phantom deployments with GlusterFS fileshares.
5. On each node, one at a time, Upgrade individual cluster nodes.
6. If the upgrade script produced the following message:

   To improve database performance, after completing the upgrade, run: /<PHANTOM_HOME>/bin/phenv /<PHANTOM_HOME>/usr/postgresql/bin/vacuumdb -h /tmp --all --analyze-in-stages

   Then run the command:

   /<PHANTOM_HOME>/bin/phenv /<PHANTOM_HOME>/usr/postgresql/bin/vacuumdb -h /tmp --all --analyze-in-stages

7. Once all cluster nodes have been upgraded, reindex playbook data. From Main Menu > Administration > Administration Settings > Search Settings, select Playbooks from the drop-down menu, then click the Reindex Search Data button.

Upgrade individual cluster nodes

Do not attempt to upgrade all the nodes at the same time. Upgrade a single node and bring it back online before proceeding to the next cluster node.

When you have upgraded N+1 nodes, where N is equal to half of the number of nodes in you cluster, database migrations will be applied. This can take a significant amount of time, depending on the amount of data in your database and the version of Splunk Phantom from which you're upgrading.

Do these steps as the user that owns the PHANTOM_HOME directory.

1. Log in to the operating system as the user who owns the PHANTOM_HOME directory.
2. Run the upgrade script.

   /<PHANTOM_HOME>/bin/phenv /<PHANTOM_HOME>/phantom_tar_install.sh upgrade

   If you don't want to upgrade your installed apps during the upgrade, you can use the --without-apps option.

   /<PHANTOM_HOME>/bin/phenv /<PHANTOM_HOME>/phantom_tar_install.sh upgrade --without-apps