Oracle Application 9i User manual

Oracle9iApplication Server Wireless Edition
Configuration Guide
Release 1.1
May 2001
Part No. A86701-02

Oracle9i Application Server Wireless Edition Configuration Guide, Release 1.1
Part No. A86701-02
Copyright © 2001 Oracle Corporation. All rights reserved.
The Programs (which include both the software and documentation) contain proprietary information of
Oracle Corporation; they are provided under a license agreement containing restrictions on use and
disclosure and are also protected by copyright, patent, and other intellectual and industrial property
laws. Reverse engineering, disassembly, or decompilation of the Programs is prohibited.
The information contained in this document is subject to change without notice. If you find any problems
in the documentation, please report them to us in writing. Oracle Corporation does not warrant that this
document is error free. Except as may be expressly permitted in your license agreement for these
Programs, no part of these Programs may be reproduced or transmitted in any form or by any means,
electronic or mechanical, for any purpose, without the express written permission of Oracle Corporation.
If the Programs are delivered to the U.S. Government or anyone licensing or using the programs on
behalf of the U.S. Government, the following notice is applicable:
Restricted Rights Notice Programs delivered subject to the DOD FAR Supplement are "commercial
computer software" and use, duplication, and disclosure of the Programs, including documentation,
shall be subject to the licensing restrictions set forth in the applicable Oracle license agreement.
Otherwise, Programs delivered subject to the Federal Acquisition Regulations are "restricted computer
software" and use, duplication, and disclosure of the Programs shall be subject to the restrictions in FAR
52.227-19, Commercial Computer Software - Restricted Rights (June, 1987). Oracle Corporation, 500
Oracle Parkway, Redwood City, CA 94065.
The Programs are not intended for use in any nuclear, aviation, mass transit, medical, or other inherently
dangerous applications. It shall be the licensee's responsibility to take all appropriate fail-safe, backup,
redundancy, and other measures to ensure the safe use of such applications if the Programs are used for
such purposes, and Oracle Corporation disclaims liability for any damages caused by such use of the
Programs.
Oracle is a registered trademark, and JDeveloper, Oracle8, Oracle8i, PL/SQL, SQL*, and SQL*Plus are
trademarks or registered trademarks of Oracle Corporation. All other company or product names
mentioned are used for identification purposes only and may be trademarks of their respective owners.
Java and all Java-based marks are trademarks or registered trademarks of Sun Microsystems, Inc., in the
U.S. and other countries.

iii
Contents
List of Ta bles
Send Us Your Comments................................................................................................................... xi
Preface........................................................................................................................................................... xiii
Audience................................................................................................................................................ xiii
Organization......................................................................................................................................... xiv
Related Documentation ...................................................................................................................... xiv
Documentation Accessibility .............................................................................................................. xv
1 Overview
1.1 Installation Overview ........................................................................................................... 1-2
1.2 Manual Configuration.......................................................................................................... 1-3
1.2.1 Configure Oracle HTTP Server and JServ.................................................................. 1-3
1.2.2 Configure ProxyFirewall.properties............................................................................ 1-6
1.2.3 Start the Oracle HTTP Server....................................................................................... 1-6
1.2.4 Wireless Edition Configuration Verification.............................................................. 1-6
1.3 Upgrade.................................................................................................................................. 1-7
1.4 Samples................................................................................................................................... 1-8
1.5 Web Integration Server......................................................................................................... 1-9
1.6 Wireless Edition Client....................................................................................................... 1-10
1.6.1 Service Designer........................................................................................................... 1-10
1.6.2 Web Integration Developer ........................................................................................ 1-10
1.7 OCI8 JDBC Driver............................................................................................................... 1-11
1.8 User Provisioning................................................................................................................ 1-12

