synchronisation:sync_sites

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
synchronisation:sync_sites [2023/09/20 00:55] – [Removing stores] Mark Gloversynchronisation:sync_sites [2024/04/23 10:21] (current) – Andrei Evguenov
Line 78: Line 78:
  
 === Password === === Password ===
-The password is a password! It is used by remote sites to authenticate with the central server. You cannot view the password that is set, so you should record it securely.+The password is used by remote sites to authenticate with the central server.  It is recommended to use copy and paste so as to avoid data entry errors, particularly as you cannot view the password that is set here.
  
-Note: due to this being used for authentication, beware editing it. If you change the password on an actively used site, the remote site will stop syncing. To resume syncing, the password must be restored to the old value on the central server, or updated to the new value on the remote site.+<WRAP center round alert 60%> 
 +  * Take care to record this password securely as it will be required when creating the datafile on the remote site.   
 +  * This password is used for authentication, so beware of editing it. If you change the password for an active remote site, the remote site will stop syncing. To resume syncing, the password must be restored to the old value on the central server, or updated to the new value on the remote site. 
 +</WRAP>
  
 === Hardware ID === === Hardware ID ===
Line 98: Line 101:
 If this is checked the site is active on this datafile, which means transactions can be entered in it but master data (like item and customer details etc.) cannot. If unchecked then the site is not active in this datafile and transactions cannot be entered in it.  If this is checked the site is active on this datafile, which means transactions can be entered in it but master data (like item and customer details etc.) cannot. If unchecked then the site is not active in this datafile and transactions cannot be entered in it. 
  
-=== Use js node http client === +=== Use of JS Node HTTP Client === 
-If checked then a js node http client will be used to transmit and receive synchronisation data instead of the built-in mSupply webserver. Useful in some special circumstances.+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.
  
 === Sync interval === === Sync interval ===
Line 109: Line 112:
 === Server URL === === Server URL ===
 Only visible if you are on a remote site. The URL of the server to synchronise with, including the port number if necessary. Only visible if you are on a remote site. The URL of the server to synchronise with, including the port number if necessary.
 +
 +=== Open mSupply Central Server Settings ===
 +<WRAP center round important 60%>
 +In mSupply v7.14.00 we've added configuration for open mSupply central server, which is required for open mSupply remote site from v2.0.0 **Open mSupply Central Server Settings** are used to identify a site as open mSupply central server
 +</WRAP>
 +
 +{{:synchronisation:screenshot_2024-04-23_at_10.20.50_pm.png?600|}}
 +
 +=== Site is open mSupply central server === 
 +
 +Only editable when site is not active on mSupply central server. Only one site can be set as open mSupply central server, an error will be shown if you try to set this site as open mSupply central server (the site that is set as open mSupply central server will be shown in the error alert). 
 +
 +=== Open mSupply central server url ===
 +
 +A url which points to this open mSupply central server site. This url will be sent to all open mSupply remote sites on every sync iteration, open mSupply remote site will in turn use this url to synchronise with open mSupply central server. This url can be changed if open mSupply central server site is relocated 
 +
 ==== Adding stores ==== ==== Adding stores ====
 **Note:** You can only add a single store to a //mobile// type site. If you try to add another mSupply will show you an alert telling you that you can't add another. **Note:** You can only add a single store to a //mobile// type site. If you try to add another mSupply will show you an alert telling you that you can't add another.
Line 132: Line 151:
 When editing an existing site, all store data of any added stores will automatically be queued to sync to the remote site after pressing OK to save the changes. When editing an existing site, all store data of any added stores will automatically be queued to sync to the remote site after pressing OK to save the changes.
  
-==== Removing stores (to the Central Server site) ====+==== Removing stores to the Central Server site ====
  
-To remove a store, highlight the store you wish to remove in the list of stores in the Site window, then press the //Remote store// button.+To remove a store, highlight the store you wish to remove in the list of stores in the Site window, then press the //Remove store// button.
  
 Stores removed from a remote site will automatically be moved to the Central Server site.  Stores removed from a remote site will automatically be moved to the Central Server site. 
  • Last modified: 2023/09/20 00:55
  • by Mark Glover