![[8.5.5.6 o posterior]](../ng_v8556.gif)
Mandato installUtility
Utilice el mandato installUtility para buscar, obtener información e instalar activos que están en un repositorio local, un repositorio remoto o el repositorio de IBM® WebSphere Liberty.
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.
- help
- Mostrar información de ayuda para una acción especificada.
- 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
- Ver los valores del proxy y el repositorio para el mandato installUtility.
Cuando se utilizan estas acciones, el mandato installUtility puede acceder a los activos en los siguientes repositorios:
- El repositorio de IBM WebSphere Liberty, un repositorio público alojado en IBM al que se puede acceder a través de 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 repositorio in situ al que se puede acceder de forma remota detrás del cortafuegos de una empresa; consulte el Repositorio WASdev/tool.lars en GitHub.
- Repositorios basados en el directorio local que se crean utilizando la acción Descarga de installUtility. Para obtener más información, consulte Descarga de activos utilizando el mandato installUtility.
Opciones
Están disponibles las
opciones siguientes para el mandato installUtility install:
- --acceptLicense
- Indicar la aceptación de los términos y condiciones de licencia.
- --to=opción_instalación
- La opción opción_instalación puede tener uno de los valores siguientes:
- usuario: 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.
- --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
- Especifica los activos que desea instalar. Puede especificar los activos de los modos siguientes:
- ID de activos
- Puede especificar los ID de activos para instalar uno o varios de los siguientes activos:
- Características
- Complementos
- Integraciones de código abierto
- Ejemplos
- Nombre de servidor
- Puede instalar las características que faltan para un servidor existente utilizando el nombre del servidor. Las características necesarias, que se definen en el archivo server.xml, se instalan desde los repositorios.
- 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 .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 extensió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, los archivos de localización y otro contenido del subsistema también se extraen en la ubicación definida en el manifiesto del subsistema.
Están disponibles las opciones siguientes para el mandato installUtility find:
- --showDescriptions
- Muestra la descripción de 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.
- 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 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 cuando realice la descarga 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 activos para descargar uno o varios de los activos siguientes:
- Características
- Complementos
- Integraciones de código abierto
- Ejemplos
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:
- --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 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.
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 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 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
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. |
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. |