FSR Features and Upgrades - 5.3

Please 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 with a current maintenance contract. It has all the features and fixes from prior releases and adds the following:

  • 760528: Gracefully handle HTTP 400 "status executing" response on CLNEXEC during PowerVS flash copy
  • 757277: When creating FSR3 csedta's autodetect *MM or *MG
  • 757268: Change replication confirm from F10 to F22
  • 756451: Replace PCYGM, PCYHA with FS: PHA and PBR. Simplify memcmps to macros.
  • 756585: TCP8050 in trg.log
  • 756587: Unable to read QA1ASP
  • 755799: CHKPPRC when CSM is specified in CSE (CSM managed) is not recognizing Symmetrical Mirroring = N
  • 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 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.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 443.

  On the HMC, allow the toolkit user profile remote access via the web (this also allows use of the REST APIs).

   

  
  To upgrade the controllers:

  1. Upgrade the controllers to 5.2
  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/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(*ALL) 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:

     SETUPFSR NODEROLE(*CTL) MIGRATE(*YES)
     

   

  To upgrade 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/QZRDHASM53) MBROPT(*ALL) ALWOBJDIF(*ALL) OMITOBJ((QZRDHASM/*ALL *DTAQ))
     

  3. On each production LPAR issue the setup command:

     SETUPFSR NODEROLE(*PRD)
     

  4. Add a call to CFGSTRPRSC at the beginning of the startup program: 

     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)
     

     An *FC entry in WRKSTRPRSC is no longer required.

  5. Remove any calls to RUNLPARCMD QZRDENDSBS.

  6. 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')

  7. 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.3 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/QZRDHASM53) MBROPT(*ALL) ALWOBJDIF(*ALL) OMITOBJ((QZRDHASM/*ALL *DTAQ))
     

  4. Issue the appropriate setup command:

     SETUPFSR NODEROLE(*CTL)
     SETUPFSR NODEROLE(*PRD)

  5. 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)
     

  6. An *FC entry in WRKSTRPRSC is no longer required.

  7. 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 CHKCSE and a detach be performed prior to the next switch to test the configuration.