TN - LM - 26051509 Resolving Corrupt Aveva Licensing Files

• Document Version: 001
• Applies to Version(s): 4.1 and 4.2.1

Description

This document outlines the procedure for resolving issues with AVEVA Enterprise Licensing when data files have become damaged or corrupted. This typically occurs due to hardware failures like disk crashes or sudden power losses. You may notice this if licenses cannot be activated or deactivated properly, even when they appear available on the AVEVA backend.

Pre-Maintenance Precautions

Last Resort: This cleanup should only be performed after all other troubleshooting methods have failed.

Redundancy: If your environment uses Redundant License Servers, you must follow these steps on both machines.

Preparation: Before starting, document every entitlement currently in your License Manager and ensure you have the corresponding XML files ready for re-activation. Note that replacing the database file will clear the list of unused activated licenses.

Solution Details

Solution Steps:

Step 1: Software Preparation

Visit the Global Customer Support (GCS) site at softwaresupportsp.aveva.com.

Download the most recent version of AVEVA Enterprise Licensing (such as version 4.2.1).

Unblock the downloaded file and complete the installation. Performing this cleanup is an ideal time to ensure your License Server is fully up to date.

Step 2: Database Management

Navigate to: C:\ProgramData\AVEVA\Licensing License Manager\Data\.

Create a backup copy of the License ManagerData.db file, then delete the original from this folder.

Obtain a fresh, blank version of the database file from the framework directory:

For v.4.1.0 or older: C:\Program Files (x86)\Common Files\ArchestrA\Licensing Framework\License Manager\License ManagerDb.db.

For v.4.2.1 or newer: C:\Program Files\Common Files\ArchestrA\Licensing Framework\License Manager\License ManagerDb.db.

Step 3: Service Reset Sequence

You must stop and then restart the four primary licensing services. The naming conventions vary depending on your software version.

A. Stop Services (In Order)

B. Replace Database

Place the blank copy of the database you obtained in Step 2 into the active data folder: C:\ProgramData\Aveva\Licensing License Manager\Data\License ManagerData.db.

C. Start Services (In Reverse Order)

Step 4: Restoration

If you are using a redundant setup, re-pair your servers now.

Import the entitlement XML files you gathered during preparation back into the License Manager.

Re-activate all required licenses.

________________________________________________________________________________________________________