Getting Started - Quick Guide
This document provides information for downloading and installing the Database Mobile Server (DMS) and its dependencies. DMS uses a middle-tier application server to communicate between the mobile clients and the backend Oracle database. Different application servers are supported for DMS, including WebLogic Server, Oracle Glassfish, Glassfish Server Open Source Edition and Apache TomEE.
This Getting Started Guide demonstrates the following:
How to install DMS on top of Oracle Glassfish server on a Windows platform
How to create a publication using Mobile Development Workbench
How to publish the Transport Application to the Mobile Server
How to run the Transport Application on the client device
See the sections below:
The following sections provide information on the transport demo and how to publish the transport application:
You should use a supported JDK for DMS install. For information on what JDK to use, refer to Section 4.3.2 JDK Platform Support in the Installation Guide.
To download JDK, go to:
Double click on the "Installation Executable" and go through the required installation steps. By default, after the installation, you can find the JDK in C:\Program Files (x86)\Java on a 32-bit Windows platform or C:\Program Files\Java on a 64-bit Windows platform.
Install and run the following products:
Oracle Database Express Edition (Oracle Database XE):
Oracle Glassfish 3.1:
Note:To install and run all the above products, first, you need to install the latest JDK 7 or JDK 8.
To install Oracle Database XE, follow the steps below:
Extract Oracle Database XE ZIP package in the current directory.You will get directory DISK1. Double click DISK1\setup.exe to install Oracle XE (see, Figure 1).
On the "License Agreement" screen, choose "I accept the terms in the license agreement", then click "Next", as seen in Figure 2.
On the "Choose Destination Location" screen, click "Browse…" to select the path to install Oracle Database XE, as shown in Figure 3.
On the "Specify Database Password" screen, enter password for both the SYS and the SYSTEM database accounts, as shown in Figure 4. Keep note of these as they will be required throughout the rest of the DMS setup process.
The "Summary" page shows current installation setting (before proceeding with the installation), as shown in Figure 5. If all the settings are as expected, click "Install" to start the installation, as shown in Figure 6.
End of installation, click "Finish", as shown in Figure 7.
After installation, the Install Wizard will create a shortcut on the desktop, as shown in Figure 8.
Double click this shortcut and it will run the default internet browser and show the home page of Oracle Database XE, as shown in Figure 9. Click the link on the home page to check the status of database.
To install Oracle Glassfish server, follow the steps below:
Double click Oracle Glassfish installation executable file to start installation. On the "Introduction" page, click "Next" to proceed (see, Figure 10).
Choose "Installation Type". Here, we choose the default type "Typical Installation", as seen in Figure 11.
On the "Install Directory" screen, click the "…" button to select the path to install Oracle Glassfish. Click "Next" as shown in Figure 12.
On the "Update Tool" screen, you can check for Oracle Glassfish updates periodically or you can disable it, as shown in Figure 13.
The "Ready To Install" screen shows the current installation setting before proceeding with the installation, as shown in Figure 14.
The installation process begins, as shown in Figure 15.
Configure the Oracle Glassfish administration settings. See Figure 16.
Refer to Section 188.8.131.52 "Installation of the Mobile Server" in the Oracle Database Mobile Server Installation Guide for instructions on how to install Database Mobile Server.
Note:During the installation of Database Mobile Server you must do the following:
On the Specify Application Server Home screen, select the installation directory of your Oracle Glassfish server installation.
On the Please Provide the Repository Database Information screen, provide the URL of the Oracle Database XE you have installed.
On the Enter Database Administrator Account Information page, you can use the user SYSTEM created during the installation of Oracle Database XE, since it has database administrative privileges.
After you have installed Database Mobile Server, run <ORACLE_HOME>\Mobile\Server\bin\runmobileserver.bat to start the server, where <ORACLE_HOME> is the Oracle Home where you have installed the Database Mobile Server.
To verify your installation, open your browser, input Mobile Server URL http://<Mobile_Server_hostname>:<port>/mobile, and check that the Mobile Manager login page is displayed, as shown in Figure 19.
Log on to the Mobile Manager with the Mobile Server Administrator user name and password and the Mobile Server Farm Page is displayed, as shown in Figure 20.
If DMS is not running, you will see an error page: "The webpage cannot be displayed or Unable to Connect". Start the DMS and refresh the page.
Refer to Section 184.108.40.206 "Installation of Mobile Development Kit" in the Oracle Database Mobile Server Installation Guide for instructions on how to install Mobile Development Kit.
Once DMS and MDK are installed, you are ready to move on to the next step - the application development and deployment models.For more information, see your mobile client platform-specific version of the Transport demo tutorial included in the MDK:
For Win32/WinCE: <ORACLE_HOME>\Mobile\Sdk\samples\dotnet\bdb\transport\doc\Transport Tutorial.doc
For Android: <ORACLE_ HOME>\Mobile\Sdk\samples\android\ transport\Transport Tutorial.pdf
For iOS: <ORACLE_HOME>\Mobile\Sdk\samples\ios\ transport\Transport Tutorial.pdf
Follow the steps below to publish the Transport Application:
Create the Application Schema and data in back-end Oracle Database XE.
Create a Mobile Server publication for the application data using the MDW - a GUI publication tool included in the MDK.
Create the Transport application for your device platform.
Publish the Transport application to Mobile Server using the Packaging Wizard.
Create mobile users using the Mobile Manager.
Grant user access to the Transport application using the Mobile Manager - DMS online administrative console.
Install mobile client on your device, download the Transport application to your device, and synchronize data between the Transport application and back-end Oracle Database.
For information about Oracle's commitment to accessibility, visit the Oracle Accessibility Program website at
Oracle customers that have purchased support have access to electronic support through My Oracle Support. For information, visit
http://www.oracle.com/pls/topic/lookup?ctx=acc&id=info or visit
http://www.oracle.com/pls/topic/lookup?ctx=acc&id=trs if you are hearing impaired.
Oracle Database Mobile Server Getting Started Guide, Release 12.1.0
Copyright © 2014, 2015, Oracle and/or its affiliates. All rights reserved.
This software and related documentation are provided under a license agreement containing restrictions on use and disclosure and are protected by intellectual property laws. Except as expressly permitted in your license agreement or allowed by law, you may not use, copy, reproduce, translate, broadcast, modify, license, transmit, distribute, exhibit, perform, publish, or display any part, in any form, or by any means. Reverse engineering, disassembly, or decompilation of this software, unless required by law for interoperability, is prohibited.
The information contained herein is subject to change without notice and is not warranted to be error-free. If you find any errors, please report them to us in writing.
If this is software or related documentation that is delivered to the U.S. Government or anyone licensing it on behalf of the U.S. Government, then the following notice is applicable:
U.S. GOVERNMENT END USERS: Oracle programs, including any operating system, integrated software, any programs installed on the hardware, and/or documentation, delivered to U.S. Government end users are "commercial computer software" pursuant to the applicable Federal Acquisition Regulation and agency-specific supplemental regulations. As such, use, duplication, disclosure, modification, and adaptation of the programs, including any operating system, integrated software, any programs installed on the hardware, and/or documentation, shall be subject to license terms and license restrictions applicable to the programs. No other rights are granted to the U.S. Government.
This software or hardware is developed for general use in a variety of information management applications. It is not developed or intended for use in any inherently dangerous applications, including applications that may create a risk of personal injury. If you use this software or hardware in dangerous applications, then you shall be responsible to take all appropriate fail-safe, backup, redundancy, and other measures to ensure its safe use. Oracle Corporation and its affiliates disclaim any liability for any damages caused by use of this software or hardware in dangerous applications.
Oracle and Java are registered trademarks of Oracle and/or its affiliates. Other names may be trademarks of their respective owners.
Intel and Intel Xeon are trademarks or registered trademarks of Intel Corporation. All SPARC trademarks are used under license and are trademarks or registered trademarks of SPARC International, Inc. AMD, Opteron, the AMD logo, and the AMD Opteron logo are trademarks or registered trademarks of Advanced Micro Devices. UNIX is a registered trademark of The Open Group.
This software or hardware and documentation may provide access to or information about content, products, and services from third parties. Oracle Corporation and its affiliates are not responsible for and expressly disclaim all warranties of any kind with respect to third-party content, products, and services unless otherwise set forth in an applicable agreement between you and Oracle. Oracle Corporation and its affiliates will not be responsible for any loss, costs, or damages incurred due to your access to or use of third-party content, products, or services, except as set forth in an applicable agreement between you and Oracle.