Skip Headers

Oracle® Application Server 10g Installation Guide
10g (9.0.4) for hp HP-UX PA-RISC (64-bit) and Linux x86
Part No. B10842-03
  Go To Documentation Library
Home
Go To Table Of Contents
Contents
Go To Index
Index

Previous Next  

B Troubleshooting

This appendix lists some methods for troubleshooting your Oracle Application Server installation. It includes the following topics:

B.1 Verify Requirements

Review the following information before performing any of the troubleshooting steps in this appendix:


Check Dependencies

If you are installing a middle tier, check that the OracleAS Infrastructure 10g that you want to associate the middle tier with is running during installation.


Read the Release Notes

Read the Oracle Application Server 10g Release Notes prior to installing Oracle Application Server. The release notes are available with the platform-specific documentation. The latest version of the release notes is available on OTN at:

http://otn.oracle.com/documentation/ias.html

B.2 User Interface Does Not Display Properly

If you are serving non-English content and forgot to click the Product Languages in the installation (see Section 5.6, "Installing Additional Languages"), the user interface might not display properly because the required fonts were not installed. You can fix this by installing the fonts from the "OracleAS RepCA and Utilities" CD-ROM or from the Oracle Application Server DVD.

  1. Insert and mount the "OracleAS RepCA and Utilities" CD-ROM or the Oracle Application Server DVD.

  2. CD-ROM: Copy the contents of the utilities/fonts directory on the CD-ROM to the ORACLE_HOME/jdk/jre/lib/fonts directory.

    DVD: Copy the contents of the repca_utilities/utilities/fonts directory on the DVD to the ORACLE_HOME/jdk/jre/lib/fonts directory.

B.3 What to Do If an Installation Error Occurs

If you encounter an error during installation of Oracle Application Server:

B.4 Troubleshoot Configuration Assistants

To troubleshoot an installation error that occurs when the configuration assistants are running:

B.4.1 Configuration Assistant Failure

Oracle Application Server configuration assistant failures are noted at the bottom of the installation screen. The Oracle Application Server configuration assistant interface displays additional information, if applicable. The configuration assistant’s execution status will be identified by the result. The result codes are:

Status Result Code
Configuration Assistant Succeeded 0
Configuration Assistant Failed 1
Configuration Assistant Cancelled -1

This result code is written to the following log file:

oraInventory/logs/installActionstimestamp.log

B.4.2 Failure During Component Configuration and Startup

During installation, configuration assistants run when the Configuration Assistants screen appears. If a configuration assistant fails, try the following procedure to correct the problem:

  1. Review the installation log files for this Oracle Application Server instance.

  2. Review the log files for each configuration assistant located in the ORACLE_HOME/cfgtoollogs directory. Default log file locations are described in Section B.5, "Descriptions of Oracle Application Server Configuration Assistants".

  3. Refer to the section describing the configuration assistants in Section B.5, "Descriptions of Oracle Application Server Configuration Assistants".

    1. If the failing configuration assistant has any dependencies, then run the dependencies again. You must do this even if the dependency completed successfully.

    2. Run the failing configuration assistant again. If you are using the installer, select the configuration assistant and click Retry.

      If the configuration assistant fails again after you click Retry, then you must remove the /var/tmp/EM_CONFIG_INSTALL.lk lock entry and try re-running the configuration assistant again.

    3. If an optional configuration assistant fails, and it does not have any dependencies, run the remaining configuration assistants. Uncheck the cancelled optional configuration assistant, highlight and check the next listed configuration assistant, and click Retry.

    4. If configuration assistant failure occurs when running configuration assistant execution commands on the command line, then re-run the configuration assistant execution command again.

      You can use the generated script file named configToolCommands located in the ORACLE_HOME/cfgtoollogs directory to execute the failed configuration assistant again. The configToolCommands script is generated after you exit the installer. During silent or non-interactive installation of Oracle Application Server the configToolCommands script is generated immediately after configuration assistant failure.

      You must set the following environment variables before using the generated script:

      • Set the ORACLE_HOME environment variable to the ORACLE_HOME path.

      • Append the shared library path environment variable with the exact locations of ORACLE_HOME/lib and ORACLE_HOME/network/lib.

        Table 4-15 lists the shared library path environment variables for different platforms

      • For the Register DCM Plug-Ins With EM Configuration Assistant only, set the PERL5LIB environment variable to the ORACLE_HOME/perl/lib/5.6.1 directory.


      Note:

      If the description of a configuration assistant includes an "Initial Tasks" section, you must perform these tasks before running the configuration assistant.

