Anteriormente hicimos una instalación de ZOWE usando la versión SMPE y la versión Convenience build. En esta ocasión, volveremos a instalar la versión 1.24.0 - Convenience build.
La instalación la haré mediante de comandos de OMVS. Estos comandos se pueden dar desde el terminal o por job (JCL).
En mi sistema ya está la versión 1.23.0 instalada, por lo tanto, ya habrá algunas partes (como la referente a la seguridad RACF) que ya estará realizada.
Vamos a la página oficial de ZOWE y descargamos el producto:
Seguiremos los pasos de:
Installing Zowe runtime from a convenience build
Ahora crearemos un ZFS para subir el software. Además, crearemos el directorio /var/zowe y montaremos el ZFS en ese punto de montaje.
Después habrá que añadirlo al miembro BPXPRMxx.
NOTA: Podéis descargar el job al principio de la página.
Si en algún momento queremos comprobar el espacio que tenemos disponible, desde OMVS (TSO OMVS), usaremos el comando:
df -P /var/zowe
Ahora transferimos el software mediante FTP (en mi caso, tuve que arrancar el FTP con el comando “S FTPD”).
ftp XXX.XXX.XXX.XXX
binary
cd /var/zowe
put zowe-1.24.0.pax
El archivo podemos descomprimirlo usando el siguiente job:
Comprobamos que se ha extraído.
Una vez extraídos los ficheros, tenemos que definir los siguientes parámetros:
<RUNTIME_DIR>
<DATA_SET_PREFIX>
<LOG_DIR>
En mi caso, como es una subida de versión, usaré los siguientes:
/var/zowe/runtime
ZWE100.V1240
/var/zowe/logs
Hay dos formas de realizar la instalación: mediante comando y por WORKFLOW de z/OSMF.
Mediante comando sería usando:
zowe-install.sh -i <RUNTIME_DIR> -h <DATASET_PREFIX> [-l <LOG_DIR>]
Podemos hacerlo por job:
Comprobamos que no de errores del tipo:
WARNING: NODE_HOME is not defined. The component commands.install defined in manifest will not be processed.
You can either re-run the zowe-install-component.sh script with NODE_HOME defined, or run commands.install defined in manifest manually.
Install Zowe component /S0W1/var/zowe/zowe-1.20.1/./files/files-api-package-1.0.6.zip to /var/zowe/runtime/components
Si apareciesen esos errores, hay que comprobar que el “export” de “NODE_HOME” tenga la ruta correcta donde está instalado NODE.JS y volver a procesarlo.
Ya tenemos hecha la instalación del producto, ahora falta configurar: seguridad, certificados, instancia y STCs.
El primer job que deberíamos ejecutar es el ZWE100.V1240.SZWESAMP(ZWESECUR).
En mi caso, no lo voy a hacer porque ya estaba instalada una versión anterior de ZOWE. Solo lo ejecutaré en caso de detectar algún error de permisos en el futuro.
Ahora vamos a crear los certificados para ZOWE.
Para ello, debemos editar el siguiente fichero de variables y adaptarlas a nuestro sistema.
/var/zowe/runtime/bin/zowe-setup-certificates.env
La ruta /apps/zowe/v1240 se usará en un paso posterior.
Ahora ejecutaremos el script que genera los certificados. Lo podemos hacer por job o de forma manual.
El comando “export ZOWE_ZOSMF_PORT=10443” sirve para evitar el error:
Unable to detect z/OS MF HTTPS port
Please enter the HTTPS port of z/OS MF server on this system
Comprobamos que termine bien.
El siguiente paso es añadir la librería de módulos ZWE100.V1240.SZWEAUTH a APF:
SETPROG APF,ADD,DSNAME=ZWE100.V1240.SZWEAUTH,VOLUME=PRD000
Además, lo añadimos al miembro PROGxx correspondiente.
Ahora hay que añadir lo siguiente en el miembro SCHEDxx correspondiente:
PPT PGMNAME(ZWESIS01) KEY(4) NOSWAP
En mi caso, ya lo tenía añadido de la instalación anterior.
Copiamos el miembro ZWE100.V1240.SZWESAMP(ZWESISTC) a nuestra PROCLIB.
Adaptamos la STC con la librería STEPLIB correspondiente, en mi caso, ZWE100.V1240.SZWEAUTH.
También indicamos la PARMLIB en la que guardaremos el fichero de parámetros.
El parámetro “MEM” indica el sufijo del fichero de parámetros, en este caso, será ZWESIP00.
Copiamos el fichero de parámetros ZWESIP00 de la librería de ejemplos (ZWE100.V1240.SZWESAMP) a la PARMLIB indicada en la tarea ZWESISTC.
En este miembro no he realizado ningún cambio.
El siguiente paso es crear la instancia. Este paso se puede hacer por job o por de forma manual.
Consiste en ejecutar el siguiente script indicando dónde crearemos la instancia:
<RUNTIME_DIR>/bin/zowe-configure-instance.sh -c <PATH_TO_INSTANCE_DIR>
El job debería tardar menos de 5 minutos en ejecutarse. Si tarda más, quiere decir que en algún punto el script se ha quedado atascado. Habrá que cancelarlo y hacer el proceso por OMVS.
Comprobamos que termina correctamente.
Ahora vamos al directorio de la instancia /apps/zowe/v1240 y modificamos el fichero instance.env
En mi caso, solo tuve que modificar las siguientes variables por el valor correcto. El resto lo dejé por defecto.
ZOSMF_HOST=S0W1.EMUFRAMEZOS.COM
KEYSTORE_DIRECTORY=/apps/zowe/v1240/security/keystore
Copiamos el miembro ZWE100.V1240.SZWESAMP(ZWESVSTC) a la PROCLIB.
Indicamos la ruta a la instancia, en mi caso, /apps/zowe/v1240.
También copiaremos la última STC que nos falta llamada ZWESASTC. Esta STC no hace falta arrancarla. Lo hará el propio programa si la necesita.
Indicamos la librería correspondiente en la STEPLIB.
Por último, arrancamos las tareas con los comandos:
S ZWESISTC,PARM='COLD'
S ZWESVSTC
Lo arranco en COLD por el cambio de versión.
Comprobamos que se trata de la versión nueva.
Espero que os haya parecido fácil esta instalación. Son los mismos pasos que hicimos para instalar la versión 1.23.0.
¡Que lo disfrutéis!