Server Management App

The Server Management App is a new feature introduced to MacPractice Build 12.11. We'll cover the purpose of the Server Management App, the changes that will consequently be coming to MacPractice, and the functionality contained within that will benefit you and your office.

If you have any questions that aren't answered in this article, please reach out to MacPractice Support and we'll be happy to assist you.

What is the Server Management App?
The Server Management App is a Web Application that is used to manage the processes and database for your MacPractice Server. By utilizing this App, a user will be able to start and restart the MacPractice Server and diagnose whether a process is properly running or not. The functionality of the App will be expanded over time, so please provide us your feedback!

What Benefits Will Users Receive?
Users on MacOS Catalina will no longer need to run the Catalina start up script! 

Server start up times and restart times should be significantly faster.

A user without knowledge of the Activity Monitor will still be able to ascertain whether their MacPractice Server has all processes running.

More to come! 

Getting Started
Before getting started, keep in mind that if you are unsure how to proceed, please contact MacPractice Support and we can assist you. 

The Server Management App can be accessed in three different ways. You must be on the same local network as the MP Server in order to access the Server Management App. You cannot utilize a VPN to bypass this restriction as a security measure.

If the MacPractice software is not running, you can open a web browser and navigate to the following URL:


If you've started MacPractice but are at the login prompt, you can access the Server App by clicking the gear icon on the MacPractice Login Window.


If the MacPractice software is running, you can access the App via the MacPractice Menu:


Creating a Server Administrator User
The first time you access the App, you'll be prompted to create a Server Administrator User. This is not the same as a MacPractice User. Currently, there can only be one Server Administrator User. You'll want to ensure you're on the Server when setting up your first Server Admin User.


After creating the Server Administrator User, you'll be able to log in. On future visits to the App, you'll simply be presented with this login prompt. Simply enter the Login Username and Password that you set for the Server Admin User.


If you forget your password, MacPractice Support can assist you with resetting your password.

Initial Login
Upon first login, you'll be asked to mount the Data Sparsebundle. This simply means you need to enter the security password for the MacPractice database.


Then, you'll be prompted to enter the Database Hostname, which typically is localhost.

IF THIS IS localhost, THEN IT MUST BE ALL LOWERCASE OTHERWISE ERRORS WILL OCCUR. Please note that once you set the Database Hostname, this can't be changed later without complete removal/installation. 


Finally, you'll be asked to "Create a database". This prompt is asking to set what database is currently connected to the App. For most existing users, they'll want to "Select an existing Database", but you can also create or restore a database here as well by using the drop down selector.

You'll need to fill in the Serial Number field with the client's MacPractice license number. Be sure to capitalize the leading letters, for example: MD. 

The Database Name field will reference the practice's Database Name, which in most cases is typically "macpractice".

If the database name is macpractice, it MUST BE LOWER CASE OTHERWISE ERRORS WILL OCCUR.


Interface Overview
When you get logged in, you'll be presented with the Management App interface.


You'll note that the sidebar defaults to the Server Node. This is where you can monitor your processes, determine the mounted status of the sparse bundle, and use the management buttons as necessary to stop and restart processes and the server. It's important to note that as of 7/16, the Change Location button on the Sparsebundle does not currently function.


Any time you interact with one of these stop or restart buttons, a status indicator will appear at the top of the window to indicate that the interface is performing an action.

The Status indicators capture the moment the Server Node is accessed. If you need to verify a process is running, we recommend clicking the refresh button.

Important Note: Spamming any buttons will not improve performance and in some cases may cause technical issues. When you click a button, you should wait for the action to resolve before clicking another.

Database Management
In the Database Management node, there are currently two available options. You can either Validate your Database (this normally happens during Database updates), or you can Restore from a Backup.


Validating your Database is typically done during updates, but can identify and in some cases correct an issue. Typically you won't need to utilize this function unless directed to by MacPractice Support.

Restore From Backup allows you to select a previously created backup which you can then restore your database from. 

Currently the Settings tab only contains a place for the Serial Number. 



Was this article helpful?
0 out of 0 found this helpful