Puede portear una aplicación Liberty que utiliza MongoDB para que se ejecute en el perfil
completo de WebSphere Application
Server.
Antes de empezar
Asegúrese de que la aplicación se ejecuta satisfactoriamente en el perfil ampliado de Liberty para
WebSphere Application Server Versión 8.5.5.0 o posterior y de que el servidor de perfiles completo se
encuentra en la versión 8.5.5.1 o posterior.
Solo se da soporte a las versiones del controlador MongoDB Java versiones 2.10.1 a 2.12.5.
Procedimiento
- Utilice el archivo server.xml del perfil de Liberty para crear el archivo ibm-mongodb.xml para el entorno de perfil completo.
- Cree un archivo local llamado ibm-mongodb.xml con un elemento raíz de <ibm-mongodb>.
- Copie los elementos <mongo> y <mongoDB> del archivo server.xml en el archivo ibm-mongodb.xml y anídelos bajo el elemento
raíz <ibm-mongodb>. Si tiene elementos <mongo> o <mongoDB> en un archivo que se han incluido en el archivo server.xml mediante
el
elemento <include>, también debe copiar estos elementos en el nuevo archivo ibm-mongodb.xml; por ejemplo:
<ibm-mongodb>
<mongo id="mongo" libraryRef="mongo-lib" hostNames="localhost" ports="27017"/>
<mongoDB jndiName="mongo/sampledb" mongoRef="mongo" databaseName="sampleDb"/>
</ibm-mongodb>
Avoid trouble: Los elementos <include> que se copien desde el archivo server.xml en el archivo ibm-mongodb.xml se ignorarán. Además, las contraseñas
deben ser texto sin formato; no se pueden cifrar. Los valores de configuración que especifiquen un valor de duración en tiempo deben convertirse a
valores
enteros estrictos. Por ejemplo, convierta
12s a
12000 milisegundos. Los elementos de configuración del archivo
ibm-mongodb.xml no pueden tener el mismo ID que cualquier otro elemento.
gotcha
- Instale el archivo ibm-mongodb.xml en la configuración de perfil completo.
- Inicie la herramienta de scripts wsadmin. Para iniciar wsadmin utilizando el lenguaje Jython, ejecute el mandato wsadmin
-lang jython desde el directorio bin del perfil del servidor.
- Para cada servidor adopte la configuración de un servidor de Liberty, utilice el mandato createDocument para
crear
un documento nuevo en el repositorio de configuración. Ejecute los mandatos siguientes:
AdminConfig.createDocument("cells/[cell_name]/nodes/[node_name]/servers/[server_name]/ibm-mongodb.xml","[path_to]/ibm-mongodb.xml")
AdminConfig.save()
- Cree una biblioteca compartida aislada para el controlador Java™ de MongoDB. Utilice esta biblioteca compartida aislada para el servidor de aplicaciones y utilícela en
todas las aplicaciones que utilizan MongoDB.
- Consulte la documentación sobre la creación de bibliotecas compartidas para obtener información sobre cómo crear la biblioteca
compartida para el
controlador Java de MongoDB. La biblioteca compartida del controlador Java
de MongoDB debe ser una biblioteca compartida aislada.
- Instale la aplicación utilizando scripts o la consola de administración. Asegúrese de asociar la aplicación con la biblioteca
compartida recién creada.
Resultados
Ha porteado una aplicación de perfil de Liberty que utiliza MongoDB para que la aplicación se ejecute en el perfil completo.