B.4.3 Fatal Errors

Some configuration assistant failures are "fatal errors". You cannot recover from a fatal error by correcting the problem and continuing. You must remove the current installation and reinstall Oracle Application Server. The following tasks describe the recovery procedure:

  1. Deinstall the failed installation using the procedure described in Section C.1, "Deinstallation of 10g (9.0.4) Instances".

  2. Correct the cause of the fatal error.

  3. Reinstall Oracle Application Server.

  4. If the fatal error reoccurs, then you must remove all Oracle installations from your computer.

B.4.4 How to Rerun OracleAS Randomize Password Configuration Assistant

The following steps describe how to rerun OracleAS Randomize Password Configuration Assistant:

  1. Start Oracle Internet Directory Manager.

  2. Enter the Oracle Internet Directory host, port, user name, and password.

  3. Expand Entry Management > cn=OracleContext > cn=Products > cn=IAS > cn=IAS Infrastructure Databases.

  4. Click orclreferencename=<your_globaldb_name>

  5. For each schema under the <your_globaldb_name> tree, there is an orclreferencename entry. For the orclreferencename entry:

    • Change the value of the orclpassword attribute to the same value as the schema name. For example, if wireless is the schema name, change the orclpassword attribute value to wireless.

    • Change the orclflexattribute1 to false.

    Click Apply.

    Perform these steps for all of your schemas except ODS and OEM_REPOSITORY.

  6. Login to the database location where the OracleAS Randomize Password Configuration Assistant failure is occurring.

  7. Run the following SQL script:

    SQL> $ORACLE_HOME/assistants/dbca/admin/unlock.sql

  8. Rerun the OracleAS Randomize Password Configuration Assistant.

B.4.5 OC4J Instance Configuration Assistant Errors

If the OC4J Instance Configuration Assistant fails with the following error:

Adding dependent libraries for application 'portal'...done. 
Deploying application 'oraudrepl' to OC4J instance 'OC4J_Portal'... 
ERROR: Caught exception during deploy. 
java.rmi.RemoteException: deploy failed!: ; nested exception is: 
oracle.oc4j.admin.internal.DeployerException: User specified for 
application-client uddirepl, 'uddi_replicator' not found 
at com.evermind.server.rmi.RMIConnection.
EXCEPTION_ORIGINATES_FROM_THE_REMOTE_SERVER(RMIConnection.java:1520)
... lines omitted ...

check that your Oracle Internet Directory was upgraded successfully.

This error is seen when you are installing a middle tier against an Oracle Internet Directory that was upgraded from 9.2.0.x to 10g (9.0.4), but not all the upgrade steps were completed. Make sure you followed the steps on upgrading Oracle Internet Directory 9.2.0.x to 10g (9.0.4) as documented in the Oracle Application Server 10g Upgrading to 10g (9.0.4) guide. The instructions are in the "Upgrading the Identity Management Services" chapter.

B.4.6 UDDI Configuration Assistant Errors

If the UDDI Configuration Assistant fails with the following error:

WARN UddiCA: The DAS Public Group entry cannot be found. Users cannot be
assigned to the group uddi_unlimited_quota_group via DAS application. 
javax.naming.NoPermissionException: [LDAP: error code 50 - Insufficient Access 
Rights]; remaining name 'cn=default,cn=PublicGroups,cn=User Configuration,
cn=Attribute Configuration,cn=DAS,cn=Products,cn=OracleContext,dc=oracle,dc=com' 
at com.sun.jndi.ldap.LdapCtx.mapErrorCode(LdapCtx.java:2953)
... lines omitted ...

check that your Oracle Internet Directory was upgraded successfully.

This error is seen when you are installing a middle tier against an Oracle Internet Directory that was upgraded from 9.2.0.x to 10g (9.0.4), but not all the upgrade steps were completed. Make sure you followed the steps on upgrading Oracle Internet Directory 9.2.0.x to 10g (9.0.4) as documented in the Oracle Application Server 10g Upgrading to 10g (9.0.4) guide. The instructions are in the "Upgrading the Identity Management Services" chapter.

