Installation Instructions for Hot Fix C50001

Windows


Hot fix C50001 addresses the issue(s) in SAS Financial Management 5.1_M2 on Windows as documented in the Issue(s) Addressed section of the hot fix download page:

http://ftp.sas.com/techsup/download/hotfix/HF2/C50.html#C50001


This hot fix contains updates to the following software components:

SAS Solutions Services Add-in for Microsoft Office 5.1
SAS Financial Management Add-in for Microsoft Excel 5.1

SAS Financial Management Mid-Tier 5.1_M2
SAS Financial Management Web Data Entry 5.1_M2
SAS Solutions Services Mid-Tier 5.1_M2
SAS OLAP Data and Compute Server Mid-Tier for Solutions 5.1_M2

SAS Financial Management 5.1_M2
SAS Financial Management Studio 5.1_M2

SAS Solutions Services Data Server 5.1_M2
SAS Solutions Services Data-Tier 5.1_M1


PRE-INSTALLATION INSTRUCTIONS

  1. 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.

  2. Backup the entire SAS Financial Management 5.1_M2 system, all tiers. This will entail stopping all SAS sessions, daemons, spawners, and servers. Instructions for using the Metadata Backup Wizard can be found in the SAS 9.2 Intelligence Platform - System Administration Guide in Part 4, Chapter 10. The easiest method is to use the Backup Wizard, but if this method is to be used, it is imperative to ensure that the appropriate User Credentials are used. Chapters 9 - 11 cover all of the methods for metadata backup.

    If there are problems backing up the metadata, open a Technical Support Track with the Metadata Support Team.

  3. If a combined SAS Financial Management and SAS Strategy Management environment is being updated, please review SAS Note 41007 before beginning the hot fix installation process. This SAS Note provides additional installation instructions.


IMPORTANT NOTES

  1. Files delivered in this hot fix will be backed up during the installation process. However, Technical Support strongly recommends that you back up your system before applying updates to software.

  2. You must have Administrator Privileges on your CLIENT or SERVER machine.

  3. All currently active SAS sessions, daemons, spawners and servers must be terminated before applying this hot fix.

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


INSTALLATION


The installer downloaded is C50001wn.exe.
  1. Copy C50001wn.exe to each Windows machine where SAS Financial Management 5.1_M2 components are installed.

  2. Execute C50001wn.exe on each machine where SAS Financial Management 5.1_M2 components are installed.


This will initiate the installation wizard, which will guide you through the hot fix installation process. The installation process will determine which components of SAS Financial Management 5.1_M2 are installed on the machine, and apply the appropriate updates.

If 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.


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


This completes the installation of this hot fix. Post-installation steps must be performed to successfully complete the deployment of this hot fix.


POST-INSTALLATION INSTRUCTIONS

For each product installed, click the link to be redirected to post-installation instructions.

SAS Solutions Services Add-in for Microsoft Office 5.1
SAS Financial Management Add-in for Microsoft Excel 5.1

SAS Financial Management Mid-Tier 5.1_M2
SAS Financial Management Web Data Entry 5.1_M2
SAS Solutions Services Mid-Tier 5.1_M2
SAS OLAP Data and Compute Server Mid-Tier for Solutions 5.1_M2

SAS Financial Management 5.1_M2
SAS Financial Management Studio 5.1_M2

SAS Solutions Services Data Server 5.1_M2
SAS Solutions Services Data-Tier 5.1_M1

After the post-installation instructions have been completed, all Web Servers and Remote Services must be restarted.


SAS Solutions Services Add-in for Microsoft Office 5.1

None

Back to Post-Installation list


SAS Financial Management Add-in for Microsoft Excel 5.1

None

Back to Post-Installation list


SAS Financial Management Mid-Tier 5.1_M2

Updates to the SAS Financial Management Mid-Tier 5.1_M2 provided in this hot fix require that Web Applications be rebuilt and redeployed. If this component is installed on Windows, 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. Invoke the SAS Deployment Manager 9.2

