D Appendix: Integration Gateway Services .ear File Installation

This section provides detailed steps for installing the Integration Gateway Services (IGS) .ear file. The instructions below cover the following topics:

1. Prerequisites

2. Preparing the WebLogic Server (WLS)

3. Deploying the IGS .ear file

4. Testing the IGS using the WLS test page

Prerequisites

Installation of the IGS .ear file requires the following:

• WebLogic Server

• AQ 11g database

• Oracle Retail Integration Bus (already running)

Each .ear file or ejb-jar file containing the services should be deployed on its own WebLogic instance.

To avoid confusion when naming the WebLogic instance, it is recommended that the .ear file name is used (without the extension) along with underscore, wls_instance. For example, if the .ear file is rms-service.ear, the instance name is rms-service_wls_instance.

Note: Before deploying the IGS .ear file, be sure to create RIB AQ JMS Topics. For information, see Chapter 4, "Run the RIB Application Installer".

Prepare the WebLogic Server

Create a datasource for IGS, pointing to the RIB AQ JMS server, as follows:

1. Navigate to the Summary of JDBC Data Sources screen using the Services > JDBC > Data Sources menu.

   
   

2. Click New to open the Create a New JDBC Data Source screen. Enter the following values:

   Field Name	Value
   Name	igs-ojms-managed-datasource
   JNDI Name	IGSOracleAQJmsDs
   Database Type	Oracle
   Database Driver	Oracle

   
   
   
   

3. Also on the Create a New JDBC Data Source screen, uncheck "Supports Global Transactions."

   
   

4. Also on the Create a New JDBC Data Source screen, enter the following database details:

   • Database Name

   • Host Name

   • Port

   • Database User Name

   • Password

   • Confirm Password

   
   

5. Also on the Create a New JDBC Data Source screen, verify the configuration details, as shown below:

   
   

6. At the top of the screen, click Test Configuration to ensure the server is able to connect to the database. Note the message at the top of the following screen: "Connection test succeeded."

   
   

7. Also on the Create a New JDBC Data Source screen, select the target server under Select Targets. Click Finish.

   
   

8. Upon clicking Finish, the newly created data source should appear in the list of data sources (on the Summary of JDBC Data Sources screen).

   
   

Deploy the IGS .ear File

Complete the following steps to deploy the IGS .ear file.

1. Download the IntegrationGatewayService13.1.1ForAll13.1.1Apps.tar to a temporary location.

2. Run the following command for extracting the contents of the .tar file:

   $ tar -xvf IntegrationGatewayService13.1.1ForAll13.1.1Apps_eng-ga.tar
   

3. Navigate to the "integration-bus-gateway-services" directory to see the contents:

   $ cd integration-bus-gateway-services
   

   $ ls -ltr
   

   
   

4. Navigate to the WL_Server > Deployments screen to view the list of deployed applications on the Summary of Deployments screen.

   
   

   Note: To re-deploy an application that is already deployed, click Delete first to "undeploy" the application. Then continue with the following steps.

   
   
   
   

5. On the Summary of Deployments screen, click Install to open the Install Application Assistant screen.

   
   

6. On the Install Application Assistant screen, click the "upload your file(s)" link to display the Deployment Archive field.

   
   

7. In the Deployment Archive field enter the .ear file location of the local server, as shown below:

   
   

8. Click Next to view the following portion of the Install Application Assistant screen:

   
   

9. Click Next to move on to the portion of the Install Application Assistant screen shown below. Click the "Install this deployment as an application" radio button.

   
   

10. Click Next to display a list of Optional Settings. Leave the default values as they are shown below:

    
    

11. Click Next to view the following portion of the Install Application Assistant screen. Select the "No, I will review the configuration late" radio button.

    
    

12. Click Finish to start the deployment process and return to the list of deployed applications.

Test the IGS using the WLS Test Page

Clicking Finish in the last set of instructions opens the Deployments screen shown below. Each application has a link to all of its modules and components.

1. In the list of applications, click on the plus sign (+) beside integrations-service to display the modules and components associated with it.

   
   

2. Under Modules and Components, click on any Web service to view a list of Web service details, as shown below.

   
   

3. In the Settings for AllocPublishingService screen, click the Testing tab.

   
   

4. Click the Test Client link to open the Web service test client page:

   
   

5. Modify the SOAP request body as needed. Click on the method required to invoke the corresponding method of the Web service. Once the method call is complete, the SOAP response will display in the same page.