Contents List of Tables Send Us Your Comments ........................xi Preface ................................xiii Audience ..............................xiii Organization............................Related Documentation ........................Documentation Accessibility ......................Overview Installation Overview ......................1-2 Manual Configuration ......................1-3 Configure Oracle HTTP Server and JServ ..............1-3 1.2.1 Configure ProxyFirewall.properties................
Page 4
Geocoding Setup........................1-12 1.10 JDBC Connection Pooling ....................1-12 FastForward Introduction..........................2-2 2.1.1 Features..........................2-2 Installation ..........................2-2 2.2.1 System Requirements ....................2-2 2.2.2 Installation ........................2-3 On Your Own Web Server and JSP Engine ............2-3 2.2.2.1 2.2.2.2 On PTG 1.1 ....................... 2-3 Configuration .........................
Page 5
Logging Overview ..........................4-1 Database Logging........................4-1 4.2.1 Configuring the Database Logger................4-2 4.2.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 Multiple JVM Support and Load Balancing Overview ..........................
Page 6
Setting up the ptg_services.tcl File..................6-10 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 Multi-byte Character Support Overview..........................7-2 Multi-byte Encoding Schemes ..................... 7-2 Fixed-width Encoding Schemes ...................
Page 9
List of Tables 2–1 Mail parameters........................2-5 Directory parameters ......................2-7 2–2 2–3 Mail parameters passed through request............... 2-9 Directory parameters passed through request............2-10 2–4 2–5 Mail configuration class ..................... 2-11 4–1 Contents of the ptg_session_log Table ................4-3 Contents of the ptg_service_log Table ................
Page 10
10–21 Parameters of the mappers.xml File ................10-28 10–22 Parameters of the routers.xml File .................. 10-28 10–23 Parameters of the Strip.properties File................10-29 10–24 Strip Processing Classes....................10-29 10–25 Parameters of the MAgent.properties File..............10-30 10–26 Parameters of the Cookies.properties File ..............10-31...
Send Us Your Comments Oracle9i Application Server Wireless Edition Configuration Guide, Release 1.1 Part No. A86701-02 Oracle Corporation welcomes your comments and suggestions on the quality and usefulness of this document. Your input is an important part of the information used for revision. Did you find any errors? Is the information clearly presented? Do you need more information? If so, where?
Preface The Oracle9i Application Server Wireless Edition Configuration Guide discusses how to configure Wireless Edition. This Preface contains these topics: Audience Organization Related Documentation Documentation Accessibility Audience Oracle9i Application Server Wireless Edition Configuration Guide is for users who are setting up their environments to administer and/or develop applications for wireless users.
Organization This document contains: Chapter 1, "Overview" Overview of post-installation configuration procedures. Chapter 2, "FastForward" Configure Mail and LDAP applications. Chapter 3, "Alerts and SMS Configuring the SMS Listener to process Request Listener" time-based, scheduled services known as Alerts. Chapter 4, "Logging" Configuring the logging capabilities of Wireless Edition.
Additionally, Oracle9i Application Server, Database, Networking, Application Development, and other documentation is available on your Documentation CD, and at docs.oracle.com. Documentation Accessibility Oracle’s goal is to make our products, services, and supporting documentation accessible to the disabled community with good usability. To that end, our documentation includes features that make information available to users of assistive technology.
Installation Overview In this document: Important: WE_HOME is the directory in which Wireless Edition is installed followed by the "panama" sub-directory. For example: c:\ias10210\panama (Windows) /private/ias10210/panama (UNIX) Replace "WE_HOME" with the fully-qualified directory path. ORACLE_HOME is the directory in which Oracle9i Application Server is installed.
Manual Configuration 1.2 Manual Configuration After installation, perform the manual configuration steps described in this section: Section 1.2.1, "Configure Oracle HTTP Server and JServ" Section 1.2.2, "Configure ProxyFirewall.properties" Section 1.2.3, "Start the Oracle HTTP Server" Section 1.2.4, "Wireless Edition Configuration Verification" 1.2.1 Configure Oracle HTTP Server and JServ This section describes the configuration of the Oracle HTTP Server and JServ.
Page 20
Manual Configuration Verify that the Java Virtual Machine is version 1.2.2. For example: wrapper.bin= <ORACLE_HOME>/Apache/jdk/bin/java.exe After the other "wrapper.classpath" entries, add all the required Wireless Edition files after the "tools.jar" entry in the classpath. For Windows (for UNIX replace "\" with "/"): wrapper.classpath=<WE_HOME>\server\classes wrapper.classpath=<WE_HOME>\lib\panama.zip wrapper.classpath=<WE_HOME>\lib\panama_core.zip...
Page 21
Manual Configuration For UNIX only, to display the images from the Personalization Portal properly, set the DISPLAY environment variable in the jserv.properties file to configure access to the host on which the server runs: If the X server runs on the same machine as the Wireless Edition server, set the DISPLAY environment variable in the jserv.properties file as follows: wrapper.env=DISPLAY=:0.0 From the X server host machine (x_server_host_name in the following...
Manual Configuration In the Startup Servlets section, add the Wireless Edition specific servlets: servlets.startup=oracle.panama.ParmImpl In the Servlet Aliases section, add the Wireless Edition specific servlets: servlet.rm.code=oracle.panama.ParmImpl 1.2.2 Configure ProxyFirewall.properties If a proxy server is used to access an external web site from Wireless Edition, configure the ProxyFirewall.properties file: Set http.use.proxy to true.
Upgrade The login page should appear. The Personalization Portal prompts you to enter a user name and a password. You can log in using “Administrator” as the user name and “manager” as the password. Run the Wireless Edition Request Manager by accessing the following URL: http://host_name.domain:7777/ptg/rm The login page should appear.
Samples 1.4 Samples You can install the sample services and adapters into the repository after completing the steps in Section 1.2 and/or Section 1.3. Change to the sample directory: WE_HOME\sample (Windows) WE_HOME/sample (UNIX) Modify the upload.bat or upload.sh file using the -l option to specify the Wireless Edition user and password for which the data is loaded.
Web Integration Server 1.5 Web Integration Server The Wireless Edition Web Integration Server hosts services that applications can use to exchange data and information sources via the Web. The Web Integration Server is installed with Wireless Edition. The following steps guide you through the configuration process of the Web Integration Server: Run the Web Integration Server.
Wireless Edition Client 1.6 Wireless Edition Client The Wireless Edition client runs only on the Windows platform. The client installation consists of the following: Service Designer Web Integration Developer 1.6.1 Service Designer The Service Designer is a visual interface for implementing and managing services in Wireless Edition.
OCI8 JDBC Driver From the Edit menu, select Preferences, and then Configuration. Enter the Proxy (HTTP) and the Secure Proxy (HTTPS) settings appropriate for your environment. Click OK. 1.7 OCI8 JDBC Driver The default configuration of Wireless Edition uses the Oracle THIN JDBC driver. For a production environment, the Oracle OCI8 JDBC driver is required, as it provides improved performance, concurrency, scalability, and multi-byte support.
User Provisioning 1.8 User Provisioning You can integrate your repository with an existing provisioning system using one of the following: You can manage users by creating a service with the Wireless Edition provisioning adapter. The provisioning adapter supports the Wireless Edition services that create, search for, update, and delete users at runtime.
Page 29
JDBC Connection Pooling Connection pooling under Wireless Edition session management supports server environments that include short-lived threads, long-lived threads (thread pool model), or a combination of short-lived and long-lived threads. The following system properties apply to the connection pooling mechanism: #Minimum number of connections for the connection pool db.connect.minConnections=5 #Maximum number of connections for the connection pool...
FastForward This document describes the FastForward Email and Directory applications, their installation, and configuration . Each section of this document presents a different topic. These sections include: Introduction Installation Configuration FastForward 2-1...
Introduction 2.1 Introduction The FastForward Email and Directory applications enables you to provide your end users with access to their corporate email and directory lookup on any mobile device. Mobile email will drive productivity within your enterprise, allowing employees to stay in touch while away from the office. 2.1.1 Features The FastForward Email and Directory applications include implementation of the following features:...
Installation Mail JavaMail API 1.2 from Sun Microsystems JavaBeans Activation Framework extension (JAF) from Sun Microsystems Directory JNDI 1.2 from Sun Microsystems 2.2.2 Installation 2.2.2.1 On Your Own Web Server and JSP Engine Ensure you have a working web server and a JSP engine configured to run on that web server.
Configuration 2.3 Configuration The OracleMobile Mail and Directory applications provide mobile access for industry standard electronic mail systems and Directory servers. Supported backends include: Mail IMAP POP3 MS Exchange 5.5 and 2000 Lotus 4.6 and Release 5 Directory LDAP servers supporting JNDI 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.
Page 35
Configuration An example of the files is in the doc directory. The root "oracle" directory containing the properties IMPORTANT: 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.
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 domain is not specified, the default email domain will be appended to the username.
Page 37
Configuration 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.
Page 38
Configuration ldap.username If an LDAP login is required, a default username and ldap.password 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.
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.
Page 40
Configuration DOMAIN Definition, possible values, and default values are the same as the "mail.default.emaildomain" in the properties file. 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"...
Configuration PTG_VERSION Definition, possible values, and default values are the same as the "oracle.panama.version" in the properties file. Definition, STUDIO 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.
Page 42
Configuration String getXMLVersion (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"...
Configuration 2.3.0.3.4 Configuration of URL Adapter in PTG 1.1 ServiceDesigner Mail and Directory applications 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): Open Service Designer and connect to a PTG 1.1 instance.
Page 44
Configuration Figure 2–1 Service Designer Window Now you can use e-mail. 2-14 Oracle9i Application Server Wireless Edition Configuration Guide...
Alerts and SMS Request Listener Alerts and SMS Request Listener discusses alerts and the SMS Request Listener in Wireless Edition. 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"...
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.
Alerts 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.
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.url= 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.class=oracle.panama.util.sms.SmsSMPPDriver Set the following entries with the appropriate values:...
SMS Request Listener 3.2.4.5 Flow-Control Configure the following entries for the SMS-control: # The max number of SMS chunks per message. <int> sms.message.maxchunks= # The maximum number of bytes per message. <int> 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 Edition SMS System Account Id...
Request and Notification Queue Pool To configure the SMS Request Listener: Include oracle.panama.util.sms.SmsServer as another 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. Configure the SMS protocol. See Section 3.2.4.3. If the UCP protocol is used when configuring the SMS protocol, set: sms.receiver.listener.mode=true If the SMPP protocol is used when configuring the SMS protocol, set: sms.receiver.listener.mode=false...
Page 51
Request and Notification Queue Pool init.pool.size= # Minimum Thread pool size minimum.pool.size= Alerts and SMS Request Listener 3-7...
Page 52
Request and Notification Queue Pool 3-8 Oracle9i Application Server Wireless Edition Configuration Guide...
Logging 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"...
Database Logging 4.2.1 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. #System Logger related parameters # Number of minutes after which the logger thread wakes up to flush # the log entries to the database.
Database Logging select access to the V$ tables. Usage example: log in as system and say "grant select any table to %PANAMA_ USERNAME%" #SystemLog.db.connect.string=%PANAMA_USERNAME%/%PANAMA_USER_PW%@%PANAMA_ HOST%:%PANAMA_PORT%:%PANAMA_SID% 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.
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.
Transaction Logging 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.
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, and 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.
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/oracle/panama/core/probe directory. The following daemon manages the implementation: oracle.panama.core.probe.WebServer Logging 4-7...
Page 60
Configuring the Runtime Monitor and Management 4-8 Oracle9i Application Server Wireless Edition Configuration Guide...
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"...
Overview In this document: Important: WE_HOME is the directory in which Wireless Edition is installed followed by the "panama" sub-directory. For example: c:\ias10210\panama (Windows) /private/ias10210/panama (UNIX) Replace "WE_HOME" with the fully-qualified directory path. ORACLE_HOME is the directory in which Oracle9i Application Server is installed.
Multiple Instances on Same Machine as Oracle HTTP Server 5.2 Multiple Instances on Same Machine as Oracle HTTP Server To configure multiple JVM instances on the same machine: Modify the jserv.conf file so the Oracle HTTP Server is aware of the multiple JServ instances that are running.
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: ApJServShmFile ORACLE_HOME\Apache\Jserv\jserv_shm Close the section using: </IfModule> 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 instances.
Page 65
Multiple Instances on Same Machine as Oracle HTTP Server 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.
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.
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: While configuring jserv.conf change the ApJServHost directive so that the...
Page 68
Multiple Instances and Oracle HTTP Server All on Different Machines Start the Oracle HTTP Server. On each machine running the JServ instances, modify the jserv.properties file: bindaddress=ip_address_of_machine_running_jserv_instance security.allowedAddresses=oraclehttpserver_ip_address On the machine running the Master Instance, modify the Master.properties file. Table 5–1 for more information.
Configuring the Personalization Portal for Load-Balancing 5.5 Load Balancing When multiple instances are running, load balancing can 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.
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 intermediate gateways support cookies, enable one of the load-balanced Wireless Edition instances to service Personalization Portal requests.
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.properties= ORACLE_HOME\Apache\Jserv\conf\zone_pp.properties Modify the various Wireless Edition specific properties files. The default location for these files is in the <WE_HOME>\server\classes directory.
Configuring the Personalization Portal for Load-Balancing Set the following in the Notification.properties file in the <WE_ HOME>\server\classes\oracle\panama\core\admin\ directory to: sms.server.port=5000 Set the following in the Rmi.properties file in the <WE_ HOME>\server\classes\oracle\panama\core\admin\ directory. This is the port number on which the RMI server runs: rmi.server.port=201 Set the following in the www-server.properties file in the <WE_ HOME>\server\classes\oracle\panama\core directory:...
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\jndi.jar set classpath=%classpath%;ORACLE_HOME\lib\xmlparserv2.jar set classpath=%classpath%;<WE_HOME>\lib\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>\lib\sax2.jar set classpath=%classpath%;<WE_HOME>\lib\activation.jar set classpath=%classpath%;<WE_HOME>\lib\mail.jar set classpath=%classpath%;<WE_HOME>\lib\ldap.jar set classpath=%classpath%;<WE_HOME>\lib\ldapbp.jar set classpath=%classpath%;<WE_HOME>\lib\providerutil.jar set classpath=%classpath%;<WE_HOME>\lib\sdoapi.jar set classpath=%classpath%;<WE_HOME>\lib\sdovis.jar...
Page 74
Configuring the Personalization Portal for Load-Balancing 5-14 Oracle9i Application Server Wireless Edition Configuration Guide...
Oracle Enterprise Manager Oracle Enterprise Manager describes the use of Oracle Enterprise Manager with Wireless Edition. 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"...
Overview 6.1 Overview The use of Oracle Enterprise Manager with Wireless Edition provides: Performance monitoring 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 Wireless Edition Cartridge.
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 tier configuration instructions: The Oracle Enterprise Manager server side configuration involves the Oracle Intelligent Agent and Data Gatherer. See Section 6.3.1.
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. 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.
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 vpxptg 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 dbsnmp_stop To start the agent:...
Configuring the Server, Client, and Middle-tier Un-zip the ptgwincartridge.zip file in WE_ HOME/oem/agent/cartridge/win32 to a directory (referred to as CART_DIR in this document). Copy the file vpxptg.dll in CART_DIR\odg\bin to the ORACLE_HOME\bin directory. Copy the file vpxptgUS.htm in CART_DIR\odg\html to the ORACLE_ HOME\odg\html directory.
Page 81
Configuring the Server, Client, and Middle-tier Extract this file in the copied directory. 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. For example: jar -xvf oemptg.jar The entries in WE_HOME/oem/client/OEMClient.properties.append must be appended to ORACLE_HOME/sysman/config/OEMCLient.properties.
Page 82
Configuring the Server, Client, and Middle-tier The entries in WE_HOME/oem/client/vtdclient.properties.append must be appended to ORACLE_HOME/sysman/config/vtdclient.properties. The following shows the entries: /target/oracle_sysman_diagpack/oracle_sysman_ ptg=oracle.sysman.vtd.VtdPtgCredentials /options/standalone=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.
Configuring the Server, Client, and Middle-tier $ORACLE_HOME/jlib/ewtcompat-opt-3_3_6.zip $ORACLE_HOME/jlib/ewt-swingaccess-1_1_1.jar $ORACLE_HOME/jlib/share-1_0_8.jar $ORACLE_HOME/jlib/jssl-1_2.jar $ORACLE_HOME/jlib/javax-ssl-1_2.jar $ORACLE_HOME/jlib/netcfg.jar:/ For Windows: %ORACLE_HOME%\classes %ORACLE_HOME%\jdbc\lib\classes111.zip %ORACLE_HOME%\lib\vbjorb.jar %ORACLE_HOME%\lib\vbjapp.jar %ORACLE_HOME%\lib\vbjtools.jar %ORACLE_HOME%\classes\classesFromIDLVisi %ORACLE_HOME%\jlib\ewt-3_3_6.jar %ORACLE_HOME%\jlib\ewtcompat-opt-3_3_6.zip %ORACLE_HOME%\jlib\ewt-swingaccess-1_1_1.jar %ORACLE_HOME%\jlib\share-1_0_8.jar %ORACLE_HOME%\jlib\jssl-1_2.jar %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.
Setting up the ptg_services.tcl File # Wireless Edition events integration /com/oracle/sysman/em/tests_datasource/ptg/datasource = oracle.sysman.ptg.PTGTestsDatasource After updating the OMSRegistry.registry file, recreate the Note: 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.
Page 85
Setting up the ptg_services.tcl File set HostName($NEW_PARAMETER_NAME) $Host; set tnsaddress($NEW_PARAMETER_NAME) "(DESCRIPTION=(ADDRESS_LIST = (ADDRESS = (PROTOCOL = TCP)(HOST = TRACE_DB_HOSTNAME)(PORT = TRACE_DB_ PORT)))(CONNECT_DATA=(SID=TRACE_DB_SID)(ORACLE_HOME=TRACE_DB_ORACLE_ 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.
Configuration for Another Wireless Edition Instance set HostName($ServiceName2) $Host; set tnsaddress($ServiceName2) "(DESCRIPTION=(ADDRESS_LIST = (ADDRESS = (PROTOCOL = TCP)(HOST = ptgserver-sun.us.oracle.com)(PORT = 1521)))(CONNECT_ DATA=(SID=ptgdev)(ORACLE_HOME=/private/oracle/8.1.7)(SERVER=DEDICATED)))" Place this file in ORACLE_HOME/network/agent/config. Note: Add this file name to nmiconf.lst. To reflect any change to either file restart the Oracle Intelligent Agent and rediscover the node.
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.
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: Launch the necessary performance monitoring tool. See the Oracle Enterprise Manager documentation for instructions on how to launch it.
Multi-byte Character Support Multi-byte Character Support describes multi-byte character support in Wireless 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"...
Overview 7.1 Overview This release of Wireless Edition supports single-byte, multi-byte, and fixed-width encoding schemes which are based on national, international, and 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 the number of characters and the number of bytes.
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.
LocalStrings.properties Files and Localization 7.5.3 Localization for LDAP, Mail Adapter, and Personalization from 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.
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"...
System Password Encryption/Decryption 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: encryptPassword.sh WE_HOME/server/classes/oracle/panama/core/admin Then set the following property in the System.properties file: passwordEncrypted=true...
LoadXml 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.
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.
Upload and Download Utilities Option Description This option ensures that the repository 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.
Xslt Please make sure the -l option has been properly specified Note: 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.
CopyObjects Xslt, which is a command-line utility, reads from standard input and writes its results to standard output. Synopsis oracle.panama.util.Xslt [stylesheet] Options The Xslt utility takes the following option: Table 8–3 Options for the Xslt Utility Option Description The XSL stylesheet that the utility applies to the XML document. stylesheet Xslt Example java oracle.panama.util.Xslt mystylesheet.xsl <...
Page 100
CopyObjects Options The CopyObjects utility takes the following options: 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 Wireless Edition server. Specify the source in the format: username/password@//hostname:port/servername targets The target Wireless Edition servers.
Mod_JServ Configuration 9.1 Mod_JServ Configuration To adjust the maximum number of socket connections that Mod_ JServ can handle simultaneously, modify the following parameter in the jserv.properties file. Table 9–1 Mod_JServ Configuration Name Value security.maxConnections 9.2 Recommended Unix Kernel Parameters Oracle recommends that you modify the following kernel parameters in the /etc/system file: Table 9–2 Recommended Unix Kernel Parameters Parameter...
Property Files The Wireless Edition supports system-wide extensibility using property files. Each property file stores runtime parameters and processing information for a Wireless Edition component. The Wireless Edition property files are named with the extension .properties or .xml. Each section of this document presents a different topic. These sections include: Section 10.1, "Overview"...
Overview Section 10.17, "MailAdapter.properties" Section 10.18, "Master.Properties" Section 10.19, "positioner.xml" Section 10.20, "Geocoders.xml" Section 10.21, "Mappers.xml" Section 10.22, "Routers.xml" Section 10.23, "Strip.properties" Section 10.24, "MAgent.properties" Section 10.25, "MInstances.properties" Section 10.26, "Cookies.properties" In this document: Important: WE_HOME is the directory in which Wireless Edition is installed followed by the "panama"...
Page 107
Overview Table 10–1 Wireless Edition Properties Files Property File Description System.Properties Configuration settings for the entire Wireless Edition system. Notification.properties Email and SMS server configuration properties. Rmi.properties Identifies the server name and listening port of the Wireless Edition RMI server. oemevent.properties Properties for event logging using oemevent.
System.Properties Property File Description Mappers.xml Specifies the possible mapper capability providers’ preferences, in descending order. Routers.xml Specifies the routing capability provider’s preference in descending order. Strip.properties Acquires and converts arbitrary Web content; reads configuration settings from the Strip.properties file. Uses the settings in the file to locate classes that process the markup tags in content.
Page 109
System.Properties Type Editable Description instance.identifier String Wireless Edition server instance identifier. Must be unique among Wireless Edition server instances and should be modified if multiple instances are running. The default is instance1. locator.boot.check Boolean If set to true, the Wireless Edition performs a bootstrap check procedure during system boot.
Page 110
System.Properties Type Editable Description db.session.min Integer The minimum or optimal number of open database sessions. This parameter is used to tune the session pool. It can increase when necessary, but always attempts to return to the specified number of concurrent open database sessions.
Page 111
System.Properties Type Editable Description locator.objectcache.class Class The object cache Name implementation class. The default is oracle.panam.core.util.ObjectC acheHardWeakImpl. objectcache.check.timetolive Seconds The time-to-live, in seconds, of a persistent object. After this time, the Wireless Edition reconstructs the object. The default is 600. objectcache.check.interval Seconds The time required for the cache...
Page 112
System.Properties Type Editable Description log.level String list Log level. Can contain any of the following: error, warning, notify, or transaction. The default is "warning, error, notify". log.directory Path Log file directory. log.file.name File name Y Log file name pattern. The default is sys_panama.log.
Page 113
System.Properties Type Editable Description locator.external.hook.class Class Default implementation of name UserAuthenticationHook. The default is oracle.panama.core.PanamaExt ernalHookDefImpl. locator.useragent.class Class Default implementation of the name device recognition class. The default is oracle.panama.core.xform.User AgentImpl. locator.request.daemon .classes Class System daemons to start. See name list System.properties file for options.
Page 114
System.Properties Type Editable Description locator.home.folder.sorter.hook. String Value used by the class oracle.panama.rt.common.Ho meFolderSorter class to sort the services in a user’s home folder. The default is USER_ SERVICES_FIRST. locator.service.visibility.hook.class Class Declares a hook to show or Name hide a service when Wireless Edition is started.
Page 115
System.Properties Type Editable Description locator.session.id.hook.class Class Declares the hook for Name generating the session ID. The default is oracle.panama.rt.common.Sessi onIdGenerator. locator.listener.registration.hook. Class Declares the hook for the event class Name registration listener. The default is oracle.panama.rt.common.Liste nerRegistration. locator.caller.location.hook.class Class Declares the hook which Name acquires the user’s current location.
Page 116
System.Properties Type Editable Description locator.request.listener.classes Class Declares a class to implement Name the RequestListener interface, oracle.panama.core.admin.Syst emLogger to perform database session logging. The event.request.begin event.request.end, and event.after.request properties must be set to 1 to enable them locator.response.listener.classes Class Declares a class to implement Name the ResponseListener interface.
Page 117
System.Properties Type Editable Description event.request.error Boolean Declares a request event to be "error occurs during request processing". The default is false, or disabled. Set to true to enable. event.after.request Boolean Declares a request event to be "request object has been released".
Page 118
System.Properties Type Editable Description order.services String The sorting order for the Wireless Edition services, folders, and bookmarks on the output devices. The default is ORDER_SEQNO_ASC, ORDER_NAME_ASC. SystemLog.enableServiceLogging Boolean Specifies whether Service Logging should be enabled. The default is false. SystemLog.enableSessionLogging Boolean Specifies whether Session Logging should be enabled.
Notification.properties 10.3 Notification.properties This file provides basic configuration for the notification engine. This file is in the WE_HOME/server/classes/oracle/panama/core/admin directory. Table 10–3 Parameters of the Notification.properties File Type Editable Description dispatcher.logical.device. String Repository name of the logical device for email.name email. The default is EMAIL. dispatcher.logical.device.
Rmi.properties Type Editable Description mail.server.name String Send Mail Transport Protocol (SMTP) server host name if email is used as the means of notification. mail.domain String Optional property. The mail domain name used if required by the SMTP server. mail.from String Mandatory property.
oemevent.properties Type Editable Description rmi.server.name String Name of the RMI server. The default is PanamaServer. The implementation is managed by the daemon: oracle.panama.core.rmi.server.ServerImpl 10.5 oemevent.properties Asynchronous notification of error information is provided using the event framework provided by Oracle Enterprise Manager. In case of an error, the 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.
Ftp.properties You must be connected to the spatial database to use the Note: spatial adapters. In addition, data stored in the spatial database (images and geometry) must be purchased from a third-party provider. 10.6 Ftp.properties The FTP server is a daemon that publishes the repository as an FTP file system. The repository folder is represented as an FTP directory, and repository objects are represented as FTP files.
Spatial.Properties The Ftp.properties file has the following parameters: Table 10–6 Parameters of the Ftp.properties File Type Editable Description ftp.server.port Integer TCP listening port. The default is 9100. ftp.connection.timeout Seconds Client connection timeout in seconds, a value of 0 is equal to "no timeout." The default is ftp.charset String Character set used to send "Object"...
www-server.properties 10.8 www-server.properties 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.
Provisioning.properties oracle.panama.core.probe.WebServer 10.9 Provisioning.properties This property file is used by the Provisioning adapter and the Personalization Portal. This file is in the WE_HOME/server/classes/oracle/panama/core/admin directory. Table 10–9 Parameters of the Provisoning.properties File Type Editable Description common.root Folder Common root folder for the user’s home Name folders.
useragent.properties 10.10 useragent.properties This property file lists the mapping from the HTTP user agent to the Wireless Edition logical device. This file is in the WE_HOME/server/classes/oracle/panama/core/admin directory. Table 10–10 Parameters of the UserAgents.properties File Type Editable Description default.logicaldevice Device Default logical device if no mapping is found. The default is WML11.
EncodingSets.properties Table 10–12 Parameters of the AsynchNotification.properties File Type Editable Description worker.classname Class Implementation class for the asynchronous Name notification Dequeuer. The default is oracle.panama.core.parm.asynch.AsynchNotifica tionImpl. init.pool.size Integer Thread pool size at startup. The default is 1. minimum.pool.size Integer Minimum thread pool size. The default is 1. server.listen.port Integer Asynchronous notification Dequeuer...
LocationMark.properties This file is in the WE_HOME/server/classes/oracle/panama/core/admin directory. The IANA standard is available on the Information Sciences Institute web site. The Java encoding set names are published on the Javasoft web site. Table 10–14 Parameters of the EncodingSets.properties File Description [ID].iananame IANA name for the encoding set.
ProxyFirewall.properties Type Editable Description display.County String County of the location mark. display.State String State of the location mark. display.Country String Country of the location mark. display.PostalCodeExt String Postal extension code of the location mark. display.PostalCostCode String Postal code of the location mark. 10.16 ProxyFirewall.properties This property file specifies the proxy properties used by Wireless Edition when HTTP or FTP protocols are required.
MailAdapter.properties Type Editable Description authentication.set Boolean Declares whether the proxy server requires authentication. The default is false. authentication.username String User name if authentication is required. authentication.password String Password if authentication is required. 10.17 MailAdapter.properties This is the properties file for the email adapter. It is in the WE_ HOME/server/classes/oracle/panama/adapter/mail directory.
Geocoders.xml Type Editable Description rmiThreadPool.minThreads Integer Maximum number of threads in the RMI thread pool. The default is 20. rmiThreadPool.idleTimeout Integer Idle timeout, in minutes, for the thread. The default is 10. remoteObjects.length Integer Default is 1. remote.Object1.name String Default is CacheSynchServer. remoteObject1.implementation String Default is oracle.panama.master.CacheSyncS...
Mappers.xml Table 10–20 Parameters of the Geocoders.xml File Description ProviderName Provider name. ProviderImpl Class that implements the provider. the rest Additional arguments read by the provider. 10.21 Mappers.xml This XML file specifies all the possible mapper capability providers. The sequence in the XML file determines the mapper provider’s preference in descending order.
Page 133
Strip.properties with a translation table to convert a target entity into an appropriate string. It in the WE_HOME/server/classes/oracle/panama/adapter/stripper directory. Table 10–23 Parameters of the Strip.properties File Type Editable Description stripper.useProxy Boolean Enables the use of a proxy server. The default is true. stripper.proxyServe Host Name of the proxy server.
MAgent.properties oracle.panama.adapter.stripper.Strip1.targets.aring = å oracle.panama.adapter.stripper.Strip1.targets.Aring = Å oracle.panama.adapter.stripper.Strip1.targets.ouml = ö oracle.panama.adapter.stripper.Strip1.targets.Ouml = Ö oracle.panama.adapter.stripper.Strip1.targets.amp = & oracle.panama.adapter.stripper.Strip1.targets.Amp = & oracle.panama.adapter.stripper.Strip1.targets.AMP = & oracle.panama.adapter.stripper.Strip1.targets.nbsp = - oracle.panama.adapter.stripper.Strip1.targets.euml = ë oracle.panama.adapter.stripper.Strip1.targets.Euml = Ë oracle.panama.adapter.stripper.Strip1.targets.#150 = - 10.24 MAgent.properties The Magent.properties file on both the client and server side points to an instance’s classes and port.
Cookies.properties instance name to the corresponding Magent.properties file. For example, for two instances: PTG1=oracle.panama.magent.config.Magent1 PTG2=oracle.panama.magent.config.Magent2 10.26 Cookies.properties This property file enables Wireless Edition to use cookies and sets the duration of the login session. This file is in the WE_HOME/server/classes/oracle/panama/core/admin directory.