B Troubleshooting the Installation

Occasionally, problems occur during an installation. This chapter contains information that might help you resolves such problems.

This chapter contains the following sections:

What Happens During Installation
Resolving Problems

B.1 What Happens During Installation

Installation of Oracle WSM consists of the following steps:

Oracle Universal Installer validates the information you specified, then installs files. One of the files it creates is install.properties, located in ORACLE_HOME\owsm\bin.
Oracle Universal Installer invokes the Oracle WSM Configuration Assistant, which modifies and creates files based on the contents of install.properties.
In a Basic installation, the Configuration Assistant starts and stops the Oracle Containers for J2EE server and the Oracle Database Lite server.

B.2 Resolving Problems

This section lists some problems that you might encounter when installing Oracle Web Services Manager.

If the installation cannot proceed, it typically displays a dialog box containing information about the problem. If necessary, scroll up in the text field to see the relevant information. In some cases, if you correct the problem and click Retry, the installation will proceed normally.

B.2.1 Installer Does Not Appear

Problem

On a Windows system, the installer does not appear when you run setup.exe. An Oracle Database is running on the machine

Solution

If you are installing Oracle Web Services Manager on a Windows computer that is already running Oracle Database, then you must start up the installer with the following option:

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

B.2.2 Connection Problems During Installation

The most common problems during installation are due to an inability to connect to Oracle Application Server or an inability to connect to the database.

Problem

Inability to connect to Oracle Application Server

Solution

In an Advanced installation, this can occur if the preexisting Oracle Application Server is not running. Restart the server and click Retry.

Solution

If the credentials are wrong or the instance name is incorrect, update install.properties, restart the server and click Retry.

Problem

Inability to connect to the database.

Solution

In an Advanced installation, this can occur if the preexisting Oracle Database is not running. Restart the database and click Retry.

Solution

If the credentials, connection information, or service name is wrong, update install.properties, restart the server and click Retry

B.2.3 Restarting Installation After a Failure

Problem

You need to exit the installer to fix a problem, then restart the installation.

Solution

In some cases, you might have to exit Oracle Universal Installer to correct a more complex problem. Once you correct the problem, you can continue the installation by running the Oracle WSM Configuration Assistant, wsmadmin, from the command line. The command is:

ORACLE_HOME\owsm\bin\wsmadmin.bat install

on Windows and

ORACLE_HOME/owsm/bin/wsmadmin.sh install

on UNIX.

Note:

On Windows, Oracle Universal Installer uses the -oui option to wsmadmin.bat. You might see this option in a log file. Do not use the -oui option when you run wsmadmin.bat from the command line.