Oracle Application 9i Configuration Manual

Download

Page 1

Oracle9i Application Server Wireless Edition

Configuration G uide

Release 1.1

May 2001 Part No. A86701-02

Page 2

Oracle9i Application Server Wireless Edition Configuration Guide, Release 1.1 Part No. A86701-02 Copyright © 2001 Oracle Corp oration. All rights reserved. The Programs (which inc lud e bo th t he software and documentation) contain proprietary in formation of

Oracle Corporation; they are provided under a license agreement containing restrictions on use and disclosure and are also protected by copyright, paten t, an d other intellectual and in dustrial property laws. Reverse engineering, disassembly, or decompilation of the Programs is prohibited.

The information conta i ned in this document is s ub ject to change without noti ce. If you find any pr ob lems in the documen t at ion, please report the m t o u s in writing. Oracle C orporation does not warrant that th is 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 t he e xp res s wri tte n 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 soft ware" 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 Comp ut e r Soft ware - 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 Cor poration disclaims liability fo r an y dam a ge s caused by such use of the Programs.

Oracle is a registered trademark, and JDe v e lo p er, Oracle8, Oracle8i, PL/S QL , SQ L*, an d S QL*Plus are trademarks or registered trademarks of Oracle Corporation. All othe r c om p an y or p roduct na me s mentioned are used for identification purposes only and may be trademarks of thei r respective owners.

Java and all Java-based marks are trademarks or registered trademarks of Sun Microsystems, Inc., in the U.S. and other countries.

Page 3

Contents

List of Tables

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

1.2.1

1.2.2

1.2.3

1.2.4

1.3

1.4

1.5

1.6

1.6.1

1.6.2

1.7

1.8

Manual Configuration.......................................................................................................... 1-3

Configure Oracle HTTP Server and JServ.................................................................. 1-3

Configure ProxyFirewall.properties............................................................................ 1-6

Start the Oracle HTTP Server....................................................................................... 1-6

Wireless Edition Configuration Verification.............................................................. 1-6

Upgrade.................................................................................................................................. 1-7

Samples................................................................................................................................... 1-8

Web Integration Server......................................................................................................... 1-9

Wireless Edition Client....................................................................................................... 1-10

Service Designer........................................................................................................... 1-10

Web Integration Developer ........................................................................................ 1-10

OCI8 JDBC Driver............................................................................................................... 1-11

User Provisioning................................................................................................................ 1-12

iii

Page 4

1.9 Geocoding Setup.................................................................................................................. 1-12

1.10

JDBC Connection Pooling .................................................................................................. 1-12

2 FastForward

2.1 Introduction............................................................................................................................ 2-2

2.1.1

2.2

2.2.1

2.2.2

2.2.2.1

2.2.2.2

2.3

2.3.0.3

2.3.0.3.1 Configuration Through Properties Files....................................................... 2-4

2.3.0.3.2

2.3.0.3.3

2.3.0.3.4 Configuration of URL Adapter in PTG 1.1 ServiceDesigner................... 2-13

Features............................................................................................................................ 2-2

Installation.............................................................................................................................. 2-2

System Requirements .................................................................................................... 2-2

Installation....................................................................................................................... 2-3

On Your Own Web Server and JSP Engine......................................................... 2-3

On PTG 1.1 ............................................................................................................... 2-3

Configuration......................................................................................................................... 2-4

Configuration........................................................................................................... 2-4

Configuring Mail and Directory Parameters through request.............. 2-9

Mail Configuration Class.............................................................................. 2-11

3 Alerts and SMS Request Listener

3.1 Overview................................................................................................................................. 3-1

3.2

3.2.1

3.2.2 Notification Queue......................................................................................................... 3-3

3.2.3

3.2.4

3.2.4.1

3.2.4.2

3.2.4.3

3.2.4.4

3.2.4.5

3.2.4.6

3.3

3.4

3.4.1

3.4.2

Alerts ....................................................................................................................................... 3-2

Request Queue........................................................................................................ ..... ... 3-2

Email-based Alert........................................................................................................... 3-3

SMS-based Alert............................................................................................................. 3-3

SMS-C Server........................................................................................................... 3-3

SMPP Protocol......................................................................................................... 3-4

SMS Protocol............................................................................................................ 3-4

UCP Protocol............................................................................................................ 3-4

Flow-Control............................................................................................................ 3-5

Wireless Edition SMS System Account for SMS-C............................................. 3-5

SMS Request Listener............................................................................................................ 3-5

Request and Notification Queue Pool................................................................................ 3-6

Request Queue Thread Pool Size................................................................................. 3-6

Notification Queue Thread Pool Size.......................................................................... 3-6

Page 5

4 Logging

4.1 Overview ................................................................................................................................ 4-1

4.2

4.2.1

4.2.2

4.3

4.4

4.5

4.6

Database Logging.......................................... .............................................................. ...... .... 4-1

Configuring the Database Logger................................................................................ 4-2

Database Table Contents............................................................................................... 4-3

Service Designer Logging .................................................................................................... 4-5

Server Logging....................................................................................................................... 4-5

Transaction Logging ............................................................................................................ 4-5

Configuring the Runtime Monitor and Management...................................................... 4-6

5 Multiple JVM Support and Load Balancing

5.1 Overview ................................................................................................................................ 5-2

5.2

5.3 Multiple Instances on the Same Machine/Oracle HTTP Server on Different Machine ......

5.4

5.5

5.5.1 Load-Balancing with Cookies....................................................................................... 5-9

5.5.2

5.6

5.6.1 Clients/Gateways Support Cookies.......................................................................... 5-10

5.6.2

5.6.3

Multiple Instances on Same Machine as Oracle HTTP Server........................................ 5-3

5-7

Multiple Instances and Oracle HTTP Server All on Different Machines...................... 5-7

Load Balancing ...................................................................................................................... 5-9

Load Balancing Through URL Rewriting................................................................... 5-9

Configuring the Personalization Portal for Load-Balancing........................................... 5-9

Clients/Gateways Do Not Support Cookies............................................................ 5-10

Sample Batch File ......................................................................................................... 5-12

6 Oracle Enterprise Manager

6.1 Overview ................................................................................................................................ 6-2

6.2

6.3

6.3.1

6.3.1.1

6.3.1.2

6.3.1.3

6.3.2

6.3.3

Prerequisites........................................................................................................................... 6-2

Configuring the Server, Client, and Middle-tier............................................................... 6-3

Configuring the Server Side ......................................................................................... 6-3

Configuring the Oracle Intelligent Agent............................................................ 6-3

Wireless Edition Data Gatherer Cartridge Installation: Unix........................... 6-4

Wireless Edition Data Gatherer Cartridge Installation: Windows.................. 6-5

Configuring the Client Side.......................................................................................... 6-6

Configuring the Middle-tier......................................................................................... 6-9

Page 6

6.4 Setting up the ptg_services.tcl File.................................................................................... 6-10

6.5

6.6

6.7

6.8

Configuration for Another Wireless Edition Instance ................................................... 6-12

Configuring the Database Logger..................................................................................... 6-13

Asynchronous Notification of Error Information........................................................... 6-13

Launching the Oracle Enterprise Manager Tools........................................................... 6-14

7 Multi-byte Character Support

7.1 Overview................................................................................................................................. 7-2

7.2

7.2.1

7.2.2

7.3

7.4

7.5 LocalStrings.properties Files and Localization ................................................................. 7-3

7.5.1

7.5.2

7.5.3 Localization for LDAP, Mail Adapter, and Personalization from a Device.......... 7-4

Multi-byte Encoding Schemes............................................................................................. 7-2

Fixed-width Encoding Schemes................................................................................... 7-2

Variable-width Encoding Schemes.............................................................................. 7-2

Setting the Multi-Byte Encoding for the Personalization Portal..................................... 7-3

Setting up a Netscape Browser to Display Multi-byte Data ........................................... 7-3

Service Designer Localization....................................................................................... 7-3

Personalization Portal Localization............................................................................. 7-3

8 Utilities

8.1 System Password Encryption/Decryption........................................................................ 8-2

8.1.1

8.2

8.3 Upload and Download Utilities.......................................................................................... 8-5

8.4

8.5

Extensibility..................................................................................................................... 8-2

LoadXml.................................................................................................................................. 8-3

Xslt ........................................................................................................................................... 8-6

CopyObjects ........................................................................................................................... 8-7

9 Recommended Settings

9.1 Mod_JServ Configuration .................................................................................................... 9-2

9.2

9.3

Recommended Unix Kernel Parameters............................................................................ 9-2

Recommended Unix TCP Parameters................................................................................ 9-2

10 Property Files

10.1 Overview............................................................................................................................... 10-2

10.2

System.Properties................................................................................................................ 10-4

Page 7

10.3 Notification.properties ..................................................................................................... 10-15

10.4

10.5

10.6

10.7

10.8

10.9

10.10

10.11

10.12

10.13

10.14

10.15

Rmi.properties ................................................................................................................... 10-16

oemevent.properties ......................................................................................................... 10-17

Ftp.properties..................................................................................................................... 10-18

Spatial.Properties............................................................................................................... 10-19

www-server.properties .................................................................................................... 10-20

Provisioning.properties.................................................................................................... 10-21

useragent.properties ......................................................................................................... 10-22

LDAP.properties................................................................................................................ 10-22

AsynchNotification.properties........................................................................................ 10-22

AsynchRequest.properties............................................................................................... 10-23

EncodingSets.properties................................................................................................... 10-23

LocationMark.properties.................................................................................................. 10-24

10.16 ProxyFirewall.properties.................................................................................................. 10-25

10.17

10.18

MailAdapter.properties.................................................................................................... 10-26

Master.Properties .............................................................................................................. 10-26

10.19 positioner.xml.................................................................................................................... 10-27

10.20

10.21

Geocoders.xml ................................................................................................................... 10-27

Mappers.xml ...................................................................................................................... 10-28

10.22 Routers.xml ........................................................................................................................ 10-28

10.23

10.24

Strip.properties.................................................................................................................. 10-28

MAgent.properties............................................................................................................ 10-30

10.25 MInstances.properties....................................................................................................... 10-30

10.26

Cookies.properties............................................................................................................. 10-31

Index

vii

Page 8

viii

Page 9

List of Tables

2–1 Mail parameters..................................................................................................................... 2-5

2–2 2–3 2–4 2–5 4–1 4–2 4–3 5–1 6–1 6–2 7–1 8–1 8–2 8–3 8–4 9–1 9–2 9–3 10–1 10–2 10–3 10–4 10–5 10–6 10–7 10–8 10–9 10–10 10–11 10–12 10–13 10–14 10–15 10–16 10–17 10–18 10–19 10–20

Directory parameters............................................................................................................ 2-7

Mail parameters passed through request....................................................................... 2-9

Directory parameters passed through request............................................................ 2-10

Mail configuration class ..................................................................................................... 2-11

Contents of the ptg_session_log Table............................................................................... 4-3

Contents of the ptg_service_log Table ............................................................................... 4-4

Server Error Information...................................................................................................... 4-5

Property File Settings............................................................................................................ 5-6

ptg_services.tcl Parameters................................................................................................ 6-11

Properties of the oemevents.properties File.................................................................... 6-13

LocalStrings.properties Files Details .................................................................................. 7-4

LoadXml Utility..................................................................................................................... 8-4

Behaviors for the XML Loader in the Systems.property File ......................................... 8-6

Options for the Xslt Utility................................................................................................... 8-7

Options for the CopyObjects Utility................................................................................... 8-8

Mod_JServ Configuration.................................................................................................... 9-2

Recommended Unix Kernel Parameters............................................................................ 9-2

Recommended Solaris TCP Parameters............................................................................. 9-2

Wireless Edition Properties Files ...................................................................................... 10-3

Parameters for the System.properties File....................................................................... 10-4

Parameters of the Notification.properties File.............................................................. 10-15

Parameters of the Rmi.properties File............................................................................ 10-16

Parameters of the oemevents.properties File................................................................ 10-17

Parameters of the Ftp.properties File ............................................................................. 10-19

Parameters of the spatial.properties File........................................................................ 10-19

Parameters of the www-server.properties File............................................................. 10-20

Parameters of the Provisoning.properties File.............................................................. 10-21

Parameters of the UserAgents.properties File .............................................................. 10-22

Parameters of the LDAP.properties File........................................................................ 10-22

Parameters of the AsynchNotification.properties File................................................. 10-23

Parameters of the AsynchRequest.properties File........................................................ 10-23

Parameters of the EncodingSets.properties File ........................................................... 10-24

Parameters of the LocationMark.properties File.......................................................... 10-24

Parameters of the ProxyFirewall.properties File .......................................................... 10-25

Parameters of the MailAdapter.properties File ............................................................ 10-26

Parameters of the Master.properties File....................................................................... 10-26

Parameters of the positioner.xml File............................................................................. 10-27

