Liberty: Mandato featureManager

Utilice el mandato featureManager para instalar una característica y obtener detalles de todas las características que están listadas.

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 mediante un servidor proxy. Para obtener más información, consulte Configuración del soporte de servidor proxy para el mandato featureManager en Liberty.

Importante: Las acciones featureManager find, install y uninstall se han estabilizado excepto al instalar archivos .esa.

Utilice el mandato installUtility en lugar del mandato featureManager. Con el mandato installUtility, puede gestionar más tipos de activos e instalar, buscar o descargar activos de varios repositorios. 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:
install
Característica estabilizada: Esta acción se ha estabilizado. Utilice el mandato installUtility install, a menos que instale archivos .esa. Utilice el mandato featureManager para instalar archivos .esa.
Instale una característica o un archivo de archivado de subsistema empresarial (ESA) en el entorno de ejecución.
El mandato featureManager puede descargar activos desde Repositorio de Liberty. Para obtener más información, consulte Instalación de activos de Repositorio de Liberty.
uninstall
Característica estabilizada: Esta acción se ha estabilizado. En su lugar, utilice el mandato installUtility 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.
  • La acción uninstall no puede desinstalar características de usuario; por ejemplo, webCacheMonitor-1.0.
featureList
Genera un archivo XML que contiene un informe que detalla todas las características instaladas.
find
Característica estabilizada: Esta acción se ha estabilizado. En su lugar, utilice el mandato installUtility find.
Genere una lista de todos los activos en el Repositorio de Liberty, busque activos en el Repositorio de Liberty aplicables a su configuración, o consulte información detallada.
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.
help
Muestra información de ayuda para una acción especificada.

Opciones

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.
--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
Al instalar una característica, esta opción especifica un directorio de origen local desde el cual puede instalar características. 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 el acuerdo de licencia.
--viewLicenseInfo
Ver la información de la 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 e ignorar el archivo que existe.
  • replace: Sobrescribir el archivo existente.
--verbose
Utilice esta opción para visualizar cualquier información adicional mientras se ejecuta la acción.
nombre
Especifica una o más características que desea instalar, separadas con un espacio o una coma. Puede especificar las características de las formas siguientes:
ID de característica
  • Especifique el nombre abreviado de la característica, por ejemplo adminCenter-1.0
  • Especifique el nombre simbólico de la característica, por ejemplo com.ibm.websphere.appserver.adminCenter-1.0
archivo .esa
  • Especifique un nombre de archivo, por ejemplo my_feature.esa
  • Especifique un URL, por ejemplo http://myhost.ibm.com/liberty/assets/my_feature.esa

Esta acción utiliza el archivo OSGI-INF/SUBSYTEM.MF del archivo ESA como manifiesto de característica nuevo que se puede copiar en el directorio ${wlp.user.dir}/extensions/lib/features (o directorio de extensión del producto si se especifica un valor para la propiedad --to) que se renombra con el 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, archivos de localización y otro contenido de subsistema también se pueden extraer en la ubicación definida en el manifiesto del subsistema.

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 uninstall:
--noPrompts
Desinstalar características sin ninguna interacción del usuario ni mensajes de confirmación.
--verbose
Utilice esta opción para visualizar cualquier información adicional mientras se ejecuta la acción.
nombre
Especifique una o varias características para desinstalar, separando los nombres con un espacio o una coma. 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.
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 esta opción no se especifica, 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.
--verbose
Utilice esta opción para visualizar cualquier información adicional mientras se ejecuta la acción.
Están disponibles las opciones siguientes para el mandato featureManager find:
--viewInfo
Muestra información detallada.
--verbose
Utilice esta opción para visualizar cualquier información adicional mientras se ejecuta la acción.
searchString
Genera una lista de activos del Repositorio de Liberty que son aplicables a su configuración.
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.
fileName
El nombre del archivo JAR generado.

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
El ejemplo siguiente instala una característica e incluye información adicional:
featureManager install extendedPackage-1.0 --verbose
El ejemplo siguiente busca activos que son aplicables a su configuración:
featureManager find searchString
El ejemplo siguiente lista información detallada:
featureManager find searchstring --viewInfo
El ejemplo siguiente busca una característica e incluye información adicional:
featureManager find "adminCenter-1.0" --verbose
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
El ejemplo siguiente descarga todas las dependencias desde el Repositorio de Liberty:
featureManager install nombre_abreviado_característica
--downloadOnly=all
--location=c:\temp\download --acceptLicense
El ejemplo siguiente instala las características que se encuentran en un directorio local. Si faltan dependencias, se instalan desde el Repositorio de Liberty:
featureManager install nombre_abreviado_característica --location=c:\temp\download
--acceptLicense
El ejemplo siguiente instala activos de un directorio local sin descargar las dependencias que faltan en el Repositorio de Liberty:
featureManager install
nombre_abreviado_característica --location=c:\temp\download --offlineOnly

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
El ejemplo siguiente desinstala una característica:
featureManager uninstall adminCenter-1.0

Códigos de retorno

Tabla 1. Descripción de los 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:
  • 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.
[17.0.0.3 and later]36 [17.0.0.3 and later]La instalación de una característica de usuario no es válida para la extensión especificada: --to=core .

Icono que indica el tipo de tema Tema de referencia

Nombre de archivo: rwlp_command_featuremanager.html