3 Patch Installation

This chapter describes how to upgrade RO from a previous release to Release 14.1.2.

Upgrade Prerequisites

In order to upgrade RO, first verify the following criteria for the RPAS system:

• Verify that RPAS is currently installed and is at Release 13.3 or later. If not, refer to the section, Upgrade to Key RPAS Versions.

• Verify that the UNIX operating system is updated to the currently supported version. Refer to the ”Hardware and Software Requirements” section of the Oracle Retail Predictive Application Server Installation Guide.

• Verify that the environment variables are correctly set for both the server and PC; if they are not, follow these instructions to set them:

  • Change directories to the original RPAS installation directory (such as the one created by the most recent installer), and run the retaillogin.ksh script to set all environment variables. For example:

    $ cd /retail

    $ . ./retaillogin.ksh

Notes: Once you have run the script, verify that all the environment variables point to the correct locations on your environment. If you have updated Java since the last installation of RPAS, verify that the JAVA_HOME path is correct. If not, update your retaillogin.ksh script and source it again as previously outlined.

Upgrade Process

The following process outlines how to upgrade RO to the latest version using the RPAS Configuration Tools.

Upgrade to Key RPAS Versions

Before you upgrade to a post-13.3 release, ensure that you have upgraded and patched to RPAS Release 13.2.3.

This list defines the upgrade process that is described in the following sections.

1. Upgrade and Patch to RPAS Release 13.2.3

2. Convert for Integer Indexing

3. Upgrade and Patch to RPAS Release 13.3 or Later

Upgrade and Patch to RPAS Release 13.2.3

Upgrading your domain to a 13.3 or later RPAS domain requires that you first upgrade it to a 13.2.3 domain. For instructions, see the ”Upgrading and Patching Domains” section in the 13.2.3 release of either the Classic Client or Fusion Client version of the Oracle Retail Predictive Application Server Administration Guide.

After upgrading, you must run a configuration patch over the domain to ensure compatibility with the RPAS version, regardless of whether there are any configuration changes.

Convert for Integer Indexing

Upgrading to a 13.3 or later RPAS domain requires the use of the convertDomain utility, which may not copy the entire contents of the source domain to the destination domain. For files that are not copied by convertDomain, you may need to copy them manually.

For information about what is and is not copied, see the ”convertDomain” section in the 13.3 release of either the Classic Client or Fusion Client version of the Oracle Retail Predictive Application Server Administration Guide.

Upgrade and Patch to RPAS Release 13.3 or Later

The following process outlines how to upgrade RO to the current version using the RPAS Configuration Tools.

Note: After upgrading, you must run a configuration patch over the domain to ensure compatibility with the latest RPAS version, regardless of whether there are any configuration changes.

For the PC

Follow these instructions for the PC to upgrade to the current version:

1. Open RPAS Configuration Tools.

2. In RPAS Configuration Tools, load your previous configuration of RO:

   1. From the Configuration Tools File menu, select Open.

   2. From the Open window, locate the configuration file and click Open.

3. If your configuration requires updating, dialog boxes will prompt you to upgrade. Follow the instructions given in the dialog boxes.

4. In the RPAS Configuration Tools File menu, click Save to save the configuration.

5. Zip the configuration in Cygwin and transfer the.zip file to the RPAS server. Note where it is saved. You will need this configuration for Step 2 of the section, "For the Server".

For the Server

Follow these instructions for the server to upgrade to the current version:

1. Upgrade the RPAS server configuration by running the installer:

   1. Begin the installer as described in the Installing Replenishment Optimization.

   2. Complete steps 1-4.

   3. At step 5, the Install Tasks Window, clear the Create RO Domain check box.

   4. Finish the remaining steps of the installer.

2. Unzip the updated configuration and note where it is extracted. You saved this configuration in Step 5 of the section, "For the PC".

3. Upgrade your RO domain to a 14.1.2 domain. Run the following command:

   buildRO.sh -c <config path> -i <input path> -l <log path> -d <domain path> -p

   Flag	Where:	Is the Path for the:	Default Value*
   -c	<config path>	configurations	$PWD/../DomainCfg/Version11.0/Promote
   -i	<input path>	input files	$PWD/../DomainBuild/to_rpas
   -l	<log path>	log file	$PWD/../
   -d	<domain path>	domain	$PWD/../domain
   -m	<max process#>	number of max processes for loading measures	1
   -f	<log file >	log file	build_domain.log
   -p	<make patch build >	domain patching	none
   -u	<show usage of this script>	show usage of this script	none
   -n	<configName>	configuration name	RO
   -r	<partionDimension>	partion dimension	pgrp
   * Where $PWD is the current directory

   
   
   
   

   Note: The flag -p must be used for domain patching.