Retiring the primary storage location
This section describes the process that must be followed to retire the DS-System primary storage location. This is the location specified by the Backup Root parameter in the DS-System configuration file (dssys.cfg).
IMPORTANT: Normally you should never change the primary storage location. However, in the event of hardware failure on the primary storage location, you must configure a replacement file system with the same absolute path (name/IP address, share, and folder) as the original one. Then you must restart the DS-System in DR mode by setting the value of the DisasterRecoveryMode advanced configuration parameter to 1. This configures DS-System to rebuild the storage links for every backup set in the replacement location.
All extensible storage locations contain the following:
• data — Folder containing the customer data.
• Storage_Label.txt — Text file containing the extensible storage location ID and its path.
• tmp/temp — Folder containing temporary files (one is used for normal operations and the other is used by some of the modules).
• trash — Folder containing all deleted files.
The primary storage location also contains the following folders:
• cd — Folder containing the disc/tape contents.
• cluster — Folder containing the N+1 configuration file (filename: config). Required only for N+1 DS-Systems.
• dump — Folder containing the DS-System database dumps.
• logs — Folder containing the archived log files with entries that were removed from the DS-System database by the Clear DS-System Logs feature and Delete Logs processes.
• Upgrade — Folder containing all the upgrade packages for client-side software installations.
To retire the primary storage location:
IMPORTANT: This process requires manual changes to the DS-System database and a restart of the DS-System so must be performed carefully.
1. On the Setup menu, click System Activities, and then click Disable.
2. On the Setup menu, click Storage, and then click Extensible Storage.
3. In the Extensible Storage Locations dialog box, configure the <Default> storage group so that it contains only two storage locations:
• The existing primary storage location that is to be retired.
• The replacement storage location.
The replacement storage location must have the next (sequential) lowest ID number. For example, if you have four locations (IDs 1, 2, 3, 4), and ID 1 is the current primary, you must make ID 2 the new primary storage location.
IMPORTANT: Only use the <Default> storage group with these two storage locations. If necessary, temporarily change the storage group of any other storage location that shares this group to ensure that there is only one other location where the DS-System can re-assign the primary storage location.
5. Wait until the Retire Storage Monitor appears. At this point, the DS-System automatically re-assigns the primary storage links to the other storage location in the <Default> storage group.
NOTE: If you have temporarily changed the storage group of any other storage locations, change them back now. In this case, you will have to close the popup Retire Storage Monitor window, edit the storage location(s), then re-open it (On the Setup menu, click Storage, and then click Retire Storage Monitor).
6. In the Retire Storage Monitor dialog box, click Start This starts the data movement from the primary storage location to the other location.
NOTE: If there is a Stop button instead of a Start button, the DS-System is already monitoring and will begin retiring the storage automatically.
7. In the Retire Storage dialog box, select how many threads to use and click OK.
8. After the retiring primary storage location process is finished, stop the DS-System service.
9. Copy the cd, cluster, dump, and logs folders to the new primary storage location.
10. Open the DS-System configuration file (dssys.cfg) and change the following values to the path of the new primary storage location:
• Backup Root
• Del Root
• Temp Root
• Upgrade Path
11. Manually edit the DS-System (dssystem) database (Microsoft SQL or PostgreSQL) with the following SQL statement:
DELETE FROM Storage_Locations WHERE ID=<primary_storage_id>
where <primary_storage_id> is the lowest corresponding ID from the Extensible Storage Locations dialog box list (normally it will be “1”).
This command removes the existing primary storage location. The next lowest ID number becomes the new primary storage location. (For example: if you delete ID 1 and there is an ID 2, then it becomes the new primary storage location.)
The new primary storage location must be the same one where the links were re-assigned in step 5.
IMPORTANT: Do not make any other changes to this table or the database.
12. Start the DS-System service / daemon. Verify there are no errors.