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

Vous pouvez installer WebSphere Application Server Liberty Core sur les systèmes d'exploitation IBM® i via la ligne de commande d'Installation Manager.

Avant de commencer

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.

Référentiel Liberty[8.5.5.6 ou ultérieure]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 plus d'informations sur les référentiels d'actifs Liberty, voir Installation d'actifs avec Installation Manager.

Important : Avant d'installer WebSphere Application Server Liberty Core, lisez le contrat de licence que vous trouverez avec les fichiers du produit. Indiquez que vous l'acceptez en spécifiant -acceptLicense dans la commande comme décrit dans cette rubrique.
Installez Installation Manager sur le système où vous voulez installer le produit.
  • Si vous voulez utiliser l'instance d'Installation Manager livrée avec ce produit, effectuez les actions suivantes :
    1. Procurez-vous les fichiers nécessaires.
      Il existe trois options de base pour obtenir et installer Installation Manager et le produit.
      • Accédez au support physique et utilisez une installation locale
        Vous pouvez accéder aux référentiels de produit depuis le support physique.
        1. Installez Installation Manager sur votre système.

          Vous pouvez installer Installation Manager en utilisant le support physique, un fichier obtenu depuis le site Passport Advantage ou un fichier contenant la dernière version d'Installation Manager depuis le site Web des téléchargements IBM Installation Manager.

        2. Utilisez Installation Manager pour installer le produit depuis les référentiels de produit présents sur le support.
      • Télécharger les fichiers à partir du site Passport Advantage et utiliser l'installation locale
        Les clients disposant d'une licence dotés d'un ID et d'un mot de passe Passport Advantage peuvent télécharger les référentiels de produit requis depuis le site Passport Advantage.
        1. Téléchargez les fichiers à partir du site Passport Advantage.
        2. Installez Installation Manager sur votre système.

          Vous pouvez installer Installation Manager en utilisant le support physique, un fichier obtenu depuis le site Passport Advantage ou un fichier contenant la dernière version d'Installation Manager depuis le site Web des téléchargements IBM Installation Manager.

        3. Utiliser le gestionnaire d'installation pour installer le produit depuis les référentiels téléchargés.
      • Accédez aux référentiels opérationnels et utilisez l'installation Web
        Si vous disposez d'un ID et d'un mot de passe Passport Advantage, vous pouvez installer le produit à partir des référentiels en ligne.
        1. Installez Installation Manager sur votre système.

          Vous pouvez installer Installation Manager en utilisant le support physique, un fichier obtenu depuis le site Passport Advantage ou un fichier contenant la dernière version d'Installation Manager depuis le site Web des téléchargements IBM Installation Manager.

        2. Utilisez Installation Manager pour installer le produit à partir du référentiel Web disponible dans
          http://www.ibm.com/software/repositorymanager/com.ibm.websphere.liberty.v85 
          Remarque : Cet emplacement ne contient pas de page Web à laquelle vous pouvez accéder à l'aide d'un navigateur Web. Il s'agit d'un emplacement de référentiel en ligne distant que vous devez spécifier pour la valeur du paramètre -repositories, de sorte que la commande imcl puisse accéder aux fichiers de ce référentiel pour installer le produire.

        Si possible, vous devez utiliser les référentiels Web distants afin de pouvoir accéder aux fichiers d'installation les plus récents.

      Remarque : Si vous ne disposez pas d'un ID et d'un mot de passe Passport Advantage, vous devez installer le produit depuis les référentiels de produit sur le support physique ou depuis les référentiels locaux.
    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 chemin_et_nom_fichier_journal
        Notes :
  • Si vous disposez déjà d'une version d'Installation Manager sur votre système et souhaitez l'utiliser pour installer le produit et gérer le produit, obtenez les fichiers de produit nécessaires.
    Il existe trois options de base pour l'installation du produit.
    • Accédez au support physique et utilisez une installation locale

      Vous pouvez accéder aux référentiels de produit depuis le support physique. Utilisez Installation Manager pour installer le produit depuis les référentiels de produit présents sur le support.

    • Télécharger les fichiers à partir du site Passport Advantage et utiliser l'installation locale
      Les clients disposant d'une licence dotés d'un ID et d'un mot de passe Passport Advantage peuvent télécharger les référentiels de produit requis depuis le site Passport Advantage.
      1. Télécharger les référentiels produit depuis le site Passport Advantage.
      2. Utiliser le gestionnaire d'installation pour installer le produit depuis les référentiels téléchargés.
    • Accédez aux référentiels opérationnels et utilisez l'installation Web
      Si vous avez un ID et un mot de passe Passport Advantage, vous pouvez à l'aide d'Installation Manager installer le produit à partir des référentiels Web. Utilisez Installation Manager pour installer le produit à partir du référentiel Web disponible dans
      http://www.ibm.com/software/repositorymanager/com.ibm.websphere.liberty.v85 
      Remarque : Cet emplacement ne contient pas de page Web à laquelle vous pouvez accéder à l'aide d'un navigateur Web. Il s'agit d'un emplacement de référentiel Web distant que vous devez définir dans le paramètre -repositories pour que la commande imcl puisse accéder aux fichiers du référentiel pour installer le produit.

      Si possible, vous devez utiliser les référentiels Web distants afin de pouvoir accéder aux fichiers d'installation les plus récents.

    Remarque : Si vous ne disposez pas d'un ID et d'un mot de passe Passport Advantage, vous devez installer le produit depuis les référentiels de produit sur le support physique ou depuis les référentiels locaux.

