[17.0.0.1 and later]

Registro de servidores de Liberty en el servicio de Product Insights en IBM Cloud

Al configurar la característica productInsights-1.0, se puede registrar el servidor local o basado en la nube de Liberty para notificar as métricas de uso del servicio IBM® Cloud Product Insights.

Antes de empezar

  • Cree una cuenta de IBM Cloud. Para crear la cuenta, consulte Registro en IBM IBM Cloud.
  • Decida si se deben direccionar los datos notificados del servidor mediante la pasarela de Product Insights, sobre la que puede obtener información y que puede instalar desde IBM Cloud Product Insights en IBM developerWorks. Direccionando los datos mediante la pasarela, puede revisar los datos antes de enviarlos al servicio de Product Insights.
    Si se utiliza o no la pasarela afecta a cómo se configura la comunicación SSL al servicio de Product Insights en IBM Cloud:
    • Si instala la pasarela, debe utilizar el certificado de servidor desde la pasarela de Product Insights. Para obtener información sobre el certificado, consulte la documentación de IBM Cloud Product Insights en developerWorks.
    • Si no utiliza la pasarela, descargue el archivo digicert.jks desde IBM Cloud. Este archivo contiene un certificado de una entidad emisora de certificados reconocida.

    Coloque una copia del archivo de almacén de claves para la configuración elegida en el directorio ${server.config.dir}/resources/security que desee registrar.

  • En la instalación de Liberty. instale la característica productInsights-1.0 mediante el mandato the installUtility. Para obtener más información, consulte Instalación de activos utilizando el mandato installUtility.
    Importante: Si la instalación de Liberty no tiene acceso directo a Internet, debe configurar los valores de proxy para el mandato installUtility para instalar desde el Repositorio de IBM WebSphere Liberty en línea.

Acerca de esta tarea

Desde un único servicio Product Insights en IBM Cloud, puede realizar un seguimiento de muchos servidores Liberty alojados localmente, en IBM Cloud o en otros entornos de nube. Cuando se registra un servidor Liberty en una instancia de servicio Product Insights, dicho servidor se conecta al servicio en IBM Cloud y periódicamente notifica las siguientes métricas de uso.
  • Número de servidores Liberty activos
  • Ubicación de host de cada servidor
  • Edición y versión del producto de cada servidor
  • La ocupación de cada servidor

Sólo usted y otros usuarios a los que ha autorizado en IBM Cloud pueden controlar la instancia de servicio Product Insights.

Para obtener más información, consulte IBM Cloud Product Insights on IBM developerWorks.

Procedimiento

  1. Cree una instancia del servicio Product Insights en la consola de IBM Cloud.

    Puesto que el servicio puede realizar un seguimiento de muchos servidores Liberty, sólo necesita una única instancia de servicio.

    1. En el Catálogo de IBM Cloud, busque el servicio Product Insights o seleccione el servicio bajo Servicios > Integrar.
    2. En la página resultante, cambie opcionalmente el nombre de servicio predeterminado y a continuación pulse Crear.
    3. En el servicio de Product Insights, vaya a Credenciales de servicio y seleccione Ver credenciales para una de las credenciales que se muestran.

      Tome nota del host de API y la clave de API del servicio de Product Insights que ha creado. Esta información se añade a la configuración del servidor de Liberty para registrar el servidor en la instancia de servicio específica.

  2. En el archivo de configuración server.xml del servidor de Liberty que desee registrar, añada la característica productInsights-1.0.
    <featureManager>
      <feature>productInsights-1.0</feature>
    </featureManager>
  3. En la configuración del servidor, defina el almacén de claves y el almacén de confianza para la comunicación SSL entre el servidor de Liberty y el servicio de Product Insights en IBM Cloud.
    <keyStore id="productInsightsKeyStore" location="archivo_almacén_claves.jks" type="JKS"/>
    <ssl id="productInsightsSSL"
      keyStoreRef="productInsightsKeyStore"
      trustStoreRef="productInsightsKeyStore"
      sslProtocol="TLSv1.2"/>
    • En el elemento keyStore, especifique un ID y haga referencia al archivo de almacén de claves para la configuración, que es el certificado para la pasarela o el archivo digicert.jks, tal como se describe en Antes de empezar.
    • En el elemento ssl, especifique un ID y haga referencia a los ID del elemento keyStore que haya definido. Para obtener más información sobre la configuración SSL, consulte atributos de configuración SSL.
  4. Configure el servicio de Product Insights en el elemento productInsights.
    <productInsights url="<host_API_o_URL_pasarela>" apiKey="<clave_API>" sslRef="productInsightsSSL" groups="<nombreGrupo>"
           proxyUrl="<URL_proxy>" proxyUser="<nombreUsuarioProxy>" proxyPassword="<contraseñaProxy>"/>
    • En los atributos url y apiKey, especifique el host de API y las credenciales de clave que ha anotado al crear el servicio de Product Insights. Si ha instalado la pasarela de Product Insights, en su lugar especifique el URL de la pasarela en el atributo url.
    • En el atributo sslRef, haga referencia al ID del elemento ssl que ha definido.
    • Para el atributo groups opcional, puede definir conjuntos de servidores Liberty que se van a agrupar para fines de informes. Puede definir varios niveles de grupo anidados y puede incluir cada servidor Liberty en varios grupos separando los nombres de grupo con una coma, tal como se muestra en el ejemplo siguiente.
      groups="libertyGroup1, libertyGroup1/subgroupA, subgroupA/smallGroupx"
      En este ejemplo, smallGroupx está anidado dentro de subgroupA, que está anidado dentro de libertyGroup1. Especifique grupos de nivel de nivel superior sin una barra inclinada (/). Especifique grupos anidados con una barra inclinada como, por ejemplo, en parentGroup/nestedGroup. Los servidores agrupados se visualizan jerárquicamente en el servicio Product Insights.
    • Si no utiliza la pasarela y el servidor de Liberty no tiene acceso directo a Internet, defina el proxy HTTP en los atributos proxyUrl, proxyUser y proxyPassword. El URL de proxy debe tener el formato http://nombrehost:puerto, y solo se requiere el nombre de usuario y la contraseña de proxy si el servidor proxy HTTP requiere autenticación.

      Si Liberty tiene acceso a Internet o si se están direccionando datos mediante la pasarela, no es necesario definir valores de proxy.

Resultados

Para visualizar los servidores registrados en la consola IBM Cloud, vaya a Menú (☰) > Panel de control y seleccione la instancia de servicio Product Insights. Los servidores registrados se listan en la pestaña Administrar del servicio.

Para detener la notificación de métricas de usuario de un servidor de Liberty, elimine la configuración productInsights de la configuración de ese servidor.


Icono que indica el tipo de tema Tema de tarea

Nombre de archivo: twlp_config_blmx_productinsights.html