Oracle Application 9i, Configuration Manual

Page 1: ...Oracle9i Application Server Wireless Edition Configuration Guide Release 1 1 May 2001 Part No A86701 02 ...

Page 2: ...ograms delivered subject to the DOD FAR Supplement are commercial computer software and use duplication and disclosure of the Programs including documentation shall be subject to the licensing restrictions set forth in the applicable Oracle license agreement Otherwise Programs delivered subject to the Federal Acquisition Regulations are restricted computer software and use duplication and disclosu...

Page 3: ...guration 1 3 1 2 1 Configure Oracle HTTP Server and JServ 1 3 1 2 2 Configure ProxyFirewall properties 1 6 1 2 3 Start the Oracle HTTP Server 1 6 1 2 4 Wireless Edition Configuration Verification 1 6 1 3 Upgrade 1 7 1 4 Samples 1 8 1 5 Web Integration Server 1 9 1 6 Wireless Edition Client 1 10 1 6 1 Service Designer 1 10 1 6 2 Web Integration Developer 1 10 1 7 OCI8 JDBC Driver 1 11 1 8 User Prov...

Page 4: ... 2 9 2 3 0 3 3 Mail Configuration Class 2 11 2 3 0 3 4 Configuration of URL Adapter in PTG 1 1 ServiceDesigner 2 13 3 Alerts and SMS Request Listener 3 1 Overview 3 1 3 2 Alerts 3 2 3 2 1 Request Queue 3 2 3 2 2 Notification Queue 3 3 3 2 3 Email based Alert 3 3 3 2 4 SMS based Alert 3 3 3 2 4 1 SMS C Server 3 3 3 2 4 2 SMPP Protocol 3 4 3 2 4 3 SMS Protocol 3 4 3 2 4 4 UCP Protocol 3 4 3 2 4 5 Fl...

Page 5: ... Machines 5 7 5 5 Load Balancing 5 9 5 5 1 Load Balancing with Cookies 5 9 5 5 2 Load Balancing Through URL Rewriting 5 9 5 6 Configuring the Personalization Portal for Load Balancing 5 9 5 6 1 Clients Gateways Support Cookies 5 10 5 6 2 Clients Gateways Do Not Support Cookies 5 10 5 6 3 Sample Batch File 5 12 6 Oracle Enterprise Manager 6 1 Overview 6 2 6 2 Prerequisites 6 2 6 3 Configuring the S...

Page 6: ...nalization Portal 7 3 7 4 Setting up a Netscape Browser to Display Multi byte Data 7 3 7 5 LocalStrings properties Files and Localization 7 3 7 5 1 Service Designer Localization 7 3 7 5 2 Personalization Portal Localization 7 3 7 5 3 Localization for LDAP Mail Adapter and Personalization from a Device 7 4 8 Utilities 8 1 System Password Encryption Decryption 8 2 8 1 1 Extensibility 8 2 8 2 LoadXml...

Page 7: ...10 12 AsynchNotification properties 10 22 10 13 AsynchRequest properties 10 23 10 14 EncodingSets properties 10 23 10 15 LocationMark properties 10 24 10 16 ProxyFirewall properties 10 25 10 17 MailAdapter properties 10 26 10 18 Master Properties 10 26 10 19 positioner xml 10 27 10 20 Geocoders xml 10 27 10 21 Mappers xml 10 28 10 22 Routers xml 10 28 10 23 Strip properties 10 28 10 24 MAgent prop...

Page 8: ...viii ...

Page 9: ...meters for the System properties File 10 4 10 3 Parameters of the Notification properties File 10 15 10 4 Parameters of the Rmi properties File 10 16 10 5 Parameters of the oemevents properties File 10 17 10 6 Parameters of the Ftp properties File 10 19 10 7 Parameters of the spatial properties File 10 19 10 8 Parameters of the www server properties File 10 20 10 9 Parameters of the Provisoning pr...

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

Page 11: ...xamples 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 4...

Page 12: ...xii ...

Page 13: ...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 techno...

Page 14: ...figuring the SMS Listener to process time based scheduled services known as Alerts Chapter 4 Logging Configuring the logging capabilities of Wireless Edition Chapter 5 Multiple JVM Support and Load Balancing Configuring Wireless Edition to allow multiple Java Virtual Machine instances and load balancing Chapter 6 Oracle Enterprise Manager Configuring the Oracle Enterprise Manger for use with Wirel...

