What Is Docstore?

The Docstore is a new system service included in the updated Disk Safe format in the 5.14.3 release of Server Backup Manager. The purpose of the docstore is to simplify the Disk Safe format and provide a consistent way of accessing the data in the Disk Safe. Beginning with version 5.14.3, all Disk Safes must be converted to this new format. The Docstore process is integral to all Disk Safe operations (such as backups and restores) and should be allowed to run uninterrupted. 

* When the Docstore service has been started, let it run until the task is complete. 
* "100% CPU Usage" is normal when running the Docstore service.
* If the Docstore conversion is interrupted by restarting the cdp-server, the conversion will start over from scratch. *Do not hit reset during a conversion.*
** If the cdp-server is restarted during conversion, the Disk Safe will remain in a "closed" state (even after the conversion finishes) and must be manually reopened. 
* Attempting to open a Disk Safe that is still converting will result in the following message: "The selected Disk Safe cannot be opened until metadata conversion finishes."
* The Docstore conversion only happens on startup or when attaching a Disk Safe.
* The "close on startup" option does not prevent conversions.
* Old Disk Safes will contain a '_metadata_' folder in them. This is the old unconverted data and will not be deleted. 
* When a conversion begins, the '_metadata2_' folder is created. New Disk Safes added after conversion will only contain this folder.
** If the conversion is interrupted, the previous attempts to convert will be renamed '_metadata2.1_', '_metadata2.2_', etc.
* The _metadata2_ folder contains a _conversion.log_ file that displays information about what is currently being converted. When the conversion is completed, an empty file named '_finishedConverting_' displays in the _metadata2_ folder. 
* Ten Disk Safes are converted at a time.
* MySQL customers with large databases may be the most heavily hit by the conversion costs due to the amount of data stored per backup.
* If the Disk Safe directory is renamed while the cdp-server is turned off, it would fail to trigger conversion on startup because it can't find the Disk Safe at the expected location anymore. If this happens, detach the Disk Safe in the UI and reattach it when you are ready to start conversion. This method can can be used to help customers manage costly conversions.