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.
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]
- install
- Característica estabilizada: Esta acción se ha estabilizado. En su lugar, utilice el mandato installUtility install.
- 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 el 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 Liberty que son 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
- --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, los archivos de localización y otro contenido del subsistema también se extraen 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.
- --force
- Desinstala la característica especificada independientemente de si otras características instaladas tienen dependencias de ella.Nota: La desinstalación de una característica que requieren otras características instaladas podría hacer que estas características dejaran de funcionar y podría impedir que los servidores se ejecutaran correctamente.
- --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.
- --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.
- --verbose
- Utilice esta opción para visualizar cualquier información adicional mientras se ejecuta la acción.
- --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 Liberty que son aplicables a su configuración.
- --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
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
installUtility install extendedPackage-1.0 --verbose
featureManager find searchString
featureManager find searchstring --viewInfo
El
ejemplo siguiente busca una característica e incluye información
adicional: featureManager find "adminCenter-1.0" --verbose
featureManager
install nombre_abreviado_característica --downloadOnly --location=c:\temp\download --acceptLicense
featureManager install nombre_abreviado_característica
--downloadOnly=all
--location=c:\temp\download --acceptLicense
featureManager install nombre_abreviado_característica --location=c:\temp\download
--acceptLicense
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
featureManager uninstall adminCenter-1.0
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. |