Vous pouvez utiliser Installation Manager pour ajouter ou supprimer des modules complémentaires et des fonctions dans une installation existante. Vous pouvez modifier à la fois la
fonction de conteneur d'EJB embarquable et de client JPA facultative et les modules complémentaires et fonctions Liberty.
Avant de commencer
Vérifiez que les préférences que vous avez définies dans Installation Manager pointent vers les référentiels locaux ou basés sur le Web qui
contiennent WebSphere Application Server Liberty et les modules complémentaires ou les
fonctions Liberty.
Lorsque vous modifiez votre installation, vous pouvez choisir d'accéder au référentiel IBM WebSphere Liberty pour installer les modules complémentaires et les fonctions. L'accès au
référentiel IBM WebSphere Liberty demande un accès à Internet. Si votre système n'a pas
d'accès à Internet et si vous souhaitez installer des actifs Liberty personnalisés,
configurez une instance du service de référentiel d'actifs Liberty ou un référentiel basé sur un
répertoire local puis ajoutez l'URL du référentiel, le chemin d'accès au répertoire ou le
chemin d'archivage dans Installation Manager. Pour plus d'informations sur les référentiels
Liberty, voir Installation d'actifs avec Installation Manager.
Pourquoi et quand exécuter cette tâche
Remarque : Un avis de suppression a été émis pour la fonction du conteneur d'EJB embarquable et du client JPA à partir du groupe de correctifs 16.0.0.2, de sorte que la fonction
est éligible pour une suppression future. Pour plus d'informations, voir Avis de suppression.
Procédure
Sélectionnez l'une des options suivantes pour modifier votre installation Liberty.
Ajoutez ou supprimez des modules complémentaires et des fonctions à l'aide de l'interface graphique. - Arrêtez tous les serveurs et toutes les applications sur l'installation
WebSphere Application Server Liberty Core modifiée.
- Démarrez Installation Manager.
- Cliquez sur Modifier.
- Sélectionnez le groupe de modules à modifier.
- Cliquez
sur Suivant.
Remarque : Si vous êtes invité à vous authentifier, utilisez l'ID et le mot de passe IBM avec lesquels vous vous êtes enregistré sur le site
Web du programme.
- Développez le produit IBM WebSphere Application Server Liberty installé.
- Cochez la case pour installer la fonction du conteneur d'EJB embarquable et du client JPA ou désélectionnez la case pour supprimer la fonction si elle est déjà installée. Cliquez ensuite sur Suivant.
- Choisissez si vous souhaitez ajouter ou supprimer des modules complémentaires et des fonctions Liberty.
- Pour ajouter des modules complémentaires ou des fonctions, procédez comme suit :
- Sélectionnez Ajouter des additifs et des fonctions. Vous pouvez également choisir de vous connecter au référentiel en ligne d'IBM WebSphere Liberty. Cliquez
sur Suivant.
- Sélectionnez les modules complémentaires à installer et cliquez sur Suivant.
Seuls les modules complémentaires qui ne sont pas déjà installés sont affichés.
- Sélectionnez les fonctions à installer et cliquez sur Suivant.
Seules les fonctions qui ne sont pas déjà installées sont affichées.
- Acceptez les termes du contrat de licence puis cliquez sur Suivant.
- Révisez les informations récapitulatives des modules complémentaires et des fonctions et cliquez sur Suivant.
- Pour supprimer des modules complémentaires ou des fonctions, procédez comme suit :
- Sélectionnez Retirer des additifs et des fonctions et cliquez sur Suivant.
- Sélectionnez les modules complémentaires à supprimer et cliquez sur Suivant.
- Sélectionnez les fonctions à supprimer et cliquez sur Suivant.
Si une fonction dépend d'autres fonctions que vous souhaitez désinstaller, vous devez également
désinstaller la fonction qui possède la dépendance.
- Révisez les informations récapitulatives des modules complémentaires et des fonctions et cliquez sur Suivant.
- Lisez le récapitulatif et cliquez sur Modifier.
Remarque : Seul(e) l'ajout / la suppression de la fonction du conteneur d'EJB embarquable et du client JPA est affiché(e).
- Si la modification aboutit, le programme affiche un message indiquant que l'installation a réussi.
- Dans le cas contraire, cliquez sur Afficher le fichier journal pour corriger l'erreur.
- Cliquez sur Terminer.
- Cliquez sur pour fermer Installation Manager.
- Ajoutez ou supprimez des fonctions à partir de la ligne de commande.
Le nom d'offre de la fonction du conteneur d'EJB embarquable et du client JPA client est embeddablecontainer. La fonction embeddablecontainer facultative
est ajoutée en spécifiant l'option -addFeatures et supprimée en spécifiant l'option -removeFeatures.
Le processus d'ajout et de suppression des actifs n'est pas le même lorsque vous modifiez une installation Liberty existante et lorsque vous installez initialement le produit. Pour ajouter
des modules complémentaires ou des fonctions Liberty, spécifiez les noms symboliques ou les noms abrégés sur la propriété user.addAssets et spécifiez le paramètre
-acceptLicense. Pour supprimer des modules complémentaires ou des fonctions, spécifiez les noms symboliques ou les noms abrégés sur la propriété
user.removeAssets, en les séparant par des virgules doubles.
Par défaut, toutes les fonctions et tous les modules complémentaires Liberty installés restent installés à moins que vous ne les supprimiez de manière spécifique.
Remarque : Vous pouvez installer des actifs depuis des instances du Service de référentiel d'actifs Liberty ou depuis les référentiels basés sur des répertoires
locaux avec ou sans accès Internet. Ajoutez l'URL du référentiel, le chemin d'accès au répertoire ou le chemin d'accès au fichier archive sur le paramètre -repositories. L'accès
à ces référentiels s'effectue dans l'ordre spécifié. Pour en savoir plus sur ces référentiels d'actifs, voir Installation d'actifs avec Installation Manager. Pour installer
des actifs depuis le référentiel IBM WebSphere Liberty, vous devez avoir accès à Internet. Pour permettre
l'accès au référentiel Liberty, sur le paramètre -properties, définissez l'option user.useLibertyRepository sur true.
Le référentiel Liberty est le dernier des référentiels auquel on accède lors de l'installation.
Conseil : Dans votre installation Liberty, utilisez l'action installUtility find pour afficher une liste des noms abrégés des actifs que vous pouvez installer.

