Mandato installUtility

Utilice el mandato installUtility para buscar, obtener información e instalar activos que están en un repositorio basado en directorio, una instancia de Liberty Asset Repository Service o el Repositorio de IBM® WebSphere Liberty.

Orígenes de activo

El mandato installUtility puede acceder a activos en los repositorios siguientes:
  • IBM WebSphere Liberty Repository, un repositorio público alojado en IBM accesible mediante Internet. Para obtener más información, consulte Repositorio de Liberty.
  • El servicio Liberty Asset Repository Service, un servicio de código abierto que puede utilizar para crear un repositorio local al que se accede de forma remota detrás del cortafuegos de una empresa. Para obtener más información, consulte el proyecto WASdev/tool.lars en GitHub.
  • Los repositorios basados en directorios locales que ha creado utilizando la acción installUtility download o descargando el archivo wlp-featureRepo-<versión>.zip, que contiene todas las características y complementos. Para obtener más información, consulte Descarga de activos utilizando el mandato installUtility.

Puede utilizar el mandato installUtility para trabajar con activos de repositorio basados en directorio directamente desde repositorios comprimidos como, por ejemplo, wlp-featureRepo-<versión>.zip, sin extraer los archivos. Para obtener más información sobre el archivo wlp-featureRepo-<versión>.zip, consulte Descarga de activos utilizando el mandato installUtility.

Sintaxis

La sintaxis del mandato es la siguiente:

installUtility acción [opciones]
La variable acción puede tener uno de los valores siguientes:
download
Descargar los activos de los repositorios.
find
Buscar los activos en los repositorios que son aplicables a su configuración o ver información detallada sobre los activos.
install
Instalar activos un archivo ESA (Enterprise Subsystem Archive) en el tiempo de ejecución o desplegar un paquete del servidor e instalar las características necesarias del paquete.
testConnection
Probar la conexión de repositorio.
uninstall
Desinstalar las características especificando el nombre abreviado de la característica o el nombre simbólico de la característica. Puede especificar varias características separadas por un espacio.
Nota: Asegúrese de que todos los procesos del servidor se han detenido antes de desinstalar una característica.
viewSettings
Vea una plantilla para configurar repositorio o un proxy, o vea y valide los valores para los repositorios o el proxy configurados.
help
Mostrar información de ayuda para una acción especificada.

Opciones

Están disponibles las opciones siguientes para el mandato installUtility download:
--acceptLicense
Acepta el contrato de licencia.
--viewLicenseAgreement
Ver el acuerdo de licencia.
--viewLicenseInfo
Ver el acuerdo de licencia.
--location=directoryPath
Especifique el directorio de destino para los activos descargados. Esta opción es obligatoria.
--overwrite
Utilice esta opción para sobrescribir los archivos existentes al descargar en el directorio local. El comportamiento predetermina sin la opción es omitir todos los archivos existentes.
--verbose
Utilice esta opción para visualizar información adicional durante la descarga.
nombre
Especifique los ID de activo para descargar uno o varios de los activos siguientes, separando varios ID de activo con un espacio:
  • Características
  • Complementos
  • Integraciones de código abierto
  • Ejemplos

Están disponibles las opciones siguientes para el mandato installUtility find:
--from
Especifique un único repositorio basado en directorio como origen de los activos para el mandato installUtility.

El repositorio basado en directorio puede ser una carpeta descomprimida o un archivo de archivado comprimido.

Para buscar activos en varios repositorios basados en directorio, debe configurar los directorios en el archivo repositories.properties. Para obtener más información, consulte Configuración de repositorios y valores de proxy para el mandato installUtility.

--showDescriptions
Muestra la descripción para cada una de las características encontradas por la búsqueda.
--type=[feature|sample|opensource|addon|all*]
Busca el tipo de activos especificado.
--name
Busca el nombre de activo para la searchString especificada.
--verbose
Utilice esta opción para visualizar cualquier información adicional mientras se ejecuta la acción.
searchString
Busca los activos que son aplicables a su configuración. Si no especifica una serie de activos, el mandato busca todos los activos aplicables.

Están disponibles las opciones siguientes para el mandato installUtility install:
--to=opción_instalación
La opción opción_instalación puede tener uno de los valores siguientes:
  • usr: la característica se instala como una característica de usuario. Este es el valor predeterminado.
  • extensión: la ubicación para instalar la característica. Puede instalar la característica en cualquier ubicación de extensión del producto.
--from
Especifique un único repositorio basado en directorio como origen de los activos para el mandato installUtility.

El repositorio basado en directorio puede ser una carpeta descomprimida o un archivo de archivado comprimido.

Para instalar activos desde varios repositorios basados en directorio, debe configurar los repositorios en el archivo repositories.properties. Para obtener más información, consulte Configuración de repositorios y valores de proxy para el mandato installUtility.

--acceptLicense
Indicar la aceptación de los términos y condiciones de licencia.
--viewLicenseAgreement
Ver el acuerdo de licencia.
--viewLicenseInfo
Ver la información de la licencia.
--verbose
Utilice esta opción para visualizar cualquier información adicional mientras se ejecuta la acción.
nombre
Especifique uno o más activos que desee instalar. Puede especificar los activos de los modos siguientes:
ID de activos
Puede especificar los ID de activo para instalar uno o varios de los activos siguientes, separando varios ID de activo con un espacio:
  • Características
  • Complementos
  • Integraciones de código abierto
  • Ejemplos
