IBM Support

FSR Features and Upgrades - 4.5

General Page

Upgrade and Update details are found on this page.
Please contact support to access the upgrade files. A valid maintenance agreement is required.
  • Features added in 4.5

    PowerHA Tools for IBM i 4.5 is now available for select customers. It has all the features and fixes from 4.3 and 4.4, and adds the following:

    • CSM support for FSFC and FSR operations, including Dual Control

    • GMIR ESE D-Copy support

    • Full system LUN swap

    • New options on WRKCSEDTA (check, run, view logs files)

    • LPM support integrations

    • Migration of data from prior releases (4.3 and 4.4)

    • Prompt for HMC LPAR and profile names

    • Support for aggregate communication lines

    • CHK commands warn if log files > 20 MB

    • Replication will delayed until target LPAR finishes IPL

    • Improved FSR cleanup on failed detach

    • CHKCSE verifies remote copy consistency group replicates the correct LUNs

    • Prompting of CSEDTA shutdown command

    • Log when DDD lock management commands are used

    • CSE Panels re-organized for clarity

    • DSPCSEDTA OUTPUT(*PRINT)

    • Register and release PowerHA licenses

    • QZRDHASM savefiles compressed

    • CHGBRMSOBJ enhancements

    • Allow CHKCSE to skip LUN validation

    • Allow some full system DS8K replication without automation

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

    • 39603: HyperSwap for Sysbas not fully implemented in toolkit

    • 40000: WRKCSE LUN volume panels: Use actual node names instead of Production and HA

    • 39939: Don't start GMIR replication on hyperswap if detached

    • 39856: 6.2.9 version of CSM server breaks CsmClientManager

    • 40285: Check that disks have reported in before calling multi-path resetter

    • 40109: Add node name to sysbas LUN environment in WRKCSE

    • 41144: savddd / rstddd doesn't handle all flashes correctly

    • 40161: Add retrieve curr prod node function to RTVINF

    • 40879: Improve output from DMPIMF

    • 39531: RLSCSELCK no longer releases all LPAR locks

    • 41444: WRKCSE - license code 91 should be able to create flash environment

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

    • More environment variables documented here

    • 43951: SWCSE failed to start replication in reverse direction after switch

    • 44313: DMPINF failed to collect FSR data

    • 43149: License key 58 (MGM) added back

    • 42238: RTVINF *GMIRSTATEDIRECT returned direction in the wrong variable

    • 42765: DMPINF only recorded current date entries

    • 43072: Fixed WRKSTRPRSC *VIRTUALIP lines

    • 43185: Various fixes related to check if target LPAR is running on FlashCopy volumes (environment variable QZ_DISABLE_LUN_CHECK)

    • 42438: Incorrect message issued when no volumes to import

    • 40003: When removing routes include the binding interface

    • 44775: CHKPPRC checks whether GM flash CG exists

    The following features were added (or fixed) in the August 3rd, 2021 build:

    • 45917: SETUPFSR *PRD needs to set more qpgmr aut’s

    • 46143: Add CONFLICT parm to ALCOBJ command

    • 46129: After failed FSR Detach, next FSR Detach is not doing force write

    The following features were added (or fixed) in the December 15th, 2021 build:

    • 47246: Virtuals IPs are started consistently

    • 47482: Improvements in CSM Re-attach

    • 48256: Set LIND to CMNxx if no resource found

    • 47832: Host mappings use target DS when running at *PT

    • 48815: CFGSTRPRSC must stop looking for devices when one is found

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

    • 50089: Compatibility updates for 4.6 controllers

  • Upgrading to 4.5 from a prior release

    Upgrading to 4.5 is only recommended from the March 5th 2019 build of 4.3 (or newer) - 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.5). 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.5 controllers will support non-cluster source LPARs running at 4.3, 4.4 or 4.5, which facilitates upgrading source LPARs in stages.


    To update the controllers:

    1. Upgrade the controllers to the 3/5/2019 (or newer) build of 4.3
    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/ddd43backups'
      QZRDHASM/SAVDDD PATH('/tmp/ddd43backups')
    6. On each controller, issue the restore command:
      
      RSTLIB SAVLIB(QZRDHASM) DEV(*SAVF) SAVF(QGPL/QZRDHASM45) 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.

    To update a source LPAR:
    1. End the toolkit subsystem:
      
      ENDSBS QZRDFSR *IMMED
    2. On each controller, issue the restore command:
      
      RSTLIB SAVLIB(QZRDHASM) DEV(*SAVF) SAVF(QGPL/QZRDHASM45) MBROPT(*ALL) ALWOBJDIF(*COMPATIBLE) OMITOBJ((QZRDHASM/*ALL *DTAQ))
    3. On each production LPAR issue the setup command:
      
      SETUPFSR NODEROLE(*PRD)
    4. On each production LPAR use the following command to define the system roles:
      
      WRKSTRPRSC *SYS
    5. Update job scheduler entries to call CLEANLOGS instead of CLNICSMLOG.
    6. After these steps have been performed, it is recommended that CHKCSE and a detach be performed prior to the next switch to test the configuration.

    While it is not necessary to make any changes beyond those listed above, the following are optional steps to utilize some of the new features in version 4.5:

    • 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.
  • Updating 4.5 to a newer build date

    1. Ensure no SWCSE commands are in process on the LPAR being upgraded.
    2. End the toolkit subsystem:
      
      ENDSBS QZRDFSR *IMMED
    3. Issue the restore command:
      
      RSTLIB SAVLIB(QZRDHASM) DEV(*SAVF) SAVF(QGPL/QZRDHASM45) MBROPT(*ALL) ALWOBJDIF(*COMPATIBLE) OMITOBJ((QZRDHASM/*ALL *DTAQ))
    4. Issue the appropriate setup command:
      
      SETUPFSR NODEROLE(*CTL)
      SETUPFSR NODEROLE(*PRD)  

    After these steps have been performed, it is recommended that CHKCSE and a detach be performed prior to the next switch to test the configuration.

[{"Type":"MASTER","Line of Business":{"code":"LOB57","label":"Power"},"Business Unit":{"code":"BU058","label":"IBM Infrastructure w\/TPS"},"Product":{"code":"SWG60","label":"IBM i"},"ARM Category":[{"code":"a8m0z000000cxy9AAA","label":"High Availability-\u003EFull System Flash Copy"}],"ARM Case Number":"","Platform":[{"code":"PF012","label":"IBM i"}],"Version":"All Versions"}]

Document Information

Modified date:
18 May 2023

UID

ibm16203033