FSR Features and Upgrades - 4.6

PowerHA Tools for IBM i 4.6 is now available for all customers with a current maintenance contract. It has all the features and fixes from prior releases and adds the following:

• 43431: WRKCSEDTA filtering and position-to field

• 43359: WRKCSEDTA option 15 = Auto-refresh log view

• 42386: LUN Switch for Storwize

• 38933: WRKCSECRDL option 6 to Validate

• 36809: Check that QLPAR on the is neither disabled nor expired

• 45101: Added CHKFSRFLSH and STRFSRFLSH

• 35844: SAVDDD has a new parameter *GEN which creates a new directory based on a timestamp and both SAVV and RSTDDD have more log messages

• 25007: SETUPFSR includes access code parameters

• 47326: WRKCSEDTA F7 = work with subsystem QZRDFSR

• 48288: Support for BRMS restricted state IP addresses in PVI and FSR

• 48798: CFGSTRPRSC will continue processing despite non-critical failures

• 48800: CFGSTRPRSC will not re-save job scheduler entries if they're all held

• 48337: WRKSTRPRSC *CMN has one port per location code and will auto-detect ports

• 40005: WRKSTRPRSC supports *SGxx entries

The following features were added (or fixed) in the April 8th, 2022 build:

• 51928: CHKCSE failed to validate CSM-managed DS8K environments.

The following features were added (or fixed) in the August 1st, 2023 build:

• 61546: RTVINF was leaving the java tunnel open.

• 61412: Suspend/Resume of FSR CSM sessions was missing.

• 61146: Minor enhancement to TSTCOMM.

• 60483: QZIAWCHJD *JOBD was not owned by QPGMR.

• 60929: 7.5 compatibility updates.

• 60195: QZRDRTVCDT (API) access code updates (85,88,89).

• 59998: CLEANLOGS parameter RETAIN is now required.

• 59913: DMPINF shows both CSM server IPs.

• 59949: CSM initial timeout increased to 150 seconds.

• 59896: Fixed null pointer exception when CSM server unable to connect and *DEBUGCSM was *ON.

• 59807: Sort volumes when creating volume fingerprint.

• 59665: *SEARCH managed system CSEDTA value was not used for LPAR IPLs.

• 59336: Addressed viewlog errors com.ibm.ctc.rest.RESTJsonParseException.

• 59351: New command: RTVSTRPRSC.

• 59354: Log URL parms for Java code.

• 59345: Clean up isProductInstalled log entries.

• 59309: QZRDWRTCDT accepts comm LOCCOD shortcut *LPAR-.

• 59326: Disallow Expire and Terminate in RUNCSMCMD.

• 59327: Change default CSEDTA wait time from 60 to 20 seconds.

• 59093: Expand command parm to 30 characters in RUNCSMCMD.

• 58992: Importing SVC volumes for host mapppings failed to save volume IDs.

• 57525: WRKCSEDTA escape messages caused job to end when run from IBM i main menu.

• 58908: CHKCSE didn't accept FLASH and PPRC records with same name.

• 58715: CHKCSE failed for SVC LUN switch.

• 59680: Full system LUN switch updated to accept FSR license keys.

• 57987: CFGSTRPRSC *SGxx entries should not restore job scheduler entries.

• 56616: LUN validation improvements for SVC CHKPPRC.

• 55975: FSR volumes with LSS 0 caused FSR LUN check to fail.

• 55348: Bearer token expirations are now transparently handled.

• 55701: RSTDDD was issuing MCH3601 from QZRDSVRSEN.

• 55701: Full system GMIR D-Copy flash breaks CHKCSE and SWCSE.

• 52932: CSM client failed when password or userid is 16 characters long.

• 53588: CHKCSE failed with 'FSR Response is unrecognizable'.

• 53370: Host names in mappings failed if longer than 16 characters.

• 53157: CHKFSRFLSH failed with IAS0506 when CSM is configured.

• 53100: SWPPRC and CHKPPRC fail for SVC GMIR environments configured to use CSM.

• 55638: Use QIBM_FSFC_PING environment variable to revert DS8K REST call back to DSCLI calls.

• 53257: Fixed memory leak (MCH5003).

• 52561: Toolkits hangs if LPAR IPLs too fast.

• 52481: CFGSTRPRSC will change the IP's line description.

The following features were added (or fixed) in the February 18th, 2025 build:

• 5730893: Dynamically create DSCLI classpaths

Upgrading to 4.6 is only recommended from version 4.5 - upgrading from any other build or release will require manually recreating all WRKCSE, WRKCSEDTA and WRKCSECRDL entries. Use the following command to display the 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.

1. Upgrade the controllers to 4.5
2. Ensure no SWCSE commands are in process.
3. End the toolkit subsystem:

   
   ENDSBS QZRDFSR *IMMED

4. Generate a text file with all of the WRKCSE / WRKCSEDTA information:

   
   QZRDHASM/DMPINF ENV(*ALL) EXTDLOGS(*NO)

5. Save the DDD information:

   
   MKDIR '/tmp/ddd45backups'
   QZRDHASM/SAVDDD PATH('/tmp/ddd45backups')

6. On each controller, issue the restore command:

   
   RSTLIB SAVLIB(QZRDHASM) DEV(*SAVF) SAVF(QGPL/QZRDHASM46) MBROPT(*ALL) ALWOBJDIF(*COMPATIBLE) OMITOBJ((QZRDHASM/*ALL *DTAQ))

7. 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/jsch.jar') 
   ADDLNK NEWLNK('/QIBM/Qzrdhasm/ssh/jsch.jar') OBJ('/QIBM/Qzrdhasm/ssh/jsch-0.1.55.jar') 

8. On one controlling partition, migrate the existing DDD to the new format:

   
   CALL QZRDHASM/QZRDIAMIGW

9. On each controlling partition issue the setup command:

   
   SETUPFSR NODEROLE(*CTL)

10. Update job scheduler entries to call CLEANLOGS instead of CLNICSMLOG.