Vous pouvez installer toutes les offres WebSphere Application Server Liberty
sur les systèmes d'exploitation IBM®
i à l'aide de la ligne de commande d'Installation Manager.
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.
Préparez-vous à l'installation avant de suivre la procédure ci-après. Voir Préparation du système d'exploitation en vue de l'installation sur IBM i pour plus d'informations.
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.
Important : Avant d'installer Liberty, vous devez lire le contrat de licence fourni
avec les fichiers produit. Indiquez que vous l'acceptez en spécifiant -acceptLicense dans la commande comme décrit dans cette rubrique.
Si
IBM Installation Manager Version 1.8.5 (ou une version ultérieure) n'est pas déjà installé, installez-le sur le système sur lequel vous souhaitez installer le produit :
- Téléchargez IBM Installation Manager.
Il existe trois façons d'accéder aux fichiers d'installation d'Installation Manager.
- Choisissez trois emplacements distincts pour les fichiers binaires d'Installation Manager, pour les données d'exécution (données de l'agent) et pour les données partagées.
- Installez
Installation Manager à l'aide de la ligne de commande d'Installation Manager.
- Connectez-vous au système IBM i avec un profil utilisateur ayant les droits spéciaux *ALLOBJ et *SECADM.
- Sur une ligne de commande CL, exécutez la commande STRQSH pour démarrer le shell 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 à l'emplacement contenant les fichiers d'installation d'Installation Manager et exécutez la commande suivante :
installc -acceptLicense -log log_file_path_and_name
Pourquoi et quand exécuter cette tâche
Toutes les offres produit, y compris les offres produit
Liberty et les autres logiciels disponibles, sont installés à l'aide des mêmes commandes Installation Manager. Pour installer une
offre différente, suivez ces étapes mais remplacez l'ID d'offre et toute fonction facultative par l'ID et les fonction de l'offre.
Nouveau : Lorsque vous installez
Liberty, par défaut, toutes les fonctions
Liberty qui s'appliquent à votre édition de produit
Liberty sont également installées.
Vous pouvez également installer un
ensemble de fonctions différent ou aucune fonction. Pour plus d'informations, voir la section
Conseils.
Procédure
- Facultatif : Si le référentiel requiert un nom d'utilisateur et un mot de
passe, créez un fichier de stockage des données d'identification et
un fichier des mots de passe principaux pour accéder à ce référentiel.
- Facultatif : Créez le fichier des mots de passe maître.
Le fichier des mots de passe maître est un fichier texte contenant une phrase de passe telle que "Ce texte est le mot de passe maître." Ce fichier est utilisé pour sécurisé vos données
d'authentification.
Si vous créez un fichier des mots de passe maître et si vous l'utilisez lorsque vous créez des données d'identification, vous devez toujours spécifier le fichier des mots de passe maître.
Conseil : Pour sécuriser ce fichier, définissez des droits pour restreindre son accès conformément à votre système d'exploitation.
- Créez un fichier de stockage des données d'identification en exécutant la commande imutilsc saveCredential.

imutilsc.exe saveCredential
-secureStorageFile storage_file
-userName user_ID -userPassword user_password
-url repository_URL_or_path




./imutilsc saveCredential
-secureStorageFile storage_file
-userName user_ID -userPassword user_password
-url repository_URL_or_path
Conseil : Si la commande imutilsc ne parvient pas à trouver l'URL qui est spécifiée lorsque vous créez le fichier de stockage des données d'identification, ajoutez
/repository.config à la fin de l'emplacement de l'URL du référentiel.
- Connectez-vous au système IBM i avec un profil utilisateur ayant les droits spéciaux *ALLOBJ et *SECADM.
- Sur une ligne de commande CL, exécutez la commande STRQSH pour démarrer le shell 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 sous-répertoire eclipse/tools dans le répertoire d'installation
d'Installation Manager.
- Utilisez la commande imcl pour installer le produit.
./imcl install com.ibm.websphere.liberty.CORE.ND_offering_version,optional_feature_ID
-repositories repository_URL_or_path
-installationDirectory installation_directory
-sharedResourcesDirectory shared_directory
-preferences preference_key=value
-properties property_key=value
-secureStorageFile storage_file -masterPasswordFile master_password_file
-acceptLicense
Conseils : Nouveau : Lorsque vous installez Liberty, par défaut, toutes les fonctions Liberty qui s'appliquent à votre édition de produit Liberty sont également installées.
Au lieu d'installer toutes les fonctions, vous pouvez installer un ensemble personnalisés de fonctions et de modules complémentaires Liberty en les spécifiant sur les propriétés
user.addon et user.feature, comme indiqué 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.
Important : Si vous ne souhaitez pas installer les modules complémentaires ou les fonctions
Liberty, spécifiez le paramètre -properties user.addon="" user.feature="".
Pour
plus d'informations, voir les rubriques suivantes :
- Les dispositions, remarques et autres informations appropriées sont fournies
dans les fichiers du contrat de licence du sous-répertoire lafiles
ou nom_offre/lafiles du référentiel ou de
l'image d'installation de cette offre.
- La première fois que vous installez un package à l'aide
d'Installation Manager, vous pouvez spécifier le répertoire des
ressources partagées. Le répertoire des ressources partagées est l'endroit où les artefacts d'installation se trouvent ; il peut être utilisé par un plusieurs groupe de packages. Il est également utilisé comme zone de transfert pour le contenu du produit au cours des opérations d'installation. Par défaut, ce contenu est mis en cache pour pouvoir être utilisé en cas d'annulation. Utilisez votre unité ayant la taille la plus importante pour cette installation. Vous ne pouvez pas changer l'emplacement du répertoire tant que vous n'avez pas désinstallé tous les packages.
- La valeur de version_offre, 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 d'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 :
imcl install com.ibm.websphere.liberty.CORE.ND,embeddablecontainer
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.
- Pour les installations initiales, il est conseillé de spécifier racine_données_utilisateur, car dans le cas contraire la valeur par défaut de
racine_données_utilisateur, /QIBM/UserData/WebSphere/Liberty/EDITION, est utilisée. Utilisez la propriété was.install.os400.profile.location pour spécifier la valeur de racine_données_utilisateur.
- Le programme peut générer des instructions post-installation importantes dans la sortie
standard.
Pour plus d'informations sur l'utilisation de la commande imcl pour installer le produit, consultez la
documentation d'IBM Installation Manager.
Exemple
Voici un exemple d'utilisation de la commande
imcl pour installer
WebSphere Application Server LibertyCore :
./imcl install com.ibm.websphere.liberty.CORE.ND
-repositories https://downloads.mycorp.com:8080/WAS_Liberty_repository
-installationDirectory /QIBM/ProdData/WebSphere/Liberty/LibertyCore
-properties was.install.os400.profile.location=/QIBM/UserData/WebSphere/Liberty/LibertyCore
-sharedResourcesDirectory /QIBM/UserData/InstallationManager/IMShared
-secureStorageFile $HOME/WASFiles/temp/credential.store -masterPasswordFile $HOME/WASFiles/IM/master_password_file.txt
-acceptLicense