iv
1.9 Geocoding Setup.................................................................................................................. 1-12
1.10 JDBC Connection Pooling .................................................................................................. 1-12
2 FastForward
2.1 Introduction............................................................................................................................ 2-2
2.1.1 Features............................................................................................................................ 2-2
2.2 Installation.............................................................................................................................. 2-2
2.2.1 System Requirements .................................................................................................... 2-2
2.2.2 Installation....................................................................................................................... 2-3
2.2.2.1 On Your Own Web Server and JSP Engine......................................................... 2-3
2.2.2.2 On PTG 1.1 ............................................................................................................... 2-3
2.3 Configuration......................................................................................................................... 2-4
2.3.0.3 Configuration........................................................................................................... 2-4
2.3.0.3.1 Configuration Through Properties Files....................................................... 2-4
2.3.0.3.2 Configuring Mail and Directory Parameters through request.............. 2-9
2.3.0.3.3 Mail Configuration Class.............................................................................. 2-11
2.3.0.3.4 Configuration of URL Adapter in PTG 1.1 ServiceDesigner................... 2-13
3 Alerts and SMS Request Listener
3.1 Overview................................................................................................................................. 3-1
3.2 Alerts ....................................................................................................................................... 3-2
3.2.1 Request Queue................................................................................................................ 3-2
3.2.2 Notification Queue......................................................................................................... 3-3
3.2.3 Email-based Alert........................................................................................................... 3-3
3.2.4 SMS-based Alert............................................................................................................. 3-3
3.2.4.1 SMS-C Server........................................................................................................... 3-3
3.2.4.2 SMPP Protocol......................................................................................................... 3-4
3.2.4.3 SMS Protocol............................................................................................................ 3-4
3.2.4.4 UCP Protocol............................................................................................................ 3-4
3.2.4.5 Flow-Control............................................................................................................ 3-5
3.2.4.6 Wireless Edition SMS System Account for SMS-C............................................. 3-5
3.3 SMS Request Listener............................................................................................................ 3-5
3.4 Request and Notification Queue Pool................................................................................ 3-6
3.4.1 Request Queue Thread Pool Size................................................................................. 3-6
3.4.2 Notification Queue Thread Pool Size.......................................................................... 3-6

v
4 Logging
4.1 Overview ................................................................................................................................ 4-1
4.2 Database Logging.................................................................................................................. 4-1
4.2.1 Configuring the Database Logger................................................................................ 4-2
4.2.2 Database Table Contents............................................................................................... 4-3
4.3 Service Designer Logging .................................................................................................... 4-5
4.4 Server Logging....................................................................................................................... 4-5
4.5 Transaction Logging ............................................................................................................ 4-5
4.6 Configuring the Runtime Monitor and Management...................................................... 4-6
5 Multiple JVM Support and Load Balancing
5.1 Overview ................................................................................................................................ 5-2
5.2 Multiple Instances on Same Machine as Oracle HTTP Server........................................ 5-3
5.3 Multiple Instances on the Same Machine/Oracle HTTP Server on Different Machine ......
5-7
5.4 Multiple Instances and Oracle HTTP Server All on Different Machines...................... 5-7
5.5 Load Balancing ...................................................................................................................... 5-9
5.5.1 Load-Balancing with Cookies....................................................................................... 5-9
5.5.2 Load Balancing Through URL Rewriting................................................................... 5-9
5.6 Configuring the Personalization Portal for Load-Balancing........................................... 5-9
5.6.1 Clients/Gateways Support Cookies.......................................................................... 5-10
5.6.2 Clients/Gateways Do Not Support Cookies............................................................ 5-10
5.6.3 Sample Batch File ......................................................................................................... 5-12
6 Oracle Enterprise Manager
6.1 Overview ................................................................................................................................ 6-2
6.2 Prerequisites........................................................................................................................... 6-2
6.3 Configuring the Server, Client, and Middle-tier............................................................... 6-3
6.3.1 Configuring the Server Side ......................................................................................... 6-3
6.3.1.1 Configuring the Oracle Intelligent Agent............................................................ 6-3
6.3.1.2 Wireless Edition Data Gatherer Cartridge Installation: Unix........................... 6-4
6.3.1.3 Wireless Edition Data Gatherer Cartridge Installation: Windows.................. 6-5
6.3.2 Configuring the Client Side.......................................................................................... 6-6
6.3.3 Configuring the Middle-tier ......................................................................................... 6-9

