Ops Manager 许可证密钥概述

许可证密钥是 MongoDB 颁发的签名文件，用于确认您的 MongoDB 企业高级版订单处于激活状态。您需要在 Ops Manager 中安装许可证密钥，Ops Manager 会使用该密钥显示您安装的许可证密钥状态，并在订单到期日之前发出警告。

MongoDB 正在引入许可证密钥，以使企业高级版许可与更广泛的软件市场保持一致。许可证密钥让您可以在 Ops Manager 中清晰地查看许可证密钥状态和续订时间表。

License keys apply to Ops Manager 9.0.2, 8.0.28, and later. If you run an earlier version, you don't need a license key.

重要

Ops Manager 不会限制任何许可证密钥状态下的任何操作。您的部署、备份和恢复功能将继续正常运行，并且您可以随时安装许可证密钥。

许可证密钥生命周期

许可证密钥的激活过程分为四个阶段。以下各节将按顺序描述每个阶段。

您可以在密钥门户中为您的安装密钥管理器 ID 生成许可证密钥。
您需要在 Ops Manager 中安装许可证密钥。Ops Manager 会自动验证许可证密钥，因此无需连接到 MongoDB 即可进行安装。
Ops Manager 会计算许可证密钥状态，并在订单结束日期前后发出警告。
在订单到期日之前，您需要生成一个续订的许可证密钥。如果系统已连接，则会自动安装该密钥。否则，您需要自行安装。

获取并安装许可证密钥

You generate a license key in the Key Portal at https://support.mongodb.com/keyportal. To generate a license key, add your Ops Manager installation to the Key Portal by its Key Manager ID.

密钥管理器 ID 用于标识 Ops Manager 安装，包括高可用性设置中的每个实例。Ops Manager 会拒绝 MongoDB 为其他密钥管理器 ID 颁发的许可证密钥。

如果您无法生成许可证密钥，则可能是您的 MongoDB 订单即将到期或正在等待续订。请联系您的 MongoDB 企业高级版订单经理或您的 MongoDB 客户团队。

Ops Manager 会使用内置于 Ops Manager 安装中的公钥验证每个许可证密钥。要查找密钥管理器 ID 并安装许可证密钥，请参阅Ops Manager 中的“管理许可证密钥” 。要了解 Ops Manager 拒绝许可证密钥时返回的错误，请参阅“排查安装错误”。

许可证密钥状态

Ops Manager 每小时计算一次许可证密钥状态。安装或释放许可证密钥后，Ops Manager 也会立即重新计算状态。

未通过验证的许可证密钥不提供任何保障。Ops Manager 将仅包含未验证许可证密钥的安装与未包含任何许可证密钥的安装视为同一类安装。

Status Values

The License Key Manager page and the API describe the same status with different names. The following table maps each Ops Manager interface status to the enforcement.effectiveState value that the API returns:

接口状态	API状态	说明
`Active`	`LICENSED`	许可证密钥涵盖您的安装，并且没有续订警告。
`Needs attention`	`LICENSED`	A license key covers your installation, and a renewal warning is open. The `enforcement.warnings` array in the API response contains the warning.
`Grace period`	`GRACE`	您的安装目前没有保障，宽限期正在进行中。当您的订单到期日已过或您尚未安装可用的许可证密钥时，就会出现此状态。
`Expired`	`EXPIRED`	您的订单截止日期已过，宽限期也已结束，但您仍未获得新的许可证密钥。
`Unlicensed`	`UNLICENSED`	您尚未安装可用的许可证密钥，宽限期已结束。

宽限期

The grace period lasts 90 days. After your order end date passes, Ops Manager enters the GRACE state. If you don't install a new license key within 90 days, the state changes to EXPIRED.

If you install Ops Manager, or upgrade to a version that supports license keys, without installing a license key, the grace period starts when Ops Manager first calculates the license key status, within an hour of startup. If you still haven't installed a license key after 90 days, the state changes to UNLICENSED.

