- Released At: 26-07-2023
- Page Views:
- Downloads:
- Table of Contents
- Related Documents
-
H3C UIS Manager
Local Licensing Guide
Document version: 5W100-20210827
Copyright © 2021 New H3C Technologies Co., Ltd. All rights reserved.
No part of this manual may be reproduced or transmitted in any form or by any means without prior written consent of New H3C Technologies Co., Ltd.
Except for the trademarks of New H3C Technologies Co., Ltd., any trademarks that may be mentioned in this document are the property of their respective owners.
The information in this document is subject to change without notice.
Obtaining information about license-based features
Restrictions and guidelines: Local licensing management
Management operation restrictions and guidelines
Registering and installing a license
Obtaining a formal license key
Obtaining the host information file or hardware code file
Obtaining the host information file
Obtaining the hardware code file
Requesting a license for the first time
Registering a software license
Q: What is a license key and what is an activation key or activation file?
Q: Can I uninstall a local license?
Q: Can I uninstall an expired license?
Q: Can I install an uninstalled activation file on the host again?
Q: How do I retrieve a lost license key?
Q: How do I retrieve an activation key or activation file?
Q: How do I transfer licenses when a host fails or when license transfer is required?
Overview
H3C offers licensing options for you to deploy features and expand resource capacity on an as needed basis. To use license-based features, you purchase licenses from H3C and install the licenses.
Obtaining information about license-based features
To obtain information about license-based features, their licensing status, and license availability:
1. Log in to UIS.
2. Click System on the top navigation bar.
3. From the left navigation pane, select Licensing.
Figure 1 Licensing management page
|
NOTE: The license-based features vary by software version. |
License types
H3C offers preinstalled, trial (or temporary), and formal licenses. Support for preinstalled and trial licenses varies by product. For more information about the license options available for UIS Manager, see H3C UIS License Matrixes.
Preinstalled licenses
Preinstalled licenses are built into a system and are available for use on initial startup of the system. Users do not need to activate them.
A preinstalled license is typically time limited and cannot be uninstalled or transferred.
When a preinstalled license expires, the license-based feature becomes unavailable. To continue to use the feature, you must purchase and install a formal license for it.
Trial licenses
Trial licenses are provided for you to verify the functionality of premium features so you can make an educated purchase decision.
A trial license is time limited and cannot be uninstalled or transferred.
When a trial license expires, the license-based feature becomes unavailable. To continue to use the feature, you must purchase and install a formal license for it.
To obtain a trial license for a feature:
1. Contact your H3C sales representative or technical support.
2. Register the trial license key with H3C License Management Platform to obtain an activation key or file.
3. Install the activation key or file to activate the feature.
Formal licenses
To gain most from a license-based feature, purchase a formal license for it.
Formal licenses are available with different validity periods and their support for uninstallation and transfer of formal licenses depends on product model. For more information, see H3C UIS License Matrixes.
To install a formal license for a feature:
1. Purchase a software license certificate through an official channel.
2. Access H3C License Management Platform, and then enter the license key in the certificate and the required device information to obtain an activation key or activation file.
3. Install the activation key or activation file in the target system.
Concepts
The following information describes the basic concepts that you might encounter when you register, install, and manage licenses.
H3C License Management Platform
H3C License Management Platform provides product licensing services for H3C customers. You can access this system to obtain license activation key or file, transfer licenses, or remove the device and license binding for an uninstalled license.
H3C License Management Platform is accessible at http://www.h3c.com/en/License.
Software license certificate
A software license certificate allows users to use a license-based feature. It contains license key, license capacity, and other information.
|
NOTE: Some of the H3C devices come with software license certificates. If they do not address all your requirements for premium features, purchase software license certificates separately. |
License key
A license key uniquely identifies a license.
To obtain a formal license key, purchase a software license certificate. The authorization serial number in the software license certificate is the license key.
To obtain a trial license key, contact your H3C sales representative or H3C technical support. Support for trial licenses depends on the device model. For more information, see H3C UIS License Matrixes.
Host information file
A host information file contains a string that uniquely identifies a host. You must submit a host information file to obtain an activation key or file from H3C License Management Platform.
Activation key and activation file
An activation key (AK) or activation file (AF) binds a license to a system.
To use a license-based feature on a system, you must perform the following tasks:
1. Use the license key and the system’s host information to obtain an activation key or file from H3C License Management Platform.
2. Install the activation key or file on the system.
Technical support
To obtain assistance, contact H3C by email or phone or access documents at the H3C website.
· Email:
¡ China: service@h3c.com
¡ Hongkong, China: service_hk@h3c.com
¡ Other countries or regions: h3cts@h3c.com
· Technical support hotline:
To find contacts for your local area, access the H3C global contacts page at https://www.h3c.com/en/Support/Online_Help/Service_Hotlines/
· Website: http://www.h3c.com
About local licensing
Local licensing requires license activation system by system. It is applicable to small-sized networks.
To install a license on a system:
1. Obtain the license key and host information of the system.
2. Access H3C License Management Platform to request an activation key or activation file based on the license key and the system's host information.
3. Install the activation key or activation file on the system to activate the license.
The activation key or file for a license is host locked. You cannot install the activation key or activation file for one host to activate the license on another host.
Figure 2 Local licensing procedure
Restrictions and guidelines: Local licensing management
Management operation restrictions and guidelines
· Purchase licenses from H3C authorized channels.
· To identify the validity periods of the licenses that have been installed on the system, click System on the top navigation bar, and then select Licensing from the left navigation pane. If the license for a feature is time limited, install a new license for the feature before the old license expires.
· Licenses are typically host locked. To ensure a successful licensing, use the following licensing guidelines:
a. When you purchase a license certificate, verify the following items:
- Make sure the license is compatible with the target host.
- Make sure its licensed functionality and capacity meet your requirements.
b. When you obtain an activation key or file, make sure the provided license key and hardware information are correct.
c. Install the activation key or file on the correct target system.
· Make sure no one else is performing license management tasks while you are managing licenses on the same system.
· Unless otherwise stated, all character strings entered on H3C License Management Platform are case sensitive. As a best practice to ensure a successful licensing, copy and paste license keys, Uninstall keys, and values for other critical fields as long as possible.
File operation restrictions
When you operate host information files, activation files, or Uninstall files, follow these restrictions and guidelines:
To avoid licensing error, do not modify the file name or edit the file content.
Before you install an activation file, download the activation file to local storage, and then upload the activation file to the system.
Registering and installing a license
Figure 3 Licensing procedure
Obtaining a license key
After you obtain a license key, back up it and keep the backup license key in a safe place for future use.
Obtaining a formal license key
To use a license-based feature, purchase a software license certificate for it. The authorization serial number in the software license certificate is the license key.
Obtaining a trial license key
If you need a trial license key to verify the functionality of a feature before you making a purchase decision, contact your H3C sales representative or H3C Support.
Obtaining the host information file or hardware code file
Restrictions and guidelines
For a stateful failover system, you can collect host information files for both the primary and backup management hosts on the primary host.
In a stateful failover system, the primary and backup management hosts cannot share one heterogeneous migration license or disk backup disaster recovery license. The heterogeneous migration or disk backup disaster recovery features are available only on the host installed with a license. To use heterogeneous migration or disk backup disaster recovery on both management hosts, collects their hardware codes to register the feature on them separately.
For heterogeneous migration or disk backup disaster recovery, obtain hardware codes as described in "Obtaining the hardware code file."
For other features, obtain host information files as described in "Obtaining the host information file."
Obtaining the host information file
To obtain UIS Manager licenses, you must first obtain host information files of the management node and download the files to the local disk.
In a stateful failover environment, you will get two sets of host information files, which are distinguished by the management IP addresses of the primary and backup management nodes.
To obtain host information files:
1. Access the UIS Manager login page.
2. Click Product Registration.
Figure 4 UIS Manager login page
3. Enter the root password, select Request or Update a License from the License Actions field, and then click Next.
Figure 5 Specifying a license action
4. Enter the end user information and applicant information, and then click Next.
Figure 6 Entering registration information
5. Click Download.
CAUTION: · UIS_host.info is the host information file for the UIS management node, and UIS_onstor_ip_host.info is the host information file for the distributed storage management node. · Do not edit the names of the host information files. |
The host information file package is downloaded to the local disk. Figure 8 and Figure 9 show the decompressed host information files for standalone deployment and stateful failover deployment, respectively.
Figure 7 Downloading host information files
Figure 8 Host information files for standalone deployment
Figure 9 Host information files for stateful failover deployment
Obtaining the hardware code file
CAUTION: In a stateful failover system, this task downloads the hardware code for the current management host. |
To download hardware codes:
1. Log in to UIS.
2. Click System on the top navigation bar.
3. From the left navigation pane, select Licensing.
4. Click the Feature Licensing tab.
Figure 10 Feature licensing
5. Click Download Hardware Code.
Figure 11 Hardware code
Obtaining the activation file
On H3C License Management Platform, you can bind one or multiple license keys to one system or perform the binding operation for multiple systems in one request
For HCI deployment, you must request activation files for the UIS standard edition and UIS-ONEStor separately by using a host information file. For more information about host information files, see "Obtaining the host information file." For example, to register the UIS standard edition, UIS-CAS, UIS standard edition enhancement package, and UIS-ONEStor licenses, perform the following tasks:
· Request an activation file for the UIS standard edition, UIS-CAS, UIS standard edition enhancement package licenses.
· Request an activation file for the UIS-ONEStor license.
When you apply for an activation file, H3C License Management Platform might prompt license key combination errors in the following situations:
· The CPU quantities are different for the licenses in a package. The UIS standard edition, UIS-CAS, UIS standard edition enhancement package requires that all licenses in the package license the same number of CPUs.
· A license package lacks license keys. Make sure you enter all required licenses keys to apply for an activation file for the licenses in a package.
UIS licenses are independent from UIS-ONEStor licenses. They belong to different product categories on H3C License Management Platform. Expanding or unbinding a UIS license does not affect any UIS-ONEStore license.
For stateful failover deployment, use a UIS standard edition license key to request a stateful failover activation file. Request a common activation file for the UIS-CAS, UIS standard edition enhancement package, or UIS-ONEStor license.
Requesting a license for the first time
Restrictions and guidelines
Typically, H3C License Management Platform generates one activation key or activation file for one license key.
If you request multiple licenses for one device, H3C License Management Platform might generate only one activation key or activation file for multiple license keys. The number of activation keys or activation files does not affect the availability of the licenses. After you install all generated activation keys or activation files on the license server, you can use all of the licenses.
It takes some time for H3C License Management Platform to generate multiple activation files. In this scenario, you cannot download the activation files from the webpage. To obtain the activation files, you must access the email box at the specified address.
If you do not receive an activation key or activation file for a license key from the platform and cannot use the license key to re-apply for license activation, contact H3C Support.
Procedure
1. Access H3C License Management Platform at http://www.h3c.com/en/License.
2. Access the page for license activation, and then use one of the following methods to add license keys:
¡ To add license keys one by one:
- Copy and paste a license key in the empty License Key box that opens, and then click Search & Add.
Alternatively, click the icon, and then upload the QR code image for the license key. Make sure the uploaded image is complete and clear for the platform to correctly recognize it.
- Repeat this step until all license keys are added.
¡ To add license keys in bulk.
- Click Import & Add.
- In the dialog box that opens, click the Download Excel License Key Import Template link.
- Click Select File to upload the template file that contains the license keys.
Figure 12 Adding license keys
|
NOTE: If you have requested a trial license key for the UIS standard edition enhancement package, upload the trial license key together with the other license keys you have obtained. You can register the UIS-ONEStor block storage, file storage, and object storage licenses separately. If you already have a license for a storage type and want to request a license for another storage type, expand the existing license. For example, if you want to obtain a file storage license after obtaining a block storage license, expand the block storage license. The expanded license contains information about both block storage and file storage. |
3. Select license keys to be activated, and then click Next.
4. To bind license keys one by one, click the icon in the Device ID column. To bind multiple license keys in bulk, click Bulk Bind. Configure the following parameters:
¡ Device ID—Enter the device identifier. You can use the combination of device model, IP address, and physical location as the device identifier.
¡ License key binding mode—Select Bind New License Keys when you request a license for the first time.
¡ Device Info File—Click Select to upload the host information file.
|
NOTE: To obtain an activation file for the UIS standard edition license, upload the host information file (UIS_host.info) of the target host. To obtain an activation file for the UIS-ONEStor license, upload the host information file (UIS_onstor_ip_host.info) of the target host. To obtain an activation file for the heterogeneous migration or disk backup disaster recovery license, upload the hardware code file (HardInfo.dat) of the target host. |
Figure 13 Binding license keys to devices
|
NOTE: In a stateful failover scenario, select Stateful Failover for the Deployment Mode parameter, and then upload the host information files of the primary and backup hosts. |
5. Review the bindings carefully.
Each license key will be locked to the device to which each of them is bound.
6. Make sure you understand the impact of the binding operation, and then select the option that explicitly states so.
7. Click Next.
8. Enter customer information as described in Table 1 and then click Next.
Figure 14 Entering customer information
Parameter |
Description |
End Customer Company/Organization |
(Required.) Company or organization that uses the licenses. |
Your Company/Organization |
(Required.) Company or organization with which the license applicant works. |
Contact Person |
(Required.) Name of the contact person. |
Phone Number |
(Required.) Contact phone number. |
Email Address |
(Required.) Contact email address. H3C License Management Platform will send the generated activation keys or activation files to this email address. Make sure the email address is correct and available. |
Zip/Postal Code |
(Optional.) Zip code or postal code for the contact address. |
Address |
(Optional.) Contact address. |
Project Name |
(Optional.) Project name. |
Verification Code |
(Required.) The verification code is case insensitive. |
9. Review the license key and device information and then select I accept all terms of H3C Legal Statement.
10. Click Confirm & Activate.
11. Double-check the license key and device information, and then click OK.
The platform automatically generates an activation key or activation file for each binding and send them to the specified email address.
12. Perform one of the following tasks to obtain activation keys or activation files:
¡ Click Get Activation Info to download an activation key or activation file to the local disk.
¡ Click Bulk Get Activation Info to obtain all activation keys or activation files generated for this request.
¡ Access the email box at the specified address to obtain the activation keys or activation files.
Expanding a license
You can expand a license to manage more physical CPUs, disk space, or upgrade the license from the standard edition to the enterprise edition.
Restrictions and guidelines
Typically, H3C License Management Platform generates one activation key or activation file for one license key.
If you request multiple licenses for one device, H3C License Management Platform might generate only one activation key or activation file for multiple license keys. The number of activation keys or activation files does not affect the availability of the licenses. After you install all generated activation keys or activation files on the license server, you can use all of the licenses.
It takes some time for H3C License Management Platform to generate multiple activation files. In this scenario, you cannot download the activation files from the webpage. To obtain the activation files, you must access the email box at the specified address.
If you do not receive an activation key or activation file for a license key from the platform and cannot use the license key to re-apply for license activation, contact H3C Support.
When you bind a new license key to a host for a license, follow these restrictions and guidelines:
· If the license is a trial license, H3C License Management Platform cannot automatically obtain the most recent history activation file when you upload the host information file. You must enter the license key for the license in addition to the new license key.
· If the license is a formal license, H3C License Management Platform automatically obtains the host information file bound to the most recent history activation file after you upload that activation file to the platform. As a best practice, use this method. Alternatively, you can upload the host information file to H3C License Management Platform for the platform to automatically obtain the most recent history activation file. If the host information file has changes (for example, NIC information changes), the platform might fail to obtain the most recent history activation file. In this case, H3C License Management Platform uses the new license key to activate instead of expanding the license.
If the UIS host information file has changes, use the following information to identify whether you can expand a license directly on H3C License Management Platform:
· If the host information file does not have great changes (not all NICs are replaced, the main board is not replaced, or not all MAC addresses of the NICs are changed), you can directly expand a license on H3C License Management Platform. When you bind a new license key to the host, upload the most recent history activation file. The platform automatically obtains the host information file bound to that activation file. Although the host information file is not identical to the new host information file, you can obtain an activation file successfully and install the activation file correctly on UIS.
· If the host information file has great changes (all NICs are replaced, the main board is replaced, or all MAC addresses of the NICs are changed), you must first contact H3C Support to transfer the license to the new hardware. Then, you can expand the license on H3C License Management Platform. If you expand the license on H3C License Management Platform without contacting H3C Support to transfer the license to the new hardware, the following conditions exist:
¡ If you upload the new host information file, the platform cannot automatically obtain the most recent history activation file. The platform uses the new license key to activate instead of expanding the license.
¡ If you upload the most recent history activation file, the host information file automatically obtained by the platform is greatly different from the new host information file. The activation file obtained based on the old host information file cannot be installed correctly on UIS. If you replace the old host information file with the new one when binding a new license key to the host, the platform uses the new license key to activate instead of expanding the license.
Procedure
1. Access H3C License Management Platform at http://www.h3c.com/en/License.
2. Access the page for license activation, and then use one of the following methods to add license keys:
¡ To add license keys one by one:
- Copy and paste a license key in the empty License Key box that opens, and then click Search & Add.
Alternatively, click the icon, and then upload the QR code image for the license key. Make sure the uploaded image is complete and clear for the platform to correctly recognize it.
- Repeat this step until all license keys are added.
¡ To add license keys in bulk.
- Click Import & Add.
- In the dialog box that opens, click the Download Excel License Key Import Template link.
- Click Select File to upload the template file that contains the license keys.
Figure 15 Adding license keys
3. Select license keys to be activated, and then click Next.
4. To bind license keys one by one, click the icon in the Device ID column. To bind multiple license keys in bulk, click Bulk Bind. Configure the following parameters:
¡ Device ID—Enter the device identifier. You can use the combination of device model, IP address, and physical location as the device identifier.
¡ License key binding mode—Select Bind New & Existing License Keys when you expand an existing license.
¡ Most Recent Activation File—Click Select to upload the history activation file (.lic). Then, H3C License Management Platform will automatically obtain the license information and device information related to this history activation file, and bind the new license keys and history license keys to the device information file.
¡ Device Info File—Click Select to upload the host information file. After you upload the most recent activation file, H3C License Management Platform will automatically obtain the host information file.
|
NOTE: To obtain an activation file for the UIS standard edition license, upload the host information file (UIS_host.info) of the target host. To obtain an activation file for the UIS-ONEStor license, upload the host information file (UIS_onstor_ip_host.info) of the target host. To obtain an activation file for a feature license, upload the hardware code file (HardInfo.dat) of the target host. |
Figure 16 Binding license keys to devices
|
NOTE: In a stateful failover scenario, select Stateful Failover for the Deployment Mode parameter. Then, you can upload the most recent activation file or upload the host information files of the primary and backup hosts. |
5. Review the bindings carefully.
Each license key will be locked to the device to which each of them is bound.
6. Make sure you understand the impact of the binding operation, and then select the option that explicitly states so.
8. Enter customer information as described in Table 2 and then click Next.
Figure 17 Entering customer information
Parameter |
Description |
End Customer Company/Organization |
(Required.) Company or organization that uses the licenses. |
Your Company/Organization |
(Required.) Company or organization with which the license applicant works. |
Contact Person |
(Required.) Name of the contact person. |
Phone Number |
(Required.) Contact phone number. |
Email Address |
(Required.) Contact email address. H3C License Management Platform will send the generated activation keys or activation files to this email address. Make sure the email address is correct and available. |
Zip/Postal Code |
(Optional.) Zip code or postal code for the contact address. |
Address |
(Optional.) Contact address. |
Project Name |
(Optional.) Project name. |
Verification Code |
(Required.) The verification code is case insensitive. |
9. Review the license key and device information and then select I accept all terms of H3C Legal Statement.
10. Click Confirm & Activate.
11. Double-check the license key and device information, and then click OK.
The platform automatically generates an activation key or activation file for each binding and send them to the specified email address.
12. Perform one of the following tasks to obtain activation keys or activation files:
¡ Click Get Activation Info to download an activation key or activation file to the local disk.
¡ Click Bulk Get Activation Info to obtain all activation keys or activation files generated for this request.
¡ Access the email box at the specified address to obtain the activation keys or activation files.
Registering a license
To register a license for the heterogeneous migration or disk backup disaster recovery feature, see "Registering a feature license." To register other types of licenses, see "Registering a software license."
Registering a software license
1. Log in to UIS.
2. Click System on the top navigation bar.
3. From the left navigation pane, select Licensing.
Figure 18 Licensing management page
5. Click Browse to select the UIS activation file (.lic) and the distributed storage activation file (.lic), and then click OK.
Figure 19 Registering licenses
After the licenses are registered successfully, you can view license information on the license management page.
|
NOTE: · If your trial or temporary distributed storage license is about to expire, register a new temporary license or official license before the license in use expires. If you fail to do so, the new temporary license or official license might not take effect. · If your distributed storage license has expired, contact H3C Support to reregister the license. · If you have licensed the distributed storage service with a temporary license, when you register a new temporary license, make sure its capacity is not smaller than the capacity of the old license. |
Registering a feature license
1. Log in to UIS.
2. Click System on the top navigation bar.
3. From the left navigation pane, select Licensing.
4. Click the Feature Licensing tab.
Figure 20 Feature licensing page
5. Click Register License.
6. Click Browse to select an activation file, and then click OK.
Figure 21 Registering a license
After the registration, the feature license is displayed on the Feature Licenses tab.
Appendix A FAQ
License activation
Q: What is a license key and what is an activation key or activation file?
A: A license key uniquely identifies a license. An activation key or activation file uniquely binds a license key to a host. To use a license-based feature on a host, you must install the activation key or activation file for that license on the host.
To obtain a license key, purchase a software license certificate from an H3C approved sales channel.
To obtain an activation key or activation file, access H3C License Management Platform at http://www.h3c.com/en/License. Then, request an activation key or activation file based on the license key and hardware information of the target host.
Q: Might the host information file for the host change? What impact does a host information file change have?
A: The host information file would change if the hardware (such as a CPU, network adapter, or main board) on the server is replaced.
The host information file change might affect the activated licenses on the management platform. If the management platform prompts license errors, contact H3C Support.
You will be unable to install the activation keys or activation files obtained by using the old host information file on the device. To resolve the issue, contact H3C Support.
To obtain a new activation file, you must export the new host information file from the device.
Q: Do I need to purchase and install new licenses for licensed features on the host after a software upgrade?
A: No, you do not need to do this. Unexpired licenses will continue to take effect after the host software upgrades.
License uninstallation
Q: Can I uninstall a local license?
A: No, you cannot. To uninstall a local license, contact H3C Support.
Q: Can I uninstall an expired license?
A: No, you cannot.
Q: Can I install an uninstalled activation file on the host again?
A: No. An activation file will become invalid after you uninstall it. To restore the license, contact H3C Support.
License retrieval
Q: How do I retrieve a lost license key?
A: If you lose the license key before obtaining an activation key or activation file, contact H3C Support to retrieve the license key based on the license purchase contract.
If you lose the license key after obtaining an activation key or activation file, contact H3C Support and provide the activation key or file or the device information.
Q: How do I retrieve an activation key or activation file?
A: You will be unable to use a licensed feature if its activation key or activation file is lost or inadvertently deleted. To retrieve an activation key or activation file, use one of the following methods:
Use the backup activation key or activation file.
Find the activation key or activation file from the email box of the applicant.
Contact H3C Support and provide the license key or host information to retrieve the activation key or activation file.
Q: How do I transfer licenses when a host fails or when license transfer is required?
A: Contact H3C Support for help.