Oracle Retail Demand Forecasting Installation Guide Release 12.0 May 2006
Copyright 2006, Oracle. All rights reserved. The Programs (which include both the software and documentation) contain proprietary information; they are provided under a license agreement containing restrictions on use and disclosure and are also protected by copyright, patent, and other intellectual and industrial property laws. Reverse engineering, disassembly, or decompilation of the Programs, except to the extent required to obtain interoperability with other independently created software or as specified by law, is prohibited. The information contained in this document is subject to change without notice. If you find any problems in the documentation, please report them to us in writing. This document is not warranted to be error-free. Except as may be expressly permitted in your license agreement for these Programs, no part of these Programs may be reproduced or transmitted in any form or by any means, electronic or mechanical, for any purpose. If the Programs are delivered to the United States Government or anyone licensing or using the Programs on behalf of the United States Government, the following notice is applicable: U.S. GOVERNMENT RIGHTS Programs, software, databases, and related documentation and technical data delivered to U.S. Government customers are "commercial computer software" or "commercial technical data" pursuant to the applicable Federal Acquisition Regulation and agency-specific supplemental regulations. As such, use, duplication, disclosure, modification, and adaptation of the Programs, including documentation and technical data, shall be subject to the licensing restrictions set forth in the applicable Oracle license agreement, and, to the extent applicable, the additional rights set forth in FAR 52.227-19, Commercial Computer Software Restricted Rights (June 1987). Oracle Corporation, 500 Oracle Parkway, Redwood City, CA 94065 The Programs are not intended for use in any nuclear, aviation, mass transit, medical, or other inherently dangerous applications. It shall be the licensee's responsibility to take all appropriate fail-safe, backup, redundancy and other measures to ensure the safe use of such applications if the Programs are used for such purposes, and we disclaim liability for any damages caused by such use of the Programs. Oracle, JD Edwards, PeopleSoft, and Siebel are registered trademarks of Oracle Corporation and/or its affiliates. Other names may be trademarks of their respective owners. The Programs may provide links to Web sites and access to content, products, and services from third parties. Oracle is not responsible for the availability of, or any content provided on, third-party Web sites. You bear all risks associated with the use of such content. If you choose to purchase any products or services from a third party, the relationship is directly between you and the third party. Oracle is not responsible for: (a) the quality of third-party products or services; or (b) fulfilling any of the terms of the agreement with the third party, including delivery of products or services and warranty obligations related to purchased products or services. Oracle is not responsible for any loss or damage of any sort that you may incur from dealing with any third party.
Contents Preface... v Customer Support...v 1 Introduction... 1 Intended Audience...1 About this Document...1 2 Installation on UNIX Environments... 3 Preparation...3 Overview...3 Installation Package...3 Installation...4 Start the Installer...4 Introduction...5 Base Paths for Solution...6 Domain Installation Paths...7 Install Tasks...8 Installation Progress...9 Results and Logs...10 A Appendix: Automated Installation on Windows and Supplemental Manual Steps... 11 Step 1: Create the RDF Installation Directory...11 Step 2: Copy the RDF PlugIn to the Configuration Tools...11 Step 3: Run rpasinstall to build the RDF_12...12 Step 4: Load the sales measures...12 Step 5: Use mace to calculate the Weekly Sales measures...12 B Appendix: Creating a Global Domain Configuration Directory (Optional)... 13 C Appendix: Run rpasinstall to Install RDF Domain(s)... 15 Installation Guide iii
Preface Customer Support https://metalink.oracle.com When contacting Customer Support, please provide: Product version and program/module name. Functional and technical description of the problem (include business impact). Detailed step-by-step instructions to recreate. Exact error message received. Screen shots of each step you take. Note: Information contained in this document may not match your application exactly. This is due to configuration changes and customizations that may have been made for the version that you are working with. Installation Guide v
1 Introduction This document provides instructions on installing Oracle Retail Demand Forecasting v 12.0. Intended Audience This document is intended for an MIS administrator that needs to install the RPAS software and create RDF domains. About this Document This document provides detailed instructions on how to install an RDF domain using a configuration created via the RPAS Configuration Tools. This document does not describe how to create the actual configuration. The RDF Configuration Guide documents the steps that are required to create a configuration. Supplemental installations guides are referenced in this document. The RPAS Installation Guide and RPAS Configuration Guide must be obtained prior to beginning the installation process. Read these documents in their entirety before beginning the installation. Installation Guide 1
Preparation 2 Installation on UNIX Environments The installation of the server-side RPAS components on UNIX operating systems is accomplished using Java-based installation programs that are included with the installation package. The RPAS Installer automates the following: Installation of the RPAS server Installation of Configuration Tools on the server (installation of the Tools on Windows machines is accomplished using an InstallShield package) Installation and licensing of Acumate Definition of DomainDaemon port The RDF Installer automates the following: Installation of the RDF_12 mock install configuration Installation of RDF plugins for the Configuration Tools Installation of Language Translation files Creation of a sample RDF_12 domain This document assumes that the RPAS Installer process (from the RPAS Installation Guide) has been completed prior to using the RDF Installer. Overview The RPAS components included in this installation process are available inside the media pack of the solution downloaded from Oracle s E-Delivery web site. There are 4 RPAS archives inside the media pack of the RDF solution that is downloaded, one RPAS archive for each supported operating system. Installation Package Create an installation directory from which the RDF installation routine will be run. This directory will be referred to as [RDF Installation]. After downloading the package from Oracle E-Delivery and ftp the archive to the [RDF Installation] directory on the target server. Use 'binary' mode to transfer the archive. Extract the package to the [RDF Installation] directory. cd [RDF Installation] unzip RDF.zip Installation Guide 3
Installation on UNIX Environments Installation Start the Installer Begin the Installer by first changing to the root of the [RDF Installation] directory and running the below command:./install.sh Note: The command must be executed with the preceding period and forward slash. If this process is being run on an X-Windows emulator (such as Exceed) you will be presented with a graphical user interface to the Installer. If you are running in console mode through a terminal emulator, you will be presented with the text interface to the installer. In both cases, the requested information will be identical but displayed differently. In the GUI you may be shown a checkbox to signal whether you want a component installed; in text mode you will be prompted for a response of "true" or "false". Note: In text mode, the default value will appear in square brackets. To use the default value and continue, simply hit the "Enter" key. If you wish to use a different value, enter the new value. When prompted to create a directory respond with "y" or "yes" and hit the "Enter" key. 4
Oracle Retail Demand Forecasting 12.0 Introduction This screen shows the components that will be installed during installation process and the required components. Click Next when ready. Installation Guide 5
Installation on UNIX Environments Base Paths for Solution Enter the following and click "Next" when ready: Directory to store the configurations Directory to store created domains Path to the retailogin.ksh script created during RPAS installation 6
Oracle Retail Demand Forecasting 12.0 Domain Installation Paths Enter the path to the RDF domain to be created. Click Next when ready. Installation Guide 7
Installation on UNIX Environments Install Tasks Activate the checkbox to create the RDF domain. By deactivating the checkbox all required components to support an RDF domain are installed, however the domain is not created. Click Next when ready. 8
Oracle Retail Demand Forecasting 12.0 Installation Progress Once you are ready to begin installation, click the "Install" button. This screen will show the progress of the installation. Select "Show Details" if you wish to view the log output as the installation is completed. If you select not to view the details you will be shown a graphical representation of the installation steps. As each is completed, the color will change to show you the progress. You can toggle between detailed mode at any time during or after the installation. Warning: If you chose to create the RDF_12 global domain, installation time might take 30 to 60+ minutes depending on server specs. Installation Guide 9
Installation on UNIX Environments Results and Logs The system will notify you when the installation process is finished. Click the OK button. If you viewed the installation via the graphical progress, you can now click "Show Details" to view the logs. Once you are finished reviewing the installation, you can click on the "Exit" button to close the installer application. If you wish to view the log again at a later date, a text copy was saved in the directory you initiated the installation from ([RDF Installation]). The log file will be named based on the product and a timestamp, followed by the ".log" extension. Created as part of this process is the make_domain.rdf file located in the [Configurations Install Dir] entered during the install. This file contains all of the required parameters needed to support the domain install. If necessary this file may be modified if the default parameters are not desired for your particular environment. Note: The domain install process also includes post-install data loading scripts specific to the RDF_12 configuration. These scripts may also be modified. 10
A Appendix: Automated Installation on Windows and Supplemental Manual Steps Additional manual steps are required for Windows environments to build the RDF_12 mock installation or other RDF configurations. After the completion of the InstallShield process the following components must be installed prior to completing the install process for RDF: Acumate RPAS Client RPAS Server: Also referred to as $RPAS_HOME RPAS Configuration Tools: Also referred to as $RIDE_HOME Java: Also referred to as $JAVA_HOME Note: See the RPAS Installation Guide for instructions on the above components. Step 1: Create the RDF Installation Directory Create an installation directory from which the RDF installation routine will be run. This directory will be referred to as [RDF Installation]. After downloading the package from Oracle E-Delivery and ftp the archive to the [RDF Installation] directory on the target server. Use 'binary' mode to transfer the archive. Extract the package to the [RDF Installation] directory. cd [RDF Installation] unzip RDF.zip Step 2: Copy the RDF PlugIn to the Configuration Tools The RDF PlugIn enables the RDF solution to be available for configuration in the RPAS Configuration Tools and supports the domain install process. Locate the plugin directory by changing to the root of the [RDF Installation] directory. Navigate to [RDF Installation]/plugin/ and copy the entire contents of resource to the Configuration Tools installation ($RIDE_HOME)/ Installation Guide 11
Appendix: Automated Installation on Windows and Supplemental Manual Steps Step 3: Run rpasinstall to build the RDF_12 The following command may be used to install the RDF_12 configuration using the p option to specify the partition dimension (pgrp) configured in this global domain environment: rpasinstall -fullinstall -dh <path to the domain> -cn RDF_12 -ch <path to the configuration> -in <path to the data files> -log <path to the location and name of the installation log> -rf AppFunctions -rf RdfFunctions rf ClusterEngine p pgrp Note: AppFunctions and RdfFunction are required functions needed for the installation of RDF. This configuration also includes Grade which requires both AppFunctions and ClusterEngine. Note: See the RPAS Configuration Guide for usage information on rpasinstall. Example: rpasinstall -fullinstall -dh C:\RDF\Domains -cn RDF_12 -ch C:\RDF\configurations - in C:\RDF\input -log C:\RDF\configurations\install.txt -rf AppFunctions -rf RdfFunctions rf ClusterEngine p pgrp Step 4: Load the sales measures After the domain installation has completed the sales data must be loaded into the domain using the loadmeasure utility. Open a command prompt from the master domain (/RDF_12) and type the following commands: loadmeasure -d. -measure dpos loadmeasure -d. -measure rsal loadmeasure -d. -measure csal loadmeasure -d. -measure psal Step 5: Use mace to calculate the Weekly Sales measures Open a command prompt from the local domain (/RDF_12/ldom0) and type the following command: mace -d. -run -group common_batch Repeat this step for each of the remaining local domains (/RDF_12/ldom1 and /RDF_12/ldom2). 12
B Appendix: Creating a Global Domain Configuration Directory (Optional) If you are installing a Global Domain environment, an xml file may be created to determine how the domains will be partitioned and the label of each domain. If you take this approach, the -configdir option should be used when running rpasinstall. The following example is the structure of the globaldomainconfig.xml file: Path: The location of the root of the domain. For the RDF_12 configuration, RDF_ is the root to the Master domain. Partitiondim: The partition dimension. For RDF_12, pgrp (Group) is the dimension in which the local domains will be partitioned. There can only be one partition dimension. Subpath: The path and name of the local (sub-domain) that contains a specific partition position. ldom+# is the default name given by RPAS to local domains. For the RDF_12 configuration, post-install scripts are pre-configured to install and load data to the domains named ldom0, ldom1, and ldom2. Subposition: The position from the partition dimension that will be located in the local domain. The RDF_12 configuration will create three local domains. For example, ldom0 will include all product positions at or below pgrp 1100. Example file structure: <?xml version="1.0" encoding="utf-8" standalone="yes"?> <rpas> <globaldomain> <path>/domains/rdf_12</path> <partitiondim>pgrp</partitiondim> <subdomain> <subpath>/domains/rdf_12/ldom0</subpath> <subpositions>1100</subpositions> </subdomain> <subdomain> <subpath>/domains/rdf_12/ldom1</subpath> <subpositions>1300</subpositions> </subdomain> <subdomain> <subpath>/domains/rdf_12/ldom2</subpath> <subpositions>2500</subpositions> </subdomain> </globaldomain> </rpas> Note: If you use the above example xml file structure to install the RDF_12 configuration, only the Path and Subpath to the domains may be changed; but the local domains (ldom0, ldom1, ldom2), partition dimension (pgrp), and subpositions (1100, 1300 and 2500) must be the same as above. Installation Guide 13
C Appendix: Run rpasinstall to Install RDF Domain(s) The rpasinstall utility is used to install domains that support RDF. See the RPAS Configuration Guide for more information on the usage of rpasinstall. RDF requires the following functions to be registered at the time of installation: a. AppFunctions b. RdfFunctions Example 1: Installing a Simple domain environment by using a simple domain configuration: rpasinstall -fullinstall -dh /Domain_Home -cn Simple -ch /configurations -in /Data -log /Log/InstallLog.txt -verbose -rf AppFunctions -rf RdfFunctions Example 2: Installing a Global Domain environment by using a global domain configuration and the p option to specify the partition dimension: rpasinstall -fullinstall -dh /Domain_Home -cn Global -ch /configurations -in /Data -log /Log/InstallLog.txt -verbose -rf AppFunctions -rf RdfFunctions p pgrp Example 3: Installing a Global Domain environment by using a global domain configuration and the configdir option to specify the path to the globaldomainconfig.xml: rpasinstall -fullinstall -cn Global -ch /Configurations -in /Data -log /Log/InstallLog.txt -verbose -rf AppFunctions -rf RdfFunctions configdir /ConfigDir Note: AppFunctions and RdfFunction are required functions needed for the installation of RDF. RDF configurations that also include Grade requires ClusterEngine to also be registered. Note: See the RPAS Configuration Guide for usage information on rpasinstall. Installation Guide 15