To return to the Active status, install a license key that covers your installation. To learn how, see Manage License Keys in Ops Manager.

续订提醒

Ops Manager 会在您的订单到期日之前发出续订提醒：

对于两年或更长时间的订单，警告会在订单结束日期前六个月发出。
对于较短的订单，预警会在订单结束日期前四个月发出。

While the warning is open, the status is Needs attention.

通知

Ops Manager 会通过以下方式通知您许可证密钥状态：

运维管理界面顶部的横幅。
A warning icon on the License Keys item in the Admin navigation.
许可证密钥管理器页面上的消息。
系统警报。

Ops Manager shows the banner, the icon, and the page only to users with the Global Owner role.

旗帜

横幅广告链接到许可证密钥管理器页面。但该横幅广告并未显示在该页面上。

The banner is yellow when the status is Needs attention or Grace period. The yellow banner shows the following message:

You are at risk of not meeting your license key requirements.

The banner is red when the status is Expired or Unlicensed. The red banner shows the following message:

You are not meeting your license key requirements.

许可证密钥管理器页面消息

许可证密钥管理器页面会显示一条与状态相符的消息：

状态	message
`Needs attention`	`Your license key is about to expire`该消息会显示许可证密钥的剩余天数和到期日期。消息会提示您联系您的 MongoDB 客户团队或内部 MongoDB 管理员。
`Grace period`	`Grace Period`该消息会显示剩余天数以及您必须安装有效许可证密钥的日期。
`Expired` or `Unlicensed`	`License key expired`该消息表明 Ops Manager 实例不再具有有效的许可证密钥。

系统警报

Ops Manager 默认创建以下系统警报。默认情况下，每个警报在保持开启状态期间每周都会再次发送通知。

警报	开启时间
`At risk of not meeting license key requirements`	The state is `LICENSED` and a renewal warning is open. The alert closes when the warning clears or when the state changes.
`Not meeting license key requirements`	The state is `GRACE`, `EXPIRED`, or `UNLICENSED`. The alert closes when the state returns to `LICENSED`.

每条警报的详细信息都包含当前状态。如果运维经理预测状态会发生变化，则详细信息还会包含下一个状态以及变化日期。警报电子邮件中包含指向许可证密钥管理器页面的链接。

By default, Ops Manager sends the alert email to the Admin Email Address. To change the notification settings, see Modify Notification Settings for a System Alert.

续订许可证密钥

在您的订单到期日之前，请在密钥门户中为您的安装密钥管理器 ID 生成续订的许可证密钥。如果您的 Ops Manager 安装可以连接到 MongoDB，Ops Manager 将每小时检查一次新的许可证密钥，并自动安装续订的许可证密钥。自动安装始终开启，无法关闭。

您必须手动安装首次安装的许可证密钥。如果 Ops Manager 无法连接到 MongoDB，或者自动安装失败，Ops Manager 将在下次检查时重试。您也可以随时自行安装许可证密钥。要了解具体操作方法，请参阅Ops Manager 中的“管理许可证密钥”部分。

如果您的续订仍在进行中，请联系您的 MongoDB 客户团队申请临时延期。任何临时延期都必须获得 MongoDB 的批准。

遥测和许可证密钥

Ops Manager 会发送 MongoDB 产品使用情况遥测数据，以帮助 MongoDB 提供更好的支持、了解您的部署模型并确定需要投资的领域。许可证密钥可以包含遥测豁免，允许您选择关闭产品使用情况遥测功能。

The License Key Manager page shows the exemption under Entitlements.

如果您的许可证密钥未包含遥测豁免，则 Ops Manager 会发送产品使用情况遥测数据。在这种情况下，Ops Manager 界面会拒绝禁用产品使用情况收集的请求，并显示以下错误：

Product usage collection requires a license telemetry exemption

有关 Ops Manager 收集的数据的更多信息，请参阅Ops Manager 遥测概述。