Smart Assist for PowerHA on IBM i

Smart Assist for PowerHA® on IBM i

Smart Assist for PowerHA® on IBM i is a set of tools created by Technology Expert Labs (formerly Lab Services)  Power Systems Delivery Practice, based on feedback and need by numerous customer engagements.  These tools have been created and modified over many years.  Many of these tools were created in response to customers' automation requirements and the Technology Expert Labs Team continues to enhance existing tools and add more on a regular basis.

Version Information:  Smart Assist 7.1 is used for IBM i O/S V7R1; Smart Assist 7.2 is used for IBM i O/S V7R2; Smart Assist 7.3 is used for IBM i O/S V7R3 and V7R4

*NOTE - Starting in V7R4, with enhancements in the PowerHA® product, some utilities of Smart Assist are no longer being developed and are considered not supported.  Some of the PowerHA® Cluster Management functions (SETFACT and RTVFACT) and Admin Domain Management will no longer be leveraged by Smart Assist.  These can now be managed by using PowerHA Policies.

Use the following document for PowerHA Tools Smart Assist Admin Domain Cleanup For R740 And Above

These tools are useful for many implementations of PowerHA-based solutions:

• IBM i Independent ASP (IASP) migration and management
• PowerHA®-managed Geographic Mirroring
• PowerHA®-managed DS8K-based or SVC/Storwize-based replication, flashcopy and LUN-level switching
• ICSM-managed implementations

Smart Assist can provide the following benefits:

• Additional functionality during the set-up and installation phase of the environment
• Programming interfaces to assist in monitoring the environment
• Command utilities to assist in daily administration of the environment

This wiki is divided into the following sections to help find information more easily:

