É possível transportar um aplicativo Liberty que usa MongoDB para ser executado no perfil completo do WebSphere Application Server.
Antes de Iniciar
Certifique-se de que o aplicativo seja executado com êxito no perfil do Liberty Extended
para o WebSphere Application Server Versão 8.5.5.0 ou posterior e que o servidor de perfil
integral seja da versão 8.5.5.1 ou posterior.
Somente as versões 2.10.1 a 2.12.5 do driver MongoDB são suportadas.
Procedimento
- Use o arquivo server.xml do perfil do Liberty para criar o arquivo ibm-mongodb.xml para o ambiente do perfil completo.
- Crie um arquivo local chamado ibm-mongodb.xml com um elemento raiz <ibm-mongodb>.
- Copie os elementos <mongo> e <mongoDB> do arquivo server.xml para o arquivo ibm-mongodb.xml e aninhe-os no elemento <ibm-mongodb> raiz. Caso possua elementos <mongo> ou <mongoDB> em um arquivo que foi incluído em seu arquivo server.xml por meio do elemento <include>, copie também esses elementos para o novo arquivo ibm-mongodb.xml; por exemplo:
<ibm-mongodb>
<mongo id="mongo" libraryRef="mongo-lib" hostNames="localhost" ports="27017"/>
<mongoDB jndiName="mongo/sampledb" mongoRef="mongo" databaseName="sampleDb"/>
</ibm-mongodb>
Evitar Problemas: Quaisquer elementos <include> que sejam copiados do arquivo server.xml para o arquivo ibm-mongodb.xml são ignorados. Além disso, as senhas devem estar em texto simples; elas não podem ser criptografadas. Todos os valores de configuração que especifiquem um valor de duração de tempo devem ser convertidos para valores de números inteiros exatos.
Por exemplo, converta
12s para
12000 milissegundos. Os elementos de configuração no arquivo ibm-mongodb.xml não podem ter o mesmo ID de nenhum outro elemento.
gotcha
- Instale o arquivo ibm-mongodb.xml na configuração de perfil completa.
- Inicie a ferramenta de script wsadmin. Para iniciar wsadmin usando a linguagem Jython, execute o comando wsadmin -lang jython a partir do diretório bin do perfil do servidor.
- Para cada servidor que está obtendo a configuração a partir de um servidor Liberty, use o comando createDocument para criar um novo documento no repositório de configuração. Execute os seguintes comandos:
AdminConfig.createDocument("cells/[cell_name]/nodes/[node_name]/servers/[server_name]/ibm-mongodb.xml","[path_to]/ibm-mongodb.xml")
AdminConfig.save()
- Crie uma biblioteca compartilhada isolada para o driver Java™ do MongoDB. Use essa biblioteca compartilhada isolada para o servidor de aplicativos e utilize-a em todos os aplicativos que estão usando MongoDB.
- Consulte a documentação sobre como criar bibliotecas compartilhadas para aprender a criar a biblioteca compartilhada para o driver Java do MongoDB. A biblioteca compartilhada do driver Java do MongoDB deve ser uma biblioteca compartilhada isolada.
- Instale o aplicativo usando o script ou o console de administração. Certifique-se de associar o aplicativo à biblioteca compartilhada recém-criada.
Resultados
Você transportou um aplicativo do perfil Liberty que usa o MongoDB, para que o aplicativo seja executado no perfil completo.