1
Overview

This document describes the post-installation configuration of Wireless Edition.

Each section of this document presents a different topic. These sections include:

• Section 1.1, "Installation Overview"
• Section 1.2, "Manual Configuration"
• Section 1.3, "Upgrade"
• Section 1.4, "Samples"
• Section 1.5, "Web Integration Server"
• Section 1.6, "Wireless Edition Client"
• Section 1.7, "OCI8 JDBC Driver"
• Section 1.8, "User Provisioning"
• Section 1.9, "Geocoding Setup"
• Section 1.10, "JDBC Connection Pooling"

Important: In this document: WE_HOME is the directory in which Wireless Edition is installed followed by the "panama" sub-directory. For example: c:\ias10210\panama (Windows) /private/ias10210/panama (UNIX) Replace "WE_HOME" with the fully-qualified directory path. ORACLE_HOME is the directory in which Oracle9i Application Server is installed.

1.1 Installation Overview

The Oracle9i Application Server installation includes three options:

• Oracle HTTP Server
• Standard Edition
• Enterprise Edition

Wireless Edition is installed as part of each of these options. The Oracle9i Application Server Installation Guide discusses each option, and discusses the installation steps specific to Wireless Edition. The Installation Guide defines Wireless Edition and Oracle HTTP Server hardware and software requirements, preinstallation tasks (setting environment variables), port numbers, starting and stopping the Oracle HTTP Server, and the Wireless Edition client configuration.

For a new installation of Wireless Edition, follow the steps in this document starting with the manual configuration in Section 1.2. If you have a previous release of Wireless Edition installed see Section 1.3.

Important: Wireless Edition is not properly configured until the manual configuration steps are completed in Section 1.2.

1.2 Manual Configuration

After installation, perform the manual configuration steps described in this section:

• Section 1.2.1, "Configure Oracle HTTP Server and JServ"
• Section 1.2.2, "Configure ProxyFirewall.properties"
• Section 1.2.3, "Start the Oracle HTTP Server"
• Section 1.2.4, "Wireless Edition Configuration Verification"

 

1.2.1 Configure Oracle HTTP Server and JServ

This section describes the configuration of the Oracle HTTP Server and JServ.

1. Configure the httpd.conf file. The httpd.conf file is in the ORACLE_HOME/Apache/Apache/conf directory.

 
1. Create an alias for this release of the Personalization Portal. This is needed so that the application server can find the http://hostname/portal/Login.jsp URL. Include the following in the Alias section:

Alias /portal/ "WE_HOME/server/portal/"

2. To access a previous release of the Personalization Portal, in addition to this release, create an alias. This allows the application server to find the http://hostname/papz/login.jsp URL. Include the following in the Alias section:

Alias /papz/ "WE_HOME/server/papz/"

3. Create an alias for the Javadoc directory. Include the following in the Alias section. This step is optional.

Alias /ptgdoc/ "WE_HOME/doc/javadoc/" 

2. Configure the jserv.conf file. The jserv.conf file is in the ORACLE_HOME/Apache/Jserv/etc directory. In the ApJServMount section, add the Wireless Edition specific mount point:

ApJServMount /ptg /root

3. Configure the jserv.properties file. The jserv.properties file is in the ORACLE_HOME/Apache/Jserv/etc directory.
1. Verify that the Java Virtual Machine is version 1.2.2. For example:

wrapper.bin= <ORACLE_HOME>/Apache/jdk/bin/java.exe

2. After the other "wrapper.classpath" entries, add all the required Wireless Edition files after the "tools.jar" entry in the classpath.