From the SASDeploymentManager directory launch config.exe.
SAS Deployment Manager is installed in the following default location:

<SASHOME>\SASDeploymentManager\9.2

2. Select a language in the Choose Language box

3. Select Rebuild Web Applications

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

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

6. Select SAS Financial Management Mid-Tier 5.1 as the Web Application to Rebuild

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

8. Select Finish when the deployment is complete

This process will update the SAS Financial Management Mid-Tier 5.1_M2 ear in

<SASCONFIGDIR>\Web\Staging
A backup of the original ear file will be placed in the directory
<SASCONFIGDIR>\Web\Staging\Backup
Re-deploy Web Application

1. Re-deploy the web application using WebLogic Admin console.

To deploy this application it is important to deploy from <SASCONFIGDIR>\Web\Staging\sas.financialmanagement51.ear. Also verify that in the settings overview tab for sas.financialmanagement5.1.ear that the deployment order is set to 110.

Back to Post-Installation list


SAS Financial Management Web Data Entry 5.1_M2

Updates to the SAS Financial Management Web Data Entry 5.1_M2 provided in this hot fix require that Web Applications be rebuilt and redeployed. If this component is installed on Windows, 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. Invoke the SAS Deployment Manager 9.2

From the SASDeploymentManager directory launch config.exe.
SAS Deployment Manager is installed in the following default location:

<SASHOME>\SASDeploymentManager\9.2

2. Select a language in the Choose Language box

3. Select Rebuild Web Applications

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

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

6. Select SAS Financial Management Web Data Entry 5.1 as the Web Application to Rebuild

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

8. Select Finish when the deployment is complete

This process will update the SAS Financial Management Web Data Entry 5.1_M2 ear in

<SASCONFIGDIR>\Web\Staging
A backup of the original ear file will be placed in the directory
<SASCONFIGDIR>\Web\Staging\Backup
Re-deploy Web Application

1. Re-deploy the web application using WebLogic Admin console.

To deploy this application it is important to deploy from <SASCONFIGDIR>\Web\Staging\sas.financialmanagementwde5.1.ear. Also verify that in the settings overview tab for sas.financialmanagementwde5.1.ear that the deployment order is set to 110.

Back to Post-Installation list


SAS Solutions Services Mid-Tier 5.1_M2

To perform the metadata portion of this fix, perform the following steps:

1. Logon to the MID-TIER with the same userid that was used to install the SAS software.

2. Extract

C:\Program Files\SAS\SASSolutionsServicesMidTier\5.1\Config\deploy\temp51.zip
to C:\.

The directories/files will be extracted to

C:\temp51\GroovyLoad
C:\temp51\apache-ant-1.7.0
Note: The Ant environment is the standard Ant with four additional JAR files
ant-contrib.jar
bsf.jar
commons-logging-1.1.jar
groovy-all-1.5.1.jar
3. Edit the SDW.PROPERTIES file located in
C:\temp51\GroovyLoad\Source\content\sdw.properties.
Only update the first four entries to match your environment:
omr.host=FULLY_QUALIFIED_HOSTNAME
omr.port=8561
admin.user=sasadm@saspw
admin.pass=PasswordPassword1
Note: You should verify that you can open SAS Management Console with the above admin.user and admin.pass values.

4. Open a command window.

