D Troubleshooting the Installation

This appendix describes solutions to common problems that you might encounter when installing Oracle Service Bus. It contains the following topics:

General Troubleshooting Tips
Installation and Configuration Log Files
Need More Help?

D.1 General Troubleshooting Tips

If you encounter an error during installation:

Read the Oracle Fusion Middleware Release Notes for Linux x86 or Oracle Fusion Middleware Release Notes for Microsoft Windows (32-Bit) (depending on your platform) for the latest updates. The most current version of the release notes is available on the Oracle Fusion Middleware 11 g Release 1 (11.1.1) Documentation page on Oracle Technology Network:
```
http://www.oracle.com/technetwork/middleware/docs/middleware-093940.html
```
Click the View Library link for the documentation library corresponding to your release. The Release Notes are available in the library.
Verify your system and configuration is certified. Refer to the System Requirements and Supported Platforms for Oracle Fusion Middleware 11gR1 document on the Oracle Fusion Middleware Supported System Configurations page:
```
http://www.oracle.com/technology/software/products/ias/files/fusion_certification.html
```
Verify your system meets the minimum system requirements. Refer to the System Requirements and Specifications document:
```
http://www.oracle.com/technology/software/products/ias/files/fusion_requirements.htm
```
If you entered incorrect information on one of the installation screens, return to that screen by clicking Back until you see the screen.
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.
3. Correct the issue that caused the error.
4. Restart the installation.

D.2 Installation and Configuration Log Files

This section contains information about the log files that are created when running the Oracle Service Bus installer and the Oracle Fusion Middleware Configuration Wizard. Log files contain information that can help you troubleshoot problems with your installation or configuration.

D.2.1 Installation Log Files

The installer writes logs files to the Oracle_Inventory_Location/log (on UNIX operating systems) or Oracle_Inventory_Location\logs (on Windows operating systems) directory. On UNIX systems, if you do not know the location of your Oracle Inventory directory, you can find it in the OSB_ORACLE_HOME/oraInst.loc file. On Windows systems, the default location for the inventory directory is C:\Program Files\Oracle\Inventory\logs.

The following install log files are written to the log directory:

installdate-time-stamp.log

This is the main log file.
installdate-time-stamp.out

This log file contains the output and error streams during the installation.
installActionsdate-time-stamp.log

This file is used by the installer GUI to keep track of internal information.
installProfiledate-time-stamp.log

This log file contains the overall statistics like time taken to complete the installation, as well as configuration, memory and CPU details.
oraInstalldate-time-stamp.log

This log file contains the output stream of the copy session.

If you start the installer with the -printtime parameter, the timeTakendate-time-stamp.log and timedate-time-stamp.log files are created in the same directory:

timeTakendate-time-stamp.log

This file contains information for the amount of time taken to move between screens (applicable for GUI installations only).
timedate-time-stamp.log

This file contains time information for the copy session.

If you start the installer with the -printmemory parameter, the memorydate-time-stamp.log file is created. This file contains memory usage information for the copy session.

D.2.2 Configuration Log Files

To create a log file of your configuration session, start the Configuration Wizard with the -log option, as shown below:

On UNIX operating systems:

./config.sh -log=log_filename -log_priority=log_level

On Windows operating systems:

config.cmd -log=log_filename -log_priority=log_level

See Table D-1 for more details about the -log and -log_priority options.

Table D-1 Configuration Wizard Log File Options

Parameter Description

Parameter	Description
`-log`	Specify the location of your log file. If you specify an absolute path with your `log_filename` then your log file will be created there. If you only specify a file name with no path, then the log files are created in the `MW_HOME/logs` (on UNIX operating systems) or `MW_HOME\logs` (on Windows operating systems) directory. Other values that can be specified with `-log` are: `stdout` This writes the error message to the standard output stream. `stderr` This writes the error messages to the standard error stream. `disable` This disables default logging so that no log files are generated in `MW_HOME/logs` (on UNIX operating systems) or `MW_HOME\logs` (on Windows operating systems).
`-log_priority`	Specify the level of detail you want included in your logs. The acceptable values are listed below, from most detailed to least detailed: `debug` `info` `warning` `error` `fatal`

-log

Specify the location of your log file.

If you specify an absolute path with your log_filename then your log file will be created there. If you only specify a file name with no path, then the log files are created in the MW_HOME/logs (on UNIX operating systems) or MW_HOME\logs (on Windows operating systems) directory.

Other values that can be specified with -log are:

stdout

This writes the error message to the standard output stream.
stderr

This writes the error messages to the standard error stream.
disable

This disables default logging so that no log files are generated in MW_HOME/logs (on UNIX operating systems) or MW_HOME\logs (on Windows operating systems).

-log_priority

Specify the level of detail you want included in your logs.

The acceptable values are listed below, from most detailed to least detailed:

debug
info
warning
error
fatal

D.3 Need More Help?

If you cannot solve a problem using the information in this appendix, look for additional information in My Oracle Support (formerly MetaLink) at http://support.oracle.com.

If you cannot find a solution to your problem, open a service request.