Oracle9i Application Server Installation Guide Release 2 (9.0.3) for AIX-Based Systems, HP 9000 Series HP-UX, HP Tru64 UNIX, and Linux Intel Part Number B10225-04 |
|
This appendix describes some methods for troubleshooting your Oracle9i Application Server Release 2 (9.0.3) (Oracle9iAS 9.0.3) installation. It includes the following topics:
Oracle recommends reviewing the following for troubleshooting your Oracle9iAS 9.0.3 installation:
Note the following information before performing any of the troubleshooting steps in this appendix:
Review the following sections, which specifically describe requirements and preinstallation tasks:
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
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:
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.
prompt> swap -a swap_file_name
prompt> swap -s
If you encounter an error during installation of Oracle9iAS 9.0.3:
To troubleshoot an installation error that occurs when the Oracle9iAS Configuration Assistants are running:
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/installActions
timestamp.log
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.
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:
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:
The BC4J Configuration Assistant integrates BC4J with the Oracle Enterprise Manager Web site.
ORACLE_HOME/sysman/emd/targets.xml
None.
Remove all BC4J entries from the configuration files above, if they exist.
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
None.
The Clickstream Collector Agent Configuration Assistant integrates the Oracle9iAS Clickstream Collector Agent with the Oracle Enterprise Manager Web site.
ORACLE_HOME/sysman/emd/targets.xml ORACLE_HOME/sysman/webapps/emd/WEB-INF/config/consoleConfig.xml ORACLE_HOME/dcm/config/sysmgmtProperties.xml
None.
Remove all Oracle9iAS Clickstream Collector Agent entries in the configuration files above.
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
Infrastructure Use Configuration Assistant
The DCM Repository Backup Assistant enables you to back up your DCM repository.
None.
ORACLE_HOME/dcm/logs/dcmctl_logs/log.xml ORACLE_HOME/dcm/logs/emd_logs/log.xml
None.
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. |
None.
The Enterprise Manager Web site Configuration Assistant configures Oracle9iAS components to deploy applications through the Oracle Enterprise Manager Web site.
None.
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
None.
ORACLE_HOME/bin/emctl start -silent
None.
The HTTP Server Configuration Assistant adds the Oracle HTTP Server target to the ORACLE_HOME
/sysman/emd/targets.xml
file.
ORACLE_HOME/sysman/emd/targets.xml
None.
Remove the Oracle HTTP Server target from targets.xml
.
ORACLE_HOME/jdk/bin/java -jar ORACLE_HOME/jlib/emConfigInstall.jar \ targets ORACLE_HOME/Apache/Apache/conf/ohstarget.xml
None.
The Infrastructure Use Configuration Assistant enables Oracle9iAS 9.0.3 usage with Oracle9iAS Infrastructure 9.0.2.
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/useinfratool.log ORACLE_HOME/dcm/logs/dcmctl_logs/log.xml ORACLE_HOME/dcm/logs/emd_logs/log.xml
ORACLE_HOME
/config/infratool.properties
in a text editor.
$0
to $-1
.
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
None.
The Java Security Configuration Assistant sets and reassigns new passwords for JAAS security.
ORACLE_HOME/j2ee/home/config/jazn_data.xml
None.
Set the library path environment variable to ORACLE_HOME
/lib
.
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:
" |
None.
The OC4J Configuration Assistant integrates OC4J with the Oracle Enterprise Manager Web site.
ORACLE_HOME/sysman/emd/targets.xml
None.
None.
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
None.
The OC4J Instance Configuration Assistant configures OC4J instances for deployed Oracle9iAS applications.
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
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
prompt> ORACLE_HOME/opmn/bin/opmnctl stopall
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
deploy.ini
does not exist in the ORACLE_HOME
/j2ee
directory, then rename deploy.ini.
number
.bak
to deploy.ini
.
/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>
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
None.
The OPMN Configuration Assistant enables the monitoring of Oracle9iAS processes in the ORACLE_HOME
/opmn/conf/opmn.xml
file.
None.
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
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
ORACLE_HOME/opmn/bin/opmnctl startall
OC4J Instance Configuration Assistant
The Oracle9iAS Instance Configuration Assistant adds Oracle9iAS instance name into the targets.xml
file.
ORACLE_HOME/sysman/emd/targets.xml
None.
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>
ORACLE_HOME/jdk/bin/java -jar ORACLE_HOME/jlib/emConfigInstall.jar \ targets ORACLE_HOME/config/targets2add.xml
None.
The Oracle9iAS Web Cache Configuration Assistant establishes caching rules, listening ports, and security passwords.
ORACLE_HOME/config/ias.properties
ORACLE_HOME/webcache/logs/event_log ORACLE_HOME/webcache/logs/access_log
None.
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
None.
|
![]() Copyright © 2002 Oracle Corporation. All Rights Reserved. |
|