Pourquoi et quand exécuter cette tâche

[8.5.5.4 ou ultérieure]Pour installer la version 8.5.5.4 et versions suivantes du profil Liberty, vous devez disposer d'IBM Installation Manager version 1.6.2 ou suivante.

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 pour accéder à ce référentiel.
    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.
    Remarque : Lorsque vous utilisez Installation Manager version 1.6.2 ou une version ultérieure, utilisez les options -secureStorageFile et -masterPasswordFile pour stocker les données d'identification dans un fichier de stockage des données d'identification. Dans les versions d'Installation Manager antérieures à la version 1.6.2, les options -keyring et -password étaient utilisées pour accéder aux données d'identification dans un fichier de clés. Ces options ont été dépréciées dans la version 1.6.2. Il n'existe pas de chemin de migration entre les fichier de clés et les fichiers de stockage en raison des différences entre les structures de fichiers. Pour plus d'informations sur l'utilisation des options -secureStorageFile et -masterPasswordFile afin de stocker les données d'identification dans un fichier de stockage des données d'identification, voir le centre de documentation d'Installation Manager version 1.6. Pour plus d'informations sur l'utilisation des options -keyring et -password pour stocker les données d'identification dans un fichier de clés, voir le centre de documentation d'Installation Manager version 1.5.
  2. Choisissez trois emplacements distincts pour les fichiers binaires du produit, pour les données d'exécution (données de l'agent) et pour les données partagées.
  3. Connectez-vous au système IBM i avec un profil utilisateur ayant les droits spéciaux *ALLOBJ et *SECADM.
  4. Sur une ligne de commande CL, exécutez la commande STRQSH pour démarrer le shell de commandes Qshell.
  5. 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
  6. Accédez au sous-répertoire eclipse/tools dans le répertoire d'installation d'Installation Manager.
  7. Utilisez la commande imcl pour installer le produit.
    ./imcl install
    com.ibm.websphere.liberty.v85_offering_version,optional_feature_ID
      -repositories référentiel_source 
      -installationDirectory répertoire_installation 
      -sharedResourcesDirectory répertoire_partagé
      -preferences clé_préférence=valeur
      -properties clé_propriété=valeur
      -secureStorageFile fichier_stockage -masterPasswordFile fichier_mots_de_passe_principaux
      -acceptLicense
    Conseils :
    • Les dispositions, remarques et autres informations appropriées sont fournies dans les fichiers du contrat de licence du sous-répertoire lafiles ou nom_produit/lafiles du référentiel ou de l'image d'installation de cette offre.
    • Vous pouvez installer une liste de fonctions séparées par des virgules.
      • Conteneur d'EJB pouvant être imbriqué et client JPA (embeddablecontainer)

        Cette option installe le conteneur d'EJB pouvant être imbriqué et le client JPA.

        Le conteneur d'EJB pouvant être imbriqué 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 un bean d'entreprise à l'aide de ce conteneur pouvant être imbriqué en dehors du serveur d'applications. Le conteneur EJB pouvant être imbriqué fait partie de la spécification EJB 3.1 et 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 pouvant être imbriqué pour fournir la fonctionnalité Java Persistence API (JPA) dans un environnement Java.

      Notes :
      • Si aucune fonction n'est spécifiée, la fonction par défaut (embeddablecontainer) est installée.
    • Référentiel Liberty[8.5.5.2 ou ultérieure]Vous pouvez spécifier des ressources actifs supplémentaires à installer depuis le référentiel Liberty. Pour la liste de tous les actifs de référentiel Liberty, consultez la page des téléchargements sur WASdev.net.

      Pour installer des actifs du référentiel Liberty, vous devez avoir accès à Internet et disposer d'IBM Installation Manager version 1.6.2 ou ultérieure.

      Si vous voulez installer des fonctions de référentiel supplémentaires, indiquez les noms abrégés ou les noms symboliques dans l'option user.feature du paramètre -properties. Les noms de fonctions multiples sont séparés par une double virgule. L'exemple suivant installe les fonctions Conteneur de portlet et Service de portlet :
      -properties user.feature=portlet-2.0,,portletserving-2.0,user.accept.license=true
      [8.5.5.5 ou ultérieure]Pour la version 8.5.5.5 et les versions suivantes, user.accept.license=true n'est pas obligatoire.
      Référentiel Liberty[8.5.5.4 ou ultérieure]A partir de la version 8.5.5.4, la fonction extprogmodels n'est plus disponible. Installez à la place le module complémentaire extendedPackage-1.0, ou installez les fonction individuelles du référentiel Liberty dont vous avez besoin. Voir les rubriques suivantes pour en savoir plus :
      Vous pouvez installer l'ensemble complet de fonctions Modèles de programmation étendue en spécifiant l'option user.addon :
      -properties user.addon=extendedPackage-1.0,user.accept.license=true
      Si vous effectuez une mise à niveau depuis le profil Liberty version 8.5.5.3 ou suivante de WebSphere Application Server contenant la fonction d'installation extprogmodels, Installation Manager installe automatiquement le module complémentaire extendedPackage-1.0. Vous devez spécifier l'option user.accept.license :
      -properties user.accept.license=true
      Référentiel Liberty[8.5.5.6 ou ultérieure]Vous pouvez aussi installer les actifs depuis des instances du Service du référentiel d'actifs Liberty ou depuis un référentiel basé sur un répertoire local. Pour plus d'informations sur ces référentiels d'actifs, voir Installation d'actifs avec Installation Manager. Ajoutez l'URL du référentiel ou le répertoire dans le paramètre -repositories. Les référentiels sont utilisés dans lequel il sont indiqués. Par défaut, le référentiel Liberty est le dernier des référentiels utilisés lors de l'installation. Pour désactiver l'accès au référentiel Liberty, dans le paramètre -properties, définissez l'option user.useLibertyRepository sur false. L'exemple suivant installe les actifs d'abord depuis l'instance https://your_onprem_asset_repo_url du Service du référentiel d'actifs Liberty. Si les actifs ne sont pas disponibles, ils sont installés depuis le référentiel basé sur un répertoire local /QIBM/LocalAssetRepo. L'accès au référentiel Liberty d'IBM WebSphere est désactivé :
      ./imcl install com.ibm.websphere.liberty.v85
      -properties user.useLibertyRepository=false,user.addon=extendedPackage-1.0,user.feature=portlet-2.0
      -installationDirectory /QIBM/ProdData/Liberty -acceptLicense
      -repositories /QIBM/LibertyProductRepo,https://your_onprem_asset_repo_url,/QIBM/LocalAssetRepo
      -sharedResourcesDirectory /QIBM/UserData/InstallationManager/IMShared
      -showProgress
      Pour en savoir plus sur le référentiel Liberty et sur les actifs qu'il contient, voir Référentiel Liberty.
    • version_offre, qui peut être éventuellement lié à l'ID d'offre avec le caractère de soulignement, est une version spécifique de l'offre à installer (8.5.5.20110503_0200 par exemple).
      • Si version_offre n'est pas spécifié, 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 référentiel_source
    • 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.
    • Dans le cas d'une installation initiale, il est recommandé de spécifier la valeur de racine_données_utilisateur ; sinon, la valeur par défaut pour racine_données_utilisateur, /QIBM/UserData/WebSphere/AppServer/V85/LibertyCore, est utilisée. Utilisez la propriété was.install.os400.profile.location pour spécifier la valeur de racine_données_utilisateur. Si la valeur de racine_données_utilisateur doit être /QIBM/UserData/WebSphere/AppServer/V85/Liberty par exemple, spécifiez -properties was.install.os400.profile.location=/QIBM/UserData/WebSphere/AppServer/V85/Liberty dans la commande d'installation imcl.
    • 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 afin d'installer le produit, voir le centre de documentation 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.v85
  -repositories https://downloads.mycorp.com:8080/WAS_85_repository
  -installationDirectory /QIBM/ProdData/WebSphere/AppServer/V85/LibertyCore
  -properties was.install.os400.profile.location=/QIBM/UserData/WebSphere/AppServer/V85/LibertyCore
  -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

Dispositions pour les centres de documentation | Commentaires


Icône d'horodatage Dernière mise à jour: Wednesday, 2 September 2015
http://www14.software.ibm.com/webapp/wsbroker/redirect?version=phil&product=was-libcore-mp&topic=twlp_ins_installation_is_cl
Nom du fichier : twlp_ins_installation_is_cl.html