第三十五章 在 Windows 上使用 IRIS（二）

IRIS 启动器

Microsoft Windows 平台上的主要IRIS 界面是 IRIS 启动器。从 IRIS 启动器，可以启动所有 IRIS 配置和管理工具。还可以从快捷方式或命令行调用每个启动器命令。

相应地，可以从 Windows 程序菜单中启动许多 IRIS 工具，方法是指向 IRIS 文件夹，然后指向启动 IRIS 以获得适当的 IRIS 实例名称。

当在基于 Windows 的系统上启动 IRIS 时， IRIS 启动器图标会出现在任务栏的系统托盘中。

当单击 IRIS 启动器时，会出现一个菜单，其中包含使用 ObjectScript 实用程序和编程环境的命令。

下表描述了 IRIS 启动器菜单中可用的命令。

好消息， InterSystems 容器镜像仓库Docker桌面扩展已正式发布供大家 下载 .

大家可以在Docker桌面版的marketplace 下载.下载后需要重启 Docker Desktop to 

把数据库添加进Mirror

以往的经验里， 用户在把数据库添加到镜像时遇到过各种各样的问题，以致必须请求外部帮助才能解决。除了步骤本身比较繁琐，很大的原因是阅读文档不细致。还有一个，就是对英文水平不太高的用户，有些英文句式并不是很好懂，比如说，文档中有这一句其实非常关键：

If you attempt to add a new database to the mirror on a nonprimary member that was not created as a mirrored database on the primary, but rather added to the mirror after it was created, an error message notes this and you cannot complete the operation.

我用最好的翻译器DeepL翻译后的中文是：

如果你试图在一个非主要成员上向镜像添加一个新的数据库，而这个数据库并不是在主要成员上作为镜像数据库创建的，而是在创建后添加到镜像中的，那么就会出现错误信息提示，你无法完成操作。

Mirror的配置

这里详细介绍了主成员(Primary)和备用成员(Backup)的设置过程。 虽然也包括了异步成员配置的章节，其实我没有真的操作，我认为应该没有特别需要注意的。

配置Mirror应该有这么几步：

1. 启动Mirror服务

进入系统管理界面，选择系统管理>配置>镜像设置>启动镜像服务，勾选服务已启动， 保存退出。这是可以看到菜单栏的创建镜像条目已经从灰色变成正常的白色，表示您已经可以创建镜像。

仅仅是打开服务，并没有修改Journal文件

2. 创建镜像，添加主成员

在管理界面进入“系统>配置>镜像设置>创建镜像”，从这里开始镜像的创建工作。创建镜像的同时，这一步还包括把本机做为第一个镜像成员加入到镜像。第一个镜像成员被加入后会成为主镜像成员， 菜单里的英文是“Primary Failover Member"。

Warning: 如果本机的ISCAgent没有启动, 您会得到提示“错误 #2118: ISCAgent不在本地系统中启动”。另外，特殊情况下，您还可能会碰到错误提示：“错误 #2136: 实例的版本高于ISCAgent的版本”。

镜像的设置

如下面的截图，创建镜像需要提供这些配置信息：

• 镜像名称：可以是任意的名称, 和各个服务器/成员的名称无关。

• 需要SSL/TLS：如果您不勾选此选项，会得到“强烈建议使用SSL/TLS"的提示信息。

因为篇幅太长， 我把它分为3篇贴在社区

配置前的准备

配置Mirror前要准备三件事儿：

1. 规划网络连接。
2. 在所有的服务器中启动ISCAgent服务。
3. 准备服务器的SSL/TLS证书。可选， 但非常推荐。

我假设您在动手前一定已经对Mirror的原理和架构已经不陌生了，对镜像成员，DR(灾备)成员, Arbiter, ISCAgent等术语已经自动切换的概念有大概的认识。如果不是这样，请先阅读在线文档，或者这篇文章。

规划网络连接

