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 that are run 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 run, the following topics are included in this chapter:
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: $JAVA_TOP/oracle/apps/fnd/isg/ant/isgDesigner.xml is a multipurpose script. It can also be used to implement 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 the design-time activities, see Managing SOAP Service Lifecycle Activities Using An Ant Script and Managing REST Service Lifecycle Activities Using An Ant Script.
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:
ant -f $JAVA_TOP/oracle/apps/fnd/isg/ant/isgDesigner.xml DiagnoseAGENTSetup
This command runs configuration checks on the Oracle E-Business Suite side.
ant -f $JAVA_TOP/oracle/apps/fnd/isg/ant/isgDesigner.xml DiagnoseAPPSetup
This command runs configuration checks on the Oracle SOA Suite side.
ant -f $JAVA_TOP/oracle/apps/fnd/isg/ant/isgDesigner.xml DiagnoseISGSetup
This command runs complete diagnostic tests on both Oracle E-Business Suite and Oracle SOA Suite.
ant -f $JAVA_TOP/oracle/apps/fnd/isg/ant/isgDesigner.xml DiagnoseISGFunctionality
This command runs all design-time operations for all types of interfaces in Oracle E-Business Suite Integrated SOA Gateway.
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 the test is failed. Message will convey the information that what type of error occurred and what is the error and corresponding actions if available.