FSFC Features and Upgrades - 5.3

Contact support to access the upgrade files. A valid maintenance agreement is required.

• Features added in 5.3

   

  PowerHA Tools for IBM i 5.3 is now available for all customers current on maintenance. It has all the features and fixes from prior releases, and adds the following:

  • 754639: LPAR profile *current must accept any combination of case
  • 733633: WRKCSE SGC needs to display the retention period parameter
  • 745401: BRMS BR2 and 7.4 needs to use different BUEPALL call
  • 752488: Update missing formats in QCLCINCSRC/QZRESTDEF.CLLE
  • 746494: CSEDTA API's need to set the current version information
  • 754041: WRKCSE opt 12 on GMIR then pause (opt 2) needs to wait for gmir to pause
  • 752549: PowerVS FSFC detach doesn't run if boot volume is the final one in the list
  • 751802: Increase host name length to 63
  • 745159: FSR 3-site for DS8 and CSM
  • 753880: WRKSGCPY errors out if total available storage > 1GB
  • 60434: Automatically change qsysopr message delivery to *HOLD
  • 752424: Reduce the errors coming from saveJobLog
  • 748522: Do not save user queues in QUSRBRM (FSFC)
  • 746493: CHKCSE and SWCSE should create msgq QZRDFSR on the source
  • 750969: WRKSTRPRSC *RTE: Add duplicate route priority
  • 750968: WRKSTRPRSC *CMN: Add field to indicate whether to set as BRMS restricted interface
  • 751724: Propogate QZ_DS_CG_WAIT from 4.6
  • 751630: PowerVS REST API calls should log request and correlation id
  • 751551: Displaying SGC dates needs to account for DST
  • 751137: Data over write issue in qzrdiadm using doanyscipt from qzrdiastmf
  • 748360: Add 102 as a universal license key
  • 748115: DS8K DLTMAP is too slow, use DSCLI instead
  • 748286: For SVC, under WRKCSE Opt 16...unable to select a host
  • 748356: Add fsfc userTag to PowerVS clones
  • 748276: Need to check task state of VSI before activating
  • 748239: FSR MMIR status was incorrectly showing 'unknown'
  • 747888: FSFC Ragged Commit needs to turn off no commit boundary after the flashcopy
  • 748139: Add additional delays when getting "too many requests" from SVC using REST
  • 748098: Source lock for uploading logs needs to time out sooner
  • 747512: Logging Enhancements
  • 746041: WRKCLDVOL should allow onboarding volumes in a volume group
  • 746272: FSR Detach: When idle and normal no details displayed

   

• Upgrading to 5.3 from a prior release

  Upgrading to 5.3 is only recommended from version 5.2 - 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. 5.3). 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 5.3 controllers will support non-cluster source LPARs running at 5.2 or 5.3, which facilitates upgrading source LPARs in stages.

  Firewall changes may be necessary between the controllers and FlashSystem / Storwize units. In version 5.3 of the toolkit, communications with Storwize / FlashSystem units uses REST API's which use port 7443. Communications with the HMC uses REST API's on port 12443.

  Use WRKCSE opt 2 to update any FSFC environments using FlashCopy from FlashSystem MMIR targets. Add the source device IP and consistency group. This will enable the toolkit to pause replication before a FlashCopy to prevent torn pages.

   

  
  To upgrade the controllers:

  1. Ensure the controllers are at 5.2 before proceeding.
  2. Ensure no STRFSFLASH or STRFLASH or 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/ddd52backups'
     QZRDHASM/SAVDDD PATH('/tmp/ddd52backups')
     

  6. On each controller, issue the restore command:

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

  7. SSH is no longer used in version 5.3. The jsch jar files can be removed:

     RMVLNK OBJLNK('/QIBM/Qzrdhasm/ssh/jsch.jar')
     RMV OBJLNK('/QIBM/Qzrdhasm/ssh/jsch-0.1.55.jar')
     

  8. On each controlling partition issue the setup command:

     QZRDHASM/SETUPFSFC NODEROLE(*CTL) MIGRATE(*YES)
     

   

  To upgrade a source LPAR:

  1. End the toolkit subsystem: 

     ENDSBS QZRDFSR *IMMED
     

  2. On each source partition, issue the restore command:

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

  3. On each source partition issue the setup command:

     QZRDHASM/SETUPFSFC NODEROLE(*SRC)
     

  4. On each source partition add CFGSTRPRSC to the beginning of the startup program (the intent is to skip the rest of the startup program if the node role is not a *PSxx, *PTxx, or *Hx usage):

     DCL VAR(&IPLTYPE) TYPE(*CHAR) LEN(5) VALUE('?????')
     /* PowerHA Tools for IBM i */
     QZRDHASM/CFGSTRPRSC RTNVAR(&IPLTYPE)
     MONMSG     MSGID(CPF0000)
     IF COND(%SST(&IPLTYPE 1 2) *NE '*P' *AND +
             %SST(&IPLTYPE 1 2) *NE '*H') +    
        THEN(RETURN)                           
     STRTCP
     MONMSG     MSGID(CPF0000)
     

  5. Issue the commands to ensure the Activation Engine / Cloud-init is properly disabled (skip if also using DRA / VMRM):

     CALL PGM(QSYS/QAENGCHG) PARM(*DISABLE)
     CALL PGM(QSYS/QAENGCHG) PARM('WAITTIME=0')

  6. Remove any calls to RUNLPARCMD QZRDENDSBS.
  7. On each source partition add a *PS entry to WRKSTRPRSC (only the 'System Information' panel)
  8. An *FC entry in WRKSTRPRSC is no longer required.
  9. After these steps have been performed, it is recommended that CHKFSFLASH be performed before the next planned flashcopy to test the configuration.

• Updating 5.3 to a newer build date

   

  1. Note the change to handling the return of CFGSTRPRSC - the intent is to skip the rest of the startup program if the node role is not *PSxx, *PTxx, or *Hx: 

     DCL VAR(&IPLTYPE) TYPE(*CHAR) LEN(5) VALUE('?????')
     /* PowerHA Tools for IBM i */
     QZRDHASM/CFGSTRPRSC RTNVAR(&IPLTYPE)
     MONMSG     MSGID(CPF0000)
     IF COND(%SST(&IPLTYPE 1 2) *NE '*P' *AND +
             %SST(&IPLTYPE 1 2) *NE '*H') +    
        THEN(RETURN)                           
     STRTCP
     MONMSG     MSGID(CPF0000)
     

  2. An *FC entry in WRKSTRPRSC is no longer required.
  3. A *PS entry in WRKSTRPRSC is required.
  4. Ensure no STRFSFLASH or STRFLASH or SWCSE commands are in process on the LPAR being upgraded.

  5. End the toolkit subsystem: 

     ENDSBS QZRDFSR *IMMED
     

  6. Issue the restore command:

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

  7. Issue the appropriate setup command:

     QZRDHASM/SETUPFSFC NODEROLE(*CTL)
     QZRDHASM/SETUPFSFC NODEROLE(*SRC)

  8. On each source LPAR, issue the commands to ensure the Activation Engine / Cloud-init is properly disabled:

     CALL PGM(QSYS/QAENGCHG) PARM(*DISABLE)
     CALL PGM(QSYS/QAENGCHG) PARM('WAITTIME=0')

  After these steps have been performed, it is recommended that CHKFSFLASH be performed before the next planned flashcopy to test the configuration.