Installation de Liberty sur des systèmes d'exploitation IBM i via la ligne de commande

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

[17.0.0.3 and later]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 :

  1. Téléchargez IBM Installation Manager.
    Il existe trois façons d'accéder aux fichiers d'installation d'Installation Manager.
    • Téléchargez la dernière version d'Installation Manager depuis le site Web IBM Installation Manager.
    • Installez Installation Manager à partir des référentiels de produit fournis sur le support.
    • Téléchargez les fichiers du site Passport Advantage et utilisez l'installation locale

      Les clients disposant d'une licence avec un ID et un mot de passe Passport Advantage peuvent télécharger les référentiels de produit à partir du site Passport Advantage.

  2. 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.
  3. Installez Installation Manager à l'aide de la ligne de commande d'Installation Manager.
    1. Connectez-vous au système IBM i avec un profil utilisateur ayant les droits spéciaux *ALLOBJ et *SECADM.
    2. Sur une ligne de commande CL, exécutez la commande STRQSH pour démarrer le shell de commandes Qshell.
    3. 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
    4. 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
      Remarques :

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

  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.
      For Windows platforms
      imutilsc.exe saveCredential 
        -secureStorageFile storage_file
        -userName user_ID -userPassword user_password
        -url repository_URL_or_path 
      For AIX platformsFor HP UNIX platformsFor LINUX platformsFor Solaris platforms
      ./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. Connectez-vous au système IBM i avec un profil utilisateur ayant les droits spéciaux *ALLOBJ et *SECADM.
  3. Sur une ligne de commande CL, exécutez la commande STRQSH pour démarrer le shell de commandes Qshell.
  4. 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
  5. Accédez au sous-répertoire eclipse/tools dans le répertoire d'installation d'Installation Manager.
  6. Utilisez la commande imcl pour installer le produit.
    ./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 install com.ibm.websphere.liberty.BASE,embeddablecontainer             
      -properties user.addon=extendedPackage-1.0,user.feature=portlet-2.0,,portletserving-2.0
      -installationDirectory /QIBM/ProdData/WebSphere/Liberty/Base -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.BASE,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 Liberty :
./imcl install com.ibm.websphere.liberty.BASE
  -repositories https://downloads.mycorp.com:8080/WAS_Liberty_repository
  -installationDirectory /QIBM/ProdData/WebSphere/Liberty/Base
  -properties was.install.os400.profile.location=/QIBM/UserData/WebSphere/Liberty/Base
  -sharedResourcesDirectory /QIBM/UserData/InstallationManager/IMShared
  -secureStorageFile $HOME/WASFiles/temp/credential.store -masterPasswordFile $HOME/WASFiles/IM/master_password_file.txt
  -acceptLicense

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

Nom du fichier : twlp_ins_installation_is_cl.html