vi
6.4 Setting up the ptg_services.tcl File.................................................................................... 6-10
6.5 Configuration for Another Wireless Edition Instance ................................................... 6-12
6.6 Configuring the Database Logger..................................................................................... 6-13
6.7 Asynchronous Notification of Error Information........................................................... 6-13
6.8 Launching the Oracle Enterprise Manager Tools........................................................... 6-14
7 Multi-byte Character Support
7.1 Overview................................................................................................................................. 7-2
7.2 Multi-byte Encoding Schemes............................................................................................. 7-2
7.2.1 Fixed-width Encoding Schemes................................................................................... 7-2
7.2.2 Variable-width Encoding Schemes.............................................................................. 7-2
7.3 Setting the Multi-Byte Encoding for the Personalization Portal..................................... 7-3
7.4 Setting up a Netscape Browser to Display Multi-byte Data ........................................... 7-3
7.5 LocalStrings.properties Files and Localization ................................................................. 7-3
7.5.1 Service Designer Localization....................................................................................... 7-3
7.5.2 Personalization Portal Localization............................................................................. 7-3
7.5.3 Localization for LDAP, Mail Adapter, and Personalization from a Device.......... 7-4
8 Utilities
8.1 System Password Encryption/Decryption........................................................................ 8-2
8.1.1 Extensibility..................................................................................................................... 8-2
8.2 LoadXml.................................................................................................................................. 8-3
8.3 Upload and Download Utilities .......................................................................................... 8-5
8.4 Xslt ........................................................................................................................................... 8-6
8.5 CopyObjects ........................................................................................................................... 8-7
9 Recommended Settings
9.1 Mod_JServ Configuration .................................................................................................... 9-2
9.2 Recommended Unix Kernel Parameters............................................................................ 9-2
9.3 Recommended Unix TCP Parameters................................................................................ 9-2
10 Property Files
10.1 Overview............................................................................................................................... 10-2
10.2 System.Properties................................................................................................................ 10-4

vii
10.3 Notification.properties ..................................................................................................... 10-15
10.4 Rmi.properties ................................................................................................................... 10-16
10.5 oemevent.properties ......................................................................................................... 10-17
10.6 Ftp.properties..................................................................................................................... 10-18
10.7 Spatial.Properties............................................................................................................... 10-19
10.8 www-server.properties .................................................................................................... 10-20
10.9 Provisioning.properties.................................................................................................... 10-21
10.10 useragent.properties ......................................................................................................... 10-22
10.11 LDAP.properties................................................................................................................ 10-22
10.12 AsynchNotification.properties........................................................................................ 10-22
10.13 AsynchRequest.properties............................................................................................... 10-23
10.14 EncodingSets.properties................................................................................................... 10-23
10.15 LocationMark.properties.................................................................................................. 10-24
10.16 ProxyFirewall.properties.................................................................................................. 10-25
10.17 MailAdapter.properties.................................................................................................... 10-26
10.18 Master.Properties .............................................................................................................. 10-26
10.19 positioner.xml.................................................................................................................... 10-27
10.20 Geocoders.xml ................................................................................................................... 10-27
10.21 Mappers.xml ...................................................................................................................... 10-28
10.22 Routers.xml ........................................................................................................................ 10-28
10.23 Strip.properties.................................................................................................................. 10-28
10.24 MAgent.properties............................................................................................................ 10-30
10.25 MInstances.properties....................................................................................................... 10-30
10.26 Cookies.properties............................................................................................................. 10-31
Index

viii

