Installation de Liberty sur des systèmes d'exploitation distribués via la ligne de commande

Vous pouvez installer toutes les offres WebSphere Application Server Liberty en utilisant la ligne de commande d'Installation Manager.

Avant de commencer

[16.0.0.4 et ultérieur]Remarque : Le support d'utilisation de Java™ SE 6 avec WebSphere Liberty cessera en septembre 2017. Après la fin du support officiel, le noyau Liberty sera recompilé et ne pourra plus fonctionner avec Java SE 6. Si vous continuez d'utiliser Java SE 6 sur d'anciens groupes de correctifs après la fin du support, vous exposez 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 package du SDK IBM® Java Technology Edition, version 8 dans le groupe de packages 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

  1. 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.
    1. 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.
    2. Créez un fichier de stockage des données d'identification en exécutant la commande imutilsc saveCredential.
      Pour plateformes Windows
      imutilsc.exe saveCredential 
        -secureStorageFile storage_file
        -userName user_ID -userPassword user_password
        -url repository_URL_or_path 
      Pour plateformes AIXPour plateformes HP UNIXPour plateformes LINUXPour plateformes Solaris
      ./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.
  2. Ouvrez une session sur votre système.
  3. Accédez au sous-répertoire eclipse/tools dans le répertoire d'installation d'Installation Manager.
  4. Vérifiez que le référentiel de l'offre est disponible.
    Pour plateformes Windows
    imcl.exe listAvailablePackages -repositories repository_URL_or_path
    Pour plateformes AIXPour plateformes HP UNIXPour plateformes LINUXPour plateformes Solaris
    ./imcl listAvailablePackages -repositories repository_URL_or_path
    Vous voyez un ou plusieurs niveaux de l'offre.
  5. Utilisez la commande imcl pour installer l'offre.
    Pour plateformes Windows
    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
    Pour plateformes AIXPour plateformes HP UNIXPour plateformes LINUXPour plateformes Solaris
    ./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="".
    • 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, consultez la documentation produit d'IBM Installation Manager.


Icône indiquant le type de rubrique Rubrique Tâche

Nom du fichier : twlp_ins_installation_dist_cl.html