Upgrade a single unprivileged Splunk Phantom instance
Follow these steps to upgrade your unprivileged Splunk Phantom instance.
If your Splunk Phantom deployment is not a cluster, and uses an external PostgresSQL database and/or an external GlusterFS file share you will need to upgrade the external services before upgrading Splunk Phantom itself.
- Make sure you have read Splunk Phantom upgrade overview and prerequisites.
- Update the operating system and installed packages. See Prepare your Splunk Phantom deployment for upgrade.
- Log in to the Splunk Phantom instance's operating system as the user account that runs Splunk Phantom. On an unprivileged virtual machine image or AMI-based deployment, this user account is "phantom."
- If you use a warm standby or use ibackup.pyc for backups, you must disable those features before proceeding. If you are not using either of those features, you may skip these sub-steps.
- Disable warm standby. See Upgrade or maintain warm standby instances in Administer Splunk Phantom.
- If you are using automation to run ibackup.pyc to make backups, cancel backups that could run during your upgrade window. For example, if you have configured a cron job to run ibackup.pyc, disable that cron job.
- Disable WAL archiving for the PostgreSQL database. Set the
archive_mode
to "off" in the file<PHANTOM_HOME>/data/db/postgresql.phantom.conf
.sed -i -e 's/archive_mode = on/archive_mode = off/i' /<PHANTOM_HOME>/data/db/postgresql.phantom.conf
- Restart PostgreSQL to make the configuration change take effect. If you are upgrading a system that is running PostgreSQL version 9.4: If you are upgrading a system that is running PostgreSQL version 11:
/<PHANTOM_HOME>/bin/phsvc restart postgresql-9.4
/<PHANTOM_HOME>/bin/phsvc restart postgresql-11
- If your Splunk Phantom instance uses an external PostgreSQL database, Upgrade PostgreSQL for Splunk Phantom deployments with external databases.
- If your Splunk Phantom deployment uses an external GlusterFS-based file share, upgrade GlusterFS. See Upgrade GlusterFS for Splunk Phantom deployments with GlusterFS fileshares.
- Run the upgrade script. To upgrade without apps:
/<PHANTOM_HOME>/bin/phenv /<PHANTOM_HOME>/phantom_tar_install.sh upgrade
/<PHANTOM_HOME>/bin/phenv /<PHANTOM_HOME>/phantom_tar_install.sh upgrade --without-apps
- If the upgrade script produced the following message: Then run the command:
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
/<PHANTOM_HOME>/bin/phenv /<PHANTOM_HOME>/usr/postgresql/bin/vacuumdb -h /tmp --all --analyze-in-stages
- After the upgrade is complete, from Main Menu > Administration > Administration Settings > Search Settings, select Playbooks from the drop-down menu, then click the Reindex Search Data button.
Upgrade a single Splunk Phantom instance on a system with limited internet access | Upgrade a Splunk Phantom cluster |
This documentation applies to the following versions of Splunk® Phantom (Legacy): 4.9
Feedback submitted, thanks!