Parameters of the Geocoders.xml File............................................................................ 10-28

Page 10

10–21 Parameters of the mappers.xml File ............................................................................... 10-28

10–22 10–23 10–24 10–25 10–26

Parameters of the routers.xml File.................................................................................. 10-28

Parameters of the Strip.properties File........................................................................... 10-29

Strip Processing Classes.................................................................................................... 10-29

Parameters of the MAgent.properties File..................................................................... 10-30

Parameters of the Cookies.properties File..................................................................... 10-31

Page 11

Send Us Your Comment s

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: iasdocs_us@oracle.com

■ 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.

Page 12

xii

Page 13

Audience

Preface

The Oracle9i Application Server Wireless Edition Configuration Guide discusses how to configure Wireless Edition.

This Preface contains these topics:

Audience Organization Related Docume ntation Documentation Accessibility

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.

xiii

Page 14

Organization

This document contains:

Chapter 1, "Overview" Overview of post-installation configuration

Chapter 2, "FastForward" Configure Mail and LDAP applications.

procedures.

Chapter 3, "Alerts and SMS

Request Listener"

Chapter 4, "Logging" Configuring the logging capabilities of Wireless

Chapter 5, "Multiple JVM

Support and Load Balancing"

Chapter 6, "Oracle Enterprise

Manager"

Chapter 7, "Multi-byte

Character Support"

Chapter 8, "Utilities" Utilities, such as Password

Chapter 9, "Recommended

Settings"

Chapter 10, "Property Files" Properties files and their parameters.

Configuring the SMS Listener to process time-based, scheduled services known as Alerts.

Edition. Configuring Wireless Edition to allow multiple

Java Virtual Machine instances and load balancing.

Configuring the Oracle Enterprise Manger for use with Wireless Edition.

Multi-byte character support and localization of Wireless Edition.

Encryption/Decryption, LoadXML, Upload/Download utilities, Xslt, and CopyObjects.

Recommended setting for Mod_JServ and Solaris TCP/IP and Kernel parameters.

Directory

■ LDAP servers supporting JND I 1. 2

Mail and Directory applications can be two separate applications, or they can be

configured separately in such a way that they can interact with each other.

Also, the Mail and Directory applications can be used as both hosted applications or

as shipped products.

2.3.0.3 Configuration

You can configure the Mail and Directory Application in one of two ways:

■ Send configuration parameters through request, or

■ Use the Mail application property file.

The Mail and Directory applications will first try to use the parameters sent through

request. Then they will try to look for other missing parameters. Finally, default

values will be used.

2.3.0.3.1 Configuration Through Properties Files

For the Mail application, configure OracleMobileEmail.properties (in the

oracle/panama/module/communicate/mail directory).

For the Directory Application, configure OracleMobileLDAP.properties (in the

oracle/panama/module/communicate/ldap directory).

2-4 Oracle9i Application Server Wireless Edition Configuration Guide

Page 35

An example of the files is in the doc directory.

IMPORTANT: The root "oracle" directory containing the properties

files must be in the classpath of the JSP engine. There is a properties directory in the install; modify the properties files there, and put the <install>/properties directories in the classpath of the JSP engine.

Note: Parameters a nd values in properties file is case sensitive.

WARNING: Ensure you are using the proper format for your

UNIX or Windows platforms. For example: UNIX format mail.logger=/tmp/mail.log Windows format mail.logger=d:\\tmp\\mail.log

Configuration

For the Mail application, you must configure the following parameters:

Table 2–1 Mail parameters

mail.service Mail service supported by the mail server. Currently

supported services are "IMAP" or "POP3". Default is IMAP.

mail.server.name Full hostname of the mail se rver. mail.server.port Port number of the Mail server on the host. Default

for IMAP is 143. Default for POP3 is 110.

mail.smtp.server.name Full hostname of the SMTP server. mail.smtp.server.port Port number of the SMTP server on the host. Default

for IMAP is 25.

mail.smtp.server.login Returns the login name of the SMTP server. If login

for SMTP is not required, this method should return a null or empty string (""), otherwise, the value will be used for SMTP login.

mail.folder.inbox Name of the Inbox folder on the mail server. Default

is "INBOX". This property is optional.

FastForward 2-5

Page 36

Configuration

mail.folder.sent The name of the Sent folder on the mail server.

Default is "Sent". This property is optional.

mail.default.emaildomain Default email domain for sending emails. When

sending emails, if the email doma in is not specified, the default email domain will be appended to the username.

mail.log Determines whether log in is enabled or not. Value is

either "true" or "false". Default is "true".

mail.logger Full path of the log file.

mail.msgfetch.setsize Maximum number of messages to fetch for one

request. This is the maximum number of messages returned for one request. For example, if a folder has 300 messages, only the first 200 will be returned at the first request.

mail.server.connect.timeout Connecti on timeout in milliseconds. Default is 2000.

mail.config.class The configuration class. Users can provide their own

configuration classes, allowing them to do more advanced configuration, for example, select a mail server host name based on username. Default is

oracle.panama.module.communicate.mail.util.Conf ig which is shipped with the OracleMobile Mail

application.

mail.directoryEnabled Enables/disables directory access from email. If

enabled, when users are composing emails, they can go to directories to look for email addresses. Values can be "true" or "false". Default is "false".

ldap.designer.path Used when directory is enabled. Check the

"mail.directoryEnabled" parameter. When the application is running on PTG, but not

studio, then the path to the application specified in ServiceDesigner Service Trees is needed.

For example, if LDAP is the service defined for the Directory Application, and it is put in a folder called Apps under Service Trees, then the path should be /Apps/Ldap.

2-6 Oracle9i Application Server Wireless Edition Configuration Guide

Page 37

Configuration

mail.designer.path Path to the application specified in Servi ceDesigner

Service Trees. Check the "studio" parameter. For example, if Mail is the service defined for the Mail application, and it is put in a folder called Apps under Service Trees, then the path should be /Apps/Mail.

For the Directory application, you must configure the following parameters:

Table 2–2 Directory parameters

ldap.host LDAP server hostname. ldap.port LDAP server port number. The default is 389. ldap.log Determines whether logging is turn on or off. Values

can be "true" or "false". Default is "true".

ldap.logger Full pathname of the log fi le. ldap.queries Two default queries are shipped with the

OracleMobile Directory Application:

One searches for a person on the common name LDAP attribute.

The second searches for a person on the first name and the last name LDAP attribute. For details about LDAP query syntax, s ee the LDAP documentation.

ldap.links

Hotlink is a mechanism that ena ble s yo u to cr ea te hyperlin ks on the attribute in the res u lt list. For details about Hotli nk, see the LDAP documentation.

ldap.labelMultipleMatch Sets the values that appear in the results list from the

query, when a query returns more than one line. Note that the values must be in the query. The default is givenname, surname, and title.

ldap.labelMultipleMatch Contains givenname, surname, and title ldap.maxResultCount Maximum results returned from a query. Default is

1000.

ldap.enableLogin Determines if LDAP login is required for a user. The

value is either "true" or "false". Default is "false".

FastForward 2-7

Page 38

Configuration

ldap.username

ldap.password

If an LDAP login is required, a default username and password can be specified. Ensure the

ldap.enableLogin property is true.

ldap.emailEnabled Enables/disables email access from a directory. If

enabled, when a person from LDAP is displayed, users can send an email directly from the email address.

ldap.emailAttribute Name of the email attribute of a person in the LDAP

schema.

ldap.phoneAttribute Name of the telephone number attribute of a person

in the LDAP schema.

ldap.maxRecPage Maximum results displayed on a screen. D efault is 9.

mail.designer.path Path to the application specified in ServiceDesigner

Service Trees. Check the "studio" parameter. For example, if Mail is the service defined for the Mail application, and it is put in a folder called Apps under

Service Trees, then the path should be /Apps/Mail.

ldap.designer.path Used when directory is enabled. Check the

"mail.directoryEnabled" parameter. When the application is running on PTG, but not

studio, then the path to the application specified in ServiceDesigner Service Trees is needed.

For example, if LDAP is the service defined for the Directory Application, and it is put in a folder called Apps under Service Trees, then the path should be /Apps/Ldap.

2-8 Oracle9i Application Server Wireless Edition Configuration Guide

Page 39

Configuration

2.3.0.3.2 Configuring Mail and Directory Parameters through request

Parameters defined this way will override the values defined in the properties file. The following Mail parameters can be passed through request:

Table 2–3 Mail parameters passed through request

CONFIG_FILE Specifies the properties file that defines all the other Mail

properties. This allows multiple properties files for different configurations. By default, the file OracleMobileEmail.properties will be used.

For example, if you want to use the properties file myconfig.properties, put it into the request CONFIG_ FILE=myconfig, and ensure the file is on the classpath.

PTG_VERSION Definition, possible values, and default val ues are the same

as the "oracle.panama.version" in the properties file.

STUDIO Defin ition, possible values, and default values are the same

as the "studio" in the properties file.

MAIL_SERVICE Definition, possible values, and default values are the same

as the "mail.service" in the properties file.

MAILHOST Definition, possible values, and default values are the same

as the "mail.server.name" in the properties file.

MAILPORT Definition, possible values, and default values are the same

as the "mail.server.port" in the properties file.

SMTPHOST Definition, possible values, and default values are the same

as the "mail.smtp.server.name" in the properties file.

SMTPPORT Definition, possible values, and default values are the same

as the "mail.smtp.server.port" in the properties file.

SMTP_LOGIN Definition, possible values, and default values are the same

as the "mail.smtp.server.login" in the properties file.

SENDER_DOMAIN Definition, possible values, and default values are the same

as the "mail.smtp.domain" in the properties file.

INBOX Definition, possible values, and default values are the same

as the "mail.folder.inbox" in the properties file.

SENT Definition, possible values, and default values are the same

as the "mail.folder.sent" in the properties file.

FastForward 2-9

Page 40

Configuration

DOMAIN Definition, possible values, and default values are the same

as the "mail.default.emaildomain" in the properties file.

LOG Definition, possible values, and default values are the same

as the "mail.log" in the properties file.

LOGFILE Definition, possible values, and default values are the same

as the "mail.logger" in the properties file.

MAIL_FETCH_

SIZE

Definition, possible values, and default values are the same as the "mail.msgfetch.setsize" in the properties file.

TIMEOUT Definition, possible values, and default values are the same

as the "mail.server.connect.timeout" in the properties file.

CONFIG Definitio n, possible values, and default values are the same

as the "mail.config.class" in the properties file.

DIR_ENABLED Definition, possible values, and default values are the same

as the "mail.directoryEnabled" in the properties file. USERNAME Username of the user for transparent login. PASSWORD Password of the user for transparent login. If USERNAME is

not sent at the same time, this password will be ignored, and

the user must login. For example, if you want to bypass the

request:

http://myURL/Mail.jsp?USERNAME=myusername&PASS

WORD=mypassword

All the other parameters will be read from the properties file, or the default values will be used. If other parameters are defined property, you can bypass the login. Note that all parameters values are strings. Also, if a parameter is defined through request, it will override the corresponding parameter in the properties file.

The following Directory parameters can be passed through request:

Table 2–4 Directory parameters passed through request

LDAPHOST

LDAPPORT

2-10 Oracle9i Application Server Wireless Edition Configuration Guide

Definition, possible values, and default values are the same as the

"ldap.host" in the properties file.

Definition, possible values, and default values are the same as the

"ldap.port" in the properties file.

Page 41

Configuration

PTG_VERSION

STUDIO

Definition, possible values, and default values are the same as the

"oracle.panama.versi on" in th e pr opert ies file.

Definition, possible values, and default values are the same as the

"studio" in the properties file

All the other parameters will be read from the properties file, or the default values will be used. If other parameters are defined property, you can bypass the login. Note that all parameters values are string. Also, if a parameter is defined through request, it will override the corresponding parameter in the properties file.

2.3.0.3.3 Mail Configuration Class

For Mail configuration, you can define your own configuration class to d o more advanced configuration. For example, select mail server host name based on runtime information.

To do this, you must define a class which implement s

oracle.panama.module.communicate.mail.util.IConfig, and in package oracle.panama.module.communicate.mail.util. In the class, you can define the

following methods:

Table 2–5 Mail configuration class

String getMailService(Object o) Returns the mail service. The current

supported services are IMAP and POP3. String getDomain(Object o) Returns the default mail domain. String getServerName(Object o) Returns the mail server host name. int getServerPort(Object o) Returns the mail server port number. Make

sure it is a valid number. String

Returns the SMTP server host name. getSMTPServerName(Object o)

int getSMTPServerPort(Object o) Returns the SMTP server port number. M ake

sure it is a valid number. String getSMPTLogin(Object o) Returns the login name of the SMTP server.

If login for SMTP is not required, this method

should return null or empty string (""),

