C
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

C.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

C.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?

C.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

C.1.1.2 Verify Size of Pagefile

The total size of paging files must be at least 512 MB.

To review/change pagefile sizes:

Windows NT:

1. Select Start > Settings > Control Panel.

2. Double-click System.

3. Select the Performance tab.

4. Click Change to review/change the virtual memory setting.

Windows 2000:

1. Select Start > Settings > Control Panel.

2. Double-click System.

3. Select the Advanced tab.

4. Click Performance Options.

5. Click Change to review/change the virtual memory setting.

C.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 for causes:
     • Inventory_location\logs\installActionstimestamp.log

     • Inventory_location\logs\oraInstalltimestamp.err

     • Inventory_location\logs\oraInstalltimestamp.out

     The default Inventory_location is:

     C:\Program Files\Oracle\Inventory
     
     

  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.

C.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 C.1.2, "What to Do If An Installation Error Occurs" and the component log files in Section C.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 C.2.3, "Fatal Errors" for further instructions.

C.2.1 Configuration Assistant Failure

Oracle9iAS Configuration Assistant failures are noted at the bottom of the Installation screen. The Oracle9iAS Configuration Assistant interface displays additional information, if applicable. The Oracle9iAS Configuration Assistant's 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:

C:\Program Files\Oracle\Inventory\logs\installActionstimestamp.log

C.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 C.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 the description of a configuration assistant includes an "Initial Tasks" section, then you must perform these tasks before running the assistant.

C.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.3, "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.4, "Deinstalling by Manually Removing All Oracle Products".

C.3 Descriptions of Oracle9iAS Configuration Assistants

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

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

C.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
ORACLE_HOME\sysman\config\iasadmin.properties

Writes to the Following Log Files

None.

Initial Tasks

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

Command Line

Enter these lines as one command. Note: do not enter any space characters before or after the semicolons (;) that separate the paths in the -classpath option.

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.

C.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

Enter these lines as one command. Note: do not enter any space characters before or after the semicolons (;) that separate the paths in the -classpath option.

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

C.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 creates it. If backup_directory exists, then it must be empty. If it is not empty, then the assistant will fail.

Dependencies

None.

C.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.

C.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

Enter these lines as one command.

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

Dependencies

None.

C.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
ORACLE_HOME\config\ias.properties

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

Enter these lines as one command. Note: do not enter any space characters before or after the semicolons (;) that separate the paths in the -classpath option.

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.

C.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 Path environment variable to include ORACLE_HOME\lib.

Command Line

Enter these lines as one command. Note: do not enter any space characters before or after the semicolons (;) that separate the paths in the -classpath option.

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.

C.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 
ORACLE_HOME\config\ias.properties

Writes to the Following Log Files

None.

Initial Tasks

None.

Command Line

Enter these lines as one command. Note: do not enter any space characters before or after the semicolons (;) that separate the paths in the -classpath option.

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.

C.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 C.2.3, "Fatal Errors"

2. Shut down 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.

   If you get a "sharing violation" error message when deleting files from the ORACLE_HOME\dcm\repository directory, change all Oracle9iAS services to manual and reboot the machine. Then try deleting the files again.

   prompt> del ORACLE_HOME\dcm\repository\* 
   prompt> del ORACLE_HOME\dcm\config\dcm.conf 
   prompt> del ORACLE_HOME\opmn\conf\ons.conf 
   prompt> del ORACLE_HOME\j2ee\OC4J_* 
   prompt> del 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

Enter these lines as one command. Note: do not enter any space characters before or after the semicolons (;) that separate the paths in the -classpath option.

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.

C.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.log 
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

C.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

Enter these lines as one command.

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

Dependencies

None.

C.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\sysman\emd\targets.xml
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

Enter these lines as one command. Note: do not enter any space characters before or after the semicolons (;) that separate the paths in the -classpath option.

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.