Restoring all Admin Portal data is done by copying the backed-up files back to their original locations.
During this process, the Admin Portal services must be stopped.
For cloud installations, backup and restore are handled by the service provider and cannot be performed by customers.
Data is stored across three types of storage:
- Relational database (MSSQL LocalDB): Stores all structured relational data, including entities and their relationships.
- Table storage (MongoDB): Stores unstructured data, such as system events, events, and reporting data.
- File system: Stores all downloaded files and files prepared for download from the Admin Portal, such as item documents, and import/export files.
Restore MSSQL LocalDB
To restore data from a backup, neither the Admin Portal service nor the MongoDB service can be running.
To stop the CD.Platform service, follow these steps:
- Press Windows + R on your keyboard to open the Run dialog.
- Type services.msc and press Enter.
- In the Services window, scroll down the list to find CD.Platform.
- Services are listed alphabetically, so it should appear under the “C” section.
- Right-click on CD.Platform.
- Select Stop from the context menu (1).
- The Status column for CD.Platform should now be blank (instead of showing “Running”).
Navigate to location C:\Windows\System32\config\systemprofile
Replace files SmartSupplyAdministration.mdf and SmartSupplyAdministration_log.ldf with same files from the backup location
Start CD Platform services or continue with restore of MongoDB
Restore MongoDB
- Shut down the MongoDB service (open Task Manager, locate the MongoDB service, and stop it).
- Navigate to C:\MongoDB and delete the Data folder.
- Copy the Data folder from the backup location into C:\MongoDB
- Restart the MongoDB service (and the CD Platform services, if they are still stopped).
Alternatively, mongorestore can be used to import data dumped with mongodump without need to stop MongoDB services. To restore dumped data, start C:\MongoDB\Server\bin\mongorestore.exe.
For more information, visit https://docs.mongodb.com/manual/core/backups/
Restore file system
To restore files stored on the file system, it is recommended to stop the CD Platform services to prevent any data corruption.
- (Optional) Stop the CD Platform services.
- Clear the contents of the folder: C:\Storage.
- Copy the contents from the file system backup folder to C:\Storage.
- (Optional) Restart the CD Platform services.