IBM Support

FSR Features and Upgrades - 5.1

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.1

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

    • 53011: Support for GRS in PowerVS

    • 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

  • Upgrading to 5.1 from a prior release

    Upgrading to 5.1 is only recommended from version 4.6 - 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.1). 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/QZRDHASM51) 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/QZRDHASM51) 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.1 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/QZRDHASM51) 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:
20 January 2023

UID

ibm16856167