B
Troubleshooting

This appendix lists some methods for troubleshooting your Oracle9i Application Server Release 2 (9.0.3) (Oracle9iAS 9.0.3) installation. It includes the following topics:

• Troubleshooting the Installation

• Troubleshooting Oracle9iAS Configuration Assistants

• Descriptions of Oracle9iAS Configuration Assistants

B.1 Troubleshooting the Installation

Oracle recommends reviewing the following for troubleshooting your Oracle9iAS 9.0.3 installation:

• Verify Hardware and Preinstallation Requirements

• What to Do If An Installation Error Occurs

B.1.1 Verify Hardware and Preinstallation Requirements

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

• Do the host specifications meet the requirements specified in Chapter 2, "Getting Started"?

  Review the following sections, which specifically describe requirements and preinstallation tasks:

  • Section 2.1, "Preinstallation Summary"

  • Section 2.2, "Hardware Requirements"

  • Section 2.3, "Operating System Requirements"

  • Section 2.5, "Preinstallation Tasks"

  • Section 2.6.2, "Oracle Universal Installer Prerequisite Checks"

• If your installation is using an Oracle9iAS Infrastructure, then was the infrastructure running during this installation?

B.1.1.1 Release Notes

Oracle recommends reading the Oracle9i Application Server 9.0.3 Release Notes prior to installing Oracle9iAS 9.0.3. Oracle9i Application Server 9.0.3 Release Notes are available with the platform-specific documentation. The latest version of the Release Notes are available on OTN at

http://otn.oracle.com/products/ias/content.html

B.1.1.2 Verify TMP or Swap Space

Use the following command to display free swap space:

prompt> swap -s

Your host must meet the minimum swap space requirement described in Section 2.2, "Hardware Requirements". If you do not have enough swap space, then perform the following tasks:

1. Login as the system root user.

2. Create an empty swap file using the following command:

   prompt> mkfile sizeM swap_file_name
   
   

   The minimum size of this file must be greater than the difference between the currently available swap space and required swap space. For example, if you have 100 MB of free swap space and the installation requires 256 MB, then this swap file must be at least 156 MB.

3. Add the file to the swap space using the following command:

   prompt> swap -a swap_file_name
   
   

4. Verify that the new swap space meets the requirements by running the following command:

   prompt> swap -s
   

B.1.2 What to Do If An Installation Error Occurs

If you encounter an error during installation of Oracle9iAS 9.0.3:

• When an error occurs, do not exit Oracle Universal Installer. This makes it easier to find the log files.

• If you entered incorrect information on one of the install screens during the interview phase, then you can return to previous installation screens by clicking Previous until you reach the screen you would like to edit.

• If you encounter an error while the installer is copying or linking files, then you must perform the following tasks:
  1. Note the error and review the installation logs at for causes:
     • oraInventory_location/logs/installActionstimestamp.log

     • oraInventory_location/logs/oraInstalltimestamp.err

     • oraInventory_location/logs/oraInstalltimestamp.out

  2. Remove the failed installation by following the steps in Chapter 5, "Deinstallation and Reinstallation".

  3. Correct the issue that caused the error.

  4. Start the Oracle9iAS 9.0.3 installation again.

B.2 Troubleshooting Oracle9iAS Configuration Assistants

To troubleshoot an installation error that occurs when the Oracle9iAS Configuration Assistants are running:

• Review the log files listed in Section B.1.2, "What to Do If An Installation Error Occurs" and the component log files in Section B.3, "Descriptions of Oracle9iAS Configuration Assistants". Try to fix the issue that caused the error.

• If you see a 'Fatal Error. Reinstall' message, then try to find the cause of the problem by analyzing the log files. Refer to Section B.2.3, "Fatal Errors" for further instructions.

B.2.1 Configuration Assistant Failure

Oracle9iAS Configuration Assistant failures are noted at the bottom of the Installation Screen. The Oracle9iAS Configuration Assistant interface, if applicable, displays additional information. The Oracle9iAS Configuration Assistant execution status will be identified by the result code called <exit-code>.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.2.2 Failure During Component Configuration and Startup

