Upgrade Prisma Cloud
You can upgrade Prisma Cloud without losing any of your data or configurations.
Upgrade Console first.
After upgrading Console, upgrade your Defenders, and other Prisma Cloud components.
Before upgrading, check the
Breaking changes
section in the release notes to see if there are any special instructions or requirements.You can upgrade from an immediate previous major version only.
If your installation is more than one major release behind, you must upgrade in steps.
For example, you cannot directly upgrade from version 19.11 to 20.09.
You must upgrade from version 19.11 to 20.04, and then from 20.04 to 20.09.
Console notifies you when new versions of Prisma Cloud are available.
Notifications are displayed in the top right corner of the dashboard.
When you upgrade Console, the old Console container is completely replaced with a new container.
Because Prisma Cloud stores state information outside of the container, all your rules and settings are immediately available to the upgraded Prisma Cloud containers.
Prisma Cloud state information is stored in a database in the location specified by DATA_FOLDER, which is defined in twistlock.cfg.
By default, the database is located in /var/lib/twistlock.
Overview of the upgrade process
First upgrade Console.
Next, upgrade your Defenders.
Finally, upgrade all other Prisma Cloud components, such as the Jenkins plugin.
The upgrade process is vastly simplified when automatic Defender upgrades is enabled (it’s enabled by default).
The steps in the upgrade process are:
- Upgrade Console.
- Upgrade all deployed Defenders.
- If Defender auto-upgrade is enabled — Console will upgrade deployed Defenders for you. If Console fails to upgrade one or more Defenders, it displays a banner at the top of the UI. If you’ve created an alert for Defender health events, Console emits a message on the alert channel for any Defender it fails to upgrade. Manually upgrade any Defenders that Console could not auto-upgrade.
- If Defender auto-upgrade is disabled — Manually upgrade all deployed Defenders.
- Validate that all deployed Defenders have been upgraded.
- Review deployed Defenders and DaemonSets underManage > Defenders > Manage.
- Filter the theStatuscolumn byUpgrade.
- If any Defenders have theUpgradestatus, manually upgrade them.
- Manually upgrade all other Prisma Cloud Compute components, such as the Jenkins plugin, so that their versions exactly match Console’s version.
Version numbers of installed components
The currently installed version of Console is displayed in the bell menu.
The versions of your deployed Defenders are listed under
Manage > Defenders > Manage
:
Prisma Cloud Compute components
The versions of all deployed components should match exactly.
To support the multi-step upgrade process, older versions of Prisma Cloud components can continue to interoperate with newer versions of Console in a limited way.
Plan to upgrade all Prisma Cloud components as soon as possible.
After you upgrade Console, upgrade the following components:
- Defenders. Console can automatically upgrade most Defender types for you. App-embedded Defenders and PCF Defenders (also known as Twistlock for Pivotal Platform) must be manually upgraded.
- Jenkins plugin.
- twistcli.
- If you’re using projects, supervisor Consoles must match the Central Console version.
Version mismatches
Console interoperates with older components on a best-effort basis.
When older components interact with Console, Console displays some indicators in the dashboard:
- InMonitor > Events, any audits generated by older Defenders are marked with an out-of-date indicator. Links to the rules that triggered the audit are disabled (explanation follows).
- InMonitor > VulnerabilitiesandMonitor > Compliance, any scan reports generated by older components (Defender registry scanners, Jenkins plugins, twistcli) are marked with an out-of-date indicator.
Although older Defenders can interoperate with newer Consoles, their operation is restricted.
Older Defenders fully protect your nodes using the policies and settings most recently cached before upgrading Console.
They can emit audits to Console and local logs, including syslog.
However, they cannot access any API endpoint other than the upgrade endpoint, and they cannot share any new data with Console.
No new policies or settings can be pushed from Console to older Defenders.
When Defender is in this state, its status is shown as 'Upgrade needed' in
Manage > Defenders > Manage
.
To restore older Defenders to a fully operation state, upgrade them so that their versions match Console’s version.Upgrading Console when using projects
When you have one or more tenant or scale Projects, upgrade all Supervisors before upgrading the Central Console. During the upgrade process, there may be periods where the Supervisors appear as disconnected. This is normal, because the Supervisors are disconnected while the upgrade is occuring and Central Console will recheck connectivity every 10 minutes. Within 10 minutes of upgrading all Supervisors and the Central Console, all Supervisors should appear healthy.
Upgrade each Supervisor and then the Central Console using the appropriate procedure:
Defender auto-upgrade support
Most Defender types can be auto-upgraded.
A handful must still be manaully upgraded.
The following table summarizes the Defender types, and which ones can be auto-upgraded.
Defender type | Auto-upgrade |
|---|---|
Container Defender, which includes:
| Y |
Serverless Defender | Y* (see Serverless Defender auto-protect) |
App embedded Defender | N |
PCF Defender | N |
Host Defender | Y |
Enabling Defender auto-upgrade
By default, Defender auto-upgrade is enabled.
You can check and change the setting in Console.
- Open Prisma Cloud Compute Console.
- Go toManage > Defenders > Manage.
- Click onAdvanced Settings.
- SetAutomatically upgrade DefenderstoOnorOff.
