This release note and the software that accompanies it are copyright (c) 2012, Intel Corporation or its suppliers, and may only be installed and used in accordance with the license that accompanies the software.

This Software is furnished under license and may only be used or copied in accordance with the terms of that license. No license, express or implied, by estoppel or otherwise, to any intellectual property rights is granted by this document. The Software is subject to change without notice, and should not be construed as a commitment by Intel Corporation or its suppliers to market, license, sell or support any product or technology. Unless otherwise provided for in the license under which this Software is provided, the Software is provided AS IS, with no warranties of any kind, express or implied. Except as expressly permitted by the Software license, neither Intel Corporation nor its suppliers assumes any responsibility or liability for any errors or inaccuracies that may appear herein. Except as expressly permitted by the Software license, no part of the Software may be reproduced, stored in a retrieval system, transmitted in any form, or distributed by any means without the express written consent of Intel Corporation.

********************************************************************************
REQUIREMENTS:
********************************************************************************

Server:
    This platform shall have Intel(R) SAS (Gen2 and Gen3) HBA’s and drivers to
    support inband interface.

Host Bus Adapter Compatibility:
    Any HBA that support SCSI pass-through commands. 
    (RMS25JB040, RMS25JB080, RMS25KB040, RS25GB008, RMS3JC080, RS25GB008, RS3FC044,
    RS3UC008, RS3GC008)

RAID Host Bus Adapter Compatibility:
    Any Intel(R) RAID controller that supports sending firmware updates to expanders. 	    
    (RMS25PB080, RMS25PB040,RMT3PB080, RMS25CB080, RMS25CB040, RMT3CB080, RS25SB008,
    RMS25CB080N,RMS25PB080N, RMS3HC080, RMS3CC080, RS3DC080)

Expander Compatibility:
    Compatible with the following Intel(R) SAS3x Expanders.
    RES3FV288, RES3FV288-R, RES3TV360
       
********************************************************************************

********************************************************************************
Known Restrictions:
********************************************************************************

Expander behind 12G SAS MegaRAID HBA requires minimum firmware level of B012.

********************************************************************************

********************************************************************************
Contents in the package:
********************************************************************************

The following files are included in this folder

Name:							Description:
Linux_README.txt				This file
CMDTool2_Linux_v8.04.07_rel-notes.txt	Release notes for CMDTool2
CmdTool2-8.04.07-1.noarch.rpm	RPM for CmdTool2 installation used to enable update of
 								expander behind HWRAID controller
Lib_Utils-1.00-09.noarch.rpm	Supporting libraries for 
fw_tool.sh						Expander update script
sg3_utils-1.34-1src.rpm			RPM for sg3_uitls installation
storcli-1.13.06-1.noarch.rpm		RPM for storcli

********************************************************************************
Installation Instructions:
********************************************************************************

Linux instructions for updating RAID Expander Firmware:
-----------------

Firmware Upgrade through Linux Live CD (RHEL6.2 for example)
 i)For expander behind SAS HBA or On-board SAS/SATA Controller
 (RMS25JB040, RMS25JB080, RMS25KB040, RS25GB008, RMS3JC080, RS25GB008, RS3FC044, RS3UC008, RS3GC008)
    1. Download and extract all files to a USB key.
    2. Boot system from Linux Live CD
    3. Select "Rescue installed system" in Linux boot menu
    4. Select "Local CD/DVD" when "Rescue Method" window appears and 	"Skip" when "Rescue" 	window appears.
    5. Select "shell  Start shell" when prompted.
    6. Connect USB key to system and mount it under Linux.
    7. Navigate to directory with the Linux utility.
    8. Install sg_utils.
	a. Install the sg_utils RPM, run the command "rpm -ivh <sg3	_utils-1.34-1.src.rpm>"
    9. Find expander(s) device name.
		a. Run "sg_scan -i" command
        b. The format of the expander device name is shown as below
		/dev/sgx
    10. Update expander fw.
		a. Run "./fw_tool.sh --fw_update ../../binary/firmware_image.bin 	<device name>"
    11. Power cycle JBOD or reset expander
		a. To reset expander run "sg_ses --page=0x04  --control  --data=02,02 <device name>
    12. Repeat steps 9 - 11 for each expander found.


Firmware Upgrade through running Linux system  
 i)For expander behind SAS HBA or On-board SAS Controller
 (RMS25JB040, RMS25JB080, RMS25KB040, RS25GB008, RMS3JC080, RS25GB008, RS3FC044, RS3UC008, RS3GC008)
    1. Download and extract all files to a local drive.
    2. Boot the target system to Linux.
    3. Navigate to directory with the Linux utility.
    4. Install sg_utils.
		a. Install the sg_utils RPM, run the command "rpm -ivh <sg3	_utils-1.34-1.src.rpm>"
    5. Find expander(s) device name.
		a. Run "sg_scan -i" command
		b. Look for device identification of Intel RES3xxxxx
        c. The format of the expander device name is shown as below
		/dev/sgx
    6. Update expander fw.
		a. Run "./fw_tool.sh --fw_update ../../binary/firmware_image.bin 	<device name>"
    7. Power cycle JBOD or reset expander
		a. To reset expander run "sg_ses --page=0x04  --control  --data=02,02 <device name>
    8. Repeat steps 5 - 7 for each expander found.

 ii)For expander behind 6G SAS MegaRAID HBA
 (RMS25PB080, RMS25PB040,RMT3PB080, RMS25CB080, RMS25CB040, RMT3CB080, RS25SB008, RMS25CB080N,RMS25PB080N)
    1. Download and extract all files to a local drive.
    2. Boot the target system to Linux.
    3. Install CMDTool2.
		a. Install the Lib_Utils RPM, run the command "rpm -ivh 	<Lib_Utils-1.xx-	xx.noarch.rpm>"
		b. Install the CmdTool2 RPM, run the comand "rpm -ivh <CmdTool2-	x.xx-x.noarch.rpm>"
    4. Find enclosure device ID
		a. Run "cmdtool2 -EncInfo -aN" (N=adapter number, default = 0)
	b. The format of the expander device ID shown below
		Enclosure 1:
		Device ID				:xx		(example xx = 11)
	5. Record expander device ID
    6. Update expander.
		a. Run "cmdtool2 -PdFwDownload -EncdevId[xx] -f ..\..\binary\firmware_image.bin -aN" 
    7. Power cycle JBOD
	8. Repeat steps 6 - 7 for each expander found. 
	
iii)For expander behind 12G SAS MegaRAID HBA
 (RMS3HC080, RMS3CC080, RS3DC080)
    1. Download and extract all files to a local drive.
    2. Boot the target system to Linux.
    3. Install storcli.
		a. Install storcli rpm, run the command "rpm -ivh <storcli-x.xx.xx-x.noarch.rpm>"
    4. Find enclosure device ID
		a. Run "/opt/MegaRAID/storcli/storcli -EncInfo -aN" (N=adapter number, default = 0)
		b. The format of the expander device ID shown below
			Enclosure 1:
			Device ID				:xx		(example xx = 11)
	5. Record expander device ID
    6. Update expander.
		a. Run "/opt/MegaRAID/storcli/storcli /CN/Exx download src= ../../binary/firmware_image.bin forceActivate" (N=adapter number, default = 0; xx=enclosure device ID) 
    7. Repeat steps 6 for each expander found. 

*Note - forceActivate switch will cause the expander to reset after the firmware update is complete. Even though the new expander firmware is running, the RAID firmware will not pick up the new expander firmware revision until after a reboot.
   
*********************************************************************************