otherwise, the value will be used for SMTP

FastForward 2-11

Page 42

Configuration

String getXMLV ersion (Object o) Returns the PTG XML version. Ensure it is

consistent with the "studio" parameters. Currently, studio is running PTG 1.0.

boolean isStudio(Object o) Indicates whether it is running in studio or not.

Ensure it is consistent with the "oracle.panama.version" parameters. Currently, studio is running PTG 1.0.

String getInboxFolderName

Returns the Inbox folder name.

(Object o) String getSentFolderName

Returns the Sent folder name.

(Object o) boolean isLogging(Object o) Indicates if logging is enabled. String getLogfile (Object o) Returns the full path of the log file. String getTimeout (Object o) Returns the connection timeout in

milliseconds.

In the OracleMobileEmail.properties file, change the mail.config.class property to be the class you define.

The input is an object. The default behavior is not to pass any thing. You can change it to pass information such as a string (username for example), or a hashtable containing more information.

If you do not want to implement all of the methods, you can extend from oracle.panama.module.communicate.mail.util.Config. You can choose to override methods, but the rest will be the default implementations. The default is to ign ore the username and pick up the information from the properties file.

Refer to the Javadoc IConfig.html and the Java interface in the doc directory of the install.

2-12 Oracle9i Application Server Wireless Edition Configuration Guide

Page 43

Configuration

2.3.0.3.4 Configuration of URL Adapter in PTG 1.1 ServiceDesigner

Mail and Directory applica t ions can be run through the URL Adapter in PTG 1.1. To do so, you must create a Master Service and a Service Alias. Here are the steps (for details, refer to the PTG documentation):

1. Open Service Designer and connect to a PTG 1.1 instance.

2. Open the Master Services folder at the top level.

You can create a new Master Service in an existing folder or create a new folder and then create the Master Service in that folder. In the example, the Master Service "Mail" is created under the folder "Admin".

IMPORTANT: Oracle Corporation recommends that the service not

to be created at the root level directly under Master Service.

3. Choose URL Adapter for the new service.

4. In the "Input Parameters" tab, under "Value", put the URL of the application.

