分享此页面

# 高级 Quality Insight 配置

此部分包括一些高级 Quality Insight 配置。

在本主题中︰

## 监控索引状态

首次为大型项目编制索引可能需要几个小时。安装 Quality Insight 后更改数据位置将需要与初始索引相似的时间，因为所有数据都将被重新索引并且索引过程将重新开始。您可能想要监控索引过程的进度。

要监控索引过程的状态，请执行以下操作:

1. 向 URL 发送 HTTP GET 请求:

       http://<Quality Insight 服务器>:<端口>/alm-fetcher-service/api/health/

2. 索引过程完成后，状态会从 "`RUNNING`" 变为 "`WAITING`"。这表明索引已完成，正在等待下一次汇集新数据。每几个小时，系统会查询是否有新数据要编制索引。

   备注: 当 `_nextRuntime` 的值不是 "`-1`" 时，表示索引过程已完成，项目数据准备就绪，可使用 Quality Insight 进行搜索。(如果 `_nextRuntime` 为 "`-1`"，这表示索引尚未开始或仍在进行中，并且第一次尚未完成。)

返回页首

## (可选，仅适用于 Windows) 修改 Quality Insight 配置

安装 Quality Insight 后，您可以根据需要修改配置设置，例如数据位置或 ALM 服务器 URL。

例如，您可能决定将数据存储在共享位置或安装目录之外的文件夹中，以防止在 Quality Insight 升级或卸载时将其删除。

备注: 更改配置设置可能会导致停机一段时间，直到 Quality Insight 服务重新启动。如果在安装 Quality Insight 后更改数据位置，所有数据都将被重新索引。索引过程将重新开始，所花费的时间与第一次索引项目时相似。

要修改和更新 Quality Insight 配置，请执行以下操作:

1. 从 Windows 的“开始”菜单中，选择“所有程序”>“Micro Focus”>“Quality Insight”-“更新配置”。

   将打开“Quality Insight - 配置”页面。

2. 编辑所需的设置。

3. 单击“保存”。Quality Insight 服务重新启动。

   您可能需要等待一段时间才能使用 Quality Insight。将显示一条消息，指示 Quality Insight 服务已准备就绪。

返回页首

## (可选，仅适用于 Windows) 更改运行 Quality Insight 服务的用户

默认情况下，Quality Insight 服务由本地系统用户运行。您可以将运行 Quality Insight 服务的用户更改为其他 Windows 用户。确保 Windows 用户具有运行服务的权限。

备注: 如果您决定更改存储 Quality Insight 数据的位置，例如更改为共享位置，请确保运行 Quality Insight 机器的 Windows 用户具有访问指定位置的权限。

要更改 Quality Insight 服务用户，请执行以下操作:

1. 在运行 Quality Insight 的机器上，按 Win+R，然后在“运行”命令框中，键入 services.msc 并按 Enter。将打开“服务”窗口。

2. 停止 MF Quality Insight 和 MF Quality Insight ES 服务。
3. 双击每个服务。将打开“搜索属性”对话框。
4. 在“登录”选项卡中，更改每个服务的用户。
5. 启动这两个服务。

返回页首

## 通过 SSL 或 HTTPS 运行 Quality Insight

安装 Quality Insight 后，您可以在 Quality Insight 服务器上配置信任。当 Quality Insight 通过 HTTPs 协议连接到 ALM 服务器时，这是必需的操作。

要通过 SSL 或 HTTPS 运行 Quality Insight，请执行以下操作:

1. 使用您的证书链准备密钥库文件并将其放置在相关文件夹中 (例如，`<Quality Insight 安装路径>\apache-tomcat-9.0.22\conf`)。要了解更多信息，请参阅证书颁发机构 (CA) 文档。
2. 将 Apache Tomcat 配置为使用 HTTPS:
   1. 导航到 `<Quality Insight 安装路径>\apache-tomcat-9.0.22\conf` 并打开 `server.xml`。

   2. 添加以下内容:

      Copy code

          <Connector port="8443" protocol="org.apache.coyote.http11.Http11NioProtocol"
          maxThreads="150" SSLEnabled="true" scheme="https" secure="true"
          clientAuth="false" sslProtocol="TLS" keystoreFile="conf/keystore.jks" keystorePass="changeit"
          sslEnabledProtocols="TLSv1,TLSv1.1,TLSv1.2"/>

      下表描述了以上属性:

      属性 | 描述
      --- | ---
      port | 将用于从 ALM 连接的 SSL 端口
      protocol | 有关协议的详细信息，请参阅 Apache Tomcat 文档
      keystoreFile | 密钥库的路径
      keystorePass | 密钥库的密码
      sslEnabledProtocols | 允许的 SSL 协议

