Differences
This shows you the differences between two versions of the page.
Both sides previous revision Previous revision Next revision | Previous revision Next revisionBoth sides next revision | ||
preferences:synchronisation [2019/09/21 11:29] – lou | preferences:synchronisation [2023/04/07 08:05] – [16.07. Synchronisation preferences] Gary Willetts | ||
---|---|---|---|
Line 1: | Line 1: | ||
{{indexmenu_n> | {{indexmenu_n> | ||
- | ===== 13.07. Synchronisation ===== | + | ====== 16.07. Synchronisation |
<WRAP center round important 90%> | <WRAP center round important 90%> | ||
* Synchronisation preferences are only relevant for a [[other_stuff: | * Synchronisation preferences are only relevant for a [[other_stuff: | ||
* These preferences can be safely ignored if you have a stand-alone mSupply installation, | * These preferences can be safely ignored if you have a stand-alone mSupply installation, | ||
+ | * These settings will normally only be changed by Sustainable Solutions. They are not intended for general use by mSupply users. | ||
+ | * This settings tab has been removed in versions 5.07 and later of mSupply. If it is missing then the synchronisation settings are accessed from the **Synchronisation** icon on the //Special// tab of the Navigator. See the [[synchronisation: | ||
</ | </ | ||
- | Note that the main page describing | + | To view the synchronisation |
- | Synchronization is the process whereby mSupply maintains data integrity between a ' | + | {{ : |
- | * The primary server | + | When you first arrive at this window, all fields |
- | * The primary server can be configured to maintain | + | |
- | | + | |
- | | + | |
- | {{ :preferences: | + | ===== Unlocking the settings for editing ===== |
+ | Click on the **Click to un-lock** button and this window will open: | ||
- | ====General==== | + | {{ : |
- | These settings will normally only be changed by Sustainable Solutions. They are not intended for general use by customers. | + | |
- | **Click to Un-lock button:** Altering these preferences can have serious consequences for your mSupply(r) data so they are protected by an authorisation code. Click on the 'Click to Un-lock' | + | Enter your unlocking code in the **Authorisation code** field and click on the **OK** button. |
- | **Sync | + | ===== The preferences ===== |
+ | * **This site:** these fields contain the settings for the sync site this datafile belongs to | ||
+ | * **Sync | ||
+ | * **Sync | ||
+ | * **Sync request size:** the number of requests | ||
+ | * **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 | ||
+ | * **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. | ||
- | ====Synchronize | + | ==== Synchronise |
+ | 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 in this table. If this is a satellite server then the primary server only will be identified in here. | ||
- | **Sync ID:** The ID of the current store to use in the synchronization process. You choose | + | Sometimes there can be hundreds |
+ | === Editing an existing row === | ||
+ | Double-click on a row to edit its details. This window will open: | ||
+ | {{ : | ||
- | **User name:** Communication between the primary and satellite servers is authenticated. This user name and the password | + | * **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: | ||
+ | * **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. | ||
- | **Password:** See above. | + | |
- | **Sync | + | === Adding a site === |
+ | To add a new site to sync with, click on the {{:barcode_scanning: | ||
- | {{ :preferences:sync_prefs_user.png |}} | + | === Deleting a site === |
+ | To delete a site from the list, simply click on it to select it and click on the {{:dispensing:delete_button.png?20|}} button to the right of the list. | ||
- | 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 ' | ||
+ | \\ | ||
+ | \\ | ||
+ | | // Previous: | ||
- | // Previous: | ||
---- struct data ---- | ---- struct data ---- | ||
+ | pagestatus.status | ||
---- | ---- | ||