2 Installation and Basic Setup

Determining the Type of Installation

The Retail Service-Oriented Architecture Enabler Tool can be installed and used in any of the following configurations:

Standalone application
Web-application in Oracle WebLogic

Installing as a Standalone Application

To install the Retail Service-Oriented Architecture Enabler Tool, complete the following steps.

Determine the user and the location to install the rse.
Verify the JAVA_HOME environment variable is set for the user. The JAVA_HOME must be set to a Java 1.8 JDK with latest security updates. If the user is located on the same server as the Application Server, then setting the JAVA_HOME to $ORACLE_HOME/jdk is recommended.
```
>echo $JAVA_HOME
/home/aia1/oracle/middleware/jdk
```
Create a directory for the RSE.
```
>mkdir rse
```
Download and extract the RSE to the RSE home directory.
```
> cd RSEStandalone
> cp /u00/stage/RIB19.1.000/RetailSOAEnabler19.1.000ForAll19.1.000Apps_eng_ga.tar.
> tar -xvf RetailSOAEnabler19.1.000ForAll19.1.000Apps_eng_ga.tar
```
This step creates the RSE root directory structure. For example: /user/aia1/RSE/retail-soa-enabler.

This structure becomes RSE_HOME.

Note:
RSE_HOME is assumed to be the rse-home directory in the following steps.
```
> export RSE_HOME=/user/home/aia1/RSE/retail-soa-enabler
```
Installation is complete. See "Command Line Interface".

Installation as a Web Application in Oracle WebLogic

This section explains how to deploy the Retail Service-Oriented Architecture Enabler tool to an Oracle WebLogic 12.2.1.4.0 application server as a Web application.

The steps below describe how to deploy the Retail Service-Oriented Architecture Enabler tool to an Oracle WebLogic 12.2.1.4.0 Application Server as a Web application.

Note:

See "Technical Specifications" in "Introduction".

Prerequisites

The following are prerequisites for installation:

The retail-soa-enabler-gui-<version>.war file is located within the directory structure of the RetailSOAEnabler19.1.000ForAll19.1.000Apps_eng_ga.tar. Locate and extract the contents to a location that is accessible by the browser for deployment.
The installation and base configuration of the Oracle WebLogic Server 12.2.1.4.0 is beyond the scope of this document. Work with the Application Server Administration team to determine the physical and logical placement of the retail-soa-enabler-gui-<version> component within the WebLogic Server 12.2.1.4.0 deployment.

Note:
See the Oracle WebLogic Server 12c (12.2.1.4.0) Installation Guide.

Deploy the Retail Service-Oriented Architecture Enabler

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

Note:

For instructions with illustrations (screen captures), see "Appendix: Installer Screens."

Navigate to the Deployments page.
If necessary, click Lock and Edit on the left navigation bar to enable the Install button.
Click Install.

Note:
If the application has already been installed, see "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.
Select Upload your files.
On the Upload a Deployment to the Administration Server page, use the Browse button to locate the retail-soa-enabler-gui-<version>.war file in the Deployment Archive.
Select the retail-soa-enabler-gui-<version>.war.
Click Next and move to Choose targeting style.
Select Install this deployment as an application.
Click Next and move to Optional Settings.
Click Next and move to Select deployment targets. Select the Server name where you want to install the application.
Click Next and move to Optional Settings page.
In the Security section, select the option DD only: Use only roles and policies that are defined in the deployment descriptors.
Select No, I will review the configuration later.
Click Finish to deploy the application.
Click Activate Changes to finish install. Go to Deployments page, select the retail-soa-enabler-gui<version> application and click on Start > Servicing all requests button. This should change the status of retail-soa-enabler-gui-<version> application to Active status.
After the application is deployed, we need to create a group and users who can access the RSE GUI applications.
Go to Security Realms page, click on the default realm and go to Users and Groups tab.
Create a new group named rseAdminGroup in the Groups page.
Go to Users page and create a new user.
Click on the newly created user and go to the Groups tab of that user. From the Available groups, select rseAdminGroup and move it to the Chosen window.
Click Save.

This completes the deployment of RSE GUI application.

Verify the Retail Service-Oriented Architecture Enabler

Take the following steps to verify the retail service-oriented architecture enabler:

Navigate to the Deployments page.
Locate retail-soa-enabler-gui-<version> on the Summary of Deployments page.
Click the name, retail-soa-enabler-gui-<version>, to move to the Settings for the retail-soa-enabler-gui-<version>.
Select the Testing tab.
Click the index.jsp URL in the Test Point.
The URL opens the Retail Service-Oriented Architecture Enabler login page.
Enter the credentials created in the 'Deploy the Retail Service-Oriented Architecture Enabler' section, and the RSE home page is displayed.
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:

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.
Select Delete.
The retail-soa-enabler-gui-<version> should now not show on the Summary of Deployment page.
Return to the appropriate step in "Deploy the Retail Service-Oriented Architecture Enabler."