高级 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>

返回页首

另请参见：