Utilisez l'outil d'intégration de la ligne de commande de l'utilitaire IBM®
Bluemix pour configurer votre
serveur Liberty pour utiliser le service dashDB
de Bluemix.
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 utiliser le service dashDB.
Procédure
- Connectez-vous à l'aide de la commande bluemixUtility login. Après votre connexion initiale, vous n'avez pas besoin d'effectuer à nouveau cette étape.
- 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: dashDB
Description: A flexible and powerful data warehouse for online analytics processing, or a highly reliable relational database for enterprise-level online transaction processing.
Documentation: https://www.ng.bluemix.net/docs/#services/dashDB/index.html#dashDB
Plans: Entry, Enterprise256.4, Enterprise256.12, EnterpriseMPP.4, EnterpriseTransactional12.128.1400, EnterpriseTransactional2.8.500, Enterprise
- Le service dashDB offre différents plans de service pour la création d'entrepôts de données et le traitement transactionnel. Utilisez le tableau de
bord Bluemix pour créer ou demander une instance.
- Une fois que vous disposez d'une instance de service dashDB, vérifiez qu'elle possède une clé de service. Une clé de service contient les données
d'identification du service. Exemple :
$ bluemixUtility showService myDashDB
Name: myDashDB
Type: dashDB
Plan: EnterpriseTransactional2.8.500
Description: A flexible and powerful data warehouse for online analytics processing, or a highly reliable relational database for enterprise-level online transaction processing.
Documentation: https://www.ng.bluemix.net/docs/#services/dashDB/index.html#dashDB
Service keys:
credential-1
Si aucune clé de service n'est répertoriée, utilisez le tableau de bord Bluemix ou la commande
bluemixUtility
createService avec les options
serviceType,
servicePlan et
serviceName pour en créer une. Si vous utilisez la commande
createService, veillez à transmettre le type de service, le nom de plan et le nom de service correspondant aux valeurs des résultats de la commande
showService. Exemple :
$ bluemixUtility createService dashDB EnterpriseTransactional2.8.500 myDashDB
- Exécutez la commande bluemixUtility import myDashDB pour importer la configuration.
Acceptez les dispositions du contrat de licence relatives aux bibliothèques nécessaires pour accéder au service.
- 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 :
myDashDB
- 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 myDashDB
Checking if features required for the myDashDB service are installed.
All required features are installed.
The myDashDB is now bound to defaultServer server.
Le nom JNDI par défaut de la base de données dashDB est jdbc/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 myDashDB --vjndiName=jdbc/myDataSource
Résultats
Vous pouvez désormais utiliser les services dashDB avec votre serveur
Liberty.