5. Create a service alias (for example: http://pc1.company.com/mail.jsp) for the

new service under the "Service Trees" folder. The alias should point to the Master Service created. In the example below, the service alias "Mail" is created under the "Apps" folder under "Service Trees". Oracle Corporation also recommends that the alias not be created at the level directly under Service Trees. The alias should point to /master/Admin/Mail.

6. Create an alias for users that points to the service alias created in the previous

step. In the example below, the service alias "Mail" is created under the "Administrator" folder located under "Service Trees". This means the service is available for the user "Administrator".

FastForward 2-13

Page 44

Configuration

Figure 2–1 Service Designer Window

Now you can use e-mail.

2-14 Oracle9i Application Server Wireless Edition Configuration Guide

Page 45

Alert s and SMS Request Listener

Alerts and SMS Request Listener discusses alerts a nd the SMS Request Listener in Wireless Editio n. Each section of this document presents a different topic. These sections include:

■ Section 3.1, "Overview"

■ Section 3.2, "Alerts"

■ Section 3.3, "SMS Request Listener"

■ Section 3.4, "Request and Notification Queue Pool"

Important: In this document WE_HOME is the directory in which

Wire less Edition is installed followed by the "panama" sub-di rectory. For example:

Replace "WE_HOME" with the fully- qualified directory path.

3.1 Overview

Alerts, in the Wireless Edition, are time-based scheduled services. Alerts are executed when the scheduled time expires. The result, if any, after the service is executed, is delivered to the end user at the default alert address. The Wireless Edition can accept either email or phone numbers as the alert address. If the default alert address is an email address, the result is delivered as an email message. If the default alert address is a phone number, the result is delivered as a SMS. The alert

c:\ias10210\ panama (Windows) /private/ias 10210/panama (UNI X)

Alerts and SMS Request Listener 3-1

Page 46

Alerts

3.2 Alerts

and alert address can be created by end users through Wireless Edition personalization from the desktop computer or the device.

Services in Wireless Edition can be invoked through the HTTP protocol and through SMS. Users can invoke the services through SMS with the corresponding service name. However, currently only services without input arguments can be invoked through SMS. The result of the service execution is re turned as another SMS. The capability is provided through the SMS Request Listener. [[Is this still true?]]

Alerts, which are time-based scheduled services, are placed in the request queue when they are created. The result of the alert execution, if any, is placed in the notification queue. The alert functionality in the Wireless Edition requires the installation of the Oracle8i JOB and AQ options.

Important: The aq_tm_processes parameter in the init.ora file

must be set to at least "2" for the processing of asynchronous alerts in Wireless Edition.

3.2.1 Re quest Queue

The request queue stores all the alerts to be executed. The Wireless Edition processes an alert as follows:

1. An alert is crea ted or upda ted with a start date and a specified interval when

the user creates a time-based scheduled service. The alert is placed in the request queue.

2. When the specified time expires, the alert is activated and executed. The result,

if any, is placed in the notification queue with th e alert creator’s default alert address. The alert with an updated next execution time is placed back in the request queue.

3. If the alert fails to be executed for any reason, the alert is not placed back in the

request queue. It can only be reactivated by updating the start date through the Personalization Portal.

3-2 Oracle9i Application Server Wireless Edition Configuration Guide

Page 47

3.2.2 Notification Queue

The result of an alert execution, if any, together with the alert creator’s default alert address, is placed in the notification queue. The Wireless Edition dequeues notification messages out of the notification queue. If the alert address is an email address, the result is sent out as an email message. If the alert address is a phone number, the result is sent out as SMS to the specified phone number.

3.2.3 Email-based Alert

If the result of a delivered alert is an email message, set the follow ing entries in the Notification.properties file in the WE_ HOME\server\classes\oracle\panama\core\admin directory:

# The smtp s erver hostname, m andatory <hostnam e> mail.server. name= # The mail d omain name, set i f SMTP server req uires this <doma inname> mail.domain= # The from m ail address, mand atory <email addr ess> mail.from= # The organi zation, optional <string> mail.organiz ation= # The defaul t mail subject, m andatory <string> mail.subject = # The Conten t-Transfer-Encodi ng, mandatory <st ring> mail.content .transfer.encodin g=

Alerts

3.2.4 SMS-based Alert

If the result of a delivered alert is a SMS message, configure the Notification.properties file in the WE_ HOME\server\classes\oracle\panama\core\admin directory.

3.2.4.1 SMS-C Server

Configure the following entries to specify the host on which the SMS-C is running:

# the hostna me on which the S MS-C is running sms.server.n ame= # the port on the sms.server.name from which the SMS-C is listening the inc oming SMS-message sms.server.p ort=

Generally, the Wireless Edition uses direct TCP/IP communication to the SMS-C server when sending the SMS message. If the UCP protocol is selected, the Wireless

Alerts and SMS Request Listener 3-3

Page 48

Alerts

Edition can also use the URL connection to the SMS-C server when sending the SMS message. In this case, provide the correct URL to the SMS-C server:

sms.server.u rl=

3.2.4.2 SMPP Protocol

If the SMPP protocol is used to communicate between the Wireless Edition and SMS-C when sending the notification message, set:

sms.driver.c lass=oracle.panam a.util.sms.SmsSMP PDriver

Set the following entries with the appropriate values:

# The SMPP s ystem id <string> # sms.smpp.sys tem.id= # # The SMPP s ystem type <strin g> # sms.smpp.sys tem.type= # # The SMPP c lient password <s tring> # sms.smpp.sys tem.password=

3.2.4.3 SMS Protocol

When sending the SMS message, the Wireless Edition can use either the Universal Computer Protocol (either operation 01 or operation 51 co mmand set), or the Short Message Peer-to-Peer (SMPP) protocol to communicate with the SMS-C.

3.2.4.4 UCP Protocol

If the UCP protocol is used to communicate between the Wireless Edition and SMS-C when sending the notification message, set:

sms.driver.c lass=oracle.panam a.util.sms.SmsUCP Driver

Also, specify which command set to use:

sms.ucptype= 01 (for operation 01 command set) sms.ucptype= 51 (for operation 51 command set)

3-4 Oracle9i Application Server Wireless Edition Configuration Guide

Page 49

SMS Request Listener

3.2.4.5 Flow-Control

Configure the following entries for the SMS-control:

# The max nu mber of SMS chunk s per message. <i nt> # sms.message. maxchunks= # # The maximu m number of bytes per message. <in t> # sms.message. maxsize=

3.2.4.6 Wireless Edition SMS System Account for SMS-C

If there is a dedicated SMS system account created at SMS-C for the Wireless Edition to send the SMS to, configure the following entries appropriately:

# Wireless E dition SMS System Account Id sms.account. id # The corres ponding password sms.account. password

3.3 SMS Request Listener

Note: The follow ing configuration is not required if the SMS

Request Listener will not be provided to the end user.

The SMS Request Listener allows the invocation of any Wireless Edition service using a SMS message. The SMS Request Listener processes the SMS-based service invocation request and returns the result, if any, as a SMS message by performing the following:

1. Authenticate the user by finding the alert address with the actual phone

number.

2. Invoke the service.

3. Place the result, if any, after invoking the service, in the notification queue.

Alerts and SMS Request Listener 3-5

Page 50

Request and N otifi cat ion Q ueu e Pool

To configure the SMS Request Listener:

1. Include oracle.panama.util.sms.SmsServer as anothe r daemon thread in the

locator.request.daemon.classes entry in the System.properties file in the WE_ HOME/server/classes/oracle/panama/core/admin directory.

2. Configure the SMS protocol. See Section 3.2.4.3.

3. If the UCP protocol is used when configuring the SMS protocol, set:

sms.receiver .listener.mode=tr ue

If the SMPP protocol is used when configuring the SMS protocol, set:

sms.receiver .listener.mode=fa lse

5. If the UCP protocol is used, set the incoming listener port appropriately:

sms.receiver .listener.port=

3.4 Request and Notification Queue Pool

To improve the throughput for request and notification processing, configure the number of threads that process the corresponding queue.

3.4.1 Request Queue T hread Pool Size

To configure the thread pool size for the request queue, set the following appropriately in the AsynchRequest.properties file in the WE_ HOME/server/classes/oracle/panama/core/admin directory:

# Thread poo l size at startup # init.pool.si ze= # # Minimum Th read pool size # minimum.pool .size=

3.4.2 Notif ic at io n Qu eu e Th r ea d Pool Size

To configure the thread pool size for the notification queue, set the following appropriately in the AsynchNotification.properties file in the WE_ HOME/server/classes/oracle/panama/core/admin directory:

# Thread poo l size at startup

3-6 Oracle9i Application Server Wireless Edition Configuration Guide

Page 51

# init.pool.si ze= # # Minimum Th read pool size # minimum.pool .size=

Request and Notification Queue Pool

Alerts and SMS Request Listener 3-7

Page 52

Request and N otifi cat ion Q ueu e Pool

3-8 Oracle9i Application Server Wireless Edition Configuration Guide

Page 53

The document describes the logging capability of Wireless Edition. Each section of this document presents a different topic. These sections include:

■ Section 4.1, "Overview"

■ Section 4.2, "Database Logging"

■ Section 4.3, "Service Designer Logging"

■ Section 4.4, "Server Logging"

■ Section 4.5, "Transaction Logging"

■ Section 4.6, "Configuring the Runtime Monitor and Management"

4.1 Overview

Logging

Wire less Edition generates logging information for both the server and development client components.

4.2 Database Logging

Wireless Edition database logging records each authenticated service invocation request and each successful user session. Database logging is required for performance monitoring and measurement using Oracle Enterprise Manager. The logged information includes service access pa tterns, response times for services, and the number of sessions. This data can be used by remote management tools to display results such as service access patterns, throughput, and average response times. Database logging is handled asynchronously.

Logging 4-1

Page 54

Database Logging

4.2.1 Configurin g the Database Logger

The database logger of a Wireless Edition instance must point to a database schema to log the information. This conf iguration is done in the System.properties file of each Wireless Edition instance.

# #System Logger rel ated parameters #

# Number of minutes after whi ch the logger thr ead wakes up to flush # the log entries to the data base. This parameter is option al. SystemLog.lo gger.wakeupFreque ncy=10

# The maximu m number of entri es cached by the logger thread. # This param eter is optional. SystemLog.lo gger.maxSize=100

# Whether service log ging should be enabled SystemLog.en ableServiceLoggin g=true

# Whether session log ging should be enabled SystemLog.en ableSessionLoggin g=true

# The reques t listener class locator.requ est.listener.clas ses=oracle.panama .core.admin.Syst emLogger

# The sessio n listener class locator.sess ion.listener.clas ses=oracle.panama .core.admin.Syst emLogger

# Enable eve nt request loggin g event.before .request=true event.reques t.end=true event.reques t.error=true event.after. request=true

# Enable eve nt session loggin g event.sessio n.begin=true event.sessio n.end=true

# System Log Database connect string <String> # Syntax for this property is similar to db.co nnect.string # System Logs can be prese nt in a separate database # # NOTE: For the OEM cartrige queries, Make sur e the user speci fied below has

4-2 Oracle9i Application Server Wireless Edition Configuration Guide

Page 55

select acces s to the V$ table s. # Usage example: log in as system and say "grant select any table to %PANA MA_ USERNAME%" #SystemLog.d b.connect.string= %PANAMA_USERNAME% /%PANAMA_USER_PW %@%PANAMA_ HOST%:%PANAM A_PORT%:%PANAMA_S ID%

If the SystemLog.db.connect.string parameter is set, logged information is stored in a separate database. This parameter should not be set if the logged information is to be stored in the same repository.

Note: The database user name used here (the one replacing

%PANAMA_USERNAME%) must have select access to all tables. In this example "PANAMA" is Wireless Edition.

4.2.2 Database Table Contents

Data logged to the database is stored in two tables, ptg_service_log and ptg_ session_log.

Database Logging

Table 4–1 Contents of the ptg_session_log Table

Column Name Description

session_id The identifier of the session. user_id The Object Identifier (OID) of the user of the session. user_name The user name. ptg_instance_id A unique identifier, for the database instance. logical_device The logical device which invoked the service. login_time The timestamp when the session was created. login_hour The hour when the session was created. expiry_time The timestamp when the session expired. timestamp The time when the data is logged.

Logging 4-3

Page 56

Database Logging

Table 4–2 Contents of the ptg_service_log Table

Column Name Description

service_id Object Identifier (OID) for the invoked service. service_name Name of the invoked service. ptg_instance_id Unique identifier, for the database instance. final_service_id OID of the final service, for example the master service or folder. final_service_name Name of the final service. session_id Session identifier for which the service was invoked. service_arguments Arguments of the service, in XML format. bookmark External link, if the invoked service is a bookmark. service_type Type of service. invocation_hour Hour when the service was invoked. invocation_time Date when the service was invoked. response_time Response time for the service. request_status Status of the request, a non-zero value indicates an error

number . error_description Error message, if one occurred while invoking the service. user_id OID for the user. user_name Name of the user. remote_address Host IP address and n ame. logical_device Logical device which invoked the service. external_user_id External user ID. external_use r_name External user name. adapter_type Type of adapter. adapter_home Time taken by the adapter. transformatio n_time Time taken by the transfo rmer. timestamp Time when the data is logged.

4-4 Oracle9i Application Server Wireless Edition Configuration Guide

Page 57

4.3 Service Designer Logging

By default, the Service Designer writes error information to the log directory of the Service Designer home directory. You can modify this setting, and the log naming pattern, in the preferences.xml file. The file is in the WE_ HOME/tools/ServiceDesigner/resources directory.

4.4 Server Logging

The Wireless Edition w rites server error information to the files and directory specified in the System.properties file. You can open the log files directly, or view them from the Wireless Edition Runtime Information and Management interface (the Probe interface) at port 8090. Click the "Files" link.

The Wireless Edition specifies these types of errors:

Table 4–3 Server Error Information

Error Value

Transaction Logging

ERR_SERVICE_UNAVAILABLE PTG-001 ERR_SERVICE_ERROR PTG-002 ERR_SERVICE_NOT_FOUND PTG-003 ERR_CONFIGURATION_ERROR PTG-004 ERR_INTERNAL_ERROR P TG-005 ERR_DATABASE_ERROR PTG-006

In addition to error messages, the Wireless Edition provides extensive runtime exception logging. When fatal exceptions occur, the Wireless Edition logs the exceptions and stack traces in the global log fil e. If yo u need to contact Oracle Support Services, you should have the log information available.

4.5 Transaction Logging

The transaction log is a log file on the Wireless Edition server that provides information regarding user access. To enable transaction logging, you must include transaction logging as a log level in the System.properties file. For example:

log.level=Wa rning, Error, Not ify, Transaction

Logging 4-5

Page 58

Configuring the Runtime Monitor and Management

You can use the System.properties file to set the directory to which the Wireless Edition writes transaction logs, a nd to specify a file name pattern for the log files. You can also configure the transaction record pattern.

If you enable transaction logging when a user accesses a service that has a cost value set, the transaction log generates data. You can set a cost for a master service using the Wireless Edition Service Designer. You can access the transaction log data programmatically, to generate billing information or to integrate the Wireless Edition transaction information with an external billing man agement system.

The following sample shows the log results of four stock quote queries by a single user. The sample uses the default logging pattern, which you can modify in the System.properties file. It lists the time of access, the user name (Sample), the service, and the price per access (25):

[11/14/99 4:03: 26 PM] Sample /master/OnlineQuo teOracle 25 [11/14/99 4:03: 29 PM] Sample /master/OnlineQuo teOracle 25 [11/14/99 4:03: 35 PM] Sample /master/OnlineQuo teOracle 25

4.6 Configuring the Runtime Monitor and Management

The probe is a daemon that displays runtime information about:

■ Log files

■ Active objects

■ Active sessions

■ Active threads

The probe performs simple runtime management including:

■ Shutting down an active object instance.

■ Refreshing persistent attributes on an active object.

■ Setting the global debug flag to on or off.

■ Reloading properties for device recognition when adding a new device to a

running system.

By default, installation of Wireless Edition installs and initiates the probe runtime monitor with the listening port 8090. To access the probe from a browser enter the following URL:

http://host_name:8090

4-6 Oracle9i Application Server Wireless Edition Configuration Guide

Page 59

Configuring the Runtime Monitor and Management

You can configure the probe component by editing the www-server .properties file in the WE_HOME/server/classes/o racle/panama/core/probe directory. The following daemon manages the implementation:

oracle.panam a.core.probe.WebS erver

Logging 4-7

Page 60

Configuring the Runtime Monitor and Management

4-8 Oracle9i Application Server Wireless Edition Configuration Guide

Page 61

Multiple JVM Support and Load Balancing

Multiple JVM Support and Load Balancing describes multiple Java Virtual Machine (JVM) support in Wireless Edition. Each section of this document presents a different topic. These sections include:

■ Section 5.1, "Overview"

■ Section 5.2, "Multiple Instances on Same Machine as Oracle HTTP Server"

■ Section 5.3, "Multiple Instances on the Same Machine/Oracle HTTP Server on

Different Machine"

■ Section 5.4, "Multiple Instances and Oracle HTTP Server All on Different

Machines"

■ Section 5.5, "Load Balancing"

■ Section 5.6, "Configuring the Personalization Portal for Load-Balancing"

Note: Oracle recommends that each Java Virtual Machine (JVM)

not support more than 20 0 concurrent user sessions.

Multiple JVM Support and Load Ba lancing 5-1

Page 62

Overview

5.1 Overview

The following sections describe three possible deplo yment scenarios for multiple Java Virtual Machine (JVM) support in Wireless Edition:

■ Section 5.2, "Multiple Instances on Same Machine as Oracle HTTP Server"

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/ias 10210/panama (UNI X)

Replace "WE_HOME" with the fully-qualified directory path.

■ ORACLE_HOME is the directory in which Oracle9i

Application Server is instal led.

■ Section 5.3, "Multiple Instances on the Same Machine/Oracle HTTP Server on

Different Mac h i ne"

■ Section 5.4, "Multiple Instances and Oracle HTTP Server All on Different

Machines"

This document describes:

■ The Cache synchronization setup (to ensure that the object caches of each

instance are synchronous).

■ Multiple JVM environment without JServ session cookies.

■ Personalization Portal s et up.

Note: The steps in this document assume an initial configuration

of single JVM support. Verify that Wir eless Edition is initially set up to run as a single instance communicating with a single Oracle HTTP Server instance.

5-2 Oracle9i Application Server Wireless Edition Configuration Guide

Page 63

Multiple Instances o n Same M achin e as Ora cle H TTP S erver

5.2 Multiple Instances on Same Machine as Oracle HTTP Server

To configure multiple JVM instances on the same machine:

1. Modify the jserv.conf file so the Oracle HTTP Server is aware of the multiple

JServ instances that are running. Start each of these JServ instances manually. Insert the following statements after any existing statements in the section that begins with <IFModule> and ends with </IFModule> in the jserv.conf file. The jserv.conf file is in the ORACLE_HOME\Apache\JServ\conf directory.

a. Modify the following:

<IfModule mod_j serv.c> ApJServManua l on

Running multiple insta nces of JServ requires a manual start for each instance:

ApJServMount /ptg balance://s et1/root

W1, W2,...WN are integers that determine the load-balancing weight

assigned to each of the instances. T o balance equally among all instances; do not specify Wx; the weight value must be an integer. Weight can be decided on the relative load you want each JServ to handle. Requests for /ptg are load-balanced on set "set1":

ApJServBalan ce set1 PC1 W1 ApJServBalan ce set1 PC2 W2 . . ApJServBalan ce set1 PCN WN

Port numbers can be any valid port on the system, however they should not

conflict with any other application using the same port.

ApJServHost PC1 ajpv12://localhost:77 71 ApJServHost PC2 ajpv12://localhost:77 72 . . ApJServHost PCN ajpv11://localhost:77 7N

JS1 to JSN are routing cookies. These can be set to any unique string for

each entry.

ApJServRoute JS1 PC1

Multiple JVM Support and Load Ba lancing 5-3

Page 64

Multiple Instances on Same Machine as Oracle HTTP Server

ApJServRoute JS2 PC2 . . ApJServRoute JSN PCN

This file is used internally by Apache for implementing fault tolerance:

ApJServShmFi le ORACLE_HOME\Apache\J serv\jserv_shm

g. Close the section using:

</IfModule>

2. Start the Oracle HTTP Server.

ORACLE_HOME\ Apache\Apache\Apache .exe -k start -d ORACLE_HOME\ Apache\Apache

Create and modify the jserv.properties files for each of the instan ces. Make

copies of the default jserv.properties files for each of the instances, for example, jserv1.properties, jserv2.properties. The jserv.properties file is in the

ORACLE_HOME\Apache\JServ\conf directory. Modify the files:

a. Port which the instance uses to communicate with Apache using the AJP

protocol. x corresponds to each of the JServ instances 1...N.

port=777x

The log file. For Unix, ensure that the JServ process owner has write permissions for this file:

log.file=ORA CLE_HOME\Apache\J serv\logs\jservx. log

c. This allows only clients from the local machine to access the JServ instances:

security.all owedAddresses=127 .0.0.1

d. Change the location of class files specific to the JServ instance from:

wrapper.clas spath=<WE_HOME>\s erver\classes

to:

wrapper.clas spath=<WE_HOME>\s erver\classesx

4. To enable cache synchronization among the database instances, mo dify the

Wireless Edition specific properties files. The default location for these files is in the <WE_HOME>\server\classes directory. Create copies of this directory

5-4 Oracle9i Application Server Wireless Edition Configuration Guide

Page 65

Multiple Instances o n Same M achin e as Ora cle H TTP S erver

structure and modify the structure so that each of the JServ instances have unique port numbers and other resources. For example, these directories should appear as <WE_HOME>\server\classesx, where x corresponds to each of the JServ instances 1...N. Modify the System.properties file in the <WE_ HOME>\server\classesx\oracle\panama\core\admin directory:

a. Set the unique identifier for the instance. x corresponds to each of the JServ

instances 1...N.

instance.ide ntifier=instancex

b. Set the following parameter to true for every instance to ensure that the

instance participates in cache synchronization:

participateI nCacheSynchroniza tion=true

c. This value should point to the machine and port where the Master Instance

for Cache synchronization is running. It should have the same value for all instances. Ensure that the port number (2007 in this case) is the same as the one specified by the rmi.registry.port parameter in the Master.properties file:

masterInstan ce.url=//localhos t:2007

Modify the properties files in Table 5–1. These files are in the <WE_

HOME>\ser v er \c l as s e s x \o r ac l e \ p anama\core director y. The sub-directories are specified.

e. Run the following SQL scripts by connecting to the repository database as

the Wireless Edition database user. The scripts are provided in the <WE_ HOME>\server\classesx\oracle\panama\sql directory.

create_cache sync_schema.sql enable-cache synch_triggers.sq l

The master server must be started by running the script <WE_

HOME>\ser v e r\c l a s s e s x \o r ac l e\panama\sample\runM a st e r S e r ve r.bat or runMasterServer .sh.

Multiple JVM Support and Load Ba lancing 5-5

Page 66

Multiple Instances on Same Machine as Oracle HTTP Server

Table 5–1 Property File Settings

Property File Setting

\admin\AsynchNotification.properties server .listen.port=5500x \core\admin\AsynchRequest.properties server.listen.port=6500x \core\admin\Ftp.properties ftp.server.port=910x \core\admin\Notification.properties sms.server.port=5000x \core\admin\Rmi.properties rmi.server.port=201x

The port number on which the RMI server runs. \probe\www-server.properties port=809x \magent\config\MAgent.properties magent.server.port=201x

Same as rmi.server.port in Rmi.properties. \spatial\spati al.properties Change path to class files to refl ect the per

instance classes. \Master\Master.properties Modify the db.connect parameter in this file t o be

the same as that in System.properties.

Modify only the Master.properties file in the

classpath of the master instance.

ptgInstances.length=N

ptgInstance1.rmi.host=localhost

ptgInstance1.rmi.port=2011 (This is the value of

rmi.server.port in the Rmi.properties file.)

ptgInstance1.rmi.objectName=CacheSyncClient

(Do not change CacheSyncClient to any other

value.)

ptgInstance2.rmi.host=localhost

ptgInstance2.rmi.port=2012

ptgInstance2.rmi.objectName=CacheSyncClient

ptgInstanceN.rmi.host=localhost

ptgInstanceN.rmi.port=201N

ptgInstanceN.rmi.objectName=CacheSyncClient

Start each of the JServ instances manually after the Oracle HTTP Server is

started. Create a batch script to supply all the class es specif ied in the

5-6 Oracle9i Application Server Wireless Edition Configuration Guide

Page 67

Multiple Instances and Oracle HTTP Server All on Different Machines

jserv.properties file to Java as part of the classpath. See Section 5.6.3 for a sample batch script.

5.3 Multiple Instances on the Same Machine/Oracle HTTP Server on Different Machine

The steps are the same as in Section 5.2 except for the following:

1. While configuring jserv.conf change the ApJServHost directive so that the

Oracle HTTP Server points to the machine running the JServ instances, by specifying its IP address. For example:

ApJServHost PC1 ajpv12://jserv-machin e:7771 ApJServHost PC2 ajpv11://jserv-machin e:7772 . . ApJServHost PCN ajpv11://jserv-machin e:777N

These port numbers can be any valid port on the machine running JServ instances, only that they must not co nflict with any other application using the same port.

2. In each of the jserv.propertiesx files, change the bindaddress parameter to the

IP address of the machine running the JServ instance, and the security.allowedAddresses parameter to point to the IP address of the machine running the Oracle HTTP Server. For example:

bindaddress= ip_address_of_mac hine_running_jser v_instance security.all owedAddresses=192 .168.1.2

5.4 Multiple Instances and Oracle HTTP Server All on Different Machines

The steps are similar to Section 5.2, in addition:

1. Modify the jserv.conf file on the machine running the Oracle HTTP Server.

Ensure that the ApJServHost directive includes the IP addresses of each of the machines running the JServ instances. For example:

ApJServHost PC1 ajpv12://jserv-machin e1:8007 ApJServHost PC2 ajpv11://jserve-machi ne2:8007 . . ApJServHost PCN ajpv11://jserv-machin eN:8007

Multiple JVM Support and Load Ba lancing 5-7

Page 68

Multiple Instances and Oracle HTTP Server All on Different Machines

2. Start the Oracle HTTP Server.

3. On each machine running the JServ instances, modify the jserv.properties file:

bindaddress= ip_address_of_mac hine_running_jser v_instance security.all owedAddresses=ora clehttpserver_ip_ address

On the machine running the Master Instance, modify the Master.properties file. See Table 5–1 for more information.

5. Modify the system.properties file in the <WE_

HOME>\server\classes\oracle\panama\core\admin directory on all machines:

a. Set the unique identifier for the instance:

instance.ide ntifier=instancex

b. Set the following parameter to true to ensure that the instance participates

in cache synchronization:

participateI nCacheSynchroniza tion=true

c. Set the following parameter to point to the machine and port where the

Master Instance for Cache synchronization is running. It should have the same value for all instances. Ensure that the port number (2007 in this case) is the same as the one specified by the rmi.registry.port parameter in the Master.properties file.

masterInstan ce.url=//machine_ running_master_in stance:2007

Run the SQL script enable_cachesync_schema.sql by connecting to the repository database as the Wireless Edition database user. The script resides, by default, in the <WE_HOME>\sql directory.

e. Start the master server on the machine running the master instance by

running the script runMasterServer.bat in the <WE_HOME>\sample directory.

6. Start each of the JServ instances manually using the batch script. See

Section 5.6.3 for a sample script.

5-8 Oracle9i Application Server Wireless Edition Configuration Guide

Page 69

Configuring the Personalization Portal for Load-Balancing

5.5 Load Balancing

When multiple instances are running, load balancing ca n be performed by a separate machine. For example, there could be several Oracle HTTP Server instances, each with a set of JServ instances balanced on a one-to-many basis by this machine. The Oracle HTTP Server instances can perform load balancing by using a hardware load balancer in front of the Oracle HTTP Server instances.

The main purpose of multiple JVM support in Wireless Edition is to provide scalability through load-bala ncing. There are three implementations when setting up load-balancing.

■ Load-balancing among Oracle HTTP servers through hardware load-balancing.

■ Load-balancing among Jserv instances with cookies.

■ Load-balancing among Jserv instances with U RL rewriting.

5.5.1 Load-Balancing with Cookies

When intermediate gateways or proxies and the clients support cookies, load balancing can be achieved using cookies:

1. Set the enable.http.session.binding parameter in all of the System.properties

files (on all machines, if more than one machine is involved) to true.

2. In the ORACLE_HOME\Apache\JServ\conf\zone.properties file set the

session.useCookies parameter to true.

5.5.2 Load Balancing Through URL Rewriting

When intermediate gateways or proxies do not support cookies, load balancing can be achieved through URL rewriting:

1. Set the enable.http.session.binding parameter in all of the System.properties

files (on all machines, if more than one machine is involved) to true.

2. In the ORACLE_HOME\Apache\JServ\conf\zone.properties file set the

session.useCookies parameter to false.

5.6 Configuring the Personalization Portal for Load-Balancing

This section describes the configuration of the Personalization Portal in two environments:

Multiple JVM Support and Load Ba lancing 5-9

Page 70

Configuring the Personalization Portal for Load-Balancing

■ Section 5.6.1, "Clients/Gateways Support Cookies"

■ Section 5.6.2, "Clients/Gateways Do Not Support Cookies"

5.6.1 Clients/Gateways Support Cookies

To set up the Personalization Portal when clients and/or interm ed iate gateways support cookies, enable one of the load-balanced Wireless Edition instances to service Personalization Portal requests. Modif y the jserv.conf file to change the value of the ApJServDefaultPort parameter to the port number of any of the load-balanced instances (ApJServDefaultPort 7771).

5.6.2 Clients/Gateways Do Not Support Cookies

To set up the Personalization Portal when clients and/or intermediate gateways do not support cookies, run a sep ara te Wireless Edition instance to se rvice Personalization Portal requests.

1. Modify the jserv.conf file to change the value of the ApJServDefaultPort

parameter to the port number of any unoccupied port (ApJServDefaultPort

7774).

2. Create a copy of the jserv.properties file, for example, jserv4.properties

(assuming that there are three load-balanced instances runnin g) for each of the instances and modify the following:

a. Set the port which the instance uses to communicate with Oracle HTTP

Server using the AJP protocol. This should be the same as the value set for the ApJServDefaultPort parameter in the jserv.conf file.

port=7774

b. Set the log file. For UNIX ensure that the JServ process owner has write

permissions for this file.

log.file=ORA CLE_HOME\Apache\J serv\logs\jserv4. log

c. Ensure that only the Oracle HTTP Server talks to this JServ ins tance:

security.all owedAddresses=ora clehttpserver_ip_ address

d. Change wrappe r.classpa t h=<WE_HOME>\server\class e s to

wrapper.classpath=<WE_HOME>\server\classesx. This is the location of class files specific to the JServ instance.

5-10 Oracle9i Application Server Wireless Edition Configuration Guide

Page 71

Configuring the Personalization Portal for Load-Balancing

Copy the default zone.properties file in ORACLE_HOME\Apache\Jserv\conf to zone_pp.properties. In this file, ensure that the session.useCookies parameter has a value of true.

root.propert ies= ORACLE_HOME\ Apache\Jserv\conf \zone_pp.propert ies

4. Modify the various Wireless Edition specific properties files. The default

location for these files is in the <WE_HOME>\server\classes directory. Create a copy of this directory and modify the properties files so that each of the JServ instances has a unique port num b e r and other resources. For example, the directory should appear as <WE_HOME>\server\classes. In the <WE_ HOME>\server\classes4\oracle\panama\core\admin\ directory, modify the System.properties file.

a. Set the unique identifier for this instance:

instance.ide ntifier=instance

b. Set the following parameter to true to ensure that the instance participates

in cache synchronization:

participateI nCacheSynchroniza tion=true

Set the enable.http.session.binding to false.

c. d. Set the following to point to the machine and port where the Master

Instance for Cache synchronization is runnin g. It should have the same value for all instances. Ensure that the port number (2007 in this case) is the same as the one specified by the rmi.registry.port parameter in the Master.properties file on the machine running the Master instance.

masterInstan ce.url=//localhos t:2007

Set the following in the AsynchNotification.properties file in the <WE_

HOME>\server\classes\oracle\panama\core\admin \ d irectory to:

server.liste n.port=5500

f. Set the following in the AsynchRequest.properties file in the <WE_

HOME>\server\classes\oracle\panama\core\admin \ d irectory to:

server.liste n.port=6500

g. Set the following in the Ftp.properties file in the <WE_

HOME>\server\classes\oracle\panama\core\admin \ d irectory to:

ftp.server.p ort=910

Multiple JVM Support and Load Balancing 5-11

Page 72

Configuring the Personalization Portal for Load-Balancing

h. Set the following in the Notification.properties file in the <WE_

HOME>\server\classes\oracle\panama\core\admin \ d irectory to:

sms.server.p ort=5000

Set the following in the Rmi.properties file in the <WE_

HOME>\server\classes\oracle\panama\core\admin\ d irectory. This is the port number on which the RMI server runs:

rmi.server.p ort=201

j. Set the following in the www-server.properties file in the <WE_

HOME>\server\classes\oracle\panam a\core directory:

port=809

Set the following in the MAgent.properties file in the <WE_ HOME>\server\classes\ora c le\panama\magent\config directory. This is the same as the rmi.server.port setting in Rmi.properties in the <WE_ HOME>\server\classes\oracle\panama\core\admin d irectory.

magent.serve r.port=201

l. Set the path to the class files to reflect the per instance classes in the

Spatial.properties file in the <WE_ HOME>\server\classes\oracle\panama\spatial\ directory.

Now the instance can be started using the batch file in Section 5.6.3.

5.6.3 Sample Batch File

The following is a sample batch file for manually starting and stopping Oracle HTTP Server. Classes for hooks or other features should be added at the end of the file.

@ECHO OFF set classpath=% classpath%;ORACLE_HO ME\java\lib;PORACLE _HOME\Apache\jdk\li b set classpath=% classpath%;ORACLE_HOME \Apache\Jserv\Apache Jserv.jar set classpath=% classpath%;ORACLE_HOME \Apache\Jsdk\lib\jsd k.jar set classpath=% classpath%;<WE_HOME>\s erver\classes%1 set classpath=% classpath%;<WE_HOME>\l ib\panama.zip set classpath=% classpath%;<WE_HOME>\l ib\panama_core.zip set classpath=% classpath%;<WE_HOME>\l ib\panama_portal.zip set classpath=% classpath%;<WE_HOME>\l ib\panama_papz.zip set classpath=% classpath%;ORACLE_HOME \jdbc\lib\classes12. zip

5-12 Oracle9i Application Server Wireless Edition Configuration Guide

Page 73

Configuring the Personalization Portal for Load-Balancing

set classpath=% classpath%;ORACLE_HOME \jsp\lib\ojsp.jar set classpath=% classpath%;ORACLE_HOME \lib\servlet.jar set classpath=% classpath%;ORACLE_HOME \Apache\BC4J\lib\jnd i.jar set classpath=% classpath%;ORACLE_HOME \lib\xmlparserv2.jar set classpath=% classpath%;<WE_HOME>\l ib\client.zip set classpath=% classpath%;<WE_HOME> \lib\server.zip set classpath=% classpath%;<WE_HOME> \lib\caboshare-opt- 1_0_0.zip set classpath=% classpath%;<WE_HOME> \lib\marlin-opt-1_0 _0.zip set classpath=% classpath%;<WE_HOME> \lib\ocelot-opt-1_0 _0.zip set classpath=% classpath%;<WE_HOME> \lib\share-opt-1_1_ 7.zip set classpath=% classpath%;<<WE_HOME >>\lib\tecate-opt-1 _0_0.zip set classpath=% classpath%;<WE_HOME> \lib\regexp.jar set classpath=% classpath%;<WE_HOME>\l ib\sax2.jar set classpath=% classpath%;<WE_HOME>\l ib\activation.jar set classpath=% classpath%;<WE_HOME> \lib\mail.jar set classpath=% classpath%;<WE_HOME>\l ib\ldap.jar set classpath=% classpath%;<WE_HOME>\l ib\ldapbp.jar set classpath=% classpath%;<WE_HOME>\l ib\providerutil.jar set classpath=% classpath%;<WE_HOME>\l ib\sdoapi.jar set classpath=% classpath%;<WE_HOME>\l ib\sdovis.jar set classpath=% classpath%;<WE_HOME>\l ib\MapQuestX.jar set classpath=% classpath%;<WE_HOME>\l ib\MQJavaCore.jar set classpath=% classpath%;<WE_HOME>\l ib\RoutingJServerCli ent.jar set classpath=% classpath%;<WE_HOME>\l ib\jai_codec.jar set classpath=% classpath%;WE_HOME\l ib\classes%1 REM Add oth er classpath entr ies here for spec ific features or hooks implemente d REM by the customer. java -c %org .apache.jserv.JSe rv ORACLE_HOME\Ap ache\JServ\conf\ jserv%1.propertie s

This script (in the example, jservmanual.sh) can be used in the following manner to start and stop a Jserv instance:

■ To start instance 1, us e:

jservmanual. sh 1

■ To stop an instance, use:

jservmanual. sh 1 -s

Multiple JVM Support and Load Balancing 5-13

Page 74

Configuring the Personalization Portal for Load-Balancing

5-14 Oracle9i Application Server Wireless Edition Configuration Guide

Page 75

Oracle Enterprise Manager

Oracle Enterp rise Manager describes the use of Oracle Enterprise Manager with Wireless Editio n. Each section of this document presents a different topic. These sections include:

■ Section 6.1, "Overview"

■ Section 6.2, "Prerequisites"

■ Section 6.3, "Configuring the Server, Client, and Middle-tier"

■ Section 6.4, "Setting up the ptg_services.tcl File"

■ Section 6.5, "Configuration for Another W ir eless Edition Instance"

■ Section 6.6, "Configuring the Database Logger"

■ Section 6.7, "Asynch ronous Notification of Error Information"

■ Section 6.8, "Launching the Oracle Enterprise Manager Tools"

Important: In this document:

■ WE_HOME is the directory in which Wireless Edition is

Replace "WE_HOME" with the fully- qualified directory path.

■ ORACLE_HOME is the Oracle 8.1.7 Oracle home.

installed followed by the "panama" sub-directory. For example:

c:\ias10210\ panama (Windows) /private/ias 10210/panama (UNI X)

Oracle Enterprise Manager 6-1

Page 76

Overview

6.1 Overview

The use of Oracle Enterprise Manager with Wireless Edition provides:

■ Performanc e mo ni t or i n g

■ Fault management

■ Configuration management

Performance Monitoring

The Oracle Enterprise Manager Diagnostic Pack includes Performance Manager and Capacity Planner. The Performance Manager is a Windows NT client side tool for viewing performance data collected by the Wir eless Edition Cartridge. The Capacity Planner allows you to archive and view performance data collected by th e Wireless Edition cartridge. This cartridge is used by the Data Gatherer to collect performance data logged by the Wireless Edition runtime.

Fault Management

The event framework of Oracle Enterprise Manager enables asynchronous notification of error information. When an error occurs , Wireless Edition generates an Oracle Enterprise Manager event at the node where the error occurred. The event provides the details necessary for fault diagnosis. The Ora cle Intelligent Agent running on each node picks up these events and forwards them to the Oracle Enterprise Manager Console for display. You can configure the Console to page or email the administrator.

Configuration Management

The configuration management framework provides a way to alter some runtime parameters.

6.2 Prerequisites

To configure Oracle Enterprise Manager for use with Wireless Edition you must first install the following components:

■ Oracle Enterprise Manager 2.2 with Diagnostic Pack

■ Oracle Intelligent Agent 8.1.7

■ Oracle Management Server 2.2

6-2 Oracle9i Application Server Wireless Edition Configuration Guide

Page 77

Configuring the Server, Client, and Middle-tier

6.3 Configuring the Server, Client, and Middle-tier

The Oracle Enterprise Manager configuration includes server side, client side, and middle tie r co n f i gu r ation instruction s:

■ The Oracle Enterprise Manager server side configuration involves the Oracle

Intelligent Agent and Data Gatherer. See Section 6.3.1.

■ The Oracle Enterprise Manager client side configura tion involves the Console

(the navigator and events) and Diagnostic Pack (Performance Manager and Capacity Planner). See Section 6.3.2.

■ The Oracle Enterprise Manager middle-tier configuration involves the Oracle

Management Server, specifically the configura tion to receive threshold events from the Data Gatherer Cartridge on the Console. See Section 6 .3.3.

6.3.1 Configuring the Server Side

The server side configuration includes the config uration of the Oracle Intelligent Agent and the Wireless Edition Data Gatherer Cartridge.

6.3.1.1 Configuring the Oracle Intelligent Agent

To configure the Oracle Intelligent Agen t on the server:

1. Install the Oracle Intelligent Agent 8.1.7 in ORACLE_HOME. If the Oracle

Management Server is to reside on the same host as the Oracle Intelligent Agent, ensure that the Oracle Management Server is also installed in the same ORACLE_HOME.

Note: If running Orac le 8.1.6, perform a custom installation of

Oracle 8.1.7 Enterprise Edition. Select the Oracle Intelligent Agent and its subcomponents . In stall it in a separate ORACLE_HOME.

2. Copy the file dgmetric.tcl from the WE_HOME/oem/agent directory to the

Oracle Intelligent Agent ORACLE_ HOME/netwo r k /ag e n t /ev e n t s/ oracle/generic/metric directory. This operation replaces the existing dgmetric.tcl file.

3. Copy the file ptg_services.tcl from the WE_HOME/oem/ agent directory to the

ORACLE_HOME/network/agent/config directory.

Oracle Enterprise Manager 6-3

Page 78

Configuring the Server, Client, and Middle-tier

Append the ptg_services.tcl file name to the nmiconf.1st file found in the ORACLE_HOME/network/agent/config directory.

The agent discovers the Wireless Edition service using these files.

5. Edit the ptg_services.tcl file to configure the instance(s) information. See

Section 6.4 for instructions on setting up the ptg_services.tcl file. Configur ation

for a default instance name (PTG1) is provided as an example.

Note: The Oracle Intelligent Agent must be restarted whenever

any change is made to the ptg_services.tcl file or to the nmiconf.lst file.

After completing the preceding instructions, install the Wireless Edition Data Gatherer cartridge. The Oracle Intelligent Agent uses this cartridge to collect Wireless Edition performance data. The Performance Manager and Capacity Planner use the collected data to provide runtime metrics for diagnosis.

The cartridge installation steps differ according to the hardware platform.

6.3.1.2 Wireless Edition Data Gatherer Cartridge Installation: Unix

To install the data gatherer cartridge:

Important: The cartridge installation requires an Oracle Enterprise

Manager 2.2 Console and Oracle Intelligent Agent 8.1.7 on the server side.

1. Un-t ar t he ptgsolariscartridge.tar file found in WE_

HOME/oem/agent/cartridge/solaris to a directory (referred to as CART_DIR in this document).

2. Copy CART_DIR /lib/libvpxptg.so to the ORACLE_HOME/odg /lib directory.

3. Copy CART_DIR/mesg/vpxptgus.msb to the ORACLE_HOME/odg/mesg

directory.

4. Copy CART_DIR /html/vpxptgUS.htm to the ORACLE_HOME /odg/html

directory.

6-4 Oracle9i Application Server Wireless Edition Configuration Guide

Page 79

Configuring the Server, Client, and Middle-tier

Append the following entry to the svppcart.dat file in the ORACLE_ HOME/odg directory.

PTG ALL libvpxptg vpx ptg

This completes the server side configuration. Restart the Oracle Intelligent Agent. Restart the Data Gatherer.

Oracle Intelligent Agent Start and Stop

To stop the agent:

lsnrctl dbsn mp_stop

To start the agent:

lsnrctl dbsn mp_start

Data Gatherer Start and Stop

To stop the gatherer:

vppcntl -sto p

To start the gatherer:

vppcntl -sta rt

Note: For more information on commands to restart the Oracle

Intelligent Agent, Oracle Management Server, and Data Gatherer, see the Oracle Enterprise Manager Configuration Guide.

6.3.1.3 Wireless Edition Data Gatherer Cartridge Installation: Windows

To install the data gatherer cartridge:

Important: The cartridge installation requires an Oracle Enterprise

Manager 2.2 Console and Oracle Intelligent Agent 8.1.7 on the server side.

Oracle Enterprise Manager 6-5

Page 80

Configuring the Server, Client, and Middle-tier

Un-zip the ptgwincartridge.zip file in WE_ HOME/oem/agent/ca r tridge/win32 to a directory (referred to as CART_DIR in this document).

2. Copy the file vpxptg.dll in CART_DIR\odg\bin to the ORACLE_HOME\bin

directory.

3. Copy the file vpxptgUS.htm in CART_DIR\odg\html to the ORACLE_

HOME\odg\html directory.

4. Copy the file vpxptgus.msb in CART_DIR\odg\mesg to the ORACLE_

HOME\odg\mesg directory.

5. Append the following entry to the svppcart.dat file in the ORACLE_

HOME\odg directory:

PTG ALL vpxptg vpxptg

This completes the server side configuration for Oracle Enterprise Manager integration. Restart the Oracle Intelligent A gent and the Data Gatherer. Thi s sta r ts the Wireless Edition cartridge along with the Oracle Intelli gent Agent startup.

Select the Control Panel and then Services to restart the appropriate service.

6.3.2 Configuring the Client Side

To configure the Oracle Enterprise Manager client side:

Note: Requirement for deployment of the integration classes: JRE

1.1.8_10 for Unix and JRE 1.1.7.30o for Windows.

1. Install the Oracle Enterprise Manager client, including the Console an d client

tools, Oracle Management Server, and Diagnostic Pack (Performance Manager and Capaci ty Planner) .

Note: The Oracle Enterprise Manager Diagnostic Pack is only

availabl e for Windows.

2. Copy the file oemptg.jar fro m the WE_HOME/oem/client directory to the

ORACLE_HOME/classes directory.

6-6 Oracle9i Application Server Wireless Edition Configuration Guide

Page 81

Configuring the Server, Client, and Middle-tier

Extract this file in the copied directory. This extracts the console integra tion classes, Performance Manager integration classes, events integration classes, and RMI client and stub for the Console interaction with the server. For example:

jar -xvf oemptg.ja r

4. The entries in WE_HOME/oem/client/OEMClient.properties.append must be

appended to ORACLE_HOME/sysman/config/OEMCLient.properties. The following shows the entries.

# # System def inition of types for Wireless Edit ion # /com/oracle/ sysman/em/system/typ es/oracle_sysman_pt g/isa =test_service1 /com/oracle/ sysman/em/system/ types/oracle_sysm an_ptg/service = true /com/oracle/ sysman/em/system/ types/oracle_sysm an_ptg/display_c lass = oracle.sysma n.ptg.navigator.P tgDisplayDriver

# # Console de finition of types for navigator tr ee for # Wireless E dition # /com/oracle/ sysman/em/console /navigator/oracle _sysman_ptg/data _source = oracle.sysma n.ptg.navigator.P tgSubItemContaine rSource

/com/oracle/ sysman/em/console /navigator/oracle _sysman_ptg/prox y =oracle.sysm an.ptg.navigator. PtgProxy

# # Events Int egration # # Wireless E dition events int egration # /com/oracle/ sysman/em/console/te sts_datasource/ptg/ datasource = oracle.sysma n.ptg.PTGTestsDat asource

# PTG Consol e credentials cla sses for Events I ntegration /com/oracle/ sysman/em/system/typ es/oracle_sysman_pt g/isa = /com/oracle/ sysman/em/system/ types/oracle_sysm an_ptg/service = true /com/oracle/ sysman/em/system/typ es/oracle_sysman_pt g/credentials_displa y = oracle.sysma n.vtcConsole.vtcC redentials.PtgCre dentialsDisplay /com/oracle/ sysman/em/system/typ es/oracle_sysman_pt g/credentials = oracle.sysma n.emSDK.common.cr edentials.PtgCred entials

Oracle Enterprise Manager 6-7

Page 82

Configuring the Server, Client, and Middle-tier

The entries in WE_HOME/oem/client/v td client.properties.append must be appended to ORACLE_HOME/s ysman/config/vtdclient.properties. The following shows the entries:

/target/orac le_sysman_diagpac k/oracle_sysman_ ptg=oracle.s ysman.vtd.VtdPtgC redentials /options/sta ndalone=TRUE

Edit the ORACLE_

HOME/classes/oracle/panama/magent/MAgent.properties file to reflect the values of the installed Wireless Edition server name. The port number and the service name are defaulted.

Note: This property file should be in synch with the one on the

Wireless Edition server side for each instance to which the file refers.

7. For the Oracle Enterprise Manager client side installation the only pertinent

values are magent.server.host and magent.server. The remaining properties may be ignored or defaulted here.

# Server Hos t Name magent.serve r.host=<Wireless Editio n server host name>

# The servic e port: Use the s ame port as the R MI server as # in Rmi.pr operties magent.serve r.port=2008

# Service Na me magent.serve r.name=Magent

Verify that the classpath contains the following entries.

For UNIX:

$ORACLE_HOME /classes $ORACLE_HOME /jdbc/lib/classes 111.zip $ORACLE_HOME /lib/vbjorb.jar $ORACLE_HOME /lib/vbjapp.jar $ORACLE_HOME /lib/vbjtools.jar $ORACLE_HOME /classes/classesF romIDLVisi $ORACLE_HOME /jlib/ewt-3_3_6.j ar

6-8 Oracle9i Application Server Wireless Edition Configuration Guide

Page 83

Configuring the Server, Client, and Middle-tier

$ORACLE_HOME /jlib/ewtcompat-o pt-3_3_6.zip $ORACLE_HOME /jlib/ewt-swingac cess-1_1_1.jar $ORACLE_HOME /jlib/share-1_0_8 .jar $ORACLE_HOME /jlib/jssl-1_2.ja r $ORACLE_HOME /jlib/javax-ssl-1 _2.jar $ORACLE_HOME /jlib/netcfg.jar: /

For Windows:

%ORACLE_HOME %\classes %ORACLE_HOME %\jdbc\lib\classe s111.zip %ORACLE_HOME %\lib\vbjorb.jar %ORACLE_HOME %\lib\vbjapp.jar %ORACLE_HOME %\lib\vbjtools.ja r %ORACLE_HOME %\classes\classes FromIDLVisi %ORACLE_HOME %\jlib\ewt-3_3_6. jar %ORACLE_HOME %\jlib\ewtcompat- opt-3_3_6.zip %ORACLE_HOME %\jlib\ewt-swinga ccess-1_1_1.jar %ORACLE_HOME %\jlib\share-1_0_ 8.jar %ORACLE_HOME %\jlib\jssl-1_2.j ar %ORACLE_HOME %\jlib\javax-ssl- 1_2.jar

The Oracle Enterprise Manager client side configuration is now complete.

6.3.3 Configuring the Middle-tier

The middle-tier hosts the Oracle Management Server. The following configuration is for the Events Integration.

1. Copy the file oemptg.jar in the WE_HOME/oem/oms directory to the

ORACLE_HOME/classes directory where the Oracle Management Server is installed.

2. Extract this file in the copied directory, for example:

jar -xvf oemptg.ja r

This extracts the Console integration classes, Performance Manager integration classes, events integration classes, and RMI client and stub for the Console interaction with the server.

3. The entries in WE_HOME/oem/oms/OMSRegistry.registry.append must be

appended to the OMSRegistry.registry file in ORACLE_ HOME/sysman/admin.

# ORACLE_HOM E/sysman/admin/OM SRegistry.registr y

Oracle Enterprise Manager 6-9

Page 84

Setting up the ptg_services.tcl File

# Wireless E dition events int egration # /com/oracle/ sysman/em/tests_data source/ptg/datasour ce = oracle.sysma n.ptg.PTGTestsDat asource

Note: After updating the OMSRegistry.registry file, recreate the

Oracle Management Server repository using the Oracle Enterprise Manager configuration assistant. See the Oracle Enterprise Manager Configuration Guide for more information.

This completes the middle-tier configuration. Restart the Oracle Management Server and Oracle Intelligent Agent.

6.4 Setting up the ptg_services.tcl File

To set up the ptg_services.tcl file:

1. Set the correct values of the NEW_PARAMETER_NAME, PTG_INSTANCE_

NAME, TRACE_DB_HOSTNAME, TRACE_DB_PORT, TRACE_DB_SID, and TRACE_DB_ORACLE_HOME for each instance.

2. To add another instance:

a. Add a new parameter to store the new ServiceName (the Wireless Edition

instance name) to the "global Parameters". See the following example.

b. Copy the lines between "BEGIN EXAMPLE" and "END EXAMPLE", and

replace the information with the new instance’s parameter name and remaining information.

global Param eters ServiceType HostName tnsaddr ess argv NEW_PAR AMETER_ NAME Service Name2

set Paramete rs(oracle_sysman_ ptg) {ServiceType HostName tnsadd ress };

set Host [li ndex $argv 0];

#The Service name is a subnod e in the navigato r

set NEW_PARAMET ER_NAME PTG_INSTANCE_N AME;

lappend Serv iceNames $NEW_PAR AMETER_NAME; set ServiceType ($NEW_PARAMETER_NAME ) oracle_sysman_ptg;

6-10 Oracle9i Application Server Wireless Edition Configuration Guide

Page 85

Setting up the ptg_services.tcl File

set HostName($N EW_PARAMETER_NAME) $Ho st; set tnsaddre ss($NEW_PARAMETER _NAME) "(DESCRIPT ION=(ADDRESS_LIS T = (ADDRESS = (PROTOC OL = TCP)(HOST = TRACE_DB_HOST NAME)(PORT = TRACE_DB_ PORT)))(CONN ECT_DATA=(SID=TRA CE_DB_SID)(ORACLE _HOME=TRACE_DB_O RACLE_ HOME)(SERVER =DEDICATED)))"

In the following example a new parameter (ServiceName2) is added and the values for the PTG_INSTANCE_NAME, TRACE_DB... are set. For this example the listed parameters are replaced with the values in the following. The values are similar to the tnsnames.ora configuration.

Table 6–1 ptg_services.tcl Parameters

Parameter Va lue in Examp le Description

NEW_PARAMETER_NAME ServiceName2 Parameter name declaration. PTG_INSTANCE_NAME PTG2 The Wireless Edition instance

name.

TRACE_DB_HOSTNAME ptgserver-sun.us.oracle.com The host name of the

database log database.

TRACE_DB_PORT 1521 The port of the database

listener. TRACE_DB_SID ptgdev The SID of the log database. TRACE_DB_ORACLE_

HOME

# Example: # The Servic e name "PTG2" (Wi reless Edition In stance name) is a subnode in the # Navigator tree

# In the lin e below, just app end the new param eter name # i.e. Serv iceName2. Don’t d uplicate this lin e. global Param eters ServiceType HostName tnsaddr ess argv Service Name2

set Paramete rs(oracle_sysman_ ptg) {ServiceType HostName tnsadd ress };

set Host [li ndex $argv 0];

# Lines belo w need to be dupl icated every time a new instance is added set ServiceName 2 PTG2; lappend Serv iceNames $Service Name2; set ServiceType ($ServiceName2) oracle _sysman_ptg;

/private/oracle/8.1.7 The Oracle home directory.

Oracle Enterprise Manager 6-11

Page 86

Configuration f or Anot her Wi reless Ed ition Instance

set HostName($S erviceName2) $Host; set tnsaddress($ServiceName2) "(DESCRIPTION=(ADDRESS_LIST = (ADDRESS = (PROTOCOL = TCP)(HOST = ptgserver-sun.u s.oracle.com)(POR T = 1521)))(CONN ECT_ DATA=(SID=pt gdev)(ORACLE_HOME =/private/oracle/ 8.1.7)(SERVER=DE DICATED)))"

Note: Place this file in ORACLE_HOME/network/ag e nt/config.

Add this file name to nmiconf.lst. To reflect any change to either file restart the Oracle Intelligent Agent and rediscover the node.

6.5 Configuration for Another Wireless Edition Instance

The preceding configuration is for one Wireless Edition instance. To configure another Wireless Edition instance:

1. Ptg_services.tcl: Add another entry in the ORACLE_

HOME/network/agent/config/ptg_services.tcl file. Give this instan ce a different service name. See Section 6.4 for in structions and an example.

2. Minstances.properties: Add a corresponding instance’s <instance name > =

<property file name> entry to the ORACLE_ HOME/class e s /o r acl e /p a nama/magent/config/MIns t an c es . p roperties file. The RMI client uses this information to communicate with the corresponding server. Each instance is monitored using a Magent.properties file which contains the Wireless Edition server host name, port, and service name. In the case of multiple instances, these are identified by these values. The

Minstances.properties file should point the instance name to the corresponding Magent.properties file. For example, for two instances:

PTG1=oracle. panama.magent.con fig.Magent1 PTG2=oracle. panama.magent.con fig.Magent2

Magent.properties: Configure the Magent.properties file on both the client and

server side to point to the new instance’s classes and port. Users can have any number of instances but each instance’s information is stored in a separate property file.

4. Ensure that an Oracle Enterprise Manager Agent is installed on the node where

the Wireless Edition instance is running. The Wireless Edition instance uses the Agent to pipe error messages to the Oracle Enterprise Manager Console.

5. The System.properties.templ file contains parameters for the system logger

and the logger schema. Ensure that these are set up appropriately.

6-12 Oracle9i Application Server Wireless Edition Configuration Guide

Page 87

Asynchronous Notification of Error Information

6.6 Configuring the Database Logger

The database logger of a Wireless Edition instance must point to a database schema to log the information. This configuration is done in the System.properties file of each Wireless Edition instance. See Chapter 4 for more information on the database logger .

6.7 Asynchronous Notification of Error Information

Asynchronous notification of error information is provided using the event framework provided by Oracle Enterprise Manager. In case of an error, th e Wireless Edition server generates an Oracle Enterprise Manager event at the node where the error occurred providing all the necessary details for the fault diagnosis.

Note: An Oracle Enterprise Manager agent must be running on

the node where oemevent is invoked. The event must be defined as an unsolicited event and the node must be added as a monitored destination.

The Oracle Enterprise Manager Event properties can be configured by editing the oemevent.properties file in the WE_HOME/server/oracle/panama/core/admin directory.

The oemevent.properties file has the following parameters:

Table 6–2 Properties of the oemevents.properties File

Key Type Customizable Description

oemevent.path str ing Y Complete pat h name for the

oemevent executable.

oemevent.event. name

oemevent.object. name

oemevent.event level

string Y Unsolicited event name as defined in

the console.

string Y Object name specified in the event

definition.

string Y Event level specified in the event

definition. The level should be defined as "2" and spec ified as " alert ".

Oracle Enterprise Manage r 6-13

Page 88

Launching the Oracle Enterprise Manager Tools

6.8 Launching the Oracle Enterprise Manager Tools

Performance Monitoring is accomplished through the Oracle Enterprise Manager Performance Manager and Capacity Planner tools (provided only for Windows NT). Once the installation is complete:

1. Launch the necessary performance monitoring tool. See the Oracle Enterprise

Manager documentation for instructions on how to launch it.

2. At the login scre en s elect Stand-alone and no repository connection. Click OK.

3. Double-click PTG PM Targets.

4. Enter the Wireless Edition login information to the schema where the Wireless

Edition dumps the runtime log information. This information is the same as the system logger configuration inf ormation that is entered in Section 6.6.

5. Enter the Data Gatherer Location. This is the host on which you installed the

Data Gatherer and Wireless Edition cartridge.

6. Click OK.

This allows you to begin using the performance monitoring and capacity planning. The Fault and Configuration Mana gement is accomplished through the Oracle

Enterprise Manager Console.

1. Launch the Oracle Enterprise Manager Console. See the Oracle Enterprise

Manager documentation for instructions on how to launch it.

2. Log on to the repository which you created during your Oracle Enterprise

Manager installation.

3. Discover the node where the Oracle Intelligent Agent is running.

4. Configure the Console to receive unsolicited events from the Nodes

(hostnames) on which Wireless Edition is running. See the Oracle Enterprise Manager documentation for instructions on how to configure it.

6-14 Oracle9i Application Server Wireless Edition Configuration Guide

Page 89

Multi-byte Character Support

Multi-byte Character Support describes multi-byte character support in Wir eless Edition. Each section of this document presents a different topic. These sections include:

■ Section 7.1, "Overview"

■ Section 7.2, "Multi-byte Encoding Schemes"

■ Section 7.3, "Setting the Multi-Byte Encoding for the Personalization Portal"

■ Section 7.4, "Setting up a Netscape Browser to Display Multi-byte Data"

■ Section 7.5, "LocalStrings.properties Files and Localization"

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/ias 10210/panama (UNI X)

Replace "WE_HOME" with the fully- qualified directory path.

■ ORACLE_HOME is the directory in which Oracle9i

Application Server is instal led.

Multi-byte Character Support 7-1

Page 90

Overview

7.1 Overview

This release of Wire less Edition supports single-byte, multi-byte, and fixed-width encoding schemes which are based on national, international, a nd vendor-specific standards.

If the character set is single byte, and that character set includes only composite characters, the number of characters and the number of bytes are the same. If the character set is multi-byte, there is generally no such correspondence between th e number of characters and the number of bytes. A character can consist of one or more bytes, depending on the specific multi-byte encoding scheme.

A typical situation is when character elements are combined to form a single character. For example, in the Thai language, up to three separate character elements can be combined to form one character, and one Thai character would require up to 3 bytes when TH8TISASCII or another single-byte Thai character set is used. One Thai character would require up to 9 bytes when the UTF8 character set is used.

7.2 Multi-byte Encoding Schemes

Multi-byte encoding schemes are needed to support ideographic scripts used in Asian languages like Chinese or Japanese since these languages use thousan ds of characters. These schemes use either a fixed number of bytes to represent a character or a vari able number of bytes per character.

7.2.1 Fixed-width Encoding Schemes

In a fixed-width Multi-byte encoding scheme, each character is represented by a fixed number of n bytes, where n is greater than or equal to two.

7.2.2 Variable-width Encoding Schemes

A variable-width encoding scheme uses one or more bytes to represent a single character. Some Multi-byte encoding schemes use certain bits to indicate the number of bytes that represent a character. For example, if two bytes is the maximum number of bytes used to represent a character, the most significant bit can be toggled to indicate whether that byte is part of a single-byte character or the first byte of a double-byte character. In other schemes, control codes differentiate single-byte from double-byte characters. Anothe r possibility is that a shift-out code is used to indicate that the subsequent bytes are double-byte characters until a shift-in code is encountered.

7-2 Oracle9i Application Server Wireless Edition Configuration Guide

Page 91

LocalStrings.properties Files and Localization

7.3 Setting the Multi-Byte Encoding for the Personalization Portal

The Personalization Portal receives the encoding for the text of the site from the setting in the PAPZ logical device, which is in the repository. The default encoding is VTF-8, which can be used for both Western European and Asian languages. The portal sets the content for each page with the encoding specified by the logical device. To change the default encoding to multi-byte encoding click PAPZ under Logical Devices in the Service Designer and change the encoding for your particular language.

7.4 Setting up a Netscape Browser to Display Multi-byte Data

To set up a Netscape 4.6 web browser to display Multi-byte data:

1. Click Edit, Preference, Appearance, and Fonts.

2. Select Unicode in the For the Encoding field.

3. For example, for Chinese, select MS Song in the Variable Width Font field.

4. For example, for Chinese, select MS Song in the Fixed Width Font field.

5. Select the "Use my default fonts, overriding document-specified fonts" radio

button.

7.5 LocalStrings.properties Files and Localization

Localization has been simplified through the use of a property file called LocalStrings.properties. This file contains text labels used by screens within various adapters and JSP pages.

7.5.1 Service Designer Localization

Modify the LocalStrings.properties file in the panama_pasm.zip file in the ORACLE_HOME\panama\tools\ServiceDesigner\lib directory.

7.5.2 Personalization Portal Localization

Modify the LocalStrings.properties file in the WE_ HOME/server/classes/oracle/panama/adapter/webui directory.

Multi-byte Character Support 7-3

Page 92

LocalStrings.properties Files and Localization

7.5.3 Localization for LDAP, Mail Adapter, and Personalization f r om a Device

Localization text for these adapters can be found in LocalStrings.properties files in the WE_HOME/server/classes/oracle/panama/adapter directory. The sub-directories are specified.

Table 7–1 LocalStrings.properties Files Details

Location Contents

/ldap/LocalStrings.properties Text labels used by the LDAP adapter. /mail/LocalStrings.properties Text labels used by the Mail adapter. /papzlite/LocalStrings.properties Text labels used by the device interface to the

Personalization Portal.

7-4 Oracle9i Application Server Wireless Edition Configuration Guide

Page 93

Utilities

Utilities describes the XML utilities used for management and deployment. Each section of this document presents a different topic. These sections include:

■ Section 8.1, "System Password Encryption/Decryption"

■ Section 8.2, "LoadXml"

■ Section 8.3, "Upload and Download Utilities"

■ Section 8.4, "Xslt"

■ Section 8.5, "CopyObjects"

Utilities 8-1

Page 94

System Password Encryption/Decryp tion

8.1 System Password Encryption/Decryption

The Wireless Edition database password for the repository is stored in clear text in the System.properties file by default. The password can be encrypted by running the following tool to modify the db.connect.string:

encryptPassw ord.sh WE_HOME/se rver/classes/orac le/panama/core/a dmin

Then set the following property in the System.properties file:

passwordEncr ypted=true

8.1.1 Extensibility

The SystemPasswor dEncryptionHook.c lass identifies the encryption algorithm. To provide extensibility, the class can be used to in voke a user’s algorithm in place of the default algorithm.

The default setting is:

locator.Syst emPasswordEncrypt ionHook.class= oracle. panama.rt.common. SystemPasswordEnc ryption

To use an alternate encryption algorithm, implement the following interface:

public interfac e SystemPasswordEncryp tionHook { /** Encryp ts the text * @param text the text to be encrypted * @retur n the encrypted t ext */ public String encr ypt(String text);

/** Decryp ts the encrypted text * @param encryptedText th e encrypted text * @retur n the decrypted t ext */

public String decrypt(String en cryptedText);

}

This allows you to replace the default algorithm, for example:

locator.Syst emPasswordEncrypt ionHook.class= oracle. panama.MyEncrypti on

8-2 Oracle9i Application Server Wireless Edition Configuration Guide

Page 95

8.2 LoadXml

The LoadXML utility allows you to download and upload Wireless Edition repository objects as XML files.

LoadXml reads from stdin and writes to stdout. All logging and error messages are written to stderr. The XML in the file you import with LoadXml must conform to the Repository XML.

The upload function performs the following:

1. Checks for the objects in the repository by logical unique name.

2. Loads all dependencies.

3. If the objects exist in the repository, LoadXml updates the objects.

4. If the objects do not exist, LoadXml creates them.

5. After each object type is successfully loaded, LoadXml performs a commit. The

LoadXml

commit includes all referenced objects (dependencies).

In the unload XML result, all objects have an attribute called _objectId; this is the system unique object key. You must look up objects by unique name attribute and not the object key. If you start the program witho ut giving an option, all options are listed.

LoadXML imports and exports the repository identified by the database connect string in the System.properties file. In the development environment, this file is located in the WE_HOME/server/classes/oracle/panama/core/admin directory.

Wire less Edition does not validate the XML file you import into the repository with LoadXml. To avoid errors, work in an XML file that you have exported fro m the repository. This gives you a “known good” Repository XML framework for adding, removing, and modifying individual elements.

Syntax

oracle.panam a.core.util.LoadXml [-l username/password] [-x[ adgnstu] [expr]] [-c# [-p]] [-r rm i://rmi-host:port /server_name]

Options

The LoadXml utility accepts the following opti ons:

Utilities 8-3

Page 96

LoadXml

Table 8–1 LoadXml Utility

Option Description

-l usr/pwd

Log on to Wireless Edition using a user name and password. If no administrator is defined in the system, the program allows any user to log on. Otherwise, the user must be an administrator to log on.

-x Unload all repository data to stdout. The data can be filtered by adding these options to the -x option.

-a Adapter filter.

-d Logical device filter.

-g Group filter.

-n Agent filter.

-s Service filter.

-t Transformer filter.

-u User filter. expr Name expression filter. This option can include wildcards,

such as: [*%?_].

-c# Upload repository data read from stdin. The argument # is a number that, if set, causes a commit after the specified number of objects are uploaded. An argument of 0 causes a commit after a complete load of th e XML data.

-p This option activates provisioning of user data when uploading. This mode is only used with the -c option. The provisioning upload handles the provisioning DTD, and makes it possible to create, enab le, disa bl e, and remove users in the repository. This mode always creates new users. If the createUserRoot attribute is set to YES, LoadXml creates a root folder for each user. The provisioning upload uses streaming to load users, and therefore does not resolve dependencies.

8-4 Oracle9i Application Server Wireless Edition Configuration Guide

Page 97

Upload and Download Utilities

Option Description

-r This option ensures that the reposi tory and object cache for a running instance of Wireless Edition are current. The following is sample syntax:

-r rmi://stpc250.us.oracle.com:2008/PanamaServer -c0 < bootstrap.xml

rmi-host is the machine on which the RMI registry is running.

port is the port at which the registry is listening. server-name is the name of the Wireless Edition instance. port and server-name can be found in the Rmi.properties

file.

Unload Example

In this example, XML data is written to standard output.

java oracle.pan ama.core.util.LoadXm l -l adm/adm -x > outputfile.xml

Upload Example

In this example, XML data is read from standard input. It must contain all referenced obj ect s.

prompt$ java oracle.panama.co re.util.LoadXml - l adm/adm -c0 < inputfile.xml

8.3 Upload and Download Utilities

You can use the upload and download utilities to im port and export the Wireless Edition repository as an XML file. These utilities invoke LoadXml. They are located in the WE_HOME/sample directory of your development environment. Y ou invoke

upload from a command prompt as follows: upload.bat repository.xml

This loads the contents of the file repository.xml into the repository. It accesses the repository specified by the connect string in the client-side System.properties file.

To download a repository: download.bat repository.xml This places the contents of the repository in a file named repository.xml.

Utilities 8-5

Page 98

Xslt

Note: Please make sure the -l option has been properly specified

in either the upload.bat or upload.sh script file.

The xmlloader.properties file specifies the mapping between the object names and their handler Java classes. The objects are specified as fully-qualified from the root, as dot-separated names. For example, the PanamaObjects property file is specified as oracle.panama.util.XMLLoader.PGRPHandler.

The System.properties file has the following entries to determine behavior.

Table 8–2 Behaviors for the XML Loader in the Systems.property File

Entry Behavior

xmlloader.pathExpression Specifies the regular expression which

determines the path of the objects that you intend to upload and download.

8.4 Xslt

xmlloader.activityLog Specifies the location of logging activity. xmlloader.errorLog Specifies the location for logging errors. xmlloader.createUserRoot Determines whether a root folder is to be created

for each user when uploading provisioning data.

xmlloader.commitFrequency Frequency in seconds to commit the uploaded

information to the back-end reposi tory.

xmlloader.replaceObjects Determines whether a pre-existing objects should

be overwritten.

Note: ’All the XML Loader parameters in the System.properties

file are default values that are overwritten by the XML Loader API.

The Xslt utility is a tool you can use to test sty lesheets. Xslt uses the XML DOM parser and the XSL processor included with the Oracle XML processor. You can use Xslt to apply the stylesheets you create to any XML document.

8-6 Oracle9i Application Server Wireless Edition Configuration Guide

Page 99

CopyObjects

Xslt, which is a command-line utility, reads from standard input and writes its results to standard output.

Synopsis

oracle.panam a.util.Xslt [styl esheet]

Options

The Xslt utility takes the following option:

Table 8–3 Options for the Xslt Utility

Option Description

stylesheet The XSL stylesheet that the utility applies to the XML document.

Xslt Example

java oracle.pan ama.util.Xslt mystyles heet.xsl < myxml.xml

8.5 CopyObjects

The CopyObjects utility allows you to copy services from one Wireless Edition site to one or more other sites. You can use this utility, for example, to deploy services from a testing and development environment to production servers.

CopyObjects sends services to target servers as XML elements. It takes a folder object as a command-line argument. To copy a service, therefore, you must first place the service in a folder. When invoked, CopyObjects copies the folder and all its contents to the target Wireless Edition sites you specify at the comm an d line.

Requirements

All source and target Wireless Edition servers must have the Wireless Edition RMI server running.

The basic configuration of adapters and transformers must be the same on the source and target servers. CopyObjects only sends services, links, and folders. It does not send configuration data.

Syntax

oracle.panam a.core.util.CopyO bjects [-f folder ] [-s source ][targets... ]

Utilities 8-7

Page 100

CopyObjec ts

Options

The CopyObjects utility takes the following option s:

Table 8–4 Options for the CopyObjects Utility

Option Description

-f folder The name of an existing folder in the source system.

-s source The source W ireless Edition server. Spe cif y the sour c e in th e

format: username/password@//hostname:port/servername

targets The tar get Wireless Edition s erv ers . S p ecify t a r gets in the format:

username/password@//hostname:port/servername

Example

This example copies a folder and its content from a local server to production sites at m1 and m2.

java oracle. panama.core.util. CopyObjects \

- f /master/finance \

- s user/pw@//:2008 /WEServer \ user/pw@//m1:20 08/WEServer \ user/pw@//m2:20 08/WEServer

8-8 Oracle9i Application Server Wireless Edition Configuration Guide