Mandato featureManager
Puede utilizar el mandato featureManager para buscar, instalar, desinstalar u obtener detalles sobre características.
La característica que desea instalar debe estar empaquetada como un archivado de subsistema (archivo ESA).
Puede acceder al repositorio de Liberty utilizando el mandato featureManager a
través de un servidor proxy; para obtener más información, consulte Configuración del soporte de servidor proxy para el mandato featureManager en el perfil Liberty.
Para gestionar más tipos de activos e instalar, buscar o descargar activos desde varios repositorios, utilice el mandato installUtility, en lugar del mandato featureManager. Para obtener más información, consulte
Instalación de activos utilizando el mandato installUtility.
Sintaxis
La sintaxis del mandato es la siguiente:
featureManager acción [opciones]
classpath
- Generar un archivo JAR que puede añadirse a una vía de acceso de clases de compilador para poder utilizar las API de una lista de características. Esta
acción permite compilar scripts de construcción en los JAR de la API que están incluidos en el producto sin hacer referencia a nombres de JAR específicos,
que pueden cambiar cuando se aplica un fixpack. Los JAR de salida contienen vías de acceso relativas a los JAR de API del producto. Por tanto, no debe
mover el archivo JAR de salida a otro directorio. Nota: debe especificarse la opción --features con esta acción.
- install
- Instala una característica desde un archivo de archivado de subsistema de empresa (ESA), un URL en un archivo ESA, un
nombre
abreviado de característica o un nombre simbólico de característica.
Si especifica un nombre abreviado de característica o un nombre simbólico, la característica se descarga desde un repositorio en línea alojado en IBM.
La acción install utiliza el archivo OSGI-INF/SUBSYSTEM.MF del archivo ESA como nuevo manifiesto de característica que se puede copiar en el directorio ${wlp.user.dir}/extensions/lib/features (o en el directorio de extensión del producto si se especifica un valor para la propiedad --to) que se renombra a partir del nombre simbólico del subsistema. Todos los paquetes del subsistema se extraen en el directorio ${wlp.user.dir}/extensions/lib y se renombran como {nombre simbólico de paquete}_{versión de paquete}.jar. Los archivos de licencia, archivos de suma de comprobación, los archivos de localización y otro contenido del subsistema también se extraen en la ubicación definida en el manifiesto del subsistema.
El mandato featureManager puede descargar activos desde el repositorio de Liberty. Para obtener más información, consulte Instalación de activos de Repositorio de Liberty.
- featureList
- Genera un archivo XML que contiene un informe que detalla todas las características instaladas.
find
- Buscar activos en el repositorio de Liberty que sean aplicables a la configuración.
- help
- Muestra información de ayuda para una acción especificada.
uninstall
Desinstalar características utilizando el nombre abreviado o el nombre simbólico de la característica.
Nota:- Asegúrese de que todos los procesos del servidor se han detenido antes de desinstalar una característica.
- El mandato uninstall no puede desinstalar características de usuario; por ejemplo: webCacheMonitor-1.0.
Opciones
![[8.5.5.4 o posterior]](../ng_v8554.gif)
- --features=característica1,característica2,...
- La lista de características que contienen la lista de archivos JAR de API. Esta opción es necesaria para la acción classpath.
- --acceptLicense
- Indica automáticamente la aceptación de los términos y condiciones de licencia.
--downloadOnly=[all | required* | none]
- Descarga la característica solicitada en un directorio local sin instalarla. Esta opción puede configurarse para descargar todas las características
dependientes, las características dependientes necesarias para este entorno de ejecución o ninguna de las características dependientes. El valor
predeterminado es descargar las características dependientes necesarias.
Especifique el directorio con la opción --location. Nota: no puede utilizar esta opción si especifica la ubicación del archivado de subsistema con un nombre de archivo o un URL.
--location=directoryPath
- Especifica la ubicación del archivado de subsistema que desea instalar. Cuando se utiliza con la opción --downloadOnly, esta opción especifica un directorio de destino para las características
descargadas.
Esta opción es necesaria cuando se utilizan las opciones --downloadOnly y --offlineOnly. Nota: no puede utilizar esta opción si especifica la ubicación del archivado de subsistema con un nombre de archivo o un URL.
--offlineOnly
- Utilice esta opción si no desea conectarse al repositorio de Liberty. En lugar de ello, el mandato sólo instala características del directorio
local. El directorio local se especifica con la opción --location. Nota: no puede utilizar esta opción si especifica la ubicación del archivado de subsistema con un nombre de archivo o un URL.
- --to=opción_instalación
- donde opción_instalación puede tomar uno de los valores
siguientes:
- usr: la característica se instala como una característica de usuario. Éste es el valor predeterminado.
- extension: la ubicación en la que desea instalar la característica. Puede instalar la característica en cualquier ubicación de extensión del producto.
- --viewLicenseAgreement
- Ver acuerdo de licencia.
- --viewLicenseInfo
- Ver información de licencia.
- --when-file-exists=opción_exist
- Especifica la acción que debe realizarse si un archivo que se va a instalar ya existe. opción_exist
puede tomar uno de los valores siguientes:
- fail: cancelar la instalación.
- ignore: continuar la instalación y pasar por alto el archivo que existe.
- replace: sobrescribir el archivo existente.
- archivado_subsistema
- Especifica la ubicación del archivado de subsistema que desea instalar. Puede especificar la ubicación de las siguientes maneras:
- Un nombre de archivo; por ejemplo: mi_característica.esa.
- Un URL; por ejemplo:
http://mihost.ibm.com/liberty/assets/mi_característica.esa
El nombre abreviado del archivado de subsistema (archivo ESA), como por ejemplo adminCenter-1.0
El nombre simbólico del archivado de subsistema (archivo ESA), como por ejemplo com.ibm.websphere.appserver.adminCenter-1.0
Para obtener más información, consulte la Página de descargas en WASdev.net.
- --encoding=juego_caracteres
- donde juego_caracteres es el juego de caracteres que se va a utilizar al crear el archivo de informe XML.
- --locale=idioma
- donde idioma especifica el idioma que se va a utilizar al crear el archivo de informe XML. Este consta de un código de idioma en minúscula de dos letras ISO-639, de modo opcional seguido de un carácter de subrayado y el código de país de dos letras en mayúscula ISO-3166.
- --productExtension=nombre
- donde nombre es el nombre de extensión del producto cuyas características se van a enumerar. Si se instala la extensión del producto en la ubicación de usuario predeterminada, utilice la palabra clave: usr. Si no se especifica esta opción, la acción se lleva a cabo en WebSphere Application Server Liberty Core.
- nombre_archivo_informe_XML
- Especifica el nombre del archivo de informe XML que desea crear.
searchString
- Utilice la opción searchstring para buscar las características aplicables de IBM WebSphere Liberty Repository
--viewInfo
- Ver información detallada.
![[8.5.5.5 o posterior]](../ng_v8555.gif)
- nombre
- Especifique la característica que debe desinstalarse. Puede especificar las opciones siguientes:
- El nombre abreviado del archivado de subsistema (archivo ESA), como por ejemplo adminCenter-1.0.
- El nombre simbólico del archivado de subsistema (archivo ESA), como por ejemplo com.ibm.websphere.appserver.adminCenter-1.0.
- --noPrompts
- Desinstalar características sin ninguna interacción del usuario ni mensajes de confirmación.
Ejemplos de uso
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=nombreExtensiónProducto my_feature_report.xml
featureManager help install

