Release 5.0.2
Part No. B10111-01
 Contents |
 Index |
|
Oracle9i Lite Administration and Deployment Guide
Release 5.0.2 Part No. B10111-01 |
|
This document discusses how to administer mobile applications. The discussion covers the following topics:
To get a list of applications, click the Applications tab and then select By Name or By Virtual Path. Enter your search criteria in the search field and click Go. A list of applications with a virtual path or application name matching your search criteria appears in the right frame.
The database tables must exist before you publish your application. You can create the tables in the Oracle database by using the SQL command, CREATE TABLE. Any table that is used for an updateable snapshot must have a PRIMARY KEY constraint.
It is recommended that all records be inserted into your database tables before publishing your application.
After you have built an application and packaged it into a .jar file using the Packaging Wizard, you can upload it to the Mobile Server Repository on the Oracle database server by doing the following:
Click Publish Applications in the left frame of the Applications panel. The Repository Directory and JAR File fields appear in the right frame.
As Figure 6-1 shows, in the Repository Directory field, enter the name of the directory in the Mobile Server Repository where the application file will be located (for example, mysample). If you leave this field blank, the Mobile Server will create a directory using the value of the virtual path of the application.
In the Jar File field, enter the name of the .jar file you wish to upload (for example, sample1.jar), or locate the file using the Browse button.
If you wish to overwrite an existing application with the same virtual path in the repository, select "Overwrite the Existing Application."
Click Upload to publish the application to the Mobile Server Repository.
Figure 6-1 Uploading Applications to the Mobile Server Repository
You can modify a Mobile application's properties including its name, description, and database connectivity. To perform this task, click the Applications tab and then click By Name or By Virtual Path in the left frame. Enter your search criteria in the search field and click Go. A list of applications appears in the right frame. Click the application you want to modify. The following options appear in the left frame:
Properties
Data Subsetting
Registry
Access
Files
Click Properties. The following information appears in the right frame:
| Field | Description | Required |
|---|---|---|
| Application Name | The name of the application. | X |
| Application Virtual Path | The application's virtual path. This cannot be modified. | X |
| Application Icon | The application's icon as it appears in the Workspace. This cannot be modified. | X |
| Application Description | A description of the application. | X |
| Application Mode | Indicates whether this application is running or suspended. | |
| Maximum Database Connections | The number of connections the application supports to the Oracle database. | X |
| Connection Sharing | When selected, enables your application to share database connections among connected users. When not selected, users must wait five seconds for every connection currently assigned to the application. | |
| Database Username | The user name used by your application to connect to the Oracle database. | X |
| Database Password | The password used by your application to connect to the Oracle database. | X |
As Figure 6-2 and Figure 6-3 show, to modify an application's name, description, or database connectivity, enter the information in the required fields and click Save.
Figure 6-2 Modifying Application Properties
To enable connection pooling, click the Connection Sharing On button and then click Save.
Figure 6-3 Modifying Database Connectivity Information
You can use the Mobile Server Control Center to remove an application's resources and properties from the Mobile Server. To perform this task, click the Applications tab and then click By Name or By Virtual Path in the left frame. Enter your search criteria in the search field and click Go. A list of applications appears in the right frame. Click the application you want to delete. The following options appear in the left frame:
Properties
Data Subsetting
Registry
Access
Files
Click Properties. Scroll to the bottom of the right frame and click Remove, as shown in Figure 6-4. This removes the application from the Mobile Server.
Figure 6-4 Removing an Application
Removing an application from the Mobile Server does not delete all of the application's files and servlets from the Mobile Server system. The application's servlets remain loaded until the last user with access to the Mobile Server application logs off of the Mobile Server. Once the last user has logged off of the Mobile Server, the administrator can use the Mobile Server shell utility and delete all of the application files.
You can use the Mobile Server Control Center to suspend a mobile application for maintenance purposes. Suspending an application prevents all users from accessing the application in online mode. All users can still access the application in offline mode. To suspend a mobile application, click the Applications tab and then click By Name or By Virtual Path in the left frame. Enter your search criteria in the search field and click Go. A list of applications appears in the right frame. Click the application you want to suspend. The following options appear in the left frame:
Properties
Data Subsetting
Registry
Access
Files
Click Properties. Click Suspen, as illustrated in Figure 6-5. A warning dialog appears followed by a confirmation dialog. The application mode changes to suspended. The Resume button replaces the Suspend button.
Figure 6-5 Suspending an Application
You can use the Mobile Server Control Center to resume an application that has been suspended. To perform this task, click the Applications tab and then click By Name or By Virtual Path in the left frame. Enter your search criteria in the search field and click Go. A list of applications appears in the right frame. Click the application you want to resume. The following options appear in the left frame:
Properties
Data Subsetting
Registry
Access
Files
Click Properties. Click Resume. This returns the application to normal operation and enables it to go offline, if necessary. The application mode changes to running. The Suspend button replaces the Resume button.
Figure 6-6 Resuming an Application
This section presents the access features of the Mobile Server Control Center.
With the Mobile Server Control Center, you can grant or revoke user and group access to a specific application. To perform these tasks, click the Applications tab and then click By Name or By Virtual Path in the left frame. Enter your search criteria in the search field and click Go. A list of applications appears in the right frame. Click the application you want to modify. The following options appear in the left frame:
Properties
Data Subsetting
Registry
Access
Files
Click Access. A list of users and groups appears as shown in Figure 6-7.
To grant application access to users, select the "Access?" check box next to the user(s) listed under User based access and then click Save. To grant access to all users in the list, click Select All and then click Save.
To revoke application access to users, remove the selection from the "Access?" check box and click Save.
To grant application access to groups, select the "Access?" check box next to the group(s) listed under Group-based access and then click Save. To grant access to all groups in the list, click Select All and then click Save.
To revoke application access to groups, remove the selection from the "Access?" check box and click Save.
|
Note: Granting application access to an entire group gives each user in that group access to the application. However, you can exclude certain users from accessing the application without removing them from the group. For more information, see Section 6.8.2, "Including Users in or Excluding Users from Group-Level Access". |
Figure 6-7 Granting or Revoking Application Access
You can modify an application's group-level access to an application by either including or excluding users. To perform these tasks, click the Applications tab and then click By Name or By Virtual Path in the left frame. Enter your search criteria in the search field and click Go. A list of applications appears in the right frame. Click the application you want to modify. The following options appear in the left frame:
Properties
Data Subsetting
Registry
Access
Files
Click Access. A list of users and groups appears in the right frame.
To grant access to users in the group, do the following:
Click the Edit link that is associated with the group (that is, the Edit link that appears on the same line as the group).
On the next page, select the Enabled check box next to "Enable App Access for Group User".
To revoke application access from a user in the group, do the following:
Click the Edit link that is associated with Pthe group (that is, the Edit link that appears on the same line as the group).
On the next page, remove the selection in the Enabled check box next to "Enable App Access for Group User".
For information on how to create Web-to-Go roles, see Oracle9i Lite Developer's Guide for Web-to-Go.
To grant or revoke access to users and groups to a Mobile Server role, click the Applications tab and then click By Name or By Virtual Path in the left frame. Enter your search criteria in the search field and click Go. A list of applications appears in the right frame. Click the application you want to modify. The following options appear in the left frame:
Properties
Data Subsetting
Registry
Access
Files
Click Access. A list of users and groups appears.
To grant roles to the user, click the Edit link next to the user's name in the User based access section of the screen. A list of available roles for the user appears.
|
Note: You can only access the list of available roles for a user if the user has been granted access to the application. If the user does not have access to the application, the Mobile Server Control Center returns an error message when you click the Edit link. |
Select the "Granted?" check box next the role you want to grant to the user. Click Save.
To revoke roles from the user, clear the check box next to the role as shown in Figure 6-8. Click Save.
Figure 6-8 Revoking Roles from a User
You can modify an application's group(s) by granting or revoking roles to the group(s). To perform these tasks, click the Applications tab and then click By Name or By Virtual Path in the left frame. Enter your search criteria in the search field and click Go. A list of applications appears in the right frame. Click the application you want to modify. The following options appear in the left frame:
Properties
Data Subsetting
Registry
Access
Files
Click Access. A list of users and groups appears in the right frame.
To grant roles to the group, click the Edit link next to the group's name. A list of available roles for the group appears.
|
Note: You can only access the list of available roles for a group if that group has been granted access to the application. If the group does not have access to the application, the Mobile Server Control Center returns an error message when you click the Edit link. |
Select the "Granted?" check box next the role you want to grant to the group. Click Save.
To revoke roles from the group, remove the selection in the check box next the role. Click Save.
The Mobile Server Control Center enables administrators to both view and edit the data subsetting parameters in a Mobile application. To perform this task, click the Applications tab and then click By Name or By Virtual Path in the left frame. Enter your search criteria in the search field and click Go. A list of applications appears in the right frame. Click the application that contains the data subsetting parameters that you want to view or modify. The following options appear in the left frame:
Properties
Data Subsetting
Registry
Access
Files
Click Data Subsetting. A list of users and their associated platforms appear in the right frame, as illustrated in Figure 6-9.
Figure 6-9 Modifying Data Subsetting Parameters
To view the data subsetting parameters for a user (for example, JOHN), click the platform next to the user. The Mobile Server Control Center displays information about the application name, the user name, the platform name, and the value under the heading "Selected User" in the rightmost section of the right panel, as shown in Figure 6-9.
The following table describes the displayed elements:
| Element | Description | Required |
|---|---|---|
| Application | The application name. This cannot be modified. | |
| User Name | The user name of the selected user. This cannot be modified. | |
| Platform Name | The platform specified in the Packaging Wizard for the snapshot. This cannot be modified | |
| Name | The name of the parameter for the mobile application. | X |
| Value | The value of the parameter for the mobile application. | X |
Enter the values for the parameters and then click Save. Clicking Reset sets the values in the Value fields back to their original state.
You can modify registry entries for mobile application users. The registry contains a modifiable registry entry for users. To perform this task, click the Applications tab and then click By Name or By Virtual Path in the left frame. Enter your search criteria in the search field and click Go. A list of applications appears in the right frame. Click the application that contains the user name/value pairs you want to modify. The following options appear in the left frame:
Properties
Data Subsetting
Registry
Access
Files
Click Registry in the left frame. A list of registry entries associated with the mobile application appears, as shown in Figure 6-10. Click the registry entry you want to modify.
Figure 6-10 Modifying Registry Entries
The following information appears in the right frame.
| Field | Description | Required |
|---|---|---|
| Application | The application name. This cannot be modified. | X |
| User | The application user. This cannot be modified. | X |
| Registry Name | The registry name. This cannot be modified. | X |
| Default Value | The registry's default value. This cannot be modified. | X |
| Override | A field for modifying the default value. |
As Figure 6-11 illustrates, to modify a user's name/value pair, enter the new value in the Override field and click Save.
Figure 6-11 Modifying a User's Name/Value Pair
The Mobile Server Control Center enables the Mobile Server administrator to designate specific application files as public files, meaning users of both the Mobile Client for Web-to-Go and the Branch Office can download these files. Files are made public on an application level. Every Branch Office or Mobile Client for Web-to-Go to which that application is synchronized will have the same public files available for download. Users download public files from the Branch Office or Mobile Client for Web-to-Go through the following URL:
http://<client>/public/download
For more information on downloading public files from the Mobile Client for Web-to-Go, see Chapter 12, "Deployment" and Chapter 14, "Deployment: Using the Mobile Client for Web-to-Go".
|
Note: The Mobile Server administrator uses the Packaging Wizard to publish an application to the Mobile Server Repository. The Packaging Wizard enables a developer to define a new application or edit an existing one. For more information on the Packaging Wizard, see Oracle9i Lite Developer's Guide for Web-to-Go. |
Figure 6-12 Selecting Application Files for Public Use
The Mobile Server administrator then selects the desired application file. Clicking the file displays a list of applications as Figure 6-12 illustrates. Mobile Server administrators sort this list using the following:
| Label | Description |
| Name | The name of the application file. Clicking this label sorts all application files and folders in alphabetical order. |
| Size | The size of the application file or folder. Clicking this label sorts all application files and folders by size. |
| Modified | The most recent time and date that the application files were modified. Clicking this label sorts all application files and folders by the last time they were modified. |
| Public File | Selecting this check box grants branch office users access to the application file. Clicking the Public File label groups all application files that are selected as public. |
After locating this application, the Mobile Server administrator designates any file as public by selecting the adjacent Public File check box and clicking Save. The file is now designated as a public file in the Mobile Server Repository.
The Mobile Server Control Center enables administrators to create bookmarks that allow users quick access to Web sites from the Workspace the Mobile Client for Web-to-Go.
To create a bookmark, click the Edit Bookmark option in the left frame of the Application tab. As Figure 6-13 shows, the right frame then displays Edit Bookmark panel. Click New.
Figure 6-13 Creating a System Bookmark
The right frame is then populated by the Bookmark panel and the Custom Image panel, as shown in Figure 6-14.
Figure 6-14 The Bookmark Panel
Administrators create bookmarks by entering information into the Site URL, Site Name, and Comments fields in the Bookmark panel. The Bookmark panel contains the following elements.
| Element | Description | Required |
|---|---|---|
| Site URL | A drop-down list of Internet protocols that corresponds to the site's identifying icon that appears next to Image (described below). After you have selected the appropriate protocol image, enter the name of the site in the adjacent field (for example, www.Oracle.com). This name can be entered manually or pasted. | X |
| Site Name | A field for entering the name of the Web site (for example, Oracle). This does not have to be the exact site name. Instead, it can be a name that is meaningful to both the administrator and users. | X |
| Comments | A field for entering a brief description of the site (for example, my oracle). This description appears as a caption under the site name when it appears on the Web-to-Go Workspace. | |
| Image | Displays the image that corresponds to the site URL protocol as selected from the Site URL drop-down box. This image can be replaced by another of the administrator's choosing by using the Image field in the Custom Image panel. |
Clicking Save after entering the appropriate information in the Site URL, Site Name, and Comments fields publishes the bookmark to the Bookmark tab in the Web-to-Go Workspace. Clicking Reset clears all fields and sets the Site URL drop-down list back to its default setting of http://.
The Web-to-Go Bookmark function allows administrators to replace the .gif image of the protocol icons. To change an icon, locate the desired protocol in the Bookmark panel's Site URL drop-down list and then enter the name of the new .gif image you wish to use in the Image field in the Custom Image panel. You can also enter the name of the .gif file in this field by using the Browse button. Click Upload to upload the image to the Web-to-Go Repository. Clicking Save replaces the existing image with the new one. Clicking Reset returns the existing image as the bookmark's icon.
Administrators can change a bookmark's site name, describing comments, or image by clicking the pencil icon to the right of the bookmark, as illustrated in the following figure:
Figure 6-15 The Pencil Icon
The Bookmark and Custom Image panels used to create a new bookmark appear the right frame, this time with the Site URL, Site Name, and Site Comments fields populated with previously entered information. Change the information in the Site Name and Comments fields and then click Save. Clicking Reset returns the fields to their original state. To change the bookmark's icon, enter the name of the new .gif file in the Image field, or locate the gif file using the Browse button. Click Upload to upload the image to the Web-to-Go Workspace. Clicking Save replaces the bookmark's existing image with the new one. Clicking Reset returns the previous image as the bookmark's icon.
Administrators can delete a bookmark by clicking the garbage can icon next to the bookmark. Clicking this icon invokes a message that prompts you to complete the deletion.
Administrators can create Internet protocol icons from .gif images they have selected. These .gif files can be changed by clicking Edit Default Bookmark Icon in the left frame. The right frame is then populated by the current set of Internet protocol icons.
To change an icon, scroll to the desired image and then click Modify. The Image Loading panel appears, as the following Figure 6-16 shows:
Figure 6-16 The Image Loading Panel
Enter the name of the .gif image that you intend to use for the new icon, or locate it using the Browse button. Clicking Upload to replaces the current icon with the new one.
Using the Mobile Server Control Center, you can add WAR files to your applications. In accordance with the J2EE specifications, you add Web components to a J2EE application in a package called a Web Application Archive (WAR). It is basically a JAR file with a few extra rules regarding what data is included within the file; it contains all the files that make up a Web application as well as other resources.
As Figure 6-17 shows, you can add a WAR file to a particular application from the Applications tab after finding that application.
Figure 6-17 Adding a WAR File to an Application
To add a WAR file to an application, follow these steps:
In the Applications tab, find the application to which you want to add the WAR file.
Click the Add WAR file link in the left panel of the screen.
The Add WAR file to application screen appears in the right panel, displaying the application name.
In the row for specifying the WAR file, below Application Name, in the right panel, click the Browse button to locate the WAR file or type the path to the file in the field provided.
Click the Upload link.
|
 Copyright © 2002 Oracle Corporation All rights reserved |
|