Les groupes de correctifs du produit contiennent un lot de correctifs de maintenance permettant
d'amener WebSphere Application Server Liberty
Core à un niveau supérieur du produit. Les correctifs temporaires fournissent la maintenance corrective associée à des problèmes connus spécifiques. Vous pouvez utiliser la fonction de ligne de commande
d'IBM® Installation Manager pour mettre à jour le produit avec les correctifs disponibles pour votre niveau de service de
l'installation WebSphere Application Server Liberty Core.
Avant de commencer
Important : La prise en charge de l'utilisation de Java™ SE 6 avec WebSphere
Liberty s'est terminée en septembre 2017. Le noyau Liberty a été recompilé à 17.0.0.3. A partir de 17.0.0.3, le noyau Liberty ne s'exécute plus avec Java SE
6. Si vous continuez d'utiliser Java SE 6 sur des versions antérieures après la date de fin de prise en charge, vous pouvez exposer votre environnement à
des risques de sécurité.
Java Platform, Standard Edition 8 est le kit de développement de logiciels Java
recommandé car il fournit les fonctions et les mises à jour de sécurité les plus récentes. Au lieu de Java SE 8, vous pouvez utiliser n'importe quel
version Java SDK prise en charge.
Contactez le service du support logiciel IBM pour plus d'informations sur les mises à jour de WebSphere Application Server for IBM i. Les dernières informations sont disponibles auprès du service du support logiciel IBM et de Fix Central.
IBM Installation Manager Version 1.8.5 (ou une version ultérieure) est utilisé pour appliquer la maintenance produit à
WebSphere Application Server for IBM i.
Si vous
voulez installer des actifs Liberty depuis des référentiels basés
sur un répertoire local ou une instance du Service du référentiel
d'actifs Liberty, configurez
les référentiels. Pour en savoir plus sur les référentiels d'actifs Liberty, voir Installation d'actifs avec Installation Manager.
Conseil : Au lieu d'exécuter la procédure décrite dans cet article, vous pouvez utiliser Installation Manager pour utiliser la ligne de commande updateAll dans un fichier de réponses ou sur la ligne de commande pour rechercher et mettre à jour tous les packages installés. Utilisez cette commande uniquement si vous contrôlez complètement les correctifs contenus dans les référentiels cible. Si vous créez un groupe de référentiels personnalisés contenant uniquement les correctifs que vous voulez installer et pointer vers ce groupe de référentiels, vous pouvez exécuter cette commande sans problème. Si vous activez la recherche dans les référentiels de service ou installez les correctifs directement depuis d'autres référentiels Web dynamiques, ne sélectionnez pas cette option pour pouvoir sélectionner uniquement les correctifs que vous voulez installer en utilisant l'option -installFixes de la commande install sur la ligne de commande ou l'attribut installFixes dans un fichier de réponses.
Pourquoi et quand exécuter cette tâche
Utilisez cette procédure lorsque vous voulez appliquer un nouveau groupe de correctifs au système.
Nouveau : Le groupe de correctifs 16.0.0.2 est le groupe de correctifs Liberty qui suit 8.5.5.9. Pour en savoir plus sur les modifications réalisées au niveau de la numérotation
et la livraison des groupes de correctifs Liberty, voir Nouveautés dans cette version de Liberty.
Lorsque vous installez un groupe de correctifs, Installation Manager ré-applique automatiquement tous les correctifs temporaires installés s'ils s'appliquent au niveau de groupe de correctifs
mis à jour. Les correctifs temporaires qui ne s'appliquent pas (par exemple, si le groupe de correctifs mis à jour contient déjà le correctif) sont désinstallés. Dans certains cas, Installation
Manager doit désinstaller un correctif temporaire que vous devez ré-appliquer manuellement. Par exemple, si vous effectuez une mise à jour vers un groupe de correctifs qui ne contient pas le
correctif et nécessite un niveau de correctif temporaire mis à jour. Installation Manager vous informe si un correctif temporaire doit être ré-appliqué manuellement. Vous pouvez vérifier quels
correctifs temporaires sont installés en exécutant la commande productInfo version --ifixes.
Procédure
- Pour obtenir la liste des correctifs disponibles pour WebSphere Application Server Liberty Core
et des informations spécifiques sur
chaque chacun, effectuez les actions suivantes.
- Accédez à Fix
Central.
- Cliquez sur Rechercher un produit.
- Sélectionnez WebSphere Liberty comme groupe de produits.
- Sélectionnez la version du produit à mettre à jour.
- Sélectionnez IBM i comme plateforme et cliquez sur Continuer.
- Sélectionnez Rechercher des correctifs et cliquez sur Continuer.
- Sélectionnez Groupe de correctifs comme type de correctif, puis cliquez sur Soumettre.
- Cliquez sur Plus d'informations sous chaque correctif pour afficher des informations sur le correctif.
- Recommandation : notez le nom du correctif à installer.
- Mettez à jour WebSphere Application Server Liberty Core avec le groupe de correctifs
en appliquant l'une
des procédures suivantes.
- Accédez au référentiel de service dynamique qui contient le groupe de correctifs et utilisez la mise à jour Web.
Utilisez Installation Manager sur
votre système local pour mettre
à jour
WebSphere Application Server Liberty Core avec les correctifs temporaires obtenus
des référentiels de service Web
dynamiques.
- Pour les référentiels de service dynamique, utilisez les mêmes URL que celles utilisées pour les référentiels d'offres du produit généralement disponibles au cours de l'installation. Ces
URL sont répertoriées dans Référentiels de produit en ligne des offres Liberty.
- Ces emplacements ne contiennent pas de pages Web auxquelles vous pouvez accéder en utilisant un navigateur Web. Il s'agit d'emplacements de référentiels Web qui vous pouvez définir pour
Installation Manager pour qu'il gère le produit.
Pour installer un correctif temporaire depuis un référentiel de service, procédez comme suit :
- Si vous ne disposez pas encore d'un fichier de stockage des données d'identification et d'un fichier de mots de passe principaux pour Installation Manager contenant votre ID utilisateur et votre mot de passe pour les logiciels
IBM, créez des fichiers vous permettant d'accéder au référentiel.
Remarque : Il s'agit des données d'identification que vous utilisez pour accéder aux sites Web protégés IBM.
Pour obtenir des informations sur la création du fichier de stockage des données
d'identification et du fichier de mots de passe principaux pour Installation Manager,
consultez la documentation produit d'IBM
Installation Manager.Conseil : Lors de la création d'un fichier de stockage des données d'identification, ajoutez
/repository.config à la fin de l'emplacement d'URL du référentiel si la commande imutilsc ne trouve pas l'URL indiquée.
- Connectez-vous au système IBM i avec un profil utilisateur ayant les droits spéciaux *ALLOBJ et *SECADM.
- Arrêtez tous les serveurs et toutes les applications sur l'installation
WebSphere Application Server Liberty Core qui est en cours de mise à jour.
- Sur la ligne de commande CL, exécutez la commande STRQSH pour démarrer l'interpréteur de commandes Qshell.
- Vérifiez que le paramètre umask est défini sur 022.
Pour tester le paramètre umask, exécutez la commande suivante :
umask
Pour définir le paramètre umask à 022, exécutez la commande suivante :
umask 022
- Accédez au répertoire fichiers_binaires_Installation_Manager/eclipse/tools, où fichiers_binaires_Installation_Manager est le répertoire racine d'installation d'Installation Manager.
Sur les systèmes IBM i, le répertoire racine d'Installation Manager est /QIBM/ProdData/InstallationManager.
- Installez le groupe de correctifs.
./imcl install offering_ID_offering_version,optional_feature_ID
-repositories repository_URL_or_path
-installationDirectory offering_installation_location
-secureStorageFile storage_file -masterPasswordFile master_password_file
-acceptLicense
Conseils : Nouveau : Lorsque vous mettez à jour Liberty, toutes les fonctions et tous les modules complémentaires Liberty installés sont également mis à jour.
Vous pouvez
installer des fonctions et des modules complémentaires additionnels en les spécifiant sur les propriétés user.addon et user.feature, comme illustré dans
l'exemple ci-dessous. Notez que les noms abrégés ou les noms symboliques des fonctions sont séparés par
des virgules doubles :./imcl install com.ibm.websphere.liberty.CORE.ND,embeddablecontainer
-properties user.addon=extendedPackage-1.0,user.feature=portlet-2.0,,portletserving-2.0
-installationDirectory /QIBM/ProdData/WebSphere/Liberty/LibertyCore -acceptLicense
-repositories /QIBM/LibertyProductRepo,https://your_onprem_asset_repo_url,/QIBM/LocalAssetRepo,/QIBM/LocalAssetRepo2.zip
-sharedResourcesDirectory /QIBM/UserData/InstallationManager/IMShared
-showProgress
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.
- ID_offre est l'ID d'offre listé dans Offres de produit Liberty pour les systèmes d'exploitation pris en charge.
- La valeur de offre_version, qui peut être liée à l'ID d'offre à l'aide d'un trait de soulignement, est une version spécifique de l'offre à installer
(16.0.2.20160503_0200 par exemple).
- Si la valeur version_offre n'est pas spécifiée, la dernière version de l'offre et tous les correctifs temporaires de la version sont installés.
- Si vous définissez version_offre, la version spécifiée de l'offre n'est pas installée et aucun correctif temporaire de la version n'est installé.
La version de l'offre peut être jointe à la fin de l'ID d'offre avec un trait de
soulignement lorsque vous exécutez la commande suivante sur le référentiel :
./imcl listAvailablePackages -repositories repository_URL_or_path
- Vous pouvez également définir none, recommended ou all avec l'argument -installFixes pour indiquer les correctifs temporaires à installer avec l'offre.
- Si la version de l'offre n'est pas spécifiée, la valeur all est attribuée
par défaut à l'option -installFixes.
- Si la version de l'offre est spécifiée, la valeur none est attribuée par défaut à
-installFixes.
- Pour installer le conteneur EJB embarquable et le client JPA, spécifiez la fonction facultative embeddablecontainer après l'ID d'offre, en les séparant par une virgule.
Le
conteneur d'EJB embarquable est un fichier archive Java (JAR) que vous pouvez utiliser pour exécuter des beans enterprise dans un
environnement Java Platform, Standard Edition
(SE) autonome. Vous pouvez exécuter les beans d'entreprise en utilisant ce conteneur embarquable en dehors du serveur d'applications. Le conteneur d'EJB embarquable fait partie de la spécification EJB
3.1 et il est principalement utilisé pour les tests unitaires de la logique métier de beans d'entreprise.
Le
client JPA peut être utilisé avec le conteneur d'EJB embarquable pour fournir la fonctionnalité Java Persistence API (JPA) dans un
environnement Java.
- Si vous avez obtenu le groupe de correctifs en installant la PTF de groupe WebSphere Application Server, vous pouvez utiliser les référentiels de groupes de correctifs locaux pour installer le groupe de correctifs.
Pour
en savoir plus les référentiels de groupes de correctifs locaux, voir le fichier /QIBM/WAS/WASFixpacks/Readme.html ou /QIBM/WAS/WASFixpacks/Readme.txt.
- Facultatif : listez tous les packages installés pour vérifier l'installation :
./imcl listInstalledPackages -long
- Téléchargez un fichier qui contient le groupe de correctif depuis Fix Central et utilisez la mise à jour locale.
Téléchargez les fichiers qui contiennent les groupes de correctifs depuis Fix Central. Chaque fichier de correctif compressé contient un référentiel Installation Manager pour le groupe de correctifs et il porte généralement l'extension .zip. Après avoir téléchargé le fichier du groupe de correctifs, vous pouvez utiliser Installation Manager
pour mettre à jour
WebSphere Application Server Liberty Core
avec le groupe de correctifs.
- Pour télécharger le groupe de correctifs, procédez comme suit :
- Accédez à Fix
Central.
- Cliquez sur Rechercher un produit.
- Sélectionnez WebSphere Liberty comme groupe de produits.
- Sélectionnez la version installée.
- Sélectionnez votre système d'exploitation comme plateforme et cliquez sur Continuer.
- Sélectionnez Rechercher des correctifs et cliquez sur Continuer.
- Sélectionnez le groupe de correctifs à télécharger et cliquez sur Continuer.
- Sélectionnez les options de téléchargement et cliquez sur Continuer.
- Cliquez sur J'accepte pour accepter les conditions.
- Cliquez sur Télécharger maintenant pour télécharger le groupe de correctifs.
- Transférez le fichier de correctif compressé dans le format binaire vers les systèmes IBM i sur lesquels vous voulez les installer.
- Extrayez les fichiers de référentiel compressés vers un répertoire de votre système.
- Pour installer un groupe de correctifs depuis un fichier téléchargé, procédez comme suit :
- Connectez-vous au système IBM i avec un profil utilisateur ayant les droits spéciaux *ALLOBJ et *SECADM.
- Arrêtez tous les serveurs et toutes les applications sur l'installation
WebSphere Application Server Liberty Core qui est en cours de mise à jour.
- Sur la ligne de commande CL, exécutez la commande STRQSH pour démarrer l'interpréteur de commandes Qshell.
- Vérifiez que le paramètre umask est défini sur 022.
Pour tester le paramètre umask, exécutez la commande suivante :
umask
Pour définir le paramètre umask à 022, exécutez la commande suivante :
umask 022
- Accédez au répertoire fichiers_binaires_Installation_Manager/eclipse/tools, où fichiers_binaires_Installation_Manager est le répertoire racine d'installation d'Installation Manager.
Sur les systèmes IBM i, le répertoire racine d'Installation Manager est /QIBM/ProdData/InstallationManager.
- Installez le groupe de correctifs.
./imcl install offering_ID_offering_version,optional_feature_ID
-repositories location_of_expanded_files
-installationDirectory offering_installation_location
-acceptLicense
Conseils : Nouveau : Lorsque vous mettez à jour Liberty, toutes les fonctions et tous les modules complémentaires Liberty installés sont également mis à jour.
Vous pouvez
installer des fonctions et des modules complémentaires additionnels en les spécifiant sur les propriétés user.addon et user.feature, comme illustré dans
l'exemple ci-dessous. Notez que les noms abrégés ou les noms symboliques des fonctions sont séparés par
des virgules doubles :./imcl install com.ibm.websphere.liberty.CORE.ND,embeddablecontainer
-properties user.addon=extendedPackage-1.0,user.feature=portlet-2.0,,portletserving-2.0
-installationDirectory /QIBM/ProdData/WebSphere/Liberty/LibertyCore -acceptLicense
-repositories /QIBM/LibertyProductRepo,https://your_onprem_asset_repo_url,/QIBM/LocalAssetRepo,/QIBM/LocalAssetRepo2.zip
-sharedResourcesDirectory /QIBM/UserData/InstallationManager/IMShared
-showProgress
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.
- ID_offre est l'ID d'offre listé dans Offres de produit Liberty pour les systèmes d'exploitation pris en charge.
- La valeur de offre_version, qui peut être liée à l'ID d'offre à l'aide d'un trait de soulignement, est une version spécifique de l'offre à installer
(16.0.2.20160503_0200 par exemple).
- Si la valeur version_offre n'est pas spécifiée, la dernière version de l'offre et tous les correctifs temporaires de la version sont installés.
- Si vous définissez version_offre, la version spécifiée de l'offre n'est pas installée et aucun correctif temporaire de la version n'est installé.
La version de l'offre peut être jointe à la fin de l'ID d'offre avec un trait de
soulignement lorsque vous exécutez la commande suivante sur le référentiel :
./imcl listAvailablePackages -repositories repository_URL_or_path
- Vous pouvez également définir none, recommended ou all avec l'argument -installFixes pour indiquer les correctifs temporaires à installer avec l'offre.
- Si la version de l'offre n'est pas spécifiée, la valeur all est attribuée
par défaut à l'option -installFixes.
- Si la version de l'offre est spécifiée, la valeur none est attribuée par défaut à
-installFixes.
- Pour installer le conteneur EJB embarquable et le client JPA, spécifiez la fonction facultative embeddablecontainer après l'ID d'offre, en les séparant par une virgule.
Le
conteneur d'EJB embarquable est un fichier archive Java (JAR) que vous pouvez utiliser pour exécuter des beans enterprise dans un
environnement Java Platform, Standard Edition
(SE) autonome. Vous pouvez exécuter les beans d'entreprise en utilisant ce conteneur embarquable en dehors du serveur d'applications. Le conteneur d'EJB embarquable fait partie de la spécification EJB
3.1 et il est principalement utilisé pour les tests unitaires de la logique métier de beans d'entreprise.
Le
client JPA peut être utilisé avec le conteneur d'EJB embarquable pour fournir la fonctionnalité Java Persistence API (JPA) dans un
environnement Java.
- Si vous avez obtenu le groupe de correctifs en installant la PTF de groupe WebSphere Application Server, vous pouvez utiliser les référentiels de groupes de correctifs locaux pour installer le groupe de correctifs.
Pour
en savoir plus les référentiels de groupes de correctifs locaux, voir le fichier /QIBM/WAS/WASFixpacks/Readme.html ou /QIBM/WAS/WASFixpacks/Readme.txt.
- Facultatif : listez tous les packages installés pour vérifier l'installation :
./imcl listInstalledPackages -long