IT38255: COPY TO CLOUD OR ARCHIVE FAILS WITH RELATIONSHIPDELETEERROR WHEN DELETING OLD RELATIONSHIP

APAR status

• Closed as program error.

Error description

• When IBM Spectrum Protect Plus is running a copy to cloud or
  archive, under certain conditions
  
  it attempts to delete an old relationship and create a new one.
  For example if the destination has
  
  changed, or if the previous relationship was created but never
  cataloged due to a failure during
  the previous job, the next run of the SLA attempts to delete the
  previous relationship. Another
  symptom seen is that the vSnap checks against all relationships
  rather than just the ones
  involved in the deletion.
  
  This  operation can fail with the following messages seen in the
  job log:
  INFO,CTGGA3116,Copying 1/1 snapshot to archive object storage
  for volume <name>
  ERROR,Copy Failed ( message :"Failed to delete relationship:
  Relationship <ID> has <n> ACTIVE/PENDING sessions"type
  :"RelationshipDeleteError")
  e=...serviceprovider.common.storage.exception.StorageGenericExc
  eption:message :"Failed to delete relationship: Relationship <ID
  <n> ACTIVE/PENDING sessions"type :"RelationshipDeleteError"
  
  IBM Spectrum Protect /Protect Plus Versions Affected:?
  10.1.8
  
  
  Additional Keywords: TS006504369 ISPPSUP-2777
  RelationshipDeleteError SPP ArchiveToTape
  

Local fix

• Make sure all jobs have completed and nothing is running
  before   manually deleting the relationship using the following
  
  steps.
  
  1) Looking at the above error from the job log, make a note of
  the relationship ID.
  It will look like the following:
  
  
  ERROR,Copy Failed ( message :"Failed to delete relationship:
  Relationship <ID>
  
  
  2) Run the following command to delete the relationship using
  the following :
  For cloud copy relationships:
  
  vsnap cloud relationship delete --id <ID>
  
  For archive relationships:
  
  vsnap archive relationship delete --id <ID>
  
  NOTE:  If the manual command fails with the same error, examine
  the list of sessions using  the commands:
  
  "vsnap cloud session show" or "vsnap archive session show"
  
  If there are one or more background sessions still present,
  allow them to complete before retrying the deletion.
  

Problem summary

• ****************************************************************
  * USERS AFFECTED:                                              *
  * IBM Spectrum Protect Plus level 10.1.8                       *
  ****************************************************************
  * PROBLEM DESCRIPTION:                                         *
  * See Error Description                                        *
  ****************************************************************
  * RECOMMENDATION:                                              *
  * Apply fixing level when available. This problem is currently *
  * projected to be fixed in IBM Spectrum Protect Plus level     *
  * 10.1.9. Note that this is subject to change at the           *
  * discretion of IBM.                                           *
  ****************************************************************
  

Problem conclusion

• Implemented codes fixes to perform the correct checks during
  deletion of cloud or archive relationships.
  

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:

Modules/Macros

• vSnap    Archive
  

Fix information

• Fixed component name

  SP PLUS

• Fixed component ID

  5737SPLUS

Applicable component levels