A Appendix: Installer Screens

This appendix provides step-by-step instructions for installing the Oracle Retail Service-Oriented Architecture Enabler tool as a Web application in Oracle WebLogic.

Installation as a Web Application in Oracle WebLogic

To install the Oracle Retail Service-Oriented Architecture Enabler tool as a Web application in Oracle WebLogic, complete these steps.

Deploy the Retail SOA Enabler Application

Using the WebLogic Server Administration Console, complete the following steps:

1. Navigate to the Deployments page:

2. In the left navigation bar, click Lock & Edit. Click Install.

   
   
   
   

   Note: If the application has already been installed, see the section, "Redeploy the Application."

   
   

   The Locate deployment to install and prepare for deployment page is displayed. Follow the instructions to locate the retail-soa-enabler-gui-<version>.war file.

3. Upload your file(s).

4. On the Upload a Deployment to the admin server page, use the Browse button to locate the retail-soa-enabler-gui-<version>.war file in the Deployment Archive.

   
   

5. Select the retail-soa-enabler-gui-<version>.war.

   
   

6. Click Next and move to Choose targeting style.

   
   

7. Select Install this deployment as an application.

8. Select the Deployment Target.

   
   

9. Click Next to select security options. Here select the option DD Only: Use only roles and policies that are defined in the deployment descriptors.
   

   
   

   Note: Choosing an option other than DD Only can result in redirection to an error page for the RSE Admin GUI after deployment.

   
   

10. Click Next to review your choices. Click Finish.

    
    

11. Select No, I will review the configuration later.

12. Click Finish to deploy the application.

13. Click Activate Changes to finish the deployment.

    
    

14. Select the retail-soa-enabler-gui-<version> application. Click Start > Servicing All Requests.

    
    

15. Next step is to add group and user required to access RSE GUI application. To create the group, click on Security Realms.

    
    

16. Click on the default realm name and go to Users and Groups tab, and go to Groups tab.

    
    

17. Click on New button. In the next page, enter the name of group as rseAdminGroup. Enter description for the group.

18. Click OK button. The new group gets added.

19. Now go to the Users tab of security realm.

20. Click on New button to create a new user. In the next page, enter username and password for the new user to be created.

21. Click OK button. The new user gets added.

    
    

22. Now click on the new user and go to Groups tab of that user.

23. Select the group rseAdminGroup from the Available window and move it to Chosen window.

    
    

24. Click Save button. It will add the newly created user to the group rseAdminGroup.

    This completes the security setup for RSE GUI application. Now if you go to the RSE GUI login page, you should be able to login using the new user.

Creating the rseAdminGroup

To create the rseAdminGroup, do the following:

1. In WebLogic, click Security Realms.

2. Click on myrealm and then Users and Groups.

3. Click on groups and then New.

4. Enter rseAdminGroup in the name field, leaving the other fields at default.

5. Click OK.

6. Add at least one user to the rseAdminGroup group.

Verify the Retail SOA Enabler Web Application

1. Navigate to the Deployments page.

   
   

2. On the Summary of Deployments screen, locate retail-soa-enabler-gui-<version>.

3. Click retail-soa-enabler-gui-<version> to view settings for the retail-soa-enabler-gui.

   
   

4. Select the Testing tab.

   
   

5. Click the index.jsp URL in the Test Point.

6. The URL should open to the login screen for the Retail Service-Oriented Architecture Enabler Home page.

   
   

7. Enter the credentials created in Creating the rseAdminGroup section.

   The RSE home page is displayed.

   
   

8. The installation is complete. See Chapter 4, "User Interface Usage."

Redeploy the Application

If the retail-soa-enabler-gui-<version> application has already been deployed, follow these steps:

1. If the retail-soa-enabler-gui-<version> application is running, select Stop and When Work Completes or Force Stop Now, depending on the environment. The recommended option always is When Work Completes.

   
   

2. Click Lock & Edit and select the required application retail-soa-enabler-gui-<version> and then click Delete.

   
   

3. Click Activate Changes.

   
   

4. The retail-soa-enabler-gui-<version> should now not show on the Summary of Deployment screen.