Skip Headers
Oracle® Database Lite Administration and Deployment Guide
10g (10.0.0)
Part No. B12262-01
  Go To Table Of Contents
Contents
Go To Index
Index

Previous
Previous
Next
Next
 

4 Administering Mobile Applications

This document discusses how to administer mobile applications. Topics include:

4.1 Overview

Administering mobile applications includes tasks such as listing your web applications, creating database tables, uploading your applications to the mobile server repository, modifying application properties, and so on. The following sections provide a sequential description of tasks that you must perform to administer mobile applications.

4.2 Listing Applications

This section enables you to list mobile applications. To display a list of applications, login to the Mobile Server and click the Mobile Manager link in the workspace. The Mobile Server Farms page appears. To display your Mobile Server home page, click your Mobile Server link. Click the Applications link. As Figure 4-1 displays, the Applications page lists existing applications and their corresponding virtual path.

Figure 4-1 Applications Page

This image displays the Mobile Server applications page.

To search applications, enter your application name in the Application Name field and click Go. The Applications page displays the search result under the Application Name column.

4.3 Modifying Application Properties

To modify application properties, navigate to the Applications page and click the required Application Name link. As Figure 4-2 displays, the chosen application's page contains application properties and database connectivity details.

Figure 4-2 Application Properties Page

This image displays the application properties page.

As described in Table 4-1, enter the modified application properties in the corresponding fields of the Application Properties and Database Connectivity sections.

Table 4-1 Application Properties Page Description

Field Description
Application Name name of your mobile application
Application Description a brief description of your mobile application
Publication Name publication name of your mobile application
Platform Name Select the appropriate platform name from the platform name list.
Maximum Database Connections number of maximum database connections used by your mobile applications
Database User Name name of the database user
Database Password password of the database user

To retain the modified application properties, click Save.

To remove the application, click Remove.

To reset the Application Properties page, click Reset.

4.4 Suspending Mobile Applications

To suspend mobile applications, navigate to the Properties page and click Suspend. The Mobile Manager seeks your confirmation before suspending the application. Click Yes. You are returned to the applications page. As an indicator, the status field displays "Suspended".

4.5 Resuming Mobile Applications

To resume a mobile application that has been suspended, select the application and click Resume. The Mobile Manager resumes the chosen application.

4.6 Uploading Applications to the Mobile Server Repository

After building mobile applications and packaging them into a .jar file using the Packaging Wizard, you can upload mobile applications to the Mobile Server Repository.

To upload mobile applications into the Mobile Server Repository on the Oracle database server, navigate to the Applications page and select the mobile application. Click Publish Application. As Figure 4-3 displays, the Publish Application page appears.

Figure 4-3 Publish Application Page

This image displays the Publish Application page.

As described in Table 4-2, enter data in the Publish Application page.

Table 4-2 Publish Application Page Description

Field Description
Repository Directory Directory name for your mobile applications. The specified directory name indicates the location of your mobile applications in the Mobile Server Repository. For example, MySample.

Note: If you leave the Repository Directory field blank, the Mobile Server automatically creates a directory using the value of the virtual path of your applications.

JDeveloper WAR File To upload a WAR file, select this option and enter its virtual path in the corresponding field.
Packaging Wizard JAR File To upload a Packaging Wizard JAR file, select this option.
Overwrite the existing application To overwrite existing applications with the same virtual path in the Mobile Server Repository, select the Overwrite the existing application check box.
WAR File To locate the WAR or JAR file, click Browse.

To publish your mobile applications to the Mobile Server Repository, click Upload.

4.6.1 Creating Database Tables

As an Administrator, you must ensure that the relevant database tables exist in the Oracle database before publishing mobile applications. Using the SQL command CREATE TABLE, you can create tables in the Oracle database. Any table that is used for an updatable snapshot must have the PRIMARY KEY constraint.

It is recommended that all records be inserted into your database tables before publishing your mobile application.

4.7 Removing Applications from the Mobile Server

Removing an application from the Mobile Server does not delete all application files and servlets from the Mobile Server system. The application's servlets remain loaded until the last user with access to the Mobile Server applications logs off from the Mobile Server. Once the last user has logged off from the Mobile Server, the administrator can use the shell utility in the Mobile Server and delete all application files.

