[17.0.0.1 et ultérieur]

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

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

Avant de commencer

  • Créez un compte Bluemix. Pour créer votre compte, consultez Inscrivez-vous à IBM Bluemix.
  • 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 la documentation 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 Bluemix:
    • 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 Bluemix. 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 Bluemix vous permet de suivre de nombreux serveurs Liberty hébergés sur site, dans Bluemix 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 Bluemix 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 Bluemix 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 Bluemix.

    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 Bluemix, 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 communication SSL entre le serveur Liberty et le service Product Insights sur Bluemix.
    <keyStore id="productInsightsKeyStore" location="keystorefile.jks" type="JKS"/>
    <trustStore id="productInsightsTrustStore" location="keystorefile.jks" type="JKS"/>
    <ssl id="productInsightsSSL"
      keyStoreRef="productInsightsKeyStore"
      trustStoreRef="productInsightsTrustStore"
      sslProtocol="TLSv1.2"/>
    • Pour les éléments keyStore et trustStore, spécifiez un ID et référencez le fichier de clés pour votre configuration (à savoir le certificat pour la passerelle ou le fichier digicert.jks) comme décrit dans la section Avant de commencer.
    • Pour les éléments ssl, spécifiez un ID et référencez les ID des éléments keyStore et trustStore que vous avez définis. Pour plus d'informations sur la configuration SSL, voir Liberty : 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 passerelleProduct 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 jeux de serveurs Liberty à regrouper à des fins de rapports. Vous pouvez définir plusieurs niveaux de groupes imbriqués et chaque serveur Liberty peut être inclus dans plusieurs groupes en séparant les noms de groupe par une virgule comme illustré dans l'exemple ci-dessous.
      groups="libertyGroup1, libertyGroup1/subgroupA"
      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 un accès direct à Internet, définissez le proxy HTTP dans les attributs proxyUrl, proxyUser et proxyPassword. L'URL du proxy doit suivre le format http://nom_d'hôte:port. Le nom et le mot de passe de l'utilisateur du proxy ne sont requis que 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 Bluemix, 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