[8.5.5.6 ou ultérieure]

Commande installUtility

Utilisez la commande installUtility pour rechercher, obtenir des informations, et installer des actifs d'un référentiel vers un référentiel distant, ou le référentiel IBM® WebSphere Liberty.

Syntaxe

La syntaxe de la commande est la suivante :

installUtility action [options]
La variable action peut prendre l'une des valeurs suivantes :
download
Télécharge les actifs depuis les référentiels.
find
Recherche des actifs dans les référentiels qui s'appliquent à votre configuration, pou afficher des informations détaillées sur les actifs.
help
Affiche des informations d'aide pour l'action spécifiée.
install
Installe les actifs ou un fichier ESA dans l'environnement d'exécution, ou déploie un package serveur et installe les fonctions requises de ce package.
testConnection
Teste la connexion à un référentiel.
uninstall
Désinstalle des fonctions en indiquant le nom abrégé ou le nom symbolique de la fonction. Vous pouvez spécifier plusieurs fonctions séparées par un espace.
Remarque : Assurez-vous que tous les processus serveur sont arrêtés avant de désinstaller une fonction.
viewSettings
Affiche les paramètres de proxy et de référentiel pour la commande installUtility.
Lorsque vous utilisez ces actions, la commande installUtility peut accéder aux actifs dans les référentiels suivants :

Options

Les options suivantes sont disponibles pour la commande installUtility install :
--acceptLicense
Accepter les dispositions du contrat de licence.
--to=option_install
L'option install_option peut prendre l'une des valeurs suivantes :
  • user: La fonction est installée en tant que fonction utilisateur. Cette valeur est la valeur par défaut.
  • extension : Emplacement d'installation de la fonction. Vous pouvez installer la fonction dans n'importe quel emplacement d'extension de produit.
--viewLicenseAgreement
Afficher le contrat de licence.
--viewLicenseInfo
Afficher les informations sur la licence.
--verbose
Utilisez cette option pour afficher des informations supplémentaires disponibles pendant l'exécution de l'action.
name
Indique les actifs que vous voulez installer. Vous pouvez indiquer les actifs de plusieurs manières :
ID d'actif
Vous pouvez spécifier des ID d'actifs pour installer un ou plusieurs des actifs suivants :
  • Fonctions
  • Modules complémentaires
  • Intégrations Open source
  • Exemples
Nom du serveur
Vous pouvez installer des fonctions manquantes pour un serveur existant à l'aide du nom de ce serveur. Les fonctions requises, qui sont définies dans le fichier server.xml, sont installées depuis les référentiels.
Package serveur
Vous pouvez spécifier un package serveur que vous avez créé à l'aide de la commande server package --include=usr. Le package serveur se déploie, et les fonctions requises, qui sont définies dans le fichier server.xml, sont installées depuis les référentiels.
Fichier .esa
Installer une fonction depuis un fichier .esa sur votre système de fichiers local. Cette action utilise le fichier manifeste OSGI-INF/SUBSYTEM.MF depuis le fichier .esa comme nouveau manifeste de fonction. Le fichier manifeste indique le nom, le contenu et les dépendances d'une fonction. Si vous indiquez l'option --to, installUtility copie le fichier manifeste dans le répertoire ${wlp.user.dir}/extensions/lib/features, ou dans le répertoire d'extension de produit. Tous les regroupements pour le sous-système sont extraits dans le répertoire ${wlp.user.dir}/extensions/lib et renommés $ {nom symbolique regroupement}_{version regroupement}.jar. Les fichiers de licence, de total de contrôle, de localisation et autre contenu du sous-système sont également extraits à l'emplacement défini dans le manifeste du sous-système.
Les options suivantes sont disponibles pour la commande installUtility find :
--showDescriptions
Affiche la description de chacune des fonctions trouvées par la recherche.
--type=[feature|sample|opensource|addon|all*]
Recherche les types d'actifs spécifiés.
--name
Recherche le nom d'actif pour l'élément searchString spécifié.
searchString
Recherche des actifs qui sont applicables à votre configuration. Si vous ne spécifiez pas de chaîne de recherche, la commande recherche tous les actifs applicables.
Les options suivantes sont disponibles pour la commande installUtility download :
--acceptLicense
Accepter le contrat de licence.
--viewLicenseAgreement
Afficher le contrat de licence.
--viewLicenseInfo
Afficher le contrat de licence.
--location=directoryPath
Indiquer lde répertoire de destination pour les actifs reçus par téléchargement. Cette option est obligatoire.
--overwrite
Cette option permet de remplacer les fichiers existants lors du téléchargement vers le répertoire local. Le comportement par défaut sans l'option est d'ignorer tous les fichiers existants.
--verbose
Cette option permet d'afficher des informations supplémentaires pendant le téléchargement.
name
Indiquer les ID d'actif pour télécharger un ou plusieurs des actifs suivants :
  • Fonctions
  • Modules complémentaires
  • Intégrations Open source
  • Exemples
