Vous pouvez installer une offre produit en utilisant la commande imcl install d'Installation Manager.
Avant de commencer
Préparez le système sur lequel vous voulez installer le produit comme décrit à la section Préparation du système d'exploitation en vue de l'installation du produit.
Installez IBM Installation Manager et vérifiez que vous pouvez accéder aux référentiels du produit. Reportez-vous aux rubriques
Installation d'Installation Manager et Configuration des référentiels de produit dans Installation Manager.
IBM Installation Manager version 1.8.5 ou ultérieure est requis pour l'installation du produit.
Important : Avant d'installer le produit, vous devez lire le contrat de licence qui se trouve avec les fichiers du produit. 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 ce produit. Acceptez les termes du contrat de licence en spécifiant -acceptLicense dans la commande.
Pourquoi et quand exécuter cette tâche
Toutes les offres produit peuvent être installées via la ligne de commande d'Installation Manager, y compris les offres suivantes :
- Toutes les éditions WebSphere
Application Server
- Application Client for WebSphere
Application Server
- DMZ Secure Proxy Server for WebSphere
Application Server
- IBM HTTP Server
- Plug-ins de serveur Web
- WebSphere Customization
Toolbox
Pour la liste complète des offres produit, voir Offres du produit WebSphere Application Server pour les systèmes d'exploitation pris en charge.
Pour les utilisateurs en transition: IBM SDK, Java™ Technology Edition version 8 est la version SDK Java pour WebSphere
Application Server
Version 9.0.
IBM SDK, Java Technology Edition n'est plus intégré aux offres WebSphere
Application Server. Java SDK est disponible sous la forme d'une offre distincte qui doit être installée en même temps que le produit.trns
Pour obtenir des informations sur l'utilisation de la commande imcl, voir la documentation IBM Installation Manager.
Procédure
- Ouvrez une session sur votre système.
Assurez-vous de vous connecter au système IBM i avec un profil utilisateur possédant les droits spéciaux *ALLOBJ et
*SECADM.
- Choisissez un emplacement de répertoire distinct pour les fichiers binaires. Si vous effectuez l'installation
depuis cette instance d'Installation Manager pour la première fois, choisissez également un emplacement pour les données partagées.
- Démarrez la ligne de commande.
Sur une ligne de commande CL, exécutez la commande STRQSH pour démarrer le shell de commandes Qshell.
- Vérifiez que vous disposez des droits nécessaires pour installer le produit dans les répertoires choisis.
- Accédez au sous-répertoire eclipse/tools dans le répertoire d'installation
d'Installation Manager.
- Vérifiez que le référentiel du produit est disponible.
La commande listAvailablePackages affiche un ou plusieurs niveaux de l'offre.
![[Windows]](../images/windows.gif)
imcl.exe listAvailablePackages -repositories source_repository
![[AIX]](../images/aixlogo.gif)
![[HP-UX]](../images/hpux.gif)
![[Linux]](../images/linux.gif)
![[Solaris]](../images/solaris.gif)
![[IBM i]](../images/iseries.gif)
./imcl listAvailablePackages -repositories source_repository
- Facultatif : Si le référentiel requiert un nom d'utilisateur et un mot de passe, créez un fichier des mots de passe maître et un fichier de stockage des données d'identification 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écuriser vos
données d'authentification.
Si vous créez un fichier des mots de passe maître lors de la création de vos données d'identification, vous devez toujours spécifier
ce 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.
![[Windows]](../images/windows.gif)
imutilsc.exe saveCredential
-secureStorageFile storage_file
-userName user_ID -userPassword user_password
-url source_repository
![[AIX]](../images/aixlogo.gif)
![[HP-UX]](../images/hpux.gif)
![[Linux]](../images/linux.gif)
![[Solaris]](../images/solaris.gif)
![[IBM i]](../images/iseries.gif)
./imutilsc saveCredential
-secureStorageFile storage_file
-userName user_ID -userPassword user_password
-url source_repository
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.
Pour plus d'informations, voir la documentation IBM Installation Manager.
- Exécutez la commande imcl pour installer l'offre produit.
La commande imcl est au format et possède les options illustrés dans les exemples suivants :
Important : IBM SDK Java Technology Edition n'étant plus imbriqué avec le produit, vous devez spécifier à la fois l'ID offre produit
et l'ID offre IBM Java SDK (
com.ibm.java.jdk.v8). L'offre produit ne peut pas être installée sans le kit Java SDK.
![[Windows]](../images/windows.gif)
imcl.exe install offering_ID_offering_version,optional_feature_ID com.ibm.java.jdk.v8
-repositories source_repository
-installationDirectory installation_directory
-sharedResourcesDirectory shared_directory
-accessRights access_mode
-preferences preference_key=value
-properties property_key=value
-secureStorageFile storage_file -masterPasswordFile master_password_file
-acceptLicense
![[AIX]](../images/aixlogo.gif)
![[HP-UX]](../images/hpux.gif)
![[Linux]](../images/linux.gif)
![[Solaris]](../images/solaris.gif)
./imcl install offering_ID_offering_version,optional_feature_ID com.ibm.java.jdk.v8
-repositories source_repository
-installationDirectory installation_directory
-sharedResourcesDirectory shared_directory
-accessRights access_mode
-preferences preference_key=value
-properties property_key=value
-secureStorageFile storage_file -masterPasswordFile master_password_file
-acceptLicense
![[IBM i]](../images/iseries.gif)
Important : Toutes les applications sous IBM i utilisent le kit Java SDK
fournit avec le système d'exploitation, et IBM SDK, Java Technology Edition ne peut pas être installé
avec les offres produit sous IBM i.
./imcl install offering_ID_offering_version,optional_feature_ID
-repositories source_repository
-installationDirectory installation_directory
-sharedResourcesDirectory shared_directory
-accessRights access_mode
-preferences preference_key=value
-properties property_key=value
-secureStorageFile storage_file -masterPasswordFile master_password_file
-acceptLicense
- Installation des offres et des fonctions facultatives
Pour certaines offres, vous pouvez ajouter une liste séparée par des virgules de fonctions facultatives à installer. Si vous ne spécifiez pas de fonctions facultatives, un ensemble par défaut de fonctions est installé. Pour installer uniquement les fonctions votre choix, spécifiez leur liste explicite.
Les ID offre, fonctions facultatives de chaque offre et fonction par défaut sont indiquées dans le tableau suivant.
Tableau 1. ID offre et fonction facultativesID offre |
ID fonction facultative |
Fonctions par défaut |
WebSphere
Application Server, Network Deployment com.ibm.websphere.ND.v90
|
- core.feature: WebSphere
Application Server
Cette fonction
doit être spécifiée lorsque vous indiquez les sous-fonctions facultatives suivantes : - samples : modèles d'application
- thinclient : clients légers autonomes et adaptateurs de ressources
- embeddablecontainer : conteneur EJB incorporable
- ejbdeploy : outil EJBDeploy pour les modèles antérieurs à EJB 3.0
Remarque : Vous ne pouvez pas utiliser Installation Manager pour modifier, mettre à jour
ou restaurer une version antérieure de fonctions pour ensuite ajouter ou retirer core.feature. Seules les sous-fonctions peuvent être ajoutées ou retirées.
|
- core.feature
- thinclient
- embeddablecontainer
- ejbdeploy
|
Application Client for WebSphere
Application Server com.ibm.websphere.APPCLIENT.v90
|
- samples : exemples
- standalonethinclient.resourceadapter.runtime : exécution de clients légers autonomes
- standalonethinclient.resourceadapter.samples : exemples de clients légers autonomes
- embeddablecontainer : conteneur EJB incorporable
|
embeddablecontainer |
DMZ Secure Proxy Server for IBM WebSphere Application Server com.ibm.websphere.NDDMZ.v90
|
- core.feature: DMZ Secure Proxy Server for IBM WebSphere Application Server
Cette fonction
doit être spécifiée lorsque vous indiquez la sous-fonction facultative suivante : - thinclient : clients légers autonomes et adaptateurs de ressources
|
Aucune fonction par défaut |
Plug-ins de serveur Web com.ibm.websphere.PLG.v90
|
Aucune fonction facultative |
N/D |
WebSphere Customization
Toolbox com.ibm.websphere.WCT.v90
|
- zpmt : outil de gestion de profil (z/OS uniquement)
- zmmt : z/OS Migration Management Tool
- pct : Outil de configuration de plug-ins de serveur Web
|
Toutes les fonctions facultatives sont installées par défaut
|
- Spécification d'une version d'offre
La version_offre, qui peut être liée à l'ID offre avec un caractère de soulignement, est une version spécifique de l'offre à installer
(9.0.0.x_0200 par exemple).
- Si la 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 la version_offre est spécifiée, la version spécifiée de l'offre est installée, et aucun correctif temporaire de cette version ne l'est.
La version de l'offre peut être jointe à la fin de l'ID offre avec un trait de
soulignement lorsque vous exécutez la commande suivante sur le référentiel :
imcl listAvailablePackages -repositories source_repository
- Installation des correctifs temporaires
Pour indiquer quels correctifs temporaires vous souhaitez installer avec l'offre, spécifiez none, recommended ou all avec
l'argument -installFixes.
- 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.
- Spécification des droits d'accès
Le paramètre -accessRights n'est pas requis si vous avez antérieurement spécifié le mode dans lequel vous souhaitez installer Installation Manager.
- Choisissez si vous souhaitez sauvegarder des versions de packages pour la rétrogradation
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
Conseil : Même si vous choisissez de ne pas sauvegarder les fichiers en local pour rétablissement éventuel du niveau antérieur, vous pouvez revenir à n'importe quel niveau installé auparavant en accédant au référentiel produit approprié.
Pour plus d'informations sur la configuration des préférences d'Installation Manager, voir la documentation IBM Installation Manager.
Définition de user_data_root
![[IBM i]](../images/iseries.gif)
Pratiques recommandées: Dans le cas d'installations initiales, il est recommandé de spécifier
user_data_root, faute de quoi, la valeur par défaut de
user_data_root est
/QIBM/UserData/WebSphere/AppServer/V9/ND.
bprac
Pour spécifier user_data_root, exécutez la commande imcl avec le chemin de fichier user_data_root indiqué à la propriété was.install.os400.profile.location. Exemple : -properties
was.install.os400.profile.location=/QIBM/UserData/WebSphere/AppServer/V9/ND.
Exemples
![[Windows]](../images/windows.gif)
L'exemple suivant illustre l'installation de la version la plus récente de
WebSphere
Application Server sous système d'exploitation Windows :
imcl install com.ibm.websphere.ND.v90 com.ibm.java.jdk.8
-installationDirectory "C:\Program Files\IBM\WebSphere\AppServer"
-sharedResourcesDirectory "C:\Program Files\IBM\IMShared"
-repositories C:\IBM\REP\WSAS9ENT
-acceptLicense
-showProgress
-log installv9.xml
-preferences com.ibm.cic.common.core.preferences.keepFetchedFiles=false,com.ibm.cic.common.core.preferences.preserveDownloadedArtifacts=false
![[IBM i]](../images/iseries.gif)
L'exemple suivant illustre l'installation de la version la plus récente de
WebSphere
Application Server sous système d'exploitation IBM i :
./imcl install com.ibm.websphere.ND.v90
-repositories https://downloads.mycorp.com:8080/WAS_90_repository
-installationDirectory /QIBM/ProdData/WebSphere/AppServer/V9/ND
-properties was.install.os400.profile.location=/QIBM/UserData/WebSphere/AppServer/V9/ND
-sharedResourcesDirectory /QIBM/UserData/InstallationManager/IMShared
-secureStorageFile $HOME/WASFiles/temp/credential.store
-acceptLicense
Que faire ensuite
Lorsque l'installation se termine, le programme peut écrire des instructions importantes concernant la post-installation dans la sortie standard.