Page 15: ... our documentation includes features that make information available to users of assistive technology This documentation is available in HTML format and contains markup to facilitate access by the disabled community Standards will continue to evolve over time and Oracle is actively engaged with other market leading technology vendors to address technical obstacles so that our documentation can be ...

Page 16: ...xvi ...

Page 17: ... a different topic These sections include Section 1 1 Installation Overview Section 1 2 Manual Configuration Section 1 3 Upgrade Section 1 4 Samples Section 1 5 Web Integration Server Section 1 6 Wireless Edition Client Section 1 7 OCI8 JDBC Driver Section 1 8 User Provisioning Section 1 9 Geocoding Setup Section 1 10 JDBC Connection Pooling ...

Page 18: ...vironment variables port numbers starting and stopping the Oracle HTTP Server and the Wireless Edition client configuration For a new installation of Wireless Edition follow the steps in this document starting with the manual configuration in Section 1 2 If you have a previous release of Wireless Edition installed see Section 1 3 Important In this document WE_HOME is the directory in which Wireles...

Page 19: ...the application server can find the http hostname portal Login jsp URL Include the following in the Alias section Alias portal WE_HOME server portal b To access a previous release of the Personalization Portal in addition to this release create an alias This allows the application server to find the http hostname papz login jsp URL Include the following in the Alias section Alias papz WE_HOME serv...

Page 20: ...classpath WE_HOME lib ocelot opt zip wrapper classpath WE_HOME lib share opt 1_1_7 zip wrapper classpath WE_HOME lib tecate opt zip wrapper classpath WE_HOME lib regexp jar wrapper classpath WE_HOME lib sax2 jar wrapper classpath WE_HOME lib activation jar wrapper classpath WE_HOME lib mail jar wrapper classpath WE_HOME lib ldap jar wrapper classpath WE_HOME lib ldapbp jar wrapper classpath WE_HOM...

Page 21: ...operties file as follows wrapper env DISPLAY x_server_host_name 0 0 From the X server host machine run the following command using the Wireless Edition host wireless_edition_host_name in the following example xhost wireless_edition_host_name 5 Configure the zone properties file The zone properties file is in the ORACLE_ HOME Apache Jserv etc directory a In the List of Repositories section add the ...

Page 22: ... http use proxy true 2 Specify the correct host in http proxy host For example http proxy host www proxy us oracle com 3 Specify the correct port in http proxy port For example http proxy port 80 1 2 3 Start the Oracle HTTP Server To start the Oracle HTTP Server see the instructions in the Oracle9i Application Server Installation Guide 1 2 4 Wireless Edition Configuration Verification After instal...

Page 23: ...e following steps 1 Stop the Oracle HTTP Server See the Oracle9i Application Server Installation Guide for instructions 2 Back up the entire panama directory For example copy the entire panama directory to a different location 3 Back up the repository using an Oracle backup tool 4 Run the Oracle9i Application Server installation 5 Follow the manual configuration steps in Section 1 2 6 Restart the ...

Page 24: ...rties file This must be added before the Oracle HTTP Server is started wrapper classpath WE_HOME sample Windows wrapper classpath WE_HOME sample UNIX 5 Restart the Oracle HTTP Server See the Oracle 9i Application Server Installation Guide for instructions You should see the sample adapters and sample services in the master Samples folder using the Service Designer or the Personalization Portal Not...

Page 25: ...om a browser go to the Web Integration Server URL http host_name domain 5555 3 Log in to the Web Integration Server with the user name Administrator and password manage These are the default settings 4 Select Settings The server settings appear Click Edit 5 Enter the Proxy HTTP and Secure Proxy HTTPS settings for your environment 6 Click Submit 7 Click Logout The Web Integration Developer the deve...

Page 26: ...ice Designer is installed during the Wireless Edition client installation See the Oracle 9i Application Server Wireless Edition Implementation Guide for information on using this tool 1 6 2 Web Integration Developer Web Integration Developer is a development environment for creating and testing Web Integration services written in Web Interface Definition Language WIDL The Web Integration Developer...

