admin:backup_and_restore

Differences

This shows you the differences between two versions of the page.

Link to this comparison view

Both sides previous revision Previous revision
Next revision
Previous revision
Last revisionBoth sides next revision
admin:backup_and_restore [2020/09/15 07:21] – [Setting up backup and a log file for single user mSupply] Mark Gloveradmin:backup_and_restore [2022/01/17 23:10] – [Restoring your data] Mark Glover
Line 1: Line 1:
 {{indexmenu_n>60}} {{indexmenu_n>60}}
-====== 23.06. Backup ====== +====== 25.06. Backup ======
 If your data is important, then data backups need to happen, because things can go wrong (power failures, disk failures, ransomware, etc.) If your data is important, then data backups need to happen, because things can go wrong (power failures, disk failures, ransomware, etc.)
  
Line 23: Line 22:
  
 Choose **File > Backup...** to run a manual backup of your data. The backup will be carried out according to the configuration of the [[preferences:general#backup_tab|Preferences > Backup tab]]. Choose **File > Backup...** to run a manual backup of your data. The backup will be carried out according to the configuration of the [[preferences:general#backup_tab|Preferences > Backup tab]].
- 
- 
- 
- 
  
 ===== Backup: best practice ===== ===== Backup: best practice =====
Line 50: Line 45:
 This is still possible if your machine only has one disk drive and you can not configure a RAID array.  This could be a volume attached to a USB port (e.g. a thumb drive) or a location on the network, //provided that it is always available//. This is still possible if your machine only has one disk drive and you can not configure a RAID array.  This could be a volume attached to a USB port (e.g. a thumb drive) or a location on the network, //provided that it is always available//.
  
 +==== Configure Primary backups ====
  
 +We recommend that you configure the Primary backup as recommended in our user's guide section on the [[preferences:general#backup_tab|Preferences > Backup tab]].
  
- +==== Configure a secondary backup ==== 
-==== Configure a secondary backup location in mSupply ==== +  * Configure a secondary backup to a destination on the same machine, or elsewhere on the network that will be synced off-site (e.g. Dropbox, OneDrive, Google Drive, etc.) - refer [[preferences:general#backup_2_tab|Preferences > Backup 2 tab]].
-  * Configured a secondary backup to a destination on the same machine, or elsewhere on the network that will be synced off-site (e.g. Dropbox, OneDrive, Google Drive, etc.) - refer [[preferences:general#backup_2_tab|Preferences > Backup 2 tab]].+
  
 ==== Configure off-site backup ==== ==== Configure off-site backup ====
Line 63: Line 59:
 ==== Mirrored servers ==== ==== Mirrored servers ====
 We have the technology to provide mirrored servers when very high availability is required. Contact us if interested. A charge will apply for implementation We have the technology to provide mirrored servers when very high availability is required. Contact us if interested. A charge will apply for implementation
 +
 +
 +
 +==== Use a standard place to store backups ====
 +We suggest that you store:
 +  * mSupply data in ''C:/mSupply_data/''
 +  * Backups in ''C:/mSupply_backups/''
 +  * Log file in ''C:/mSupply_data/''
 +
 +===== Backup for mSupply single user sites =====
 +
 +If you have a synchronisation system with mSupply it's very important that the sync satellite sites have operating backups.  By design, mSupply sync satellite sites can operate indefinitely without syncing to the Central server.  There are numerous cases of Sync satellite sites operating for months without syncing, though this is not recommended!  In such cases, a failure on the sync satellite site could result in months of lost data unless backups are operating on the such sync satellite sites.  These sites are normally even more vulnerable to failure than 'Central' servers ....
  
 =====  Restoring your data ===== =====  Restoring your data =====
 +<WRAP important center round 90%>
 +For data security purposes, the //New data file//, //Restore// and //Open new datafile// functions are disabled if you are on a satellite site in a synchronising system.
 +</WRAP>
  
 An mSupply database can be created from a backup: An mSupply database can be created from a backup:
- 
   - Log in to msupply with an old data file or by creating a new data file and click menu **File > Restore...**   - Log in to msupply with an old data file or by creating a new data file and click menu **File > Restore...**
   - Locate your backup file in the //**Open**// dialog that appears. Your backup file has file extension ''.4BK'', eg. ''CMS.4BK'' Hit **OK**.   - Locate your backup file in the //**Open**// dialog that appears. Your backup file has file extension ''.4BK'', eg. ''CMS.4BK'' Hit **OK**.
Line 76: Line 86:
   - Select the data file and hit the **OK** button.   - Select the data file and hit the **OK** button.
   - You may be prompted for a log file.  Click on the **Create** button.  Select the suggested location, which is the same as your new data file location, and click on the **Save** button.   - You may be prompted for a log file.  Click on the **Create** button.  Select the suggested location, which is the same as your new data file location, and click on the **Save** button.
-  - You will be prompted to do a backup.  It is not necessary to do this at this stage, but the log file will not be created until you create the first backup, so you may as well accept the offer.  It can take a while to open this new data file, particularly if it is a large data file and the index file is not included with the backup (hours).+  - You will be advised that **The log file will be activated after the next backup of the data file.  Do you want to start the backup automatically?**.  If you click **OK** here, then a backup will be created //now// This can take many minutes if it is a large data file.  It is not necessary to create the backup at this stage, but the log file will not be created until you create the first backup
 +  - After clicking **OK** or **Cancel**, the data file will open.  This will take time (hours) if it is a large data file and the index file is not included with the backup (hours)
 +  - You will then be asked to **Please create and specify the location of of your log file in the next window.**  You may find that the parent location of the default location is where the log file is already created.  You can overwrite it.
   - mSupply should open your restored data file and you should be presented with the log in screen to the new data file.   - mSupply should open your restored data file and you should be presented with the log in screen to the new data file.
  
Line 83: Line 95:
 Be very careful about restoring. We suggest you consult Sustainable Solutions before attempting a restore, particularly in a synced system. Be very careful about restoring. We suggest you consult Sustainable Solutions before attempting a restore, particularly in a synced system.
  
-===== Setting up backup for single user mSupply ===== 
- 
-If you are using a synchronisation system with mSupply it's very important that you don't lose any data on the remote sites, which are possibly even more vulnerable to power or component failures.  
- 
-==== Use a standard place to store backups ==== 
-We suggest that you store: 
-  * mSupply data in ''C:/mSupply_data/'' 
-  * Backups in ''C:/mSupply_backups/'' 
-  * Log file in ''C:/mSupply_data/'' 
- 
-==== Primary backups ==== 
- 
-We recommend that you configure mSupply to  
-  * Use the single disk as the primary backup location. 
-  * The Primary backup should be set to be carried out nightly. 
-  * Use a log (journal) file. A log file records each database action as it happens. In the event of a power failure or other adverse event, all changes can be recovered from the log file. 
- 
-You can configure primary backups to run on a schedule that you set.  To do this go to Admin > Preferences and select Backup from the left panel.  You must have an existing backup to use these features (see [[admin:backup_and_restore#running_a_backup]]). 
- 
-{{ :admin:backup1.jpg |}} 
- 
-Select Automatic Backup and schedule by hour(s), day(s) or week(s) as indicated. 
- 
-{{ :admin:backup2.jpg |}} 
- 
-Choose your backup folder and select Use log file. {{:admin:backup5.jpg}}   
- 
-You will be prompted to specify the location of your log file. 
- 
-{{ :admin:backup3.jpg |}} 
- 
-Press Continue 
- 
-{{ :admin:backup4.jpg?700 |}} 
- 
-When all settings are correct, press OK to save. 
  
 \\ \\
  • Last modified: 2022/05/30 02:03
  • by Mark Glover