Oracle® Retail Functional Artifact Generator Guide Release 16.0.023 E89609-01 |
|
Previous |
Next |
This chapter provides instructions for installing and deploying the Oracle Retail Artifact Generator.
The Oracle Retail Artifact Generator can be installed and used in any of the following configurations:
Standalone application
Application inside rib-home
Web-application in Oracle WebLogic
To install the Oracle Retail Artifact Generator, complete the following steps.
Determine the user and the location to install the Artifact Generator.
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 Artifact Generator.
> mkdir ArtifactGeneratorStandalone
Download and extract the Artifact Generator to the Artifact Generator home directory.
> cd ArtifactGeneratorStandalone > cp /u00/stage/RIB16.0.023/ArtifactGenerator16.0.023ForAll16.x.xApps_eng_ga.tar. > tar -xvf ArtifactGenerator16.0.023ForAll16.x.xApps_eng_ga.tar
This step creates the Artifact Generator root directory structure. For example: /user/aia1/ArtifactGenerator/retail-func-artifact-gen.
This structure becomes AG_HOME.
Note: AG_HOME is assumed to be the artifact-generator-home directory in the following steps. |
> export AG_HOME=/user/home/aia1/ArtifactGenerator/retail-func-artifact-gen
Note: For a base artifact, use the RibFunctionalArtifacts for RIB. For Retail Services Backbone, use the RetailFunctionalArtifacts instead. |
Download the RIB Functional Artifact tar or the Retail Functional Artifact tar to the AG_HOME/base-func-artifacts directory.
> cd $AG_HOME/base-func-artifacts > cp /u00/stage/RIB16.0.023/RibFuncArtifact16.0.023ForAll16.0.023Apps_eng_ga.tar.
Do not untar it. This will be handled by the setup scripts.
Execute the setup script.
> cd $AG_HOME>$JAVA_HOME/bin/java -classpath ./integration-lib/*: groovy.ui.GroovyMain com/oracle/retail/integration/artifact/generator/SetupWorkArea.groovy
Installation is complete. See Chapter 3, "General Usage."
For the following steps, $RIB_HOME is assumed to be the rib-home directory in the rib-app-builder directory tree structure.
For example: /u00/rib/Rib16021ForAll16xxApps/rib-home
Verify the JAVA_HOME environment variable. The JAVA_HOME must be set to a Java 1.8 JDK with latest security updates.. If the <RIB_HOME> workspace 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
Download and extract the Artifact Generator to the Artifact Generator into the rib-home/tools-home directory. There already will be a placeholder directory /retail-func-artifact-gen.
> cd $RIB_HOME/tools-home > cp /u00/stage/RIB16.0.023/ArtifactGenerator16.0.023ForAll16.x.xApps_eng_ga.tar > tar -xvf ArtifactGenerator16.0.023ForAll16.x.xApps_eng_ga.tar
Note: For a base artifact, use the RibFunctionalArtifacts for RIB. For Retail Services Backbone, use the RetailFunctionalArtifacts instead. |
Download the RIB Functional Artifact tar or the Retail Functional Artifact tar to the AG_HOME/base-func-artifacts directory.
> cd $AG_HOME/base-func-artifacts > cp /u00/stage/RIB160.0.023/RibFuncArtifact16.0.023ForAll16.0.023Apps_eng_ga.tar
Do not untar it. This will be handled by the setup scripts.
Execute the setup script.
> cd $AG_HOME>$JAVA_HOME/bin/java -classpath ./integration-lib/*: groovy.ui.GroovyMain com/oracle/retail/integration/artifact/generator/SetupWorkArea.groovy
Installation is complete. See Chapter 3, "General Usage."
The steps below describe how to deploy the Oracle Retail Artifact Generator to an Oracle WebLogic Application Server as a Web application.
The following are prerequisites for installation.
The retail-func-artifact-gen-gui<version>.war file is located within the directory structure of the ArtifactGenerator16.0.023ForAll16.x.xApps_eng_ga.tar. It is recommended that the Artifact Generator be deployed from the rib-home location, although the .war file can be obtained from the stand-alone installation as well.
The installation and base configuration of the Oracle WebLogic Server is beyond the scope of this document. Work with the Application Server Administration team to determine the physical and logical placement of the retail-func-artifact-gen-gui component within the WebLogic Server deployment.
Note: See Oracle WebLogic Server 12c (12.2.1.2) Installation Guide. |
Using the WebLogic Server Administration Console, complete the following steps:
Note: For instructions with illustrations (screen captures), see "Appendix: Install the Artifact Generator." |
Navigate to the Deployments page.
Click Install.
Note: If the application has already been installed, see the section, "Redeploying the Application," in this chapter. |
The "Locate deployment to install and prepare for deployment” page is displayed. Follow the instructions to locate the retail-func-artifact-gen-gui-<version>.war file.
Select Upload Files.
On the Upload a Deployment to the Administration server page, use the Browse button to locate the retail-func-artifact-gen-gui-<version>.war file in the "Deployment Archive."
Select the retail-func-artifact-gen-gui-<version>.war
Click Next and move to Choose targeting style.
Select Install this deployment as an application. Click Next and move to Select Target Deployments. Select the target server for the Artifact Generator Web application.
Click Next and move to Optional Settings.
Click Next and move to Review your choices and click Finish.
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-func-artifact-gen-gui<version> application and click on Start > Servicing all requests button. This should change the status of retail-func-artifact-gen-gui application to Active status.
To create the agAdminGroup, do the following:
In WebLogic, click on Security Realms.
Click on myrealm and then Users and Groups.
Click on groups and then New.
Enter agAdminGroup in the name field, leaving the other fields at default.
Click OK.
Add at least one user to the agAdminGroup group.
To verify the artifact generator Web application, do the following.
Navigate to the Deployments page.
Locate the retail-func-artifact-gen-gui-<version>on the Summary of Deployments page.
Click the name, retail-func-artifact-gen-gui-<version>, to move to the "Settings for the rib-func-artifact-gen-gui."
Select the Testing tab.
Click the link for the index.jsp URL in the Test Point. The URL should open to the Retail Artifact Generator Login page.
The installation is complete. For more information, see Chapter 3, "General Usage."
Click on the Setup Work Areas tab.
Click Choose File, navigate to, and select the RibFuncArtifact16.0.023ForAll16.0.023Apps_eng_ga.tar
file.
Click Create Work Area.
If the retail-func-artifact-gen-gui application has already been deployed, follow these steps.
If the retail-func-artifact-gen-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.
Click Delete.
The retail-func-artifact-gen-gui-<version> should now not show on the Summary of Deployment page.
Return to the appropriate step in Deploy the Application.