[17.0.0.1 以及更新版本]

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 file。這個檔案含有來自已知憑證管理中心的憑證。

    將您所選配置的金鑰儲存庫檔副本,放在您想登錄之每一部伺服器的 ${server.config.dir}/resources/security 目錄中。

  • 在 Liberty 安裝架構中,使用 installUtility 指令來安裝 productInsights-1.0 特性。如需相關資訊,請參閱使用 installUtility 指令來安裝資產
    重要: 如果您的 Liberty 安裝架構無法直接存取網際網路,則必須配置 installUtility 指令的 Proxy 設定,以便從線上 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 元素中,指定 ID,並參照您的配置的金鑰儲存庫檔,可以是閘道的憑證或是 digicert.jks 檔,如開始之前中所述。
    • ssl 元素中,指定 ID,並參照您所定義之 keyStore 元素的 ID。如需 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 元素的 ID。
    • 對於 groups 選用屬性,您可以定義多組 Liberty 伺服器,來加以分組,以方便報告。您可以定義多個巢狀群組層次,並以逗點來區隔群組名稱,以便將每一部 Liberty 伺服器包含在多個群組中,如下列範例所示。
      groups="libertyGroup1, libertyGroup1/subgroupA, subgroupA/smallGroupx"
      在本例中,smallGroupx 以巢狀方式放置於 subgroupA 內,而 subgroupA 也以巢狀方式放置於 libertyGroup1 內。如果要指定最高層次的群組,則不含正斜線 (/)。如果要指定巢狀群組,請使用正斜線,例如:parentGroup/nestedGroup。已分組的伺服器會在 Product Insights 服務中以階層方式顯示。
    • 如果您沒有使用閘道,且 Liberty 伺服器無法直接存取網際網路,請在 proxyUrlproxyUserproxyPassword 屬性上定義 HTTP Proxy。Proxy URL 必須是 http://hostname:port 格式,並且只有在您的 HTTP Proxy 伺服器需要鑑別時,才需要 Proxy 使用者名稱和密碼。

      如果 Liberty 能夠存取網際網路,或者您是透過閘道來遞送資料,就不需要定義 Proxy 設定。

結果

如果要在 IBM Cloud 主控台檢視已登錄的伺服器,請移至功能表 (☰) > 儀表板,然後選取 Product Insights 服務實例。您已登錄的伺服器會列在服務的管理標籤上。

如果要停止從 Liberty 伺服器報告使用情形度量,請將 productInsights 配置從該伺服器的配置中移除。


指示主題類型的圖示 作業主題

檔名:twlp_config_blmx_productinsights.html