About the Upgrade Readiness App
The Upgrade Readiness App version 4.0.x is the latest version of the Upgrade Readiness App, which replaced the Splunk Platform Upgrade Readiness App. Use the Upgrade Readiness App to prepare your Splunk platform deployment for upgrade to Python 3 and jQuery 3.5. You can also use the Upgrade Readiness App 4.0.0 to scan for Splunk platform compatibility. The Splunk platform compatibility scan helps you determine if your deployment is prepared for upgrade to Splunk Enterprise 9.0.
This version of the app is present by default in Splunk Cloud Platform 8.2.2203 and higher, and Splunk Enterprise 9.0 and higher. You can download and install the Upgrade Readiness App 4.0.0 on Splunk Enterprise versions 8.0 and higher, or Splunk Cloud Platform versions 8.2.2201 and higher.
The app's scan results describe the remediation actions you must take to ensure that your public and private apps work as expected after you upgrade to Splunk Enterprise 9.0, or to a new version of Python on the Splunk platform, as well as actions you must take to remove dependency on vulnerable versions of jQuery. For example, scan results show if any apps and customizations rely on Python 2 so that you can update them.
In Splunk Enterprise 9.0, Python 2 is no longer an option for Splunk Enterprise. You must use Python 3 only. Splunk Cloud Platform continues to default to Python 2.
On Splunk Cloud Platform only, the Upgrade Readiness App provides these additional features:
- Scan search heads and indexers and view a combined report from both types of instances.
- Request an upgrade of the default Python version from Python 2 to Python 3.
For more information on the Splunk Enterprise Python 3 release, see Python 3 migration with the Splunk platform.
For more information on jQuery 3.5 support in Splunk software, see Overview of the jQuery 3.5 upgrade.
The Upgrade Readiness App is a tool that assists you with your transition to Python 3 and jQuery 3.5, and upgrading your deployment to Splunk Enterprise 9.0. Even if your deployment passes all checks, you must still independently test your private and customized apps and add-ons for incompatibilities.
What the Upgrade Readiness App scans for in the app default folders
The Upgrade Readiness App checks app default folders for the following issues:
- Python 3 incompatible code in custom Mako templates.
- Python scripts that might fail in Python 3.
- Uses out of date Python SDKs.
- Lower versions of jQuery prior to jQuery 3.5.
- Templates and dashboards with versions lower than 1.1.
- Uses of HTML files that rely on lower versions of jQuery.
Splunk platform compatibility
- Imports of Python libraries that are making outbound TLS connections.
- Disabled TLS configurations for search peers in a clustered instance.
- Disabled TLS configurations for MongoDB and indexers.
In clustered environments, the app performs these checks on search heads and indexers and provides a merged report with remediation steps.
For more information about these checks and what to do with the results, see Scan a Splunk platform instance with the Upgrade Readiness App.
Python version switch on Splunk Cloud Platform
On the Splunk Cloud Platform version of the app, the Python Version tab is enabled by default for the sc_admin role. This lets Splunk Cloud Platform admins see the current default Python version of the cluster and, if the default version is Python 2, request an upgrade to Python 3. All upgrade requests that users make are listed on this page.
When you request an upgrade from Python 2 to Python 3, the application sends a request to Splunk Support to upgrade the default version of Python across the entire cluster.
To get started, see Install the Upgrade Readiness App.
For instructions on how to use the app, see Scan a Splunk platform instance with the Upgrade Readiness App.
For information about features, fixed issues, and known issues in this app, see Release notes.
Which apps the Upgrade Readiness App scans
The Upgrade Readiness App scans all apps and add-ons in the $SPLUNK_HOME/etc/apps and $SPLUNK_HOME/etc/peer-apps directories, with some exceptions. The app scans private apps that you have created for your own organization, as well as public apps installed from Splunkbase, including third-party apps and Splunk supported apps.
The Upgrade Readiness App excludes the following apps from the scan:
- Search & Reporting
- Splunk Enterprise Security
Install the Upgrade Readiness App
This documentation applies to the following versions of Splunk® Enterprise: 9.0.0, 9.0.1, 9.0.2