b12246 | Oracle Database | Port (Computer Networking)

Oracle® Application Server 10g

Forms and Reports Services Installation Guide 10g (9.0.4) for Solaris Operating Environment
Part No. B12246-01

December 2003

Oracle Application Server 10g Forms and Reports Services Installation Guide, 10g (9.0.4) for Solaris Operating Environment Part No. B12246-01 Copyright © 2003 Oracle. All rights reserved. Primary Author: Anjana Suparna Sriram The Programs (which include both the software and documentation) contain proprietary information; they are provided under a license agreement containing restrictions on use and disclosure and are also protected by copyright, patent, and other intellectual and industrial property laws. Reverse engineering, disassembly, or decompilation of the Programs, except to the extent required to obtain interoperability with other independently created software or as specified by law, is prohibited. The information contained in this document is subject to change without notice. If you find any problems in the documentation, please report them to us in writing. This document is not warranted to be error-free. Except as may be expressly permitted in your license agreement for these Programs, no part of these Programs may be reproduced or transmitted in any form or by any means, electronic or mechanical, for any purpose. If the Programs are delivered to the United States Government or anyone licensing or using the Programs on behalf of the United States Government, the following notice is applicable: U.S. GOVERNMENT RIGHTS Programs, software, databases, and related documentation and technical data delivered to U.S. Government customers are "commercial computer software" or "commercial technical data" pursuant to the applicable Federal Acquisition Regulation and agency-specific supplemental regulations. As such, use, duplication, disclosure, modification, and adaptation of the Programs, including documentation and technical data, shall be subject to the licensing restrictions set forth in the applicable Oracle license agreement, and, to the extent applicable, the additional rights set forth in FAR 52.227-19, Commercial Computer Software--Restricted Rights (June 1987). Oracle Corporation, 500 Oracle Parkway, Redwood City, CA 94065 The Programs are not intended for use in any nuclear, aviation, mass transit, medical, or other inherently dangerous applications. It shall be the licensee's responsibility to take all appropriate fail-safe, backup, redundancy and other measures to ensure the safe use of such applications if the Programs are used for such purposes, and we disclaim liability for any damages caused by such use of the Programs. Oracle is a registered trademark of Oracle Corporation and/or its affiliates. Other names may be trademarks of their respective owners. The Programs may provide links to Web sites and access to content, products, and services from third parties. Oracle is not responsible for the availability of, or any content provided on, third-party Web sites. You bear all risks associated with the use of such content. If you choose to purchase any products or services from a third party, the relationship is directly between you and the third party. Oracle is not responsible for: (a) the quality of third-party products or services; or (b) fulfilling any of the terms of the agreement with the third party, including delivery of products or services and warranty obligations related to purchased products or services. Oracle is not responsible for any loss or damage of any sort that you may incur from dealing with any third party.

Contents
Send Us Your Comments ................................................................................................................... v Preface........................................................................................................................................................... vii
Intended Audience ............................................................................................................................... vii Documentation Accessibility .............................................................................................................. vii Structure of This Guide........................................................................................................................ viii Related Documents................................................................................................................................ ix Conventions............................................................................................................................................ ix

1

Introduction to Oracle Application Server 10g Forms and Reports Services
1.1 1.2 1.2.1 1.2.2 1.2.3 1.2.4 1.2.5 1.2.6 1.2.7 1.2.8 Restrictions with This Installation Type ............................................................................ Available Features with This Installation Type ................................................................ OracleAS Forms Services .............................................................................................. Oracle Application Server Reports Services............................................................... Oracle HTTP Server ....................................................................................................... Oracle Application Server Web Cache........................................................................ Oracle Containers for Java (OC4J) ............................................................................... Oracle Enterprise Manager ........................................................................................... Oracle Process and Management Notification (OPMN) .......................................... Distributed Configuration Management (DCM)....................................................... 1-1 1-1 1-2 1-2 1-2 1-2 1-3 1-3 1-4 1-4

iii

2 3

Installation Overview What’s New in the Installation
3.1 Custom Port Numbers .......................................................................................................... 3.1.1 Ports.................................................................................................................................. 3.1.2 Using Default Port Numbers ........................................................................................ 3.1.3 Using Custom Port Numbers (the "Static Ports" Feature) ........................................ 3.1.3.1 Ports for Oracle HTTP Server and OracleAS Web Cache ................................. 3.1.3.2 Examples .................................................................................................................. 3.1.3.3 Notes on Using staticports.ini ............................................................................... 3.1.4 Default Port Numbers ................................................................................................... 3.2 Configuration Assistant Enhancements........................................................................... 2-1 2-1 2-2 2-2 2-4 2-6 2-7 2-8 2-11

4

Compatibility with Earlier Versions
4.1 Compatibility with Release 2 (9.0.2), Release 2 (9.0.3) and Release 10g (9.0.4)............. 3-1

5

Requirements
5.1 5.1.1 5.2 5.3 5.4 5.5 5.5.1 System Requirements............................................................................................................ Tips for Reducing Memory Usage ............................................................................... Operating System Patches.................................................................................................... Operating System Packages ................................................................................................. Operating System User ......................................................................................................... Environment Variables ......................................................................................................... DISPLAY Environment Variable ................................................................................. 4-1 4-4 4-4 4-6 4-7 4-9 4-9

6

Post-Installation Tasks
6.1 6.2 6.3 Testing your Forms and Reports Services Installation .................................................... 5-1 NLS_LANG Environment Variable .................................................................................... 5-1 Deployment of Forms and Reports Application............................................................... 5-2

Index

iv

v . please give your name. telephone number. CA 94065 USA If you would like a reply. 10g (9. and page number (if available). and electronic mail address (optional). 2op12 Redwood Shores. please indicate the title and part number of the documentation and the chapter. If you have problems with the software. address. You can send comments to us in the following ways: ■ ■ Electronic mail: formsdoc_us@oracle. please contact your local Oracle Support Services.com Postal service: Oracle Corporation Oracle Forms Documentation 200 Oracle Parkway. 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.0. section. B12246-01 Oracle Corporation welcomes your comments and suggestions on the quality and usefulness of this publication. where? Are the examples correct? Do you need more examples? What features did you like most about this manual? If you find any errors or have any other suggestions for improvement.4) for Solaris Operating Environment Part No.Send Us Your Comments Oracle Application Server 10g Forms and Reports Services Installation Guide.

