Skip Headers
Oracle® Application Server Release Notes
10g Release 2 (10.1.2) for hp-ux PA-RISC (64-bit)
B15511-05
  Go To Documentation Library
Home
Go To Table Of Contents
Contents
Go To Index
Index

Previous
Previous
Next
Next
 

2 Installation and Upgrade Issues

This chapter describes installation and upgrade issues and their workarounds associated with Oracle Application Server. It includes the following topics:

2.1 Installation Issues

This section describes issues with installation of Oracle Application Server. It includes the following topics:

2.1.1 LDAP Replication Using SSL Mode is not Supported

LDAP replication using SSL Mode is not supported when you select the "Use SSL communications to this Internet Directory" option during Oracle Internet Directory replication installation.

If you want to perform LDAP replication using SSL Mode, the workaround is to perform your installation in non-SSL mode first. Then change the Oracle Internet Directory instances to operate in SSL mode using the steps described in the Oracle Application Server 10g Administrator's Guide.

2.1.2 Harmless Message in the oraInstall.err Log File

The following error appears in the oraInstall.err log file after certain installations:

java.io.FileNotFoundException:
/net/stnfs3/vol/shiphomes/solaris/dailyShiphomes/iashybrid/10.1.2/daily/041221.0020/Disk1/stage/Patches/oracle.rdbms.dbscripts/10.1.0.3.1/1/DataFiles/sql.jar

This error can be safely ignored.

2.1.3 Locales zh_TW.EUC and zh_TW in Traditional Chinese Environments Not Supported in the OracleAS Portal Component

If you try to install the OracleAS Portal component on a computer where the locale is set to zh_TW.EUC or zh_TW in Traditional Chinese environments, the installer will pause indefinitely because of the Java encoder behavior for these locales.

The workaround is to use the zh_TW.BIG5 locale in these environments. This requirement applies during installation only. After installation, you can reset the locale to the original locale.

2.1.4 The lsnodes Command Fails on Non-RAC HP-UX Systems

After completing the installation, the install*.err files in the oraInventory/logs directory may contain errors similar to following line and with java exception stack details:

lsnodes: cannot get local node number

This error is harmless and can be safely ignored. It does not affect any functionality.Similar errors may also happen when applying bug fixes using the OPatch utility. However, the patch succeeds and the error can be safely ignored.

2.1.5 Rerun OC4J Configuration Assistant If It Fails During an OracleAS Cluster (Identity Management) Installation

In Oracle Application Server Clusters (Identity Management) installations, the installer creates a DCM cluster for the Oracle Internet Directory, OracleAS Single Sign-On, and Oracle Delegated Administration Services components.

As part of the cluster creation operation, which is performed by the OracleAS Cluster Assistant, the assistant also restarts the components. DCM invokes OPMN to restart the components.

Because Oracle Internet Directory is integrated with OPMN, OPMN starts up and monitors oidmon. In turn, oidmon starts up Oracle Internet Directory. However, OPMN returns as soon as oidmon is up; it does not wait for Oracle Internet Directory to start up. This causes a problem because the next configuration assistant, the OC4J Configuration Assistant, requires Oracle Internet Directory to be up and running. If Oracle Internet Directory is still not running, the OC4J Configuration Assistant fails.The workaround is to ensure that Oracle Internet Directory is successfully restarted, then rerun the OC4J Configuration Assistant.

2.1.6 Warning Message from Oracle Universal Installer

You may receive the following warning message when running Oracle Universal Installer:

Warning : Some Patch Bundles were not found on the system. Please ensure that either June 2003 Quality Pack GoldQPK11i has been installed or verify that 
the system is at a higher bundle level.

You can ignore this warning.

2.1.7 Deconfiguration Script Does Not Remove Entries from OracleAS Metadata Repository

If you try to deconfigure an Identity Management instance using the deconfiguration script you will not be able to remove entries from the OracleAS Metadata Repository. This occurs when the Identity Management instance is connected to an OracleAS Metadata Repository that has been loaded by OracleAS RepCA, The OracleAS Metadata Repository cannot be reused until the following SQL queries are manually run to remove the entries:

  • SQL> execute dbms_ias_version.set_component_loading(component_id=>'MRC', component_name=>'Oracle Application Server Metadata Repository Version', schema_name=>'SYS')

  • SQL> execute dbms_ias_version.set_component_loaded(component_id=>'MRC')

  • SQL> execute dbms_ias_version.set_component_valid(component_id=>'MRC')

