Versions Compared

Old Version 62

changes.mady.by.user Robin Selwitz

Saved on

compared with

New Version Current

changes.mady.by.user Gillian Javetski

Saved on

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

The following set of instructions will guide you from a new mobile phone just out of the box to a mobile phone ready to run your CommCare application. Instructions concerning the menu of the mobile phone assume that you are using the Nokia 2700 Classic – exact menu settings may differ on other phone models. The steps covered for each method should be followed exactly for successful installation. 

...

Please note: A more simplified versions of these instructions can be found here. If you encounter any difficulties installing CommCare using these simplified instructions, please proceed with the instructions found on this page.

...

CommCareHQ is most compatible with the Google Chrome web browser. Please download Chrome here.  

This video will walk you through the installation steps. Detailed instructions are below.

Widget Connector
urlhttps://www.youtube.com/watch?v=qYcO3JVqGWU

Step 1: Set the Phone Date

Set the date of your phone to any date before Nov 2015 after Nov 2013. For example, set the date to be October 1, 2015.

(The last step of the install process is to correctly set the date again, but this step is necessary for the install process to work).

Step 2: Installing the Application

Option 1: Install from Application Files
  1. Login to your domain. Click on the "Applications" menu. Click on your Application that you would like to download and install. Navigate to the Release Manager.
  2. Locate the version number that will be used for deployment. 
  3. Click on the "deploy" button.

  4. Choose "Download to Java Phone"
     
  5.  Download the .jar and .jad files.  Ensure they both have the same name (e.g. CommCare.jad and CommCare.jar, not CommCare (1).jad and CommCare.jar). The size of the jar file should be around 700 kb. The size of the jad file should be around 6-8kb. Usually these files will be saved to the 'Downloads' folder on your computer. 
  6. Connect your phone to your computer.  You can do this in a variety of ways:
    1. Option 1: Bluetooth
      1. Turn Bluetooth ON: Menu->Settings->Connectivity->Bluetooth->Bluetooth->On->Yes
      2. Change the phone's bluetooth name to something unique: Menu->Settings->Connectivity->Bluetooth->My phone's name->[enter name]->Ok
      3. Ensure bluetooth is enabled on your computer.
    2. Option 2: USB Cable 
      1. Connect your phone to your computer using the USB cable (usually the phones come with one)
      2. If a pop-up screen says "Select USB Mode," select "Data Storage." 
      3. Open the folder on your computer that represents the phone
    3. Option 3: MicroSD Card (Requires an SD card adapter)
      1. Remove the MicroSD card from your phone
      2. Put the MicroSD card into your computer's card reader (you may need an SD card adapter)
      3. Open the folder on your computer that represents the MicroSD card
  7. Copy the files from your computer to the phone's SD card.  If you have correctly connected your phone to the computer, the SD card should show up as a folder under My Computer.
    1. If you removed the SD card from your phone, put the MicroSD card back into your phone.
Option 2: Send to Phones via SMS
  1. Ensure the phone has GPRS connectivity and data credit
  2. Delete any existing CommCare apps from your phone's local memory
  3. Login to your domain. Click on the "Applications" menu. Navigate to the Release Manager.
  4. Locate the version number that will be used for deployment. 
  5. Click on the "deploy" button.
  6. Select "Send to Phones by SMS"
  7. Type the phone number of the phone and hit "Send"
  8. The phone should receive a text message.  Open it, and click the link in the message.  
  9. Scroll down using the center button and until the selection is on the bit.ly link.
  10. Click on the center key or ‘Use’ to open the link.
  11. The phone will ask whether you would like to go to this web address. Select “Go to” and hit the center key.
  12. The Opera Mini mobile internet browser should open. Please wait a few moments while the phone connects to the internet. You should see an ‘E’ or ‘G’ symbol in a box in the top left hand corner of the screen if the network coverage is excellent or good. Network coverage needs to be present and stable in order for a user to successfully download the full application directly to their phone.
  13. Once loaded, the CommCare download should appear which displays the CommCare.jad file. The “Open” button will be already selected in blue. Press the center key to start downloading.
  14. The phone will start loading the information it needs to download the application.
  15. The phone will display an application notification asking you to ‘Accept’ and confirm the application download. Hit the center key to ‘Accept.’
  16. The phone will then begin to download the application via GPRS connection. This process could take hours to several seconds depending on the network connectivity.
  17. Once the download is complete, you will be asked if you want to close the browser and open the application. Hit the center key to answer ‘Yes’.
  18. You will be asked if you want to allow editing and adding data. This is one of the three application permissions that need to be set. You may answer ‘Yes’ for now and then return to complete the final application settings.
  19. CommCare should initialize, load resources and start-up correctly.
  20. If the application is downloaded using this method, the application automatically downloads into the ‘Games’ folder in the ‘Applications’ folder.
  21. Accept all download confirmations.
Option 3: Phone to Phone Installation

You can install a CommCare application from one phone to another without the need of a computer or Nokia software. This process is especially valuable if the application needs be re-installed in the field. Refer to the full tutorial here: Phone2Phone Installation.

Step 3: Installing Multimedia 


Option 1: Source not on multimedia media manager

  1. Connect your phone to your computer (see Install Option 1 item 6 for details)
  2. Open the Memory card.
  3. Copy the multimedia folder from the computer into the phone's memory card.  The multimedia folder must be in the top-level directory/the main memory card folder.
  4. OR, if your multimedia has been uploaded to the Multimedia Manager, you can download the media from CommCareHQ directly. 

Option 2: Source is multimedia media manager 

To download multimedia from CommCareHQ follow below steps. You can read more about the multimedia manager here. 
  1. From the Release Manager, click on Deploy. 
  2. In the pop-up window, click on Download Multimedia
  3. If you see an orange button that says 'Download Incomplete Multimedia' it means the media associated with this application has not been uploaded to the Multimedia Manager in CommCareHQ. 

    This means that the application is missing references, so this zip will be incomplete. Please make sure all of your application's multimedia references are linked to media files before starting your Application, or it might be unstable. Please ask your application builder for these files and follow option 1 steps to install the media. 

  4. Click on Download ZIP. The file will be downloaded as a ZIP and you will have to unzip the file in order to use it.  By storing and transmitting it as a ZIP is a good idea so that you don't lose any of those media files!

Step 4: Store CommCare on local phone memory

We recommend storing CommCare from the phone's local memory because it's much easier to manage phone settings and it is safer and more secure opposed to storing the application in the memory card.  If you installed via SMS the application will already be on local phone memory.

  1. To move CommCare files from the SD card to the phone’s memory, access the SD card on the phone’s “Applications” menu.
  2. Scroll to the application file called “CommCare”. This is the file which displays the CommCare logo.
  3. Press “Options” which is the left soft key button.
  4. Select “Move”.
  5. Now, you can select the location where you want to put the CommCare application. 
  6. You may transfer the application file to either the Games or Collections folder. Select the “Games” folder OR select “Collections” folder. Keep the folder you choose consistent for all users.

...