IT38926: IBM SP SNAPSHOT USES COPYSERVICES_HARDWARE_TYPE GENERIC FOR THE DEVICE ADAPTER SVC / STORWIZE DYNAMIC TARGET ALLOCATION (SVCDTA)

APAR status

• Closed as documentation error.

Error description

• When configuring IBM Spectrum Protect Snapshot with a
  DEVICE_CLASS for San Volume Controller (SVC) / StorWize
  Dynamic Target Allocation (DTA), the Snapshot wizard
  setup_orasap.sh will correctly add the required
  DEVICE_CLASS parameters to the profile when you select the
  item SVCDTA as the value for the parameter
  COPYSERVICES_HARDWARE_TYPE:
  
  >>> DEVICE_CLASS YOUR_CLASS_NAME
  COPYSERVICES_HARDWARE_TYPE GENERIC
  COPYSERVICES_ADAPTERNAME svc/SvcAdapter.jar
      ### ANY OTHER DEVICE_CLASS RELATED OPTIONS ###
  <<<
  
  The documentation of these options / options values is missing
  in the product manual. Instead it contains a misleading
  statement which suggests that
  'COPYSERVICES_HARDWARE_TYPE SVCDTA'
  might be a valid setting, which is not true in fact.
  
  Product versions affected: IBM Tivoli Storage FlashCopy Manager
                             starting with version 4.1.4,
                             IBM Spectrum Protect Snapshot
                             All 8.1 versions
             Initial impact: Medium
        Additional keywords: SPS FCM ACS TS006738347 TS006211515
  

Local fix

Problem summary

• ****************************************************************
  * USERS AFFECTED:                                              *
  * IBM Spectrum Protect Snapshot 8.1.11 level.                  *
  *                                                              *
  ****************************************************************
  * PROBLEM DESCRIPTION:                                         *
  * see Error description                                        *
  ****************************************************************
  * RECOMMENDATION:                                              *
  * This issue is projected to be fixed in the IBM Spectrum      *
  * Protect Snapshot 8.1.11level. Note that this is subject to   *
  * change at the discretion of IBM.                             *
  ****************************************************************
  

Problem conclusion

• The following three topics are updated:
  1. Topic: Configuring a HyperSwap environment
  Link:
  https://www.ibm.com/docs/en/sps/8.1.11?topic=cse-configuring-hyp
  erswap-environment-2
  Old text: >>> DEVICE_CLASS SVC05_SITE1
  COPYSERVICES_HARDWARE_TYPE SVCDTA
  
  >>> DEVICE_CLASS SVC05_SITE2
  COPYSERVICES_HARDWARE_TYPE SVCDTA
  
  New text:
  >>> DEVICE_CLASS YOUR_CLASS_NAME
  COPYSERVICES_HARDWARE_TYPE GENERIC
  COPYSERVICES_ADAPTERNAME svc/SvcAdapter.jar
  
  2. Topic: Oracle profile example
  Link:
  https://www.ibm.com/docs/en/sps/8.1.11?topic=examples-oracle-pro
  file-example
  Description: The following line is removed "
  COPYSERVICES_HARDWARE_TYPE SVCDTA     # *mandatory parameter*
  SVC | SVCDTA | DS8000 | XIV"
  
  3. Topic: DEVICE_CLASS parameters for dynamic target allocation
  Link:
  https://www.ibm.com/docs/en/sps/8.1.11?topic=class-dynamic-targe
  t-allocation-parameters
  a) Old text: COPYSERVICES_HARDWARE_TYPE
  This parameter is required. Only one device can be specified.
  SVCDTA
  Specify the SVCDTA option when the storage system is SAN Volume
  Controller or Storwize family and you require the target volumes
  to be dynamically allocated during the backup process.
  Default
  None
  Advanced mode only
  No
  New text: COPYSERVICES_HARDWARE_TYPE
  This parameter is required. Only one device can be specified.
  GENERIC
  Specify the GENERIC option when the storage system is SAN Volume
  Controller or Storwize family and you require the target volumes
  to be dynamically allocated during the backup process.
  Default
  None
  Advanced mode only
  No
  b) The following parameter is added:
  COPYSERVICES_ADAPTERNAME
  This parameter is required. Only one adapter can be specified.
  Value
  svc/SvcAdapter.jar
  Default
  None
  Advanced mode only
  No
  

Temporary fix

Comments

APAR Information

• APAR is sysrouted FROM one or more of the following:

• APAR is sysrouted TO one or more of the following:

Fix information

Applicable component levels