a. Verify that the Java environment has been installed by executing
java -version
Java 1.6.0_XX should have been installed during initial deployment. If the above command returns a "not recognized..." message, then add the installed Java to the path:
Example:
set PATH=C:\Java\jdk1.6.0_16\bin;%PATH%;
Rerun "java -version" to make sure the change to the PATH environment variable was successful.
b. Set the ANT_HOME environment variable
set ANT_HOME=C:\temp51\apache-ant-1.7.0
c. Update the PATH environment variable
set PATH=%ANT_HOME%\bin;%PATH%;
d. Change to the following directory
cd C:\temp51\GroovyLoad\Source\content
e. Add the Cube, DataExploration, InformationMap, and WebReportStudio ContentTypes to the Solutions Svcs 5.1 SoftwareComponent (update ContentTypes) by running
ant installContentTypes
There should be no Java exceptions, and a BUILD SUCCESSFUL message should be displayed.
f. Create the Add to Portlet, Comment, Link, Properties and View Directives for the new DataExploration and WebReportStudio ContentTypes under the Solutions Svcs 5.1 SoftwareComponent by running
ant installDirectives
There should be no Java exceptions, and a BUILD SUCCESSFUL message should be displayed.
Note: If you do not see a BUILD SUCCESSFUL for each ant command, open a HIGH PRIORITY track with Technical Support for assistance. Please include the following information
1. Entire Ant build message(s)
2. Output from "set <RETURN>"



Updates to the SAS Solutions Services Mid-Tier 5.1_M2 provided in this hot fix require that Web Applications be rebuilt and redeployed. If this component is installed on Windows, 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. Invoke the SAS Deployment Manager 9.2

From the SASDeploymentManager directory launch config.exe.
SAS Deployment Manager is installed in the following default location:

<SASHOME>\SASDeploymentManager\9.2

2. Select a language in the Choose Language box

3. Select Rebuild Web Applications

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

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

6. Select SAS Solutions Services Mid-Tier 5.1 as the Web Application to Rebuild

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

8. Select Finish when the deployment is complete

This process will update the SAS Solutions Services Mid-Tier 5.1_M2 ear in

<SASCONFIGDIR>\Web\Staging
A backup of the original ear file will be placed in the directory
<SASCONFIGDIR>\Web\Staging\Backup
Re-deploy Web Application

1. Re-deploy the web application using WebLogic Admin console.

To deploy this application it is important to deploy from <SASCONFIGDIR>\Web\Staging\sas.solutionservices5.1.ear. Also verify that in the settings overview tab for sas.solutionservices5.1.ear that the deployment order is set to 100.

Back to Post-Installation list


SAS OLAP Data and Compute Server Mid-Tier for Solutions 5.1_M2

Updates to the SAS OLAP Data and Compute Server Mid-Tier for Solutions 5.1_M2 provided in this hot fix require that Web Applications be rebuilt and redeployed. If this component is installed on Windows, 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. Invoke the SAS Deployment Manager 9.2

From the SASDeploymentManager directory launch config.exe.
SAS Deployment Manager is installed in the following default location:

<SASHOME>\SASDeploymentManager\9.2

2. Select a language in the Choose Language box

3. Select Rebuild Web Applications

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

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

6. Select SAS OLAP Data and Compute Server Mid-Tier for Solutions 5.1 as the Web Application to Rebuild

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

8. Select Finish when the deployment is complete

This process will update the SAS OLAP Data and Compute Server Mid-Tier for Solutions 5.1_M2 ear in

<SASCONFIGDIR>\Web\Staging
A backup of the original ear file will be placed in the directory
<SASCONFIGDIR>\Web\Staging\Backup
Re-deploy Web Application

1. Re-deploy the web application using WebLogic Admin console.

To deploy this application it is important to deploy from <SASCONFIGDIR>\Web\Staging\ sas.solutionsodcs5.1.ear. Also verify that in the settings overview tab for sas.solutionsodcs5.1.ear that the deployment order is set to 100.

Back to Post-Installation list


SAS Financial Management 5.1_M2

None

Back to Post-Installation list


SAS Financial Management Studio 5.1_M2

None

Back to Post-Installation list


SAS Solutions Services Data Server 5.1_M2

None

Back to Post-Installation list


SAS Solutions Services Data-Tier 5.1_M1

None

Back to Post-Installation list



This completes the deployment of hot fix C50001 on Windows.