Prerequisites

In Open iT, an upgrade typically refers to updating the software on the same machine where it is already installed. This process is intended for minor or hotfix version updates within the same major release, such as upgrading from version 10.2.530 to version 10.2.540.

This guide provides step-by-step instructions for performing a supported Core Server upgrade, including preparation, execution, and verification procedures. Follow this guide carefully to minimize downtime and prevent potential issues during the upgrade process.

Accomplish the following items before upgrading the Core Server:

Windows

1. Coordinate with the Open iT Support Team at support@openit.com and ask for a list of custom configuration, scripts, or binaries deployed in your setup. Make sure to back up the custom files, if there are any.

2. Back up the Configuration directory, which is by default in C:\Program Files\OpeniT\Core\Configuration.

3. Back up the data directory, which is by default in C:\ProgramData\OpeniT\Data.

4. Back up the following database files:

   • map.dbl, which is by default in C:\Program Files\OpeniT\Core\ReportingServer\db\map
   • system.s3db, which is by default in C:\Program Files\OpeniT\Core\ReportingServer\db\general
   
   

5. Export and create a backup of the HKEY_LOCAL_MACHINE\Software\OpeniT registry key.

   warning

   The HKEY_LOCAL_MACHINE\Software\OpeniT\Installation and HKEY_LOCAL_MACHINE\Software\OpeniT\Resources should be excluded from the backup file.

6. Verify whether the setup is using HTTPS or not. Take note of the path to the SSL certificate directory.

7. Gather screenshots of the following pages:

   • License Monitor
   • Mapping
   • Users
   • Data Generation > Automatic Generation Config
   • Registry

Unix

1. Coordinate with the Open iT Support Team at support@openit.com and ask for a list of custom configuration, scripts, or binaries deployed in your setup. Make sure to back up the custom files, if there are any.

2. Back up the Configuration directory, which is by default in /var/opt/openit/etc.

3. Back up the data directory. This is your defined data_dir ($ROOT_DATA_DIR) upon the Core Server installation.

4. Back up the following directories:

   • /etc/opt/openit
   • /opt/openit/contrib
   
   

5. Back up the following database files:

   • map.dbl, which is by default in /opt/openit/db/map/
   • system.s3db, which is by default in /opt/openit/db/general/system.s3db
   
   

6. Verify whether the setup is using HTTPS or not. Take note of the path to the SSL certificate directory.

7. Gather screenshots of the following pages:

   • License Monitor
   • Mapping
   • Users
   • Data Generation > Automatic Generation Config
   • Registry

Once all the items are accomplished, you may now proceed to upgrade the Core Server.

Core Server Installation Requirements