This release note and the software that accompanies it are copyright (c) 2018, 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 Gen3 RAID controller or SAS adapter and drivers to support inband interface.

RAID(R) Controller Compatibility:
   Intel(R) RAID controllers/SAS adapters 
   RS3UC080, RS3UC080J, RS3FC044, RS3GC008, RS3MC044, RS3DC080, RS3DC040, RS3SC008, RS3WC080, 
   RSP3TD160F, RSP3MD088F, RSP3DD080F, RSP3WD080E, RSP3QD160J, RSP3GD016J.

Intel(R) Integrated RAID Module Compatibility:
   RMS3JC080, RMS3VC160, MS3HC080, RMS3CC080, RMS3CC040, RMS3AC160, 
   RMSP3AD160F, RMSP3CD080F, RMSP3HD080E.

Expander Compatibility:
    Compatible with the following Intel(R) SAS3x Expanders and JBODs.
    RES3FV288, RES3TV360, JBOD2312S3SP
       


********************************************************************************
Known Restrictions:
********************************************************************************
Expander behind a MegaRAID RAID module or controller requires minimum firmware level of B012.
Expander behind  an IT/IR RAID controller or SAS adapter requires a C compiler to be installed on the Linux system.



********************************************************************************
Contents in the package:
********************************************************************************
The following files are included in this folder
Name:					Description:
Linux_Firmware_Update_README		This file
Linux_CPLD_Update_README		Readme file for CPLD update
Lib_Utils-1.00-09.noarch.rpm		Support libraries for fw_tool.sh Expander firmware update script
sg3_utils-1.34-1src.rpm			RPM for sg3_uitls installation
storcli-007.0415.0000.0000-1.noarch.rpm	RPM for StorCli installation
fw_tool.sh				Expander firmware/CPLD update script



********************************************************************************
Installation Instructions (Linux):
   Please note steps for upgrading expander behind an IT/IR controller are 
   different than for expander behind MR controller, as shown below.  
********************************************************************************

Instructions for expander behind IT/IR RAID module or controller adapter
	(RS3FC044, RS3UC080, RS3UC080J, RS3GC008, RMS3JC080, RMS3VC160, 
	RMSP3JD160J, RSP3QD160J, RSP3GD016J)
	NOTE: *** LINUX SYSTEM MUST HAVE A C COMPILER INSTALLED ***

	1. Download and extract all files to a USB key.
	2. Logon THE SYSTEM as root
	3. Connect USB key to system and mount it under Linux.
	4. Navigate to directory with the Linux utility.
	5. Install sg_utils.
		a. Navigate to USB drive and directory with the Linux utility.
		b. run "rpm -ivh sg3_utils-1.34-1.src.rpm" 
            	   This will install the sg_utils, creating a sg3_utils-1.34.tgz file in the "/root/rpmbuild/SOURCES" directory
		c. Navigate to the /root/rpmbuild/SOURCES directory
		d. Uncompress the sg3_utils-1.34.tgz (tar -xvf sg3_utils-1.34.tgz)
		e. Navigate to the /root/rpmbuild/SOURCES/sg3_utils-1.34 directory
		f. run ./configure
		g. run make
		h. run make install
	6. Install Lib Utils
		a. Navigate to USB drive and directory with the Linux utility.
		b. Install the Lib_Utils RPM, (rpm -ivh Lib_Utils-1.00-09.noarch.rpm)
	7. Find expander(s) device name.
		a. Run sg_scan -i
		b. The format of the expander device name is shown as below
		   /dev/sgx
	8. Update expander fw.
		a. Navigate to USB drive and directory with the Linux utility.
		b. Run "./fw_tool.sh --fw_update ../../binary/firmware_image.bin <device name>"
		   (If a "permission Denied" error appears, just make the fw_tool.sh file executable, by running chmod 777 fw_tool.sh)
	9. Repeat step 8 for each expander found on step 7.
	10.Reboot the system or power cycle the JBOD. 
_____________________________________________________________________________________________________
   

Instructions for expander behind an MR RAID module or controller 
	(RS3MC044, RS3DC080, RS3DC040, RS3SC008, RS3WC080, MS3HC080, RMS3CC080, RMS3CC040, RMS3AC160, RSP3TD160F
	RSP3MD088F, RSP3DD080F, RSP3WD080E, RMSP3HD080E)
  
	1. Download and extract all files to a local drive.
	2. Boot the target system to Linux.
	3. Install StorCli.
		a. Navigate to the drive and directory with the storcli-007.0415.0000.0000-1.noarch.rpm 
		b. Run "rpm -ivh storcli-007.0415.0000.0000-1.noarch.rpm" to install.
	4. Find controller and corresponding expander enclosure ID
		a. Run "/opt/MegaRAID/storcli/storcli64 /call /eall show" . 
		   A list of controllers is printed on the screen.  Each controller listed will have a table mapping its enclosure IDs (EID) to product IDs (ProdID)
		b. Find the controller number listing an expander ProdID (RES3TV360 or RES3FV288 or JBOD2312S3SP). Example "Controller = 0"   
		c. For each controller showing an expander ProdID=(RES3TV360 or RES3FV288 or JBOD2312S3SP) attached, take note of the corresponding Enclosure ID (EID) 
		   Expect EID to be numeric. Example EID = 91
	5. Update expander Firmware.
		a. Run "/opt/MegaRAID/storcli/storcli64 /cN/Exx download src= ../../binary/firmware_image.bin forceActivate" 
		   In the command above N=controller number found in previous step and xx is the corresponding expander EID found in previous step
		   Example: "/opt/MegaRAID/storcli/storcli64 /c0/E91 download src= ../../binary/firmware_image.bin forceActivate" 
		b. Wait for the message indicating the firmware download has succeeded.
	6. Repeat steps 5 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.
*********************************************************************************
