Configuration de Liberty pour les services Bluemix Cloudant

Utilisez l'outil d'intégration de ligne de commande d'utilitaire IBM® Bluemix pour configurer votre serveur Liberty afin qu'il utilise le service Bluemix Cloudant.

Avant de commencer

Avant de configurer votre serveur Liberty pour qu'il utilise les services Bluemix, vous devez créer un compte. Voir Sign up for IBM Bluemix pour créer votre compte Bluemix.

Pourquoi et quand exécuter cette tâche

Configurez votre serveur Liberty pour qu'il utilise le service Cloudant. Pour en savoir plus sur Cloudant, voir Initiation à Cloudant NoSQL DB. De plus, votre application doit utiliser la bibliothèque Ektorp pour accéder au service Cloudant. Pour plus d'informations, voir Bienvenue dans Ektorp.

Procédure

  1. Connectez-vous à l'aide de la commande bluemixUtility login. Après votre connexion initiale, vous n'avez pas besoin d'effectuer à nouveau cette étape.
  2. Exécutez la commande bluemixUtility marketplace pour répertorier les détails sur tous les services Bluemix qui peuvent être utilisés avec l'utilitaire de ligne de commande. Examinez l'exemple suivant :
    Service: cloudantNoSQLDB 
    Description: Cloudant NoSQL DB provides access to a fully managed NoSQL JSON data layer that's always on. 
    This service is compatible with CouchDB, and accessible through a simple to use HTTP interface for mobile 
    and web application models. 
    Documentation: https://www.ng.bluemix.net/docs/#services/Cloudant/index.html#Cloudant 
    Plans: Shared, Enterprise SMB, Enterprise Standard
  3. Remarque : Si vous avez déjà créé une instance, passez à l'étape 4. Vous pouvez également créer une instance à partir du tableau de bord Bluemix.
    Exécutez la commande bluemixUtility createService [options] serviceType servicePlan serviceName pour créer une instance des services Bluemix que vous souhaitez utiliser. Examinez l'exemple et la description de service répertorié ci-dessous :
    $ bluemixUtility createService cloudantNoSQLDB Shared myCloudantService
  4. Facultatif : Exécutez la commande bluemixUtility listServices pour afficher le nom, le type et le plan de toutes les instances de service que vous avez créées. Examinez l'exemple suivant :
    myCloudantService cloudantNoSQLDB Shared
  5. Exécutez la commande bluemixUtility import myCloudantService pour importer la configuration.
    1. Acceptez les dispositions de contrat de licence relatives aux bibliothèques nécessaires pour accéder au service.
    2. Une fois la configuration importée, effectuez des étapes supplémentaires afin d'utiliser la configuration importée dans l'application, telles que l'ajout d'une référence de chargeur de classe à la bibliothèque. Par exemple, vous devez ajouter la référence classloader suivante à votre application pour utiliser les bibliothèques Ektorp téléchargées.
      <application id="myCloudantApp">
                      <classloader commonLibraryRef="cloudantNoSQLDB-library"/>
              </application>
  6. Facultatif : Exécutez la commande bluemixUtility listImports pour afficher les configurations de service que vous avez importées.
    Les configurations de service IBM Bluemix suivantes ont été importées :
    myCloudantService
  7. Exécutez la commande bluemixUtility bind [options] serverName serviceName pour connecter la configuration à un serveur Liberty. Acceptez les dispositions de contrat de licence, si le système vous y invite. Examinez l'exemple et la description de service répertorié ci-dessous :
    $ bluemixUtility bind defaultServer myCloudantService
    
    Checking if features required for the myCloudantService are installed.
    All required features are installed.
    The myCloudantService is now bound to defaultServer server.
    La fonction couchdb-1.0 est requise. Le nom JNDI par défaut pour la base de données Cloudant est couchdb/serviceName. Si votre application utilise un nom JNDI différent pour accéder à l'instance de base de données, utilisez l'option --vjndiName pour spécifier le nom JNDI. Examinez l'exemple suivant :
    $ bluemixUtility bind defaultServer myCloudantService --vjndiName=couchdb/connector

Résultats

Vous pouvez désormais utiliser les services Cloudant avec votre serveur Liberty.

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



Icône d'horodatage Dernière mise à jour: Tuesday, 6 December 2016
http://www14.software.ibm.com/webapp/wsbroker/redirect?version=cord&product=was-nd-mp&topic=twlp_config_blmx_cloudant
Nom du fichier : twlp_config_blmx_cloudant.html