B.4.7 Portal Configuration Assistant Errors

If the Portal Configuration Assistant fails with the following error:

Added DBA group as owner to DAS privilege group OracleDASDeleteUser. 
Error in add_member_to_privilege_group 
LDAP Error: 50: Insufficient access 
p_group_dn: cn=oracledasuserpriv,cn=groups,cn=oraclecontext,dc=oracle,dc=com 
p_member_dn: cn=dba,cn=portal.031111.0449,cn=groups,dc=oracle,dc=com 
ERROR: Could not add DBA group to DAS privilege group OracleDASUserPriv. 
Error in add_owner_to_privilege_group 
LDAP Error: 50: Insufficient access 
p_group_dn: cn=oracledasuserpriv,cn=groups,cn=oraclecontext,dc=oracle,dc=com 
p_member_dn: cn=dba,cn=portal.031111.0449,cn=groups,dc=oracle,dc=com 
ERROR: Could not add DBA group as owner to DAS privilege group 
OracleDASUserPriv 
... 
Error in add_member_to_privilege_group 
LDAP Error: 50: Insufficient access 
p_group_dn: 
cn=oracledascreategroup,cn=groups,cn=oraclecontext,dc=oracle,dc=com 
p_member_dn: 
cn=portal_administrators,cn=portal.031111.0449,cn=groups,dc=oracle,dc=com 
ERROR: Could not add portal_administrators group to DAS privilege group 
OracleDASCreateGroup.

check that your Oracle Internet Directory was upgraded successfully.

This error is seen when you are installing a middle tier against an Oracle Internet Directory that was upgraded from 9.2.0.x to 10g (9.0.4), but not all the upgrade steps were completed. Make sure you followed the steps on upgrading Oracle Internet Directory 9.2.0.x to 10g (9.0.4) as documented in the Oracle Application Server 10g Upgrading to 10g (9.0.4) guide. The instructions are in the "Upgrading the Identity Management Services" chapter.

B.5 Descriptions of Oracle Application Server Configuration Assistants

Table B-1 lists the Oracle Application Server configuration assistants in alphabetical order. Different installations use different configuration assistants depending on installation type and configuration options you selected.

Table B-1 Oracle Application Server Configuration Assistants

Configuration Assistant Description Log File Location
Application Server Control Configuration Assistant The Application Server Control Configuration Assistant starts the Oracle Management Agent and the Application Server Control to deploy applications through the Oracle Enterprise Manager Application Server Control.
NA
BC4J Configuration Assistant The BC4J Configuration Assistant integrates BC4J with the Oracle Enterprise Manager Application Server Control.

This configuration assistant requires the presence of the ORACLE_HOME/jlib/ emConfigInstall.jar file to operate.

NA
Database Migration Assistant The Database Migration Assistant migrates the 9.0.2 infrastructure database to an 10g (9.0.4) infrastructure database.

The database must be up and running prior to running this migration assistant.

ORACLE_HOME/config/ infratool_dcm_repository.log
Database- managed OracleAS Cluster Assistant Enables cluster configuration for selected databases.
NA
Delegated Administration Service (DAS) Configuration Assistant The DAS Configuration Assistant sets up the DAS URL in Oracle Internet Directory and adds the necessary access control privileges to the DAS entity.

The Infrastructure Instance Configuration Assistant must have run previous to using this configuration assistant.

ORACLE_HOME/ldap/log/oidca.log
DCM Repository Backup Assistant The DCM Repository Backup Assistant enables you to back up your DCM repository.
NA
Directory Integration Platform Configuration Assistant The Directory Integration Platform Configuration Assistant registers and starts the directory integration server when configured with Oracle Internet Directory.

Oracle Internet Directory must be configured prior to using this configuration assistant.

ORACLE_HOME/cfgtoollogs/
ORACLE_HOME/ldap/log/oidca.log 
Discoverer Configuration Assistant The Discoverer Configuration Assistant:
  • reads the contents of the discoconfig5.properties file

  • adds entries to the tartgets.xml file

  • adds a provider with a few parameters

  • adds an entry to opmn.xml

  • reloads OPMN

  • registers the Discoverer session

ORACLE_HOME/oraInventory/logs/ installActions<time.stamp>.log
Forms Configuration Assistant The Forms Configuration Assistant configures the OracleAS Forms Services server and integrates OracleAS Forms Services with Oracle Enterprise Manager Application Server Control.