• Installation Instructions
  Run the following steps for ALL partitions using Smart Assist

  1. Create a temporary save file on the IBM i partition -- e.g. CRTSAVF FILE(QGPL/SMART72)   (Note:  Name of the savefile doesn't matter.  In this case, "72" is a reference to version 7.2 or 7.3)
  2. Move or upload (FTP or other method) the save file provided by Lab Services to that save file and library on the IBM i
  3. Restore library QZRDPWRHA from the save file -- e.g. RSTLIB SAVLIB(QZRDPWRHA) DEV(*SAVF) SAVF(QGPL/SMART72)
  4. Add the product access code provided by Lab Services, using QZRDPWRHA/ADDPRDACS (product code 64)
  5. Run the setup, using QZRDPWRHA/SETUPSA

  Note:  Older versions of SmartAssist used QZRDPWRHA/RUNSETUP for the setup.  RUNSETUP still provides some functions, but not all, and can give an expected error if RUNSETUP from library QZRDHASM was run for IASP Manager (formerly ACS Toolkit / ICSM) already.

  Upgrading Smart Assist

  Run the following steps for ALL partitions using Smart Assist

  1. Create a temporary save file (or clear existing save file) on the IBM i partition -- e.g. CRTSAVF FILE(QGPL/SMART72)   (As noted above, savefile name can be anything.  This is an example.)
  2. Move or upload (FTP or other method) the save file provided by Lab Services to that save file and library on the IBM i
  3. Restore library QZRDPWRHA from the save file -- e.g. RSTLIB SAVLIB(QZRDPWRHA) DEV(*SAVF) SAVF(QGPL/SMART72) MBROPT(*ALL) ALWOBJDIF(*ALL)
  4. Add the product access code provided by Lab Services, using QZRDPWRHA/ADDPRDACS (product code 64), if running on a new serial number, or the existing access code has expired.
  5. Run the setup, using QZRDPWRHA/SETUPSA

  Note:  Older versions of SmartAssist used QZRDPWRHA/RUNSETUP for the setup.  RUNSETUP still provides some functions, but not all, and can give an expected error if RUNSETUP from library QZRDHASM was run for IASP Manager (formerly ACS Toolkit / ICSM) already.

• What's New in Smart Assist for PowerHA® on IBM i

  2015 Enhancements to Smart Assist for PowerHA® on IBM i

  In 2015, the following changes were made to Smart Assist:

  • RUNSETUP was replaced with SETUPSA for setting up Smart Assist. This will create data area PWRHADTA, a requirement for some current programs to work properly.
  • WRKMREMIS command to check/add certain MRE's (other than user profiles) to the Admin Domain
  • CRTPRFCLU was replaced by CRTPRFDIRE exit programs
  • RTVCMDEXIT and REGPWRCMD programs to provide automated addition of certain MRE's (other than user profiles) to the Admin Domain
  • PRTMREOBJ to direct the output of WRKUSRMIS and WRKMREMIS to a spooled file or outfile
  • The latest version of Smart Assist (after June 2014 build) will only run on V7R1 or higher

  2014 Enhancements to Smart Assist for PowerHA® on IBM i

  In early 2014, a rebranding took place for the PowerHA-related offerings by Lab Services.  The set of tools formerly named "PowerHA® Tools" was rebranded to the new name of Smart Assist for PowerHA® on IBM i.  Meanwhile, the "PowerHA® Tools" name became the umbrella term for all of the Lab-based services and offerings related to PowerHA® on IBM i.

  For the Smart Assist set of tools the following changes were made:

  • Enhancements to the CHKENVRCY command
  • Enhancements to the WRKUSRMIS interface
  • Enhancements to the previously-used statistical tools for global mirror on DS8K, now in STRGMIRSTS and ENDGMIRSTS
  • Addition of the CHKSSN command
  • Addition of the RUNSVCCMD command
  • Addition of the ANZSVCDTA command

• PowerHA® Cluster Management

  The commands and programs in this section are designed to aid in the management of PowerHA® clustering environment.

  Use the links for each item for more details.

  STRALLNOD - Start all cluster nodes

  SETFACT - Set Failover Actions

  RTVFACT - Retrieve Failover Actions

  RTVCLUNAME - Retrieve Cluster Name (API only)

  RTVCLUSTS - Retrieve Cluster Status (API only)

  RTVCRGSTS - Retrieve CRG Status (API only)

  RTVRCYDMN - Retrieve Recovery Domain (API only)

• IASP Management

  The commands and programs in this section are specific to independent auxiliary storage pool (IASP) environments, and provide additional assistance in managing and migrating to an IASP environment.

  Use the links for each item for more details.

  CHKDUPLIBS - Check for Duplicate Libraries

  CHKENVRCY - Check Environment Recoverablility

  MOVOUTQ - Move Output Queue

  RTVASPSTG - Retrieve ASP Storage (API only)

• Admin Domain Management

  The commands and programs in this section are specific to PowerHA® environments using an Administrative Domain.

  Use the links for each item for more details.

  REGPWRCMD - Program to automate addition of job descriptions, subsystem descriptions, authorization lists and classes to admin domain

  CHKUSRPRF - Check User Profiles

  ADDCADUSR - Add Cluster Admin Domain Users

  CRTPRFEXIT - Exit program used with adding new profiles to admin domain

  CRTPRFDIRE - Exit program used with adding new profiles to admin domain AND adding profile to system distribution directory

  CRTPRFCLU - Exit program used with creating profiles cluster-wide (Removed with March 2015 V7Rx builds)

  USRPRF CRG - Used for management of creating/deleting users cluster-wide

  PRFDLTEXIT - Exit program used with deleting profiles cluster-wide

  DLTPRFCLU - Delete Profiles Cluster-wide

  DLTPRFDIRE - Delete Directory Entries cluster-wide upon profile deletion

  WRKPRFCLU - Work with Profiles Cluster-wide

  WRKUSRMIS - Work with Users Missing from Admin Domain

  WRKMREMIS - Work with Objects Missing from Admin Domain

  PRTMREOBJ - Print Objects NOT in Admin Domain

  CHGPROF - Change Profile

• PowerHA® Environments

  The commands and programs in this section are used for any PowerHA® environment, whether managed by PowerHA® or IASP Copy Services Manager (ICSM).

  Use the links for each item for more details.

  RUNSVCCMD - Run SVC CLI Command

  CHKSSN - Check Session

  RTVCPYSSN - Retrieve Copy Session (API only)

• SVC-Based Management

  The commands in this section are used for environments using SVC-based (SVC-attached, Storwize, Spectrum Virtualize) external storage.

  RUNSVCCMD - Run SVC CLI Command

  ANZSVCDTA - Analyze RUNSVCCMD Data

• IASP Manager Environments

  The commands and programs in this section are specific to environments being managed by IASP Manager -- formerly Advanced Copy Services (ACS) or IASP Copy Services Manager (ICSM).

  CRTCLUUSRQ - Create IASP Manager User Queue

  TRGCRGEXIT - Trigger CRG Exit Program

  RLSDR - Release I/O Adapters on GMIR Target (DR) Node

  RESETDR - Reset I/O Adapters on GMIR Target (DR) Node

  STRGMIRSTS - Start Gathering GMIR Statistics

  STRSTATS - Start Gathering GMIR Statistics (older version)

  ENDGMIRSTS - End Gathering GMIR Statistics

  ENDSTATS - End Gathering GMIR Statistics (older version)

  LOGMSG - Log Message to IASP Manager Log File

  QZRDSECURE - Exit program used to manage authority of IASP Manager environment menu options

• Additional Smart Assist Commands

  The following are additional SmartAssist commands that don't fall into any of the other categories. Use the links for more details on each one.

  ADDPRDACS - Add Product Access Code

  SETUPSA - Set Up SmartAssist for PowerHA® on IBM i

  RUNSETUP - Run Set Up (replaced with March 2015 V7R1+ builds)

  CHKPHADTA - Check for SmartAssist Data

  RMVPHADTA - Remove SmartAssist Data

• Smart Assist Sample Programs

  This section contains sample programs designed to be a starting point to assist with PowerHA® environments.  They are provided as-is and should be modified to specific customer needs.

  PWRDWNEXIT - Power Down System Exit Program

  STRPWRHA71 - Start Up Program for PowerHA® Environments

  VRYOFFPRE - IASP Vary Off Pre-Processing Exit Program

  VRYOFFPOST - IASP Vary Off Post-Processing Exit Program

  VRYONPRE - IASP Vary On Pre-Processing Exit Program

  VRYONPOST - IASP Vary On Post-Processing Exit Program

  While this page may be replaced by a new page and URL in the future, http://ibm.biz/SmartAssist should redirect to the current correct URL.

  To receive notifications when this page is updated, use the Cross Reference details below with 'My Notifications' at https://ibm.com/mysupport.