How To Use the setStorageUpgradeConfig Utility

Syntax: setStorageUpgradeConfig [options]

The setStorageUpgradeConfig command enables/disables and sets the daily stop/start times for the content store upgrader that is provided with DocuShare 6.6. This command should be run on sites that have been upgraded to DocuShare 6.6 and are having problems backing up data stored in a very deep directory hierarchy that is too complex for the backup application to handle successfully. There is no need to run this command on newly installed DocuShare 6.6 sites which do not contain documents from older versions of DocuShare.

Note: The setStorageUpgradeConfig simply flattens the directory structure and reduces the number of folders to help decrease the amount of time required for backup.

The enabled upgrader runs in the background, daily during the set times, until the upgrade is complete. If for some reason the upgrader stops before completion, the administrator can restart the command without the loss of data.

To display current settings, run the command without specifying an option. The default settings for this command are enable off -starthour 1 -endhour 6.

Refer to Server Statistics>Content Store Statistics to monitor the progress of this command; Legacy Storage Performance Upgrade Enabled and Legacy Storage Performance Upgrade Completed. If the command is enabled, but has not finished upgrading, the last two columns in the Partitions table of Content Store Statistics indicate the status of each partition. Upgrade Completed displays the upgrade status of a partition and Last Directory displays upgrade progress. The Last Directory value changes periodically as the upgrader works through the content store directories.

Note: On sites upgraded to 6.6, use this command before partitioning the content store. Refer to the Content Store Configuration procedure in the DocuShare Administrator Guide.

Options for setStorageUpgradeConfig

Example using setStorageUpgradeConfig

setStorageUpgradeConfig -enable on -starthour 2 -endhour 7— enable and start the upgrader daily at 2 AM and stop at 7 AM.

Note: You can tell that the setStorageUpgradeConfig utility has completed by looking on the Content Store configuration page or you can look in the \config\ContentStore.xml configuration file for the following setting.

true

Note: If you have multiple disk partitions, the utility is done when all of the ‘upgradeFinished’ entries are marked ‘true’.

Solution Published: August 9^th 2011

Solution ID: 900

Keyword: squisher