Oracle9i Application Server Installation Guide Release 2 (9.0.3) for Microsoft Windows Part Number B10005-01 |
|
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:
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
The total size of paging files must be at least 512 MB.
To review/change pagefile sizes:
Windows NT:
Windows 2000:
If you encounter an error during installation of Oracle9iAS 9.0.3:
Inventory_location
\logs\installActions
timestamp
.log
Inventory_location
\logs\oraInstall
timestamp
.err
Inventory_location
\logs\oraInstall
timestamp
.out
The default Inventory_location is:
C:\Program Files\Oracle\Inventory
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 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
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.
If the description of a configuration assistant includes an "Initial Tasks" section, then you must perform these tasks before running the assistant.
Note:
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 use different configuration assistants depending on configuration options.
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 ORACLE_HOME\sysman\config\iasadmin.properties
None.
Remove all BC4J entries from the configuration files above, if they exist.
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
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.
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
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 creates 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
.
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
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\ias.properties
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
.
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
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 Path
environment variable to include ORACLE_HOME
\lib
.
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:
" |
None.
The OC4J Configuration Assistant integrates OC4J with the Oracle Enterprise Manager Web site.
ORACLE_HOME\sysman\emd\targets.xml ORACLE_HOME\config\ias.properties
None.
None.
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
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
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
deploy.ini
does not exist in the ORACLE_HOME
\j2ee
directory, then rename deploy.ini.
number
.bak
to deploy.ini
.
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>
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
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.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
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>
Enter these lines as one command.
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\sysman\emd\targets.xml ORACLE_HOME\config\ias.properties
ORACLE_HOME\webcache\logs\event_log ORACLE_HOME\webcache\logs\access_log
None.
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
None.
|
![]() Copyright © 2002 Oracle Corporation. All Rights Reserved. |
|