Page 27: ...racle OCI8 driver 1 Verify that ORACLE_HOME is the directory under which Wireless Edition has been installed a On Windows Modify the jserv properties file to include the PATH of the directory where the OCI library ocijdbc8 dll is installed The default is ORACLE_HOME bin wrapper path ORACLE_HOME bin b On UNIX Verify that the LD_LIBRARY_PATH environment variable includes the directory where the OCI ...

Page 28: ...nd Oracle9i Application Server Wireless Edition Developer s Guide for more information on the data model API 1 9 Geocoding Setup Wireless Edition provides basic geocoding through the provider MapInfo To expand the geocoding capability to include other providers see the Oracle9i Application Server Wireless Edition Implementation Guide Additionally if a proxy server is used to access an external web...

Page 29: ...mechanism Minimum number of connections for the connection pool db connect minConnections 5 Maximum number of connections for the connection pool db connect maxConnections 100 Incremental allocation of new connections to the connection pool db connect incConnections 1 Time interval in seconds for the watchdog to find and release unused connections to the connection pool repository session check in...

Page 30: ...JDBC Connection Pooling 1 14 Oracle9i Application Server Wireless Edition Configuration Guide ...

Page 31: ... 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 ...

Page 32: ...ing WAP phones Palms PocketPCs and RIM pagers with browser support Flexible deployment options depending on your business needs Support for IMAP and POP3 protocols including MS Exchange 5 5 and later and Lotus Domino 4 5 and later Integrated corporate email with LDAP employee lookup Standalone LDAP employee lookup 2 2 Installation 2 2 1 System Requirements This section is only applicable if the Ma...

Page 33: ...he main JSP for the Mail Application and LDAP jsp is the main JSP for the Directory Application 2 2 2 2 On PTG 1 1 PTG 1 1 already includes Apache web server and JServ 1 1 1 Configure JServ so that the jar files are in its classpath Go to JServ1 1 1 directory conf jserv properties then put the following lines before all other classpaths wrapper classpath ompim properties directory wrapper classpat...

Page 34: ...d 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...

Page 35: ...le UNIX format mail logger tmp mail log Windows format mail logger d tmp mail log 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 server 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 ...

Page 36: ...nnection 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 di...

Page 37: ...d 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 see the LDAP documentation ldap links Hotlink is a mechanism that enables you to create hyperlinks on the attribute in the result list For details about Hotlink see the LDAP ...

Page 38: ...in the LDAP schema ldap maxRecPage Maximum results displayed on a screen Default 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...

Page 39: ...he 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 ...

Page 40: ..._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 Definition possible values and default values are the same as the mail config class in the properties file DIR_ENABLED Definition possible value...

Page 41: ...ing methods Table 2 5 Mail configuration class PTG_VERSION Definition possible values and default values are the same as the oracle panama version in the properties file STUDIO Definition possible values and default values are the same as the studio in the properties file String getMailService Object o Returns the mail service The current supported services are IMAP and POP3 String getDomain Objec...

Page 42: ... 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 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 consist...

Page 43: ...t 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 ...

Page 44: ...Configuration 2 14 Oracle9i Application Server Wireless Edition Configuration Guide Figure 2 1 Service Designer Window Now you can use e mail ...

Page 45: ...ecuted 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...

Page 46: ...rt functionality in the Wireless Edition requires the installation of the Oracle8i JOB and AQ options 3 2 1 Request Queue The request queue stores all the alerts to be executed The Wireless Edition processes an alert as follows 1 An alert is created or updated 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 ...

Page 47: ...ame The mail domain name set if SMTP server requires this domainname mail domain The from mail address mandatory email address mail from The organization optional string mail organization The default mail subject mandatory string mail subject The Content Transfer Encoding mandatory string mail content transfer encoding 3 2 4 SMS based Alert If the result of a delivered alert is a SMS message confi...

Page 48: ...tem id string sms smpp system id The SMPP system type string sms smpp system type The SMPP client password string sms smpp system 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 command set or the Short Message Peer to Peer SMPP protocol to communicate with the SMS C 3 2 4 4 UCP Proto...

Page 49: ...eless Edition SMS System Account Id sms account id The corresponding password sms account password 3 3 SMS Request Listener 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...

