IT35882: 'CTGGA2081 FAILED TO ENABLE LOG BACKUP' FOR MICROSOFT SQL OR EXCHANGE DATABASES

APAR status

• Closed as program error.

Error description

• The backup of Microsoft SQL or Exchange databases using IBM
  Spectrum Protect Plus partially completes saving the database
  but failing to save logs with the following messages seen in
  the job log :
  
   SUMMARY,<timestamp>,CTGGA2398,Starting job for policy
                                 exch_<SLAName>. id -> <JobID>.
                                 IBM Spectrum Protect Plus
                                 version 10.1.7-3043.
  ...
   DETAIL,<timestamp>,CTGGG1103,[<ExchangeServerAddress>]
                                Starting enablelogbackup
     INFO,<timestamp>,CTGGA3150,[<ExchangeServerAddress>]
                                [<timestamp>] Ending
                                enablelogbackup command.
    ERROR,<timestamp>,CTGGA2066,[<ExchangeServerAddress>] Log
                                backup failed for instance
                                <ExchangeInstanceName> on
                                application server
                                <ExchangeServerAddress>
  ...
     INFO,<timestamp>,CTGGA2107,Performing backup of databases
                                [<DBName>] on application server
                                <ExchangeServerAddress>
   DETAIL,<timestamp>,CTGGG1103,[<ExchangeServerAddress>]
                                Starting backup
  ...
   DETAIL,<timestamp>,CTGGG1055,[<ExchangeServerAddress>]
                                Mailbox history successfully
                                backed up.
   DETAIL,<timestamp>,CTGGG1012,[<ExchangeServerAddress>] <x>
                                file(s) backed up. Total <y> GB
                                data transferred.
   DETAIL,<timestamp>,CTGGA2402,<ExchangeInstanceName> ==>
                                <DBName> (Server:
                                <ExchangeServerAddress> Transfer
                                Size: <y> GB)
  ...
     WARN,<timestamp>,CTGGA2341,Setting task status to partial
                                for reason(s): [Enable log backup
                                failure(s)]
   DETAIL,<timestamp>,CTGGA0804,Protection task 2 completed in
                                <xx> min(s) <yy> sec(s) and ended
                                with status PARTIAL.
  
  For this APAR to apply, the following must be seen in the
  command.log file located in the job log bundle for the affected
  Microsoft SQL or Exchange server :
  
  <timestamp> .. DEBUG winagent - connectCifsShare is called
  <timestamp> .. DEBUG winagent - base uri [https://<vSnapIP>],
                                  endpoint [/api/identity/user/
                                  <xxxx>]
  <timestamp> .. DEBUG winagent - Set request headers [/api/
                                  identity/user/<xxxx>],[01234567
                                  89abcdef0123456789abcdef],[abcd
                                  ef0123456789abcdef0123456789]
  <timestamp> .. DEBUG winagent - To send out a GET request
  <timestamp> .. DEBUG winagent - GetUserCredential return code
                                  [12030]
  <timestamp> .. ERROR winagent - HTTP Exception:
                                 [WinHttpSendRequest: 12030: The
                                 connection with the server was
                                 terminated abnormally]
  ...
  <timestamp> .. ERROR winagent - Exception caught CreateProcess
                                  failed: The system cannot find
                                  the path specified.
  <timestamp> .. ERROR winagent - Failed to get vSnap credential
                                  by using identity uri
  <timestamp> .. WARN  winagent - Failed to connect to remote
                                  address [<vSnapIP>], error
                                  [Failed to get vSnap credential
                                  by using identity uri]
  
  The above HTTPS error will be generated when the Windows host
  has incorrect/inconsistent SSL/TLS settings preventing HTTPS
  connection with the IBM Spectrum Protect Plus Host.
  The 'Test connection' wizard in the GUI used to validate
  connectivity might report HTTPS is working while it is not
  because it is incorrectly using different libraries.
  The documentation should also clarify the SSL/TLS requirements.
  
  IBM Spectrum Protect Plus Versions Affected:
  IBM Spectrum Protect Plus 10.1.3 and higher
  
  Initial Impact: Medium
  
  Additional Keywords: SPP, SPPLUS, TS004835168, logs
  

Local fix

• Check HTTPS connectivity is valid by attempting to reach the IBM
  Spectrum Protect Plus GUI with a supported browser from within
  the affected guest.
  

Problem summary

• ****************************************************************
  * USERS AFFECTED:                                              *
  * IBM Spectrum Protect Plus levels 10.1.5, 10.1.6 and 10.1.7   *
  *                                                              *
  ****************************************************************
  * PROBLEM DESCRIPTION:                                         *
  * See error description.                                       *
  ****************************************************************
  * RECOMMENDATION:                                              *
  * Apply the fixing level when available. This problem is       *
  * currently projected to be fixed in IBM Spectrum Protect Plus *
  * level 10.1.8. Note that this is subject to change at the     *
  * discretion of IBM.                                           *
  *                                                              *
  ****************************************************************
  

Problem conclusion

• The enable log backup failure has been fixed by using a
  different API for REST API calls.
  

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

• Fixed component name

  SP PLUS

• Fixed component ID

  5737SPLUS

Applicable component levels