For Windows (for UNIX replace "\" with "/"):

wrapper.classpath=<WE_HOME>\server\classes 
wrapper.classpath=<WE_HOME>\lib\panama.zip
wrapper.classpath=<WE_HOME>\lib\panama_core.zip 
wrapper.classpath=<WE_HOME>\lib\panama_portal.zip 
wrapper.classpath=<WE_HOME>\lib\panama_papz.zip 
wrapper.classpath=<WE_HOME>\lib\client.zip 
wrapper.classpath=<WE_HOME>\lib\server.zip 
wrapper.classpath=<WE_HOME>\lib\caboshare-opt.zip 
wrapper.classpath=<WE_HOME>\lib\marlin-opt.zip 
wrapper.classpath=<WE_HOME>\lib\ocelot-opt.zip 
wrapper.classpath=<WE_HOME>\lib\share-opt-1_1_7.zip 
wrapper.classpath=<WE_HOME>\lib\tecate-opt.zip 
wrapper.classpath=<WE_HOME>\lib\regexp.jar 
wrapper.classpath=<WE_HOME>\lib\sax2.jar 
wrapper.classpath=<WE_HOME>\lib\activation.jar 
wrapper.classpath=<WE_HOME>\lib\mail.jar 
wrapper.classpath=<WE_HOME>\lib\ldap.jar 
wrapper.classpath=<WE_HOME>\lib\ldapbp.jar 
wrapper.classpath=<WE_HOME>\lib\providerutil.jar 
wrapper.classpath=<WE_HOME>\lib\sdoapi101.jar 
wrapper.classpath=<WE_HOME>\lib\sdovis.jar 
wrapper.classpath=<WE_HOME>\lib\MapQuestX.jar 
wrapper.classpath=<WE_HOME>\lib\MQJavaCore.jar 
wrapper.classpath=<WE_HOME>\lib\RoutingJServerClient.jar 
wrapper.classpath=<WE_HOME>\lib\jai_codec.jar 
wrapper.classpath=<WE_HOME>\lib\jai_core.jar 
wrapper.classpath=<WE_HOME>\lib\jpeg_codec.jar 
wrapper.classpath=<WE_HOME>\lib\ordimimg.jar 

Note: Perform the following step before the Oracle HTTP Server is started. The Personalization Portal requires this step for generating the correct image.

4. 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:

 
1. 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 example) run the following command:

xhost + <x_server_host_name>

2. If the X server runs on a different machine (x_server_host_name in the following example) than the Wireless Edition server, set the DISPLAY environment variable in the jserv.properties 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>

 

Note: For both cases, remain logged into the Console while the xhost commands are executed. Otherwise, properties set through the xhost command may be lost and images may not be displayed properly in the Personalization Portal.

5. Configure the zone.properties file. The zone.properties file is in the ORACLE_HOME/Apache/Jserv/etc directory.

 
1. In the List of Repositories section, add the Wireless Edition specific repository to the existing repository line with a comma (,) separator:



For Windows:

repositories=<ORACLE_HOME>\Apache\Jserv\servlets,<WE_
HOME>\serverportal,<WE_HOME>\server\papz

For UNIX:

repositories=<ORACLE_HOME>/Apache/Jserv/servlets,<WE_
HOME>/server/portal,<WE_HOME>/server/papz

2. In the Startup Servlets section, add the Wireless Edition specific servlets:

servlets.startup=oracle.panama.ParmImpl

3. 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:
 

1. Set http.use.proxy to true. For example:

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

Note: For a list of property files provided by Wireless Edition, see Chapter 10.

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 installation, you can verify that individual Wireless Edition components are properly configured using a desktop browser:
 

1. Test whether the Personalization Portal is working properly by accessing the following URL:

http://host_name.domain:7777/portal/Login.jsp

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.
 
2. Run the Wireless Edition Request Manager by accessing the following URL:

http://host_name.domain:7777/ptg/rm

The login page should appear. The page prompts you to enter a user name and a password.


Important: You can log in using "Administrator" as the user name and "manager" as the password. These are the default settings.

1.3 Upgrade

To upgrade a previous release of Wireless Edition (Portal-to-Go) including release 1.0.2.1.0, 1.0.2.2.0, or 1.0.2.3.0 perform the 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.

 

Important: The Wireless Edition installation in the following step upgrades the database schema and migrates the existing data.

4. Run the Oracle9i Application Server installation.
5. Follow the manual configuration steps in Section 1.2.
6. Restart the Oracle HTTP Server. See the Oracle9i Application Server Installation Guide for instructions.

 

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.
 

1. Change to the sample directory:

WE_HOME\sample (Windows NT)
WE_HOME/sample (UNIX)

2. 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. For example:

-l Administrator/manager

3. Run the following:

upload.bat samples.xml (Windows NT)
upload.sh samples.xml (UNIX)

4. Add the following entry in the jserv.properties file. This must be added before the Oracle HTTP Server is started.

wrapper.classpath=WE_HOME\sample (Windows NT)
wrapper.classpath=WE_HOME/sample (UNIX)

Note: All the sample Java source and class files are stored in the "sample" directory. Include the sample directory entry in the jserv.properties file so that JServ can locate the sample class files.

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.


Note: Directory Service in the samples directory does not run unless the Oracle Internet Directory is installed. Contact content providers before running any sample service in the YP and Router directories.

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:
 

1. Run the Web Integration Server. From the WE_HOME/panama/WebIntegration/Server/bin directory, typing the following:

 
1. For Windows:

server.bat

2. For UNIX

server.sh &

The Web Integration Server can also be run as a service on Windows.
 
 

2. From 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.

 

Note: Please make sure the max heap size has been specified for the Web Integration Server. To increase the max heap size in the Web Integration Server startup script, add the -mx option.

The Web Integration Developer, the development environment for creating and testing Web Integration services written in Web Interface Definition Language (WIDL), is installed as part of the Wireless Edition client. For more information, see Section 1.6.


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. It creates and modifies Wireless Edition objects, including adapters, transformers, and services. The Service Designer provides a tree view of the Wireless Edition repository. This tree displays Wireless Edition objects classes, such as adapters and transformers, as folders or branch nodes. It shows instances of those classes as objects or leaf nodes.


The Service 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 includes tools for publishing WIDL services for the Web Integration Server.


The Web Integration Developer is installed during the Wireless Edition client installation. For installation instructions, see the Oracle 9i Application Server Installation Guide.


Note: The Web Integration Developer includes its own Java Virtual Machine (JVM). It does not require any Java setup.

To configure the Web Integration Developer:
 

1. Run the Web Integration Developer from the Windows Programs menu. Select Programs, Oracle for Windows, Wireless Edition, and Web Integration Developer.
2. From the Edit menu, select Preferences, and then Configuration.
3. Enter the Proxy (HTTP) and the Secure Proxy (HTTPS) settings appropriate for your environment.
4. 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. Additionally, this driver is required if the Oracle Parallel Server option is used.


To configure Wireless Edition to use the Oracle OCI8 driver:
 

1. Verify that ORACLE_HOME is the directory under which Wireless Edition has been installed.
1. 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

2. On UNIX: Verify that the LD_LIBRARY_PATH environment variable includes the directory where the OCI libraries (libocijdbc8.so and libocijdbc8_g.so) are installed. The default is ORACLE_HOME/lib.

 

 

2. Modify the System.properties file to change the driver and the connect string settings.

db.connect.string=%WE_REPOSITORY_USERNAME%/%WE_REPOSITORY_USER_
PW%@(description=(address=(host=%WE_REPOSITORY_
HOST%)(protocol=tcp)(port=%WE_REPOSITORY_PORT%))(connect_data=(sid=%WE_
REPOSITORY_SID%)))
db.driver=V8

1.8 User Provisioning

You can integrate your repository with an existing provisioning system using one of the following:
 

1. 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.
2. Use the LoadXml utility to import users from a flat XML file that conforms to the Repository DTD. This utility enables you to create and update user information. For more information on the LoadXML utility, see Section 8.2.
3. Use the Wireless Edition data model API to programmatically create users. A model example is provided in the WE_HOME\sample\model directory. Also, see the Javadoc and 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 site (including the MapInfo provider) from Wireless Edition, configure the ProxyFirewall.properties file:
 

1. Set http.use.proxy to true. For example:

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.10 JDBC Connection Pooling

Pooling for JDBC connections improves resource utilization and avoids connection establishment overhead. A set of configurable parameters for this connection pool is provided in the System.properties file. For more information see Section 10.2.


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 
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.interval=1

Note: To control the maximum idle time for any database connection, configure it through the Oracle data server.