F
Postinstallation Tasks for Oracle9iAS Wireless

This appendix describes postinstallation configuration tasks for Oracle9iAS Wireless:

• Oracle9iAS Wireless Web Integration Server Configuration

• Oracle9iAS Wireless Configuration

• Oracle9iAS Wireless Configuration Verification

Oracle9iAS Wireless Web Integration Server Configuration

Oracle9iAS Wireless Web Integration Server provides services for applications to use to exchange data and information sources. The Web Integration Server is installed when you install Oracle9iAS Wireless.

Note: The Web Integration Developer is the development environment for creating and testing Web Integration services written in Web Interface Definition Language (WIDL). The Web Integration Developer is installed as part of the Oracle9iAS Wireless client.

See Also: See Appendix B, "Installing Oracle9i Application Server Administrative and Development Client CD-ROM" for information on installing Oracle9iAS Wireless client.

Configuring WebIntegration Server on HP 9000 Series HP-UX, AIX and Linux Intel

The following steps guide you through the configuration process of the Web Integration Server on HP 9000 Series HP-UX and Linux Intel:

1. Run the Web Integration Server.

   From the $ORACLE_HOME/panama/WebIntergration/Server/bin directory, enter:

   prompt> server.sh &
   
   

2. From a browser, go to the Web Integration Server URL:

   http://host_name.domain:5555

3. Log in to the Web Integration Server using the user name Administrator, and password manage (the default password).

4. Click Settings. When 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.

Configuration of WebIntegration Server on Compaq Tru64

Web Integration Server is not supported on Compaq Tru64 Unix. However, the Web Integration Server for Windows NT is supplied with this release on this platform. The following steps guide you through the configuration process of the Web Integration Server on Windows NT:

1. After the Oracle9iAS installation is over, use the ftp command to transfer the $ORACLE_HOME/panama/WebIntegration/Server/wis.zip file from the Compaq Tru64 machine (iAS installation machine) to the Windows NT server. Refer to the appropriate operating system documentation for your system for information on using the ftp command.

2. On the Windows NT server, extract the wis.zip file into a temporary directory.

3. Run setup.exe from the temporary directory and follow the installation instructions on screen.

4. Run the Web Integration Server.

   From the ORACLE_HOME\panama\WebIntergration\Server\bin directory, enter:

   prompt> server.bat 
   
   

5. From a browser, go to the Web Integration Server URL:

   http:// windows_nt_host_name:5555 
   
   

6. Log in to the Web Integration Server with the user name Administrator, and password manage (the default password).

7. Select Settings. The server settings appear. Click Edit.

8. Enter the Proxy (HTTP) and Secure Proxy (HTTPS) settings for your environment.

9. Click Submit.

10. Click Logout.

Oracle9iAS Wireless Configuration

This section describes how to configure Oracle9iAS Wireless on HP 9000 Series HP-UX and Linux Intel:

1. Configure the httpd.conf file to create a Personalization Portal (papz) alias.

   The httpd.conf file is located in the $ORACLE_HOME/Apache/Apache/conf directory.

   Add the following lines at the end of the Alias section of the httpd.conf file:

   # PTG Start
   Alias /papz/ "ORACLE_HOME/panama/server/papz/"
   Alias /portal/ "ORACLE_HOME/panama/server/portal/" 
   Alias /cabo/ "ORACLE_HOME/panama/server/portal/cabo/" 
   # PTG End
   
   

   The papz alias is required for Oracle9iAS Application Server to find the following URL:

   http://hostname/papz/login.jsp.

2. Configure the jserv.conf file.

   The jserv.conf file is located in the $ORACLE_HOME/Apache/Jserv/etc directory.

   In the ApJServMount section, add the Oracle9iAS Wireless specific mount point in the following format:

   # PTG Start
   ApJServGroupMount /ptg balance://group1/root
   # PTG End
   
   

   where:

   • mountpoint is the name of the URI path you want to mount jserv-url on.

   • groupname is one of the groups defined in the ApJServGroup directive.

   • zone is the zone associated with this servlet.

