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 Liberty.
Orígenes de activo
- El Repositorio de Liberty, es un repositorio alojado por IBM® al que se puede acceder en internet. Para obtener más información, consulte Repositorio de Liberty.
- 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 se crean 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-<version>.zip, consulte Descarga de activos utilizando el mandato installUtility.
Sintaxis
La sintaxis del mandato es la siguiente:
installUtility acción [opciones]
- 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
- --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
- --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.
- --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.
- 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.
- --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.
- --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
installUtility help install
installUtility install my_feature --to=usr
installUtility install my_feature --to=my_extension
installUtility install característica1 característica2 característica3
installUtility install mongoDBSample
installUtility install --from=c:\download\wlp-featureRepo-16.0.0.2
installUtility install --from=c:\download\wlp-featureRepo-16.0.0.2.zip
installUtility install myServer
installUtility install c:\temp\myServer.jar
installUtility install c:\temp\myFeature.esa
installUtility install c:\temp\myServer.zip
installUtility find searchString
installUtility find searchString --type=sample
installUtility find webCacheMonitor-1.0 --name --type=feature
installUtility find searchstring --showDescriptions
installUtility download feature_shortName --location=c:\temp\download --acceptLicense
installUtility testConnection default
installUtility uninstall adminCenter-1.0
installUtility uninstall usr:webCacheMonitor-1.0
installUtility uninstall feature1 feature2 feature3
installUtility uninstall --noPrompts feature1 feature2 feature3
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 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:
|
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. |
![]() |
![]() |