![[8.5.5.6 ou ultérieure]](../ng_v8556.gif)
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 :
- Le référentiel IBM WebSphere Liberty, référentiel public hébergé par IBM- et accessible sur Internet. Pour plus d'informations, voir Référentiel Liberty
- Le service de référentiel d'actifs Liberty, référentiel sur site en open-source service accessible à distance derrière le pare-feu d'une entreprise ; voir le référentiel WASdev/tool.lars sur GitHub.
- Les référentiels basées dans un répertoire local qui sont créés à l'aide de l'action installUtility download. Pour plus d'informations, voir Téléchargement d'actifs avec la commande installUtility.
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
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 :
|
22 | La fonction à installer existe. |
23 | La définition de la fonction n'est pas valide pour une ou plusieurs raisons :
|
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. |