F Troubleshooting

This appendix describes solutions to common problems that you might encounter when installing Oracle Application Server. It contains the following sections:

• Section F.1, "Log Files"

• Section F.2, "General Troubleshooting Tips"

• Section F.3, "Installation Problems and Solutions"

• Section F.4, "Need More Help?"

F.1 Log Files

The installer writes the following log files:

• 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

F.2 General Troubleshooting Tips

If you encounter an error during installation:

• Read the Oracle Application Server Release Notes for the latest updates. The release notes are available with the platform-specific documentation. The most current version of the release notes is available on Oracle Technology Network (http://www.oracle.com/technology/documentation).

• Verify that your computer meets the requirements specified in Chapter 2, "Requirements".

• If you entered incorrect information on one of the installation screens, return to that screen by clicking Back until you see the screen.

• If a configuration assistant failed, check the log file for that configuration assistant. Section E.2, "Description of Oracle Application Server Configuration Assistants" lists the configuration assistants and the location of their log files. If you do not see log files from some configuration assistants in the ORACLE_HOME\cfgtoollogs directory, exit the installer. This causes the installer to copy the log files to that directory.

• If an error occurred while the installer is copying or linking files:

  1. Note the error and review the installation log files.

  2. Remove the failed installation by following the steps in Appendix D, "Deinstallation and Reinstallation".

  3. Correct the issue that caused the error.

  4. Restart the installation.

F.3 Installation Problems and Solutions

This section describes common installation problems and solutions:

• Section F.3.1, "Location of Log Files"

• Section F.3.2, "Installer Does Not Appear"

• Section F.3.3, "Unable to Clean Up a Failed Installation"

• Section F.3.4, "User Interface Does Not Display in the Desired Language, or Does Not Display Properly"

• Section F.3.5, "Unable to Run Oracle Application Server On-Network as Well as Off-Network"

• Section F.3.6, "Configuration Assistant Failures - General"

F.3.1 Location of Log Files

There are two sets of log files:

• The installer writes the following log files:

  • 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
  
  

• The configuration assistants write log files in the ORACLE_HOME\cfgtoollogs directory. The Oracle Content DB Configuration Assistant log file is located in ORACLE_HOME\content\log\ContentConfig.log

  Note that if you want to access the log files created by the configuration assistants, you need to exit the installer first. The log files are inaccessible if the installer is still in use.

F.3.2 Installer Does Not Appear

Problem

The installer does not appear when you run setup.exe.

Solution

If you are installing Oracle Application Server on a computer that is already running Oracle Database 10g, then you have to start up the installer with the following option:

E:\> setup.exe -J-Dsun.java2d.noddraw=true -Dsun.awt.nopixfmt=true

F.3.3 Unable to Clean Up a Failed Installation

If your installation was not successful, you have to deinstall it first before you can install Oracle Application Server again. Refer to Appendix D, "Deinstallation and Reinstallation" for instructions.

F.3.4 User Interface Does Not Display in the Desired Language, or Does Not Display Properly

Problem

Messages do not appear in the desired language, or messages are not displayed correctly

Solution

Currently Oracle Application Server does not support adding or removing languages after installation.

If you are serving non-English content, be sure you add all the languages that you need during installation. To add languages during installation, click the Product Languages button in the "Select Installation Type" screen. To see which languages are installed by default, see Section 3.2, "Installing Additional Languages".

If you are serving non-English content and forgot to click the Product Languages in the installation, the user interface might not display properly because the required fonts were not installed. You can fix this by contacting Customer Service for the requirement fonts.

F.3.5 Unable to Run Oracle Application Server On-Network as Well as Off-Network

Problem

You installed Oracle Application Server when the computer was connected to the network, and now you want to run it off-network.

Solution

If you want to run Oracle Application Server on-network as well as off-network, you need to install a loopback adapter. On computers with static IP address, when you go off-network, your Ethernet adapter will be down (ipconfig shows cable disconnected) and ipconfig cannot resolve that IP.

For details on loopback adapters, see Section 2.8.6, "Installing a Loopback Adapter".

F.3.6 Configuration Assistant Failures - General

This section describes general tips for troubleshooting configuration assistant failures. See the next sections for specific configuration assistant failures. See also Appendix E, "Configuration Assistants".

Problem

Configuration assistant failed.

Solution

Configuration assistants fail from a variety of causes. Some things you can check are:

• Check the log files for the failed configuration assistant to determine the problem. The log files are located in the ORACLE_HOME\cfgtoollogs directory.

• Fix the problem indicated in the log file, and click Retry to rerun the failed configuration assistant.

If the configuration assistant fails while running configuration assistant execution commands on the command line, then run the configuration assistant execution command again.

You can use the generated script file named configtoolcmds.pl located in the ORACLE_HOME\bin directory to run the failed configuration assistant again. The configtoolcmds.pl script is generated after you exit the installer. During silent or non-interactive installation, the configtoolcmds.pl script is generated immediately after configuration assistant failure.

Note:

The solution in this section does not apply to the Oracle Content DB Configuration Assistant. If the Oracle Content DB Configuration Assistant is stopped or fails, follow the steps in Section D.3, "Additional Deinstallation Tasks for Oracle Content DB" before attempting to install again. Do not click Retry.

You can find the Oracle Content DB Configuration Assistant log in the following location:

ORACLE_HOME/content/log/ContentConfig.log

F.4 Need More Help?

If this appendix does not solve the problem you encountered, try these other sources:

• Oracle Application Server Release Notes, available on the Oracle Technology Network (http://www.oracle.com/technology/documentation)

• OracleMetaLink (https://metalink.oracle.com)

If you do not find a solution for your problem, open a service request.