![[8.5.5.4 o posterior]](../ng_v8554.gif)
featureManager find searchString

![[8.5.5.4 o posterior]](../ng_v8554.gif)
featureManager find searchString --viewInfo

![[8.5.5.4 o posterior]](../ng_v8554.gif)
featureManager
install nombre_abreviado_característica --downloadOnly --location=c:\temp\download --acceptLicense

![[8.5.5.4 o posterior]](../ng_v8554.gif)
featureManager install nombre_abreviado_característica
--downloadOnly=all
--location=c:\temp\download --acceptLicense

![[8.5.5.4 o posterior]](../ng_v8554.gif)
featureManager install nombre_abreviado_característica --location=c:\temp\download
--acceptLicense

![[8.5.5.4 o posterior]](../ng_v8554.gif)
featureManager install
nombre_abreviado_característica --location=c:\temp\download --offlineOnly

![[8.5.5.4 o posterior]](../ng_v8554.gif)
featureManager classpath --features=servlet-3.0 classpath.jar
javac -cp classpath.jar TestServlet.java

![[8.5.5.5 o posterior]](../ng_v8555.gif)
featureManager uninstall adminCenter-1.0
![[Actualizado en mayo de 2014]](../delta.gif)
Códigos de retorno
Código de retorno | Descripción |
---|---|
0 | El mandato ha completado correctamente la operación solicitada. |
20 | Uno o varios argumentos no son válidos. |
21 | Se ha producido una excepción de tiempo de ejecución debido a una o varias de las condiciones siguientes:
|
22 | La característica que deseaba instalar ya existe. |
23 | La definición de característica no era válida por una de estas razones o por varias de ellas:
|
24 | Al archivo de archivado del subsistema .esa le falta contenido. |
25 | Un archivo que quería instalar ya existe y ha especificado la opción when-file-exists=fail. |
26 | El producto no es un producto principal y no se encuentran los archivos de extensión del producto. |
27 | El producto no es un producto principal y la extensión del producto no se ha definido en el archivo ${wlp.install.dir}/etc/extensions/nombre_extensión.properties. |
28 | No se han encontrado los archivos de manifiesto para la característica en la extensión del producto. |
29 | La característica no es válida para el producto actual. |
![[Actualizado en mayo de 2014]](../deltaend.gif)