IT43648: DOCUMENTATION NOT CLEARLY DESCRIBING REQUIREMENTS AND SETUP STEPS FOR MICROSOFT EXCHANGE INDIVIDUAL MAILBOX ITEM RESTORE

APAR status

• Closed as documentation error.

Error description

• The IBM Spectrum Protect Plus documentation does not clearly
  indicate the requirements and precise setup steps to be able to
  restore a Microsoft Exchange individual mailbox item on the
  target Windows server in the manual page ?Restoring individual
  mailbox items by using a granular restore operation?.
  A missing requirement is that the individual mail item restore
  process needs to happen on a Windows host with Outlook
  installed.
  This means that restore must happen on a remote Windows host as
  Outlook cannot be installed on an Exchange server.
  This is a Microsoft limitation.
  The setup steps are available in the "C:\program files\ibm\
  IBM Spectrum Protect\tools\Exchange\imr\readme.htm" file on the
  Microsoft Exchange server where the IBM Spectrum Protect Plus
  Exchange agent is installed.
  
  IBM Spectrum Protect Plus Versions Affected:
  IBM Spectrum Protect Plus 10.1.x
  
  Additional Keywords: SPP, SPPLUS, TS012538780, IMR
  

Local fix

Problem summary

• ****************************************************************
  * USERS AFFECTED:                                              *
  * IBM Spectrum Protect Plus 10.1.3 - 10.1.14                   *
  ****************************************************************
  * 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 *
  * version 10.1.15. Note that this is subject to change at the  *
  * discretion of IBM.                                           *
  ****************************************************************
  

Problem conclusion

• In IBM Documentation, the "Restoring individual mailbox items by
  using a granular restore operation" topic has missing
  requirement for individual mailbox item restore process, which
  has to be performed on a Windows host system that has Outlook
  installed.
  
  In the "Before you begin" section of the topic we have added the
  following action list items:
  
   - You must perform individual mailbox items restore operation
  from a remote server that has Microsoft 32-bit Outlook
  installed.
   - You must install and configure the granular restore remote
  package to a remote server that has Microsoft Outlook installed.
  For instructions see, "Installing the Granular Restore remote
  package".
  
  For more instructions about installation and configuration of
  the granular restore remote package, we have introduced the new
  topic in IBM Documentation: "Installing the Granular Restore
  remote package"
  
  This information will be published with the upcoming release for
  IBM Spectrum Protect plus 8.1.15 in the following topic URLs:
  https://www.ibm.com/docs/en/spp/10.1.15?topic=databases-restorin
  g-individual-items-granular-restore
  https://www.ibm.com/docs/en/spp/10.1.15?topic=restore-installing
  -granular-remote-package
  

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