Installation Instructions for Hot Fix C42001

64-bit Enabled AIX


Hot fix C42001 addresses the issue(s) in SAS Merchandise Intelligence 4.2_M1 on 64-bit Enabled AIX as documented in the Issue(s) Addressed section of the hot fix download page:

http://ftp.sas.com/techsup/download/hotfix/HF2/C42.html#C42001


This hot fix contains updates to the following software components:

SAS Merchandise Intelligence Server 4.2
SAS Size Profiling 2.2
SAS Merchandise Intelligence Mid-Tier 4.2_M1

Before applying this hot fix, follow the instructions in SAS Note 35968 to generate a SAS Deployment Registry report, then verify that the appropriate product releases are installed on your system. The software components and release numbers should match the list of software components updated by the individual hot fix installers.


IMPORTANT NOTES

  1. You must have SAS Merchandise Intelligence 4.2_M1 installed on your system before applying this hot fix. Refer to SN-35968 for instructions on how to determine which product releases you have installed.

  2. Files delivered in this hot fix will be backed up during the installation process. However, it is good general practice to back up your system before applying updates to software.

  3. You must have the appropriate administrative privileges to perform the steps described in these instructions.

  4. All servers except the SAS Metadata Server must be shut down as follows

  5. This hot fix should be installed using the same userid who performed the initial software installation.

  6. You must deploy the hot fix in the following timeframe


INSTALLATION

This hot fix must be installed on each server machine where the updated components of the product, listed above, are installed. The installation process will determine which components of SAS Merchandise Intelligence 4.2_M1 are installed on each machine, and apply the appropriate updates.

If the updated components of this product are installed on multiple operating systems, you must download the hot fix for the appropriate operating system(s) and follow the installation instructions provided to complete the deployment of this hot fix.


To install this hot fix execute the following steps.

1. The installer downloaded is C42001r6.bin. Verify that the installation binary has execute permission. If it does not, use the chmod command to make it executable.

$> chmod 755 C42001r6.bin
2. Set your $DISPLAY environment variable
export DISPLAY=<your_node_name>:0
3. Execute C42001r6.bin
<path_to_downloaded_file>/C42001r6.bin
    For example:
./C42001r6.bin

This will initiate the installation wizard, which will guide you through the hot fix installation process. During the installation you will be prompted for the SASHOME location to be updated. You should provide the path to the top level SAS directory where the deploymntreg directory exists.


See the Maintenance Installation Tool (MIT) documentation for more details on the installation of hot fixes.


POST-INSTALLATION INSTRUCTIONS

Post-Installation Instructions for SAS Merchandise Intelligence Mid-Tier 4.2_M1

Updates to the SAS Merchandise Intelligence Mid-Tier 4.2_M1 provided in this hot fix require that the Web Application be rebuilt and redeployed. If this component is installed on AIX, follow the steps below to rebuild and redeploy the web application:

Re-build Web Application

In order for this step to execute correctly, the Metadata Server must be running.

1. Set the DISPLAY environment variable, for example

$ export DISPLAY=:0

2. Invoke the SAS Deployment Manager 9.2

From the SASDeploymentManager directory execute config.sh, for example

$ cd <SASHOME>/SASDeploymentManager/9.2
$ ./config.sh

3. Select a language in the Choose Language box

4. Select Rebuild Web Applications

5. Select Configuration Directory or Enter the Configuration Directory and Level that needs to be updated

6. Specify Connection Information, including the sasadm User ID and Password

7. Select SAS Merchandise Intelligence Mid-Tier 4.2_M1 as the Web Application to Rebuild

8. Verify the information on the Summary screen and select Start

9. Select Finish when the deployment is complete

This process will update the SAS Merchandise Intelligence Mid-Tier 4.2_M1 ear in

<SASCONFIGDIR>/Lev1/Web/Staging
A backup of the original ear file will be placed in the directory
<SASCONFIGDIR>/Lev1/Web/Staging/Backup

Re-deploy Web Application

1. Re-deploy the SAS Merchandise Intelligence Mid-Tier 4.2_M1 web application (only). Details are provided at

http://support.sas.com/documentation/cdl/en/biwaag/63536/HTML/default/viewer.htm#/documentation/cdl/en/biwaag/63536/HTML/default/a003308992.htm

Note: Select sas.miserver.ear when re-deploying the web application.
2. Stop and restart the Web application server.
Note for WebLogic: If the SAS Merchandise Intelligence Mid-Tier is not started automatically after following the instructions in the link above, you will need to manually start it from the WebLogic Admin Console.


Alternative Method: The SAS Merchandise Intelligence Mid-Tier can be re-deployed to WebLogic using the following steps. The equivalent steps for WebSphere are documented in the Replace the entire application method in the detailed document link above.

1. Ensure all the services are running, including WebLogic Admin Console and Managed Server, i.e. SASServer1.

2. Login to WebLogic Admin Console.

3. Click on Lock and Edit.

4. Select the sas.miserver ear and click on the Update button.

5. Accept the default path and click on OK.

6. Click on the Activate changes button.

The web application server does not need to be restarted after using the alternative method. The Activate changes step will restart the SAS Merchandise Intelligence Mid-Tier internally.

Note:
When you run the Maintenance Installation Tool on the server where SAS Merchandise Intelligence Mid-Tier 4.2_M1 is installed you might see the following message:
SAS Merchandise Intelligence Server Version 4.2 English - AIX
Either this package is not applicable for the current platform, or this product cannot be found on your system, so the updates contained in this bundle will not be installed.

As long as you have verified that your system is running SAS Merchandise Intelligence Mid-Tier 4.2_M1 using the SAS Deployment Registry report this message can be ignored.

  • To verify that the hot fix was applied, look in the file \InstallMisc\InstallLogs\Maintenance\disvr_4.2_M1_HFC4300__postexec to verify the following changes were made:


    Post-Installation Instructions for SAS Size Profiling 2.2

    NONE


    Post-Installation Instructions for SAS Merchandise Intelligence Server 4.2 (Client Tier)

    To finish deploying the hot fix, you must locate your copied profiles, and then unpublish and delete the copied profiles. (These profiles are missing store group membership data). You can then recopy and publish the profiles.

    1. To locate copied profiles, use the Profiles view and check the Independent profiles only check box to search for all independent profiles in the system.

    2. Unpublish the profiles that were published from copied profiles. This will clean up the published profile library for the profiles that are missing store group membership.

    3. Delete the copied profiles since these profiles do not have the appropriate store group membership data.

    4. If you need to re-publish the above profiles:

    a. Re-copy those profiles.
    b. Make your changes to the newly-copied profiles.
    c. Re-publish the newly copied profiles.
    Previously copied-and-published profiles with missing store groups data will now be created correctly via the newly copied profiles.


    This completes the installation of hot fix C42001 on 64-bit Enabled AIX.