vi .

and contains markup to facilitate access by the disabled community.com/accessibility/ vii . compatibility with other products. Intended Audience This guide is intended for users who are comfortable performing some system administration operations. requirements.Preface This installation guide covers requirements. visit the Oracle Accessibility Program Web site at: http://www. and installing operating system patches on the computer where Oracle Application Server 10g Forms and Reports Services is going to be installed. Users who are installing Oracle Application Server 10g Forms and Reports Services need root access to run some scripts. and supporting documentation accessible. This documentation is available in HTML format. with good usability. and Oracle is actively engaged with other market-leading technology vendors to address technical obstacles so that our documentation can be accessible to all of our customers. to the disabled community.oracle. our documentation includes features that make information available to users of assistive technology. and post-installation tasks. such as creating users and groups. To that end. Standards will continue to evolve over time. adding users to groups. services. concepts that affect installation. Documentation Accessibility Our goal is to make Oracle products. new features in the installer. For additional information.

JAWS may not always read a line of text that consists solely of a bracket or brace. Oracle neither evaluates nor makes any representations regarding the accessibility of these Web sites. Chapter 5. "Post-Installation Tasks" This chapter describes the post-installation tasks you need to perform to ensure complete installation of Oracle Application Server 10g Forms and Reports Services. however. "Compatibility with Earlier Versions" This chapter describes possible side-effects when you install and run Oracle Application Server 10g Forms and Reports Services on a computer that is already running other products. may not always correctly read the code examples in this document. Chapter 3. "Installation Overview" This chapter provides an overview of the installation steps. "Introduction to Oracle Application Server 10g Forms and Reports Services" This chapter introduces you to Oracle Application Server 10g Forms and Reports Services and provides an overview of the components. "Requirements" This chapter lists the requirements for installing and running Oracle Application Server 10g Forms and Reports Services. Chapter 6. a Windows screen reader. viii . Accessibility of Links to External Web Sites in Documentation This documentation may contain links to Web sites of other companies or organizations that Oracle does not own or control. The conventions for writing code require that closing braces should appear on an otherwise empty line. Chapter 4. Chapter 2.Accessibility of Code Examples in Documentation JAWS. "What’s New in the Installation" This chapter describes new features in Oracle Application Server 10g Forms and Reports Services that affect the installation procedure. Structure of This Guide This guide contains the following chapters and appendixes: Chapter 1.

