Professional Documents
Culture Documents
Forms and Reports Services Release Notes 10g (9.0.4) for AIX-Based Systems and hp Tru64 UNIX
Part No. B13667-02 April 2004
Welcome to Oracle Application Server 10g (9.0.4) Forms and Reports Services. This document contains information that is specific for installing, configuring, and using Oracle Application Server 10g (9.0.4) Forms and Reports Services:
Documentation Accessibility About This Installation Type Available Features with this Installation Type Before You Start Installing Software Other Sources of Information General Issues Oracle Application Server Forms Services Release Notes Oracle Application Server Reports Services Release Notes Upgrade Issues
1 Documentation Accessibility
Our goal is to make Oracle products, services, and supporting documentation accessible, with good usability, to the disabled community. To that end, 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 accessible to all of our customers. For additional information, visit the Oracle Accessibility Program Web site at
http://www.oracle.com/accessibility/
not always correctly read the code examples in this document. The conventions for writing code require that closing braces should appear on an otherwise empty line; however, JAWS may not always read a line of text that consists solely of a bracket or brace.
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
Oracle is a registered trademark of Oracle Corporation and/or its affiliates. Other names may be trademarks of their respective owners.
not own or control. Oracle neither evaluates nor makes any representations regarding the accessibility of these Web sites.
OracleAS Forms Services Oracle Application Server Reports Services Oracle HTTP Server Oracle Application Server Web Cache Oracle Containers for J2EE (OC4J) Oracle Enterprise Manager Oracle Process and Management Notification (OPMN) Distributed Configuration Management (DCM)
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. From these pages you can drill down for more detailed information on administration, configuration, and performance monitoring. These pages allow you to administer the application server and its components and deployed applications. The underlying software technologies that keep track of your application server instances and components: These technologies automatically perform many management tasks. For example, they discover the components of each
application server instance, gather and process performance data, and provide access to application configuration information. Application Server Control is installed as part of the Oracle Application Server installation process.
Read this document first, which includes release notes for Oracle Application Server Forms and Reports Services. Read the Oracle Application Server 10g (9.0.4) Forms and Reports Services Installation Guide. This guide explains what you need to know and to do when installing this installation type.
3.
If you are upgrading from Oracle Forms 6i to Oracle Forms10g, read the white paper Forms 6i to Oracle9i Forms Upgrade Reference at http://otn.oracle.com/products/forms/pdf/forms_upgrade_ reference.pdf.
Refer to the latest version of these Release Notes on http://otn.oracle.com/documentation for any updates to this URL
Online help, available in Oracle Forms Developer, Oracle Reports Developer, and Oracle Enterprise Manager Oracle Application Server Forms Services 10g Deployment Guide Oracle Forms Migration Guide Oracle Application Server Reports Services Publishing Reports to the Web Oracle Application Server 10g Concepts Oracle Application Server 10g Administrators Guide Oracle Application Server 10g Release Notes Oracle Technology Network (http://otn.oracle.com/).
6 General Issues
This section contains information about general issues specific to this install type.
6.1 Prerequisite Check Blocks Reinstallation into the Same ORACLE_ HOME
Reinstalling Forms and Reports Services into the same ORACLE_HOME is currently blocked by Oracle Universal Installer (OUI). If you need to reinstall into the same Oracle Home because of a failed installation, you will need to deinstall the product first by clicking Deinstall Products... on the OUI Welcome Page. Select the check box that corresponds to the target ORACLE_HOME. Then click Remove and click Yes on the Confirmation Page. After deinstalling, proceed with the reinstallation. Select the same ORACLE_ HOME in the Specify File Locations Page. You may receive a warning that the target ORACLE_HOME is not registered in the central inventory. Click Yes and continue with the installation.
General Issues and Workarounds Configuration Issues and Workarounds Oracle Application Server Forms Services Issues Oracle Application Server Forms Services Known Bugs Oracle Forms Services Documentation Errata
7.1.2 Oracle Enterprise Manager Reporting Zero Shared Memory Usage on Tru64 UNIX
On the Forms User Sessions Page of Oracle Enterprise Manager, the shared memory usage is displayed as zero. That is, the output of the nmb utility is displayed as fo ex. 0.0000. This value is incorrect, however the total memory usage is reported by the private memory figure. That is, the figure displayed as private memory usage is the sum of the private memory usage and the shared memory usage.
7.3.1 Disable Single Sign-On Before Migrating from Forms Services 9.0.2
If you migrated from 9.0.2 with Single Sign-On (SSO) to Oracle Application Server 10g Forms and Reports Services, make sure that the parameter ssoMode in the formsweb.cfg file is set to false in order to run your application with this install type.
Oracle Application Server Reports Services Known Bugs Oracle Reports Services Documentation Errata
8.1.1 Configuring the In-Process Reports Server with OPMN on Tru64 UNIX
To ensure that the in-process Reports Server can be automatically managed by OPMN, perform the following post-installation steps:
1.
Start up a Visibroker Smart Agent (osagent) on your subnet. Visibroker is not available for Tru64 UNIX. The osagent executable can be found in any Oracle10g, Oracle9i Release 2 Application Server or Developer Suite installation.
Note: Running osagent for Oracle Reports Services does not require a powerful computer.
2.
Modify the opmn.xml file to automatically start up the in-process Reports Server. Make sure that there is a pingserver entry in the OC4J_BI_Forms section of the opmn.xml file and that the start parameter is set to auto. For example:
<category id="urlping-parameters"> <data id="/reports/rwservlet/pingserver?start=auto" value="200"/> </category>
Note:
A Visibroker Smart Agent (osagent) must exist and be running if the in-process Reports Serveris set to automatically start up using OPMN. If an osagent is not found, the in-process Reports Server is not started, and the OC4J_BI_Forms instance goes into a continuous restart loop. This affects other components that use OC4J_BI_Forms, such as Forms or Oracle Application Server Personalization. If this scenario occurs or, if the OC4J_BI_Forms instance becomes unstable because of the In-Process Reports Server, remove the pingserver entry from the opmn.xml file. For example, remove the following section from the opmn.xml file if it exists:
This prevents the OC4J_BI_Forms instance from going into a continuous restart loop. For more information about configuring reports server with OPMN, please see the Oracle Application Server Reports Services Publishing Reports to the Web 10g (9.0.4) guide.
The address is a random memory address, for example 203bded0. You can safely ignore these messages, they are caused by a known bug in Java 1.4.2.
8.2.1 Manually Including Display Value for Reports Servers Added Using addNewServerTarget.sh Script on AIX
If you use the addNewServerTarget.sh script to add a Reports server to the opmn.xml file for Oracle Application Server 10g (9.0.4) Business Intelligence and Forms and Oracle Application Server (9.0.4) Forms and Reports Standalone installations, you need to manually add the DISPLAY value for that Reports server on AIX. If you do not, you receive an error similar to the following when you try to run a report using that Reports server:
REP-3000: Internal error starting Oracle Toolkit.
Change directory to $ORACLE_HOME/opmn/conf. Back up the opmn.xml file. Add a new line of type <variable id="DISPLAY" in the opmn.xml file configuration section for the new Reports server. Use the following example as a guide, where reportserver_name is the name of the Reports server, and display_value is that value of the DISPLAY:
<process-type id="ReportsServer" module-id="ReportsServices"> <process-set id="reportserver_name" restart-on-death="true" numprocs="1"> <environment> <variable id="DISPLAY" value="display_value"/> <variable id="PATH" value="/project1/AS10g/FR_STANDALONE_M23_ MAR08/ohome/bin:/usr/bin:/etc:/usr/sbin:/usr/ucb:/usr/bin/X11:/sbin:/usr/ java130/jre/bin:/usr/java130/bin:/usr/bin:/bin"/>
4.
5.
6.
2.
Check that the value for port_number is correct for each Reports server. If neccessary, change the value to the Apache port of the 9.0.2 middle tier installation, because the 9.0.2 middle tier installation's ports are used after upgrading. If the targets.xml file contains the wrong URL for a Reports server, then if you access the Report server's page using Oracle Enterprise Manager, the report server status will be incorrect and some of the metrics and data will show up as Unavailable.
8.2.4 Modify reports.sh on Tru64 UNIX After Upgrading from Release 2 (9.0.2)
If you upgrade a 9.0.2 middle tier (Business Intelligence or Unified Messaging) to Oracle Application Server 10g Forms and Reports Services 10g (9.0.4), complete the following steps before running any of the Reports executables:
1.
2.
Remove the section you found in step 1 and insert the following section in its place:
## Compaq Tru64 settings (OSF1) elif [ `uname -s` = 'OSF1' ] then LD_LIBRARY_PATH=$ORACLE_HOME/jdk/jre/lib/alpha:$ORACLE_ HOME/jdk/jre/lib/alpha/fast:$ORACLE_HOME/jdk/jre/lib/alpha/native_ threads:$ORACLE_HOME/lib:${LD_LIBRAR Y_PATH}; export LD_LIBRARY_PATH #Adding command uac p noprint avoid unalligned messages /bin/uac p noprint #Set the following variable to use Motif 2.1 with JDK 142. _JAVA_AWT_USE_MOTIF_2_1=1; export _JAVA_AWT_USE_MOTIF_2_1 ## Default settings
10
9 Upgrade Issues
This section contains the following topic:
11
12