Mirror应该配置两个网段：一个用于IRIS和外部的通信；另一个用于两个Mirror成员间的内部通信，也就是数据的同步。 尽管不是必须的，但Mirror作为一个高可用方案，为了保证服务器之间的内部通信不受和外部连接的干扰，把内部通信放在单独的网段是通常的做法，尤其是在生产环境。

下图来自IRIS的在线文档：其中绿色所示的是IRIS提供服务的网段，IRIS到所有外部系统的连接，ECP应用服务器，和Arbiter在工作在这个网段。紫色的“Data Center Private LAN for Mirror Communication"用于内部通信，准确的说， 用于journal的同步。为了方便， 我会在后面的步骤中简单的把这两个网段简单的称为外网网段和内网网段。

也是来自在线文档，上图的IP地址配置像这个样子。

第三十四章 在 Windows 上使用 IRIS（一）

在 Microsoft Windows 平台上管理 IRIS 数据平台实例非常简单。可以使用管理门户和 IRIS 启动器执行大多数任务。还可以从命令提示符控制 IRIS 实例。

本主题使用 install-dir 来指代 IRIS 安装目录——可以在安装指南的默认安装目录部分找到默认目录。

注意：不要对 IRIS IRIS.DAT 数据库文件使用 Windows 文件压缩。 （通过右键单击 Windows 资源管理器中的文件或文件夹并选择属性，然后选择高级，然后压缩内容以节省磁盘空间来压缩文件；压缩后，文件夹名称或文件名在 Windows 资源管理器中呈现为蓝色。）如果压缩一个IRIS.DAT 文件，它所属的实例将无法启动，并出现误导性错误。

管理对 IRIS 实例的访问

InterSystems 服务

所有 IRIS job和进程都从 InterSystems 服务、 IRIS Controller for <instance-name> 运行。 InterSystems 服务具有的权限由其关联的 Windows 用户帐户决定。当这是本地 SYSTEM 帐户时， IRIS 可以访问 Windows 系统上的所有文件和权限。为了维护一个更安全和限制性更强的环境，应该为服务选择一个仅具有所需权限和访问权限的 Windows 帐户。

此篇文章给大家介绍一个使用pyodbc连接到 InterSystems IRIS数据库的示例，详情如下：

InterSystems IRIS 安装在Redhat 操作系统中，使用pyodbc在Mac操作系统中连接到Redhat 操作系统中InterSystems IRIS数据库。

1. 下载测试代码
2. 使用vscode打开测试代码，并在Solutions文件夹下安装pyodbc
   

   pip install pyodbc

3. 在Mac操作系统中安装ODBC驱动
   

   brew update
   brew install unixodbc

4. 安装后，查看Mac操作系统中的odbcinst.ini文件，此时odbcinst.ini文件应该是空的。
5. Mac操作系统中/usr/local/bin下使用下列命令注册驱动 或者 配置DSN
   
   • 注册ODBC驱动

   odbcinst -i -d -f   pyodbc_wheel/mac/odbcinst.ini

   • 配置本地DSN

   pyodbc_wheel/mac/odbcinst.iniodbcinst -i -s -h -f odbc.ini_unixODBCtemplate

   • 配置系统DSN

   odbcinst -i -s -l -f pyodbc_wheel/mac/odbcinst.

连接前准备：

1. Python 开发环境
2. DB-API驱动：irispython wheel 文件
3. Connection String

步骤：

1. 安装irispython wheel 文件
   

   pip install intersystems_irispython-3.2.0-py3-none-any.whl

2. Connection String：其中import iris 用来导入iris， connection = iris.connect是connection string。connection.close()用来断开连接。
   

   import iris
   
   def main():
      connection_string = "localhost:1972/USER"
      username = "SQLAdmin"
      password = "deployment-password"
   
      connection = iris.connect(connection_string, username, password)
   
      # when finished, use the line below to close the connection
      # connection.