During installation, configuration assistants launch when the Configuration Tools screen appears. If a configuration assistant fails at this point, then try the following procedure to correct the problem.

1. Review the installation log files for this instance.

2. Review the log files for the configuration assistant.

3. Correct the problem that caused the failure.

4. Refer to the section describing the configuration assistant in Section B.3, "Descriptions of Oracle9iAS 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, then select the configuration assistant and click the Retry button. If you are running the configuration assistant from a command prompt, then run it using the command in the "Command Line" section of the description.

      Note: If a configuration assistant has an "Initial Tasks" section, then you must perform these tasks before running the assistant.

B.2.3 Fatal Errors

Some configuration assistant failures are "fatal errors." You will not be able to recover from a fatal error by correcting the problem and continuing. You must remove the current installation and then restart the process of installing Oracle9iAS 9.0.3. The following tasks describe the recovery procedure:

1. Deinstall the failed installation using the procedure in Section 5.1.1, "Deinstalling an Oracle9iAS 9.0.3 Instance".

2. Correct the issue that caused the fatal error.

3. Reinstall Oracle9iAS.

4. If the fatal error reoccurs, then you must remove all Oracle installations from your host using the procedure in Section 5.1.2, "Deinstalling by Manually Removing All Oracle Products".

B.3 Descriptions of Oracle9iAS Configuration Assistants

This section lists the Oracle9iAS Configuration Assistants in alphabetical order. Different installations will use different configuration assistants depending on configuration options. Refer to the

This section describes the following assistants:

• BC4J Configuration Assistant

• Clickstream Collector Agent Configuration Assistant

• DCM Repository Backup Assistant

• Enterprise Manager Web site Configuration Assistant

• HTTP Server Configuration Assistant

• Infrastructure Use Configuration Assistant

• Java Security Configuration Assistant

• OC4J Configuration Assistant

• OC4J Instance Configuration Assistant

• OPMN Configuration Assistant

• Oracle9iAS Instance Configuration Assistant

• Oracle9iAS Web Cache Configuration Assistant

B.3.1 BC4J Configuration Assistant

The BC4J Configuration Assistant integrates BC4J with the Oracle Enterprise Manager Web site.

Modifies the Following Configuration Files

ORACLE_HOME/sysman/emd/targets.xml

Writes to the Following Log Files

None.

Initial Tasks

Remove all BC4J entries from the configuration files above, if they exist.

Command Line

ORACLE_HOME/jdk/bin/java -classpath ORACLE_HOME/jlib/emConfigInstall.jar:\
ORACLE_HOME/jlib/repository.jar:\
ORACLE_HOME/sysman/webapps/emd/WEB-INF/lib/bc4joem.jar \
oracle.jbo.server.emd.ConfigOEM ORACLE_HOME instance_name.hostname.domain

Dependencies

None.

B.3.2 Clickstream Collector Agent Configuration Assistant

The Clickstream Collector Agent Configuration Assistant integrates the Oracle9iAS Clickstream Collector Agent with the Oracle Enterprise Manager Web site.

Modifies the Following Configuration Files

ORACLE_HOME/sysman/emd/targets.xml
ORACLE_HOME/sysman/webapps/emd/WEB-INF/config/consoleConfig.xml
ORACLE_HOME/dcm/config/sysmgmtProperties.xml

Writes to the Following Log Files

None.

Initial Tasks

Remove all Oracle9iAS Clickstream Collector Agent entries in the configuration files above.

Command Line

ORACLE_HOME/jdk/bin/java -classpath ORACLE_HOME/click/lib/click.jar:\
ORACLE_HOME/sysman/jlib/emConfigInstall.jar:\
ORACLE_HOME/jlib/emConfigInstall.jar:ORACLE_HOME/jlib/repository.jar \ 
oracle.click.common.OEMIntegrate ORACLE_HOME 

Dependencies

Infrastructure Use Configuration Assistant

B.3.3 DCM Repository Backup Assistant

The DCM Repository Backup Assistant enables you to back up your DCM repository.

