H3C磐宁NingOS

License使用指南

资料版本：5W100-20231212

本文档中的信息可能变动，恕不另行通知。

目  录

1 License概述··· 1-3

1.1 License简介·· 1-3

1.2 License类型·· 1-3

1.2.1 正式授权·· 1-3

1.3 License基本概念·· 1-3

1.4 License安装方式·· 1-4

1.5 技术支持·· 1-5

2 License远程授权··· 2-5

2.1 License远程授权简介·· 2-5

2.2 License操作注意事项·· 2-6

2.2.1 License通用操作注意事项·· 2-6

2.2.2 文件类操作注意事项·· 2-6

2.3 安装并获取授权·· 2-7

2.3.1 License远程授权通用安装流程·· 2-7

2.3.2 获取授权码·· 2-8

2.3.3 安装H3C License Server软件·· 2-8

2.3.4 安装H3C License Client软件（需在待授权系统中操作）·· 2-10

2.3.5 在License Server上添加License Client（需在License Server上操作）·· 2-10

2.3.6 获取设备信息（需在License Server上操作）·· 2-12

2.3.7 申请激活文件（需在H3C License管理平台上操作）·· 2-13

2.3.8 配置License Client并获取授权（需在License Server和系统中操作）·· 2-22

2.4 授权迁移·· 2-23

2.4.1 功能简介·· 2-23

2.4.2 授权迁移流程图·· 2-24

2.4.3 配置限制和指导·· 2-24

2.4.4 获取卸载文件（需在源License Server A上操作）·· 2-24

2.4.5 获取License Server B的设备信息文件（需在目的License Server B上操作）·· 2-24

2.4.6 设备授权迁移申请（需在H3C License管理平台上操作）·· 2-24

2.4.7 安装新激活文件（需在目的License Server B上操作）·· 2-26

2.5 授权卸载·· 2-27

2.5.1 功能简介·· 2-27

2.5.2 授权卸载流程·· 2-27

2.5.3 配置限制和指导·· 2-27

2.5.4 获取卸载文件（需在License Server上操作）·· 2-27

2.5.5 设备授权卸载申请（需在H3C License管理平台上操作）·· 2-28

3 License本地授权··· 3-29

3.1 License本地授权简介·· 3-29

3.2 License操作注意事项·· 3-30

3.2.1 License通用操作注意事项·· 3-30

3.2.2 文件类操作注意事项·· 3-30

3.3 安装授权·· 3-30

3.3.1 本地授权通用安装流程·· 3-30

3.3.2 获取授权码·· 3-31

3.3.3 获取设备信息（需在待授权系统中操作）·· 3-31

3.3.4 申请激活码/激活文件（需在H3C License管理平台上操作）·· 3-32

3.3.5 安装激活码/激活文件（需在待授权系统中操作）·· 3-40

3.4 激活码卸载·· 3-41

3.5 清理License存储区·· 3-41

4 附录··· 4-42

4.1 激活信息查询·· 4-42

4.2 未激活提醒·· 4-42

1 License概述

1.1  License简介

License即授权，指新华三技术有限公司授予用户使用特定软件功能的合法权限。

登录NingOS后，执行lap-cli system activation check命令可以查看预授权到期时间及激活情况，根据系统语言不同会分中英文显示，示例如下：

·            系统语言为英文：

[root@ningos ~]# lap-cli system activation check

Authorization failed.

The system is in the probationary period.

Usage expiration time: 2024-02-17 06:42:36

·            系统语言为中文：

[root@ningos ~]# lap-cli system activation check

系统未被激活。

系统处于试用期。

试用到期时间：2024-02-17 06:42:36

1.2  License类型

目前NingOS仅支持正式授权，详细信息请参见《H3C 磐宁NingOS License支持情况说明》。

1.2.1  正式授权

当您想使用需要授权的软件功能时，请通过H3C官方渠道购买授权书（授权书中包含授权码）。

1.3  License基本概念

在进行License操作前，请了解以下License基本概念。

1. H3C License管理平台

H3C License管理平台是新华三技术有限公司为用户提供产品授权业务服务的网站。通过该网站，您可以进行License激活申请、授权迁移申请和授权卸载申请。

使用网址http://www.h3c.com/cn/License可直接访问H3C License管理平台。

2. 软件使用授权书（Software License Certificate，简称授权书）

软件使用授权书是新华三技术有限公司授予用户合法使用H3C软件功能的相关说明文件，包含授权码、授权许可数量等信息。