Page 50: ... 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 Thread Pool Size To configure the thread pool size for the request queue set the following appropriately in the AsynchRequest proper...

Page 51: ...Request and Notification Queue Pool Alerts and SMS Request Listener 3 7 init pool size Minimum Thread pool size minimum pool size ...

Page 52: ...Request and Notification Queue Pool 3 8 Oracle9i Application Server Wireless Edition Configuration Guide ...

Page 53: ...s 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 patterns response times for ser...

Page 54: ...temLog logger maxSize 100 Whether service logging should be enabled SystemLog enableServiceLogging true Whether session logging should be enabled SystemLog enableSessionLogging true The request listener class locator request listener classes oracle panama core admin SystemLogger The session listener class locator session listener classes oracle panama core admin SystemLogger Enable event request l...

Page 55: ... tables ptg_service_log and ptg_ session_log Table 4 1 Contents of the ptg_session_log Table 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 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_...

Page 56: ... 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...

Page 57: ...ition specifies these types of errors Table 4 3 Server Error Information 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 file If you need to contact Oracle Support Services you should have the log information available 4 5 Transaction Logging The t...

Page 58: ...y 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 OnlineQuoteOracle 25 11 14 99 4 03 29 PM Sample master OnlineQuoteOracle 25 11 14 99 4 03 35 PM Sample master OnlineQuoteOracle 25 4 6 Configuring the Runtime Monitor...

Page 59: ...ment Logging 4 7 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 ...

Page 60: ...Configuring the Runtime Monitor and Management 4 8 Oracle9i Application Server Wireless Edition Configuration Guide ...

Page 61: ...nclude 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 Ja...

Page 62: ...ation setup to ensure that the object caches of each instance are synchronous Multiple JVM environment without JServ session cookies Personalization Portal setup Important In this document WE_HOME is the directory in which Wireless Edition is installed followed by the panama sub directory For example c ias10210 panama Windows private ias10210 panama UNIX Replace WE_HOME with the fully qualified di...

Page 63: ... Running multiple instances of JServ requires a manual start for each instance ApJServMount ptg balance set1 root c W1 W2 WN are integers that determine the load balancing weight assigned to each of the instances To 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 ...

Page 64: ...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 b The log file For Unix ensure that the JServ process owner has write permissions for this file log file ORACLE_HOME Apache Jserv logs jservx log c This allows only clients from the local machi...

Page 65: ...nchronization 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 masterInstance url localhost 2007 d Modify the properties files in Table 5 1...

Page 66: ...www server properties port 809x magent config MAgent properties magent server port 201x Same as rmi server port in Rmi properties spatial spatial properties Change path to class files to reflect the per instance classes Master Master properties Modify the db connect parameter in this file to be the same as that in System properties Modify only the Master properties file in the classpath of the mas...

Page 67: ...achine running JServ instances only that they must not conflict 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_...

Page 68: ...sure that the instance participates in cache synchronization participateInCacheSynchronization 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 Maste...

Page 69: ...ng among Jserv instances with URL 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 ...

Page 70: ...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 running for each of the instances and modify the following a Set the port which th...

Page 71: ...instance identifier instance b Set the following parameter to true to ensure that the instance participates in cache synchronization participateInCacheSynchronization true c Set the enable http session binding to false d Set the following 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 p...

Page 72: ...racle panama core admin directory magent server 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 S...

Page 73: ...ME 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 set classpath classpath WE_HOME lib MapQuestX jar...

Page 74: ...Configuring the Personalization Portal for Load Balancing 5 14 Oracle9i Application Server Wireless Edition Configuration Guide ...

Page 75: ...tting up the ptg_services tcl File Section 6 5 Configuration for Another Wireless Edition Instance Section 6 6 Configuring the Database Logger Section 6 7 Asynchronous 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 installed followed by the panama sub directory For example ...

Page 76: ...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 Oracle Intelligent Agent running on each node picks up these events and forwar...

Page 77: ...e The server side configuration includes the configuration 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 Agent 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 e...

Page 78: ...erformance 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 1 Un tar the ptgsolariscartridge tar file found in WE_ HOME oem agent cartridge solaris to a directory referred to ...