L'exemple de commande suivant ajoute la fonction
embeddablecontainer d'Installation Manager, le modèle complémentaire
Liberty
ndMemberBundle et les fonctions
Liberty portlet-2.0 et
portletserving-2.0. La fonction
portlet-2.0 est spécifiée à l'aide du
nom symbolique tandis que
ndMemberBundle et
portletserving-2.0 sont spécifiés à l'aide des noms abrégés.
imcl.exe modify com.ibm.websphere.liberty.CORE.ND
-addFeatures embeddablecontainer
-properties user.addAssets=ndMemberBundle,,com.ibm.websphere.appserver.portlet-2.0,,portletserving-2.0
-repositories http://www.ibm.com/software/repositorymanager/com.ibm.websphere.liberty.CORE.ND
-installationDirectory "C:\Program Files\IBM\WebSphere\Liberty"
-secureStorageFile C:\credential.store -masterPasswordFile C:\master_password_file.txt
-acceptLicense

L'exemple de commande suivant supprime la fonction
embeddablecontainer d'Installation Manager, le modèle complémentaire
Liberty
ndMemberBundle et les fonctions
Liberty portlet-2.0 et
portletserving-2.0.
imcl.exe modify com.ibm.websphere.liberty
-removeFeatures embeddablecontainer
-properties user.removeAssets=ndMemberBundle,,com.ibm.websphere.appserver.portlet-2.0,,portletserving-2.0
-installationDirectory "C:\Program Files\IBM\WebSphere\Liberty"
-secureStorageFile C:\credential.store -masterPasswordFile C:\master_password_file.txt
- Ajoutez ou supprimez des fonctions à l'aide d'un fichier de réponses.
Le nom d'offre de la fonction du conteneur d'EJB embarquable et du client JPA client est embeddablecontainer. Pour ajouter cette fonction, spécifiez la fonction
embeddablecontainer sur l'attribut features de l'offre Liberty. Si la fonction est déjà installée et n'est pas spécifiée, elle est supprimée.
Le processus d'ajout et de suppression des actifs
Liberty n'est pas le même lorsque vous modifiez une installation
Liberty existante et lorsque vous installez initialement le produit. Pour
ajouter des modules complémentaires ou des fonctions, spécifiez les noms symboliques ou les noms abrégés sur la propriété
user.addAssets, en les séparant par des virgules
doubles. Lorsque vous ajoutez des fonctions, vous devez également accepter la licence utilisateur.
<data key='user.addAssets' value='ndMemberBundle,,com.ibm.websphere.appserver.portlet-2.0,,portletserving-2.0'/>
<data key='user.accept.license' value='true'/>
Pour supprimer des modules complémentaires ou des fonctions, spécifiez les noms symboliques ou les noms abrégés sur la propriété
user.removeAssets.
<data key='user.removeAssets' value='ndMemberBundle,,com.ibm.websphere.appserver.portlet-2.0,,portletserving-2.0'/>
Par défaut, toutes les fonctions et tous les modules complémentaires Liberty installés restent installés à moins que vous ne les supprimiez de manière spécifique.

L'exemple de fichier de réponses suivant modifie une installation pour ajouter la fonction Installation Manager
embeddablecontainer, le module
complémentaire
Liberty ndMemberBundle et les fonctions
Liberty portlet-2.0 et
portletserving-2.0. La fonction
portlet-2.0 est spécifiée à
l'aide du nom symbolique tandis que
ndMemberBundle et
portletserving-2.0 sont spécifiés à l'aide des noms abrégés.
<?xml version="1.0" encoding="UTF-8"?>
<agent-input clean='true' temporary='true'>
<server>
<repository location='http://www.ibm.com/software/repositorymanager/com.ibm.websphere.liberty.CORE.ND'/>
</server>
<install modify='true'>
<offering id='com.ibm.websphere.liberty.CORE.ND'
profile='WebSphere Liberty'
features='embeddablecontainer'/>
</install>
<profile id='WebSphere Liberty'
installLocation='C:\Program Files\IBM\WebSphere\Liberty'>
<data key='user.addAssets' value='ndMemberBundle,,com.ibm.websphere.appserver.portlet-2.0,,portletserving-2.0'/>
<data key='user.accept.license' value='true'/>
</profile>
</agent-input>