Oracle Retail Knowledge Base

2 Installing on a Windows Environment

6 min read

Mirror of Oracle documentation

Converted for search and offline reading. Authoritative source: Oracle. Diagrams and some complex tables are simplified — check the PDF when in doubt.

2

Installing on a Windows Environment

This chapter describes how to install the IPOCS-Demand Forecasting / IPOCS-Lifecycle Allocation and Replenishment Starter Kit on a Windows environment.

IPOCS-Demand Forecasting / IPOCS-Lifecycle Allocation and Replenishment Starter Kit Overview

RPAS Cloud Edition is comprised of many components. In addition, there are solutions that have been developed using the RPAS Cloud Edition foundation. Examples of these solutions include Oracle Retail Merchandise Financial Planning (MFPCS) and Oracle Retail Inventory Planning Optimization Cloud Service-Demand Forecasting (IPOCS-Demand Forecasting). Each application supported by the RPAS Cloud Edition Platform has a dedicated Starter Kit.

The components of the Starter Kit software include the following:

  • RPAS Configuration Tools

  • RPAS Server libraries used by the Configuration Tools

  • Documentation

Note

The Starter Kit distribution does not contain a full Retail Home instance. As a result, Retail Home and its features are not supported in Starter Kit environments.

Starter Kit Installation on Windows

For the purposes of this section, a slash “/” is used to delineate directories and files in paths. Users in a Windows Command Prompt environment need to either use a backslash “” as the delineation character or use double quotes around paths.

This section contains the following topics:

  • Starting the Cygwin Shell and Setting up the Environment

  • RPAS Package Location

  • Installing the Starter Kit

Starting the Cygwin Shell and Setting up the Environment

Perform the following procedures to start the Cygwin shell and set up the environment.

Installing the Starter Kit

The following procedures provide information about creating the necessary folders on your Windows PC and copying the Configuration Tools components to them.

1. Using Windows Explorer, navigate to your C drive, create a folder named Oracle .

2. Open the Oracle folder.

3. Unzip the downloaded file with a name similar to p33174696_19000_MSWIN-x86-64.zip into the newly created Oracle directory on the Windows machine. Once extracted, the following directories appear:

DirectoryDescription
ConfigToolsThis directory contains the components required to run the RPAS Configuration Tools.

In this example, the path C:\Oracle\RDF_Starter_Kit\ConfigTools is both the RPAS_HOME and RIDE_HOME . Environment variables are defined on your Windows PC to point to this location so that RPAS will function correctly. Refer to “Creating the Required Environment Variables” for information on creating the necessary RPAS variables.

Creating the Required Environment Variables

The following steps outline the process to follow and environment variables required to support the RPAS installation and application install.

Steps to Access the Environment Variables Window

Perform the following steps to access the Environment Variables window.

1. Press Windows key and R , the Run box opens.

2. Type sysdm.cpl and press Enter .

3. Select the Advanced tab.

4. At the bottom of the window, click Environment Variables .

1. Start Cygwin terminal and run the following commands:

>cd $RIDE_HOME/bin

then

>ConfigTools

Application Building

This section describes building applications on Oracle cloud using the configuration from the Starter Kit.

Object Store Locations

For the purposes of building the application, following subpaths in the object store are used:

Note

If you are using the VM it still uses the incoming FTP location; which is a folder shared with the host machine instead of the object store.

config

For uploading the application configuration into the cloud environment, create an archive containing the config directory and all of its contents. This archive file must be named as <config_name>_config.zip . This archive file must be uploaded to the in Object Store under planning/incoming/config location .

The customer can use the plug-ins to generate different available configuration plug-in options. Refer to Appendix: Generating the Configuration for Plug-in Options

json

Dashboards uses dashboardSettings.json and this file is used by the RPASCE client for displaying the dashboard. This file is optional. If present it should be uploaded to the Object Store under planning/incoming/json location .

batch_control

The set of batch process control files is optional. If present they must be uploaded to the Object Store under planning/incoming/batch_control location .

integration

The batch process also needs interface.cfg file which is a configuration file to get data from RAP Integration. Refer to the Oracle Retail Predictive Application Server Cloud Edition Implementation Guide for more details about configuring the interface.cfg file. This file is needed only if some interfaces are configured to get the data. This file if present should be uploaded to the Object Store under planning/incoming/config location .

input

The hierarchy data files and measure input files must be uploaded to the object store under planning/incoming/input as individual files or as an archive in the .zip format. If uploading data files as an archive, the name of the archive file should be same as the one used in batch

control files for the compressed files. Remember not to include any directory structure in the archive file. In addition to the application build and patch processes, batch framework tasks like measload, hierload, unpack, and waittrigger will check for incoming files in this same object store input location.

Updating the Starter Kit Installation

Each release of Cloud Service will have a version-specific Starter Kit. As the product is enhanced in future versions, it will be necessary to update the Starter Kit to incorporate these enhancements. The following steps outline the process of updating the Starter Kit installation:

1. Download the new version of the IPOCS-Demand Forecasting / IPOCS-Lifecycle Allocation and Replenishment Starter Kit.

2. Delete the contents of the C:/Oracle/RDF_Starter_Kit directory.

Warning

It is highly recommended to save custom configurations outside of the RDF_Starter_Kit directory so that they are not accidentally deleted when updating the Starter Kit.

3. Follow the installation instructions for the new version of the Starter Kit.

4. Run plug-in automation on the existing configuration to create a version of the configuration for the selection configuration options. Follow the instructions in the Oracle Retail Inventory Planning Optimization Cloud Service Implementation Guide .

5. Apply the changes in the newly generated configuration to the IPOCS-Demand Forecasting / IPOCS-Lifecycle Allocation and Replenishment application.

Note

For more information on using the RPAS Configuration Manager, refer to the Oracle Retail Predictive Application Server Configuration Tools User Guide .

In this guide

Graph View

Backlinks