3. 将 ALM 中使用的主证书、中间证书和 CA 证书添加到 Quality Insight 密钥库。默认位置是 `<JDK 安装路径>\jre\lib\security\cacerts`。

   - Windows

     Copy code

         "%JAVA_HOME%\bin\keytool" -import -trustcacerts -alias mydomain -file certificate.crt -keystore "<JDK 安装路径>\jre\lib\security\cacerts"

   - Linux

     Copy code

         "%JAVA_HOME%/bin/keytool" -import -trustcacerts -alias mydomain -file certificate.crt -keystore "<JDK 安装路径>\jre\lib\security\cacerts"

4. 重新启动 Quality Insight 并验证安装:

       https://<Quality Insight 服务器>:<端口>/iris-service/

   将显示一条消息，确认配置正确。

5. 将 Quality Insight 中使用的主证书、中间证书和 CA 证书添加到 ALM 密钥库。默认位置是 `<JDK 安装路径>\jre\lib\security\cacerts`。

   - Windows

     Copy code

         "%JAVA_HOME%\bin\keytool" -import -trustcacerts -alias mydomain -file certificate.crt -keystore "<JDK 安装路径>\jre\lib\security\cacerts"

   - Linux

     Copy code

         "%JAVA_HOME%/bin/keytool" -import -trustcacerts -alias mydomain -file certificate.crt -keystore "<JDK 安装路径>\jre\lib\security\cacerts"

6. 重新启动 ALM 并使用 SSL 配置 Quality Insight。

   有关更多详细信息，请参阅 https://tomcat.apache.org/tomcat-8.0-doc/ssl-howto.html。

返回页首

## 更改 Quality Insight 的启动同步时间

只有上次修改日期晚于 Quality Insight 启动同步时间的数据才会从 ALM 服务器同步到 Quality Insight 服务器，然后由 Quality Insight 获取。默认情况下，启动同步时间为 2020-01-01 00:00:00。

要更改 Quality Insight 的启动同步时间，请执行以下操作:

1. 更新 `alm-fetcher-service.properties` 文件中的 `alm.fetch.initial.date`，该文件位于 `{安装路径}\apache-tomcat-9.0.22\webapps\alm-fetcher-service\WEB-INF\classes` 目录。

   新日期格式应与默认日期相同: `YYYY-MM-DD HH:MM:SS`。

1. 对于 Windows: 打开 Windows 服务，然后重新启动 MF Quality Insight 服务。

   对于 Linux: 使用以下命令停止和启动 Quality Insight 服务:

   Copy code

       service <MF_QI> <start / stop>

返回页首

## 更改 Quality Insight 的服务器端口

安装后，Quality Insight 的服务器端口为 8080。如果 8080 已被占用，则应更改 Quality Insight 的服务器端口。

对于 Windows:

1. 更新 `alm-fetcher-service.properties` 文件中的端口号，该文件位于 `{安装目录}\apache-tomcat-9.0.22\webapps\alm-fetcher-service\WEB-INF\classes` 目录。

   Copy code

       <Server port="8005" shutdown="SHUTDOWN">
          <Service name="Catalina">
            <Connector port="8080" protocol="HTTP/1.1" connectionTimeout="20000"
              redirectPort="8443" />

   默认情况下，路径为 `C:\Program Files\MicroFocus\QualityInsight\apache-tomcat-9.0.22\webapps\alm-fetcher-service\WEB-INF\classes\alm-fetcher-service.properties`。

2. 更新 `server.xml` 文件中的端口号，该文件位于 `{安装路径}\apache-tomcat-9.0.22\conf` 目录。

   Copy code

       iris.server.url=http://localhost:8080

   默认情况下，路径为 `C:\Program Files\MicroFocus\QualityInsight\apache-tomcat-9.0.22\conf\server.xml`。

对于 Linux:

1. 更新 `alm-fetcher-service.properties` 文件中的端口号，该文件位于 `{安装路径}/apache-tomcat-9.0.22/webapps/alm-fetcher-service/WEB-INF/classes` 目录。

   Copy code

       Server port="8005" shutdown="SHUTDOWN">
          <Service name="Catalina">
            <Connector port="8080" protocol="HTTP/1.1" connectionTimeout="20000"
              redirectPort="8443" />

   默认情况下，路径为 `/var/opt/MicroFocus/QualityInsight/apache-tomcat-9.0.22/webapps/alm-fetcher-service/WEB-INF/classes/alm-fetcher-service.properties`。

2. 更新 `server.xml` 文件中的端口号，该文件位于 `{安装路径}/apache-tomcat-9.0.22/conf` 目录。

   Copy code

       iris.server.url=http://localhost:8080

   默认情况下，路径为 `/var/opt/MicroFocus/QualityInsight/apache-tomcat-9.0.22/conf/server.xml`。

返回页首

## 配置与 Quality Insight 同步的实体字段

您可以定义哪些实体字段从 ALM 服务器同步到 Quality Insight 服务器。默认情况下，部分需求字段和其他实体类型的所有字段是同步的。

要定义同步哪些实体字段，请执行以下操作:

1. 打开位于 `{安装路径}\apache-tomcat-9.0.22\webapps\alm-fetcher-service\WEB-INF` 目录中的 `alm-fetcher-service-application-context.xml` 文件。

2. 找到您要指定其字段的实体类型的 `<util:list>` 元素。

   Example: 如果要为缺陷实体类型指定字段，请找到以下元素。

       <util:list id="defect-alm-fields" list-class="java.util.ArrayList" value-type="java.lang.String">
       </util:list>

3. 在目标 `<util:list>` 元素中，添加要同步到 Quality Insight 的字段的名称。

   备注: 实体字段名称不一定与字段标签相同。要获取字段名称，请执行以下操作:

   1. 调用 REST API: `GET/qcbin/rest/domains/{domain}/projects/{project}/customization/entities/{entity name}/fields`。

   2. 字段的名称是 Field 元素的 Name 属性的值。

      例如，`<Field Label="Author" Name="owner" PhysicalName="RQ_REQ_AUTHOR">`。“作者”字段的字段名称为“所有者”。

   Example: 如果要将缺陷字段 (例如“实际修复时间”、“分配给”、“关闭日期”和“检测者”) 同步到 Quality Insight，则应将以下值添加到缺陷实体类型的 `<util:list>` 元素。

       <util:list id="defect-alm-fields" list-class="java.util.ArrayList" value-type="java.lang.String">
         <value>actual-fix-time</value>
         <value>owner</value>
         <value>closing-date</value>
         <value>detected-by</value>
       </util:list>

4. 重新启动 MF Quality Insight 服务。

   对于 Windows: 打开 Windows 服务，然后重新启动 MF Quality Insight 服务。

   对于 Linux: 使用以下命令停止和启动 Quality Insight 服务:

   Copy code

       service <MF_QI> <start / stop>

5. 通过重建控制面板卡重新索引数据。请参阅重建控制面板卡。

返回页首

## 设置 KPI 卡的最大数量

您可以在“Quality Insight”>“执行控制面板”中定义每个用户可以创建的 KPI 卡的最大数量。默认情况下，用户最多可以创建 100 个 KPI 卡。

要设置 KPI 卡的最大数量，请执行以下操作:

1. 打开位于 `{安装路径}\apache-tomcat-9.0.22\webapps\iris-service\WEB-INF\classes` 目录中的 `iris.properties` 文件。

2. 更新 `iris-service.search.page-size.limit` 参数的值。

3. 重新启动 MF Quality Insight 服务。

   对于 Windows: 打开 Windows 服务，然后重新启动 MF Quality Insight 服务。

   对于 Linux: 使用以下命令停止和启动 Quality Insight 服务:

   Copy code

       service <MF_QI> <start / stop>

返回页首

另请参见：

- 卸载 Quality Insight

https://admhelp.microfocus.com ALM 8942
改进搜索结果的提示... ALM 帮助中心 ALM 帮助中心 ALM 帮助 17.0 全部查看本地帮助中心查看联机帮助中心后退在浏览器历史记录中后退前进在浏览器历史记录中前进删除突出显示的搜索项下一个主题转到下一个主题上一个主题转到上一个主题打印当前主题版本: