Utilice la herramienta de integración de línea de mandatos de programa de utilidad
de IBM®
Bluemix
para configurar el servidor de Liberty
para utilizar el servicio de Bluemix
Cloudant.
Antes de empezar
Antes de configurar el servidor de
Liberty para utilizar los servicios
de
Bluemix, debe crear una cuenta. Consulte
Regístrese
en IBM
Bluemix para crear su cuenta de
Bluemix.
Acerca de esta tarea
Configure el servidor de Liberty
para utilizar el servicio de
Cloudant. Si
desea más información sobre
Cloudant,
consulte
Guía
de inicio con Cloudant NoSQL DB.
Además, la aplicación debe utilizar la biblioteca
Ektorp para acceder al servicio
Cloudant. Consulte
Bienvenido a Ektorp
para obtener más información.
Procedimiento
- Inicie la sesión utilizando el mandato bluemixUtility login. Tras el inicio de sesión
inicial, no tiene que completar este paso de nuevo.
- Ejecute el mandato bluemixUtility marketplace para listar los detalles sobre todos los
servicios de Bluemix que se pueden
utilizar con el programa de utilidad de línea de mandatos. Consulte el ejemplo siguiente:
Servicio: cloudantNoSQLDB
Descripción: Cloudant NoSQL DB proporciona acceso a una capa de datos JSON de NoSQL totalmente gestionada
que siempre está activo.
Este servicio es compatible con CouchDB y es accesible a través de una
interfaz HTTP fácil de usar para modelos de aplicaciones móviles
y web.
Documentación: https://www.ng.bluemix.net/docs/#services/Cloudant/index.html#Cloudant
Planes: Shared, Enterprise SMB, Enterprise Standard
Nota: Si ya ha creado una instancia, vaya al paso 4. También puede crear una instancia desde el
panel de control de Bluemix.
Ejecute el mandato bluemixUtility createService [opciones]
tipoServicio
planServicio
nombreServicio para crear una instancia de
los servicios de Bluemix
que desea utilizar. Consulte el ejemplo y la descripción siguientes de un servicio listado:
$ bluemixUtility createService cloudantNoSQLDB Shared myCloudantService
- Opcional: Ejecute el mandato bluemixUtility listServices para ver el Nombre, Tipo y Plan
de todas las instancias de servicios que ha creado. Consulte el ejemplo siguiente:
myCloudantService cloudantNoSQLDB Shared
- Ejecute el mandato bluemixUtility import myCloudantService para importar
la configuración.
- Acepte los términos y condiciones de licencia de las bibliotecas que son necesarias para acceder al
servicio.
- Después de que la configuración se haya importado satisfactoriamente, siga los pasos adicionales para
utilizar la configuración importada en la aplicación, por ejemplo añadir una referencia
classloader en la biblioteca.
Por ejemplo, debe añadir la referencia de cargador de clases
siguiente a la aplicación para utilizar las bibliotecas
Ektorp que se han descargado.
<application id="myCloudantApp">
<classloader commonLibraryRef="cloudantNoSQLDB-library"/>
</application>
- Opcional: Ejecute el mandato bluemixUtility listImports para ver las
configuraciones de servicio que ha importado.
Se han importado las siguientes configuraciones de servicio de IBM Bluemix:
myCloudantService
- Ejecute bluemixUtility bind [opciones]
nombreServidor
nombreServicio para enlazar la configuración a un servidor
Liberty. Acepte los términos y condiciones
de licencia, si se le solicita. Consulte el ejemplo y la descripción siguientes de un servicio listado:
$ bluemixUtility bind defaultServer myCloudantService
Comprobando si las características necesarias para myCloudantService están instaladas.
Todas las características necesarias están instaladas.
El servicio myCloudantService está ahora enlazado al servidor defaultServer.
La característica couchdb-1.0 es necesaria. El nombre JNDI predeterminado
para la base de datos Cloudant
es couchdb/nombreServicio. Si la aplicación utiliza un nombre JNDI
distinto para acceder a la instancia de base de datos, utilice la opción --vjndiName
para especificar el nombre JNDI. Consulte el ejemplo siguiente: $ bluemixUtility bind defaultServer myCloudantService --vjndiName=couchdb/connector
Resultados
Ahora puede utilizar los servicios de
Cloudant con el servidor de
Liberty.