[17.0.0.1 and later]

IBM CloudProduct 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 CloudProduct 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 CloudProduct 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>"/>
    • Product Insights 서비스를 작성할 때 메모해 둔 API 호스트 및 키 신임 정보를 urlapiKey 속성에 지정하십시오. Product Insights 게이트웨이를 설치한 경우 url 속성에 게이트웨이 URL을 대신 지정하십시오.
    • 정의한 ssl 요소의 ID를 sslRef 속성에서 참조하십시오.
    • 선택적 groups 속성의 경우 보고용으로 그룹화할 Liberty 서버 세트를 정의할 수 있습니다. 복수의 중첩된 그룹 레벨을 정의할 수 있으며, 다음 예제와 같이 그룹 이름을 쉼표로 구분하여 각 Liberty 서버를 복수의 그룹에 포함시킬 수 있습니다.
      groups="libertyGroup1, libertyGroup1/subgroupA, subgroupA/smallGroupx"
      이 예제에서 smallGroupxlibertyGroup1 내에 중첩된 subgroupA 내에 중첩됩니다. 최상위 레벨 그룹은 슬래시(/) 없이 지정하십시오. 중첩 그룹은 슬래시와 함께 지정하십시오(예: parentGroup/nestedGroup). 그룹화된 서버는 Product Insights 서비스에 계층 구조로 표시됩니다.
    • 게이트웨이를 사용하고 있지 않으며 Liberty 서버가 인터넷에 직접 액세스할 수 없는 경우, proxyUrl, proxyUserproxyPassword 속성에 HTTP 프록시를 정의하십시오. 프록시 URL은 http://hostname:port 형식이어야 하며, HTTP 프록시 서버를 인증해야 하는 경우에만 프록시 사용자 이름과 비밀번호가 필요합니다.

      Liberty가 인터넷에 액세스할 수 있거나 게이트웨이를 통해 데이터를 라우팅하는 경우에는 프록시 설정을 정의할 필요가 없습니다.

결과

IBM Cloud 콘솔에서 등록된 서버를 보려면 메뉴 (☰) > 대시보드로 이동하고 Product Insights 서비스 인스턴스를 선택하십시오. 등록된 서버가 서비스의 관리 탭에 나열됩니다.

Liberty 서버에서 사용 메트릭을 보고하는 작업을 중지하려면 해당 서버의 구성에서 productInsights 구성을 제거하십시오.


주제의 유형을 표시하는 아이콘 태스크 주제

파일 이름: twlp_config_blmx_productinsights.html