Configuración de repositorios y valores de proxy para el mandato installUtility

En el archivo repositories.properties, puede configurar cómo accede el mandato installUtility accede a los repositorios basados en directorio local, instancias de Liberty Asset Repository Service y al Repositorio de Liberty.

Acerca de esta tarea

El mandato installUtility puede acceder a los siguientes repositorios:
  • 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.

Los mandatos installUtility e featureManager utilizan el mismo archivo de propiedades de configuración, repositories.properties. Los valores de proxy se comparten, pero los valores del repositorio solamente los utiliza el mandato installUtility. Para gestionar activos y realizar operaciones de instalación, búsqueda o desinstalación basada en el repositorio, utilice el mandato installUtility en lugar del mandato featureManager.

Consejo: Puede descargar o instalar activos desde un único repositorio basado en directorio local especificando el repositorio en la opción --from. No es necesaria ninguna configuración adicional en el archivo repositories.properties. Para obtener más información, consulte Mandato installUtility.
Para acceder a IBM WebSphere Liberty Repository con acceso a Internet limitado o a través de un cortafuegos, asegúrese de que tiene acceso a los siguientes hosts y puertos:
  • public.dhe.ibm.com en el puerto 443
  • asset-websphere.ibm.com en el puerto 443
Nota: El mandato installUtility solamente admite servidores proxy con protocolos HTTP/HTTPS.

Procedimiento

  1. Opcional: Cuando configura por primera vez los valores de repositorio o proxy, puede ejecutar el mandato installUtility viewSettings para generar una plantilla de configuración para el archivo repositories.properties.

    Copie la plantilla en un nuevo archivo de propiedades en ${wlp.install.dir}/etc/repositories.properties. El archivo de propiedades debe estar en formato ASCII para todas las plataformas.

  2. Defina los valores en el archivo ${wlp.install.dir}/etc/repositories.properties.

    Si ha copiado la plantilla desde el mandato installUtility viewSettings, modifique la plantilla cambiando los valores de repositorio y proxy de ejemplo para que hagan referencia a su entorno. Las líneas que empiezan con un signo de número (#) no se procesan.

    • Para inhabilitar el acceso al Repositorio de Liberty, establezca la propiedad useDefaultRepository en false. El Repositorio de Liberty está habilitado de forma predeterminada y es el último repositorio al que se accede cuando se instalan o descargan activos.
      useDefaultRepository=false
    • Para definir un repositorio, añada una propiedad como repoName.url=url o repoName.url=file_path. Cada nombre de repositorio debe ser exclusivo.

      A los repositorios definidos se accede en el orden en el que se han especificado en el archivo repositories.properties.

      For Windows platforms
      dev-rep.url=http://dev.repo.ibm.com:9080/ma/v1
      local-rep2.url=file:///c:/IBM/localrepo2
      local-rep3.url=C:\IBM\localrepo3
      local-rep4.url=C:\IBM\localrepo4.zip
      For HP UNIX platformsFor Solaris platformsFor LINUX platformsFor UNIX platformsFor z/OS platforms
      dev-rep.url=http://dev.repo.ibm.com:9080/ma/v1
      local-rep2.url=file:///usr/IBM/localrepo2
      local-rep3.url=/usr/IBM/localrepo3
      local-rep4.url=/usr/IBM/localrepo4.zip
    • Si un repositorio requiere un nombre de usuario y una contraseña, establezca las propiedades repoName.user=userId y repoName.userPassword=password.
      Si se requiere un nombre de usuario y una contraseña y no se han establecido, recibirá una solicitud para que los proporcione. Para obtener una mejor seguridad, codifique la contraseña utilizando la acción securityUtility encode. Si desea más información, consulte Liberty: Mandato securityUtility.
      dev-rep.user=myname                            
      dev-rep.userPassword={aes}AH5NLyd7DfGb12pK17Pw+
    • Si su sistema requiere acceso al Repositorio de Liberty o a una instancia de Liberty Asset Repository Service mediante un servidor proxy, establezca las propiedades de proxy proxyHost, proxyPort, proxyUser y proxyPassword.

      Para obtener seguridad mejorada, codifique el valor de la propiedad proxyPassword mediante la acción securityUtility encode. Si no establece el nombre de usuario y la contraseña, recibirá una solicitud para que los proporcione.

      Por ejemplo:
      proxyHost=my.proxy.server.ibm.com
      proxyPort=9080
      proxyUser=myname
      proxyPassword={aes}AH5NLyd7DfGb12pK17Pw+
  3. Guarde los cambios en el archivo repositories.properties.
  4. Revise los valores de repositorio y proxy ejecutando el mandato installUtility viewSettings. Cuando se ejecuta el mandato installUtility viewSettings, la configuración de repositorio y proxy se valida automáticamente. Para ver mensajes de validación detallados, ejecute el mandato con la opción --viewValidationMessages.
    >installUtility viewSettings
    
    installUtility Settings
    ----------------------------------------------------------------------
    Properties File: c:\wlp\etc\repositories.properties
    Default Assets Repository: IBM WebSphere Liberty Repository
    Use Default Repository: True
    
    Validación de archivo de propiedades
    ----------------------------------------------------------------------
    Resultados de validación: El archivo de propiedades ha pasado correctamente 
    la validación.
    
    Configured Repositories
    ----------------------------------------------------------------------
    Name: dev-rep
    Location: http://dev.repo.ibm.com:9080/ma/v1
    User Name: myname
    Password: <Unspecified>
    
    Proxy Settings
    ----------------------------------------------------------------------
    Proxy Server: my.proxy.server.ibm.com
    Port: 9080
    User Name: myname
    Password: ********
  5. Pruebe la conexión de repositorio ejecutando el mandato installUtility testConnection. Si no establece el nombre de usuario y la contraseña, recibirá una solicitud para que los proporcione.
    >installUtility testConnection
    Testing the connection to all configured repositories...
    This process might take several minutes to complete.
    
    Configured Repositories
    ----------------------------------------------------------------------
    Name: dev-rep
    Location: http://dev.repo.ibm.com:9080/ma/v1
    Status: Successfully connected to the configured repository.
    Name: IBM WebSphere Liberty Repository (Default Assets Repository)
    Status: Successfully connected to the configured repository. 
    Puede probar todos los repositorios configurados en el archivo repositories.properties a la vez ejecutando el mandato installUtility testConnection sin especificar repoName. El nombre de repositorio para el Repositorio de Liberty es default. Para probar la conexión con el Repositorio de Liberty, ejecute el mandato siguiente:
    installUtility testConnection default

Qué hacer a continuación

Puede utilizar el mandato installUtility para buscar activos e instalarlos o descargarlos desde los repositorios configurados.

Icono que indica el tipo de tema Tema de tarea

Nombre de archivo: twlp_config_installutility.html