Oracle E-Business Suite Integrated SOA Gateway Diagnostic Tests

Overview

The installation of Oracle E-Business Suite Integrated SOA Gateway requires number of manual setup tasks on both Oracle E-Business Suite and Oracle SOA Suite. To effectively identify any issues, Oracle E-Business Suite Integrated SOA Gateway provides a suite of diagnostic tests executed through a backend script to help determine specific causes or issues with installation steps.

This diagnostic test suite includes multiple tests with various test functions to check on both Oracle E-Business Suite and Oracle SOA Suite instances. For example, certain tests validate if correct versions of required software and libraries are installed, some tests check if needed patches are applied, or if issues are functional related, such as Generate, Deploy, or other design-time activities.

At the end of test run, a report will be generated which may contain corrective actions mostly regarding the installation of Oracle E-Business Suite Integrated SOA Gateway.

To have better understanding on the diagnostic tests and how the test suite is executed, the following topics are included in this chapter:

Understanding the Usage of Backend Script $JAVA_TOP/oracle/apps/fnd/isg/ant/isgDesigner.xml

Oracle E-Business Suite Integrated SOA Gateway uses an Ant script $JAVA_TOP/oracle/apps/fnd/isg/ant/isgDesigner.xml to run the diagnostic tests through backend processing.

Note: Please note that $JAVA_TOP/oracle/apps/fnd/isg/ant/isgDesigner.xml is a multipurpose script. It can also be used to execute the design-time activities such as generate, regenerate, deploy, undeploy, activate, retire, and reset services as well as to upgrade or postclone services from command line.

For more information on how to use the script to perform design-time activities, see Managing SOAP Service Life Cycle Activities Using An Ant Script and Managing REST Service Life Cycle Activities Using An Ant Script.

Running Diagnostic Tests

Use the backend script isgDesigner.xml to run complete diagnostic tests on both Oracle E-Business Suite and Oracle SOA Suite with the following syntax:

ant -f $JAVA_TOP/oracle/apps/fnd/isg/ant/isgDesigner.xml DiagnoseISGSetup

Alternatively, use the same script supplying with different targets to run the configuration checks for various purposes. For example, use the test to check only on the Oracle E-Business Suite side or the Oracle SOA Suite side, or to test the design-time operations of Oracle E-Business Suite Integrated SOA Gateway for all types of interfaces.

Use the following commands to run diagnostic tests depending on your needs:

After each test run, a report DiagnosticsReport.xml will be generated as a result. The generated report will have test name, status, and message if test is failed. Message will convey the information that what type of error occurred and what is the error and corresponding actions if available.