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).

[8.5.5.5 ou ultérieure]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.

[8.5.5.6 ou ultérieure]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]
action peut prendre l'une des valeurs suivantes :
[8.5.5.4 ou ultérieure]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.

Référentiel Liberty[8.5.5.2 ou ultérieure]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.
Référentiel Liberty[8.5.5.4 ou ultérieure]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.
[8.5.5.5 ou ultérieure]uninstall
[8.5.5.5 ou ultérieure]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]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.
Les options suivantes sont disponibles pour la commande featureManager install :
--acceptLicense
Acceptez automatiquement les dispositions du contrat de licence.
Référentiel Liberty[8.5.5.4 ou ultérieure]--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.
Référentiel Liberty[8.5.5.4 ou ultérieure]--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.
Référentiel Liberty[8.5.5.4 ou ultérieure]--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
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
  • Référentiel Liberty[8.5.5.2 ou ultérieure]Le nom abrégé de l'archive de sous-système (fichier ESA), par exemple adminCenter-1.0
  • Référentiel Liberty[8.5.5.2 ou ultérieure]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.

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.
Les options suivantes sont disponibles pour la commande featureManager find :
Référentiel Liberty[8.5.5.4 ou ultérieure]searchString
Utiliser l'option searchstring pour rechercher des fonctions applicables du référentiel IBM WebSphere Liberty Repository
Référentiel Liberty[8.5.5.4 ou ultérieure]--viewInfo
Afficher des informations détaillées.
[8.5.5.5 ou ultérieure]Les options suivantes sont disponibles pour la commande featureManager uninstall :
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

L'exemple suivant installe l'archive de sous-système mon_fonction.esa en tant que fonction utilisateur :
featureManager
install mon_fonction--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 mon_fonction.esa --to=mon_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 mon_rapport_fonction.xml --locale=fr_FR
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 mon_rapport_fonction.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=nom_extension_produit
mon_rapport_fonction.xml
L'exemple suivant affiche des informations d'aide pour l'action install :
featureManager help install
Référentiel Liberty[8.5.5.4 ou ultérieure]L'exemple ci-après recherche les actifs applicables du référentiel Liberty :
featureManager find searchString
Référentiel Liberty[8.5.5.4 ou ultérieure]L'exemple suivant répertorie des informations détaillées :
featureManager find searchString --viewInfo
Référentiel Liberty[8.5.5.4 ou ultérieure]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
Remarque : Vous ne pouvez pas utiliser cette option si vous indiquez l'emplacement de l'archive de sous-système sous la forme d'une URL.
Référentiel Liberty[8.5.5.4 ou ultérieure]L'exemple suivant télécharge toutes les dépendances du référentiel Liberty et ne les installe pas :
featureManager install feature_shortName --downloadOnly=all --location=c:\temp\download --acceptLicense
Remarque : Vous ne pouvez pas utiliser cette option si vous indiquez l'emplacement de l'archive de sous-système sous la forme d'une URL.
Référentiel Liberty[8.5.5.4 ou ultérieure]L'exemple suivant installe les fonctions qui se trouvent dans un répertoire local. S'il manque des dépendances, elles sont installées depuis le référentiel en ligne :
featureManager install feature_shortName --location=c:\temp\download --acceptLicense
Remarque : Vous ne pouvez pas utiliser cette option si vous indiquez l'emplacement de l'archive de sous-système sous la forme d'une URL.
Référentiel Liberty[8.5.5.4 ou ultérieure]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
Remarque : Vous ne pouvez pas utiliser cette option si vous indiquez l'emplacement de l'archive de sous-système sous la forme d'une URL.
Référentiel Liberty[8.5.5.4 ou ultérieure]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
Référentiel Liberty[8.5.5.5 ou ultérieure]L'exemple suivant désinstalle une fonction :
featureManager uninstall adminCenter-1.0
[Mise à jour - Mai 2014]

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.
[Mise à jour - Mai 2014]

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_featuremanager
Nom du fichier : rwlp_command_featuremanager.html