Instalación de Liberty en sistemas operativos IBM i utilizando la línea de mandatos

Puede instalar todas las ofertas de WebSphere Application Server Liberty en sistemas operativos IBM® i utilizando la línea de mandatos de Installation Manager.

Antes de empezar

[17.0.0.3 and later]Importante: El soporte para utilizar Java™ SE 6 con WebSphere Liberty finalizó en septiembre de 2017. El kernel Liberty se recompiló para 17.0.0.3. A partir de 17.0.0.3, el kernel Liberty deja de ejecutarse con Java SE 6. Si sigue utilizando Java SE 6 en releases anteriores después del fin de la fecha de soporte, podría exponer su entorno a riesgos de seguridad.

El SDK de Java recomendado es Java SE 8, porque proporciona las últimas características y actualizaciones de seguridad. Como alternativa a Java SE 8 se puede utilizar cualquier versión soportada de Java SDK.

Prepare la instalación antes de utilizar este procedimiento. Consulte Preparación del sistema operativo para la instalación en IBM i para obtener más información.

Si desea instalar activos de Liberty desde repositorios basados en el directorio local o en una instancia de Liberty Asset Repository Service, configure los repositorios. Si desea más información sobre los repositorios de activos Liberty, consulte Instalación de activos utilizando Installation Manager.

Importante: Antes de instalar Liberty, debe leer el acuerdo de licencia que se puede encontrar con los archivos de producto. Manifieste su aceptación del acuerdo de licencia especificando -acceptLicense en el mandato, como se describe en el tema.

Si IBM Installation Manager Versión 1.8.5 o posterior todavía no está instalado, instálelo en el sistema donde desea instalar el producto:

  1. Descargue IBM Installation Manager.
    Existen tres opciones básicas para acceder a archivos de instalación de Installation Manager.
    • Descargue la versión más actual de Installation Manager desde el sitio web de descarga de IBM Installation Manager.
    • Instale Installation Manager desde repositorios de producto en el soporte.
    • Descargue los archivos desde el sitio de Passport Advantage y utilice la instalación local.

      Los clientes con licencia con un ID y una contraseña de Passport Advantage pueden descargar los repositorios de producto necesarios del sitio de Passport Advantage.

  2. Elija tres ubicaciones independientes para los binarios, los datos de ejecución (datos de agente) y los datos compartidos de Installation Manager.
  3. Instale Installation Manager utilizando la línea de mandatos de Installation Manager.
    1. Inicie la sesión en el sistema IBM i con un perfil de usuario que tenga las autorizaciones especiales *ALLOBJ y *SECADM.
    2. En una línea de mandato CL, ejecute el mandato STRQSH para iniciar el shell de mandato de Qshell.
    3. Asegúrese de que umask esté establecido en 022.
      Para verificar el valor de la máscara U, emita el mandato siguiente:
      umask
      Para definir el valor de máscara U en 022, emita el mandato siguiente:
      Máscara
      U 022
    4. Vaya a la ubicación que contiene los archivos de instalación de Installation Manager y ejecute el mandato siguiente:
      installc -acceptLicense -log nombre_y_vía_acceso_archivo_registro
      Notas:

Acerca de esta tarea

Todas las ofertas de producto, incluyendo las ofertas de producto Liberty y otro software disponible, se instalan utilizando los mismos mandatos de Installation Manager. Para instalar una oferta diferente, siga estos pasos, pero sustituya el ID de la oferta y cualquier característica opcional con el ID y las características de la oferta.
New: Cuando se instala Liberty, de forma predeterminada, todas las características de Liberty que se aplican a la edición del producto Liberty también se instalan. De forma alternativa, puede instalar un conjunto de características diferente o ninguna. Si desea más información, consulte la sección Sugerencias.

