Retiring the DS-System Primary Storage Location (Backup Root)
Summary
This article describes the process that must be followed in order to retire the DS-System Primary Storage Location. The Primary Storage Location is the location specified by the "Backup Root" parameter in the DS-System Configuration file (dssys.cfg). By default, after a DS-System installation, the Primary Storage Location is the storage location with ID 1.
- WARNING: Normally, you should never change the Primary Storage Location. In the event of hardware failure on the Primary Storage Location, you must configure the replacement file system with the same absolute path (name/IP address, share, folder) as the original one. Then you must restart the DS-System in DR mode (Advanced Configuration Parameter "DisasterRecoveryMode" = 1) in order for DS-System to rebuild the storage links for every backup set in the replacement location.
Details
All Extensible Storage Locations contain the following:
- Data - folder used to hold customer data
- tmp/temp - used to hold temporary files (one used for normal operations, one used by some of the modules)
- Storage_Label.txt - Text file containing the Extensible Storage location ID and its path.
The Primary Storage Location also contains the following folders:
- dump - used to hold DS-System database dumps
- Licenses - used to hold DS-System License files.
- Logs - used to hold archived log files containing entries that were removed from the DS-System database by the "Clear DS-System Logs" feature.
- cluster - N+1 DS-System only: contains the N+1 configuration file (filename "config").
Changing the Primary Storage Location
This is possible in very rare situations (like if you need to retire the Primary Storage Location). This requires manual changes to the DS-System database, therefore it must be done very carefully. This also requires a restart of the DS-System.
1. Suspend activities on DS-System (Setup Menu > System Activities: Disable).
2. Setup Menu > Storage > Extensible Storage. From the Extensible Storage Locations screen, make sure there are only two Storage Locations in the same Group as the Primary Storage Location:
- The existing Primary Storage Location (to be retired).
- The Storage Location that you want to be the replacement. This location must have the next (sequential) lowest "ID" number. For example: if you have four locations (IDs 1, 2, 3, 4), ID 1 is the current primary. You must make ID 2 the new Primary Storage Location.
3. Highlight the current Primary Storage Location and click Retire. (For more information, see "Retire Storage Locations".)
- Since you have retired the Primary Storage Location, DS-System automatically re-assigns the Primary Storage Links to the remaining Storage Location.
4. Copy the dump, Licenses, Logs, and cluster folders to the new Primary Storage Location.
5. Edit the DS-System Configuration file (dssys.cfg). Change the following values to the path of the new Primary Storage Location:
6. Stop DS-System service / daemon.
7. Manually edit the DS-System (dssystem) database (MS 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 screen list (normally it will be "1").
- Note: This command removes the existing Primary Storage Location. The next lowest ID number becomes the new Primary Storage Location. (e.g. if you delete ID #1, if there is an ID #2 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 3.
- WARNING: DO NOT MAKE ANY OTHER CHANGES TO THIS TABLE OR THE DATABASE.
8. Start DS-System service / daemon. Verify there are no errors.
See Also
The information provided in this document is provided "AS IS", without warranty of any kind. ASIGRA Inc. (ASIGRA) disclaims all warranties, either express or implied. In no event shall ASIGRA or its business partners be liable for any damages whatsoever, including direct, indirect, incidental, consequential, loss of business profits or special damages, even if ASIGRA or its business partners have been advised of the possibility of such damages. © Asigra Inc. All Rights Reserved. Confidential.
![]() ![]() |