see the following guides: ■ ■ ■ ■ Oracle Application Server 10g Forms and Reports Services Release Notes Oracle Application Server Reports Services Publishing Reports to the Web Oracle Reports Building Reports Getting Started with Oracle Reports. commands.4) for Windows and UNIX ■ ■ Conventions This guide uses the following conventions: Convention boldface text code italicized code [] . Meaning Boldface type in text indicates objects (such as buttons and fields) on screens. Text in the code font indicates filenames..com/products/reports/) Oracle Forms Migrating Forms Applications from Forms 6i Oracle Application Server Forms Services Deployment Guide 10g (9. Italicized code indicates placeholder text that you need to replace with an appropriate value. Brackets enclose optional clauses from which you can choose one or none.. or contents of configuration files.Related Documents For more information. ix .0. Ellipses indicate that extraneous information have been omitted.oracle. available on the Oracle Technology Network (http://otn.

x .

In phase one. 1.2 Available Features with This Installation Type When you install Oracle Application Server Forms and Reports Services. Infrastructure services are available with the Business Intelligence and Forms Installation type. This type of installation is suited best for users who want to upgrade Forms applications to the Grid environment in two phases. Furthermore. In phase two. you’ll have access to these features: Introduction to Oracle Application Server 10g Forms and Reports Services 1-1 .1 Introduction to Oracle Application Server 10g Forms and Reports Services Oracle Application Server Forms and Reports Services allows you to install and configure Forms and Reports Services without the need to install and configure all of Oracle Application Server 10g. and move your applications to this new installation. you’ll need to install an instance of Oracle Application Server with Business Intelligence and Forms. However. 1. such as Single Sign-On or Identity Management integration. it is not possible to associate or link this installation with an Infrastructure at a later point in time. they move to the Grid environment by upgrading their client server based Forms applications to Web-based ones. If you wish to take advantage of Infrastructure features.1 Restrictions with This Installation Type Oracle Application Server Forms and Reports Services provides no Infrastructure service. users can then choose to use the services offered by an existing Oracle Application Server Infrastructure installation.

1 OracleAS Forms Services Oracle Application Server Forms Services deploys Forms applications with database access to Java clients in a Web environment. and manageable solution for high-quality database publishing and reporting by creating dynamic reports for the Web and across the enterprise.Available Features with This Installation Type ■ ■ ■ ■ ■ ■ ■ ■ OracleAS Forms Services Oracle Application Server Reports Services Oracle HTTP Server Oracle Application Server Web Cache Oracle Containers for Java (OC4J) Oracle Enterprise Manager Oracle Process and Management Notification (OPMN) Distributed Configuration Management (DCM) 1. By storing frequently accessed URLs in virtual memory. scalable. 1.3 Oracle HTTP Server Oracle HTTP Server is the Web server that Oracle Application Server uses. It also supports Java servlets.2. and availability of frequently used e-business Web sites that run on the Oracle platform. and interactions with Oracle database. and extensibility. It enables you to implement a multitiered architecture for running your reports.2. and CGI applications. speed.2. PL/SQL.4 Oracle Application Server Web Cache Oracle Application Server Web Cache is a server accelerator caching service that improves the performance. stability. 1. which is built on Apache Web server technology. Java Server Pages (JSPs). 1. scalability.2 Oracle Application Server Reports Services Oracle Application Server Reports Services provides an easy-to-use.2. Perl. Oracle Application Server Forms Services automatically optimizes class downloads. can easily scale to service any number of requests. network traffic. Oracle HTTP Server offers scalability. Applications are automatically load-balanced across multiple servers and. therefore. Oracle Application Server Web Cache eliminates the need 1-2 Oracle Application Server 10g Forms and Reports Services Installation Guide .

From these pages you can drill down for more detailed information on administration. These pages allow you to administer the application server and its components and deployed applications.6 Oracle Enterprise Manager Oracle Enterprise Manager Application Server Control (from here on Application Server Control) provides you with the management tools you need to monitor and administer Oracle Application Server instances. 1. For example. gather and process performance data.Available Features with This Installation Type to repeatedly process requests for those URLs on the Web server. Introduction to Oracle Application Server 10g Forms and Reports Services 1-3 .2. you can monitor and configure components of your application server. Application Server Control provides Web-based management tools designed specifically for Oracle Application Server. they discover the components of each application server instance. You can deploy applications. and provide access to application configuration information. and create and manage Oracle Application Server clusters. Application Server Control consists of the following: ■ The Enterprise Manager Home pages you use to manage Oracle Application Server and its components: These Web pages provide you with a high-level view of your Oracle Application Server environment. ■ Application Server Control is installed as part of the Oracle Application Server installation process. 1. manage security. and performance monitoring. Application Server Control is installed with every instance of Oracle Application Server.2. configuration.5 Oracle Containers for Java (OC4J) Oracle Application Server Containers for Java is a complete set of J2EE containers written entirely in Java that execute on the Java Virtual Machine (JVM) of the standard Java Development Kit (JDK). The underlying software technologies that keep track of your application server instances and components: These technologies automatically perform many management tasks. and it caches both static and dynamically-generated HTTP content from one or more applications Web servers. Using Application Server Control.

Available Features with This Installation Type 1. 1-4 Oracle Application Server 10g Forms and Reports Services Installation Guide . and distributes the status information to components that are interested in it. It enables Oracle Application Server cluster-wide deployment so you can deploy an application to one instance and have it automatically propagated to the entire cluster.2. The Application Server Control uses OPMN for such tasks as starting and stopping the components of your application server instance. Application Server Control uses DCM to make configuration changes and to propagate configuration changes and deployed applications across the cluster. 1.7 Oracle Process and Management Notification (OPMN) Oracle Process Manager and Notification Server (OPMN): OPMN provides process control and monitoring for application server instances and their components.8 Distributed Configuration Management (DCM) Distributed Configuration Management (DCM): DCM manages configurations among application server instances that are associated with a common Metadata Repository. You can also make a single host or instance configuration change to one instance and have it propagated across all instances in the cluster.2. It gathers component status information.

Start the Oracle Universal installer (OUI). do not create it as the root user. To install Oracle Application Server 10g Forms and Reports Services.2 Installation Overview Oracle Application Server 10g Forms and Reports Services is an Oracle Application Server 10g installation option. It is highly recommended that you read this guide in its entirety to ensure a successful installation and optimize the capabilities of this release. On the Specify File Locations screen. The name cannot contain spaces and has a maximum length of 16 characters. Example: /opt/oracle/frstand_904 5. Example: OH_FRSA_904 ■ Destination Path: Enter the full path to the destination directory. Click Next. If you want to create the directory beforehand. 4. On the Welcome screen. This is the Oracle home. If the directory does not exist. enter the following information: ■ Name: Enter a name to identify this Oracle home. the installer creates it. create it as the oracle user. The Welcome screen appears. Installation Overview 2-1 . follow these steps: 1. Read the latest version of the following Release Notes for the most current information: ■ ■ Oracle Forms Developer Release Notes Oracle Reports Developer Release Notes 2. 3. click Next.

This is the administrative user for the instance. the instance names must be unique. ias_admin Password and Confirm Password: Set the password for the ias_ admin user. 10. Note: At any time during the installation. 2-2 Oracle Application Server 10g Forms and Reports Services Installation Guide . By default. Click Next. The Provide Outgoing Mail Server Information screen appears. Click Install to complete the installation. select them from the available languages list. 9.6. Click Next. The Language Selection screen appears. ■ 7. Instance Name: Enter a name for this instance. Enter the outgoing mail (SMTP) server used by Oracle Application Server Reports Services. If you need to install additional languages. the Installer installs Oracle Application Server 10g Forms and Reports Services with text in English and in the operating system language. The Specify Instance Name and ias_admin Password screen appears. be installed. This window lists all the components that will 11. ■ 8. Click Next. The Summary screen shows the progress of the installation. If you have more than one Oracle Application Server 10g Forms and Reports Services instance on a computer. The Summary screen appears. click Cancel to exit. Instance names contain alphanumeric and underscore characters only.

1 Ports Many Oracle Application Server 10g Forms and Reports Services components.3.1 Custom Port Numbers In Oracle Application Server 10g Forms and Reports Services 10g. you set up a file with component names and desired port numbers.1.2. See Section 3.1. The information in the following sections provide more information on the usage and customizing of ports.1. This feature is called "static ports".2. use ports. You can have OUI assign default port numbers. 3. "Using Custom Port Numbers (the "Static Ports" Feature)" for details.3 What’s New in the Installation This chapter contains information about new installation features Oracle Application Server 10g Forms and Reports Services in the following sections: ■ ■ Section 3. "Custom Port Numbers" Section 3.3. such as Oracle HTTP Server and OracleAS Web Cache. or use port numbers that you specify.1.1. The OUI then uses the values from the file instead of the default port numbers. ■ ■ Section 3. To use static ports. "Using Custom Port Numbers (the "Static Ports" Feature)" What’s New in the Installation 3-1 . "Using Default Port Numbers" Section 3. instead of having the Oracle Universal Installer (OUI) assign default port numbers. "Configuration Assistant Enhancements" 3. you can specify custom port numbers for components.

Custom Port Numbers 3.1. Tip: The OUI will not assign port numbers that are specified in the /etc/services file. if you want to reserve port 7777 for an application. add a # at the beginning of the line. See Table 3–1. This means that if you want to use these port numbers for Oracle Internet Directory.3 Using Custom Port Numbers (the "Static Ports" Feature) To instruct OUI to assign custom port numbers for components: 3-2 Oracle Application Server 10g Forms and Reports Services Installation Guide . 3. For example. Note: In the default configuration for Solaris operating system. Instead. These happen to be the default ports for Oracle Internet Directory. If you do not want OUI to assign a specific port number. you must either delete or comment out these lines in the /etc/services file. To comment out a line.1. it assigns a number from the default port number range for OID. you can add something like the following line to /etc/services: 7777/tcp myApplication The OUI will not assign port 7777 to any component if this line exists in the /etc/services file. add the port number to the /etc/services file. the /etc/services file includes ports 389 and 636 (for LDAP and LDAP/SSL). you do not have to do anything. "Default Port Numbers and Ranges (Arranged by Component)"for a list of default port numbers that OUI will assign to components. then OUI will not assign ports 389 and 636 for Oracle Internet Directory (OID). as follows: # # # # ldap ldap ldaps ldaps 389/tcp 389/udp 636/tcp 636/udp # # # # Lightweight Directory Access Protocol Lightweight Directory Access Protocol LDAP protocol over TLS/SSL (was sldap) LDAP protocol over TLS/SSL (was sldap) If you do not comment out or remove the lines from /etc/services. See Table 3–1.2 Using Default Port Numbers If you want to use the default port numbers assigned to the installed components. "Default Port Numbers and Ranges (Arranged by Component)" for a list of default port numbers.

What’s New in the Installation 3-3 . you can include the file name in the command line.ini file. This file is typically called the staticports. Remove the lines for the components for which you want to use default port numbers. but you can name it anything you want. Create a file containing the component names and port numbers. You do not need to provide port numbers for all the components in this file. Edit the local copy (the file on the hard disk) to include the desired port numbers. Copy the staticports.ini file on the Disk 1 CD-ROM as a template: 1. 2. Oracle HTTP Server port = port_num Oracle HTTP Server Listen port = port_num Oracle HTTP Server SSL port = port_num Oracle HTTP Server Listen (SSL) port = port_num Oracle HTTP Server Diagnostic port = port_num Oracle HTTP Server Jserv port = port_num Java Object Cache port = port_num DCM Java Object Cache port = port_num Oracle Notification Server Request port = port_num Oracle Notification Server Local port = port_num Oracle Notification Server Remote port = port_num Application Server Control port = port_num Application Server Control RMI port = port_num Oracle Management Agent port = port_num Web Cache HTTP Listen port = port_num Web Cache HTTP Listen (SSL) port = port_num Web Cache Administration port = port_num Web Cache Invalidation port = port_num Web Cache Statistics port = port_num Reports Services SQL*Net port = port_num Oracle Certificate Authority SSL Server Authentication port = port_num Oracle Certificate Authority SSL Mutual Authentication port = port_num Log Loader port = port_num The easiest way to create the file is to use the staticports. You only provide port numbers for components that require them. The staticports. See below for file format.Custom Port Numbers 1.ini file has the following format (replace port_num with the port number that you want to use for the component). When you start up OUI. 2.ini file from the Disk 1 CD-ROM to your hard drive.

For components not specified. See the Note on page 3-2 for details.1. you can use the portlist. "Ports for Oracle HTTP Server and OracleAS Web Cache". Application Server Control port = 2000 Web Cache Administration port = 2001 Web Cache Invalidation port = 2002 Web Cache Statistics port = 2003 Tip: The staticports. If you plan to set port numbers for Oracle HTTP Server and OracleAS Web Cache.1 Ports for Oracle HTTP Server and OracleAS Web Cache In the httpd.ini file for subsequent installations. 3.Custom Port Numbers Usage Notes: ■ ■ Port numbers cannot be greater than 65536.ini file. If you use a port number lower than 1024 for a component.ini file uses the same format as the ORACLE_HOME/install/portlist. which is created after an Oracle Application Server 10g Forms and Reports Services installation. the Port and the Listen directives specify the ports used by OracleAS Web Cache and Oracle HTTP Server. you must run the component as the root user.ini file from the first installation as the staticports. You may need to configure the component first before you can start it up.3.3. OUI will assign the default port numbers.1. See the appropriate component documentation for details. be sure you read Section 3. If you use a port number lower than 1024 for a component. If you have installed Oracle Application Server 10g Forms and Reports Services and you want to use the same port numbers in another installation. ■ ■ ■ The following example sets the Application Server Control port and some ports for OracleAS Web Cache.conf file for Oracle HTTP Server. OUI will not be able to start up the component at the end of installation. 3-4 Oracle Application Server 10g Forms and Reports Services Installation Guide .1. You still have to comment out ports 389 and 636 in the /etc/services file if you want to use these port numbers for OID.

the Oracle HTTP Server port line is ignored. If your staticports. To set this port.ini file for setting these ports depend on which components you are configuring. if you have these lines in staticports. Set the port for OracleAS Web Cache. add the following line: Oracle HTTP Server Listen (SSL) port = port_number What’s New in the Installation 3-5 . 2.ini file: Web Cache HTTP Listen port = port_number To configure the SSL port for OracleAS Web Cache. Oracle HTTP Server uses the port specified by the Listen directive. add this line in the staticports.ini file contains both Oracle HTTP Server port and Web Cache HTTP Listen port.Custom Port Numbers The correct lines in the staticports. For example.ini file: Oracle HTTP Server Listen port = port_number To configure the SSL Listen port. OracleAS Web Cache uses the port specified by the Port directive (Figure 3–1). add this line in the staticports. To set this port. To Configure OracleAS Web Cache and Oracle HTTP Server 1. Set the port for Oracle HTTP Server. add the following line: Web Cache HTTP Listen (SSL) port = port_number You cannot set the port number using the Oracle HTTP Server port line in this case.ini: Web Cache HTTP Listen port = 7979 Oracle HTTP Server port = 8080 the Port directive would be set to 7979.

2. "Configuring Oracle HTTP Server to Use Ports 80 and 443 Without OracleAS Web Cache" ■ 3-6 Oracle Application Server 10g Forms and Reports Services Installation Guide .ini.ini. As in the non-SSL version.Custom Port Numbers Figure 3–1 Configuring both OracleAS Web Cache and Oracle HTTP Server The ports_wc.3. To set these ports.1. then Oracle HTTP Server uses both Port and Listen directives.ini file. they will be ignored because you are not configuring OracleAS Web Cache. Oracle HTTP Server SSL port = 443 Oracle HTTP Server Listen (SSL) port = 443 If you also specify the Web Cache lines in staticports.2. use the Oracle HTTP Server port and Oracle HTTP Server Listen port lines in the staticports.1. ■ Section 3. In this case. "Configuring Oracle HTTP Server to Use Ports 80 and 443 With OracleAS Web Cache as the Front-End" Section 3. the port numbers must be the same.3.gif displays the configuration of both OracleAS Web Cache and Oracle HTTP. 3.1. use the following lines. you must set both directives to use the same port number.3.2.1.2 Examples This section describes some common scenarios for using staticports. *********************************************************************************************** To Configure Oracle HTTP Server Only If you are configuring Oracle HTTP Server only. For example: Oracle HTTP Server port = 8080 Oracle HTTP Server Listen port = 8080 To set the SSL version of these ports.

ini file that includes the following lines: Web Cache HTTP Listen port = 80 Oracle HTTP Server Listen port = 81 See below. see Oracle HTTP Server Administrator’s Guide and Oracle Application Server Web Cache Administrator’s Guide. create a staticports.3.Custom Port Numbers 3. These port numbers do not have to be less than 1024. The example uses ports 81 and 444.1 Configuring Oracle HTTP Server to Use Ports 80 and 443 With OracleAS Web Cache as the Front-End In this scenario. You do this configuration after installation.ini file.ini file that includes the following lines: Oracle Oracle Oracle Oracle HTTP HTTP HTTP HTTP Server Server Server Server port = 80 Listen port = 80 SSL port = 443 Listen (SSL) port = 443 Note: Because you are using ports lower than 1024. 3.1. you have to configure Oracle HTTP Server and OracleAS Web Cache to run as the root user. ■ What’s New in the Installation 3-7 . OUI uses the default port number for the component.2.3.1.2 Configuring Oracle HTTP Server to Use Ports 80 and 443 Without OracleAS Web Cache In this scenario.2. You do this configuration after installation. create a staticports. Web Cache HTTP Listen (SSL) port = 443 Oracle HTTP Server Listen (SSL) port = 444 See below. Names of components in the file are case sensitive. For more details.1. you have to configure Oracle HTTP Server to run as the root user. Note: Because you are using ports lower than 1024. 3. For details. see Oracle HTTP Server Administrator’s Guide. you have to start up Oracle HTTP Server and OracleAS Web Cache as the root user. The ports for Oracle HTTP Server Listen and SSL Listen can be any available port. If you remove the line for a component from the file. If you select port numbers less than 1024.3.3 Notes on Using staticports.ini ■ You do not need to specify port numbers for all components in the staticports.

6299 Oracle Notification Server Request port Oracle Notification Server Local port Oracle Notification Server Remote port Oracle Application Server Containers for J2EE (OC4J) OC4J AJP OC4J RMI JMS 3301 3201 3701 3301 .1.1.6099 6100 .3300 3701 . "Using Custom Port Numbers (the "Static Ports" Feature)" for details. ■ Edit the staticports. It does not look in configuration files to determine which ports an application is using.ini file to see the assigned ports. Name in staticports. The OUI rereads the staticports.ini file. it displays an alert. which enables you to override the default port numbers. or shut down the application that is using the port. Table 3–1 Default Port Numbers and Ranges (Arranged by Component) Component Default Port Port Number Range Name in staticports. See Section 3.ini.6199 6200 .4 Default Port Numbers Table 3–1 lists the default port numbers for components. 3.3800 Not settable Not settable Not settable 3-8 Oracle Application Server 10g Forms and Reports Services Installation Guide . Click Retry. ■ When installation is complete.3400 3201 .ini Oracle Process Management and Notification (OPMN) Oracle Notification Server Request Port Oracle Notification Server Local Port Oracle Notification Server Remote Port 6003 6100 6200 6003 .ini file and verifies the entries in the file again.ini file to specify a different port. This means that it can only detect ports that are being used by running processes.Custom Port Numbers ■ OUI verifies that the ports specified in the file are available by checking memory. The OUI will not assign a port that is not available. b. specifies the component name as it appears in the staticports. If the OUI detects that a specified port is not available. you can check the ORACLE_ HOME/install/portlist. To fix this: a. The last column.3.

14010 Reports Services SQL*Net port Not settable What’s New in the Installation 3-9 . OracleAS Web Cache configured) Oracle HTTP Server Listener (SSL.7877 4443 .7877 Oracle HTTP Server Listen port Oracle HTTP Server Listen (SSL) port Oracle HTTP Server port Oracle HTTP Server SSL port Oracle HTTP Server Jserv port Java Object Cache port DCM Java Object Cache port Not settable Not settable Oracle HTTP Server Diagnostic port 4443 7778 4444 8007 7000 7100 9998 7501 7200 4443 . OracleAS Web Cache configured) JServ servlet engine Java Object Cache DCM Java Object Cache SOAP server Port Tunneling Oracle HTTP Server Diagnostic port OracleAS Reports Services SQL*Net (for 6i backwards compatibility only) OracleAS Reports Services Visigenics CORBA OracleAS Web Cache 7777 7777 .ini Not settable Not settable Not settable Oracle HTTP Server Listener (OracleAS Web Cache not configured) Oracle HTTP Server Listener (SSL) Oracle HTTP Server Listener (non-SSL.3600 3601 .7599 7200 .3700 Name in staticports.7099 7100 .8107 7000 .3500 3501 .7299 1950 14000 1950 .4543 8007 .Custom Port Numbers Table 3–1 Default Port Numbers and Ranges (Arranged by Component) Component IIOP IIOPS1 IIOPS2 OracleAS Forms Services OracleAS Forms Services Oracle HTTP Server Uses the same port as Oracle HTTP Server Default Port 3401 3501 3601 Port Number Range 3401 .1960 14000 .9999 7501 .7199 9998 .4543 7777 .

1849 7770 .1829 1850 .44099 Application Server Control port Application Server Control RMI port Not settable Log Loader port Mutual Authentication Virtual Host 4401 4400 .7776 Oracle Management Agent port 1810 1850 4888 44000 1810 .1869 4888 .4300 4000 .ini Web Cache HTTP Listen port Web Cache HTTP Listen (SSL) port Web Cache Administration port Web Cache Invalidation port Web Cache Statistics port Oracle Enterprise Manager Application Server Control Application Server Control Application Server Control .Custom Port Numbers Table 3–1 Default Port Numbers and Ranges (Arranged by Component) Component OracleAS Web Cache .7877 4443 .SSL Log Loader Oracle Enterprise Manager 10g Grid Control Grid Control Oracle Management Agent Oracle Management Service OracleAS Certificate Authority Server Authentication Virtual Host 4400 4400 .HTTP Listener (SSL) OracleAS Web Cache Administration OracleAS Web Cache Invalidation OracleAS Web Cache Statistics Default Port 7777 4443 4000 4001 4002 Port Number Range 7777 .4419 Oracle Certificate Authority SSL Server Authentication port Oracle Certificate Authority SSL Mutual Authentication port Uses the same port as Oracle HTTP Server 1830 7770 1830 .RMI Application Server Control .4419 3-10 Oracle Application Server 10g Forms and Reports Services Installation Guide .4899 44000 .4543 4000 .HTTP Listener OracleAS Web Cache .4300 Name in staticports.4300 4000 .

You can rerun configuration assistants that have failed.2 Configuration Assistant Enhancements In Oracle Application Server 10g Forms and Reports Services. The configuration assistants write more understandable error messages in the log files.Configuration Assistant Enhancements 3. ■ What’s New in the Installation 3-11 . configuration assistants are enhanced with these features: ■ ■ The configuration assistants write log files in a central location.

Configuration Assistant Enhancements 3-12 Oracle Application Server 10g Forms and Reports Services Installation Guide .

0. The Reports/Forms Server column refers to the different releases of Oracle Forms and Oracle Reports server. Notes about the table: ■ ■ The Clients column refers to all the clients of Oracle Reports and Oracle Forms. Release 2 (9. ■ Compatibility with Earlier Versions 4-1 . 4. The Supported column refers to backward compatibility between client and server.0.4) Table 4–1 shows a compatibility matrix of earlier versions of Oracle Forms and Oracle Reports.1 Compatibility with Release 2 (9.4 Compatibility with Earlier Versions This chapter outlines the compatibility matrix of earlier versions of Oracle Forms and Oracle Reports with Oracle Application Server 10g Forms and Reports Services.3) and Release 10g (9.2).0.

0.0. Release 2 (9.0.0.2) Reports Clients ■ ■ ■ ■ rwcgi rwclient rwrqv rwservlet 9i (9.4) Forms Server 9i (9.0.2) Reports Server Yes None Oracle Reports 10g Clients ■ ■ ■ ■ rwcgi rwclient rwrqv rwservlet 6i Reports Server No None Oracle Reports 10g Clients ■ ■ ■ ■ rwcgi rwclient rwrqv rwservlet 10g (9.2) Forms Server Yes Yes Yes None There is no need to recompile Forms 9.4) Reports Server Supported? Yes Comments Using rwproxy.0.0.0.0.4) Table 4–1 Oracle Application Server 10g Forms and Reports Services Compatibility Matrix Clients Oracle Reports 6i Clients ■ ■ ■ ■ Reports/Forms Server 10g (9.2 applications None Oracle Forms 6i Clients Oracle9i Forms Clients Oracle Forms 10g Clients 4-2 Oracle Application Server 10g Forms and Reports Services Installation Guide .4) Forms Server 10g (9.3) and Release 10g (9.Compatibility with Release 2 (9.2).0.4) Reports Server Yes None Oracle9i (9. shipped with 10g rwcgi60 rwcli60 rwrqv60 rwservlet 10g (9.0.

5 Requirements Before installing Oracle Application Server 10g Forms and Reports Services. you can manually check only the remaining requirements. Table 5–1 System Requirements Item Operating system Requirement ■ ■ Checked by Installer Yes Solaris 8 Solaris 9 See Section 5. This chapter contains the following sections: ■ ■ ■ ■ ■ Section 5. you must ensure that your computer meets the requirements described in this chapter. "Operating System Patches" Section 5.1 System Requirements Table 5–1 lists the system requirements for running Oracle Application Server 10g Forms and Reports Services.3.4. "Operating System Patches" for a list of required patches.2. "Operating System User" Section 5.1. "System Requirements" Section 5. "Operating System Packages" Section 5. "Environment Variables" 5. Refer to Table 5–1 to see which requirements are not checked by the installer. Requirements 5-1 . To save time.2. The OUI checks many of the requirements at the start of the installation process and warns you if any of them is not met.5.

4. use the prtconf command: prompt> /usr/sbin/prtconf | grep Memory Note: These values assume you are running only one Oracle Application Server 10g Forms and Reports Services instance per computer. run the psrinfo command with the -v option: prompt> /usr/sbin/psrinfo -v Status of processor 0 as of: 02/10/03 13:21:20 Processor has been on-line since 02/04/03 15:45:07.4) uses the Sun Java 1.1 HotSpot Server VM. use the df command: prompt> df -k dir Replace dir with /opt/oracle No Space in /tmp directory 256 MB To determine the amount of free space in the /tmp directory. Oracle Application Server 10g Forms and Reports Services does not support computers using Solaris DHCP. Yes Disk space 1 GB To determine the amount of free disk space. Yes 5-2 Oracle Application Server 10g Forms and Reports Services Installation Guide . Oracle recommends a multiple CPU Yes computer. and has a sparc floating point processor.System Requirements Table 5–1 System Requirements Item IP Requirement The computer’s IP address must be static. This is because Oracle Application Server 10g (9. DHCP is supported on Linux and Microsoft Windows. you can specify a different directory by setting the TMP environment variable. which no longer supports SPARC v8 and older processors. Processor Type Processor Speed The processor must have a SPARC v9 architecture. The sparc processor operates at 450 MHz. Memory 512 MB To determine the amount of memory. No Checked by Installer No 300 MHz or greater (450 MHz recommended).0. To determine the processor speed. use the df command: prompt> df -k /tmp If the /tmp directory does not have enough free space.

System Requirements Table 5–1 System Requirements Item Swap space Requirement 640 MB of available swap space To determine the amount of available swap space. Checked by Installer Yes Log in as the root user. use the swap command: prompt> /usr/sbin/swap -s If you do not have enough swap space. ensure that the DISPLAY environment variable is set. run the xwininfo command. and create an empty swap file: prompt> su Password: root_user_password # mkfilesizemswap_file_name Append an "m" to the size to specify the size in megabytes (example: 600m). 2. prompt> /usr/openwin/bin/xwininfo Look for the "Depth" line. Before running the command. then this swap file must be at least 540 MB. The minimum size of this file must be greater than the difference between the currently available swap space and required swap space. Yes Requirements 5-3 . Add the file to the swap space using the following command: # /usr/sbin/swap -aswap_file_name 3. For example. You need a depth of at least 8 (bits per pixel). Verify the new swap space size: prompt> /usr/sbin/swap -s Monitor 256 color display To determine your monitor’s display capabilities. if you have 100 MB of free swap space. perform the following tasks: 1.

5. ■ 5.0 and higher Netscape 4.com).1 and higher However. For Oracle Report Services.3. see the Oracle Application Server 10g Administrator’s Guide. 6. you can stop them from the Oracle Enterprise Manager.sun.79.1 and higher Microsoft Internet Explorer 5. For details. Oracle Enterprise Manager is optimized for the following browsers: ■ ■ ■ For the most current list of supported browsers. if you want to stop services that are not used to reduce the memory usage. check the OracleMetaLink site (http://metalink. 5. 4.3.1. 6. the JVM heap size can be controlled by specifying small value through the environment variable REPORTS_JVM_OPTIONS.oracle. For details.Operating System Patches Table 5–1 System Requirements Item Supported browsers Requirement The following browsers are supported: ■ ■ ■ Checked by Installer No Microsoft Internet Explorer 5.1 Tips for Reducing Memory Usage If you need to reduce memory consumption: ■ After installation.78.5.2 Operating System Patches Table 5–2 lists the Solaris operating system patches that you must install before installing Oracle Application Server 10g Forms and Reports Services.0 and higher Netscape 7 and higher Mozilla 1.com 5-4 Oracle Application Server 10g Forms and Reports Services Installation Guide . see Oracle Application Server Reports Services Publishing Reports to the Web. You can download the patches from: http://sunsolve. 7 and higher Mozilla 1.

so.4. Click the "Readme" link on the following URL for the most current list of patches: http://sunsolve.1 patch 109147-24 or higher: Linker patch 111308-03 or higher: /usr/lib/libmtmalloc. The following command saves the output to a file called patchList.so. Inc.1: Runtime library patch 112003-03 or higher: Unable to load fontset in 64-bit Solaris 8 iso-1 or iso-15 108773-18 or higher: IIIM and X input and output method patch 111310-01 or higher: /usr/lib/libdhcpagent.1: Xsun patch 108921-16 or higher: CDE 1.pl?target=patches/J2SE Table 5–2 Required Patches for Solaris Operating Systems Operating System Solaris 8 Patches Required ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ 108652-66 or higher: X11 6. Sun Microsystems.1 patch 112438-01 or higher: /kernel/drv/random patch 111111-03 or higher: /usr/bin/nawk patch 112396-02 or higher: /usr/bin/fgrep patch 110386-03 or higher: RBAC feature patch 111023-02 or higher: /kernel/fs/mntfs and /kernel/fs/sparcv9/mntfs patch 108987-13 or higher: Patch for patchadd and patchrm 108528-22 or higher: Kernel update patch 108989-02 or higher: /usr/kernel/sys/acctctl and /usr/kernel/sys/exacctsys patch 108993-22 or higher: LDAP2 client. libc.Operating System Patches Note: Although the patches listed in Table 5–2 are current at the time of publication. 1. often updates the list of required patches for J2SE.4: dtwm patch 108940-54 or higher: Motif 1.1.2. How to Get a List of Operating System Patches Installed on Your Computer Follow the procedure below to determine which patches are installed on your computer. Requirements 5-5 . libthread and libnsl libraries patch 112138-01 or higher: usr/bin/domainname patch Solaris 9 No patches required. Run the showrev command with the -a option.com/pub-cgi/show.7 and 2.sun.

Do you wish to continue y/n n The installer gives you a choice to exit or continue. the installer cannot continue. You can then download and install the patches. not the letter "ell") SUNWxwfnt SUNWi1cs (the character after the "i" is the number 1. such as vi or emacs.Operating System Packages prompt> showrev -a > patchList 2. it displays a warning message in the shell where you started the installer: prompt> runInstaller . not the letter "ell") 5-6 Oracle Application Server 10g Forms and Reports Services Installation Guide . ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ SUNWarc SUNWbtool SUNWhea SUNWlibm SUNWlibms SUNWsprot SUNWsprox SUNWtoo SUNWi1of (the character after the "i" is the number 1. Type n to exit the installer if you do not have all the patches. Open the file in a text editor. If it does not find an exact match..3 Operating System Packages Check that your computer contains the following operating system packages. you have patch 108652-67 instead of 108652-66). How the Installer Checks for Operating System Patches The installer searches for the required patch versions on your computer. 5. If the packages are not present.. Pre-Requisite checks for patches have failed. and search for patch numbers. Type y to continue only if you have patches that are of a later version (for example.

To check if an operating system package is installed on your computer. run the pkginfo command with the name of the package.4 Operating System User Create an operating system user to install and upgrade Oracle products. Look in the /var/opt/oracle/oraInst. If the file does not exist. the computer does not have Oracle products installed on it. which is used by the installer for all Oracle products ■ If the computer contains other Oracle products.loc file. contact your system administrator. The primary group of the oracle user must have write permission for the oraInventory directory. The operating system user running the installer must have write permission for these directories: ■ the Oracle home directory. Requirements 5-7 . create a user with the following properties: Table 5–3 Properties of the Operating System User Who Runs the installer Item Login name Group identifier Description You can use any name for the user. If you do not already have a user for installing Oracle products. you might already have a user for this purpose.Operating System User ■ SUNWi15cs (the character after the "i" is the number 1. not the letter "ell") The last two packages (SUNWi1cs and SUNWi15cs) are required for the ISO8859-1 and ISO8859-15 codesets. You can use any name for the group. The syntax for running pkginfo is: pkginfo package_name For example: prompt> pkginfo SUNWarc If your computer is missing a package. Do this for each package listed above. This file lists the location of the inventory directory and the group who owns it. This guide refers to the user as the oracle user. 5. This guide uses the name oinstall. which contains files for the product you are installing the inventory directory.

The Full Name and Description fields are optional. 3. Bourne. use the Solaris Management Console: 1. In Primary Group. enter the name of the user (oracle).5. then expand System Configuration. This displays the Log In window. 5-8 Oracle Application Server 10g Forms and Reports Services Installation Guide . 12. 5. In User ID Number. Click Users. Never use it for purposes unrelated to the installer. In the left frame. 8. enter root. The default login shell can be the C. In Password. Select Action > Add User > With Wizard. Click Next. 4. 6. enter the root password. In Path. and enter a password for 11. To create a local operating system user. 9. Note: Use the oracle user only for installing and maintaining Oracle products. the user. 10. In the Log In window. in User Name.1. select the primary group for the user. In the left frame. In User Name. See Section 5. expand This Computer. Click Next. Select User Must Use This Password At First Login. Click Next. 7. Set the DISPLAY environment variable to point to the monitor where you want the Solaris Management Console window to appear. Click Next. enter a home directory for the user. Start up the Solaris Management Console: prompt> /usr/sadm/bin/smc 2. expand Users and select User Accounts. This is the group you created earlier to own the inventory directory. Do not use root as the oracle user.Operating System User Table 5–3 Properties of the Operating System User Who Runs the installer Item Home directory Login shell Description The home directory for the oracle user can be consistent with the home directories of other users. "DISPLAY Environment Variable" if you need help setting the environment variable. Click Next. or Korn shell. accept the default value.

1 DISPLAY Environment Variable Set the DISPLAY environment variable to point to the X server that will display the installer. To check which groups an operating system user belongs to.5.Environment Variables 13. Optional.screen_number Example (C shell): Requirements 5-9 . 5. or library to run. 14. Review the user information and click Finish to create the user. Unset Default set to YES.5 Environment Variables The operating system user who will be installing Oracle Application Server 10g Forms and Reports Services needs to set (or unset) the following environment variables. If unset. If it is set to NO. Specifies the path that Oracle Forms searches when looking for a form. defaults to /tmp. Table 5–4 Environment Variable Summary Environment variable ORACLE_HOME PATH. Table 5–4 summarizes whether you set or unset an environment variable. Review the mail server information for the user and click Next. run the groups command with the name of the user. The format of the DISPLAY environment variable is: hostname:display_number. 5. and LD_LIBRARY_PATH DISPLAY TMP TNS_ADMIN REPORTS_DEFAULT_ DISPLAY FORM90_PATH Set or Unset Unset Must not contain references to directories in any Oracle home directories. ensure that you specify the appropriate display. CLASSPATH. see your operating system documentation or contact your system administrator. menu. For example: prompt> groups oracle For more information about operating system users and groups. Set it to the monitor where you want to the installer window to appear.

then you must use a virtual frame buffer. 5-10 Oracle Application Server 10g Forms and Reports Services Installation Guide .com:0. The frame buffer X server installed with your operating system requires that you remain logged in and have the frame buffer running during installation. Search OTN for "frame buffer".com:0.oracle. such as X Virtual Frame Buffer (XVFB) or Virtual Network Computing (VNC).0 Example (Bourne or Korn shell): $ DISPLAY=test.acme.acme.0. Visit Oracle Technology Network (http://otn.com) for information about obtaining and installing XVFB or other virtual frame buffer solutions.Environment Variables % setenv DISPLAY test. export DISPLAY You can test the display by running the xclock program: $ /usr/openwin/bin/xclock & Oracle Application Server 10g Forms and Reports Services requires a running X server during installation only. If you do not wish to do this.

You might need to edit the value of the NLS_LANG variable in these files. 3.6 Post-Installation Tasks This chapter describes the post-installation tasks you need to perform to ensure complete installation of Oracle Application Server 10g Forms and Reports Services. Post-Installation Tasks 6-1 . 6.1. including a list of files that set this variable. "Deployment of Forms and Reports Application" 6. "Testing your Forms and Reports Services Installation" Section 6. Click the Forms Services or Reports link to run the test Form or test Report.1 Testing your Forms and Reports Services Installation Testing your Forms and Reports Services install would require you to have a Windows machine and a browser to invoke the OEM page of your installtion. "NLS_LANG Environment Variable" Section 6. To test your installation. This chapter contains the following sections: ■ ■ ■ Section 6.3. See the Oracle Application Server 10g Globalization Guide for details.2. 2. 4. Click the Business Intelligence and Forms link. perform the following steps: 1.2 NLS_LANG Environment Variable Check the value of the NLS_LANG environment variable to ensure that it is correct for your environment. Open the Oracle Application Server Welcome page (http://hostname:7777) Click the Demonstrations tab.

3 Deployment of Forms and Reports Application Table 6–1 lists the guides that outline post-installation information on how to configure and deploy Forms and Reports application. Table 6–1 Deploying Forms and Reports Applications Component OracleAS Reports Services OracleAS Forms Services Guides Oracle Application Server Reports Services Publishing Reports to the Web Oracle Application Server Forms Services Deployment Guide 6-2 Oracle Application Server 10g Forms and Reports Services Installation Guide .Deployment of Forms and Reports Application 6.

4-1 operating system groups groups command. summary of. DISPLAY.2/9. 4-6 pkginfo command. 4-7 groups command. 4-7 operating system patches showrev command.0. 4-3 C compatibility compatibility matrix. 4-2 reducing. 5-1 D disk space requirements. 4-9 operating system packages. 4-7 E environment variables. 4-9 NLS_LANG. 2-11 CPU requirements. 2-1 NLS_LANG environment variable. 3-1 configuration assistant enhancements. 3-1 with Release 9. 2-1 IP requirements. 4-9 oracle user. 4-3 new features. 4-5 operating system users. installer 1-1 P packages (operating system) see operating system packages Index-1 . 4-9 I installation steps. 4-2 N new features in the installer.3.Index Numerics 256 color requirement. 4-9 O operating system patches. 4-4 M memory requirements. 5-1 4-9 G groups command. 4-2 DISPLAY environment variable.0. 4-4 version. 4-2 B browser requirement. 4-4 monitor requirements.

4-5 Solaris 9 patches required.0. 4-2 processor type. 4-2 processor type. 4-2 psrinfo command.0. 4-5 Solaris 8 patches required. 2-2 portlist. 4-4 operating system version. 4-1 processor speed. 4-2 space in /tmp. 2-2. 4-3 operating system packages. 2-1. 2-1 static.patches see operating system patches pkginfo command. 4-2 monitor. 2-8 processor speed. 4-3 S showrev command. 4-6 operating system patches. 4-7 port numbers. 2-2 staticports.ini file. 4-2 swap space. 4-2 T /tmp directory space required. 1-1 summary of installation steps. 4-5 static port numbers. 4-2 environment variables. 4-4 disk space.3 compatibility with. 4-2 Release 9. 3-1 requirements browser. 4-3 Index-2 .ini file. 1-1 swap space requirement. 4-9 memory. 4-2 U users (operating system) see operating system users R RAM requirements. 4-2 static IP. 2-1. 2-3 steps. summary of.2/9.

Sign up to vote on this title
UsefulNot useful