3. 授权码（LK，License Key）

授权码是用户获得对应软件功能授权的唯一凭证。

正式授权的授权码包含在授权书中，对应授权书上的授权序列号（License Key），您购买授权书后即可获得正式授权码。

4. DID（又称设备ID，Device ID）

DID用于在H3C License管理平台申请授权，DID是设备的识别信息，是唯一标识一台硬件设备的字符串。

5. 激活码（AK，Activation Key）和激活文件（AF，Activation File）

激活码/激活文件是绑定了授权码和硬件设备信息的授权凭证，将激活码/激活文件安装到设备后，设备上的软件功能才能获得授权。

激活码是字符串形式的授权凭证，激活文件是文件形式的授权凭证。

激活码/激活文件需要您从H3C License管理平台申请。H3C License管理平台会根据您申请授权时输入的授权码和硬件设备信息，自动生成激活码或者激活文件。

6. 卸载码（UK，Uninstall Key）和卸载文件（UF，Uninstall File）

卸载码/卸载文件是用户将软件授权从某台设备上卸载的凭证。如果您需要取消授权码与设备的绑定关系，或者将一台设备未过期的授权迁移到另一台设备，您需要使用卸载码/卸载文件。

卸载码是字符串形式的，卸载文件是文件形式的。

您在系统上执行命令行卸载未过期的正式授权时，会生成卸载码或者卸载文件。

7. License存储区

License存储区是系统上大小固定、专用于存储授权相关信息的存储区。授权相关信息包括授权状态、授权时间、卸载码/卸载文件等。

为确保授权信息的准确性和延续性，License存储区中的信息在系统断电的情况下也不会丢失。

1.4  License安装方式

如表1-1所示，NingOS支持本地本地授权和远程授权两种方式，请根据现场实际情况以及您需要授权的系统数量选择合适的方式。

表1-1 License安装方式描述表

1.5  技术支持

新华三技术有限公司一直在努力提供最方便、最优质的产品，如果您对License的操作存在疑问或者不确定，请中止操作，可通过以下方式获取帮助：

·            热线电话：400-810-0504

·            服务网站：zhiliao.h3c.com

·            技术支持人员邮箱：[email protected]

·            微信公众号：新华三服务

2 License远程授权

2.1  License远程授权简介

License远程授权基于Client/Server架构，适用于规模较大的网络。远程授权具有以下优点：

·            授权的安装、卸载、迁移操作只需在License Server和H3C License管理平台上操作，无需在每台License Client上操作，简化了授权安装和维护流程。

·            多台License Client共用License Server上的授权，提高了授权利用率。

图2-1 远程授权示意图

2.2  License操作注意事项

在进行License操作前，请您务必了解以下使用注意事项。

2.2.1  License通用操作注意事项

·            请通过H3C官方销售渠道购买授权。

·            如果系统上已经安装了授权，请通过License Server的Web页面查看授权的有效期，并在有效期内安装新的授权，以免当前授权过期，影响对应业务的运行。

·            授权需要和License Server绑定。申请和安装授权时，请务必确认每步操作中输入信息的准确性，以免误操作给您造成损失。您需要确认的信息包括但不限于以下方面：

a.   确定您需要授权的License Client和License Server。

b.   确定您需要授权的软件功能。

c.   确认购买的授权规格和您的使用需求一致。

d.   确保和授权码绑定的系统是您使用的License Server。

e.   确保将获取到的激活文件安装到您使用的License Server上。

·            请不要多个用户同时在同一台License Server上进行License操作，以免操作失败。

·            如果您在H3C License管理平台上输入的信息中包含字母，Web页面如无明确说明，请您严格区分大小写。对于授权码等参数，尽量采用复制、粘贴的方式输入，以免参数输入错误，导致License操作失败。

2.2.2  文件类操作注意事项

授权安装/迁移/卸载操作中均可能需要上传或下载文件，例如设备信息文件、激活文件和卸载文件等。在执行文件操作时，请不要修改文件名称或编辑文件内容，以免造成授权失败。

2.3  安装并获取授权

2.3.1  License远程授权通用安装流程

图2-2 License远程授权通用安装流程

2.3.2  获取授权码

通过H3C官方渠道购买授权，获取授权书。授权书上印有授权码（License Key）。

2.3.3  安装H3C License Server软件

在您使用License远程授权方式前，请先安装H3C License Serve，安装方法分为两种。

1. 单独安装License Server

