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:

  1. Introduction
  2. Download the CPUSE Agent build, What's New, and Installation instructions
  3. Documentation
  4. Troubleshooting
  5. Related Solutions
  6. 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:

Installation instructions for the CPUSE Deployment Agent

(2-A) Check the current build of the CPUSE Deployment Agent

Follow one of these procedures:

  1. Navigate to the Software Updates section - click the Available Updates page.
  2. Click the button Update Settings.
  3. The build of the installed Deployment Agent appears in the Deployment Agent section.
  1. Navigate to the Upgrades (CPUSE) section - click the Status and Actions page.
  2. The build of the installed Deployment Agent appears at the top. Example:
  1. Connect to the command line on the Gaia server.

  2. Log in.

  3. If your default shell is Gaia Clish, then go to the Expert mode:

    expert

  4. 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:

  1. Connect to Gaia Portal and obtain the lock over the configuration database (click the lock icon at the top - near ' Sign Out').

  2. Navigate to the Software Updates section - click the Available Updates page.

  3. Click the button Update Settings.

  4. In the section Deployment Agent, click Update Deployment Agent.

  5. Click Browse for a file.

  6. Select the CPUSE Deployment Agent TGZ package on your computer.

  7. Click Install DA. Example:

  8. Follow the instructions on the screen.

(3) Documentation

CPUSE Administration Guide

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 debug
da_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_logs
It 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

# Category Related Solutions
1 Connectivity to
Check Point servers
- sk83520 - How to verify that Security Gateway and/or Security Management Server can access Check Point servers?
- sk94508 - Recommended Internet Access Settings for Automatic Downloads
- sk103433 - "CPUSE requires a valid license for downloads and updates" message in Gaia Portal
- sk107508 - Download of CPUSE package fails with "Error: Bad or slow connection to the Check Point Cloud"
2 Update of CPUSE Agent - sk109466 - "Please wait while updating the Deployment Agent" pop-up is stuck in Gaia Portal after CPUSE Agent update
- sk119954 - "error: Failed dependencies" during manual installation of CPUSE Agent package
3 Installation / uninstall
of CPUSE packages
- sk111158 - Central Deployment Tool (CDT)
- sk97699 - "Check Point's installer detected inconsistent file..." message when installing a software update using Gaia Software Updates
- sk104479 - "Please wait while the system reboots" popup in Gaia Portal on "Status and Actions" page
- sk101100 - CPUSE packages displayed in Gaia Portal / Gaia Clish can not be installed due to CRs conflict
- sk119993 - After major upgrade using the CPUSE Clish "installer install" command and reboot, system starts with First Time Configuration Wizard
- sk115243 - "Uninstall of package Check_Point_R80_JUMBO_HF_Txx_sk111536.tgz Failed" message when trying to uninstall the current Take / install a higher Take of R80 Jumbo Hotfix Accumulator using the CPUSE
- sk114592 - "Uninstall Failed: (Reason: Failed locating backup archive.)" when uninstalling a package using CPUSE
4 Installation / uninstall of
Jumbo Hotfix Accumulators
- sk115719 - "command not found" when running the "installed_jumbo_take" command after CPUSE Offline installation of a Jumbo Hotfix Accumulator
5 CPUSE Agent does
not work correctly
- sk81680 - Cannot see any packages in "Software Updates" packages table in Software Updates part of Gaia Portal

(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