How to Deal with License Upgrade from a Previous Version to UCMDB 11.0?

This end-to-end use case describes how to deal with license upgrade from an earlier version to UCMDB 11.0. This use case includes the following tasks.

Task 1. Upgrade UCMDB to version 11.0

For detailed instructions about upgrading UCMDB, see the interactive Deployment Guide.

Important During the upgrade, when you select Update from 10.x or 10.x CUP on the Select Installation Type wizard page, a message window pops up, reminding you that upgrading to version 11.0 requires migration of existing Universal Discovery license to Units.

Before you can proceed with the upgrade, you must do the following: 

  • Access the Support Entitlement Portal to convert any MDR and ACM licenses you own to the format required by 11.0 or later. This can be done by you and does not require any help from Micro Focus teams.
  • Contact the Software Sales Assist team (sw_ssa@microfocus.com) to begin the migration of your UD Full and UD Inventory OSI licenses to units.

Task 2. Check the license summary report

The permissive Instant-On License is installed by default and is going to expire in 22 days.

  1. Launch UCMDB Browser as Admin user.
  2. Click the Help button in the top right corner of the window, and then select About.

    The About window opens.

  3. Go to the LICENSE tab.

  4. Click the link after License Status.

    The License Summary Report page opens.

  5. Check the license summary report.

    • Only Instant-On license is listed even though you have had some licenses installed when you worked with the previous version. The license issued for previous versions are not compatible with UCMDB 11.0 and they are not visible.
    • The Advanced UD license usage is not displayed if you have not migrated to the new license key.
    • OSs managed by CM usage displays the number of OSIs belonging to the results of the managed in CM views.
    • The Managed Data Repository (MDR) usage is displayed according to the Available 3rd Party Integrations you have in UCMDB.

Task 3. Apply the new UCMDB 11.0 licenses, check licenses details and license capacity using JMX console

  1. Install the converted MDR and ACM licenses into UCMDB, and also install the migrated Units into UCMDB.

    When you access UCMDB server from web browser after upgrading UCMDB to 11.0, you may see a message similar to the following on the UCMDB splash screen:

    Click the link in the message to apply the new license according to the contract you already have, by using JMX Console > Licensing Services:

    • Use the addLicense method to install the Raw License Key
    • Use the addLicenseFromFile method to install licenses from a file

    Important If you have not yet migrated your licenses, contact the Software Sales Assist team (sw_ssa@microfocus.com) to begin the migration of your UD Full and UD Inventory OSI licenses to units. Then return to this step to apply the migrated license key or license file.

    When installing licenses, the Instant-On is overwritten.

    For details, see How to Manage Licenses Using the JMX Console.

  2. Calculate licenses immediately by invoking the invokeLicenseCalculation method from the Licensing Services category from the JMX console. (By default licenses are calculated on daily basis.)
  3. Check information about licensed capacity by using the getLicenseSummary method from the Licensing Services category from the JMX console.

Task 4. Launch License summary report and check license usage

Launch license summary report from UCMDB Browser (Help > About > LICENSE, then click the link after License Status) and check the license usage, according to what capacity you are licensed for:

  • The installed licenses details are displayed in Available Licenses section.
  • License Status - Now the license status is compliant.
  • Total Units usage provides data about units of licenses consumed and units of licenses available, as well as the units consumption rate.

  • Advanced UD usage – Units of resources discovered by the Advanced Discovery jobs
  • Basic UD usage – Units of resources discovered by the Basic Discovery jobs
  • OSIs managed by CM usage – Number of OSIs that are managed by CM
  • Available third party integrations usage – Number of integrations with non Micro Focus products
  • Is UCMDB Foundation – Indicates whether you have Foundation license or not.

Task 5. Review the units of licenses consumed in the detailed License Consumption Report

  1. In the License Summary Report window, click Export License Consumption Details Report.

    The license consumption details are exported to an Excel spreadsheet.

  2. Open the Excel spreadsheet and review the consumed units in the report:

    • The lic_type column indicates whether a resource consumes a basic or an advance license type. basic for Basic Discovery; advance for Advanced Discovery.

    • The instance_type column indicates the instance type of the resource. Valid values include server, workstation, network and storage devices, and docker container.
    • The node_role column indicates whether the resource is of node type, but not of network or storage device, and what node type the resource is: server or workstation. Value example: [server, virtualized_system] or [virtualized_system] for a server resource; [desktop, virtualized_system] for a workstation resource.

    For more details about the columns in the report, see Access the new License Summary Report.

Task 6. Install additional license capacity when you discover more resources than you are licensed for

When discovering more resources than you are licensed for, you are still able to use the UCMDB Server. However, the server status is Noncompliant.

  1. Launch License summary report from UCMDB Browser (Help > About > LICENSE) to check what exceeded capacity is.

  2. In order to be compliant, you can install additional license capacity using the addLicense method (or addLicenseFromFile method) from the Licensing Services category in the JMX console.

  3. Calculate licenses immediately by invoking the invokeLicenseCalculation method from the Licensing Services category from the JMX console. (By default licenses are calculated on daily basis.)

  4. Launch License summary report again.

    Now the UCMDB Server status is Compliant.