Page 79: ...p_stop To start the agent lsnrctl dbsnmp_start Data Gatherer Start and Stop To stop the gatherer vppcntl stop To start the gatherer vppcntl start 6 3 1 3 Wireless Edition Data Gatherer Cartridge Installation Windows To install the data gatherer cartridge Note For more information on commands to restart the Oracle Intelligent Agent Oracle Management Server and Data Gatherer see the Oracle Enterpris...

Page 80: ...side configuration for Oracle Enterprise Manager integration Restart the Oracle Intelligent Agent and the Data Gatherer This starts the Wireless Edition cartridge along with the Oracle Intelligent 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 1 Install the Oracle E...

Page 81: ... display_class oracle sysman ptg navigator PtgDisplayDriver Console definition of types for navigator tree for Wireless Edition com oracle sysman em console navigator oracle_sysman_ptg data_source oracle sysman ptg navigator PtgSubItemContainerSource com oracle sysman em console navigator oracle_sysman_ptg proxy oracle sysman ptg navigator PtgProxy Events Integration Wireless Edition events integr...

Page 82: ...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 Host Name magent server host Wireless Edition server host name The service port Use the same port as the RMI server as in Rmi properties magent server port 2008 Service Name magent server name Magent 8 Verify that the...

Page 83: ...l 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 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 insta...

Page 84: ... 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 Parameters ServiceType HostName tnsaddress argv NEW_PARAMETER_ NAME ServiceName2 set Parameters oracle_sysman_ptg ServiceType HostName tnsaddr...

Page 85: ...is a subnode in the Navigator tree In the line below just append the new parameter name i e ServiceName2 Don t duplicate this line global Parameters ServiceType HostName tnsaddress argv ServiceName2 set Parameters oracle_sysman_ptg ServiceType HostName tnsaddress set Host lindex argv 0 Lines below need to be duplicated every time a new instance is added set ServiceName2 PTG2 lappend ServiceNames S...

Page 86: ...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 config Magent1 PTG2 oracle panama magent config Magent2 3 Magent pr...

Page 87: ...sary details for the fault diagnosis 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 Note An Oracle Enterprise Manager agent must be running on the node where oemevent is inv...

Page 88: ... This information is the same as the system logger configuration information 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 Management is accomplished through the Oracle Ent...

Page 89: ... 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 ias10210 panama UNIX Replace WE_HOME with ...

Page 90: ...haracter 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 thousands of characters These schemes use either a fixed number of bytes to represent a character or a variable number of bytes per character 7 2 1 Fixed width Encoding Schemes In a fixed width Multi by...

Page 91: ...scape 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 Fil...

Page 92: ...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 int...

Page 93: ...sed 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 ...

Page 94: ... class identifies the encryption algorithm To provide extensibility the class can be used to invoke a user s algorithm in place of the default algorithm The default setting is locator SystemPasswordEncryptionHook class oracle panama rt common SystemPasswordEncryption To use an alternate encryption algorithm implement the following interface public interface SystemPasswordEncryptionHook Encrypts th...

Page 95: ...L 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 without 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 lo...

Page 96: ...er 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 the XML data p This option activates provisioning of user data when uploading This mode is only used with the c option The...

Page 97: ...ke 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 r This option ensures that the r...

Page 98: ...ply the stylesheets you create to any XML document Note Please make sure the l option has been properly specified in either the upload bat or upload sh script file Entry Behavior xmlloader pathExpression Specifies the regular expression which determines the path of the objects that you intend to upload and download xmlloader activityLog Specifies the location of logging activity xmlloader errorLog...

Page 99: ...s 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 command line Requirements All source and target Wireless Edition servers must have the Wirel...

Page 100: ...ion sites at m1 and m2 java oracle panama core util CopyObjects f master finance s user pw 2008 WEServer user pw m1 2008 WEServer user pw m2 2008 WEServer 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 S...

Page 101: ...tings defines recommended parameters for Wireless Edition Each section of this document presents a different topic These sections include Section 9 1 Mod_JServ Configuration Section 9 2 Recommended Unix Kernel Parameters Section 9 3 Recommended Unix TCP Parameters ...