Nombre de servidor
Puede instalar características según un servidor existente en el mismo entorno de Liberty especificando el nombre del servidor. El mandato instala las características aplicables definidas en el archivo server.xml de dicho servidor que no están instaladas ya en el entorno de Liberty.
Paquete de servidor
Puede especificar un paquete de servidor que ha creado utilizando el mandato server package --include=usr. Se despliega el paquete del servidor y las características necesarias, que están definidas en el archivo server.xml, se instalan desde los repositorios.
Archivo server.xml
Para instalar características según un archivo de configuración existente, puede especificar una vía de acceso a cualquier archivo server.xml local, como por ejemplo C:\localDir\server.xml. El mandato instala las características aplicables definidas en el archivo server.xml que no están instaladas ya en el entorno de Liberty.
archivo .esa
Instalar una característica desde un archivo .esa en su sistema de archivos local. Esta acción utiliza el archivo de manifiesto OSGI-INF/SUBSYTEM.MF del archivo .esa como nuevo manifiesto de característica. El archivo de manifiesto especifica el nombre, el contenido y las dependencias de una característica. Si especifica la opción --to, installUtility copia el archivo de manifiesto en el directorio ${wlp.user.dir}/extensions/lib/features, o el directorio de la expansión del producto. 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 se extraen en la ubicación definida en el manifiesto del subsistema.

Está disponible la siguiente opción para el mandato installUtility testConnection:
repoName
Especifica el nombre del repositorio que se va a probar. Si no se especifica, se prueban todos los repositorios que se especifican en el archivo repositories.properties.

Está disponible la siguiente opción para el mandato installUtility uninstall:
--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
Desinstala la característica sin solicitudes. El valor predeterminado es false.
--verbose
Utilice esta opción para visualizar información adicional durante la desinstalación.
nombre
Especifique una o más características para desinstalar, separando varios nombres con un espacio. 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.

Puede desinstalar características de usuario y extensiones del producto añadiendo como prefijo al nombre de la característica la extensión seguida de dos puntos, por ejemplo, usr:webCacheMonitor-1.0.


Esta disponible la siguiente opción para el mandato installUtility viewSettings:
--viewValidationMessages
Utilice esta opción para visualizar los mensajes detallados de la validación del archivo repositories.properties configurado. Cada mensaje contiene un código de error, el número de línea donde se ha encontrado el error y la causa del error.

Ejemplos de uso

Utilice el siguiente ejemplo para ver información de ayuda para la acción install:
installUtility help install
Utilice el siguiente ejemplo para instalar una característica de usuario:
installUtility install my_feature --to=usr
Utilice el siguiente ejemplo para instalar una característica de usuario en la ubicación de extensión del producto my_extension:
installUtility install my_feature --to=my_extension
Utilice el siguiente ejemplo para instalar varias características:
installUtility install característica1 característica2 característica3
Utilice el siguiente ejemplo para instalar un ejemplo:
installUtility install mongoDBSample
Utilice el siguiente ejemplo para instalar un paquete de características de complemento de un único repositorio basado en directorio local:
installUtility install ndMemberBundlelibertyCoreBundle --from=c:\download\wlp-featureRepo-16.0.0.2
Utilice el ejemplo de repositorio para instalar un complemento de paquete de características desde un único archivado de repositorio comprimido basado en directorio:
installUtility install ndMemberBundlelibertyCoreBundle --from=c:\download\wlp-featureRepo-16.0.0.2.zip
Utilice el siguiente ejemplo para instalar un servidor:
installUtility install myServer
Utilice el siguiente ejemplo para instalar un archivo comprimido .jar de paquete de servidor:
installUtility install c:\temp\myServer.jar
Utilice el siguiente ejemplo para instalar un archivo .esa local:
installUtility install c:\temp\myFeature.esa 
Utilice el siguiente ejemplo para instalar un archivo comprimido de paquete de servidor:
installUtility install c:\temp\myServer.zip
Utilice el siguiente ejemplo para buscar los activos que son aplicables a su configuración:
installUtility find searchString
Utilice el siguiente ejemplo para buscar los ejemplos que son aplicables a su configuración:
installUtility find searchString --type=sample
Utilice el siguiente ejemplo para buscar una determinada característica que sea aplicable a su configuración:
installUtility find webCacheMonitor-1.0 --name --type=feature
Utilice el siguiente ejemplo para listar información detallada:
installUtility find searchstring --showDescriptions
Utilice el siguiente ejemplo para descargar las dependencias necesarias de los repositorios en un directorio local:
installUtility download feature_shortName --location=c:\temp\download --acceptLicense
Utilice el siguiente ejemplo para probar la conexión con el repositorio de Liberty:
installUtility testConnection default
Utilice el siguiente ejemplo para desinstalar una característica:
installUtility uninstall adminCenter-1.0
Utilice el siguiente ejemplo para desinstalar una característica de usuario o una extensión del producto:
installUtility uninstall usr:webCacheMonitor-1.0
Utilice el siguiente ejemplo para desinstalar varias características:
installUtility uninstall feature1 feature2 feature3
Utilice el siguiente ejemplo para desinstalar varias características sin solicitudes:
installUtility uninstall --noPrompts feature1 feature2 feature3

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 durante la instalación del 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 se va a 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 se va a instalar ya existe.
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.
30 El archivo repositories.properties ha fallado la validación.
33 La conexión con el repositorio ha fallado.
34 No se ha encontrado el nombre de repositorio. El nombre de repositorio proporcionado no existe en el archivo de configuración.
35 El usuario ha cancelado la acción.

Icono que indica el tipo de tema Tema de referencia



Icono de indicación de fecha y hora Última actualización: Tuesday, 6 December 2016
http://www14.software.ibm.com/webapp/wsbroker/redirect?version=cord&product=was-libcore-mp&topic=rwlp_command_installutility
Nombre de archivo:rwlp_command_installutility.html