preferences:synchronisation

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
preferences:synchronisation [2021/10/08 09:25] – Gary Willettspreferences:synchronisation [2023/12/04 02:32] (current) – [The preferences] Kahn Wynyard
Line 2: Line 2:
 ====== 16.07. Synchronisation preferences ====== ====== 16.07. Synchronisation preferences ======
 <WRAP center round important 90%> <WRAP center round important 90%>
-  * Synchronisation preferences are only relevant for a [[other_stuff:remote_sync|synced system]]. +  * The preferences described here (accessed through **File > Preferences...**) apply to all stores on an mSupply server. 
-  * These preferences can be safely ignored if you have a stand-alone mSupply installation, or a single server. +  * In a [[synchronisation:introduction|synced system]] there will be multiple 'sync satellites' and these settings can be different on each sync satellite. 
-  * These settings will normally only be changed by Sustainable Solutions. They are not intended for general use by mSupply users.+  * There are some settings that are 'per store' - refer [[other_stuff:virtual_stores#the_preferences_tab|Store preferences]], and store preferences can be different for each store on an mSupply server.
 </WRAP> </WRAP>
  
Line 26: Line 26:
     * **Sync time interval:** the number of minutes between attempts to synchronise with the primary server. Setting this to 0 pauses sync. Editable without clicking on the **Click to unlock** button but only if sync is enabled on this site (i.e. if **Sync ID** is greater than 0).     * **Sync time interval:** the number of minutes between attempts to synchronise with the primary server. Setting this to 0 pauses sync. Editable without clicking on the **Click to unlock** button but only if sync is enabled on this site (i.e. if **Sync ID** is greater than 0).
     * **Sync request size:** the number of requests to lump together when communicating with the primary server. If the internet connection is stable it is more efficient to have a larger number here. If the connection is less stable then it is better to have a smaller number.     * **Sync request size:** the number of requests to lump together when communicating with the primary server. If the internet connection is stable it is more efficient to have a larger number here. If the connection is less stable then it is better to have a smaller number.
-  * **Use js node HTTP client checkbox:** checking this causes mSupply to use a Node.js HTTP client instead of its built-in webserver to communicate with the primary server. This is advantageous in some situations. This option will be enabled if synchronisation is being used on this site. It is the one setting that can be changed without entering the authorisation code mentioned above. +  * **Use js node HTTP client checkbox:** This preference is not recommended and will be disabled in future versions of mSupply (v7.11 and above). Node JS was used in special circumstances where 4D HTTP handlers were not working well on cellular connections for certain regions. This has been improved and Node JS is no longer needed.
   * **Check connection button:** click on this to check the connection to the primary server. The button is available even if the settings have not been unlocked and will send a test request to the primary server (but only if sync is enabled on this site i.e. if **Sync ID** is greater than 0). The result of the request will be displayed in a message and will tell you whether this site can reach the primary server.   * **Check connection button:** click on this to check the connection to the primary server. The button is available even if the settings have not been unlocked and will send a test request to the primary server (but only if sync is enabled on this site i.e. if **Sync ID** is greater than 0). The result of the request will be displayed in a message and will tell you whether this site can reach the primary server.
  
Line 44: Line 44:
   * **URL:** On a remote site, this should be the central server's URL or IP address, including the port if the default is not used. On the central server, if any sites have this field populated it'll disable sync.   * **URL:** On a remote site, this should be the central server's URL or IP address, including the port if the default is not used. On the central server, if any sites have this field populated it'll disable sync.
   * **Hardware ID:** This is a unique hardware identifier of the remote machine. The primary server has a copy of this information and, if the value here differs from that on the central server, sync will be diabled for this site. If the remote machine hardware has actually changed (e.g. a new computer) then clearing this value on the primary server will allow the new value to be saved and sync will resume.   * **Hardware ID:** This is a unique hardware identifier of the remote machine. The primary server has a copy of this information and, if the value here differs from that on the central server, sync will be diabled for this site. If the remote machine hardware has actually changed (e.g. a new computer) then clearing this value on the primary server will allow the new value to be saved and sync will resume.
-  * **Generate sync records button:**  If this is the central server, this button will generate all the sync records to initialise a new data file; if you're on a remote site, it will generate the sync records for stores active on this site (e.g. if you need to refresh the central server copy). +  * **Generate sync records button:**  If this is the central server, this button will generate all the sync records to initialise a new data file; if you're on a remote site, it will generate the sync records for stores active on this site (e.g. if you need to refresh the central server copy). After clicking on the button you will see this message: {{ :preferences:newdataalert.png?400 |New Data Sync Alert}} 
-{{ :preferences:newdataalert.png?400 |New Data Sync Alert}}+    * **New button:** Clicking this will create sync out records for system and transactional data (users, preferences, customer invoices, supplier invoices etc.). 
 +    * **Existing button:** Clicking this will create sync out records for store data only.
  
-  - New : It will create sync out records for all data like users, preferences and store datas's. 
-  - Existing : It will create sync out records for only store datas's. 
   * **Retrieve sync records button:** Does a manual pull of sync records waiting for this site on the primary server.   * **Retrieve sync records button:** Does a manual pull of sync records waiting for this site on the primary server.
  
  • Last modified: 2021/10/08 09:25
  • by Gary Willetts