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 |
|
![]() |
![]() |
This appendix lists some methods for troubleshooting your Oracle Application Server installation. It includes the following topics:
Review the following information before performing any of the troubleshooting steps in this appendix:
Ensure that the computer meets the requirements specified in Chapter 4, " Requirements".
Ensure that you have completed all of the pre-installation requirements specified in Chapter 4, " Requirements".
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 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
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.
Insert and mount the "OracleAS RepCA and Utilities" CD-ROM or the Oracle Application Server DVD.
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.
If you encounter an error during installation of Oracle Application Server:
If you entered incorrect information on one of the installation screens, return to that screen by clicking Back until you see the screen.
Exit the installer only if you want to access the component log files. The log files located ORACLE_HOME/cfgtoollogs
directory are inaccessible if the installer is still in use.
If you encounter an error while the installer is copying or linking files, perform the following tasks:
Note the error and review the installation logs for causes:
oraInventory_location
/logs/installActions
timestamp
.log
oraInventory_location
/logs/oraInstall
timestamp
.err
oraInventory_location
/logs/oraInstall
timestamp
.out
Remove the failed installation by following the steps in Appendix C, " Deinstallation and Reinstallation".
Correct the issue that caused the error.
Restart the installation.
To troubleshoot an installation error that occurs when the configuration assistants are running:
Review the installation log files listed in Section B.3, "What to Do If an Installation Error Occurs".
Review the configuration assistant log files located in the ORACLE_HOME
/cfgtoollogs
directory for a specific Oracle Application Server configuration assistant. Section B.5, "Descriptions of Oracle Application Server Configuration Assistants" also lists any other log file locations for a specific configuration assistant. Try to fix the issue that caused the error.
If you see a "Fatal Error. Reinstall" message, try to find the cause of the problem by analyzing the log files. Refer to Section B.4.3, "Fatal Errors" for further instructions.
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/installActions
timestamp.log
During installation, configuration assistants run when the Configuration Assistants screen appears. If a configuration assistant fails, try the following procedure to correct the problem:
Review the installation log files for this Oracle Application Server instance.
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".
Refer to the section describing the configuration assistants in Section B.5, "Descriptions of Oracle Application Server Configuration Assistants".
If the failing configuration assistant has any dependencies, then run the dependencies again. You must do this even if the dependency completed successfully.
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.
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.
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. |
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:
Deinstall the failed installation using the procedure described in Section C.1, "Deinstallation of 10g (9.0.4) Instances".
Correct the cause of the fatal error.
Reinstall Oracle Application Server.
If the fatal error reoccurs, then you must remove all Oracle installations from your computer.
The following steps describe how to rerun OracleAS Randomize Password Configuration Assistant:
Start Oracle Internet Directory Manager.
Enter the Oracle Internet Directory host, port, user name, and password.
Expand Entry Management > cn=OracleContext > cn=Products > cn=IAS > cn=IAS Infrastructure Databases.
Click orclreferencename=<your_globaldb_name
>
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
.
Login to the database location where the OracleAS Randomize Password Configuration Assistant failure is occurring.
Run the following SQL
script:
SQL> $ORACLE_HOME/assistants/dbca/admin/unlock.sql
Rerun the OracleAS Randomize Password Configuration Assistant.
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.
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.
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.
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 |
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:
|
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 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 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 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:
|
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:
|
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 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 |