[17.0.0.1 and later]

IBM Cloud 上的 Product Insights 服务注册 Liberty 服务器

通过配置 productInsights-1.0 功能部件,可注册本地的或基于云的 Liberty 服务器以向 IBM® Cloud Product Insights 服务报告使用情况指标。

开始之前

  • 创建 Bluemix® 帐户。要创建帐户,请参阅注册 IBM IBM Cloud
  • 决定是否通过 Product Insights 网关路由报告的服务器数据,可从 IBM developerWorks® 上的 IBM Cloud Product Insights 了解和安装此网关。通过网关路由数据,可在将数据发送到 Product Insights 服务之前查看数据。
    是否使用网关影响配置到 IBM Cloud 上的 Product Insights 服务的 SSL 通信的方式:
    • 如果安装网关,那么必须使用来自 Product Insights 网关的服务器证书。有关此证书的信息,请参阅 developerWorks 上的 IBM Cloud Product Insights 文档。
    • 如果不使用网关,请从 IBM Cloud 下载 digicert.jks 文件。 此文件包含来自已知认证中心的证书。

    将所选配置的密钥库文件的副本放置在要注册的每个服务器的 ${server.config.dir}/resources/security 目录中。

  • 在 Liberty 安装中,通过使用 installUtility 命令安装 productInsights-1.0 功能部件。有关更多信息,请参阅使用 installUtility 命令安装资产
    要点: 如果 Liberty 安装无法直接访问因特网,必须针对 installUtility 命令配置代理设置,以从联机 IBM WebSphere® Liberty Repository 安装。

关于此任务

IBM Cloud 上的单个 Product Insights 服务,可跟踪在内部、IBM Cloud 中或其他云环境中托管的很多 Liberty 服务器。Liberty 服务器向 Product Insights 服务实例注册时,此服务器连接到 IBM Cloud 上的服务,并定期报告以下使用情况指标。
  • 活动 Liberty 服务器数
  • 每个服务器的主机位置
  • 每个服务器的产品修订版和版本
  • 每个服务器的繁忙程度

仅您和您对其授予 IBM Cloud 权限的其他用户可以控制 Product Insights 服务实例。

有关更多信息,请参阅 IBM developerWorks 上的 IBM Cloud Product Insights

过程

  1. IBM Cloud 控制台中创建 Product Insights 服务的实例。

    由于服务可跟踪很多 Liberty 服务器,因此仅需要一个服务实例。

    1. IBM Cloud 目录中,搜索 Product Insights 服务或在服务 > 集成下选择服务。
    2. 在生成的页面上,可选择更改缺省服务名称,然后单击创建
    3. Product Insights 服务中,转至服务凭证,并针对显示的其中一个凭证选择查看凭证

      记录创建的 Product Insights 服务的 API 主机和 API 密钥。此信息将添加到 Liberty 服务器配置以向特定服务实例注册服务器。

  2. 在要注册的 Liberty 服务器的 server.xml 配置文件中,添加 productInsights-1.0 功能部件。
    <featureManager>
      <feature>productInsights-1.0</feature>
    </featureManager>
  3. 在服务器配置中,为 Liberty 服务器和 IBM Cloud 上的 Product Insights 服务之间的 SSL 通信定义密钥库和信任库。
    <keyStore id="productInsightsKeyStore" location="keystorefile.jks" type="JKS"/>
    <ssl id="productInsightsSSL"
      keyStoreRef="productInsightsKeyStore"
      trustStoreRef="productInsightsKeyStore"
      sslProtocol="TLSv1.2"/>
    • keyStore 元素中,指定标识并引用配置的密钥库文件,此文件为网关的证书或者 digicert.jks 文件,如开始之前中所述。
    • ssl 元素中,指定标识并引用您所定义的 keyStore 元素的标识。有关 SSL 配置的更多信息,请参阅SSL 配置属性
  4. productInsights 元素上配置 Product Insights 服务。
    <productInsights url="<apiHost_or_gatewayURL>" apiKey="<apiKey>" sslRef="productInsightsSSL" groups="<groupName>"
           proxyUrl="<proxyURL>" proxyUser="<proxyUserName>" proxyPassword="<proxyPassword>"/>
    • urlapiKey 属性上,指定创建 Product Insights 服务时记录的 API 主机和密钥凭证。如果安装了 Product Insights 网关,请改为在 url 属性上指定网关的 URL。
    • sslRef 属性上,引用定义的 ssl 元素的标识。
    • 对于可选的 groups 属性,可以定义 Liberty 服务器集以将其分组以便于报告。您可以定义多个嵌套组级别,可以将每个 Liberty 服务器包括在多个组中,组名之间用逗号分隔,如以下示例所示。
      groups="libertyGroup1, libertyGroup1/subgroupA, subgroupA/smallGroupx"
      在此示例中,smallGroupx 嵌套在 subgroupA 中,而 subgroupA 又嵌套在 libertyGroup1 中。请指定最高级别的组,没有正斜杠 (/)。指定嵌套的组,具有正斜杠,例如 parentGroup/nestedGroup。分组的服务器以分层方式在 Product Insights 服务中显示。
    • 如果未使用网关且 Liberty 服务器无法直接访问因特网,请在 proxyUrlproxyUserproxyPassword 属性上定义 HTTP 代理。代理 URL 必须为 http://hostname:port 格式,仅当 HTTP 代理服务器需要认证时,才需要代理用户名和密码。

      如果 Liberty 具有因特网访问权或您将通过网关路由数据,那么不需要定义代理设置。

结果

要在 IBM Cloud 控制台中查看已注册服务器,请转至 菜单 (☰) > 仪表板,并选择 Product Insights 服务实例。已注册的服务器在服务的管理选项卡上列出。

要停止从 Liberty 服务器报告使用情况指标,请从此服务器配置移除 productInsights 配置。


用于指示主题类型的图标 任务主题

文件名:twlp_config_blmx_productinsights.html