admin:server_administration

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
admin:server_administration [2019/10/28 20:36] – Emily Porrelloadmin:server_administration [2022/11/29 13:13] (current) – [2. By using a browser] Gary Willetts
Line 1: Line 1:
 {{indexmenu_n>130}} {{indexmenu_n>130}}
-====== 21.13. mSupply server administration ======+====== 25.13. mSupply server administration ====== 
 +mSupply server provides a number of administrative features that enable fine-tuning and robust management of the system.
  
 +The server can run as an application or as a service. Running it as a service has a lot of benefits, such as automatic restart when the server machine is restarted, but, for technical reasons, this is not always possible. Here's how you administer the server depending on how it is running.
  
-mSupply server provides a number of administrative features that enable fine-tuning and robust management of the system. +===== When running the server as an application =====
 === Server monitor=== === Server monitor===
 The server monitor tells us our computer hardware specification, database engine version, and license information including maximum connections The server monitor tells us our computer hardware specification, database engine version, and license information including maximum connections
Line 33: Line 34:
 Decide how many backups to store in your destination folder. You may also set the system to retry backups if a backup is not possible at the scheduled date and time. Eg. if the system is not running. Decide how many backups to store in your destination folder. You may also set the system to retry backups if a backup is not possible at the scheduled date and time. Eg. if the system is not running.
 {{ server_admin-7backup_restore.png?650 }} {{ server_admin-7backup_restore.png?650 }}
 +
 +=== Backup and Memory settings - according to the datafile ===
 +The database backup settings were initially singular but since mSupply v4.14 we have extra options. 
 +On the server Settings menu we have the following options :
 +
 +  * Structure Settings... [This has been widely used]
 +  * User Settings... [This is not frequently used]  
 +  * User Settings for Data file...  [We are now actively using this options]
 +
 +{{ :admin:server_backup_settings.jpg?600 |}}
 +
 +The "User Settings for Data file..." options saves the backup and memory options as a folder and is located next to the data file. 
 +
 +{{ :admin:data_backup_memory_settings_2021-09-14.jpg?400 |}}
 +
 +Above, note that the Settings folder is next to the mSupply data. This setup allows for the mSupply server to be upgraded with backup and memory settings intact.
  
 ===Application server=== ===Application server===
Line 38: Line 55:
 The application server provides settings to manage the structure (.4DC file) and data (.4DD) files. It also provides information about LAN and system memory. The application server provides settings to manage the structure (.4DC file) and data (.4DD) files. It also provides information about LAN and system memory.
 {{ server_admin-8application_server.png?650 }} {{ server_admin-8application_server.png?650 }}
- 
  
 ===Web server=== ===Web server===
Line 44: Line 60:
 The Web server tab shows the web server status and running ports. The web server can be started or stopped form this tab. The Web server tab shows the web server status and running ports. The web server can be started or stopped form this tab.
 {{ server_admin-9web_server.png?650 }} {{ server_admin-9web_server.png?650 }}
 +
 +
 +===== When running the server as a service ====
 +When the mSupply server is running as a service you need to access the monitoring pages shown above in slightly different ways.
 +
 +==== 1. By logging into a client ====
 +For this, open a client and login to mSupply. Then choose //Special > Open mSupply server window// from the menus to see the server administration window open as described above.
 +
 +Please note: to be able to do this, the user must have the //Access server administration// permission as described on the [[admin:managing_users#permissions_tabs|25.15. Managing users]] page.
 +
 +==== 2. By using a browser ====
 +To access the server administration pages from a browser, the mSupply webserver must be running (see the [[web_interface:using_the_web_server|]] page for details on how to turn it on).
 +
 +Then open a browser and enter the mSupply server's URL followed by ''/admin/ini'' e.g. ''%%https://mymSupply.msupply.org:8048/admin/ini%%''
 +
 +A window like this will open in your browser:
 +
 +{{ :admin:pasted:20221129-131037.png?600 |}}
 +
 +Use the tabs down the left hand side to navigate to the different pages which work very similarly to the pages described in the sections above.
 +
  
  
Line 88: Line 125:
 \\ \\
 \\ \\
-|  //  Previous:  **[[admin:dispensary_installation |21.12. mSupply dispensary installation]]** | | Next: **[[admin:deployment |21.14. mSupply deployment]]** //  |+|  //  Previous:  **[[admin:dispensary_installation]]** | | Next: **[[admin:deployment]]** //  |
 ---- struct data ---- ---- struct data ----
 +pagestatus.status    : 
 ---- ----
  
  • Last modified: 2019/10/28 20:36
  • by Emily Porrello