E Troubleshooting

E.1 General Troubleshooting Tips

If you encounter an error during installation:

• Read the Oracle Fusion Middleware Release Notes for the latest updates. 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 Section 2.1.1, "System Requirements and Certification".

• 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 by following the steps in Chapter 4, "Deinstalling Oracle SOA Suite".

  3. Correct the issue that caused the error.

  4. Restart the installation.

E.2 Troubleshooting Oracle Fusion Middleware Installation

This section contains solutions to common problems that you might encounter when installing Oracle Fusion Middleware. The following topics are covered:

• Section E.2.1, "Installation Log Files"

• Section E.2.2, "Configuration Log Files"

• Section E.2.3, "Configuring Oracle BAM with Custom Port Numbers"

• Section E.2.4, "Deploying Oracle SOA and Oracle BAM on Different Servers"

% ./config.sh -log=log_filename

G:\ config.cmd -log=log_filename

E.3 Invoking SOA Composites Over SSL

If Oracle WebLogic Server is configured to use custom trust key store, you must manually revise the setDomainEnv.cmd (for Windows)/setDomainEnv.sh (for UNIX) file so that the Djavax.net.ssl.trustStore parameter points to the custom trust keystore file. For example:

Djavax.net.ssl.trustStore=/myfolder/mystore/mytrustkeystore.jks

E.4 Synchronizing Clocks When Working with Clusters

Oracle SOA uses Quartz, which is an open source job-scheduling framework. When you are setting up clusters on multiple systems, Quartz requires that the clocks on all the systems be synchronized. For more information, refer to the following URL:

http://www.opensymphony.com/quartz/wikidocs/TutorialLesson11.html

Also refer to the Oracle Fusion Middleware Enterprise Deployment Guide for Oracle SOA Suite and Oracle Fusion Middleware High Availability Guide for more information about clustering in advanced topologies.

E.5 Using Data Sources with an SSL-Enabled Database

If you are using an SSL-enabled database, follow the instructions below so that your data sources will work with SSL connections:

1. Create a truststore and add the ./root/b64certificate.txt as a trusted certificate to the truststore using a keytool:

   keytool -importcert -trustcacerts -alias dbroot -keystore ./truststore -storepass welcome1 -file ./b64certificate.txt
   

2. In the WebLogic Server console, navigate to the "Connection Pool" tab of the data source you are using. Modify the following properties accordingly:

   1. Requires Authentication:

      javax.net.ssl.keyStore=keystore_password
      javax.net.ssl.keyStoreType=JKS
      javax.net.ssl.keyStorePassword=keystore_password
      javax.net.ssl.trustStore=truststore_location
      javax.net.ssl.trustStoreType=JKS
      javax.net.ssl.trustStorePassword=truststore_password
      

   2. Does Not Require Authentication:

      javax.net.ssl.trustStore=truststore_location
      javax.net.ssl.trustStoreType=JKS
      javax.net.ssl.trustStorePassword=truststore_password
      

3. In the URL field, enter the following:

   jdbc:oracle:thin:@(DESCRIPTION=(ADDRESS_LIST=(ADDRESS=(PROTOCOL=TCPS)(HOST=database_host)(PORT=database_port)))(CONNECT_DATA=(SERVICE_NAME=service_name))(SECURITY=(SSL_SERVER_CERT_DN="distinguished_name"
   )))
   

4. In the JDBC data source files, modify the <property> parameter as shown below:

   <property>
   @ <name>javax.net.ssl.trustStorePassword</name>
    <value>truststore_password</value>
   </property>
   

E.6 Extending an Identity Management Domain with a SOA Installation

If you create a domain by installing Oracle Identity Management, then extend it by installing Oracle SOA Suite, the Oracle SOA installer changes the ORACLE_HOME environment variable. This breaks the Oracle Identity Federation (OIF) WebLogic Scripting Tool (WLST) environment, which relies on the value of ORACLE_HOME as set by the Identity Management installation.

To work around this issue, do the following:

1. Follow the instructions in "Setting up the WLST Environment" in Oracle Fusion Middleware Administrator's Guide for Oracle Identity Federation.

2. Copy all of the .py files in the OIF_ORACLE_HOME/fed/script (on UNIX) or OIF_ORACLE_HOME\fed\script (on Windows) directory to the WebLogic_Home/common/wlst (on UNIX) or WebLogic_Home\common\wlst (on Windows) directory.

3. Append the OIF_ORACLE_HOME/fed/script (on UNIX) or OIF_ORACLE_HOME\fed\script (on Windows) directory to the CLASSPATH environment variable.

E.7 Need More Help?

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

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

• My Oracle Support (formerly OracleMetaLink: http://metalink.oracle.com)

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