Procedimiento

  1. Opcional: Si el repositorio requiere un nombre de usuario y una contraseña, cree un archivo de almacenamiento de credenciales y un archivo de contraseñas maestras para acceder a este repositorio.
    1. Opcional: Cree el archivo de contraseña maestra.

      El archivo de contraseña maestra es un archivo de texto que contiene una frase de contraseña como, por ejemplo, "Este texto es la contraseña maestra." Este archivo se utiliza para proteger las credenciales de autenticación.

      Si crea un archivo de contraseña maestra y lo utiliza cuando se crean credenciales, siempre debe especificar el archivo de la contraseña maestra.

      Consejo: Para proteger este archivo, establezca permisos para restringir el acceso a este archivo, según sea apropiado para su sistema operativo.
    2. Cree un archivo de almacenamiento de credenciales ejecutando el mandato imutilsc saveCredential.
      For Windows platforms
      imutilsc.exe saveCredential 
        -secureStorageFile
      archivo_almacenamiento
        -userName ID_usuario -userPassword contraseña_usuario
        -url URL_o_vía_acceso_repositorio 
      For AIX platformsFor HP UNIX platformsFor LINUX platformsFor Solaris platforms
      ./imutilsc saveCredential 
        -secureStorageFile
      archivo_almacenamiento
        -userName ID_usuario -userPassword contraseña_usuario
        -url URL_o_vía_acceso_repositorio 
      Consejo: Si el mandato imutilsc no puede encontrar el URL que se ha especificado al crear el archivo de almacenamiento de credenciales, añada /repository.config al final de la ubicación del URL del repositorio.
  2. Inicie la sesión en el sistema IBM i con un perfil de usuario que tenga las autorizaciones especiales *ALLOBJ y *SECADM.
  3. En una línea de mandato CL, ejecute el mandato STRQSH para iniciar el shell de mandato de Qshell.
  4. Asegúrese de que umask esté establecido en 022.
    Para verificar el valor de la máscara U, emita el mandato siguiente:
    umask
    Para definir el valor de máscara U en 022, emita el mandato siguiente:
    Máscara
    U 022
  5. Vaya al subdirectorio eclipse/tools en el directorio donde ha instalado Installation Manager.
  6. Utilice el mandato imcl para instalar el producto.
    ./imcl install com.ibm.websphere.liberty.CORE.ND_offering_version,optional_feature_ID
      -repositories URL_o_vía_acceso_repositorio 
      -installationDirectory directorio_instalación 
      -sharedResourcesDirectory directorio_compartido
      -preferences clave_preferencias=valor
      -properties clave_propiedad=valor
      -secureStorageFile archivo_almacenamiento -masterPasswordFile archivo_contraseña_maestra
      -acceptLicense
    Consejos:
    • New: Cuando se instala Liberty, de forma predeterminada, todas las características de Liberty que se aplican a la edición del producto Liberty también se instalan.
      En lugar de instalar todas las características, puede instalar un conjunto personalizado de complementos y características de Liberty especificándolos en las propiedades user.addon y user.feature, tal como se indica en el ejemplo siguiente. Tenga en cuenta que los nombres abreviados o los nombres simbólicos de característica están separados con comas dobles:
      ./imcl install com.ibm.websphere.liberty.CORE.ND,embeddablecontainer             
      -properties user.addon=extendedPackage-1.0,user.feature=portlet-2.0,,portletserving-2.0
      -installationDirectory /QIBM/ProdData/WebSphere/Liberty/LibertyCore -acceptLicense
      -repositories /QIBM/LibertyProductRepo,https://your_onprem_asset_repo_url,/QIBM/LocalAssetRepo,/QIBM/LocalAssetRepo2.zip
      -sharedResourcesDirectory /QIBM/UserData/InstallationManager/IMShared
      -showProgress
      Puede instalar activos de instancias del servicio Liberty Asset Repository Service o repositorios locales basados en directorios con o sin acceso a Internet. Añada el URL del repositorio, la vía de acceso de directorio o la vía de acceso de archivo de archivado en el parámetro -repositories. Se accede a estos repositorios en el orden en el que se han especificado. Si desea más información sobre estos repositorios de activos, consulte Instalación de activos utilizando Installation Manager. Para instalar activos desde el IBM WebSphere Liberty Repository, debe tener acceso a Internet. Para habilitar el acceso al repositorio de Liberty en el parámetro -properties, establezca la opción user.useLibertyRepository en true. El repositorio de Liberty es el último de los repositorios a los que se ha accedido durante la instalación.
      Importante: Si no desea instalar complementos o características de Liberty, especifique el parámetro -properties user.addon="" user.feature="".
    • Los términos y condiciones relevantes, avisos y otra información se proporcionan en los archivos del acuerdo de licencia en lafiles o en el subdirectorio nombre_oferta/lafiles de la imagen de instalación o del repositorio de esta oferta.
    • La primera vez que instale un paquete utilizando Installation Manager, especifique el directorio de recursos compartidos. El directorio de recursos compartidos es donde se encuentran los artefactos de instalación que pueden ser utilizados por uno o más grupos de paquetes. También se utiliza como un área de transferencia para la carga útil de producto durante las operaciones de instalación. De forma predeterminada, este contenido se almacena en memoria caché para que pueda ser utilizado para la retrotracción. Utilice la unidad más grande para esta instalación. No podrá cambiar la ubicación del directorio hasta después de desinstalar todos los paquetes.
    • La versión_oferta, se puede adjuntar al ID de oferta con un carácter de subrayado, es una versión específica de la oferta que se va a instalar (16.0.2.20160503_0200 por ejemplo).
      • Si no se especifica versión_oferta, se instalan la versión más reciente de la oferta y todos los arreglos temporales para esa versión.
      • Si se especifica versión_oferta, se instala la versión especificada de la oferta pero no se instalan arreglos temporales para esa versión.
      La versión de oferta se puede encontrar al final del ID de la oferta con un carácter de subrayado al ejecutar el mandato siguiente en el repositorio:
      imcl
      listAvailablePackages -repositories
      URL_o_vía_repositorio
    • También puede especificar none, recommended o all con el argumento -installFixes para indicar qué arreglos temporales desea instalar con la oferta.
      • Si no se especifica la versión de oferta, la opción -installFixes toma all de forma predeterminada.
      • Si se especifica la versión de oferta, la opción -installFixes toma none de forma predeterminada.
    • Para instalar el contenedor EJB incorporable y un cliente JPA, especifique la característica embeddablecontainer opcional detrás del ID de la oferta, separada con una coma:
      imcl install com.ibm.websphere.liberty.CORE.ND,embeddablecontainer

      El contenedor EJB incorporable es un archivo JAR (Java Archive) que puede utilizar para ejecutar enterprise beans en un entorno autónomo de Java Platform, Standard Edition (SE). Puede ejecutar enterprise beans utilizando este contenedor que se puede incorporar fuera del servidor de aplicaciones. El contenedor EJB incorporable forma parte de la especificación EJB 3.1 y se utiliza principalmente para la lógica empresarial de enterprise beans de pruebas de unidad.

      El cliente JPA puede utilizarse con el contenedor EJB incorporable para proporcionar función de Java Persistence API en un entorno Java SE.

    • Para instalaciones iniciales, es una práctica recomendada para especificar raíz_datos_usuario; de lo contrario, se utiliza el valor predeterminado para raíz_datos_usuario, /QIBM/UserData/WebSphere/Liberty/EDITION. Utilice la propiedad was.install.os400.profile.location para especificar raíz_datos_usuario.
    • Es posible que el programa grabe instrucciones posteriores a la instalación importantes en la salida estándar.

    Si desea más información sobre cómo utilizar el mandato imcl para instalar el producto, consulte la documentación del producto IBM Installation Manager.

Ejemplo

A continuación aparece un ejemplo de uso del mandato imcl para instalar WebSphere Application Server LibertyCore:
./imcl install com.ibm.websphere.liberty.CORE.ND
  -repositories https://downloads.mycorp.com:8080/WAS_Liberty_repository
  -installationDirectory /QIBM/ProdData/WebSphere/Liberty/LibertyCore
  -properties was.install.os400.profile.location=/QIBM/UserData/WebSphere/Liberty/LibertyCore
  -sharedResourcesDirectory /QIBM/UserData/InstallationManager/IMShared
  -secureStorageFile $HOME/WASFiles/temp/credential.store -masterPasswordFile $HOME/WASFiles/IM/master_password_file.txt
  -acceptLicense

Icono que indica el tipo de tema Tema de tarea

Nombre de archivo: twlp_ins_installation_is_cl.html