The OracleAS Infrastructure 10g must be up and running before running this configuration assistant. It adds an entry to targets.xml file.

ORACLE_HOME/forms90/config/ formsConfig.log
HTTP Server Configuration Assistant The HTTP Server Configuration Assistant configures Oracle HTTP Server and registers it with the Oracle Enterprise Manager Application Server Control.
ORACLE_HOME/Apache/Apache/httpd.log
Infrastructure Instance Configuration Assistant The Infrastructure Instance Configuration Assistant updates the ORACLE_HOME/config/ias.properties file, registers the instance in Oracle Internet Directory and creates the ldap.ora file with Oracle Internet Directory credentials in the ORACLE_HOME/network/admin file.

The shared library path environment variable must be set to ORACLE_HOME/lib and ORACLE_HOME/network/lib directories before using this configuration assistant.

Table 4-15 lists the shared library path environment variables for different platforms

ORACLE_HOME/config/ infratool_instance_jazn.log
Infrastructure mod_osso Configuration Assistant. The Infrastructure mod_osso Configuration Assistant registers mod_osso during installation. It plugs mod_osso into Oracle HTTP Server and provides integration with OracleAS Single Sign-On to authenticate users.This registration enables Oracle HTTP Server installed with OracleAS Infrastructure to act as a partner application to OracleAS Single Sign-On. Applications that run under Oracle HTTP Server can register and protect their URL with mod_osso. When the URL is requested, mod_osso authenticates the user with OracleAS Single Sign-On to allow access to the URL. ORACLE_HOME/config/ infratool_mod_osso.log
Infrastructure Schema Configuration Assistant The Infrastructure Schema Configuration Assistant registers the Infrastructure schemas in the Oracle Internet Directory.

The shared library path environment variable must be set to ORACLE_HOME/lib and ORACLE_HOME/network/lib directories before using this configuration assistant.

Table 4-15 lists the shared library path environment variables for different platforms

Additionally, the Internet Directory Configuration Assistant and the Database Configuration Assistant must have run successfully before using this configuration assistant.

ORACLE_HOME/config/scemaload.log
Infrastructure Upgrade Instance Configuration Assistant The Infrastructure Upgrade Instance Configuration Assistant removes ACL entries on the SSO Schema.

The shared library path environment variable must be set to ORACLE_HOME/lib and ORACLE_HOME/network/lib directories before using this configuration assistant.

Table 4-15 lists the shared library path environment variables for different platforms

ORACLE_HOME/config/ infratool_infra_upgrade.log
Internet Directory Configuration Assistant The Internet Directory Configuration Assistant initiates the Oracle Internet Directory server. It then loads the LDAP schemas used by Oracle Application Server components and sets up Identity Management for the enterprise.

The infrastructure database creation must be complete, the listener must be up and running, and the tnsnames.ora file must be configured before using this configuration assistant.

ORACLE_HOME/ldap/log/oidca.log
Java Security Configuration Assistant The Java Security Configuration Assistant changes default password and sets and reassigns new passwords for JAAS security.
ORACLE_HOME/cfgtoollogs/jaznca.log
OC4J Configuration Assistant The OC4J Configuration Assistant integrates OC4J with the Oracle Enterprise Manager Application Server Control. It uses the Oracle Enterprise Manager Application Server Control-provided APIs to perform the following steps:
  • Add entries to the targets.xml file

  • Add entries to the iasadmin.properties file

  • This configuration assistant is dependent on the presence of the deploy.ini file.

