IBM Support

FSR Features and Upgrades - 5.2

General Page

This page describes the changes to the toolkit and how to upgrade.
Please contact support to access the upgrade files. A valid maintenance agreement is required.
  • Features added in 5.2

    PowerHA Tools for IBM i 5.2 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:

    • 58120: Support for FlashSystem Policy-based Replication

    • 54908: Changes to support IBM i 7.5

    • 56361: New command: WRKCLDVOL

    • 52509: SETUPFSR changes to control configuration migrations

    • 46823: Support for iSCSI devices

    • 55079: New command: STRCLDPVM

    • 47287: CHKCSE checks if STRTCP is *YES

    The following features were added (or fixed) in the February 5th, 2023 build (20240205):

    • 698538: Flashcopy doesn't remove userspace, preventing CFGSTRPRSC from running clean on source

    • 685204: STR/CHKFSFLASH run on source should not try to release PowerHA licenses

    • 678246: Add data exposure time parm to RTVCSMSSNS command

    • 6788196: VGFC and SGC creating snapshots in wrong pool

    • 678069: WRKCSE *SELECT for Volume fails when policy name contains a space

    • 680745: Remove VGFC flash from PPRC target parameters

    • 680745: Change Target Volume Pool to Target Snapshots Pool

    • 684731: Print Java stack traces in select catch blocks

    • 678195: CG FC mappings increment mix was only checked if the CG was running

    • 666765: SVC Storage protection was counting backwards

    • 666518: More log messages related to VGFC and PBR.

    • 625627: Add more log files to DMPINF

    • 461964: PowerVS API URL errors in SYD

    • 503146: Improve Java JSON parsing messages

    • 46853: Backup IDs on WRKSGCCPY need to be sorted

    • 448932: Some 4.6 CSEDTA's weren't readable by 5.2

    • 451494: Cal't call registered exit progrmas with program data

    • 368771: CHKFSFLASH with bad RCCG results in MCH6902

    • 234836: STRFSFLASH on source received CPF9E11

    • 369619: STRSGCPY invalid check for inactive PPRC

    • 368442: FSFC SVC WRKCSE opt 12 opt 17 doesn't show correct ID or allow changing copy rates

    • 234795: WRKCSE opt 12 DS8K FC F8 wasn't working

    • 234590: STRSGCPY should issue escape message if it fails

    • 193104: VGFC SGC recovery pool ID defaults to 16448 (and it shouldn't)

    • 185585: Remote VGFC wasn't monitoring PCYGM

    • 184477: WRKCSE opt 1 needs to check input parameter for storage type

    • 66009: Validation of VGFC CSE when CSE has no hosts defined should fail

    • 61091: SGC groups issues IAS2026 when it shouldn't

  • Upgrading to 5.2 from a prior release

    Upgrading to 5.2 is only recommended from version 4.6 or 5.1 - 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. 5.2). 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.6 or 5.1, which facilitates upgrading source LPARs in stages.


    To update the controllers:

    1. Upgrade the controllers to 4.6
    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/ddd46backups'
      QZRDHASM/SAVDDD PATH('/tmp/ddd46backups')
    6. On each controller, issue the restore command:
      
      RSTLIB SAVLIB(QZRDHASM) DEV(*SAVF) SAVF(QGPL/QZRDHASM52) MBROPT(*ALL) ALWOBJDIF(*ALL) OMITOBJ((QZRDHASM/*ALL *DTAQ))
    7. Update to the most recent Secure Java jar file (not required for PowerVS):
      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 each controlling partition issue the setup command:
      
      SETUPFSR NODEROLE(*CTL) MIGRATE(*YES)

    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/QZRDHASM52) MBROPT(*ALL) ALWOBJDIF(*ALL) OMITOBJ((QZRDHASM/*ALL *DTAQ))
    3. On each production LPAR issue the setup command:
      
      SETUPFSR NODEROLE(*PRD)
    4. After these steps have been performed, check that the entries in WRKSTRPRSC, particularly the port numbers associated with communication resources, migrated correctly and perform a CHKCSE and a detach prior to the next switch to test the configuration.
  • Updating 5.2 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/QZRDHASM52) MBROPT(*ALL) ALWOBJDIF(*ALL) 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":"a8m0z0000000CGgAAM","label":"High Availability"}],"ARM Case Number":"","Platform":[{"code":"PF012","label":"IBM i"}],"Version":"All Versions"}]

Document Information

Modified date:
07 February 2024

UID

ibm17062494