[17.0.0.1 and later]

Enregistrement de serveurs Liberty auprès du service Product Insights sur IBM Cloud

En configurant la fonction productInsights-1.0, vous pouvez enregistrer votre serveur Liberty local ou basé sur le cloud afin de communiquer des métriques d'utilisation au service IBM® Cloud Product Insights.

Avant de commencer

  • Créez un compte IBM Cloud. Pour créer votre compte, consultez Inscrivez-vous à IBM IBM Cloud.
  • Décidez si vous désirez acheminer les données communiquées par le serveur via la passerelle Product Insights. Vous pouvez vous familiariser avec celle-ci et l'installer depuis IBM Cloud Product Insights sur le site IBM developerWorks. En acheminant les données via la passerelle, vous pouvez les examiner avant leur envoi au service Product Insights.
    L'utilisation ou non de la passerelle influence la manière dont vous configurez la communication SSL au service Product Insights sur IBM Cloud:
    • Si vous installez la passerelle, vous devez utiliser le certificat de serveur de la passerelle Product Insights. Pour plus d'informations sur la passerelle, reportez-vous à la documentation IBM Cloud Product Insights sur developerWorks.
    • Si vous n'utilisez pas la passerelle, téléchargez le fichier digicert.jks depuis IBM Cloud. Ce fichier contient un certificat d'une autorité de certification réputée.

    Placez une copie du fichier de clés correspondant à la configuration choisie dans le répertoire ${server.config.dir}/resources/security de chaque serveur que vous désirez enregistrer.

  • Dans votre installation Liberty, installez la fonction productInsights-1.0 à l'aide de la commande installUtility. Pour plus d'informations, voir Installation des actifs avec la commande installUtility.
    Important : Si votre installation Liberty ne dispose pas d'un accès direct à Internet, vous devez configurer des paramètres de proxy pour la commande installUtility afin d'effectuer l'installation depuis le référentiel IBM WebSphere Liberty Repository en ligne.

Pourquoi et quand exécuter cette tâche

Un même service Product Insights sur IBM Cloud vous permet de suivre de nombreux serveurs Liberty hébergés sur site, dans IBM Cloud ou dans d'autres environnements cloud. Lorsqu'un serveur Liberty est enregistré auprès d'une instance de service Product Insights, il peut se connecter à ce service sur IBM Cloud et rendre compte périodiquement des métriques d'utilisation suivantes :
  • Nombre de serveurs Liberty actifs
  • Emplacement de chaque serveur sur son hôte
  • Edition et version de produit de chaque serveur
  • Niveau d'occupation de chaque serveur

Seuls vous-même et les autres utilisateurs que vous autorisez sur IBM Cloud pouvez contrôler l'instance de service Product Insights.

Pour plus d'informations, voir IBM Cloud Product Insights sur IBM developerWorks.

Procédure

  1. Créez une instance du service Product Insights dans la console IBM Cloud.

    Comme le service est capable de suivre de nombreux serveurs Liberty, vous n'avez besoin que d'une seule instance de ce service.

    1. Dans le catalogue IBM Cloud, recherchez le service Product Insights ou sélectionnez le service sous Services > Intégrer.
    2. Sur la page résultante, au besoin, changez le nom de service par défaut et cliquez sur Créer.
    3. Dans votre service Product Insights, accédez à Données d'identification du service et sélectionnez Afficher les données d'identification pour l'une des options présentées.

      Notez l'hôte d'API et la clé d'API du service Product Insights que vous avez créé. Cette information doit être ajoutée à la configuration du serveur Liberty pour enregistrer celui-ci auprès de l'instance de service concernée.

  2. Dans le fichier de configuration server.xml du serveur Liberty que vous désirez enregistrer, ajoutez la fonction productInsights-1.0.
    <featureManager>
      <feature>productInsights-1.0</feature>
    </featureManager>
  3. Dans la configuration du serveur, définissez le fichier de clés et le magasin de clés pour la communication SSL entre le serveur Liberty et le service Product Insights sur IBM Cloud.
    <keyStore id="productInsightsKeyStore" location="keystorefile.jks" type="JKS"/>
    <ssl id="productInsightsSSL"
      keyStoreRef="productInsightsKeyStore"
      trustStoreRef="productInsightsKeyStore"
      sslProtocol="TLSv1.2"/>
    • Sur l'élément keyStore, spécifiez un ID et référencez le fichier de clés pour votre configuration, qui est soit le certificat de la passerelle, soit le fichier digicert.jks, comme décrit dans la section Avant de commencer.
    • Sur l'élément ssl, spécifiez un ID et référencez les ID de l'élément keyStore que vous avez définis. Pour plus d'informations sur la configuration SSL, voir Attributs de configuration SSL.
  4. Configurez le service Product Insights sur l'élément productInsights.
    <productInsights url="<apiHost_or_gatewayURL>" apiKey="<apiKey>" sslRef="productInsightsSSL" groups="<groupName>"
           proxyUrl="<proxyURL>" proxyUser="<proxyUserName>" proxyPassword="<proxyPassword>"/>
    • Pour les attributs url et apiKey, spécifiez l'hôte d'API et les données d'identification de la clé que vous avez notés lorsque vous avez créé le service Product Insights. Si vous avez installé la passerelle Product Insights, spécifiez à la place l'URL de la passerelle dans l'attribut url.
    • Pour l'élément sslRef, référencez l'ID de l'élément ssl que vous avez défini.
    • Pour l'attribut facultatif groups, vous pouvez définir des ensembles de serveurs Liberty à regrouper à des fins de génération de rapports. Vous pouvez définir plusieurs niveaux de groupes imbriqués et vous pouvez inclure chaque serveur Liberty dans plusieurs groupes en séparant les noms de groupes par une virgule, comme illustré dans l'exemple ci-dessous.
      groups="libertyGroup1, libertyGroup1/subgroupA, subgroupA/smallGroupx"
      Dans cet exemple, smallGroupx est imbriqué dans subgroupA, qui est imbriqué dans libertyGroup1. Spécifiez les groupes ayant le plus haut niveau sans barre oblique (/). Spécifiez les groupes imbriqués avec une barre oblique, comme dans parentGroup/nestedGroup. Les serveurs groupés sont affichés par ordre hiérarchique dans le service Product Insights.
    • Si vous n'utilisez pas la passerelle et que le serveur Liberty n'a pas d'accès direct à Internet, définissez le proxy HTTP dans les attributs proxyUrl, proxyUser et proxyPassword. L'URL du proxy doit respecter le format http://nom_d'hôte:port. Le nom et le mot de passe de l'utilisateur du proxy sont obligatoires uniquement si votre serveur proxy HTTP requiert une authentification.

      Si Liberty a un accès direct à Internet ou que vous acheminez les données via une passerelle, vous n'avez pas besoin de définir des paramètres de proxy.

Résultats

Pour voir les serveurs enregistrés dans la console IBM Cloud, allez à Menu (☰) > Tableau de bord et sélectionnez votre instance du service Product Insights. Vos serveurs enregistrés sont listés sous l'onglet Gérer du service.

Pour cesser la génération de rapports de métriques d'utilisation d'un serveur Liberty, supprimez la configuration productInsights de la configuration de ce serveur.


Icône indiquant le type de rubrique Rubrique Tâche

Nom du fichier : twlp_config_blmx_productinsights.html