ix
List of Tables
2–1 Mail parameters..................................................................................................................... 2-5
2–2 Directory parameters............................................................................................................ 2-7
2–3 Mail parameters passed through request....................................................................... 2-9
2–4 Directory parameters passed through request............................................................ 2-10
2–5 Mail configuration class ..................................................................................................... 2-11
4–1 Contents of the ptg_session_log Table............................................................................... 4-3
4–2 Contents of the ptg_service_log Table ............................................................................... 4-4
4–3 Server Error Information...................................................................................................... 4-5
5–1 Property File Settings............................................................................................................ 5-6
6–1 ptg_services.tcl Parameters................................................................................................ 6-11
6–2 Properties of the oemevents.properties File.................................................................... 6-13
7–1 LocalStrings.properties Files Details .................................................................................. 7-4
8–1 LoadXml Utility..................................................................................................................... 8-4
8–2 Behaviors for the XML Loader in the Systems.property File ......................................... 8-6
8–3 Options for the Xslt Utility................................................................................................... 8-7
8–4 Options for the CopyObjects Utility................................................................................... 8-8
9–1 Mod_JServ Configuration .................................................................................................... 9-2
9–2 Recommended Unix Kernel Parameters............................................................................ 9-2
9–3 Recommended Solaris TCP Parameters............................................................................. 9-2
10–1 Wireless Edition Properties Files ...................................................................................... 10-3
10–2 Parameters for the System.properties File....................................................................... 10-4
10–3 Parameters of the Notification.properties File.............................................................. 10-15
10–4 Parameters of the Rmi.properties File............................................................................ 10-16
10–5 Parameters of the oemevents.properties File ................................................................ 10-17
10–6 Parameters of the Ftp.properties File ............................................................................. 10-19
10–7 Parameters of the spatial.properties File........................................................................ 10-19
10–8 Parameters of the www-server.properties File............................................................. 10-20
10–9 Parameters of the Provisoning.properties File.............................................................. 10-21
10–10 Parameters of the UserAgents.properties File .............................................................. 10-22
10–11 Parameters of the LDAP.properties File ........................................................................ 10-22
10–12 Parameters of the AsynchNotification.properties File................................................. 10-23
10–13 Parameters of the AsynchRequest.properties File........................................................ 10-23
10–14 Parameters of the EncodingSets.properties File ........................................................... 10-24
10–15 Parameters of the LocationMark.properties File .......................................................... 10-24
10–16 Parameters of the ProxyFirewall.properties File.......................................................... 10-25
10–17 Parameters of the MailAdapter.properties File ............................................................ 10-26
10–18 Parameters of the Master.properties File....................................................................... 10-26
10–19 Parameters of the positioner.xml File............................................................................. 10-27
10–20 Parameters of the Geocoders.xml File............................................................................ 10-28

x
10–21 Parameters of the mappers.xml File ............................................................................... 10-28
10–22 Parameters of the routers.xml File.................................................................................. 10-28
10–23 Parameters of the Strip.properties File........................................................................... 10-29
10–24 Strip Processing Classes.................................................................................................... 10-29
10–25 Parameters of the MAgent.properties File..................................................................... 10-30
10–26 Parameters of the Cookies.properties File ..................................................................... 10-31

xi
Send Us Your Comments
Oracle9i Application Server Wireless Edition Configuration Guide, Release 1.1
Part No. A86701-02
Oracle Corporation welcomes your comments and suggestions on the quality and usefulness of this
document. Your input is an important part of the information used for revision.
■Did you find any errors?
■Is the information clearly presented?
■Do you need more information? If so, where?
■Are the examples correct? Do you need more examples?
■What features did you like most?
If you find any errors or have any other suggestions for improvement, please indicate the document
title and part number, and the chapter, section, and page number (if available). You can send
comments to us in the following ways:
■Electronic mail: [email protected]
■Postal service:
Oracle Corporation
Oracle Mobile and Wireless Products
500 Oracle Parkway, Mailstop 4OP6
Redwood Shores, California 94065
USA
If you would like a reply, please give your name, address, telephone number, and (optionally)
electronic mail address.
If you have problems with the software, please contact your local Oracle Support Services.

xii

xiii
Preface
The Oracle9i Application Server Wireless Edition Configuration Guide discusses
how to configure Wireless Edition.
This Preface contains these topics:
Audience
Organization
Related Documentation
Documentation Accessibility
Audience Oracle9i Application Server Wireless Edition Configuration Guide is for users who
are setting up their environments to administer and/or develop applications for
wireless users. This document includes the following topics:
Overview
Setting up Wireless Edition
Setting up Oracle Enterprise Manager
Settings, Utilities, and Properties
To use this document, you need a general knowledge of application servers, Web
servers, and database-driven Web sites, wireless technologies, and familiarity with
the technologies and programming languages used in middle-tier environments.

