Differences

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

--- admin:automatic_updates [2017/07/19 09:48] – created Gary Willetts
+++ admin:automatic_updates [2025/11/05 03:57] (current) – [25.07. Updating mSupply] Mark Glover
@@ Line 1: / Line 1: @@
+{{indexmenu_n>70}}
+====== 25.07. Updating mSupply ======
+Updates for mSupply are being released frequently.  The method of update varies with the type of mSupply that you have:
+  * The mSupply server must be manually updated by an administrator.  Contact [[support@msupply.foundation]] if you need help.
+  * The mSupply client will update automatically from the mSupply server when it is first opened after a server update - see [[#msupply_client|mSupply client]] below.
+  * mSupply single user can be updated automatically by the user  - see [[#msupply_single_user|mSupply single user]] below.
+==== mSupply client ====
+To automatically update your mSupply client, simply start it running. If it needs an update (because the server has been updated, for example) it will automatically update itself. You will see messages with progress bars describing what's happening. The update process should take less than 5 minutes, depending on the speed of your connection to the mSupply server and the speed of your computer. When the process is complete you'll see the usual mSupply login screen.
-===== Automatic updates =====
+The only thing that can go wrong with this update process is if the connection to the server is broken or the client does not have the necessary permissions to create new files in the directory or folder it is installed. Symptoms of these failures vary from a failure message to the update process beginning then stopping without displaying the mSupply login window.
-Choose **File > Backup **
-This function allows a backup of your datafile to be made to the specified location in your computer.
+==== mSupply single user ====
+mSupply single user is often used in a distributed sync setup where the various copies of mSupply are spread far and wide throughout a country. So the ability to remotely update them can be very useful!
-  * The backup path can be set from //File> Preferences> Backup//.
+Simply choose //Special > Check for updates...// from the menus or click on the **Check for updates** icon on the //Admin// tab of the navigator:
-  * You can perform a backup manually and/or automatically.
-  * It is not necessary to quit the database before performing a backup.
-  * Automatic backup settings are configured in the Preferences chapter. See the section [[preferences:general#Backup]]
-"Backup" function works both in single user as well as multi-user mode. Under multi-user mode, this command performs a backup of the server data. A progress window will show how the backup is proceeding.
+{{ :admin:navigator_updates.png?600 |}}
+mSupply will then check whether there is an update available for your version. If there is, you will be shown the new version and asked whether you want to continue with the update. If you do, mSupply will download it and install it automatically. When the process is finished, you will be asked to restart mSupply for the changes to take effect.
-// Previous: [[admin:tables_fields|Field Descriptions]]     Next: [[admin:user_tasks |Changing users and Passwords]]//
+\\
+\\
+|  //  Previous:  **[[admin:backup_and_restore]]** | | Next: **[[admin:user_tasks]]** //  |
 ---- struct data ----
+pagestatus.status    :
 ----