Differences
This shows you the differences between two versions of the page.
Both sides previous revision Previous revision Next revision | Previous revision | ||
preferences:synchronisation [2020/09/23 05:01] – [Editing sync preferences] Mark Glover | preferences:synchronisation [2023/12/04 02:32] (current) – [The preferences] Kahn Wynyard | ||
---|---|---|---|
Line 1: | Line 1: | ||
{{indexmenu_n> | {{indexmenu_n> | ||
- | ====== | + | ====== |
<WRAP center round important 90%> | <WRAP center round important 90%> | ||
- | * Synchronisation | + | * The preferences |
- | * These preferences can be safely ignored if you have a stand-alone | + | * In a [[synchronisation:introduction|synced system]] |
+ | * There are some settings that are 'per store' - refer [[other_stuff: | ||
</ | </ | ||
- | ==== Admin > Preferences | + | To view the synchronisation settings choose // |
- | {{ :preferences: | + | |
- | <WRAP center round alert 60%> | + | {{ : |
- | These settings will normally only be changed by Sustainable Solutions. They are not intended for general use by mSupply users. Documentation here is for reference only. | + | |
- | </ | + | |
- | ==== Editing | + | When you first arrive at this window, all fields will normally be disabled. If this is a datafile for a correctly configured |
- | **Sync time interval:** This is the time interval in minutes between requests for new information that the satellite servers make to the primary server. <WRAP center round tip 60%> | + | |
- | Setting this to '' | + | |
- | </ | + | |
- | Any user with permission to edit preferences can edit the sync time interval. | + | |
- | **Click to Un-lock button:** Altering these preferences can have serious consequences for your mSupply(r) data so the remaining synchronisation preferences are protected by an authorisation code. Click on the 'Click to Un-lock' | + | ===== Unlocking the settings for editing ===== |
+ | Click on the **Click to un-lock** button and this window will open: | ||
- | ==== Synchronize parameters | + | {{ : |
- | * **Sync ID:** The ID of the current store to use in the synchronization process. You choose this - it MUST be unique to each store to be synchronized. ID 1 is reserved for the primary server (so, if this is the primary server put 1 in here). | + | |
- | * **User name:** Communication between the primary and satellite servers is authenticated. This user name and the password | + | Enter your unlocking code in the **Authorisation code** field and click on the **OK** button. If the code you enter is valid, the various fields and buttons will be unlocked for editing and using, otherwise you will be told that the code is invalid and everything will remain read-only. |
+ | |||
+ | |||
+ | ===== The preferences ===== | ||
+ | | ||
+ | | ||
+ | * **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. | ||
+ | * **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. | ||
+ | |||
+ | ==== Synchronise parameters section ==== | ||
+ | This list contains the names of all the sites to synchronise with. If this is the primary server all the satellite servers will be identified | ||
+ | |||
+ | Sometimes there can be hundreds of sites in this list. To find the one you're interested in, you can click on the column headers to order the list by them (click again to reverse the sort order - same as with most columns throughout mSupply) or enter a site sync ID or user name in the field just above the list to reduce the list to those with an ID or user name starting with what you have entered. | ||
+ | |||
+ | === Editing an existing row === | ||
+ | Double-click on a row to edit its details. This window will open: | ||
+ | |||
+ | {{ : | ||
+ | |||
+ | * **Sync ID:** The ID of the site in the synchronisation system. You choose this; it MUST be unique to each site to be synchronised. ID 1 is reserved for the primary server (so, if this is the primary server put 1 in here). | ||
+ | * **User name:** Communication between the primary and satellite servers is authenticated. This user name and the **Password** | ||
* **Password: | * **Password: | ||
- | * **Sync | + | * **URL:** On a remote site, this should be the central server' |
+ | * **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: | ||
+ | * **New button:** Clicking this will create sync out records for system and transactional data (users, preferences, | ||
+ | * **Existing button:** Clicking this will create sync out records for store data only. | ||
+ | |||
+ | * **Retrieve sync records button:** Does a manual pull of sync records waiting for this site on the primary server. | ||
- | {{ :preferences:sync_prefs_user.png |}} | + | === Adding a site === |
+ | To add a new site to sync with, click on the {{:barcode_scanning:add_icon.png?20|}} button to the right of the list. That will open the same window as editing a row but it will be empty, ready for you to enter the appropriate values. | ||
- | This list contains the names of the servers to synchronize with. If this is the primary server all the satellite servers will be identified in this table. If this is a satellite server then the primary server only will be identified in here. Click on the ' | + | === Deleting |
+ | To delete | ||