Vous pouvez installer toutes les offres WebSphere Application Server Liberty à l'aide de la ligne de commande d'Installation Manager.
Avant de commencer
Remarque : La prise en charge de l'utilisation de Java Platform, Standard Edition 6 avec WebSphere Liberty cessera en septembre 2017. Après la prise en charge, le noyau Liberty sera
recompilé et ne pourra plus s'exécuter avec Java SE 6. Si vous continuez d'utiliser Java SE 6 sur des groupes de correctifs antérieurs 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. Pour en bénéficier, vous pouvez installer le kit de développement de logiciels IBM, Java Technology Edition, version 8 dans le groupe de modules qui contient WebSphere Liberty.
Préparez le système sur lequel vous voulez installer Liberty comme décrit dans Installation d'Installation Manager et préparation pour l'installation de Liberty.
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 les offres Liberty, lisez le contrat de licence fourni
avec les fichiers du produit. Indiquez que vous l'acceptez en spécifiant -acceptLicense dans la commande comme décrit dans cette rubrique.
Pourquoi et quand exécuter cette tâche
Toutes les offres produit, y compris les offre produit Liberty, les offres Java SDK et les autres logiciels disponibles, sont installés à l'aides des mêmes commandes d'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.
- Ouvrez une session sur votre système.
- Accédez au sous-répertoire eclipse/tools dans le répertoire d'installation
d'Installation Manager.
- Vérifiez que le référentiel de l'offre est disponible.

imcl.exe listAvailablePackages -repositories repository_URL_or_path




./imcl listAvailablePackages -repositories repository_URL_or_path
Vous voyez un ou plusieurs niveaux de l'offre.
- Utilisez la commande imcl pour installer l'offre.

imcl.exe install com.ibm.websphere.liberty.BASE_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




./imcl install com.ibm.websphere.liberty.BASE_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.exe install com.ibm.websphere.liberty.BASE,embeddablecontainer
-properties user.addon=extendedPackage-1.0,user.feature=portlet-2.0,,portletserving-2.0
-installationDirectory "C:\Program Files\IBM\WebSphere\Liberty" -acceptLicense
-repositories D:\IBM\LibertyRepo,https://your_onprem_asset_repo_url,D:\IBM\LocalAssetRepo,D:\IBM\LocalAssetRepo2.zip
-sharedResourcesDirectory D:\IBM\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 :
- 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 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.
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.
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.
- Installation Manager peut sauvegarder les versions antérieures d'un package pour rétrograder si vous rencontrez des problèmes plus tard. Quand Installation Manager rétrograde un package à une version
antérieure, les versions actuelles des fichiers sont désinstallées et
les versions antérieures sont réinstallées. Si vous décidez de ne pas sauvegarder les fichiers pour pouvoir revenir éventuellement à un niveau antérieur, vous pouvez empêcher la sauvegarde des fichiers en utilisant la préférence suivante dans la spécification de la commande :
-preference com.ibm.cic.common.core.preferences.preserveDownloadedArtifacts=False
en :Conseil : Même si vous choisissez de ne pas sauvegarder les fichiers en local en vue du rétablissement éventuel du niveau antérieur, vous pouvez revenir à n'importe quel niveau installé auparavant en accédant au référentiel de l'offre approprié.
- Installation Manager sélectionne automatiquement l'architecture du package d'installation en fonction de l'architecture de votre système d'exploitation. Sur les systèmes 64 bits, vous pouvez
spécifier une installation 32 bits en définissant la préférence suivante sur la valeur d'architecture 32 bits de votre système d'exploitation :
-properties cic.selector.arch=x86
Pour obtenir une liste des valeurs d'architecture de cic.selector.arch, veuillez vous reporter au tableau
Command-line arguments for the imcl
command de la documentation produit d'Installation Manager.
- 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.
- 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 l'offre, voir la
documentation produit d'IBM Installation Manager.