登录官网H3C License Server栏目，您可查看并获取最新的H3C License Server安装指导。将License Server单独安装在服务器或虚拟机等设备中。

2. 在已有的NingOS中通过rpm包安装License Server

·            网络配置需求。在安装License Server之前，建议您根据具体需求先规划好基础网络，使License Server所在的服务器与待授权系统之间互相连通。

·            服务器配置需求。License Server 所需服务器的硬件配置如图所示。

图2-3 硬件配置

·            依赖包版本号如图所示。

图2-4 依赖包版本号

(1)       防火墙配置。由于License Server服务支持客户端远程访问并且包含Web服务、监控服务、授权服务、Mariadb数据库通信等功能，所以需要保证Web服务、监控服务的HTTPS端口号、授权服务端口号以及Mariadb数据库端口号开启，以确保License Server服务正常启动并且能正常和lcp客户端（License Client）通信，以下介绍通过Firewall方式打开端口。

a.   查看防火墙状态。如果防火墙默认关闭，各端口的访问不会被禁止，则无需再配置放行端口；如果防火墙开启，则需要执行步骤2-5中的操作打开各端口。

[root@localhost license-server]# systemctl status firewalld

firewalld.service - firewalld - dynamic firewall daemon

Loaded: loaded (/usr/lib/systemd/system/firewalld.service; disabled; vendor preset: enabled)

Active: active (running) since Mon 2023-04-24 08:19:53 CST; 3s ago

Docs: man:firewalld(1)

Main PID: 60385 (firewalld)

Tasks: 2 (limit: 21550)

Memory: 28.2M

CGroup: /system.slice/firewalld.service

└─ 60385 /usr/bin/python3 -s /usr/sbin/firewalld --nofork --nopid

Apr 24 08:19:53 localhost.localdomain systemd[1]: Starting firewalld - dynamic firewall daemon...

Apr 24 08:19:53 localhost.localdomain systemd[1]: Started firewalld - dynamic firewall daemon.

b.   查询各端口号状态。

[root@localhost license-server]# firewall-cmd --query-port=5555/tcp

no

no表示授权服务端口号端口5555被禁止。

[root@localhost license-server]# firewall-cmd --query-port=28443/tcp

no

no表示WEB 服务的HTTPS 端口号28443被禁止。

[root@localhost license-server]# firewall-cmd --query-port=38443/tcp

no

no表示监控服务的HTTPS 端口号38443被禁止。

c.   配置防火墙，放行License Server 的授权服务端口号和HTTPS 端口号，并重载配置使配置生效。

[root@localhost license-server]# firewall-cmd --permanent --add-port=5555/tcp

success

[root@localhost license-server]# firewall-cmd --permanent --add-port=28443/tcp

success

[root@localhost license-server]# firewall-cmd --permanent --add-port=38443/tcp

success

[root@localhost license-server]# firewall-cmd --reload

success

d.   验证端口是否放行成功，显示yes表示放行成功。

[root@localhost license-server]# firewall-cmd --query-port=5555/tcp

yes

[root@localhost license-server]# firewall-cmd --query-port=28443/tcp

yes

[root@localhost license-server]# firewall-cmd --query-port=38443/tcp

yes

e.   关闭selinux服务。

(2)       安装License Server。打开各端口后，即可安装License Server，此处以使用root用户为例。

(3)       执行yum install lics命令。安装过程中会设置端口号，一般使用默认端口号即可。

[root@locahost x86_64]# yum install lics

……

[install] Decompression completed.

Type the license service port (1024-65535, default:5555) :

Type the HTTPS port for the Web login (1-65535, default:28443) :

Type the HTTPS port for the Monitor login (1-65535, default:38443) :

[install] Installing database, please wait...

(4)       确认服务正常。访问License server网址，其中10.114.244.54为License server服务器的IP地址，端口号为上一步中所设置的端口号，用户名及密码默认为：admin/admin@123。如果可以正常访问则服务搭建成功。

图2-5 登录License Server

2.3.4  安装H3C License Client软件（需在待授权系统中操作）

1. Lcp简介

被授权系统上需要搭载License Client，即Lcp服务。Lcp服务由2个包组成，OSLcp用于连接License Server，lcp-cli用于执行授权相关的动作。OSLcp在其中起到一个转接作用，负责将lcp-cli的请求传达至License Server处理。

2. 启动OSLcp服务

OSLcp已默认安装在NingOS系统中，请确认服务状态是否启动，如下示例为服务已启动。