Page 102: ...odify the following kernel parameters in the etc system file Table 9 2 Recommended Unix Kernel Parameters 9 3 Recommended Unix TCP Parameters The following TCP parameters should be modified through the ndd command Table 9 3 Recommended Solaris TCP Parameters Name Value security maxConnections 200 Parameter Value priority_paging 1 rlim_fd_max 8192 rlim_fd_cur 2048 lwp_default_stksize 0x4000 rpcmod ...

Page 103: ...000 tcp_ip_abort_cinterval 60000 tcp_keepalive_interval 120000 tcp_fin_wait_2_flush_interval 16000 tcp_conn_req_max_q 10240 tcp_conn_req_max_q0 10240 tcp_xmit_hiwat 65536 tcp_xmit_lowat 32768 tcp_recv_hiwat 65536 tcp_slow_start_initial 2 tcp_time_wait_interval 32767 Parameter Value ...

Page 104: ...Recommended Unix TCP Parameters 9 4 Oracle9i Application Server Wireless Edition Configuration Guide ...

Page 105: ...se sections include Section 10 1 Overview Section 10 2 System Properties Section 10 3 Notification properties Section 10 4 Rmi properties Section 10 5 oemevent properties Section 10 6 Ftp properties Section 10 7 Spatial Properties Section 10 8 www server properties Section 10 9 Provisioning properties Section 10 10 useragent properties Section 10 11 LDAP properties Section 10 12 AsynchNotification...

Page 106: ... or extend and configure existing ones The Wireless Edition includes many property files The following table lists the property files you can use to configure Wireless Edition Important In this document WE_HOME is the directory in which Wireless Edition is installed followed by the panama sub directory For example c ias10210 panama Windows private ias10210 panama UNIX Replace WE_HOME with the full...

Page 107: ... in the Wireless Edition repository to the actual user agent parameter received in an HTTP header Also specifies a default logical device to use if the device type cannot be determined LDAP properties Server timing and referral handling properties for LDAP adapter AsynchNotification properties Outgoing message queue Asynchronous Dequeuer properties AsynchRequest properties Incoming Asynchronous Re...

Page 108: ...viders 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 Each processing class implements a strip level for the adapter To...

Page 109: ...te in Cache Synchronization The default is false masterInstance url String Y The URL for the master instance s registry The default is localhost 2007 enable http session binding Boolean Y Enables binding to HTTP session to allow URL rewriting based on JServ load balancing The default is false db connect string String Y A valid connect string including user name and password The precise format depe...

Page 110: ...ions Integer Y The incremental allocation of new connections to the connection pool The default is 1 name separator Character N The separator used in the service path This cannot be modified after installation The default is a forward slash repository session check interval Seconds Y Time interval for unused connections to be found and released to the connection pool The default is 1 passwordEncry...

Page 111: ...ult is 60 session expiration time Seconds Y The time to live attribute of a session The default is 600 session expiration checkinterval Seconds Y The time required for the session monitor to check an open session The default is 60 locator persistent class Class name N The locator implementation for persistent objects The default is oracle panama core PersistentL ocatorImpl locator logger class Cla...

Page 112: ... name pattern The default is tx panama log log tx file maxsize Integer Y Maximum number of transaction entries in the same file The default is 1000 log tx file pattern Formatted string Y Pattern used to write transaction log records The default is user id user external id service name path cost log tx min cost Integer Y Minimum cost for the services to be logged The value specified is compared wit...

Page 113: ...otificationQueueImpl locator notification queue class Class name N Asynchronous notification queue implementation The default is oracle panama util Notification DispatcherImpl locator notification dispatcher class Class name Y Default notification engine implementation Default is oracle panama util Notification DispatcherImpl locator postprocessor class Class name N Transformer post processor impl...

Page 114: ...f a folder based on its current location The default is oracle panama rt common Loca tionServiceVisibility locator authentication hook class Class Name Y Declares the hook for user authentication The default is oracle panama rt common Aut henticator locator authorization hook class Class Name Y Declares the hook for user service authorization The default is oracle panama rt common Aut horizer loca...

Page 115: ...ed request parameter used to acquire the user s subscriber ID locator subscriber id hook class Class Name Y Declares a hook to acquire a subscriber s ID locator pre processor hook class Class Name Y Declares a hook to be invoked before device transformation locator post processor hook class Class Name Y Declares a hook to be invoked after device transformation locator combined listener classes Cla...

