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

[8.5.5.5 o posterior]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.

[8.5.5.6 o posterior]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]
donde acción puede tomar uno de los valores siguientes:
[8.5.5.4 o posterior]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.

Repositorio de Liberty[8.5.5.2 o posterior]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.
Repositorio de Liberty[8.5.5.4 o posterior]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.
[8.5.5.5 o posterior]uninstall
[8.5.5.5 o posterior]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]Están disponibles las opciones siguientes para el mandato featureManager classpath:
--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.
Están disponibles las opciones siguientes para el mandato featureManager install:
--acceptLicense
Indica automáticamente la aceptación de los términos y condiciones de licencia.
Repositorio de Liberty[8.5.5.4 o posterior]--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.
Repositorio de Liberty[8.5.5.4 o posterior]--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.
Repositorio de Liberty[8.5.5.4 o posterior]--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
  • Repositorio de Liberty[8.5.5.2 o posterior]El nombre abreviado del archivado de subsistema (archivo ESA), como por ejemplo adminCenter-1.0
  • Repositorio de Liberty[8.5.5.2 o posterior]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.

Están disponibles las opciones siguientes para el mandato featureManager featureList:
--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.
Están disponibles las opciones siguientes para el mandato featureManager find:
Repositorio de Liberty[8.5.5.4 o posterior]searchString
Utilice la opción searchstring para buscar las características aplicables de IBM WebSphere Liberty Repository
Repositorio de Liberty[8.5.5.4 o posterior]--viewInfo
Ver información detallada.
[8.5.5.5 o posterior]Están disponibles las opciones siguientes para el mandato featureManager uninstall:
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

El ejemplo siguiente instala el archivado de subsistema my_feature.esa como una característica de usuario:
featureManager install my_feature.esa --to=usr
El ejemplo siguiente instala el archivado de subsistema my_feature.esa en la ubicación de extensión del producto my_extension:
featureManager install my_feature.esa --to=my_extension
El ejemplo siguiente genera un informe para todas las características instaladas. El informe se graba en el archivo my_feature_report.xml utilizando el idioma portugués de Brasil:
featureManager featureList my_feature_report.xml --locale=pt_BR
El ejemplo siguiente genera un informe que contiene todas las características instaladas definidas en la extensión del producto instalado en la ubicación de usuario predeterminada wlp/usr/extension, que es conocida para el entorno de ejecución como la extensión del producto usr. El informe se graba en el archivo my_feature_report.xml:
featureManager featureList --productExtension=usr my_feature_report.xml
El ejemplo siguiente genera un informe que contiene todas las características definidas en la extensión del producto instalada en la ubicación a la que apunta el contenido del archivo productExtensionName.properties en el directorio etc/extensions de instalación del producto. El informe se graba en el archivo my_feature_report.xml:
featureManager featureList --productExtension=nombreExtensiónProducto my_feature_report.xml
El ejemplo siguiente muestra información de ayuda para la acción install:
featureManager help install
Repositorio de Liberty[8.5.5.4 o posterior]El ejemplo siguiente busca los activos aplicables del repositorio de Liberty:
featureManager find searchString
Repositorio de Liberty[8.5.5.4 o posterior]El ejemplo siguiente lista información detallada:
featureManager find searchString --viewInfo
Repositorio de Liberty[8.5.5.4 o posterior]El ejemplo siguiente descarga las dependencias necesarias del repositorio de Liberty en un directorio local y no las instala:
featureManager
install nombre_abreviado_característica --downloadOnly --location=c:\temp\download --acceptLicense
Nota: no puede utilizar esta opción si especifica la ubicación del archivado de subsistema con un URL.
Repositorio de Liberty[8.5.5.4 o posterior]El ejemplo siguiente descarga todas las dependencias del repositorio de Liberty en un directorio local y no las instala:
featureManager install nombre_abreviado_característica
--downloadOnly=all
--location=c:\temp\download --acceptLicense
Nota: no puede utilizar esta opción si especifica la ubicación del archivado de subsistema con un URL.
Repositorio de Liberty[8.5.5.4 o posterior]El ejemplo siguiente instala las características que se encuentran en un directorio local. Si faltan dependencias, se instalan desde el repositorio en línea:
featureManager install nombre_abreviado_característica --location=c:\temp\download
--acceptLicense
Nota: no puede utilizar esta opción si especifica la ubicación del archivado de subsistema con un URL.
Repositorio de Liberty[8.5.5.4 o posterior]El ejemplo siguiente instala activos de un directorio local sin descargar las dependencias que faltan del repositorio de Liberty:
featureManager install
nombre_abreviado_característica --location=c:\temp\download --offlineOnly
Nota: no puede utilizar esta opción si especifica la ubicación del archivado de subsistema con un URL.
Repositorio de Liberty[8.5.5.4 o posterior]El ejemplo siguiente crea un archivo JAR de vía de acceso de clases y compila una clase de aplicación que lo utiliza:
featureManager classpath --features=servlet-3.0 classpath.jar
javac -cp classpath.jar TestServlet.java
Repositorio de Liberty[8.5.5.5 o posterior]El ejemplo siguiente desinstala una característica:
featureManager uninstall adminCenter-1.0
[Actualizado en mayo de 2014]

Códigos de retorno

Tabla 1. Códigos de retorno y descripciones
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:
  • Se ha producido una excepción de tiempo de ejecución al instalar el archivo de archivado del subsistema .esa.
  • No se acepta o no se reconoce una licencia.
  • El archivo de archivado del subsistema .esa no se ha extraído correctamente.
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:
  • La característica no tiene un archivo de manifiesto válido.
  • La versión de la característica no recibe soporte en este entorno de Liberty.
  • El archivo .zip o .jar que contiene los archivos de característica no existe.
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]

Icono que indica el tipo de tema Tema de referencia

Términos y condiciones para centros de información | Comentarios


Icono de indicación de fecha y hora Última actualización: 15 de junio de 2015
http://www14.software.ibm.com/webapp/wsbroker/redirect?version=phil&product=was-libcore-mp&topic=rwlp_command_featuremanager
Nombre de archivo:rwlp_command_featuremanager.html