3. Configure the jserv.properties file.

   The jserv.properties file is located in the $ORACLE_HOME/Apache/Jserv/etc directory.

   1. Check that the Java virtual machine referenced by $ORACLE_HOME/Apache/jdk is JVM version 1.2.2.

   2. Add all the required Oracle9iAS Wireless files to the classpath next to the other wrapper.classpath entries as shown in the following example:

      # PTG Start
      wrapper.classpath=ORACLE_HOME/panama/server/classes
      wrapper.classpath=ORACLE_HOME/panama/lib/panama.zip 
      wrapper.classpath=ORACLE_HOME/panama/lib/panama_core.zip
      wrapper.classpath=ORACLE_HOME/panama/lib/panama_portal.zip 
      wrapper.classpath=ORACLE_HOME/panama/lib/panama_papz.zip
      wrapper.classpath=ORACLE_HOME/panama/lib/client.zip
      wrapper.classpath=ORACLE_HOME/panama/lib/server.zip
      wrapper.classpath=ORACLE_HOME/panama/lib/caboshare-opt.zip 
      wrapper.classpath=ORACLE_HOME/panama/lib/marlin-opt.zip 
      wrapper.classpath=ORACLE_HOME/panama/lib/ocelot-opt.zip 
      wrapper.classpath=ORACLE_HOME/panama/lib/share-opt-1_1_7.zip 
      wrapper.classpath=ORACLE_HOME/panama/lib/tecate-opt.zip 
      wrapper.classpath=ORACLE_HOME/panama/lib/regexp.jar 
      wrapper.classpath=ORACLE_HOME/panama/lib/sax2.jar 
      wrapper.classpath=ORACLE_HOME/panama/lib/activation.jar 
      wrapper.classpath=ORACLE_HOME/panama/lib/mail.jar 
      wrapper.classpath=ORACLE_HOME/panama/lib/ldap.jar 
      wrapper.classpath=ORACLE_HOME/panama/lib/ldapbp.jar 
      wrapper.classpath=ORACLE_HOME/panama/lib/providerutil.jar 
      wrapper.classpath=ORACLE_HOME/panama/lib/sdoapi101.jar 
      wrapper.classpath=ORACLE_HOME/panama/lib/sdovis.jar 
      wrapper.classpath=ORACLE_HOME/panama/lib/RoutingJServerClient.jar 
      
      wrapper.classpath=ORACLE_HOME/panama/lib/jai_codec.jar 
      wrapper.classpath=ORACLE_HOME/panama/lib/jai_core.jar 
      wrapper.classpath=ORACLE_HOME/panama/lib/jpeg_codec.jar 
      wrapper.classpath=ORACLE_HOME/panama/lib/ordimimg.jar 
      # PTG End
      
      

   3. If the PTG Server is running on a UNIX machine, modify the DISPLAY environment variable, as follows, and run the command xhost +:
      • If the X server and PTG server are running on the same machine, make the following modification:

        # PTG Start 
         wrapper.env=DISPLAY=:0.0 
        # PTG End 
        
        

      • If the X server and PTG server are running on the different machines, make the following modification where the host_name is the machine running the X server.:

        # PTG Start 
        wrapper.env=DISPLAY=ORACLE_HOME:0.0 
        # PTG End 
        
        

4. Configure the zone.properties file.

   The zone.properties file is located in the $ORACLE_HOME/Apache/Jserv/etc directory.

   Perform the following steps:

   1. In the List of Repositories section, add the Oracle9iAS Wireless specific repository to the existing repository line using a comma (,) separator. For example:

      # PTG Start
      repositories=ORACLE_HOME/Apache/Jserv/servlets,ORACLE_HOME/panama/
      server/portal,ORACLE_HOME/panama/server/papz 
      # PTG End
      
      

   2. In the Startup Servlets section, add the Oracle9iAS Wireless specific servlets. For example:

      # PTG Start
      servlets.startup=oracle.panama.ParmImpl
      # PTG End
      
      

   3. In the Servlet Aliases section, add the Oracle9iAS Wireless specific servlets:

      # PTG Start
      servlet.rm.code=oracle.panama.ParmImpl
      # PTG End
      

Oracle9iAS Wireless Configuration Verification

To verify that individual Oracle9iAS Wireless components are properly configured:

1. Test the sample Java Servlet at the following URL:

   http://host_name.domain:listener_port/papz/test.jsp

   The text "Hello World" should appear on the screen.

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

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

   The login page should appear. The Personalization Portal prompts you to enter a user name and a password. Log in using Administrator as the user name and manager as the password.

3. Run the Oracle9iAS Wireless Request Manager by accessing the following URL:

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