INSTALLATION INSTRUCTIONS FOR HOT FIX 42FI02 ON WINDOWS


The hot fix 42FI02 addresses the issue(s) in 4.2 of SAS Financial Management
software on Windows as documented in the "Issue(s) Addressed" section of
the hot fix download page:

   http://ftp.sas.com/techsup/download/hotfix/fms42.html#42fi02



IMPORTANT NOTE(S):

1.  You must have SAS Financial Management 4.2 installed on your 
    system before applying this hot fix.

2.  You must have Administrator Privileges on your CLIENT or SERVER machine
    and all currently active Financial Management sessions must be terminated 
    before applying this hot fix.



INSTALLATION:


STEP 1:  Extract the contents of the downloaded file

The hot fix package downloaded is a self extracting exe named 42FI02wn.exe.  
This exe file contains the script and supporting files to update Financial 
Management Data, Metadata and Clients.  To install this hot fix follow these 
steps:

1.  Launch 42FI02wn.exe.  This extracts four components of this hot fix into
C:\42FI02.  The four components extracted are:

  CMExcelAddin.exe
         contains common Excel Add-in updates

   FMClient.exe
         contains rich client updates

  FMExcelAddin.exe
         contains Excel Add-in updates specific to SAS Financial Management

   sssx2Midtier.exe
         contains Mid-tier updates


STEP 2:  Extracting sssx2Midtier.exe to build mid-tier and data-tier bat files

1. Run  sssx2Midtier.exe to extract the hotfix installation files onto your server 
into a directory (for example, c:\SAS).  

Running the  sssx2Midtier.exe will create a hotfix directory inside the directory 
specified during execution, named Hotfix_yyyymmdd, where yyyymmdd is the 
build date of the hotfix.  This is the 'Hotfix directory' and is the location of the 
files used below.

If you are running a multiple-server deployment, be sure to extract the files on 
both the mid-tier and data tier servers.  

The extract contains several directories and a set of files in the Hotfix directory, 
including Readme.txt, hotfixEnv.cmd, Hotfix_Datatier.bat and Hotfix_Midtier.bat. 
Additional instructions are also included in the Readme.txt file.

2. Edit the hotfixEnv.cmd file to specify the location of your local SAS Solutions 
Configuration directory. By default, this location is c:\SAS\SASSolutionsConfig.

3. To update a data tier environment (that is, the machine or machines that host 
SAS 9.1, the SAS Metadata Server, etc.), run Hotfix_Datatier.bat 

Note that is safe to ignore the following messages if you receive them:

    “Error: Cannot open file soltnsmid.properties; ignoring”.

and

    "System error 1060 has occurred.

    The specified service does not exist as an installed service.


4. To update a mid tier environment (that is, the machine that hosts the Weblogic 
application server and SAS services)

   a) Make sure that the SAS Managed Server under Weblogic and the SAS 
       Services are stopped.

   b) Run Hotfix_Midtier.bat. 

       Note that it is safe to ignore the message 

           “Error: Cannot open file soltnsdata.properties; ignoring”.

       It is also safe to ignore messages where locations could not be found under
       the 'bea' application directory.  This means that the hot fix installation could 
       not find products that are likely not installed.  For example, a message that
       would be generated if SAS Human Capital Management is not installed would
       look like the following:

           "C:\bea\user_projects\domains\SASSolutions\applications\sas.solutions.
            humancapital.ear does not exist"

   c) Restart SAS Services and the SAS Managed Server.


STEP 3:  Installing FMClient.exe on the client machine

Launching this executable will initiate the install wizard, which will guide 
you through the setup process.  The setup progress will install the updated 
files to your client.


STEP 4:  Installing CMExcelAddin.exe on the client machine

Launching this executable will initiate the install wizard, which will guide 
you through the setup process.  The setup progress will install the updated 
files to your client.


STEP 5:  Installing FMExcelAddin.exe on the client machine

Launching this executable will initiate the install wizard, which will guide 
you through the setup process.  The setup progress will install the updated 
files to your client.



This completes the installation of hot fix 42FI02 on Windows. 


~~~
Information about the hotfix:

The Hotfix_Midtier.bat replaces the following jars on the mid tier:

sas.iquery.metadata.jar
sas.solutions.commonapp.i18n.jar        sas.solutions.commonapp.jar
sas.solutions.finance.api.i18n.jar      sas.solutions.finance.api.jar
sas.solutions.finance.client.jar        sas.solutions.finance.server.i18n.jar
sas.solutions.finance.server.jar        sas.solutions.formula.i18n.jar
sas.solutions.formula.jar               sas.solutions.hcm.core.i18n.jar
sas.solutions.hcm.core.jar              sas.solutions.hcm.webapp.i18n.jar
sas.solutions.hcm.webapp.jar            sas.solutions.odcs.client.jar
sas.solutions.odcs.jar                  sas.solutions.odcs.test.jar
sas.solutions.security.server.jar       sas.solutions.spm.core.i18n.jar
sas.solutions.spm.core.jar              sas.solutions.spm.webapp.i18n.jar
sas.solutions.spm.webapp.jar            

Please note that any changes made to these jars prior to running 
this hotfix may be lost.