[root@localhost system]# systemctl status OSLcp.service

OSLcp.service - OS License Client

Loaded: loaded (/etc/systemd/system/OSLcp.service; enabled; vendor preset: disabled)

Active: active (running) since Tue 2023-04-25 02:40:01 CST; 55s ago

Process: 315297 ExecStart=/bin/sh /etc/systemd/system/startOSLcp (code=exited, status=0/SUCCESS)

Main PID: 315298 (oslcp)

Tasks: 1 (limit: 21550)

Memory: 1.1M

CGroup: /system.slice/OSLcp.service

└─ 315298 ./oslcp

Apr 25 02:40:01 localhost.localdomain systemd[1]: Starting OS License Client...

Apr 25 02:40:01 localhost.localdomain systemd[1]: Started OS License Client.

如果服务未启动，请执行systemctl start OSLcp命令启动服务。

2.3.5  在License Server上添加License Client（需在License Server上操作）

1. 添加客户端（需在License Server上操作）

(1)       登录License Server，选择[客户端管理/客户端配置]选项，进入客户端配置页面。

图2-6 客户端

(2)       单击<增加>按钮，在增加客户端页面填写客户端名称、客户端密码等信息。单击<确定>按钮，完成客户端的创建。

¡  客户端名称：1-31字符，区分大小写，仅支持字母、数字和下划线。

¡  客户端密码：8-30字符，至少包含数字、字数和特殊字符中的两种类型，不支持空格及问号。

¡  描述：最长256字符，不支持（|）字符。

图2-7 客户端信息

2. 绑定客户端（需在待授权系统中操作）

在待授权系统上执行绑定客户端的操作，完成待授权系统与License Server连接。

(1)       执行lcp-cli client set -u username -p password命令，增加License Client用户，示例如下。

[root@localhost lcp-cli]# lcp-cli client set -u test -p test123456

(2)       如果是首次执行客户端操作，则需要增加License Server配置，可参考如下命令。如果已经设置过License Server配置，则跳过本步骤，如需切换License Server请参考步骤(5)。

[root@localhost ~]# lcp-cli server clear

[root@localhost ~]# lcp-cli server set -4 10.114.244.55 -p 5555

(3)       可执行lcp-cli info命令查看用户信息。

[root@localhost lcp-cli]# lcp-cli info

Username: test

Ciphertext password: ******

License server's IP address: 10.114.244.55, port: 5555

License client: Disabled

(4)       执行lcp-cli client enable命令，该命令的作用为使Client上的用户与License Server建立连接。

[root@localhost lcp-cli]# lcp-cli client enable

(5)       （可选）切换License Server。如果原License Server已停止工作或无法连接，为保证授权服务正常使用，可以参考如下命令切换License Server。

[root@localhost lcp-cli]# lcp-cli client disable

[root@localhost lcp-cli]# lcp-cli server clear

[root@localhost ~]# lcp-cli server set -4 10.114.244.54 -p 5555

3. 确认连接状态（需在License Server上操作）

登录License Server，选择[客户端管理/客户端连接]选项，单击<刷新>按钮，查看新增的Client用户是否已成功连接到License Server，成功连接则会显示用户信息。

图2-8 用户信息显示

2.3.6  获取设备信息（需在License Server上操作）

(1)       登录License Server，进入激活文件管理页面。

(2)       选择需要激活的用户，单击<导出DID>按钮，获取License Server的设备信息文件。

图2-9 导出DID

(3)       此时浏览器会下载DID文件，该文件用于和授权码一起生成激活文件，请妥善保存。

2.3.7  申请激活文件（需在H3C License管理平台上操作）

1. 功能简介

申请激活码/激活文件需要在H3C License管理平台上进行，H3C License管理平台支持如下申请方式：

·            一次输入一个授权码，绑定一台License Server，为一台License Server申请一个授权。

·            一次输入多个授权码，您可以将不同授权码和同一License Server绑定，也可以将不同授权码和不同License Server绑定，从而为一台或多台License Server申请授权。

2. 输入授权信息

(1)       在PC上启动浏览器，在浏览器地址栏中输入H3C License管理平台地址http://www.h3c.com/cn/License后按回车键，登录H3C License管理平台。

(2)       点击“License激活申请”页签，进入“License激活申请”页面，如图2-10所示。

图2-10 License激活申请页面

(3)       输入授权信息。H3C License管理平台支持通过以下方式输入授权码，请根据需要进行选择。

¡  单个输入授权码