NA
OC4J Instance Configuration Assistant The OC4J Instance Configuration Assistant configures OC4J instances for deployed Oracle Application Server applications. NA
OPMN Configuration Assistant The OPMN Configuration Assistant starts OPMN and OPMN-managed processes. ORACLE_HOME/opmn/logs/opmn.log
OPMN Configuration Assistant- start Oracle HTTP Server Starts Oracle HTTP Server through OPMN.
ORACLE_HOME/opmn/logs/HTTP_Server.log
OPMN Configuration Assistant- start DAS instance Starts DAS instance through OPMN.
ORACLE_HOME/opmn/logs/opmn.log
Oracle Application Server Instance Configuration Assistant Adds entry to ORACLE_HOME/config/target2add.xml file.
NA
Oracle Database Configuration Assistant The Oracle Database Configuration Assistant configures the OracleAS Metadata Repository for Infrastructure use. NA
Oracle Net Configuration Assistant The Oracle Net Configuration Assistant configures the database listener and configures the mid-tier Oracle Application Server instances to use the LDAP naming by default. ORACLE_HOME/oraInventory/logs/ installActions<time.stamp>.log
Oracle mod_osso Configuration Assistant The Oracle mod_osso Configuration Assistant registers mod_osso during installation. It plugs mod_osso into Oracle HTTP Server and provides integration with OracleAS Single Sign-On to authenticate users. This registration enables Oracle HTTP Server installed with the Oracle Application Server middle-tier to act as a partner application toOracleAS Single Sign-On.Applications running under Oracle HTTP Server can register and protect their URL with mod_osso. When the URL is requested, mod_osso authenticates the user with OracleAS Single Sign-On to allow access to the URL. ORACLE_HOME/config/ j2ee_mod_osso.log
OracleAS Randomize Password Configuration Assistant The OracleAS Randomize Password Configuration Assistant changes the default password of all schemas. NA
OracleAS Instance Configuration Assistant The OracleAS Instance Configuration Assistant adds Oracle Application Server instance name into the ORACLE_HOME/config/ targets2add.xml file
NA
Personalization Configuration Assistant The Personalization Configuration Assistant configures OracleAS Personalization.
NA
Portal Configuration Assistant The Portal Configuration Assistant configures the installed instance of OracleAS Portal.

The OracleAS Infrastructure 10g must be up and running before using this configuration assistant.

ORACLE_HOME/assistants/opca/install.log
Register DCM Plug-Ins With EM Configuration Assistant Registers DCM plug-ins with Enterprise Manager. NA
Reports Configuration Assistant The Reports Configuration Assistant configures the OracleAS Reports Services server and integrates OracleAS Reports Services with Oracle Enterprise Manager Application Server Control.

The OracleAS Infrastructure 10g must be up and running before using this configuration assistant.

ORACLE_HOME/reports/config/ reportsConfig.log
Single Sign-On Configuration Assistant The Single Sign-On Configuration Assistant configures OracleAS Single Sign-On.

Oracle Internet Directory, OracleAS Metadata Repository, and the Repository API must be configured before you can use this configuration assistant.

ORACLE_HOME/sso/log/ssoca.log
ORACLE_HOME/sso/log/ssoreg.log
Ultrasearch Configuration Assistant The Ultrasearch Configuration Assistant performs the following:
  • Deploys and configures Oracle Ultra Search within the Oracle Application Server middle-tier.

  • Creates Oracle Ultra Search back-end application entities and Oracle Ultra Search administration privilege groups.

  • Creates application entities for the Oracle Ultra Search middle-tier.

  • Upgrades Oracle Ultra Search metadata stored in the Identity Management Infrastructure.

  • Cleans up all the Oracle Ultra Search metadata stored in the Identity Management Infrastructure.

ORACLE_HOME/assistants.opca/ ultrasearchInst.log

(Identity Management Configuration:
ORACLE_HOME/cfgtoollogs/isearchca.log

Use Metadata Repository Configuration Assistant The Use Metadata Repository Configuration Assistant configures OracleAS Metadata Repository information for the Oracle Application Server middle-tier installation. This includes the ability to expand the J2EE and Web Cache install type with the Identity Management option enabled to a another installation type.

The shared library path environment variable must be set to ORACLE_HOME/lib and ORACLE_HOME/network/lib directories before using this configuration assistant.

Table 4-15 lists the shared library path environment variables for different platforms

ORACLE_HOME/config/ infratool_midtier_upgrade.log
Web Cache Configuration Assistant The Web Cache Configuration Assistant configures OracleAS Web Cache and registers it with Oracle Enterprise Manager Application Server Control.
ORACLE_HOME/webcache/log/log.xml
Wireless Configuration Assistant The Wireless Configuration Assistant configures OracleAS Wireless.
ORACLE_HOME/wireless/logs/ wireless_CA.out
Wireless Development Kit Configuration Assistant The Wireless Development Kit Configuration Assistant configures the Wireless Development Kit.
ORACLE_HOME%/wireless/logs/wdk_ca.out