> ## Documentation Index
> Fetch the complete documentation index at: https://docs.pro.commure.com/llms.txt
> Use this file to discover all available pages before exploring further.
# Installing Commure Pro on Your Device
> The Commure Pro on Android™ application uses an Over-The-Air (OTA) installation.
The Commure Pro on Android™ application uses an Over-The-Air (OTA) installation. No physical connection to a computer is required to install Commure Pro on an Android device. This installation can be performed by a provider (the end-user) or an administrator.
Your system administrator provides you with the following information:
* The written web address, or a link to the web address (usually via e-mail), where you can download the application.
* Information to correctly fill out the **Host**, **Username**, and **Password** fields on the Login screen.
## Installing the Commure Pro Application
To install the Commure Pro on Android application on your device, follow these steps:
1. Enable your Internet browser to install non-Market applications by following these steps:
1. Go to **Settings**, tap into the **Search** field at the top of the screen and search for "install unknown apps."
2. Select the **Install unknown apps** option.
3. From the list of apps, select the Internet browser that you use (for example, Chrome).
4. Turn on the **Allow from this source** option.
2. On your Android device, access the web address for installing Commure Pro (provided by your system administrator). Typically, this is the organization’s Commure Pro web address followed by "/ota." For example:
[https://generalhospital.commure.com/ota](https://generalhospital.commure.com/ota)
This information may be provided to you in one of two ways:
* The web address may be sent to you as a link in an e-mail: Open the Mail application on your Android device and tap the link in the e-mail. If the e-mail was not sent to the e-mail account that you use on your Android device, you can always forward it to that e-mail address, so that you can open it on the device.
* The web address may be provided to you in written format: Open the Internet browser on your Android device and type the web address in the address line.
Depending on the Internet browser installed on your device, as well as whether or not you have downloaded previous versions of Commure Pro, one of the following messages is displayed at the bottom of the screen:
* "*This type of file can harm your device. Do you want to keep Commure Pro.apk anyway?*" Select **OK**.
* "*Do you want to download Commure Pro.apk again?*" Select **Download**.
If you have installed the Commure Pro more than once on your device, the "*Commure Pro.apk*" in the message may be incremented with a number, as in "*Commure Pro-2.apk*." Or, you may see this additional message: "*Do you want to replace the existing Commure Pro.apk" in Downloads*?" Select the **Replace File** button.
The Commure Pro application begins to download to your device and a **Download Arrow** is displayed in the top banner of the screen.
3. Touch the top banner of the screen and drag your finger down to view the Notifications list and watch the progress of the download.
4. Once the download is complete, tap the **Commure Pro.apk** (or **Commure Pro-n.apk**) download notification from the Notifications list.
As an alternative to Steps 3 and 4, you can wait for the download to complete. It will then display a notification at the bottom of the screen stating: "*CommurePro.apk downloaded*" with an **OPEN** button. Tap **OPEN**. (If you miss the notification, you can go to the **Files** or **My Files** application and then select the **Commure Pro.apk** file from there.)
The following message appears: "*Commure Pro. Do you want to install this application? It does not require any special access*." Please note that the Commure Pro application is free.
5. Tap **INSTALL** 
The following messages are displayed: "*Installing. App installed."*
6. Tap **OPEN** to immediately launch the Commure Pro application.
The Commure Pro Login screen appears.
If you accidentally select **DONE** instead of **OPEN**, you can tap the device’s **Home** button, swipe up to view your list of applications, and then select the **Commure Pro** icon to launch the application.
7. To finish the installation, follow the steps in *[Logging in the First Time Using Basic Mode (Provisioning the Device)](../get_started/logging-in-and-out#logging-in-the-first-time-using-basic-mode-provisioning-the-device)*. Or if you are an advanced user, you can follow these instructions instead: *[Logging in the First Time Using Advanced Mode (Provisioning the Device)](../get_started/logging-in-and-out#logging-in-the-first-time-using-advanced-mode-provisioning-the-device)*.
## Clearing Data from a Device
In certain scenarios, you may want to clear all of the Commure Pro data from a device. For example, if the institution owns the device, and would like to temporarily or permanently take the device out of service, you can clear the data on the device. Clearing a device removes all user and patient data (including unsubmitted data such as orders), but does not remove the Commure Pro application itself. You must have the physical device in hand in order to clear data.
To clear all user and patient data from a device, follow the steps below.
Select the **Commure Pro** icon . The Login screen is displayed.
Select the **Settings** button, located in the upper right corner. The Settings screen is displayed.
Select the **Clear Data** option. The following message is displayed: "*Clear Data. Do you want to clear all the data from this device?*"
Select Yes. All data is cleared from the device and the Login screen is displayed.
## Reprovisioning a Device for a New User
In some cases, you may want to reprovision a device. For example, if the institution owns the device, and would like to transfer it to a new user because the previous user has left, you can reprovision it. Or if you want to change the host (server) to which the device is connected, you can reprovision it. When you reprovision a device, it removes all user and patient data, but does not remove the Commure Pro application itself. It then assigns a new user to the device and downloads a fresh set of patient data. You must have the physical device in hand in order to reprovision it.
To reprovision (re-assign) the device to a new user, or to change the host to which the device is connected, follow the steps below.
1. Select the **Commure Pro** icon .
The Login screen is displayed. It shows the last used **Host** and **Username**.
2. Tap into the **Host** and/or **Username** field(s) and clear the current value in the field(s). Then enter the new value(s) for the field(s).
* Host: Address of the Commure Pro Application Server. For example:
generalhospital.commure.com
* **Username**: The provider’s Commure Pro username.
The following message is displayed: "\[*Host* or *User Name*]\* Changed. Changing the\* \[*host *or* user name*]\* will require this device to be reprovisioned. Do you want to continue?"\*
3. Select **Continue**.
4. In the **Password** field, enter the provider’s Commure Pro password.
* Select the **Login** button on the screen, or **Go** key (on the keyboard) .
The system authenticates the login information and following messages are displayed: "*Provisioning. Logging in. Synchronizing.*"
5. If PIN authentication has been enabled, follow the instructions in [Step 2](../get_started/logging-in-and-out#establishing-a-pin-for-logging-in), in the section entitled *[Establishing a PIN for Logging In](../get_started/logging-in-and-out#establishing-a-pin-for-logging-in)* to possibly establish a PIN at this time.
The Patient List screen is displayed. The device is now ready for the provider to start using the application. Please consult the appropriate Commure Pro quick reference card for instructions on using the application.
## Upgrading the Commure Pro Application
There are three components involved in the syncing of Android devices to a Commure Pro application server:
* The Commure Pro on Android™ application version that resides on the Android device.
* The Commure Pro on Android™ application version that resides on the Commure Pro application server.
* The Commure Pro application server version (a.k.a, the mobilizer version).
The Commure Pro application server (mobilizer) version is *not* required to be the same as the Commure Pro Android application version that resides on the device or on the server. Differences here will not trigger an upgrade of the Commure Pro Android application, nor prevent syncing.
Differences in the Commure Pro Android application version that resides on the device versus the Commure Pro Android application version that resides on the server *may* trigger an upgrade. When an Android device syncs to the Commure Pro application server, the device’s Commure Pro Android application version is checked:
* If the version that resides on the device is *older* than the one that resides on the server, the device is forced to undergo an upgrade to the same version that is installed on the server. During this process, the user is notified that an upgrade is required, the APK (installation files) from the server are automatically downloaded to the device, and the user is walked through the installation process (this process is described below). The user is not allowed to use the Commure Pro application or sync to the server unless they complete this process.
* If the version that resides on the device is *newer* than the one the resides on the server, the device simply syncs as normal. Any new or fixed features in the newer Commure Pro Android application that are compatible with the Commure Pro application server (the mobilizer) will work, while any new features that require a newer server version will be disabled.
The scenario in the second bullet above is rare and would typically occur in situations where a provider works at more than one organization that uses Commure Pro, and the two organizations are using different versions of the Commure Pro Android application. In this case, when the user changes the value in the **Host** field to sync to one organization versus another, the Commure Pro application is upgraded (or the device just syncs) as described in the two bullets above.
During the initial installation or an upgrade of the Commure Pro application server, your Commure Pro representative will install the appropriate Commure Pro Android application version on the server (for information on how the Android application software is loaded on the Commure Pro application server, please see the Commure Pro Administrator help (**Manage Handheld Modules \[Edit]** setting). Commure Pro may also release updated versions of the Android application that contain bug fixes or enhancements, *without a matching server release*. Your system administrator can request that the newer version of the Android application be installed on your server by Commure Pro staff. As described above, the next time each Android device syncs to the server, the device’s Commure Pro Android application version will be checked against the one that resides on the server, and if it is found to be older, this will trigger an upgrade of the Commure Pro application on the device.
If the Commure Pro Android application on an Android device requires an upgrade per one of the scenarios described above, the process below occurs. Please note that the *first* upgrade after the Commure Pro application was initially installed has a few extra steps (Steps 2 and 4), but in subsequent upgrades, those steps are skipped.
1. When a user logs into the Commure Pro application on their Android device, or the next time the device syncs, the server checks the version that is running on the device. If an upgrade is required, the upgrade process is initiated.
2. If this is the *first* time the device has been upgraded, the following message is displayed: "*Allow Commure Pro to access photos, media, and files on your device?*" Select **ALLOW**.
If you accidentally select **DENY**, the application will not upgrade and may get stuck in the syncing process. Shut down the application and log in again.
* If the message above displayed again, choose **ALLOW** this time and proceed with the remaining steps.
* If the application gets stuck in the syncing process a second time, you must shut down the application, uninstall it, and then reinstall it using the process described in *[Installing the Commure Pro Application](../get_started/installing-commure-pro-application#installing-the-commure-pro-application)* (you will get the updated version of the Commure Pro application when you do so).
3. The following message is displayed: "*Your Commure Pro app is out of date. Please wait while the app is upgraded.*" A progress bar is displayed while the latest application is automatically downloaded to the device.
4. If this is the *first* time the device has been upgraded, the following message is now displayed: "*Commure Pro. For your security, your phone is not allowed to install unknown apps from this source.*" Select **SETTINGS**, which brings you to the Install Unknown Apps setting for the Commure Pro application. Set the **Allow from this source** setting to **ON**, to enable the Commure Pro application to install upgrades on your device. Then tap **Back** on your device to return to the Commure Pro upgrade process.
If you accidentally select **CANCEL**, the upgrade will not install and the device will do one of the following:
* It will immediately start over again at Step 3, or...
* It will display this message: "*Provisioning Failed. You are attempting to log in with an incorrect version. Please check your device for pending updates or contact your system administrator.*" Tap **OK** and then log into the Commure Pro application again. The upgrade process will start over at Step 3.
This time, choose **SETTINGS** when you get to Step 4.5. The following message is displayed: "*Commure Pro. Do you want to install an update to this existing application? Your existing data will not be lost. It does not require any special access.*" Select the **INSTALL** button.
6. The following messages are displayed: "*Commure Pro. Installing. App installed.*"
7. Select the **OPEN** button to immediately log into the Commure Pro application and start using it. Or, select the **DONE** button to display the Android Home screen (you can launch the Commure Pro application at a later time by tapping the **Commure Pro** application icon).
## Uninstalling the Commure Pro Application
To remove the Commure Pro application from an Android™ device, along with all of its associated user and patient data, follow these steps:
If the Commure Pro application is open, close it by pressing the **More** button and then choosing **Exit**.
Select the Android device’s **Settings** option, and then select the **Apps** option. A list of applications is displayed.
Select **Commure Pro**. Information about the Commure Pro application is displayed.
Select the **Uninstall** button. The following message is displayed: "*Commure Pro. Do you want to uninstall this app?*"
Select **OK** to uninstall the Commure Pro application. The following messages are displayed: "*Uninstalling.Uninstall finished.*"
Select the **Home** button to return to the Home screen.