Liberty : commande featureManager
Utilisez la commande featureManager pour installer une fonction et pour obtenir des informations sur toutes les fonctions installées.
La fonction que vous voulez installer doit être conditionnée sous forme d'archive de sous-système (fichier ESA).
Vous pouvez accéder au Référentiel Liberty à l'aide de la commande featureManager via un serveur proxy. Pour plus d'informations, voir Configuration de la prise en charge du serveur proxy pour la commande featureManager dans Liberty.
Utilisez la commande installUtility au lieu de la commande featureManager. Avec la commande installUtility, vous pouvez gérer d'autres types d'actifs et installer, rechercher ou télécharger des actifs depuis plusieurs référentiels. Pour plus d'informations, voir Installation des actifs avec la commande installUtility.
Syntaxe
La syntaxe de la commande est la suivante :
featureManager action [options]
- install
- Fonction stabilisée : Cette action est stabilisée. Utilisez la commande installUtility install à moins que vous n'installiez des fichiers .esa. Pour installer des fichiers .esa, utilisez la commande featureManager.
- Installez une fonction ou un fichier ESA ((Enterprise Subsystem Archive) dans l'environnement d'exécution.
- La commande featureManager peut télécharger des actifs à partir du Référentiel Liberty. Pour plus d'informations, voir Installation d'actifs Référentiel Liberty.
- uninstall
- Fonction stabilisée : Cette action est stabilisée. Utilisez à la place la commande installUtility uninstall.
- Désinstaller des fonctions à l'aide du nom abrégé ou du nom
symbolique de la fonction.Remarque :
- Assurez-vous que tous les processus serveur sont arrêtés avant de désinstaller une fonction.
- L'action uninstall ne peut pas désinstaller des fonctions utilisateur (par exemple, webCacheMonitor-1.0).
- featureList
- Générez un fichier XML qui contient un rapport détaillant toutes les fonctions qui sont installées.
- find
- Fonction stabilisée : Cette action est stabilisée. Utilisez à la place la commande installUtility find.
- Permet de générer une liste de tous les actifs dans le Référentiel Liberty, de rechercher des actifs dans le Référentiel Liberty qui sont applicables à votre configuration, ou de consulter des informations détaillées.
- classpath
- Génère un fichier JAR qui peut être ajouté à un classpath
de compilateur pour l'utilisation des API d'une liste de fonctions. Cette
action vous permet de
compiler des scripts de génération pour les
JAR d'API qui sont inclus dans le produit sans référence à des noms
de JAR spécifiques, lesquels peuvent changer lorsqu'un groupe de
correctifs est appliqué.
Le fichier d'archive Java de sortie
contient les chemins relatifs aux fichiers JAR d'API dans le produit. Par conséquent, vous ne devez pas déplacer ce fichier JAR de sortie
vers un
autre répertoire. Remarque : L'option --features doit être spécifiée avec cette action.
- help
- Affiche des informations d'aide pour l'action spécifiée.
Options
- --acceptLicense
- Accepter automatiquement les dispositions du contrat de licence.
- --downloadOnly=[all | required* | none]
- Télécharger la fonction demandée pour un répertoire local sans
installer la fonction. Cette option peut être configurée pour
télécharger toutes les fonctions dépendantes, les fonctions
dépendantes requises
pour cette exécution, ou aucune des fonctions dépendantes. Par
défaut, les fonctions dépendantes requises sont téléchargées. Indiquez
le répertoire avec l'option --location.Remarque : Vous ne pouvez pas utiliser cette option si vous indiquez l'emplacement de l'archive de sous-système sous la forme d'un nom de fichier ou d'une URL.
- --location=directoryPath
- Lors de l'installation d'une fonction, cette option spécifie un répertoire source local depuis lequel vous pouvez installer des fonctions. Utilisée avec l'option --downloadOnly, cette
option indique un répertoire de destination pour les fonctions
téléchargées. Cette option est obligatoire lors de l'utilisation des options
--downloadOnly et
--offlineOnly.Remarque : Vous ne pouvez pas utiliser cette option si vous indiquez l'emplacement de l'archive de sous-système sous la forme d'un nom de fichier ou d'une URL.
- --offlineOnly
- Utilisez cette option si vous ne désirez pas vous connecter au Référentiel Liberty. La commande installe alors uniquement les
fonctions depuis le répertoire local. Ce répertoire local est indiqué avec l'option
--location.Remarque : Vous ne pouvez pas utiliser cette option si vous indiquez l'emplacement de l'archive de sous-système sous la forme d'un nom de fichier ou d'une URL.
- --to=option_install
- où option_install peut prendre l'une des valeurs suivantes :
- usr : la fonction est installée en tant que fonction utilisateur. Il s'agit de la valeur par défaut.
- extension : emplacement dans lequel installer 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.
- --when-file-exists=option_existence
- Spécifiez l'action à exécuter si un fichier à installer existe déjà.
option_existence peut prendre l'une des valeurs suivantes :
- fail : Annule l'installation.
- ignore : Indique de poursuivre l'installation en ignorant le fichier existant.
- replace : Indique de remplacer le fichier existant.
- --verbose
- Utilisez cette option pour afficher des informations supplémentaires disponibles pendant l'exécution de l'action.
- name
- Spécifiez une ou plusieurs fonctions, séparées par un espace ou une virgule, que vous désirez installer. Vous pouvez spécifier ces fonctions
de plusieurs manières :
- ID des fonctions
- Indiquez le nom abrégé de la fonction (par exemple, adminCenter-1.0)
- Indiquez le nom symbolique de la fonction (par exemple, com.ibm.websphere.appserver.adminCenter-1.0)
- Fichier .esa
- Indiquez un nom de fichier (par exemple, my_feature.esa)
- Indiquez une URL (par exemple, http://myhost.ibm.com/liberty/assets/my_feature.esa)
Cette action utilise le fichier OSGI-INF/SUBSYTEM.MF du fichier ESA comme un nouveau manifeste de fonction pouvant être copié dans le répertoire ${wlp.user.dir}/extensions/lib/features (ou répertoire d'extension du produit si une valeur est spécifiée pour la propriété --to) renommé selon le nom symbolique du sous-système. Tous les regroupements pour le sous-système vont être extraits dans le répertoire ${wlp.user.dir}/extensions/lib et renommé $ {nom symbolique regroupement}_{version regroupement}.jar. Les fichiers de licence, les fichiers de total de contrôle, de localisation et autres contenus du sous-système seront également extraits vers l'emplacement défini dans le manifeste de sous-système.
Pour plus d'informations, voir la page Downloads sur le site WASdev.net.
- --noPrompts
- Désinstaller les fonctions sans aucune interaction d'utilisateur ou message de confirmation.
- --verbose
- Utilisez cette option pour afficher des informations supplémentaires disponibles pendant l'exécution de l'action.
- name
- Spécifiez une ou plusieurs fonctions que vous désirez désinstaller, en séparant leurs noms par un espace ou une virgule. 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.
- --encoding=jeu de caractères
- où jeu de caractères est le jeu de caractères à utiliser lors de la création du fichier de rapport XML.
- --locale=langue
- où langue spécifie la langue à utiliser lors de la création du fichier de rapport XML. Il s'agit du code de langue composé de deux lettres minuscules ISO-639, éventuellement suivi d'un trait de soulignement et du code de pays composé de deux lettres majuscules ISO-3166.
- --productExtension=nom
- où nom est le nom de l'extension de produit dont les fonctions doivent être répertoriées. Si l'extension de produit est installée à l'emplacement utilisateur par défaut, utilisez le mot clé usr. Si cette option n'est pas spécifiée, l'action est exécutée sur WebSphere Application Server Liberty Core.
- nom_fichier_rapport_XML
- Spécifie le nom du fichier de rapport XML à créer.
- --verbose
- Utilisez cette option pour afficher des informations supplémentaires disponibles pendant l'exécution de l'action.
- --viewInfo
- Affiche des informations détaillées.
- --verbose
- Utilisez cette option pour afficher des informations supplémentaires disponibles pendant l'exécution de l'action.
- searchString
- Génère une liste des actifs du Référentiel Liberty qui sont applicables à votre configuration.
- --features=feature1,feature2,...
- Liste des fonctions contenant la liste des fichiers JAR de l'API. Cette option est obligatoire pour l'action classpath.
- fileName
- Nom du fichier JAR généré.
Exemples d'utilisation
featureManager install my_feature.esa --to=usr
featureManager install my_feature.esa --to=my_extension
featureManager featureList my_feature_report.xml --locale=pt_BR
featureManager featureList --productExtension=usr my_feature_report.xml
featureManager featureList --productExtension=productExtensionName my_feature_report.xml
featureManager help install
featureManager install extendedPackage-1.0 --verbose
featureManager find searchString
featureManager find searchstring --viewInfo
L'exemple ci-après
recherche une fonction et affiche des informations supplémentaires :featureManager find "adminCenter-1.0" --verbose
featureManager install feature_shortName --downloadOnly --location=c:\temp\download --acceptLicense
featureManager install feature_shortName --downloadOnly=all --location=c:\temp\download --acceptLicense
featureManager install feature_shortName --location=c:\temp\download --acceptLicense
featureManager install feature_shortName --location=c:\temp\download --offlineOnly
L'exemple suivant créer un fichier JAR de classpath JAR et compile une classe d'application qui l'utilise :
featureManager classpath --features=servlet-3.0 classpath.jar
javac -cp classpath.jar TestServlet.java
featureManager uninstall adminCenter-1.0
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 que vous voulez installer existe déjà. |
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 que vous voulez installer existe déjà et vous avez spécifié l'option when-file-exists=fail. |
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. |
![]() |
![]() |