Page 116: ...clares a request event to be begin being processed The default is false or disabled Set to true to enable event request end Boolean Y Declares a request event to be request has been completely processed The default is false or disabled Set to true to enable event service begin Boolean Y Declares a request event to be before the adapter is invoked The default is false or disabled Set to true to ena...

Page 117: ...event to be before session starts The default is false or disabled Set to true to enable event session begin Boolean Y Declares a session event to be session has been validated The default is false or disabled Set to true to enable event session end Boolean Y Declares a session event to be session has expired implicitly and explicitly The default is false or disabled Set to true to enable event af...

Page 118: ...ency Minutes Y Specifies the number of minutes after which the logger thread wakes up to flush the entries in the database tables The default is 10 SystemLog db connect string String Y JDBC connect string for logging to a second database transformer poolsize Integer Y Specifies the number of XML transformers in the pool The pool size should be around 1 5 times the number of CPUs The default is 10 ...

Page 119: ...String Y Password for the sms account id sms server name String Y Name of the host where SMS C is running sms server port Integer Y Port number on which the SMS C is listening sms driver class String Y Use oracle panama util sms SmsUCPDriver for UCP protocol Use oracle panama util sms SmsSMPPDriver for SMPP protocol The default is the UCP protocol sms ucptype String Y Specify the UCP command set t...

Page 120: ...e effect when the RMI server works at the object level of the system To connect to an RMI daemon you must provide a valid administrator user name and password This file is in the WE_HOME server classes oracle panama core admin directory The Rmi properties file has the following parameters Table 10 4 Parameters of the Rmi properties File mail server name String Y Send Mail Transport Protocol SMTP s...

Page 121: ...rties file has the following parameters Table 10 5 Parameters of the oemevents properties File rmi server name String Y Name of the RMI server The default is PanamaServer Note An OEM 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 Key Type Editable Description oemevent path string Y ...

Page 122: ...eate subdirectories service tree folders only Delete directories service tree folders only Delete any object Rename directories and files This file is in the WE_HOME server classes oracle panama core admin directory Note You must be connected to the spatial database to use the spatial adapters In addition data stored in the spatial database images and geometry must be purchased from a third party ...

Page 123: ...Table 10 7 Parameters of the spatial properties File Key Type Editable Description ftp server port Integer Y TCP listening port The default is 9100 ftp connection timeout Seconds Y Client connection timeout in seconds a value of 0 is equal to no timeout The default is 30 ftp charset String Y Character set used to send Object names it must be a valid Java character set The default is ISO8859_1 Key ...

Page 124: ...ates the probe runtime monitor with the listening port 8090 To access the probe from a browser enter the following URL http host_name 8090 This file is in the WE_HOME server classes oracle panama core probe directory The www server properties file has the following parameters Table 10 8 Parameters of the www server properties File The following daemon manages the implementation Key Type Editable D...

Page 125: ...d for every new user The default is Users Home common root owner String Y Owner of the subfolder for users Subfolders must have an owner which should have administrator privileges The default is Administrator common group list String Y List of groups the new user should belong to for example group_name group_name If a group does not exist it is created automatically label create_user label user_ex...

Page 126: ...2 AsynchNotification properties This is the property file read by the asynchronous notification Dequeuer It is in the WE_HOME server classes oracle panama core admin directory Key Type Editable Description default logicaldevice Device Y Default logical device if no mapping is found The default is WML11 ID useragent String Y UserAgent starting string from HTTPRequest ID logicaldevice String Y Logic...

Page 127: ...Dequeuer The default is oracle panama core parm asynch AsynchNotifica tionImpl init pool size Integer Y Thread pool size at startup The default is 1 minimum pool size Integer Y Minimum thread pool size The default is 1 server listen port Integer Y Asynchronous notification Dequeuer management server listening port The default is 55000 server listen host Host Name Y Host which is running notificati...

Page 128: ...re set to true are displayed in the Personalization Portal and on mobile devices connected to the Personalization Portal for personalization This file is in the WE_HOME server classes oracle panama core admin directory Table 10 15 Parameters of the LocationMark properties File Key Description ID iananame IANA name for the encoding set ID javaname Corresponding Java name for the encoding set Key Ty...