在图2-10所示的授权码输入框中粘贴或手工输入完整的授权码字符串，然后单击<搜索&追加>按钮，H3C License管理平台会自动获取该授权码对应的授权信息。重复执行该操作可输入多个授权信息。

¡  上传二维码自动识别授权码

单击图2-10所示的< >按钮，H3C License管理平台会弹出“上传二维码的授权码图片”页面，如图2-11所示。在“上传二维码的授权码图片”页面上传授权码的二维码图片后，单击图2-10中所示的<搜索&追加>按钮，H3C License管理平台会自动获取二维码图片关联的授权信息。重复执行该操作可输入多个授权信息。

图2-11 上传二维码的授权码图片页面

¡  批量导入授权码

单击图2-10中所示的<导入&追加>按钮，H3C License管理平台会弹出“上传导入文件”页面，如图2-12所示。

图2-12 上传导入文件页面

H3C License管理平台支持通过以下文件批量导入授权码，请根据实际情况选择其中一种方式即可：

-     授权码Excel清单模板：点击图2-12中所示的“下载授权码Excel清单模板”链接，下载授权码Excel清单模板，Excel清单模板内容如图2-13所示。在模板中输入授权码，保存模板并上传该Excel文件，即可一次导入多个授权码，获取多份授权信息。

图2-13 授权码Excel清单模板内容

-     授权码清单：针对特定的销售场景，H3C可能会向用户提供电子版的授权码清单，授权码清单如图2-14所示。此时，您可以单击图2-12中所示的<选择文件>按钮，上传授权码清单，将授权码清单中包含的授权码一次性导入H3C License管理平台。

图2-14 授权码清单

(4)       授权信息输入完毕，选中需要激活的授权码，如图2-15所示。单击<下一步>按钮，进入绑定硬件设备页面。

图2-15 授权信息输入完毕页面

3. 绑定硬件设备

(1)       在绑定硬件设备页面中，确认上一步输入的授权码是否为您本次需要激活的授权码。

¡  如需新增授权码，可参考图2-16进行如下操作：

-     单击<增加>按钮。

-     粘贴或手工输入整个授权码字符串，或者单击授权码列的< >按钮上传授权码的二维码图片。

-     单击<+>按钮，新增授权码信息。

¡  如需移除授权码，选中授权码，单击<移除>按钮，删除无需激活的授权码。

图2-16 绑定硬件设备页面

(2)       输入设备信息。

请根据H3C License管理平台页面的提示输入，设备信息的获取方法请参见“2.3.6  获取设备信息（需在License Server上操作）”。H3C License管理平台支持通过以下方式输入设备信息，请根据需要进行选择。

¡  一对一绑定

单击图2-16所示列表中自定义设备标识列的< >按钮，根据页面提示输入设备信息来分别将单个授权码和单台设备绑定，如图2-17所示。多次执行该步骤，可以将多个授权码和不同设备绑定。

图2-17 输入设备信息页面

¡  多对一绑定

选中图2-16所示列表中需要绑定的授权码，单击<批量录入设备>按钮将多个授权码和同一台设备绑定。

(3)       将所有需要激活的授权码和设备绑定完毕后，请阅读并勾选“我已了解：授权码与硬件设备绑定后，对应的授权就与硬件设备进行了绑定。进行绑定操作时，请确保输入信息的准确，以免因授权码与硬件设备的错误绑定，导致目标设备没有获得正确的授权。”，如图2-18所示。单击<下一步>按钮，进入用户数据录入页面。

图2-18 绑定硬件设备完毕页面

4. 用户数据录入

请根据图2-19所示要求输入用户信息，各参数的详细描述请参见表2-1。H3C License管理平台将根据您输入的信息来记录执行本次授权操作的用户信息。

·            如果输入的“申请联系人E-mail”邮箱是第一次在H3C License管理平台使用，在输入用户信息完成后，单击<下一步>按钮，H3C License管理平台会弹出验证邮箱页面，如图2-20所示。单击<获取验证码>按钮，H3C License管理平台会向“申请联系人E-mail”邮箱发送一封H3C邮箱验证的邮件，请将邮件中的验证码输入到验证邮箱页面后，单击<确定>按钮，完成邮箱验证，返回到用户数据录入页面。单击<下一步>按钮，进入确认并激活页面。

·            如果输入的“申请联系人E-mail”邮箱不是第一次在H3C License管理平台使用，在在输入用户信息完成后，单击<下一步>按钮，进入确认并激活页面。