Differences

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

--- synchronisation:site_export [2022/06/02 22:30] – [How Long Will Export Take?] Mark Glover
+++ synchronisation:site_export [2024/01/16 07:22] (current) – Shyam Tiwari
@@ Line 1: / Line 1: @@
 {{indexmenu_n>40}}
 ====== 29.04. Sync Site Export ======
-Sync site export allows you to easily export XML files of multiple sites, which you can then use to setup a new mSupply remote site, or to restore a mSupply site that has lost its data. For instance, a site might have had a fire or a theft of its computer.
+Sync site export allows you to easily export XML files of one or more sites, which you can then use to setup a new mSupply remote site, or to restore a mSupply site that has lost its data. For instance, a site might have had a fire or a theft of its computer.
-Creation/Restoration is done using the **[[synchronisation:site_import|site import]]** functionality after creating a new data file.
+Creation/Restoration on the satellite site machine is done using the **[[synchronisation:site_import|29.05. Sync Site Import]]** functionality after creating a new data file.
 ===== When to use =====
@@ Line 12: / Line 12: @@
 If a facility has a corrupted data file that has a lot of data that wasn't synced to the central server, **[[help:support_and_uptodate|please contact us]]**.  We can help you to recover as much data as possible from **[[admin:backup_and_restore|mSupply's backups]]**.  Otherwise, for the sake of data integrity between the sync satellite and the central server, it is strongly recommended to use this sync site export feature.
 ===== Usage =====
+<WRAP center round alert 60%>
+  * Exporting a site can take many minutes, or even more than an hour for a site on a big system (thousands of items, names, transactions).  If the client session times out before the export of a site is complete, that site export will be aborted, and you will have to start again... :-(
+  * It is worth checking to make sure that the [[preferences:general#close_msupply_if_user_is_inactive_for_minutes|User inactive timeout]] has been set to long enough.
+  * Record the [[https://docs.msupply.org.nz/synchronisation:site_import#importing_a_datafile|sync password]] as it will be required when creating the datafile on the remote site
+</WRAP>
-You can view a list of sites to export by choosing **File > Export > Export sites...**
+You can view a list of sites to export by choosing //File > Export > Export sites...// from the menus.
 To export sites you must:
@@ Line 21: / Line 27: @@
   * Your mSupply user must have permission to "add/edit sync sites" in the store that you have logged in to.
-If you do not meet these criteria, you will be shown a warning and the export window will not open.
+If you do not meet these criteria, you will be shown a warning and the export window will not open. When it does open, the window looks like this:
+{{ :synchronisation:export_sites.png?650 |}}
+  - First you must select one or more sites to export by checking their checkbox in the //Selected// column
-{{ :synchronisation:export_sites.png |}}
+  - Select a folder for the export files to be saved by clicking into the **Export folder** field below the table
+  - Click the **Export** button
-  - First you must select some sites to export by checking their checkbox in the column "Selected"
-  - Select a folder for the export files to be saved by clicking the "Export folder" field below the list of sites
-  - Click **Export**
 All the selected sites will be exported one after another. A progress bar will be shown. Cancelling the export will stop after completing the current site being processed.
-==== What is "has admin"? ====
+==== What is 'Has admin'? ====
   * A site has an admin if it has at least one user that has add/edit users permission for a store on that site and also has login rights to that store. The permission may come from the user's group.
@@ Line 43: / Line 47: @@
 Exporting new sites with new stores is fast as these sites won't have many records yet. If your mSupply system has lots of system data such as items, names and master lists, you may expect a new site with a new store to take a up 5 minutes to export.
-Sites with busy stores that have been operational for some time can take much longer. A site with a busy dispensary store with 100,000 prescriptions you may expect it to take 15 to 30 minutes to export.  A site with multiple stores with many thousands of transactions can easily take hours.  It is worth checking to make sure that the [[preferences:general#close_msupply_if_user_is_inactive_for_minutes|User inactive timeout]] has been set to long enough.  If the client session times out before the export of a site is complete, that site export will be aborted, and you will have to start again... :-(
+Sites with busy stores that have been operational for some time can take much longer. A site with a busy dispensary store with 100,000 prescriptions you may expect it to take 15 to 30 minutes to export.  A site with multiple stores with many thousands of transactions can easily take hours.
 |  //  Previous:  **[[synchronisation:site_wizard|]]** | | Next: **[[synchronisation:site_import]]** //  |