Configuring Liberty for IBM Cloud dashDB services

Use the IBM® Bluemix® utility command-line integration tool to configure your Liberty server to use the IBM Cloud dashDB® service.

Before you begin

Before you configure your Liberty server to use IBM Cloud services, you must create an account. See Sign up for IBM Cloud to create your IBM Cloud account.

About this task

Configure your Liberty server to use the dashDB service.

Procedure

  1. Log in using the bluemixUtility login command. After your initial login, you do not have to complete this step again.
  2. Run the bluemixUtility marketplace command to list details about all the IBM Cloud services that can be used with the command-line utility. See the following example:
    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
  3. The dashDB service offers different service plans for data warehousing and transactional processing. Use the IBM Cloud dashboard to create or request an instance.
  4. Once you have a dashDB service instance verify that it has a service key. A service key contains credential information for the service. For example:
    $ 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
    If you do not see a service key that is listed use the IBM Cloud dashboard or the bluemixUtility createService command with the options serviceType, servicePlan, and serviceName to create one. If you use the createService command, make sure to pass the service type, plan name, and service name that matches the values from the output of the showService command. For example:
    $ bluemixUtility createService dashDB EnterpriseTransactional2.8.500 myDashDB
  5. Run the bluemixUtility import myDashDB command to import the configuration. Accept the license terms and conditions of the necessary libraries that are needed to access the service.
  6. Optional: Run the bluemixUtility listImports command to view the service configurations that you imported.
    The following IBM Bluemix service configurations have been imported:
    myDashDB
  7. Run the bluemixUtility bind [options] serverName serviceName to bind the configuration to a Liberty server. Accept the license terms and conditions, if you are prompted. See the following example and description of a service listed:
    $ 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.
    The default JNDI name for the dashDB database is jdbc/serviceName. If your application uses a different JNDI name to access the database instance, use the --vjndiName option to specify the JNDI name. See the following example:
    $ bluemixUtility bind defaultServer myDashDB --vjndiName=jdbc/myDataSource

Results

You can now use dashDB services with your Liberty server.

Icon that indicates the type of topic Task topic

File name: twlp_config_blmx_dashdb.html