Upgrade Cloud Management Platform on CloudBolt Documentation

Import and export utilities

Mon, 01 Jan 0001 00:00:00 +0000

There are two utilities:

cb_import: Import files and directories to CMP instances
cb_export: Archive and compress files and directories into a single .tar.gz file

Access utilities

On a CMP instance, you can access the import and export utility scripts from the following location:

/opt/cloudbolt/manage.py
/opt/cloudbolt/manage.py cb_export
/opt/cloudbolt/manage.py cb_import

Export utility

By default, cb_export includes the following directories:

VARDIR/opt/cloudbolt, where VARDIR is defined in Django settings
MEDIA_ROOT and STATIC_TESTS_DIR, where each is defined in Django settings

Specific files and directories can be included or excluded as required. Refer to Options for more details.

Maintenance modes

Mon, 01 Jan 0001 00:00:00 +0000

Cloud Management Platform (CMP) supports two maintenance modes:

Admin-only: Only CMP admins can use the CMP UI and API
Full: No one can use the CMP UI and API, and jobs cannot run

Admin-only maintenance mode

When Admin-only mode is enabled, all non-admin CMP users are logged out, and a message displays on all pages. Jobs are uninterrupted.

Non-admins cannot log in while the mode is enabled, including through SSO. The login page tells them that only admins can log in.

Upgrade with high availability

Mon, 01 Jan 0001 00:00:00 +0000

Prerequisites

Web server and job engine processes must be stopped before upgrading.

Web server instances

Perform the following on each web server instance.

Stop web server processes.
```
systemctl stop httpd
```

Job engine instances

Perform the following on each job engine instance.

Check for active job engine jobs.

# Navigate to /opt/cloudbolt/
cd /opt/cloudbolt/

# Start shell_plus
./manage.py shell_plus

# List active jobs
Job.objects.filter(status__in=Job.ACTIVE_STATUSES)

Cancel active job engine jobs.

Job.objects.filter(status__in=Job.ACTIVE_STATUSES).update(status="CANCELED")

Stop job engine processes.
```
supervisorctl stop jobengine:*
```

Upgrading to Release 2026.2

Mon, 01 Jan 0001 00:00:00 +0000

This page covers what changed in Release 2026.2.10, how to prepare your environment, known compatibility risks, and how to resolve common post-upgrade errors.

What is this upgrade?

CloudBolt upgraded the underlying framework and runtime of the Cloud Management Platform (CMP) to Django 5.2 and Python 3.12, and updated Django REST Framework (DRF) from 3.11.2 to 3.15.2. These upgrades move CMP to the latest long-term support (LTS) versions of these technologies.

Upgrade to PostgreSQL 18

Mon, 01 Jan 0001 00:00:00 +0000

PostgreSQL 14 reaches end of life in November 2026 and will no longer receive security or bug fixes. PostgreSQL 18 is supported until November 2030.

The upgrade is optional and separate. Upgrading CMP does not upgrade the database. CMP continues to work on PostgreSQL 14 until you upgrade.
New installations use PostgreSQL 18. No action is required for a new CMP installation.
The upgrade requires downtime. CMP is unavailable while the database is upgraded, so schedule the upgrade in a maintenance window.

Upgrade scripts

The scripts are included in CMP 2026.3.97 and later, in the top level of the unpacked installer and upgrader. Run each script from that directory. The PostgreSQL 18 packages are included in the upgrader, so the scripts work on servers without internet access and on database servers without CMP installed.

Upgrading to Release 2026.3

Mon, 01 Jan 0001 00:00:00 +0000

Release 2026.3.51 moves the Cloud Management Platform (CMP) interface from Bootstrap 3 to Bootstrap 5. Bootstrap 3 is no longer supported, and no compatibility layer is provided. This page covers what changed and how to migrate custom templates, UI extensions, and JavaScript.

Who this affects

This page applies to you if you maintain any of the following:

Custom Django templates in /var/opt/cloudbolt/proserv/ that extend base.html or any CMP template
UI extensions (XUIs) you wrote yourself, or modified after installing
Custom JavaScript that calls c2.* functions

CloudBolt UI extensions

CloudBolt UI extensions have been updated for Bootstrap 5 and republished in the Content Library. If an updated version is not listed yet, refresh the Library listing.