Cuando estaba explorando las APIs de z/OSMF en ADCD 2.5 (RSU 2112), me di cuenta de que, cuando entraba a la ruta zosmf/api/explorer (Swagger), no veía ninguna API disponible. Todo estaba bien configurado, pero en la STC IZUSVR1 aparecería el mensaje “CWWKE0701E: bundle com.ibm.ws.rest.api.discovery”. Debido al error, el servicio que se encarga de descubrir las API no funcionaba. Voy a enseñar a actualizar Liberty a la última versión.
Encontré el siguiente enlace que indicaba que estaba corregido en la versión 21.0.0.10 (yo uso la versión 21.0.0.9):
El error detallado es:
CWWKE0701E: bundle com.ibm.ws.rest.api.discovery:1.0.56.cl210920210824-2341 (135)Ýcom.ibm.ws.rest.api.discovery.APIProviderAggregator(397)~ : The setServerStartedPhase2 method has thrown an exception java.util.ConcurrentModificationException
Se puede ver que la página aparece en blanco.
NOTA: Para poder acceder a Swagger es necesario hacer los pasos que se indican en este enlace (crear los recursos de la clase EJBROLE).
Using the z/OSMF REST services
Mi versión en uso es las 21.0.0.9.
En el siguiente enlace se pueden encontrar las versiones disponibles.
Recommended updates for WebSphere Application Server
Descargaré la versión 22.0.0.7, concretamente la versión “portable”.
Importante descargar también el fichero README porque incluye información necesaria.
Las instrucciones de instalación son muy sencillas. Se pueden encontrar aquí:
Using Installation Manager portable installs on z/OS
Nos apuntamos el punto de montaje y el espacio porque tenemos que crear un ZFS para montarlo en ese directorio.
Empiezo creando el ZFS y las rutas necesarias. El job se puede descargar la principio de la entrada.
Terminará correctamente.
Ahora hay que transferir el software por FTP al directorio que hemos creado.
ftp 192.168.1.12
bin
cd /global/instmgr/WL220007
put wlp-zos-22.0.0.7.pax.Z
Con el siguiente job descomprimiré el fichero. Se puede descargar al principio de la entrada.
Tendremos lo siguiente. Esto es el software ya disponible para ser usado. Simplemente hay que desmontar el ZFS y montarlo en la ruta que queramos.
Dentro de la carpeta wlp veremos que está el producto.
Yo, siguiendo el modo en el que está instalado en la versión 2.5 de ADCD, lo montaré dentro de un directorio en /usr/lpp/liberty_zos.
Para ello, voy a usar un job que desmontará el ZFS, creará el nuevo directorio y lo montará ahí.
Ya tendremos creado el directorio. Ahora hay que actualizar el enlace simbólico current para que apunte a la nueva versión.
Usaré el siguiente job.
Confirmamos que el enlace apunta a la nueva librería.
Ahora arrancamos z/OSMF.
S IZUANG1
S IZUSVR1
Nos fijamos que use la nueva versión.
Confirmamos que todo arranca.
El entrar para ver las API disponibles ahora si veremos el contenido.
Ya tenemos instalada la nueva versión de Liberty y hemos confirmado que con esta versión si podemos explorar las APIs correctamente.