Vous pouvez porter une application Liberty qui utilise MongoDB pour s'exécuter
sur le profil complet de WebSphere Application
Server.
Avant de commencer
Vérifiez que l'application s'exécute correctement sur le profil étendu Liberty pour websphere Application Server version 8.5.5.0 ou suivante et que le profil complet du serveur est au niveau 8.5.5.1 ou ultérieur.
Seules les versions de pilote Java MongoDB 2.10.1 à 2.12.5 sont prises en charge.
Procédure
- Utilisez le fichier server.xml du profil Liberty afin de créer le fichier ibm-mongodb.xml
pour l'environnement du profil complet.
- Créez un fichier local intitulé ibm-mongodb.xml avec l'élément racine <ibm-mongodb>.
- Copiez les éléments <mongo> et <mongoDB> de votre fichier
server.xml dans le fichier ibm-mongodb.xml et imbriquez-les sous
l'élément <ibm-mongodb> racine. Si vous avez des éléments <mongo>
ou <mongoDB> dans un fichier qui étaient inclus dans votre fichier server.xml
via l'élément <include>, vous devez également les copier dans le nouveau fichier
ibm-mongodb.xml. Par exemple :
<ibm-mongodb>
<mongo id="mongo" libraryRef="mongo-lib" hostNames="localhost" ports="27017"/>
<mongoDB jndiName="mongo/sampledb" mongoRef="mongo" databaseName="sampleDb"/>
</ibm-mongodb>
Eviter les incidents: Les éléments <include> copiés du fichier
server.xml dans le fichier ibm-mongodb.xml sont ignorés. En outre,
les mots de passe doivent être en texte en clair ; ils ne doivent pas être chiffrés. Les
valeurs de configuration qui spécifient une valeur de durée doivent être converties en
valeurs entières strictes.
Par exemple, convertissez
12s en
12000
milliseconds. Les éléments de configuration du fichier ibm-mongodb.xml
ne peuvent pas posséder le même ID qu'un autre élément.
gotcha
- Installez le fichier ibm-mongodb.xml dans la
configuration du profil complet.
- Démarrez l'outil de scriptage wsadmin. Pour démarrer wsadmin à l'aide du langage Jython, exécutez la commande wsadmin -lang jython du répertoire bin
du profil de serveur.
- Pour chaque serveur qui utilise la configuration d'un
serveur Liberty, utilisez la commande createDocument pour créer
un document dans le référentiel de configuration. Exécutez les commandes suivantes :
AdminConfig.createDocument("cells/[cell_name]/nodes/[node_name]/servers/[server_name]/ibm-mongodb.xml","[path_to]/ibm-mongodb.xml")
AdminConfig.save()
- Créez une bibliothèque partagée isolée pour le pilote Java™ MongoDB. Utilisez-la
pour le serveur d'applications et dans toutes les applications qui utilisent MongoDB.
- Pour savoir comment créer la bibliothèque partagée pour le pilote Java MongoDB, voir la documentation relative à la création des bibliothèques partagées. La bibliothèque partagée du pilote Java MongoDB doit être une bibliothèque partagée isolée.
- Installez l'application à l'aide de scripts ou de la console d'administration. Associez
bien l'application à la bibliothèque partagée nouvellement créée.
Résultats
Vous avez porté une application de profil Liberty utilisant MongoDB
pour que l'application soit exécuté dans le profil complet.