xiv
Organization
This document contains:
Related Documentation
Wireless Edition-specific Documentation
Oracle9i Application Server Wireless Edition Configuration Guide (this Guide)
Oracle9iApplication Server Wireless Edition Implementation Guide
Oracle9iApplication Server Wireless Edition Developer’s Guide
Oracle9iApplication Server Wireless Edition Installation Guide
Oracle9iApplication Server Wireless Edition Release Notes
Chapter 1, "Overview" Overview of post-installation configuration
procedures.
Chapter 2, "FastForward" Configure Mail and LDAP applications.
Chapter 3, "Alerts and SMS
Request Listener" Configuring the SMS Listener to process time-based, scheduled services known as Alerts.
Chapter 4, "Logging" Configuring the logging capabilities of Wireless
Edition.
Chapter 5, "Multiple JVM
Support and Load Balancing" Configuring Wireless Edition to allow multiple Java Virtual Machine instances and load
balancing.
Chapter 6, "Oracle Enterprise
Manager" Configuring the Oracle Enterprise Manger for use with Wireless Edition.
Chapter 7, "Multi-byte
Character Support" Multi-byte character support and localization of Wireless Edition.
Chapter 8, "Utilities" Utilities, such as Password
Encryption/Decryption, LoadXML,
Upload/Download utilities, Xslt, and
CopyObjects.
Chapter 9, "Recommended
Settings" Recommended setting for Mod_JServ and Solaris TCP/IP and Kernel parameters.
Chapter 10, "Property Files" Properties files and their parameters.

xv
Additionally, Oracle9iApplication Server, Database, Networking, Application
Development, and other documentation is available on your Documentation CD,
and at docs.oracle.com.
Documentation Accessibility
Oracle’s goal is to make our products, services, and supporting documentation
accessible to the disabled community with good usability. To that end, our
documentation includes features that make information available to users of
assistive technology. This documentation is available in HTML format, and contains
markup to facilitate access by the disabled community. Standards will continue to
evolve over time, and Oracle is actively engaged with other market-leading
technology vendors to address technical obstacles so that our documentation can be
accessible to all of our customers. For additional information, visit the Oracle
Accessibility Program web site at http://www.oracle.com/accessibility/.

xvi

Overview 1-1
1
Overview
This document describes the post-installation configuration of Wireless Edition.
Each section of this document presents a different topic. These sections include:
■Section 1.1, "Installation Overview"
■Section 1.2, "Manual Configuration"
■Section 1.3, "Upgrade"
■Section 1.4, "Samples"
■Section 1.5, "Web Integration Server"
■Section 1.6, "Wireless Edition Client"
■Section 1.7, "OCI8 JDBC Driver"
■Section 1.8, "User Provisioning"
■Section 1.9, "Geocoding Setup"
■Section 1.10, "JDBC Connection Pooling"

Installation Overview
1-2 Oracle9i Application Server Wireless Edition Configuration Guide
1.1 Installation Overview
The Oracle9i Application Server installation includes three options:
■Oracle HTTP Server
■Standard Edition
■Enterprise Edition
Wireless Edition is installed as part of each of these options. The Oracle9i Application
Server Installation Guide discusses each option, and discusses the installation steps
specific to Wireless Edition. The Installation Guide defines Wireless Edition and
Oracle HTTP Server hardware and software requirements, preinstallation tasks
(setting environment variables), port numbers, starting and stopping the Oracle
HTTP Server, and the Wireless Edition client configuration.
For a new installation of Wireless Edition, follow the steps in this document starting
with the manual configuration in Section 1.2. If you have a previous release of
Wireless Edition installed see Section 1.3.
Important: In this document:
■WE_HOME is the directory in which Wireless Edition is
installed followed by the "panama" sub-directory. For example:
c:\ias10210\panama (Windows)
/private/ias10210/panama (UNIX)
Replace "WE_HOME" with the fully-qualified directory path.
■ORACLE_HOME is the directory in which Oracle9i
Application Server is installed.
Important: Wireless Edition is not properly configured until the
manual configuration steps are completed in Section 1.2.

