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.

Important : Les actions featureManager find, install et uninstall sont stabilisées.

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]
action peut prendre l'une des valeurs suivantes :
install
Fonction stabilisée : Cette action est stabilisée. Utilisez à la place la commande installUtility install.
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 depuis le référentiel Liberty ; pour plus d'informations, voir Installation des actifs du 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, d'identifier dans ce référentiel des actifs applicables à votre configuration, ou d'examiner 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

Les options suivantes sont disponibles pour la commande featureManager install :
--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 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
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, 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.

Pour plus d'informations, voir la page Downloads sur le site WASdev.net.

Les options suivantes sont disponibles pour la commande featureManager uninstall :
--force
Désinstaller la fonction spécifiée même si d'autres fonctions installées ont des dépendances de celle-ci.
Remarque : La désinstallation d'une fonction requise par d'autres fonctions installées peut entraîner l'arrêt de ces fonctions et empêcher un fonctionnement correct des serveurs.
--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.
Les options suivantes sont disponibles pour la commande featureManager featureList :
--encoding=jeu de caractères
jeu de caractères est le jeu de caractères à utiliser lors de la création du fichier de rapport XML.
--locale=langue
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
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.
--verbose
Utilisez cette option pour afficher des informations supplémentaires disponibles pendant l'exécution de l'action.
Les options suivantes sont disponibles pour la commande featureManager find :
--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 applicables à votre configuration.
Les options suivantes sont disponibles pour la commande featureManager classpath :
--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

L'exemple suivant installe l'archive de sous-système mon_fonction.esa en tant que fonction utilisateur :
featureManager install my_feature.esa --to=usr
L'exemple suivant installe l'archive de sous-système ma_fonction.esa dans l'emplacement d'extension de produit mon_extension :
featureManager install my_feature.esa --to=my_extension
L'exemple suivant génère un rapport pour toutes les fonctions Core installées ; le rapport est écrit dans le fichier mon_rapport_fonction.xml en français :
featureManager featureList my_feature_report.xml --locale=pt_BR
L'exemple ci-dessous génère un rapport répertoriant toutes les fonctions installées qui sont définies dans l'extension de produit qui est installée à l'emplacement utilisateur par défaut wlp/usr/extension connue de l'environnement d'exécution en tant qu'extension de produit usr. Le rapport est écrit dans le fichier mon_rapport_fonction.xml :
featureManager featureList --productExtension=usr my_feature_report.xml
L'exemple ci-dessous génère un rapport répertoriant toutes les fonctions qui sont définies dans l'extension de produit installée à l'emplacement désigné dans le contenu du fichier nom_extension_produit.properties qui se trouve dans le répertoire etc/extensions de l'installation du produit. Le rapport est écrit dans le fichier mon_rapport_fonction.xml :
featureManager featureList --productExtension=productExtensionName my_feature_report.xml
L'exemple suivant affiche des informations d'aide pour l'action install :
featureManager help install
L'exemple ci-après installe une fonction et affiche des informations supplémentaires :
installUtility install extendedPackage-1.0 --verbose
L'exemple suivant recherche des actifs applicables à votre configuration :
featureManager find searchString
L'exemple suivant répertorie des informations détaillées :
featureManager find searchstring --viewInfo
L'exemple ci-après recherche une fonction et affiche des informations supplémentaires :
featureManager find "adminCenter-1.0" --verbose
L'exemple suivant télécharge les dépendances requises du référentiel Liberty vers un répertoire local et ne les installe pas :
featureManager install feature_shortName --downloadOnly --location=c:\temp\download --acceptLicense
L'exemple suivant télécharge toutes les dépendances depuis le référentiel Liberty :
featureManager install feature_shortName --downloadOnly=all --location=c:\temp\download --acceptLicense
L'exemple suivant installe les fonctions qui se trouvent dans un répertoire local. Si des dépendances sont manquantes, elles sont installées depuis le référentiel Liberty :
featureManager install feature_shortName --location=c:\temp\download --acceptLicense
L'exemple suivant installe des actifs depuis un répertoire local sans télécharger les dépendances manquantes depuis le référentiel Liberty :
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
L'exemple suivant désinstalle une fonction :
featureManager uninstall adminCenter-1.0

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 que vous voulez installer existe déjà.
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 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.

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



Icône d'horodatage Dernière mise à jour: Tuesday, 6 December 2016
http://www14.software.ibm.com/webapp/wsbroker/redirect?version=cord&product=was-nd-mp&topic=rwlp_command_featuremanager
Nom du fichier : rwlp_command_featuremanager.html