L'option suivante est disponible pour la commande installUtility testConnection :
repoName
Indique le nom du référentiel à tester. S'il n'est pas indiqué, tous les référentiels spécifiés dans le fichier repositories.properties sont testés.
L'option suivante est disponible pour la commande installUtility uninstall :
--noPrompts
Désisntalle la fonction sans invites. La valeur par défaut est false.
--verbose
Cette option permet d'afficher des informations supplémentaires pendant la désinstallation.
name
Indiquer la fonction à désinstaller. Vous pouvez définir les options suivantes :
  • Le nom abrégé de l'archive de sous-système (fichier ESA), par exemple adminCenter-1.0.
  • Le nom symbolique de l'archive de sous-système (fichier ESA), par exemple com.ibm.websphere.appserver.adminCenter-1.0.

Exemples d'utilisation

Utilisez l'exemple suivant pour afficher les informations d'aide relatives à l'action install :
installUtility help install
Utilisez l'exemple suivant pour installer une fonction utilisateur :
installUtility install my_feature --to=usr
Utilisez l'exemple suivant pour installer une fonction utilisateur dans l'emplacement d'extension de produit my_extension :
installUtility install my_feature --to=my_extension
Utilisez l'exemple suivant pour installer plusieurs fonctions :
installUtility install feature1 feature2 feature3
Utilisez l'exemple suivant pour installer un exemple de fonction :
installUtility install mongoDBSample
Utilisez l'exemple suivant pour installer un serveur :
installUtility install myServer
Utilisez l'exemple suivant pour installer un fichier .jar compressé de package serveur :
installUtility install c:\temp\myServer.jar
Utilisez l'exemple suivant pour installer un fichier .esa local :
installUtility install c:\temp\myFeature.esa 
Utilisez l'exemple suivant pour installer un fichier compressé de package serveur :
installUtility install c:\temp\myServer.zip
Utilisez l'exemple suivant pour rechercher des actifs qui s'appliquent à votre configuration :
installUtility find searchString
Utilisez l'exemple suivant pour rechercher des exemples qui s'appliquent à votre configuration :
installUtility find searchstring --type=sample
Utilisez l'exemple suivant pour rechercher une fonction particulière qui s'applique à votre configuration :
installUtility find webCacheMonitor-1.0 --name --type=feature
Utilisez l'exemple suivant pour afficher des informations détaillées :
installUtility find searchstring --showDescriptions
Utilisez l'exemple suivant pour télécharger les dépendances requises des référentiels vers un répertoire local :
installUtility download feature_shortName --location=c:\temp\download --acceptLicense
Utilisez l'exemple suivant pour tester la connexion au référentiel Liberty :
installUtility testConnection default
Utilisez l'exemple suivant pour désinstaller une fonction :
installUtility uninstall adminCenter-1.0
Utilisez l'exemple suivant pour désinstaller plusieurs fonctions :
installUtility uninstall feature1 feature2 feature3
Utilisez l'exemple suivant pour désinstaller plusieurs fonctions sans invites :
installUtility uninstall --noPrompts feature1 feature2 feature3

Codes retour

Tableau 1. Codes retour et explications
Code retour Explication
0 La commande a exécuté l'opération demandée.
20 Un ou plusieurs arguments sont incorrects.
21 Une exception d'exécution est survenue en raison d'une ou de plusieurs des conditions suivantes :
  • Une exception d'exécution est survenue lors de l'installation du fichier archive de sous-système .esa.
  • Une licence n'a pas été acceptée ou reconnue.
  • Le fichier archive de sous-système .esa n'a pas été extrait correctement.
22 La fonction à installer existe.
23 La définition de la fonction n'est pas valide pour une ou plusieurs raisons :
  • La fonction ne possède pas de fichier manifeste valide.
  • La version de la fonction n'est pas prise en charge dans cet environnement Liberty.
  • Le fichier .zip ou .jar qui contient les fichiers de la fonction n'existe pas.
24 Du contenu manque dans le fichier archive de sous-système .esa.
25 Un fichier à installer existe.
26 Le produit n'est pas un produit de base et les fichiers d'extension de produit sont introuvables.
27 Le produit n'est pas un produit de base et l'extension de produit n'est pas définie dans le fichier ${wlp.install.dir}/etc/extensions/nom_extension.properties.
28 Les fichiers manifeste pour la fonction dans l'extension de produit sont introuvables.
29 La fonction n'est pas valide pour le produit courant.
33 La connexion au référentiel a échoué.
34 Le nom de référentiel est introuvable. Le nom de référentiel fourni n'existe pas dans le fichier de configuration.
35 L'action a été annulée par l'utilisateur.

Icône indiquant le type de rubrique Rubrique de référence

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=rwlp_command_installutility
Nom du fichier : rwlp_command_installutility.html