连接前准备：

1. .Net 开发环境
2. InterSystems IRIS 客户端组件:InterSystems.Data.IRISClient.dll，这个dll文件可以再IRIS安装包中找到，在IRIS/dev/dotnet/bin/version
3. Connection String

步骤：

1. 在.Net 开发环境中，配置客户端组件InterSystems.Data.IRISClient.dll作为一个dependency 
2. Connection String：其中using InterSystems.Data.IRISClient 用来导入需要使用的dll文件，string connectionString = "Server = localhost; Port = 1972; Namespace = User; User ID = SQLAdmin; Password = deployment-password"是connection string。
   

   using System;
   using InterSystems.Data.

连接前准备：

1. C++ 开发环境
2. InterSystems ODBC 驱动 （ODBC 驱动会随InterSystems IRIS安装包自动安装在服务器中）
3. Connection String

步骤：

1. Connection String：其中#include 用来导入需要使用的libraries，"Driver=InterSystems IRIS ODBC35;Host=localhost;Port=1972;Database=USER;UID=SQLAdmin;PWD=deployment-password;\0";是connection string。
   

   #ifdef WIN32
   #include <windows.h>
   #endif
   #include <sqlext.h>
   #ifdef UNICODE
   #include <sqlucode.h>
   #endif
   #include <stdio.

连接前准备：

1. Java 开发环境
2. InterSystems JDBC 驱动
3. Connection String

步骤：