Modifies the Following Configuration Files

None.

Writes to the Following Log Files

ORACLE_HOME/dcm/logs/dcmctl_logs/log.xml 
ORACLE_HOME/dcm/logs/emd_logs/log.xml 

Initial Tasks

None.

Command Line

ORACLE_HOME/dcm/bin/dcmctl saveInstance -dir backup_directory

Note: If backup_directory does not exist, then this configuration assistant will create it. If backup_directory exists, then it must be empty. If it is not empty then the assistant will fail.

Dependencies

None.

B.3.4 Enterprise Manager Web site Configuration Assistant

The Enterprise Manager Web site Configuration Assistant configures Oracle9iAS components to deploy applications through the Oracle Enterprise Manager Web site.

Modifies the Following Configuration Files

None.

Writes to the Following Log Files

ORACLE_HOME/sysman/log/em-servlet.log 
ORACLE_HOME/sysman/log/emd.log 
ORACLE_HOME/sysman/log/em.log 
ORACLE_HOME/sysman/log/server.log 
ORACLE_HOME/sysman/log/em-application.log 
ORACLE_HOME/sysman/log/em-web-access.log 
ORACLE_HOME/sysman/log/rmi.log 
ORACLE_HOME/dcm/logs/dcmctl_logs/log.xml 
ORACLE_HOME/dcm/logs/emd_logs/log.xml 

Initial Tasks

None.

Command Line

ORACLE_HOME/bin/emctl start -silent 

Dependencies

None.

B.3.5 HTTP Server Configuration Assistant

The HTTP Server Configuration Assistant adds the Oracle HTTP Server target to the ORACLE_HOME/sysman/emd/targets.xml file.

Modifies the Following Configuration Files

ORACLE_HOME/sysman/emd/targets.xml

Writes to the Following Log Files

None.

Initial Tasks

Remove the Oracle HTTP Server target from targets.xml.

Command Line

ORACLE_HOME/jdk/bin/java -jar ORACLE_HOME/jlib/emConfigInstall.jar \ 
targets ORACLE_HOME/Apache/Apache/conf/ohstarget.xml

Dependencies

None.

B.3.6 Infrastructure Use Configuration Assistant

The Infrastructure Use Configuration Assistant enables Oracle9iAS 9.0.3 usage with Oracle9iAS Infrastructure 9.0.2.

Modifies the Following Configuration Files