Page 129: ...Editable Description http use proxy Boolean Y Declares the use of an HTTP proxy server If this is false then proxyhost and proxy port settings are ignored The default is false http proxy host Host Name Y Proxy host name The default is localhost http proxy port Port Number Y Proxy server port number The default is 80 http non proxy host String Y Lists hosts that should not use a proxy server Each h...

Page 130: ... default is false authentication username String Y User name if authentication is required authentication password String Y Password if authentication is required Key Type Editable Description JavaMail USER_ DISPLAY_NUM Integer Y Number of message headings displayed at one time under a message folder The default is 6 JavaMail EMAIL_ CONTENT_NUM Integer Y Number of characters displayed for a long m...

Page 131: ...in minutes for the thread The default is 10 remoteObjects length Integer Y Default is 1 remote Object1 name String N Default is CacheSynchServer remoteObject1 implementation String N Default is oracle panama master CacheSyncS erver ptginstances length Integer Y Number of instances that will participate in the multiple Java Virtual Machine synchronization ptginstance n rmi host String Y Host name f...

Page 132: ...ovider s preference in descending order It is in the WE_HOME server classes oracle panama spatial region directory Table 10 22 Parameters of the routers xml File 10 23 Strip properties The Strip properties file notifies the stripper adapter of proxy settings and strip levels This properties file also defines classes which provide the stripper adapter Key Description ProviderName Provider name Prov...

Page 133: ...1 Translation table for translating target entities String Does not recurse e g amp target will not work oracle panama adapter stripper Strip1 useTranslationTable true oracle panama adapter stripper Strip1 targets auml Auml aring Aring ouml Ouml amp Amp nbsp euml Euml 150 oracle panama adapter stripper Strip1 targets auml ä oracle panama adapter stripper Strip1 targets Auml Ä Key Type Editable Des...

Page 134: ...es but each instance s information is stored in a separate property file This file is in the WE_HOME server classes oracle panama config directory Table 10 25 Parameters of the MAgent properties File 10 25 MInstances properties Every database instance needs an instance name property file name entry added to the MInstances properties This file is in the WE_HOME server classes oracle panama config d...

Page 135: ...duration of the login session This file is in the WE_HOME server classes oracle panama core admin directory Table 10 26 Parameters of the Cookies properties File Key Type Editable Description cookie use userinfo Boolean Y When true this parameter instructs the system to use cookies when talking to clients that have cookie support The default is true cookie userinfo maxage Integer Y Duration of a s...

Page 136: ...Cookies properties 10 32 Oracle9i Application Server Wireless Edition Configuration Guide ...

Page 137: ...lity 8 7 D data gatherer cartridge installation 6 5 Database Logger configuring 4 2 database sessions specifying minimum 10 6 database table contents 4 3 debug flag setting 4 6 10 20 deployment scenarios multiple JVM 5 2 device recognition class 10 9 Directory application application parameters 2 7 configuring 2 4 servers 2 4 download utility 8 5 E e mail application configuring parameters through...

Page 138: ...ing schemes 7 2 multiple JVM configuring instances 5 3 deployment scenarios 5 2 support 5 1 N notification properties 10 15 queue 3 3 O objects refreshing attributes 4 6 10 20 shutting down 4 6 10 20 oemevent properties 10 17 Oracle Enterprise Manager 6 1 configuration management 6 2 configuring 6 3 fault management 6 2 launching tools 6 14 performance monitoring 6 2 prerequisites 6 2 Oracle HTTP ...

Page 139: ...ies 10 16 server 10 16 routers xml 10 28 Runtime Monitor 4 6 S sample batch file Oracle HTTP Server 5 12 samples adapters 1 8 services 1 8 server logging 4 5 Service Designer 1 10 2 13 logging 4 5 SMPP protocol 3 4 SMS alert 3 3 protocol 3 4 Request Listener 3 5 spatial properties 10 19 strip properties 10 28 10 29 system password 8 2 System properties 10 4 10 9 T thread pool size notification que...

Page 140: ...Index 4 provisioning adapter 1 12 upgrading 1 7 www server properties 10 20 X XML 8 1 Xslt utility 8 6 ...