2.1.8 Problem Running bulkload.sh Utility

When you run the bulkload.sh utility to create Oracle Internet Directory entries from data residing in or created by other applications, you may observe the following error message:

"SQL*Loader-951: Error calling once/load initialization ORA-39778: the parallel load option is not allowed when loading lob columns".

This issue is caused by bug 3931084. Obtain and apply the patch for bug 3931084 to your Oracle Application Server installation. You can download the patch from OracleMetalink (http://metalink.oracle.com).

The following are known configurations when the patch for bug 3931084 should be applied before running the bulkloa.sh utility:

  • Oracle Application Server 10g Release 2 (10.1.2) with Oracle9i Database Enterprise Edition 9.2.0.X

  • Oracle Application Server 10g Release 2 (10.1.2) with Oracle Database 10g Enterprise Edition 10.1.0.4

2.2 Upgrade Issues

This section describes issues with the upgrade of Oracle Application Server. It includes the following topics:

2.2.1 Problems Upgrading Oracle HTTP Server on HP-UX

The following message might be displayed if you are upgrading a middle-tier installation:

FastCGI: failed to connect to (dynamic) server
"/opt/oracle/inst/Apache/Apache/fcgi-bin/echo": path
"/opt/oracle/inst/Apache/Apache/logs/fastcgi/dymanic/aac1cec5416b961cf002c5526b4159" is too long for a Domain socket

On HP-UX, the path for sockets used by FastCGI is limited to 108 characters. If the message is displayed, use the FastCgiIpcDir directive to specify a path name that is significantly shorter than 108 characters, such as /tmp as follows:

  1. Edit the http.conf file for the Oracle HTTP Server that you are trying to upgrade and set the FastCgiIpcDir directive to a short path such as /tmp.

  2. Run the following command:

    dcmctl updateConfig -ct ohs
    
    
  3. Restart the Oracle HTTP Server.

  4. Restart the Upgrade process.

2.2.2 Login Link Inoperable

After you perform an upgrade of Oracle Application Server 10g from version 9.0.4 to version 10.1.2, the Oracle Enterprise Manager login link on the welcome page no longer works. During installation, the port number specified for Oracle Enterprise Manager for version 9.0.4 installation is not updated in the version 10.1.2 welcome pages. There is no workaround for this issue at this time.

2.2.3 Remaining OracleAS Infrastructure Instance in Farm

After you complete an upgrade of OracleAS Infrastructure in a farm, the pre-upgrade instance of the infrastructure still remains in the farm. There is currently no way to remove the pre-upgrade instance. The remaining instance will not cause any operational problems with the upgraded infrastructure.

2.2.4 Failure of File-Based Farm Repository Configuration Assistant

If you select Stop, and then select Retry during operation of the File-Based Farm Repository Configuration Assistant in the Oracle Universal Installer, the configuration assistant fails and displays the following message:

"This instance is already a member of a farm. An Oracle Application Server instance cannot be moved directly from one farm to another."

There is presently no workaround for this issue.

2.2.5 Problems Running Oracle Universal Installer When Installing Required OracleAS Portal Patch

If you are upgrading a Release 2 (9.0.2) OracleAS Metadata Repository and you are using OracleAS Portal, then you must apply an OracleAS Portal patch before upgrading the OracleAS Metadata Repository.


See Also:

Section 6.3.1.1, "Downloading and Installing the OracleAS Portal 10g (9.0.4) Repository Upgrade Software" in the Oracle Application Server 10g Upgrading to 10g (9.0.4)

However, while using Oracle Universal Installer to install the required patch, Oracle Universal Installer may quit unexpectedly. To prevent this problem from occurring, do the following:

  1. Use a text editor to open the oraparam.ini file, which is located in the following directory in the application server Oracle home:

    ORACLE_HOME/oui
    
    
  2. Locate the following entry in the oraparam.ini file:

    JRE_MEMORY_OPTIONS=" -mx96m"
    
    
  3. Modify the entry as follows:

    JRE_MEMORY_OPTIONS=" -mx160m"
    
    
  4. Save your changes and close the oraparam.ini file.

  5. Restart Oracle Universal Installer and install the patch as documented in the Oracle Application Server 10g Upgrading to 10g (9.0.4).

2.2.6 Problem Running the mod_osso Configuration Assistant When Upgrading an Oracle Internet Directory in a Partial Replication Environment

When you are upgrading Identity Management in an environment where you are using Oracle Internet Directory partial replication, you may encounter a problem while running the upgrade with Oracle Universal Installer: the mod_osso Configuration Assistant may fail.

If this problem occurs, do not quit Oracle Universal Installer. Instead, leave the program running and perform the following workaround in a separate window:

  1. Using a text editor, open the following file in the Oracle home of the replica you are upgrading:

    ORACLE_HOME/config/infratool_mod_osso.properties
    
    
  2. Modify the contents of the file so it reads as follows:

    DCMRESYNC=oracle.ias.configtool.configimpl.DcmResync$0
    JAZN=oracle.security.jazn.util.JAZNConfigTool$0
    HTTPD=oracle.ias.configtool.configimpl.HttpdSsoConfig$0
    MODOSSO=oracle.ias.configtool.configimpl.SsoConfig$0
    
    
  3. Save your changes and close the infratool_mod_osso.properties file.

  4. Return to Oracle Universal Installer and try running the configuration assistant again.

2.2.7 Problems or Issues While Upgrading Specific Components

If you experience problems or issues while upgrading a particular application server component, refer to the component chapter in these release notes for more information.

For example, refer to Chapter 9, "Oracle Ultra Search" for information about issues you may encounter when upgrading Oracle Ultra Search. Refer to Chapter 8, " Oracle Application Server Portal" for information about issues you may encounter while upgrading OracleAS Portal.

2.2.8 Upgrading a Portal and Wireless Installation from 9.0.2.3 to 10.1.2 on HP-UX.

After upgrading a Portal and Wireless installation from 9.0.2.3 to 10.1.2, Oracle HTTP Server may fail to start and the following messages may be displayed:

OpenWallet failed with error 28759
[Tue Jan 11 20:39:27 2005] [error] mod_ossl: Failed to open the wallet [Hint: incorrect path, incorrect password, bad wallet, ...]

This issue is due to the loading sequence of mod_ossl and php4. To avoid this problem make sure that the php4_module is loaded before the ossl_module:

  1. Open the $ORACLE_HOME/Apache/Apache/conf/httpd.conf file in a text editor.

  2. Search for the following text, which loads ossl_module.:

    <IfDefine SSL>
        LoadModule ossl_module libexec/mod_ossl.so
    </IfDefine>
    
    
    
  3. Add the following line before the ossl_module load entry:

    LoadModule php4_module libexec/libphp4.so
    
    
  4. Remove any other line that loads php4_module.

  5. Start the Oracle HTTP Server.

2.3 Documentation Errata

This section describes documentation errata. It includes the following topic:

2.3.1 Safari Browser Not Supported

The Safari browser is not supported in this release of Oracle Application Server 10g.

This is stated incorrectly in the Oracle Application Server 10g Installation Guide.

2.3.2 Extra Screen During Cluster Installation

Table 12-5 "Steps for Installing OracleAS Cluster (Identity Management) on Subsequent Nodes" of the Oracle Application Server 10g Installation Guide does not contain an entry for the Specify LDAP Virtual Hosts and Ports screen. This screen appears before the Specify OID Login screen prompting you to enter the hostname and port for LDAP virtual hosts.

2.3.3 Checking Software Requirements

Section 4.2.1 of the Installation Guide asks you to use the following command:

# /usr/sbin/swlist | grep QPK

However, this command may not list patches that were release later than June 2003 Quality Pack GoldQPK11i. Use the following command to list system software:

# /usr/sbin/swlist -l bundle | grep -i gold

If the system meets the software requirement because a later version of a package is installed, the installer may report a warning. It is safe to ignore that warning.

2.3.4 Host Name Limit of 255 Characters

The information about hardware requirements in Chapter 4 of the Installation Guide should mention that for Hostname, host names must not exceed 255 characters, and this is not checked by the installation software.

2.3.5 Kernel Parameter Settings: nfile and nproc

In the "Configuring Kernel Parameters on HP-UX" section of Chapter 4 of the Installation Guide, the recommended values for the nfile and nproc parameters are too low in the "Kernel Parameter Settings for OracleAS Metadata Repository" table. The recommended values for these parameters should be:

  • nfile: 65536

  • nproc: 4200

2.3.6 Additional Database Option Requirement

In addition to the required options listed in Table 8, "Required Database Options" in Section 1.5.9, "Database Options" in the Oracle Application Server Repository Creation Assistant User's Guide, you must also include Oracle XML DB. If you do not have all of the required options, OracleAS RepCA will not run properly.