APAR status
Closed as documentation error.
Error description
IBM Spectrum Protect Plus documentation information needs to be improved about space requirements for guest file indexing. The current 'File indexing and restore requirements' just say : "The amount of free space that is required for the metadata in the catalog depends on the total number of files in the environment. To catalog 1 million files, the catalog volume in the IBM Spectrum Protect Plus server requires roughly 350 MB of free space per retained version. The space used by file indexing metadata is reclaimed when the corresponding backup instances expire." There is no information on what exact IBM Spectrum Protect Plus host filespace the above rule applies. The file catalog is stored on the Spectrum Protect Plus host in the Lucene database under filespace /data3. That is the one to size according to the above rule of thumb. For example : Two VM guests with each guest having 10 million files. Each guest is backed up daily. Retention is 30 days. In that case, applying the rule gives : Number of file catalog entries = 2 * 10 million * 30 versions = 600 million files Approximate space needed in /data3 = 600 * 350 MB = 210 GB Additional considerations : - During indexing, the results returned from the client are temporarily stored in filespace /data2 before they are ingested into the Lucene database. The default space in /data2 is usually sufficient, but this might need to be increased slightly to accommodate the data (using the same rule of thumb) to ingest if lots of jobs are running at the same time. - The Lucene DB has an overall limit of about 2 billion entries IBM Spectrum Protect Plus Versions Affected: IBM Spectrum Protect Plus 10.1.x Initial Impact: Medium Additional Keywords: SPP, SPPLUS, TS004457204
Local fix
n/a
Problem summary
**************************************************************** * USERS AFFECTED: * * Users of the IBM Spectrum Protect Plus Knowledge Center and * * User's Guide in versions 10.1.6 and 10.1.7. * **************************************************************** * PROBLEM DESCRIPTION: * * See ERROR DESCRIPTION. * **************************************************************** * RECOMMENDATION: * ****************************************************************
Problem conclusion
Additional information has been added to the File Indexing and Restoring requirements topic concerning the space requirements in the IBM Spectrum Protect Plus User's and Installation Guide and the IBM Documentation Center for version 10.1.8 at the following location: https://www.ibm.com/support/pages/node/6416689 These additional requirements also apply to IBM Spectrum Protect Plus versions 10.1.6 and 10.1.7: The amount of free space that is required for the metadata in the catalog depends on the total number of files in the environment. To catalog 1 million files, the catalog volume in the IBM Spectrum Protect Plus server requires roughly 350 MB of free space per retained version. For example, 2 virtual machines that each contain 10 million files are backed up daily with a retention of 30 days. The resulting number of catalog entries is 2 * 10 million * 30 days for a total of 600 million entries. Therefore, the approximate space needed is 600 * 350 MB which is 210 GB. The space that is used by file indexing metadata is reclaimed when the corresponding backup instances expire. During file indexing, results are temporarily stored in /data2 prior to being saved in the catalog. If there are several jobs running concurrently, the size of /data2 may need to be increased from the default size.
Temporary fix
Comments
APAR Information
APAR number
IT35567
Reported component name
SP PLUS
Reported component ID
5737SPLUS
Reported release
A17
Status
CLOSED DOC
PE
NoPE
HIPER
NoHIPER
Special Attention
NoSpecatt / Xsystem
Submitted date
2021-01-18
Closed date
2021-05-07
Last modified date
2021-05-07
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
[{"Business Unit":{"code":"BU058","label":"IBM Infrastructure w\/TPS"},"Product":{"code":"SSNQFQ","label":"IBM Spectrum Protect Plus"},"Platform":[{"code":"PF025","label":"Platform Independent"}],"Version":"A17","Line of Business":{"code":"LOB26","label":"Storage"}}]
Document Information
Modified date:
31 January 2024