Commande featureManager
Vous pouvez utiliser la commande featureManager pour rechercher, installer, désinstaller ou obtenir des détails sur les fonctions.
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 en utilisant 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 le profil Liberty.
Pour gérer d'autres types d'actifs et
installer, rechercher ou télécharger des actifs depuis plusieurs
référentiels, utilisez la commande installUtility
au lieu de la commande featureManager. Pour plus d'informations, voir
Installation des actifs avec la commande installUtility.
Syntaxe
La syntaxe de la commande est la suivante :
featureManager
action [options]
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.
- install
- Installe une fonction à partir d'un fichier archive de
sous-système d'entreprise (ESA), d'une URL vers
un fichier ESA, d'un nom abrégé de fonction ou d'un nom symbolique
de fonction.
Si vous indiquez un nom abrégé ou un nom symbolique de fonction, la fonction est téléchargée depuis un référentiel en ligne hébergé par IBM.
L'action install utilise le fichier OSGI-INF/SUBSYSTEM.MF du fichier ESA en tant que nouveau manifeste de fonction qui peut être copié dans le répertoire ${wlp.user.dir}/extensions/lib/features (ou le répertoire d'extension de produit si une valeur est spécifiée pour la propriété --to) renommé après 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, de total de contrôle, de localisation et autre contenu du sous-système vont également être extraits à l'emplacement défini dans le manifeste du sous-système.
La commande featureManager peut télécharger des actifs depuis le référentiel Liberty ; pour plus d'informations, voir Installation d'actifs du référentiel Liberty.
- featureList
- Générez un fichier XML qui contient un rapport détaillant toutes les fonctions qui sont installées.
find
- Rechercher des actifs dans le référentiel Liberty qui sont applicables à votre configuration.
- help
- Afficher les informations d'aide pour l'action spécifiée.
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.
- La commande uninstall ne peut pas désinstaller des fonctions utilisateur ; par exemple : webCacheMonitor-1.0.
Options
![[8.5.5.4 ou ultérieure]](../ng_v8554.gif)
- --features=feature1,feature2,...
- Liste des fonctions contenant la liste des fichiers JAR de l'API. Cette option est obligatoire pour l'action classpath.
- --acceptLicense
- Acceptez 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
- Spécifie l'emplacement de l'archive de sous-système à installer. 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 voulez 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
- Affichez le contrat de licence.
- --viewLicenseInfo
- Affichez 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 : annuler l'installation.
- ignore : continuer l'installation et ignorer le fichier existant.
- replace : remplacer le fichier existant.
- subsystem_archive
- Spécifie l'emplacement de l'archive de sous-système à installer. Vous
pouvez indiquer l'emplacement de plusieurs manières :
- Un nom de fichier, par exemple : my_feature.esa.
- Une URL, par exemple :
http://myhost.ibm.com/liberty/assets/my_feature.esa
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
Pour plus d'informations, voir la page Downloads sur le site WASdev.net.
- --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 effectuée dans WebSphere Application Server Liberty Core.
- nom_fichier_rapport_XML
- Spécifie le nom du fichier de rapport XML à créer.
searchString
- Utiliser l'option searchstring pour rechercher des fonctions applicables du référentiel IBM WebSphere Liberty Repository
--viewInfo
- Afficher des informations détaillées.
![[8.5.5.5 ou ultérieure]](../ng_v8555.gif)
- 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.
- --noPrompts
- Désinstaller les fonctions sans aucune interaction d'utilisateur ou message de confirmation.
Exemples d'utilisation
featureManager
install mon_fonction--to=usr
featureManager install mon_fonction.esa --to=mon_extension
featureManager featureList mon_rapport_fonction.xml --locale=fr_FR
featureManager featureList --productExtension=usr mon_rapport_fonction.xml
featureManager featureList
--productExtension=nom_extension_produit
mon_rapport_fonction.xml
featureManager help install

![[8.5.5.4 ou ultérieure]](../ng_v8554.gif)
featureManager find searchString

![[8.5.5.4 ou ultérieure]](../ng_v8554.gif)
featureManager find searchString --viewInfo

![[8.5.5.4 ou ultérieure]](../ng_v8554.gif)
featureManager install feature_shortName --downloadOnly --location=c:\temp\download --acceptLicense

![[8.5.5.4 ou ultérieure]](../ng_v8554.gif)
featureManager install feature_shortName --downloadOnly=all --location=c:\temp\download --acceptLicense

![[8.5.5.4 ou ultérieure]](../ng_v8554.gif)
featureManager install feature_shortName --location=c:\temp\download --acceptLicense

![[8.5.5.4 ou ultérieure]](../ng_v8554.gif)
featureManager install feature_shortName --location=c:\temp\download --offlineOnly

![[8.5.5.4 ou ultérieure]](../ng_v8554.gif)
featureManager classpath --features=servlet-3.0 classpath.jar
javac -cp classpath.jar TestServlet.java

![[8.5.5.5 ou ultérieure]](../ng_v8555.gif)
featureManager uninstall adminCenter-1.0
![[Mise à jour - Mai 2014]](../delta.gif)
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. |
![[Mise à jour - Mai 2014]](../deltaend.gif)