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 Controller Compatibility:
Intel(R) RAID controllers/SAS adapters RS3UC080, RS3UC080J, RS3FC044, RS3GC008, RS3MC044, RS3DC080, RS3DC040, RS3SC008, RS3WC080.
Intel(R) Integrated RAID Modules RMS3JC080, RMS3VC160, MS3HC080, RMS3CC080, RMS3CC040, RMS3AC160.

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_README.txt				This file
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-1.13.06-1.noarch.rpm		RPM for StorCli installation
fw_tool.sh				Expander firmware update script

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

Instructions for updating RAID Expander Firmware through a running Linux system:
-----------------
  
 i) For expander behind IT/IR RAID module or controller adapter (RS3FC044, RS3UC080, RS3UC080J, RS3GC008, RMS3JC080, RMS3VC160)
    ** 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. Install the sg_utils RPM, (rpm -ivh sg3_utils-1.34-1.src.rpm) this command will create a sg3_utils-1.34.tgz file on the /root/rpmbuild/SOURCES directory
	c. Navigate to the /root/rpmbuild/SOURCES directory
	d. Decompress the sg3_utils-1.34.tgz (tar -xvf sg3_utils-1.34.tgz)
	e. Navigate to the /root/rpmbuild/SOURCES/sg3_utils-134 directory
	f. run ./configure
	g. run make
	h. run make install
     6. Install Lib Utils
	Navigate to USB drive and directory with the Linux utility.
	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. Run "./fw_tool.sh --fw_update ../../binary/firmware_image.bin <device name>"
     9. Reboot the system or power cycle the JBOD. Optionally you can reset expander by running "sg_ses --page=0x04  --control  --data=02,02 <device name>
     10. Repeat step 8 for each expander found on step 7.


ii)For expander behind an MR RAID module or controller (RS3MC044, RS3DC080, RS3DC040, RS3SC008, RS3WC080, MS3HC080, RMS3CC080, RMS3CC040, RMS3AC160)
  
    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-1.13.06-1.noarch
    4. Find enclosure device ID
		a. Run "/opt/MegaRAID/storcli/storcli64 /call /eall show (N=adapter number, default = 0)
		b. Take note of the Enclosure ID (EID) shown for the expander device (RES3TV360 or RES3FV288or  JBOD2312S3SP)
		   (example EID = 91)
    6. Update expander.
		a. Run "/opt/MegaRAID/storcli/storcli64 /cN/Exx download src= ../../binary/firmware_image.bin forceActivate" (N=adapter number, default = 0; xx=EID)
		   (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.
    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.
   
*********************************************************************************
