---
title: How to Upgrade Core Server from v9 to v10
description: "## **Summary** This article provides a best-practice, step-by-step procedure to upgrade the **Open iT Core Server** from **version 9** to **version 10**. The process ensures minimal downtime, preserves existing configurations, and helps maintain consistency across environments. ## **Purpose** To guide…"
url: "https://openit.com/knowledge-base/upgrade/upgrade-core-server-v10/"
updated: "2026-07-17"
category: Upgrade
---

# How to Upgrade Core Server from v9 to v10

## **Summary**

This article provides a best-practice, step-by-step procedure to upgrade the **Open iT Core Server** from **version 9** to **version 10**. The process ensures minimal downtime, preserves existing configurations, and helps maintain consistency across environments.

## **Purpose**

To guide administrators through a safe and uniform upgrade process of the Core Server from v9 to v10, based on practical field experience and lessons learned.

## **Scope**

- **Applies to:** On-premises environments
- **Affected Systems:** Core Server and connected client systems

## **Prerequisites**

Before starting the upgrade, ensure the following actions are completed:

1. **Backups**
   - Bin folder
   - Configuration folder
   - ReportingServer folder
   - (Optional) Data folder – recommended to request a **VM snapshot** from the customer instead of manual backup. Note: during uninstallation, the Data folder is usually preserved.
2. **Screenshots / Documentation**
   - License Servers (from the portal)
   - Mapping Source settings
   - User-to-Properties and User-to-Groups Mappings
   - Users and Groups list
3. **Environment Notes**
   - Record the **installation path** of the existing Core Server.
   - Record the **Data directory path**.
4. **Installer**
   - Download the latest Core Server v10 installer from the **Customer Portal**.

## **Upgrade Procedure**

**Step 1: Uninstall the Old Version**

1. Stop all **Core Server services**.
2. Uninstall Core Server v9 from **Programs and Features**.

**Step 2: Install Ingress**

1. Launch the Ingress installer.
2. If using **HTTPS**, provide the proper **hostname** (must match the one used to access the webpage) and the correct **port**.
3. If using **HTTP**, uncheck the HTTPS option.
4. Complete the Ingress installation.

**Step 3: Install Core Server v10**

1. Mount and run the v10 installer.
2. Choose the appropriate **installation directory**.
3. Point the **Data directory** to the existing (previous) Data folder.
4. Complete the installation.

## **Post-Upgrade Validation**

After installation, perform the following checks:

1. Confirm the **Core Server webpage** is accessible.
2. Verify all **Core Server processes** are running.
3. Reconfigure the **Mapping Sources** and **Mappings** as per the screenshots.
   - For customized mappings, copy them from the backup into the new Configuration folder.
4. Restore the previous map.dbl file:
   - Replace the new file at ReportingServer\db\map with the backed-up version.
5. Validate that all **license servers are connected** by checking **License Monitor** in the portal.

## **Rollback Plan**

In case the upgrade fails:

1. Stop Core Server services.
2. Uninstall the upgraded version (v10).
3. Restore the backed-up **configuration files** and **database**.
4. Reinstall Core Server v9.
5. Restart services and validate functionality.