Skip to main content
Version: 4.3

CMDBuild version update

CMDBuild version update​

To upgrade an existing CMDBuild installation to a newer version, follow the procedure described below.

Before updating​

Before starting the upgrade, it is recommended to create a virtual machine snapshot, if available, to simplify rollback in case of unexpected issues.

Perform the following operations:

  1. Stop Apache Tomcat
  2. Create a backup of all required data, especially the CMDBuild database
  3. Save any custom configuration files stored in:
<tomcat_installation_folder>/webapps/<webapp_name>/WEB-INF/conf

Update procedure​

  1. Delete the existing CMDBuild web application directory:
<tomcat_installation_folder>/webapps/<webapp_name>
  1. Extract the .war file of the new CMDBuild version into the same location
  2. Clear the browser cache to ensure that all updated client-side resources are loaded correctly

After updating​

When the application is started for the first time after the upgrade, a notification is displayed on the login page indicating that a new version has been installed.

If custom configuration files were saved before the upgrade:

  1. Stop Apache Tomcat
  2. Restore the saved configuration files to:
<tomcat_installation_folder>/webapps/<webapp_name>/WEB-INF/conf
  1. Start Apache Tomcat again

If database updates are required, CMDBuild will automatically detect them and display the appropriate update procedure during startup.