1. 配置 Classpath ：指向InterSystems JDBC 驱动 - intersystems-jdbc-3.0.0.0.jar
2. Connection String，其中import com.intersystems.jdbc*;用来导入驱动，User是命名空间名称。
   

   import com.intersystems.jdbc*;
   import java.sql.Connection;
   public class JDBCConnection{
   public static void main (String[] args) throws Exception {
   String dbUrl = "jdbc:IRIS://127.0.0.1:1972/User"; //replace
   String user = "SQLAdmin";
   String pass = "deployment-password";
   
   IRISDataSource ds = new IRISDataSource();
   ds.setURL(dbUrl);
   ds.setUser(user);
   ds.

第三十三章 管理许可（六）

应用许可

应用程序许可使应用程序合作伙伴能够利用 的许可功能来实现自己的许可目的。 IRIS 像管理自己的应用程序许可证一样管理客户应用程序许可证，维护使用计数并根据需要获取和返回用户许可证。当进程退出、停止或从进程表中删除时，或者当 Web 会话超时或被删除时，进程或 Web 会话使用的应用程序许可证与进程或会话使用的 IRIS 许可证一起自动释放。

应用程序许可证只是标准 .ini 格式的文件或此类文件的一部分，包含标识应用程序的部分标题和一些keyword=value对，在许可证中是唯一的，代表许可的功能。任何格式正确的应用程序许可证都可以在运行时由应用程序加载到 IRIS。

应用程序许可 API 包括使应用程序能够代表用户使用和返回许可证的方法和查询，以及使程序能够获取有关应用程序和功能许可的信息，包括正在使用和仍然可用的许可证数量。

加载应用程序许可证

IRIS 实例可以在应用程序运行时使用 $SYSTEM.License.LoadAppLicenseFile 方法加载和激活任何应用程序许可，该方法记录在 %SYSTEM.License 的类参考中（请参阅应用程序许可 API）。以这种方式加载的应用程序许可证与活动的 IRIS 许可证无关，但由 IRIS 实例独立跟踪。

InterSystems IRIS是一个伟大的数据平台，它满足了当前市场所需的功能。在这篇文章中，你可以看到我心目中的前10大功能:

Spring Boot 是最常用来创建 REST API 和微服务的 Java 框架。 它可用于部署 Web 应用程序、可执行 Web 应用程序或桌面自包含应用程序，其中应用程序和其他依赖项打包在一起。 Spring Boot 允许执行许多功能，请参见：

注：要了解有关 SpringBoot 的信息，请参见官方网站 - https://spring.io/quickstart

要创建具有一个或多个微服务的 Web api 应用程序，可以使用 Spring IDE for Eclipse/VSCode，并使用向导配置上述将在应用程序中使用的技术，请参见：

您可以选择技术并创建项目。 所有技术都将通过 maven 导入。 它就像一个可视化的 zpm。

所创建的项目有一个类用于为应用程序提供支持，其中包含所有所需内容（Web 和应用程序服务器，以及所有依赖项、微服务概念）。

此项目的完整源代码在以下 open exchange 项目中： https://openexchange.intersystems.com/package/springboot-iris-crud。

首先要配置 IRIS JDBC 驱动程序和 IRIS Hibernate 支持，为此，请将 jar 文件复制到 resources 文件夹，请参见：

打开 pom.

关于微服务架构（MSA）的IRIS定位的初学者指南。MSA在企业级Java世界中的能见度越来越高，因此，了解这股热潮背后的内容是至关重要的。我尝试着写下我的观点并与大家分享。

背景

首先，我必须承认。今年初夏，我的同事要求我收集一些关于匈牙利开发的医疗产品的信息。当我从相关公司得到反馈时，发现该产品是一个模块化系统，基于微服务架构（MSA）。好的。什么是MSA？在网上做了简短的研究，阅读了一些WIKI网页后，我得出结论：啊哈，又是一个 "架构"。我们可以用IRIS在 "架构层面 "遵守 "任何架构"--至少 "在某种程度上"。但也有一些恼人的地方。这让我对MSA有了更多的了解。到目前为止还不错，但是REST不是这篇文章的主要话题吗？MSA和REST之间的关系是什么？我访问的几乎每个网站都在例子中使用了RESTful网络服务。这让我有点怀疑。但总的来说，我赞同对MSA的一般总结：它是SOAP但做得很好。特别是因为有一些关于 "内聚 "和 "耦合 "的句子，我完全不明白。那么，如果MSA只是 "SOAP做得好"，为什么我没有看到SOAP的例子？为什么这些例子（几乎）都是RESTful？

在这个问题之前，对我来说，"REST "是一个使用JSON序列化数据交换的网络服务，通过HTTP传输。但是在那个时候，我脑子里有太多的问题，因此我开始阅读REST文献。很快我就找到了起源。

如果你读了我之前介绍QEWD微服务的文章，希望你会渴望了解如何使用它们。  所以在这篇文章中，我将解释你需要知道的东西，以便开始使用。

如果你在QEWD资源库中，你会发现目录: 

  https://github.com/robtweed/qewd/blob/master/example/jwt

在我之前关于JSON网络令牌（JWTs）和QEWD的文章中，我用这个示例应用程序来解释如何使用JWTs。  这个示例应用程序还演示了如何设置一个简单的微服务，在这种情况下是一个处理用户认证的服务。  所以，现在让我深入了解一下这个例子应用程序的这方面内容。

如果你想使用QEWD微服务，你也必须使用JWTs--它们提供了一种方法，用户的认证和会话可以被多个独立的QEWD服务器交叉通信和处理。  因此，请看一下启动文件:

   https://github.com/robtweed/qewd/blob/master/example/jwt/startup_file/q….

第三十二章 管理许可（五）

Identifying Users

IRIS 许可系统识别不同的用户并为每个用户分配一个许可单元。用户由许可证用户 ID 标识，该 ID 可以是 IP 地址、用户名、Web 会话 ID 或其他标识符，具体取决于用户的连接方式。

由单个用户启动或为单个用户启动的多个进程共享一个许可证单元，最多可达每个用户的最大进程数。如果进程数超过此最大值，则会发生转换 IRIS 开始为该用户 ID 的每个进程分配一个许可单元。系统假设如果与用户 ID 关联的进程数超过最大值，则多个用户正在通过中介（例如防火墙系统）访问 IRIS，因此需要额外的许可证单元。 （由 Job 命令启动的进程计入调用该命令的用户 ID 下。）

即使用户 ID 下的进程数回落到最大值以下， IRIS 仍会继续为该用户 ID 的每个进程分配一个许可单元。只有当用户 ID 的所有连接都关闭并且用户 ID 下没有更多进程时，许可证分配才会重置为该用户 ID 的一个单位。

通过名称识别用户的应用程序消除了与使用基于客户端 IP 地址、Web 会话 ID 或其他连接派生用户 ID 的默认用户 ID 相关的问题。

例如，当使用防火墙或终端服务器软件时， IRIS 无法区分连接用户，因此它依赖于最大连接转换规则。使用来自同一客户端的混合连接也使得无法使用自动 ID 创建适当地计算用户数。

研究Healthshare2018在已经安装完成使用的情况下，部署IIS，并代理平台。之前看到可以通过单独的CSP Gateway安装包进行处理这种问题，该文主要是获取不到该安装包的时候可以如何实现IIS的处理。

第一步:首先按照网上教程部署IIS服务。安装完成之后会在C盘创建一个名叫intepub的包。

第二步:在inetpub包下面直接插入CSPGateway 。这个包是在其他先安装IIS下，后安装Healthshare的CSP网关服务的时候在inetpub下面自动插入的包，直接找一个复制过来。

第三步:打开IIS，创建一个叫csp的网站，按照下图配置。

   第四步:在点击模块进行CSPms模块的添加。
 

接下来是配置好的CSPms的模块。
 

注意:我们从图中看到的CSPms模块是本机继承的模块，我们在右边添加本机模块的时候并不能找到C:\inetpub\CSPGateway\CSPms.dll这个模块，导致加不进去。那我们就直接在配置文件上面改。找到C:\Windows\System32\inetsrv\config该文件路径下的applicationHost.config文件，为了稳妥起见，我们先备份一下该文件。
找到<globalModules>节点，在下面加入<add name="CSPms" image="C:\Inetpub\CSPGateway\CSPms.

1. 从消息查看器看到清除周期以外的消息没有被正常清除

这种情况先抽查这些消息所处的会话中是否有未完成操作周期的消息（状态为除“Completed”“Error”“Discarded”之外的状态）。如有，且定期清除任务配置了“KeepIntegrity”，且该环境并不需要保留这些消息，可通过关闭清除任务中的“KeepIntegrity”配置清除这些会话和包含的消息。如果有这类消息，但是定期清除任务未配置“KeepIntegrity”，可能是定期清除任务的逻辑或消息数据问题导致清楚任务查找的时候没有覆盖这些消息，请联系WRC帮助排查具体原因。

有关定期清除任务的更多信息请参见文档

Purging Production Data | Managing Productions | InterSystems IRIS for Health 2022.1

2. 从消息查看器看不到清除周期之外的消息，但是^%GSIZE显示有global占据了很大的磁盘空间

这种情况需要具体排查每个较大的global。可能有以下原因：

• 系统定义的global占用很大空间。您可以联系WRC帮助排查具体原因。
• 自定义的global占用很大空间。这可能是消息中嵌套的持久化数据或流数据，或者是和消息没有直接关系的独立的表里面的数据。请对创建这种global的代码进行复盘，找到创建逻辑并增加相应的数据管理逻辑。

1. 系统文件

系统文件根据版本不同，大约会占用1GB左右的空间。这部分空间是不能省略的，随意删除文件会导致实例无法正常运行。

2. 备份文件

备份文件应及时转存到另外的磁盘或磁盘分区上，不应与.DAT数据库占用相同的磁盘分区。

3. Journal日志

Journal日志文件存储路径应设置为与.DAT数据库存储路径不同的磁盘或磁盘分区上，不应与.DAT数据库占用相同的磁盘分区。

4. 消息存储

因为HSHC集成平台设计上不支持过多的消息存储，用户应该为每个有消息流量的命名空间配置定期消息清除任务。

定义消息清除任务时 “BodiesToo”默认是没有选择的，需要手动选择。系联软件研发核心认为我们的软件不能在客户不知情的情况下自动删除客户自定义的数据，消息也属于客户自定义的数据，所以默认选项只会删除Message Header，不会删除消息本身。但是保留默认值运行清除消息任务就会导致孤立消息（指不存在配套Message Header的消息对象）的问题。BodiesToo=0也是孤立消息产生的主要原因之一。有关孤立消息的常见问题会在之后的文章做进一步讨论。

另一个消息清除任务选项“KeepIntegrity”默认是打开的。如果您需要保留“Queued”，“Suspended”，“Deferred”等未完成所有操作的消息，请保持打开。如果不需要可以关闭。

[toc]

第三十一章 管理许可（四）

显示本地许可证信息的方法

下面列出的子例程转储实例共享内存中本地包含的许可证表的内容。一般来说，他们识别客户：

$System.License.DumpLocalAll 将所有本地许可证表条目转储到当前目录中的 all.dmp 文件中：

USER> Do $System.License.DumpLocalAll()
 
25 条目转储到 c:\intersystems\irishealth\mgr\user\all.dmp

all.dmp 文件的内容示例：

$System.License.DumpLocalInUse 将所有正在使用的本地许可证表条目转储到当前目录中的 inuse.dmp 文件：

USER> Do $System.License.DumpLocalInUse()
 
2 条目转储到 c:\intersystems\irishealth\mgr\user\inuse.dmp

inuse.dmp 文件内容示例：

$System.License.DumpLocalPID 将进程 ID 使用的本地许可证表转储到当前目录中的 piduse.dmp 文件中：

USER> Do $System.License.DumpLocalPID()
 
33 条目转储到 c:\intersystems\irishealth\mgr\user\piduse.

医疗科技市场正处于强劲的演变之中。Gartner的医疗科技的波浪图展示了这些技术是什么，非常好地反映了医疗行业的数字化趋势。

其中很多技术都可以使用InterSystems的技术（ISC Health Tech）来实现:

知情同意管理使用InterSystems Healthshare Stack来做患者主索引和知情同意管理。

Globals是InterSystems IRIS的数据持久性的核心。它很灵活，允许存储JSON文档、关系数据、面向对象的数据、OLAP立方体和自定义数据模型，例如思维导图。要了解如何使用globals来存储、删除和获取思维导图数据，请遵循以下步骤:

1. 把repo Clone/git到任意本地目录

$ git clone https://github.com/yurimarx/global-mindmap.git

2. 在该目录下打开Docker 终端并执行:

$ docker-compose build

3. 启动 IRIS 容器:

$ docker-compose up -d

4. 访问 http://localhost:3000 来使用思维导图的前端并创建类似以上的思维导图

本例子的源代码

存储数据 (更多请访问: https://www.npmjs.

//迭代取值
IRISIterator subscriptIter = irisNative.getIRISIterator("^liubo.clazz.personD");
System.out.println("================迭代开始===================");
while (subscriptIter.hasNext()) {
    String subscript = subscriptIter.next();
    //此处怎么获取此节点的字符串进行解析呢，另外java可以直接访问ensemble的global么

    System.out.println(node);

}

如果你在你发布在应用市场上的应用程序中使用代码质量分析器，这将显示在Open Exchange上。

1. 在Open Exchange 应用市场主页面，你可以过滤所有通过ObjectScript质量测试的应用程序

2. 在公众的应用页面（例子），你会在信息框中看到：

3. 在你管理应用程序的页面上，你会看到质量检查状态。

没有数据 - 如果质量检查没有安装在你的 repo 中
通过 - 如果代码通过了测试
失败--如果测试失败。这不会显示在公共应用程序页面上。

现在你可以在Open Exchange社区的objectscriptQuality上找到要添加到你的 repo中的文件。

针对InterSystems开发者社区的分析。使用InterSystems IRIS BI (DeepSee)、Power BI和Logi Report Designer制作的项目，可视化并分析InterSystems 开发者社区上的成员、文章、问题、答案、观点和其他内容和活动。

你可以看到自己的活动、文章和问题。跟踪你的贡献如何改变开发者社区。

使用IRIS BI、Adaptive Analytics、InterSystems Reports、Tableau和Power BI分析关于你和你朋友的统计数据。

该项目包含预配置的IRIS和Atscale在Docker容器中的部署以及BI系统的项目文件。

更多细节信息请见相应应用的README。

这个项目也支持在线部署，你可以在这里查看。

Hi 我在线部署了一个demo演示:

https://production-monitor.demo.community.intersystems.com/csp/user/EnsPortal.ProductionConfig.zen?PRODUCTION=dc.Demo.Production#

我更新了几个设置（文件路径和URL），并将调度类切换到dc.rest.GenericService。

我从文件服务重新发送了消息。我看到授权Auth和API服务都收到了消息。

API进程（还）没有返回所需的响应。更多内容请继续关注...

  大家都用过IRIS的消息查看器吧，其实这个页面有一个隐藏的功能，就是显示【显示查询】，如图所示：

那么这个东西是如何打开的呢？如果一句话概括就是: Terminal下输入: Set ^Ens.Debug("UtilEnsMessages","sql")=1，这个也是打开这个功能的思路，下面是详细的说明。

开启功能的步骤：

    1、进入Terminal，输入用户名\密码；

  2、进入需要打开显示查询的命名空间：如 zn "BKIP"

  3、执行 【Set ^Ens.Debug("UtilEnsMessages","sql")=1】打开显示查询。

打开消息查看器页面刷新：

成功！！！ 

他有什么作用呢？举个栗子，当我修改基本条件为会话开始，点击【搜索】然后再点击【显示查询】

可以看到刚才在页面点击的操作生成了SQL并且显示在新的弹框里面了 すごい（四个一）。

基于此我们能做什么呢？

任何技术总是有些自己独特的术语，尤其是一些英文术语，对于新的用户来说往往即陌生又迷惑。这里整理了一下常听到的InterSystems术语，帮助大家尽快进入InterSystems技术圈子。

第二十九章 管理许可（二）

激活许可证密钥

IRIS 使用许可证密钥来确保其注册站点的正常运行、定义可用容量并控制对 IRIS 功能的访问。 许可证密钥以许可证密钥文件的形式提供，通常命名为 iris.key。

安装 IRIS 后，使用以下程序激活许可证密钥。始终可以使用相同的过程为任何已安装的实例激活新的许可证密钥（即升级密钥）。可以激活放置在管理门户可访问的任何位置的许可证密钥；作为激活的一部分，许可证密钥将作为 iris.key 复制到实例的 install-dir/mgr 目录（如果尚未命名）。

注意：也可以在 Windows 安装期间选择许可证密钥。执行此操作时，许可证会自动激活，并且许可证密钥会作为 iris.key 复制到实例的 install-dir/mgr 目录中；不需要此处描述的激活过程。

本节还讨论了许可证故障排除和在所有许可证单元都在使用时从操作系统命令行升级许可证。

要激活许可证密钥，请使用以下过程：

1. 导航到许可证密钥页面（系统管理 > 许可 > 许可证密钥）。将显示有关当前活动许可证密钥的信息。如果尚未激活任何许可证，则会显示这一点，例如通过标记客户名称：缺少许可证或不可读。此页面包含一个打印按钮，可让轻松打印显示的信息。

2. 单击激活许可证密钥并浏览到要激活的许可证密钥文件。