Liberty für IBM Cloud-Cloudant-Services konfigurieren

Verwenden Sie das Integrationstool des IBM® Cloud-Befehlszeilendienstprogramms, um Ihren Liberty-Server für die Verwendung mit dem IBM Cloud Cloudant-Service zu konfigurieren.

Vorbereitende Schritte

Vor der Konfiguration Ihres Liberty-Servers für die Verwendung von IBM Cloud-Services müssen Sie einen Account erstellen. Informationen zum Erstellen Ihres IBM Cloud-Kontos finden Sie unter Sign up for IBM Cloud.

Informationen zu diesem Vorgang

Konfigurieren Sie Ihren Liberty-Server so, dass er den Cloudant-Service verwendet. Weitere Informationen zu Cloudant finden Sie unter Einführung in Cloudant NoSQL DB.

Vorgehensweise

  1. Melden Sie sich mit dem Befehl bluemixUtility login an. Nach der ersten Anmeldung müssen Sie diesen Schritt nicht wieder ausführen.
  2. Führen Sie den Befehl bluemixUtility marketplace aus, um Details zu allen IBM Cloud-Services aufzulisten, die mit dem Befehlszeilendienstprogramm verwendet werden können. Sehen Sie sich hierzu das folgende Beispiel an:
    Service: cloudantNoSQLDB 
    Description: Cloudant NoSQL DB is a fully managed data layer designed for modern web and mobile applications that leverages a flexible JSON schema. 
    Cloudant is built upon and compatible with Apache CouchDB and accessible through a secure HTTPS API, which scales as your application grows. 
    Cloudant is ISO27001 and SOC2 Type 1 certified, and all data is stored in triplicate across separate physical nodes in a cluster for HA/DR within a data center.
    Documentation: https://console.ng.bluemix.net/docs/#services/Cloudant/index.html#Cloudant
    Plans: Standard, Lite
  3. Anmerkung: Wenn Sie bereits eine Instanz erstellt haben, fahren Sie mit dem nächsten Schritt fort. Sie können auch über das IBM Cloud-Dashboard eine Instanz erstellen.
    Führen Sie den Befehl bluemixUtility createService [Optionen] Servicetyp Serviceplan Servicename aus, um eine Instanz der IBM Cloud-Services zu erstellen, die Sie verwenden möchten. Sehen Sie sich das folgende Beispiel und die folgende Beschreibung für einen Service an:
    $ bluemixUtility createService cloudantNoSQLDB Lite myCloudantService
  4. Optional: Führen Sie den Befehl bluemixUtility listServices aus, um den Namen, Typ und Plan aller Serviceinstanzen anzuzeigen, die Sie erstellt haben. Sehen Sie sich hierzu das folgende Beispiel an:
    myCloudantService cloudantNoSQLDB Lite
  5. Führen Sie den Befehl bluemixUtility import myCloudantService --pversion=v2 aus, um die Konfiguration zu importieren.
    Wichtig: Die Option --pversion=v2 installiert das Feature cloudant-1.0 und lädt die offizielle Cloudant-Bibliothek für Java herunter. Informationen zur API finden Sie in der offiziellen API-Dokumentation zur Cloudant-Java-Bibliothek. Wenn Sie die Option --pversion=v2 weglassen, wird das Feature couchdb-1.0 installiert und die Ektorp-Bibliotheken werden stattdessen verwendet, um mit der Cloudant-Instanz zu kommunizieren.
    1. Akzeptieren Sie die Lizenzbedingungen der erforderlichen Bibliotheken, die für den Zugriff auf den Service benötigt werden.
    2. Nach dem erfolgreichen Import der Konfiguration führen Sie alle zusätzlichen Schritte für die Verwendung der importierten Konfiguration in Ihrer Anwendung aus. Fügen Sie der Bibliothek beispielsweise eine Klassenladeprogrammreferenz hinzu. Sie müssen Ihrer Anwendung beispielsweise die folgende Klassenladeprogrammreferenz hinzufügen, um die heruntergeladenen Bibliotheken zu verwenden.
      <application id="myCloudantApp">
               <classloader commonLibraryRef="cloudantNoSQLDB-library"/>
      </application>
  6. Optional: Führen Sie den Befehl bluemixUtility listImports aus, um die importierten Servicekonfigurationen anzuzeigen.
    The following IBM Bluemix service configurations have been imported:
    myCloudantService
  7. Führen Sie den Befehl bluemixUtility bind [Optionen] Servername Servicename aus, um die Konfiguration an einen Liberty-Server zu binden. Akzeptieren Sie die Lizenzbedingungen, wenn Sie dazu aufgefordert werden. Sehen Sie sich das folgende Beispiel und die folgende Beschreibung für einen Service an:
    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.
    Wenn Sie den Service mit der Option --pversion=v2 importiert haben, um die offiziellen Cloudant-Java-Bibliotheken zu verwenden, ist der JNDI-Standardname für die Cloudant-Datenbank cloudant/Servicename. Wenn Sie diese Option nicht angegeben haben, ist der JNDI-Standardname couchdb/Servicename. Wenn Ihre Anwendung die Datenbank mit einem anderen JNDI-Namen referenziert, verwenden Sie zur Angabe des JNDI-Namens die Option --vjndiName.
    bluemixUtility bind defaultServer myCloudantService --vjndiName=couchdb/connector

Ergebnisse

Sie können Cloudant-Services jetzt mit Ihrem Liberty-Server verwenden.

Symbol das den Typ des Artikels anzeigt. Taskartikel

Dateiname: twlp_config_blmx_cloudant.html