ORACLE_HOME/Apache/Apache/conf/httpd.conf
ORACLE_HOME/dcm/config/dcm.conf
ORACLE_HOME/dcm/repository/*
ORACLE_HOME/j2ee/home/config/jazn.xml

Writes to the Following Log Files

ORACLE_HOME/config/useinfratool.log
ORACLE_HOME/dcm/logs/dcmctl_logs/log.xml
ORACLE_HOME/dcm/logs/emd_logs/log.xml

Initial Tasks

1. Open ORACLE_HOME/config/infratool.properties in a text editor.

2. Change the flag at the end of each line from $0 to $-1.

Command Line

ORACLE_HOME/jdk/bin/java -classpath .:ORACLE_HOME/sso/lib/ossoreg.jar:\
ORACLE_HOME/jlib/ojmisc.jar:ORACLE_HOME/jlib/repository.jar:\
ORACLE_HOME/j2ee/home/jazn.jar:ORACLE_HOME/j2ee/home/jaas.jar:\
ORACLE_HOME/jdk/lib/dt.jar:ORACLE_HOME/jdk/lib/tools.jar:\
ORACLE_HOME/jlib/infratool.jar \
oracle.ias.configtool.UseInfrastructure \
-f ORACLE_HOME/config/infratool.properties \
-h hostname.domain -p OID_port -u cn=orcladmin -w oidadmin_password \ 
-s infrastructure_hostname.domain -r midtier_OHS_port \ 
-o ORACLE_HOME -m instance_name.hostname.domain \
-infra infrastructureDB_service_name

Dependencies

None.

B.3.7 Java Security Configuration Assistant

The Java Security Configuration Assistant sets and reassigns new passwords for JAAS security.

Modifies the Following Configuration Files

ORACLE_HOME/j2ee/home/config/jazn_data.xml

Writes to the Following Log Files

None.

Initial Tasks

Set the LD_LIBRARY_PATH environment variable to ORACLE_HOME/lib.

Command Line

ORACLE_HOME/jdk/bin/java \
-classpath ORACLE_HOME/dcm/lib/dcm.jar:ORACLE_HOME/j2ee/home/jazn.jar:\
ORACLE_HOME/j2ee/home/jaas.jar:ORACLE_HOME/j2ee/home/oc4j.jar:\
ORACLE_HOME/jlib/ojmisc.jar \ 
-Doracle.security.jazn.config=ORACLE_HOME/j2ee/home/jazn/install/jazn.xml \
oracle.security.jazn.util.JAZNInstallHelper -realm jazn.com \
-user admin -oldpwd welcome -newpwd new_password

Note: "welcome" is the default password when this assistant fails. If it completes successfully, then the assistant will store a more secure password in jazn_data.xml.

Dependencies

None.

B.3.8 OC4J Configuration Assistant

The OC4J Configuration Assistant integrates OC4J with the Oracle Enterprise Manager Web site.

Modifies the Following Configuration Files

ORACLE_HOME/sysman/emd/targets.xml 

Writes to the Following Log Files

None.

Initial Tasks

None.

Command Line

ORACLE_HOME/jdk/bin/java -classpath \ 
ORACLE_HOME/install/lib/oc4jcfg.jar:ORACLE_HOME/jlib/emConfigInstall.jar:\ 
ORACLE_HOME/jlib/repository.jar:ORACLE_HOME/lib/xmlparserv2.jar:\ 
ORACLE_HOME/jdbc/lib/classes12.zip:ORACLE_HOME/jdbc/lib/nls_charset12.jar:\ 
ORACLE_HOME/jlib/jndi.jar:ORACLE_HOME/jlib/rt.jar:ORACLE_HOME/jdk/lib/i18n.jar:\
ORACLE_HOME/jlib/ldapjclnt9.jar:ORACLE_HOME/jlib/ojmisc.jar:\ 
ORACLE_HOME/j2ee/home/jazn.jar:ORACLE_HOME/j2ee/home/jaas.jar  \ 
oc4jConfig -oh ORACLE_HOME 

Dependencies

None.

B.3.9 OC4J Instance Configuration Assistant

The OC4J Instance Configuration Assistant configures OC4J instances for deployed Oracle9iAS applications.

Modifies the Following Configuration Files

ORACLE_HOME/Apache/Apache/conf/mod_oc4j.conf
ORACLE_HOME/j2ee/OC4J_Demos/*
ORACLE_HOME/j2ee/home/application-deployments/* 
ORACLE_HOME/j2ee/home/applications/* 
ORACLE_HOME/j2ee/home/connectors/* 
ORACLE_HOME/j2ee/home/config/* 
ORACLE_HOME/j2ee/home/persistence/* 
ORACLE_HOME/dcm/config/dcm.conf 
ORACLE_HOME/dcm/repository/* 
ORACLE_HOME/opmn/conf/opmn.xml 
ORACLE_HOME/opmn/conf/ons.conf 

Writes to the Following Log Files

ORACLE_HOME/j2ee/OC4J_Demos/application-deployments/*/OC4J_Demos_default_island_1/application.log
ORACLE_HOME/j2ee/OC4J_Demos/log/OC4J_Demos_default_island_1/server.log
ORACLE_HOME/j2ee/OC4J_Demos/log/OC4J_Demos_default_island_1/global-application.log
ORACLE_HOME/j2ee/OC4J_Demos/log/OC4J_Demos_default_island_1/default-web-access.log
ORACLE_HOME/j2ee/OC4J_Demos/log/OC4J_Demos_default_island_1/jms.log
ORACLE_HOME/j2ee/OC4J_Demos/log/OC4J_Demos_default_island_1/rmi.log
ORACLE_HOME/opmn/logs/OC4J_Demos*
ORACLE_HOME/j2ee/home/log/home_default_island_1/server.log
ORACLE_HOME/j2ee/home/log/home_default_island_1/global-application.log
ORACLE_HOME/j2ee/home/log/home_default_island_1/default-web-access.log
ORACLE_HOME/j2ee/home/log/home_default_island_1/jms.log
ORACLE_HOME/j2ee/home/log/home_default_island_1/rmi.log
ORACLE_HOME/j2ee/home/application-deployments/*/home_default_island_1/application.log
ORACLE_HOME/opmn/logs/home*
ORACLE_HOME/dcm/logs/dcmctl_logs/log.xml
ORACLE_HOME/dcm/logs/emd_logs/log.xml
ORACLE_HOME/j2ee/home/log/log.xml

Initial Tasks

1. If your installation uses Oracle9iAS Infrastructure and the OC4J Instance Configuration Assistant fails, then there is a fatal error and you cannot recover without reinstalling.

   See Also: Section B.2.3, "Fatal Errors"

2. Shutdown opmn and all managed processes with the following command:

   prompt> ORACLE_HOME/opmn/bin/opmnctl stopall
   
   

3. Remove files from the failed deployment with the following command:

   prompt> rm -rf ORACLE_HOME/dcm/repository/* 
   prompt> rm -rf ORACLE_HOME/dcm/config/dcm.conf 
   prompt> rm -rf ORACLE_HOME/opmn/conf/ons.conf 
   prompt> rm -rf ORACLE_HOME/j2ee/OC4J_* 
   prompt> rm -rf ORACLE_HOME/j2ee/home/log/log.xml 
   
   

4. If deploy.ini does not exist in the ORACLE_HOME/j2ee directory, then rename deploy.ini.number.bak to deploy.ini.

5. In ORACLE_HOME/opmn/conf/opmn.xml remove sections related to all OC4J instances except for the home instance. For example, the section for the OC4J.Demos instance looks like the following:

   <oc4j instanceName="OC4J_Demos" gid="OC4J_Demos"> 
      .... 
   </oc4j> 
   

Command Line

ORACLE_HOME/jdk/bin/java -mx512M \
-classpath ORACLE_HOME/j2ee/home/jaznplugin.jar:ORACLE_HOME/j2ee/home/jazn.jar:\
ORACLE_HOME/jlib/emConfigInstall.jar:ORACLE_HOME/lib/xmlparserv2.jar:\
ORACLE_HOME/lib/xschema.jar:ORACLE_HOME/dcm/lib/dcm.jar:\
ORACLE_HOME/jdbc/lib/classes12.jar:ORACLE_HOME/lib/dms.jar:\
ORACLE_HOME/j2ee/home/oc4j.jar:ORACLE_HOME/opmn/lib/ons.jar:\
ORACLE_HOME/dcm/lib/oc4j_deploy_tools.jar \
-Doracle.ias.sysmgmt.logging.logdir=ORACLE_HOME/j2ee/home/log \
oracle.j2ee.tools.deploy.Oc4jDeploy \
-oraclehome ORACLE_HOME -verbose -inifile ORACLE_HOME/j2ee/deploy.ini

Dependencies

None.

B.3.10 OPMN Configuration Assistant

The OPMN Configuration Assistant enables the monitoring of Oracle9iAS processes in the ORACLE_HOME/opmn/conf/opmn.xml file.

Modifies the Following Configuration Files

None.

Writes to the Following Log Files

ORACLE_HOME/Apache/Apache/logs/error_log 
ORACLE_HOME/Apache/Apache/logs/ssl_engine_log 
ORACLE_HOME/Apache/Apache/logs/access_log 
ORACLE_HOME/Apache/Apache/logs/ssl_request_log 
ORACLE_HOME/opmn/logs/HTTP Server.1og 
ORACLE_HOME/j2ee/home/log/home_default_island_1/server.log 
ORACLE_HOME/j2ee/home/log/home_default_island_1/global-application.log 
ORACLE_HOME/j2ee/home/log/home_default_island_1/default-web-access.log 
ORACLE_HOME/j2ee/home/log/home_default_island_1/jms.log 
ORACLE_HOME/j2ee/home/log/home_default_island_1/rmi.log 
ORACLE_HOME/j2ee/home/application-deployments/*/home_default_island_1/application.log 
ORACLE_HOME/opmn/logs/home.default_island.1 
ORACLE_HOME/j2ee/OC4J_Demos/application-deployments/*/OC4J_Demos_default_island_1/application.log
ORACLE_HOME/j2ee/OC4J_Demos/log/OC4J_Demos_default_island_1/server.log 
ORACLE_HOME/j2ee/OC4J_Demos/log/OC4J_Demos_default_island_1/global-application.log 
ORACLE_HOME/j2ee/OC4J_Demos/log/OC4J_Demos_default_island_1/default-web-access.log 
ORACLE_HOME/j2ee/OC4J_Demos/log/OC4J_Demos_default_island_1/jms.log 
ORACLE_HOME/j2ee/OC4J_Demos/log/OC4J_Demos_default_island_1/rmi.log 
ORACLE_HOME/opmn/logs/OC4J_Demos.default_island.1 
ORACLE_HOME/opmn/logs/ons.log
ORACLE_HOME/opmn/logs/ipm.log

Initial Tasks

If there are any opmn.exe processes running in the current ORACLE_HOME, then stop them by running the following command:

prompt> ORACLE_HOME/opmn/bin/opmnctl stopall 

Command Line

ORACLE_HOME/opmn/bin/opmnctl startall

Dependencies

OC4J Instance Configuration Assistant

B.3.11 Oracle9iAS Instance Configuration Assistant

The Oracle9iAS Instance Configuration Assistant adds Oracle9iAS instance name into the targets.xml file.

Modifies the Following Configuration Files

ORACLE_HOME/sysman/emd/targets.xml

Writes to the Following Log Files

None.

Initial Tasks

Remove the following entry from targets.xml:

<Target TYPE="oracle_ias" NAME="instance_name" VERSION="1.0"> 
   <Property NAME="OracleHome" VALUE="ORACLE_HOME" /> 
   <Property NAME="host" VALUE="hostname" /> 
</Target>

Command Line

ORACLE_HOME/jdk/bin/java -jar ORACLE_HOME/jlib/emConfigInstall.jar \ 
targets ORACLE_HOME/config/targets2add.xml

Dependencies

None.

B.3.12 Oracle9iAS Web Cache Configuration Assistant

The Oracle9iAS Web Cache Configuration Assistant establishes caching rules, listening ports, and security passwords.

Modifies the Following Configuration Files

ORACLE_HOME/config/ias.properties

Writes to the Following Log Files

ORACLE_HOME/webcache/logs/event_log
ORACLE_HOME/webcache/logs/access_log

Initial Tasks

None.

Command Line

ORACLE_HOME/jdk/bin/java -classpath \ 
ORACLE_HOME/sysman/webapps/emd/WEB-INF/lib/webcachecfg.jar:\ 
ORACLE_HOME/sysman/webapps/emd/WEB-INF/lib/emd.jar:\ 
ORACLE_HOME/jlib/emConfigInstall.jar:ORACLE_HOME/jlib/repository.jar:\ 
ORACLE_HOME/lib/xmlparserv2.jar:ORACLE_HOME/jdbc/lib/classes12.zip:\ 
ORACLE_HOME/jdbc/lib/nls_charset12.jar:ORACLE_HOME/jlib/jndi.jar:\ 
ORACLE_HOME/jlib/rt.jar:ORACLE_HOME/jdk/lib/i18n.jar:\ 
ORACLE_HOME/jlib/ldapjclnt9.jar:ORACLE_HOME/jlib/ojmisc.jar:\ 
ORACLE_HOME/j2ee/home/jazn.jar:ORACLE_HOME/j2ee/home/jaas.jar  \ 
oracle.ias.webcache.config.WebcacheConfig -oh ORACLE_HOME 

Dependencies

None.