sk92449 - Check Point Upgrade Service Engine (CPUSE) - Gaia Deployment Agent
Check Point Upgrade Service Engine (CPUSE) - Gaia Deployment Agent
Product: Multi-Domain Security Management, Security Gateways, Security Management
Version: R80.40 (EOS), R81 (EOS), R81.10 (EOS), R81.20, R82, R82.10
OS: Gaia
Last Modified: 2026-07-19
Solution
Table of Contents:
- Introduction
- Download the CPUSE Agent build, What's New, and Installation instructions
- Documentation
- Troubleshooting
- Related Solutions
- Revision history
In addition, refer to sk111158 - Central Deployment Tool (CDT).
(1) Introduction
Check Point Upgrade Service Engine (CPUSE), also known as Deployment Agent [DA], is an advanced and intuitive mechanism for software deployment on Gaia OS, which supports deployments of single HotFixes (HF), of HotFix Accumulators (Jumbo), and of Major Versions.
Gaia Software Updates offers a Smart, Fast and Safe deployment solution:
| Smart | - Discover only the applicable software updates - Reboot only if required - Auto authentication with Download Center - View hierarchy of software updates - E-mail notification for new updates |
| Fast | - Fast download - Fast installation - Short downtime |
| Safe | - Upgrade to the next Major Version is performed on a new disk partition and preserves Gaia OS configuration - Automatic conflicts validation - Checksum validation of packages on the target server - Self-test after installation - Auto roll-back on failures |
(2) Download the Deployment Agent build, What's New, and Installation instructions
| Build Number |
Release Date |
Status | Download Link |
What's New |
| 2771 | 07 June 2026 | Recommended version |
For R82.10 version: (TGZ) |
- Enhancement: Improved the user experience for background upgrades of Security Management Servers. - Enhancement: Maestro Hyperscale Orchestrator (MHO) now receives software updates and hotfixes without requiring an active entitled license. - Enhancement: Improved installation logging and error handling for faster analysis and solutions. |
| For 3900 series appliances: (TGZ) |
||||
| For versions R80.40/R81/R81.10/R81.20/R82: (TGZ) |
||||
| 2806 | 19 Jul 2026 | Gradual deployment | TBD | - Added fixes for a seamless upgrade (on both the Management server and the Security Gateway). - Fixes stability issues. |
| 2337 | 09 Oct 2023 | For versions R80.30 and lower (not supported on Scalable Platforms) |
(TGZ) |
Important Notes:
- To upgrade a Scalable Platform from R81.10 or R81.20 to R82, you must install the CPUSE Deployment Agent build 2550 or higher from this SK article.
- To upgrade a Scalable Platform from R80.20SP, R80.30SP, R81, or R81.10 to "R81.20 for Scalable Platforms", you must install the dedicated CPUSE Deployment Agent from sk177624 - R81.20 for Scalable Platforms.
- To upgrade a Scalable Platform from R80.20SP, R80.30SP, or R81 to "R81.10 for Scalable Platforms", you must install the dedicated CPUSE Deployment Agent from sk173363 - R81.10 for Scalable Platforms.
- See CPUSE Requirements.
- The latest CPUSE Deployment Agent build is usually gradually released to all customers. Therefore, not all Gaia servers receive the latest build at the same time.
- Check Point always recommends to upgrade the CPUSE Deployment Agent to the latest available build in this SK article.
- It is not supported to install a lower build of the CPUSE Deployment Agent over the current build (downgrading the CPUSE Deployment Agent is not supported).
Installation instructions for the CPUSE Deployment Agent
(2-A) Check the current build of the CPUSE Deployment Agent
Follow one of these procedures:
- Instructions for the New Interface (Build 2337 and higher):
- Navigate to the Software Updates section - click the Available Updates page.
- Click the button Update Settings.
- The build of the installed Deployment Agent appears in the Deployment Agent section.
- Instructions for the Legacy Interface (Build 2297 and lower):
- Navigate to the Upgrades (CPUSE) section - click the Status and Actions page.
- The build of the installed Deployment Agent appears at the top. Example:
- Instructions for the Expert mode
Connect to the command line on the Gaia server.
Log in.
If your default shell is Gaia Clish, then go to the Expert mode:
expert
Run one of these commands:
On a Security Gateway / Management Server:
clish -c "show installer status build"
On a Scalable Platform:
gclish -c "show installer status build"
Example output:
Build number: 2297(2-B) Manually install the CPUSE Deployment Agent package
Follow one of these procedures:
- Instructions for the New Interface (Build 2337 and higher):
Connect to Gaia Portal and obtain the lock over the configuration database (click the lock icon at the top - near ' Sign Out').
Navigate to the Software Updates section - click the Available Updates page.
Click the button Update Settings.
In the section Deployment Agent, click Update Deployment Agent.
Click Browse for a file.
Select the CPUSE Deployment Agent TGZ package on your computer.
Click Install DA. Example:
Follow the instructions on the screen.
(3) Documentation
| Action | Page in the CPUSE Administration Guide |
| See CPUSE Requirements | CPUSE Requirements |
| Update the CPUSE Deployment Agent | Updating the CPUSE Deployment Agent |
| See all installed CPUSE packages | Viewing Installed CPUSE Software Packages |
| Download a CPUSE package | Installing a CPUSE Software Package on Gaia |
| Import a CPUSE package | Installing a CPUSE Software Package on Gaia |
| Verify a CPUSE package | Installing a CPUSE Software Package on Gaia |
| Install a CPUSE package | Installing a CPUSE Software Package on Gaia |
| Export a CPUSE package | Exporting a CPUSE Software Package from Gaia |
| Uninstall a CPUSE package | Uninstalling a CPUSE Software Package from Gaia |
| Delete a CPUSE package | Deleting a CPUSE Software Package from Gaia |
| Configure CPUSE settings | CPUSE Update Settings |
| View CPUSE logs | CPUSE Event Log |
| Run CPUSE CLI commands | CPUSE Syntax in Gaia Clish / Gaia gClish |
| Change the CPUSE GUI version | Changing the CPUSE GUI |
(4) Troubleshooting
| # | Instructions |
| 1 | To collect debug, run (no need to restart the Deployment Agent):da_cli edit_configuration operation=add_config PING_DEBUG=1 - to activate debugda_cli edit_configuration operation=add_config PING_DEBUG=0 - to deactivate debug (default) |
| 2 | To collect all the relevant logs, run the command:da_cli collect_logsIt creates a TGZ file in the current working directory, including all required files to analyze the issue. |
| 3 | By default, if the Deployment Agent identifies a newer version in Download Center and if the self-update option is disabled, then the Deployment Agent blocks the operations until the latest version is installed. To bypass this, run:da_cli edit_configuration operation=add_config ENFORCE_NEW_DA=1 - to enable the block (default)da_cli edit_configuration operation=add_config ENFORCE_NEW_DA=0 - to disable the block |
| 4 | Symptom: "clish", "DAClient", and "da_cli" commands seem to have no effect. Solution: If MDPS is enabled on the Security Gateway, make sure that the shell runs in the management plane. When MDPS is enabled on the Security Gateway, CPUSE service runs in the management plane, any command line interaction with CPUSE should be executed in the same plane (clish, DAClient, and da_cli). |
| 5 | Symptom: Not enough free disk space on /var/log due to old packages. Solution: Use " da_cli delete package=<name>"Important note: Delete a package only if you are 100% sure you will not revert to a previous snapshot of this version. |
(5) Related Solutions
(6) Revision History
| Date | Description |
| 07 Jun 2026 | "Latest build of CPUSE and What's New" section - added new recommended Build 2771 |
| 24 Nov 2025 | "Latest build of CPUSE and What's New" section - added new recommended Build 2672 |
| 29 Jul 2025 | "Latest build of CPUSE and What's New" section - added new recommended Build 2606 |
| 16 Jun 2025 | "Latest build of CPUSE and What's New" section - added new recommended Build 2589 |
| 16 Feb 2025 | "Latest build of CPUSE and What's New" section - added new recommended Build 2550 |
| 22 Dec 2024 | "Latest build of CPUSE and What's New" section - added new recommended Build 2512 |
| 29 Oct 2024 | "Latest build of CPUSE and What's New" section - added new recommended Build 2492 |
| 27 Oct 2024 | Updated "Important Notes" in section "(2) Download" |
| 13 Oct 2024 | "Latest build of CPUSE and What's New" section - added new recommended Build 2474 |
| 07 Aug 2024 | Moved all instructions for working with CPUSE packages to the CPUSE Administration Guide Removed instructions for outdated CPUSE Deployment Agent builds Improved formatting of the article |
| 22 July 2024 | "Latest build of CPUSE and What's New" section - added new recommended Build 2443 |
| 14 July 2024 | "Latest build of CPUSE and What's New" section - added new recommended Build 2432 |
| 05 Jun 2024 | "Latest build of CPUSE and What's New" section - added new recommended Build 2429 |
| 31 Mar 2024 | Section "(4-C) How to work with CPUSE - How to uninstall a CPUSE package" - improved steps in Gaia Portal |
| 06 Feb 2024 | "Latest build of CPUSE and What's New" section - added new recommended Build 2379 |
| 09 Oct 2023 | "Latest build of CPUSE and What's New" section - added new recommended Build 2337 |
| 30 Jul 2023 | "Latest build of CPUSE and What's New" section - added new recommended Build 2325 |
| 30 Apr 2023 | Improved formatting |
| 26 Apr 2023 | Improved formatting |
| 16 Apr 2023 | "Latest build of CPUSE and What's New" section - added new Recommended Build 2297 |
| 23 Jan 2023 | "Latest build of CPUSE and What's New" section - added new Recommended Build 2282 |
| 18 Dec 2022 | "Latest build of CPUSE and What's New" section - added new Recommended Build 2267 |
| 02 Oct 2022 | "Latest build of CPUSE and What's New" section - added new Recommended Build 2243 |
| 29 Aug 2022 | "Latest build of CPUSE and What's New" section - added new Recommended Build 2229 |
| 27 July 2022 | "Latest build of CPUSE and What's New" section - added new Recommended Build 2208 |
| 10 July 2022 | "Latest build of CPUSE and What's New" section - added new Recommended Build 2205 |
| 24 May 2022 | "Latest build of CPUSE and What's New" section - added new Recommended Build 2193 |
| 04 May 2022 | - Improved formatting - "(4-D) "How to ..." section - restored the sub-section "How to download SmartConsole package from Gaia Portal" |
| 21 Mar 2022 | "Latest build of CPUSE and What's New" section - added new Recommended Build 2176 |
| 30 Jan 2022 | "Latest build of CPUSE and What's New" section - added new Recommended Build 2154 |
| 14 Dec 2021 | "Latest build of CPUSE and What's New" section - added new Recommended Build 2140 |
| 14 Nov 2021 | "(6) Limitations, Troubleshooting and Related solutions" - added point #4 |
| 07 Oct 2021 | "Latest build of CPUSE and What's New" section - added new Recommended Build 2113 |
| 02 Sep 2021 | Updating screenshots and removed documentation for unsupported versions (77.10 and below) |
| 24 Aug 2021 | "Latest build of CPUSE and What's New" section - added new Recommended Build 2101 |
| 08 Jul 2021 | "Latest build of CPUSE and What's New" section - added new Recommended Build 2084 |
| 18 Apr 2021 | "(6) Limitations, Troubleshooting and Related solutions" - added a Troubleshooting scenario #3 |
| 11 Apr 2021 | "Latest build of CPUSE and What's New" section - added new Recommended Build 2047 |
| 07 Feb 2021 | "Latest build of CPUSE and What's New" section - added new Recommended Build 2019 |
| 14 Dec 2020 | "Latest build of CPUSE and What's New" section - added new GA Build 1999 |
| 25 Nov 2020 | "Latest build of CPUSE and What's New" section - added new GA Build 1986 |
| 28 Oct 2020 | "Latest build of CPUSE and What's New" section - added new GA Build 1976 |
| 23 Sep 2020 | "Latest build of CPUSE and What's New" section - added new GA Build 1959 |
| 10 Sep 2020 | "Latest build of CPUSE and What's New" section - added new GA Build 1935 |
| 20 Aug 2020 | "Latest build of CPUSE and What's New" section - added new GA Build 1931 |
| 19 Jul 2020 | "Latest build of CPUSE and What's New" section - added new GA Build 1928 |
| 30 Jun 2020 | Updated (6) Troubleshooting |
| 18 Jun 2020 | "Latest build of CPUSE and What's New" section - added new GA Build 1905 |
| 16 Apr 2020 | "Latest build of CPUSE and What's New" section - added new GA Build 1889 |
| 16 Feb 2020 | "Latest build of CPUSE and What's New" section - added new GA Build 1865 |
| 09 Feb 2020 | "Latest build of CPUSE and What's New" section - added new GA Build 1858 |
| 16 Jan 2020 | "Latest build of CPUSE and What's New" section - added new GA Build 1848 |
| 10 Dec 2019 | "Latest build of CPUSE and What's New" section - added new GA Build 1832 |
| 27 Nov 2019 | Added section (4-B-d) Perform a clean install or upgrade of a Blink image |
| 20 Nov 2019 | "Latest build of CPUSE and What's New" section - added new GA Build 1818 |
| 03 Oct 2019 | "Latest build of CPUSE and What's New" section - added new GA Build 1786 |
| 19 Aug 2019 | "Latest build of CPUSE and What's New" section - added new GA Build 1751 |
| 11 Aug 2019 | "Latest build of CPUSE and What's New" section - added new GA Build 1731 |
| 16 July 2019 | "Latest build of CPUSE and What's New" section - added new GA Build 1728 |
| 01 July 2019 | "Latest build of CPUSE and What's New" section - added new GA Build 1722 |
| 05 June 2019 | Added a note that CPUSE package is not compatible with R80.20SP |
| 14 May 2019 | "Latest build of CPUSE and What's New" section - added new GA Build 1677 |
| 01 May 2019 | "Latest build of CPUSE and What's New" section - added new GA Build 1676 |
| 31 Mar 2019 | Updated section 4C - "How to uninstall a CPUSE package" |
| 26 Mar 2019 | "Latest build of CPUSE and What's New" section - added new GA Build 1671 |
| 17 Mar 2019 | "Latest build of CPUSE and What's New" section - added new GA Build 1669 |
| 23 Jan 2019 | "Latest build of CPUSE and What's New" section - added new GA Build 1580 |
| 28 Nov 2018 | "Latest build of CPUSE and What's New" section - added new GA Build 1577 |
| 29 Sep 2018 | "Latest build of CPUSE and What's New" section - added new GA Build 1573 |
| 26 Sep 2018 | Added link to R80.20 Gaia Administration Guide |
| 15 July 2018 | Added R80.20 to Versions list |
| 25 June 2018 | "Latest build of CPUSE and What's New" section - added new GA Build 1511 |
| 24 June 2018 | "Latest build of CPUSE and What's New" section - added new GA Build 1510 |
| 14 June 2018 | "Latest build of CPUSE and What's New" section - added new GA Build 1508 |
| 06 May 2018 | "Latest build of CPUSE and What's New" section - added new GA Build 1483 |
| 08 Apr 2018 | Updated Section (2) System requirements and limitations, item G. |
| 12 Feb 2018 | "Latest build of CPUSE and What's New" section - added new GA Build 1439 |
| 02 Jan 2018 | "Latest build of CPUSE and What's New" section - added new GA Build 1418 |
| 26 Nov 2017 | "Latest build of CPUSE and What's New" section - added new GA Build 1405 |
| 10 Oct 2017 | Corrected the import instructions in Gaia Portal - correct the name of the button from "Upload" to "Import". |
| 08 Oct 2017 | Renamed the "Latest build of CPUSE and What's New" section to the "Download the latest build of CPUSE Agent and What's New". |
| 24 Sep 2017 | "Latest build of CPUSE and What's New" section - "(3-D) History of older CPUSE Agent builds" subsection - updated the text to show that build 1130 is integrated into R80 GA version. |
| 27 Aug 2017 | "Latest build of CPUSE and What's New" section - added new GA Build 1298. |
| 23 Aug 2017 | "Troubleshooting and Related solutions" section - added sk104479. |
| 17 Aug 2017 | "Troubleshooting and Related solutions" section - added sk119993. |
| 16 Aug 2017 | "Troubleshooting and Related solutions" section - added sk119954. |
| 24 July 2017 | "Latest build of CPUSE and What's New" section - added a note that restarting the ConfD daemon should be performed during a maintenance window. |
| 06 July 2017 | "System requirements and limitations" section - updated a note that on VSX R80.10, any package can be installed using CPUSE. |
| 27 June 2017 | "Latest build of CPUSE and What's New" section - added new GA Build 1294. |
| 21 June 2017 | - Updated the instructions for importing a package in Gaia Portal (by clicking on the Import Package button on the main page). - Added link to R80.10 Gaia Administration Guide. |
| 16 June 2017 | "Latest build of CPUSE and What's New" section - added new GA Build 1293. |
| 18 May 2017 | Added R80.10 version to the article. |
| 25 Apr 2017 | "Latest build of CPUSE and What's New" section - added new GA Build 1283. |
| 04 Apr 2017 | "Latest build of CPUSE and What's New" section - added new GA Build 1278. |
| 28 Mar 2017 | - Updated the title of this article from " CPUSE - Gaia Software Updates (including Gaia Software Updates Agent)" to " Check Point Upgrade Service Engine (CPUSE) - Gaia Deployment Agent". - "Latest build of CPUSE and What's New" section - added the Build 1272 back. |
| 20 Mar 2017 | "Latest build of CPUSE and What's New" section - temporarily reverted from Build 1272 to the previous Build 1130. |
| 15 Mar 2017 | Added the applicable screenshots for "Verifier" results. |
| 13 Mar 2017 | "Latest build of CPUSE and What's New" section - added new GA Build 1272. |
| 11 Feb 2017 | "Troubleshooting and Related solutions" section - added sk114592. |
| 05 Feb 2017 | "Troubleshooting and Related solutions" section - added sk115719. |
| 15 Jan 2017 | "Troubleshooting and Related solutions" section - added sk115515. |
| 31 Dec 2016 | - "(4-A) "How to ..." section - improved import instructions for Offline procedure in Gaia Portal. - "Troubleshooting and Related solutions" section - added sk111158, sk115243. |
| 19 Nov 2016 | - "(4-A) "How to ..." section - improved notes about VSX mode. - "(4-B) "How to ..." section - improved notes about VSX mode. - "(4-B) "How to ..." section - "(4-B-b)" subsection - added a list of files that are copied by CPUSE during an upgrade to a Major Version. |
| 14 Nov 2016 | "(4-D) "How to ..." section - improved notes. |
| 03 Nov 2016 | "System requirements and limitations" section - added clarifications about the required license and contract. |
| 02 Oct 2016 | "Latest build of CPUSE and What's New" section - added new Build 1130. |
| 21 Sep 2016 | "Troubleshooting and Related solutions" section - added sk113268, sk113269, sk113270. |
| 21 Aug 2016 | "Latest build of CPUSE and What's New" section - added new Build 1127. |
| 23 June 2016 | "(4-D) "How to ..." section - improved the description of "installer agent start" command. |
| 21 June 2016 | "(4-D) "How to ..." section - improved the description of "`installer agent <disable |
| 16 June 2016 | "Latest build of CPUSE and What's New" section - added new Build 100 5. |
| 14 Apr 2016 | "Latest build of CPUSE and What's New" section - added new Build 994. |
| 10 Apr 2016 | - "Troubleshooting and Related solutions" section - added sk105746. - "System requirements and limitations" section - added the applicable Domain objects. |
| 09 Apr 2016 | "Latest build of CPUSE and What's New" section - added a note about manual installation of CPUSE Agent RPM. |
| 31 Mar 2016 | Improved text readability. |
| 30 Mar 2016 | "Troubleshooting and Related solutions" section - added sk109359. |
| 27 Mar 2016 | Article was redesigned and updated. |
| 03 Jan 2015 | Minor text improvements. |
| 03 Jan 2015 | "System requirements and limitations" section - updated the information. |
| 20 Nov 2015 | Add explanation for "DAClient" commands. |
| 20 Sep 2015 | "System requirements and limitations" section - updated the information. |
| 29 July 2015 | Corrected Gaia Clish syntax for starting and stopping the Gaia Software Updates Agent daemon. |
| 26 July 2015 | Added Gaia Clish syntax for Build 802 and higher. |
| 22 July 2015 | Added sk106696 to "Related solutions" section. |
| 11 Mar 2015 | "System requirements and limitations" section - added instructions for allowing CPUSE to work with Check Point cloud. |
| 29 Jan 2015 | "System requirements and limitations" section - updated the information that option " Automatically download Contracts and other important data (Recommended)" should be enabled in SmartDashboard. |
| 05 Oct 2014 | Added description for Gaia Software Updates Agent version from 710 to 747. |
| 11 Sep 2014 | "Overview" - "Description" section - added a note that CPuse mechanism supports deployment of Major Versions (starting from build 502). |
| 19 Aug 2014 | - "Software Updates Notifications" section - updated the information. - Updated the notes for |