Upgrading to 4.6 is only recommended from version 4.5 - upgrading from any other release will require manually re-creating all WRKCSE, WRKCSEDTA and WRKCSECRDL entries. Use the following command to display the version and build date:
DSPDTAARA DTAARA(QZRDHASM/BUILD)
All the controllers and source LPARs in a cluster must be at the same version (i.e. 4.6). We strongly recommend that they also all be at the same build date. The version and build date is stored in data area QZRDHASM/BUILD.
The 4.6 controllers will support non-cluster source LPARs running at 4.5 or 4.6, which facilitates upgrading source LPARs in stages.
As of 4.5 DS8K volume groups are no longer supported on WRKCSE opt 16 panels. These have been changed to hostnames and volume mappings and the configurations on the DS8K will also need to change. Use WRKCSE opt 16 to record your existing volume groups before the migration, then use WRKCSE opt 16 after the migration to enter the new host mappings.
For DS8K copy services environments which specify "Full Flash" and "Resynch Flash" then the existing FlashCopy must be removed before the next STRFSFLASH. To remove the FlashCopy, ensure the target LPAR is not using the target LUNs and run the rmflash script from WRKCSE opt 14.
To update the controllers:
- Upgrade the controllers to 4.5
- Ensure no STRFSFLASH or STRFLASH or SWCSE commands are in process.
End the toolkit subsystem:
ENDSBS QZRDFSR *IMMED
Generate a text file with all of the WRKCSE / WRKCSEDTA information:
QZRDHASM/DMPINF ENV(*ALL) EXTDLOGS(*NO)
Save the DDD information:
MKDIR '/tmp/ddd45backups'
QZRDHASM/SAVDDD PATH('/tmp/ddd45backups')
On each controller, issue the restore command:
RSTLIB SAVLIB(QZRDHASM) DEV(*SAVF) SAVF(QGPL/QZRDHASM46) MBROPT(*ALL) ALWOBJDIF(*COMPATIBLE) OMITOBJ((QZRDHASM/*ALL *DTAQ))
Update to the most recent Secure Java JAR file.
Download it from here: https://sourceforge.net/projects/jsch/files/jsch.jar/0.1.55/jsch-0.1.55.jar/download
Place it on all controllers in /QIBM/Qzrdhasm/ssh/
Then update the links:
RMVLNK OBJLNK('/QIBM/Qzrdhasm/ssh/jsch.jar')
ADDLNK NEWLNK('/QIBM/Qzrdhasm/ssh/jsch.jar') OBJ('/QIBM/Qzrdhasm/ssh/jsch-0.1.55.jar')
On one controlling partition, migrate the existing DDD to the new format:
CALL QZRDHASM/QZRDIAMIGW
On each controlling partition issue the setup command:
SETUPFSFC NODEROLE(*CTL)
To update a source LPAR:
End the toolkit subsystem:
ENDSBS QZRDFSR *IMMED
On each source LPAR, issue the restore command:
RSTLIB SAVLIB(QZRDHASM) DEV(*SAVF) SAVF(QGPL/QZRDHASM46) MBROPT(*ALL) ALWOBJDIF(*COMPATIBLE) OMITOBJ((QZRDHASM/*ALL *DTAQ))
On each source partition issue the setup command:
SETUPFSFC NODEROLE(*SRC)
- After these steps have been performed, it is recommended that CHKFSFLASH be performed before the next planned flashcopy to test the configuration.
While it is not necessary to make any changes beyond those listed above, the following are optional steps to use some of the new features in version 4.6:
- If using multiple controllers and STRFSFLASH from the source LPAR, use WRKSTRPRSC on the source LPAR to define the controllers and call STRFSFLASH with parameter CTLR(*AUTO) so that STRFSFLASH can use either available controller.
- On the controllers use SAVDDD with your backup strategy to capture the toolkit DDD.
- If LPM is involved, update the CSEDTA to specify HMC Managed System *SEARCH instead of multiple CSEDTA's.
- Use the Hyperswap support to avoid multiple CSEDTA's.
- Use BRMS Custom timestamps if the BRMS Advanced Feature is installed and licensed.
- Change the BRMS control groups use the Backup item exit program QZBRMSEXIT instead of ENDFSFLASH in the last *EXIT, so you can get notifications of abnormal control group end and backup progress in restricted state.