To remove an application from the Mobile Server, navigate to the Applications page and select the application that you want to remove. Click Delete. The Mobile Manager seeks your confirmation. Click Yes. You are returned to the Applications page.

4.8 Modifying Data Subsetting Parameters

The Mobile Manager enables administrators to view and edit data subsetting parameters in a mobile application. To view and edit data subsetting parameters, navigate to the Applications page and click the application for which you need to view and edit data subsetting parameters. The Applications Properties page appears. Click the Data Subsetting link. As Figure 4-4 displays, the Data Subsetting page appears.

Figure 4-4 Data Subsetting Page

This image displays the Data Subsetting page.

The Data Subsetting page lists user names and their associated platforms. Under the User Name column, click the user's name for whom you would like to set data subsetting parameters. As Figure 4-5 displays, the Data Subsetting Parameters page appears and lists the parameter name and value.

Figure 4-5 Data Subsetting Parameters

This image displays the Data Subsetting Parameters page.

Enter the changed parameter value and click Save. You are returned to the Data Subsetting Parameters page. To reset the Data Subsetting Parameters page, click Reset.

4.9 Modifying Registry Entries

To modify registry entries, locate the file webtogo.ora and enter your registry value against the REGISTRY_TAB parameter.

4.10 Selecting Application Files for Public Use

The Mobile Manager enables the Mobile Server administrator to designate specific application files as public files. This feature enables Mobile Clients for Web-to-Go and Branch Office users to download and use these files.

On an application level, application files are available as public files. Every Branch Office or Mobile Client for Web-to-Go to which an application is synchronized will have the same public files available for download. Users can download public files from the Branch Office or Mobile Client for Web-to-Go through the following URL.

http://<client>/public/download

To select application files, navigate to the Applications page and click the required application link. The Applications home page appears. Click the Files link. As Figure 4-6 displays, the Files page lists application files that are assigned for public use.

Figure 4-6 Files Page

This image displays the Files page.

The application file check boxes that enable file selection indicate that the application files have been assigned for public use. Check boxes that are not enabled for selection indicate that the application files are not assigned for public use. Select the check box against the application file that you need for public use and click Make Public. You are returned to the Files page.

4.11 Adding Web Application Archive (WAR) Files

Using the Mobile Manager, you can add WAR files to your mobile applications. In accordance with J2EE specifications, you can add Web components to a J2EE application in a package called a Web Application Archive (WAR). The WAR file is basically a JAR file with a few extra rules regarding what data is included within the file. It contains all files that make up a web application including other resources.

To add a WAR file, navigate to the Applications page and click the required application link. The Application Properties page appears. Click the Add WAR File link. As Figure 4-7 displays, the Add WAR File page appears.

Figure 4-7 Add WAR File Page

This image displays the Add WAR File page.

To upload the WAR file, click Browse and locate the WAR file. Click Upload. You are returned to the Add WAR File page.

4.12 Adding Bookmarks

To add bookmarks to your mobile applications, click the Administration link. As Figure 4-8 displays, the Administration page appears.

Figure 4-8 Administration Page

This image displays the Administration page.

Click the Bookmarks link. As Figure 4-9 displays, the Bookmarks page appears.

Figure 4-9 Bookmarks Page

This image displays the Bookmarks page.

Click Add Bookmark. As Figure 4-10 displays, the Add Bookmarks page appears.

Figure 4-10 Add Bookmarks Page

This image displays the Add Bookmarks page.

Enter data under the Bookmark Properties section as described in Table 4-3 and click Save. You are returned to the Mobile Server Bookmarks page which lists your bookmark.

Table 4-3 Bookmark Properties Description

Field Description
Site URL Web site URL of your mobile application. Choose the appropriate protocol from the list displayed. For example, to indicate a web site address, choose http. To indicate a secure web site address, choose https. To indicate a file transfer site address, choose ftp.
Site Name Web site name of your mobile application. For example, www.oracle.com.
Comments Brief description of the web site

Deleting Bookmarks

To delete bookmarks, navigate to the Bookmarks page and select the Bookmark that you want to delete. Click Delete.

To reset the bookmarks page, click Reset.