How To
Summary
Describe in detail how to download and install the DWC under z/OS ( zliberty)
Objective
Installed DWC on z/OS
Environment
z/OS with z Workload Scheduler 9.3 or higher installed
Steps
(A) Create two ZFS files, one to hold the pax file needed for the install (from FIX CENTRAL) and the other
to hold the data created by the install itself (dwcinst script)
For example:
to hold the data created by the install itself (dwcinst script)
For example:
For PAX:
//STEP1 EXEC PGM=IDCAMS
//SYSPRINT DD SYSOUT=*
//SYSIN DD *
DEFINE CLUSTER (NAME(ZWS.DWC.ZFS) -
VOLUMES(I#US04) -
LINEAR CYL(3300 1000) SHAREOPTIONS(2))
//STEP2 EXEC PGM=IOEAGFMT,REGION=0M,
// PARM=('-aggregate ZWS.DWC.ZFS -compat')
//SYSPRINT DD SYSOUT=*
//STDOUT DD SYSOUT=*
//STDERR DD SYSOUT=*
//SYSUDUMP DD SYSOUT=*
//CEEDUMP DD SYSOUT=*
//SYSPRINT DD SYSOUT=*
//SYSIN DD *
DEFINE CLUSTER (NAME(ZWS.DWC.ZFS) -
VOLUMES(I#US04) -
LINEAR CYL(3300 1000) SHAREOPTIONS(2))
//STEP2 EXEC PGM=IOEAGFMT,REGION=0M,
// PARM=('-aggregate ZWS.DWC.ZFS -compat')
//SYSPRINT DD SYSOUT=*
//STDOUT DD SYSOUT=*
//STDERR DD SYSOUT=*
//SYSUDUMP DD SYSOUT=*
//CEEDUMP DD SYSOUT=*
For INSTALL:
//STEP1 EXEC PGM=IDCAMS
//SYSPRINT DD SYSOUT=*
//SYSIN DD *
DEFINE CLUSTER (NAME(ZWS.DWCFP4.ZFS) -
VOLUMES(I#US04) -
DATACLAS(DCEXT) -
LINEAR CYL(6000 2000) SHAREOPTIONS(2))
//STEP2 EXEC PGM=IOEAGFMT,REGION=0M,
// PARM=('-aggregate ZWS.DWCFP4.ZFS -compat')
//SYSPRINT DD SYSOUT=*
//STDOUT DD SYSOUT=*
//STDERR DD SYSOUT=*
//SYSUDUMP DD SYSOUT=*
//CEEDUMP DD SYSOUT=*
//SYSPRINT DD SYSOUT=*
//SYSIN DD *
DEFINE CLUSTER (NAME(ZWS.DWCFP4.ZFS) -
VOLUMES(I#US04) -
DATACLAS(DCEXT) -
LINEAR CYL(6000 2000) SHAREOPTIONS(2))
//STEP2 EXEC PGM=IOEAGFMT,REGION=0M,
// PARM=('-aggregate ZWS.DWCFP4.ZFS -compat')
//SYSPRINT DD SYSOUT=*
//STDOUT DD SYSOUT=*
//STDERR DD SYSOUT=*
//SYSUDUMP DD SYSOUT=*
//CEEDUMP DD SYSOUT=*
Note: DATACLAS(DCEXT) is one to allow VSAM extended datasets (DSNTYPE=LARGE)
(B) Create directories with MKDIR as needed, so that you can mount the two ZFS files
(C) Do the MOUNTS: (with MOUNT command from ISPF, or BPXPRMxx parmlib member)
(C) Do the MOUNTS: (with MOUNT command from ISPF, or BPXPRMxx parmlib member)
MOUNT FILESYSTEM('ZWS.DWC.ZFS')
TYPE(ZFS)
MODE(RDWR)
PARM('AGGRGROW')
MOUNTPOINT('/var/ZWS950/DWCPAX')
UNMOUNT
MOUNT FILESYSTEM('ZWS.DWCFP4.ZFS')
TYPE(ZFS)
MODE(RDWR)
PARM('AGGRGROW')
MOUNTPOINT('/var/ZWS950/DWC95FP4')
UNMOUNT
TYPE(ZFS)
MODE(RDWR)
PARM('AGGRGROW')
MOUNTPOINT('/var/ZWS950/DWCPAX')
UNMOUNT
MOUNT FILESYSTEM('ZWS.DWCFP4.ZFS')
TYPE(ZFS)
MODE(RDWR)
PARM('AGGRGROW')
MOUNTPOINT('/var/ZWS950/DWC95FP4')
UNMOUNT
(D) Follow this installation procedure:
The pax file is now available on the FIX CENTRAL download site:
https://www.ibm.com/support/fixcentral/
https://www.ibm.com/support/fixcentral/
In the box:
Search all IBM for Fix Metadata
Search all IBM for Fix Metadata
Put this name:
9.5.0-IBM-DWC-Zsystem-FP0004.pax
(Release date should be 2021/09/11)
9.5.0-IBM-DWC-Zsystem-FP0004.pax
(Release date should be 2021/09/11)
And you should be able to download the file using DOWNLOAD DIRECTORY or BROWSER (HTTPS) or FTP.
The file is about 1.02 GB in size.
Once you have the pax file you can follow these steps to install it:
Steps:
1. Upload (FTP) the file 9.5.0-IBM-DWC-Zsystem-FP0004.pax into LPAR where DWC will be installed
(the directory /var/ZWS950/DWCPAX in the example above, as file DWC-Zsystem-FP0004.pax)
2. Run these commands to "unpax" the file:
cd /var/ZWS950/DWCPAX
pax -rf DWC-Zsystem-FP0004.pax
cd /var/ZWS950/DWCPAX
pax -rf DWC-Zsystem-FP0004.pax
NOTE: At this point if you want to use a database other than the default DERBY,
you have to run the configureDb before the dwcinst script. If you want to use DB2,
APAR IJ31250 needs to be followed: CHANGES AND CLARIFICATION NEEDED FOR
CONFIGUREDBDB2Z.TEMPLATE TO COMPLY WITH DB2 FOR Z/OS -
In configureDbDb2z.template there are two parameter values
IWS_TSNAME and IWS_TS_PATH which have the default value of
TWS_DATA however DB2 on z/OS does not allow the underscore
character in a tablespace name. This was bypassed by using
TWSDATA instead of TWS_DATA for the value.
you have to run the configureDb before the dwcinst script. If you want to use DB2,
APAR IJ31250 needs to be followed: CHANGES AND CLARIFICATION NEEDED FOR
CONFIGUREDBDB2Z.TEMPLATE TO COMPLY WITH DB2 FOR Z/OS -
In configureDbDb2z.template there are two parameter values
IWS_TSNAME and IWS_TS_PATH which have the default value of
TWS_DATA however DB2 on z/OS does not allow the underscore
character in a tablespace name. This was bypassed by using
TWSDATA instead of TWS_DATA for the value.
3. Ensure that the MAXASSIZE parameter is correctly set (suggested value is 2147483647), otherwise run the command: altuser user_name omvs(assizemax(2147483647))
4. Ensure that the CPUTIMEMAX parameter is correctly set (suggested value is 915827882), otherwise run the command: altuser user_name omvs(cputimemax(915827882))
5. From ISPF command shell put the OMVS command to set the JAVA Environment variable:
PATH=/bin:/JAVA_INSTDIR/J8.0_64/bin
export PATH
JAVA_HOME:/JAVA_INSTDIR /J8.0_64
Export JAVA_HOME
export PATH
JAVA_HOME:/JAVA_INSTDIR /J8.0_64
Export JAVA_HOME
6. Point to the directory where the image was unpacked: cd /var/ZWS950/DWCPAX
7. Run the installation command like in the below example and ensure that the path used as inst_dir is different from the one used to unpack the image in step 2 above:
dwcinst.sh --acceptlicense yes --user dwcadmin --password dwcadmin --inst_dir /var/ZWS950/DWC95FP4 --wlpdir liberty_inst_dir
Note: As an alternative it is possible to copy the template dwcinst.properties file stored in the package, modify it and run the installation
using this command from /var/ZWS950/DWC95FP4 :
using this command from /var/ZWS950/DWC95FP4 :
./dwcinst.sh -f dwcinst.properties
Tips:
Use /var/ZWS950/DWC95FP4 as folder where DWC-Zsystem-FP0004.pax is unpacked
Use /var/ZWS950/DWC95FP4 as the folder that contains the dwcinst.properties file (copied from dwcinst.template) and then modified as needed
Use /var/ZWS950/DWC95FP4 as inst_dir
Use /var/ZWS950/DWC95FP4 as the folder that contains the dwcinst.properties file (copied from dwcinst.template) and then modified as needed
Use /var/ZWS950/DWC95FP4 as inst_dir
Note: It is ALSO possible to run the dwcinst script via a batch job instead of from TSO OMVS. For example:
//*--------------------------------------------------
//* create DWC Console
//*--------------------------------------------------
//DEFDWC EXEC PGM=BPXBATCH
//STDENV DD DATA,DLM=$$
JAVA_HOME=/apc/java800/64bit/usr/lpp/java/J8.0_64
$$
//STDPARM DD DATA,DLM=$$
sh /var/ZWS950/DWCPAX/dwcinst.sh
-f /var/ZWS950/DWCPAX/dwcinst.properties
$$
//SYSTSIN DD DUMMY
//SYSTSPRT DD SYSOUT=*
//STDOUT DD SYSOUT=*
//STDERR DD SYSOUT=*
//* create DWC Console
//*--------------------------------------------------
//DEFDWC EXEC PGM=BPXBATCH
//STDENV DD DATA,DLM=$$
JAVA_HOME=/apc/java800/64bit/usr/lpp/java/J8.0_64
$$
//STDPARM DD DATA,DLM=$$
sh /var/ZWS950/DWCPAX/dwcinst.sh
-f /var/ZWS950/DWCPAX/dwcinst.properties
$$
//SYSTSIN DD DUMMY
//SYSTSPRT DD SYSOUT=*
//STDOUT DD SYSOUT=*
//STDERR DD SYSOUT=*
8. Check the installation log under the dir: /var/ZWS950/DWC95FP4/DWC_DATA_dir/installation/logs to be sure that DWC is correctly installed
(Start the DWC if not already running - angel process (ex. BBGZANGL) then server (ex. BBGZSRV) -- see sample JCL in Additional Information section below)
9. Open the DWC by a common browser at the link: https://lpar_hostname_of_the_dwc:9443/console/login.jsp
Additional Information
SAMPLE JCL for running the DWC as a STARTED TASK: (start BBGZANGL first, then BBGZSRV)
//BBGZANGL PROC PARMS='',COLD=N,NAME='',SAFLOG=N
//*------------------------------------------------------------------
// SET ROOT='/usr/lpp/liberty_zos/21.0.0.3'
//*------------------------------------------------------------------
//* Start the Liberty angel process
//*------------------------------------------------------------------
//* This proc may be overwritten by fixpacks or iFixes.
//* You must copy to another location before customizing.
//*------------------------------------------------------------------
//STEP1 EXEC PGM=BPXBATA2,REGION=0M,TIME=NOLIMIT,
// PARM='PGM &ROOT./lib/native/zos/s390x/bbgzangl COLD=&COLD NAME=X
// &NAME &PARMS SAFLOG=&SAFLOG'
//STDOUT DD SYSOUT=*
//STDERR DD SYSOUT=*
//*------------------------------------------------------------------
// SET ROOT='/usr/lpp/liberty_zos/21.0.0.3'
//*------------------------------------------------------------------
//* Start the Liberty angel process
//*------------------------------------------------------------------
//* This proc may be overwritten by fixpacks or iFixes.
//* You must copy to another location before customizing.
//*------------------------------------------------------------------
//STEP1 EXEC PGM=BPXBATA2,REGION=0M,TIME=NOLIMIT,
// PARM='PGM &ROOT./lib/native/zos/s390x/bbgzangl COLD=&COLD NAME=X
// &NAME &PARMS SAFLOG=&SAFLOG'
//STDOUT DD SYSOUT=*
//STDERR DD SYSOUT=*
//BBGZSRV PROC PARMS='dwcServer'
//*------------------------------------------------------------------
//* This proc may be overwritten by fixpacks or iFixes.
//* You must copy to another location before customizing.
//*------------------------------------------------------------------
//* INSTDIR - the path to the WebSphere Liberty Profile install.
//* This path is used to find the product code and is
//* equivalent to the WLP_INSTALL_DIR environment variable
//* in the Unix shell.
//* USERDIR - the path to the WebSphere Liberty Profile user area.
//* This path is used to store shared and server specific
//* configuration information and is equivalent to the
//* WLP_USER_DIR environment variable in the Unix shell.
//*------------------------------------------------------------------
// SET INSTDIR='/usr/lpp/liberty_zos/21.0.0.3'
// SET USERDIR='/var/ZWS950/DWC95FP4/usr' /*this is for FP4*/
//*------------------------------------------------------------------
//* Start the Liberty server
//*
//* WLPUDIR - PATH DD that points to the Liberty Profile's "user"
//* directory. If the DD is not allocated, the user
//* directory location defaults to the wlp/usr directory
//* in the install tree.
//* STDOUT - Destination for stdout (System.out)
//* STDERR - Destination for stderr (System.err)
//* MSGLOG - Destination for messages.log (optional)
//* STDENV - Initial Unix environment - read by the system. The
//* installation default and server specific server
//* environment files will be merged into this environment
//* before the JVM is launched.
//*------------------------------------------------------------------
//STEP1 EXEC PGM=BPXBATSL,REGION=0M,TIME=NOLIMIT,
// PARM='PGM &INSTDIR./lib/native/zos/s390x/bbgzsrv &PARMS'
//WLPUDIR DD PATH='&USERDIR.'
//STDOUT DD SYSOUT=*
//STDERR DD SYSOUT=*
Document Location
Worldwide
[{"Type":"MASTER","Line of Business":{"code":"LOB35","label":"Mainframe SW"},"Business Unit":{"code":"BU058","label":"IBM Infrastructure w\/TPS"},"Product":{"code":"SSG4CQ","label":"IBM Tivoli WorkLoad Scheduler for z\/OS"},"ARM Category":[{"code":"a8m0z0000001fyAAAQ","label":"ZOS->IZWS->INSTALLATION"}],"ARM Case Number":"TS007688351","Platform":[{"code":"PF025","label":"Platform Independent"}],"Version":"All Versions"}]
Was this topic helpful?
Document Information
Modified date:
13 December 2021
UID
ibm16525876