Manual Configuration
Overview 1-3
1.2 Manual Configuration
After installation, perform the manual configuration steps described in this section:
■Section 1.2.1, "Configure Oracle HTTP Server and JServ"
■Section 1.2.2, "Configure ProxyFirewall.properties"
■Section 1.2.3, "Start the Oracle HTTP Server"
■Section 1.2.4, "Wireless Edition Configuration Verification"
1.2.1 Configure Oracle HTTP Server and JServ
This section describes the configuration of the Oracle HTTP Server and JServ.
1. Configure the httpd.conf file. The httpd.conf file is in the ORACLE_
HOME/Apache/Apache/conf directory.
a. Create an alias for this release of the Personalization Portal. This is needed
so that the application server can find the
http://hostname/portal/Login.jsp URL. Include the following in the Alias
section:
Alias /portal/ "WE_HOME/server/portal/"
b. To access a previous release of the Personalization Portal, in addition to this
release, create an alias. This allows the application server to find the
http://hostname/papz/login.jsp URL. Include the following in the Alias
section:
Alias /papz/ "WE_HOME/server/papz/"
c. Create an alias for the Javadoc directory. Include the following in the Alias
section. This step is optional.
Alias /ptgdoc/ "WE_HOME/doc/javadoc/"
2. Configure the jserv.conf file. The jserv.conf file is in the ORACLE_
HOME/Apache/Jserv/etc directory. In the ApJServMount section, add the
Wireless Edition specific mount point:
ApJServMount /ptg /root
3. Configure the jserv.properties file. The jserv.properties file is in the ORACLE_
HOME/Apache/Jserv/etc directory.

Manual Configuration
1-4 Oracle9i Application Server Wireless Edition Configuration Guide
a. Verify that the Java Virtual Machine is version 1.2.2. For example:
wrapper.bin= <ORACLE_HOME>/Apache/jdk/bin/java.exe
b. After the other "wrapper.classpath" entries, add all the required Wireless
Edition files after the "tools.jar" entry in the classpath.
For Windows (for UNIX replace "\" with "/"):
wrapper.classpath=<WE_HOME>\server\classes
wrapper.classpath=<WE_HOME>\lib\panama.zip
wrapper.classpath=<WE_HOME>\lib\panama_core.zip
wrapper.classpath=<WE_HOME>\lib\panama_portal.zip
wrapper.classpath=<WE_HOME>\lib\panama_papz.zip
wrapper.classpath=<WE_HOME>\lib\client.zip
wrapper.classpath=<WE_HOME>\lib\server.zip
wrapper.classpath=<WE_HOME>\lib\caboshare-opt.zip
wrapper.classpath=<WE_HOME>\lib\marlin-opt.zip
wrapper.classpath=<WE_HOME>\lib\ocelot-opt.zip
wrapper.classpath=<WE_HOME>\lib\share-opt-1_1_7.zip
wrapper.classpath=<WE_HOME>\lib\tecate-opt.zip
wrapper.classpath=<WE_HOME>\lib\regexp.jar
wrapper.classpath=<WE_HOME>\lib\sax2.jar
wrapper.classpath=<WE_HOME>\lib\activation.jar
wrapper.classpath=<WE_HOME>\lib\mail.jar
wrapper.classpath=<WE_HOME>\lib\ldap.jar
wrapper.classpath=<WE_HOME>\lib\ldapbp.jar
wrapper.classpath=<WE_HOME>\lib\providerutil.jar
wrapper.classpath=<WE_HOME>\lib\sdoapi101.jar
wrapper.classpath=<WE_HOME>\lib\sdovis.jar
wrapper.classpath=<WE_HOME>\lib\MapQuestX.jar
wrapper.classpath=<WE_HOME>\lib\MQJavaCore.jar
wrapper.classpath=<WE_HOME>\lib\RoutingJServerClient.jar
wrapper.classpath=<WE_HOME>\lib\jai_codec.jar
wrapper.classpath=<WE_HOME>\lib\jai_core.jar
wrapper.classpath=<WE_HOME>\lib\jpeg_codec.jar
wrapper.classpath=<WE_HOME>\lib\ordimimg.jar
Note: Perform the following step before the Oracle HTTP Server is
started. The Personalization Portal requires this step for generating
the correct image.