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.

Intel(R) RAID 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 Modules 
   RMS3JC080, RMS3VC160, MS3HC080, RMS3CC080, RMS3CC040, RMS3AC160, 
   RMSP3AD160F, RMSP3CD080F, RMSP3HD080E.

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

NOTE: Expander's firmware level: Expander firmware must be at least B057.
       
********************************************************************************

********************************************************************************
Known Restrictions:
****************************************************************************************************************
Expander's firmware level must be at least B057.
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_CPLD_Update_README		This file
Linux_Firmware_Update_README		Readme file for Firmware 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 updating RAID Expander Firmware through a running Linux system:
-----------------
NOTE: Make sure your expander is at least at B057 firmware level.
  
Instructions for expander behind IT/IR RAID module or 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 drive
	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 (If sg_utils are already installed, go to step 6)
		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 (If Lib utils are already installed, go to step 7)
		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. Identify the expander's device name, it's one line before the expander name. The format of the expander device name is shown as below
		   /dev/sgx
	8. Update expander's CPLD code.
		a. Navigate to USB drive and directory with the Linux utility.
		b. If your expander is an RES3FV240, Run "./fw_tool.sh -c ../../cpld/FV_p00361_20171130.bin <device name>"
		c. If your expander is an RES3TV360, Run "./fw_tool.sh -c ../../cpld/TV_p00363_20171130.bin <device name>"
		   (If a "permission Denied" error appears, just make the fw_tool.sh file executable, by running chmod 777 fw_tool.sh)
	10. Repeat step 8 for each expander found on step 7.
	11. 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 USB drive
	2. Boot the target system to Linux.
	3. Install StorCli (If StorCli is already installed, go to step 4).
		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. Allow bypassing SES commands through the RAID controller
		a. Run "/opt/MegaRAID/storcli/storcli64 -adpsetprop ExposeEnclDevicesEnbl 1 -aall"
		b. Reboot the system for the changes to take effect.
	Once the system comes back on line, continue with step 5.  
	5. Install sg_utils (If sg_utils are already installed, go to step 6)
		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. 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 (If Lib utils are already installed, go to step 7)
		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. Identify the expander's device name, it's one line before the expander name. The format of the expander device name is shown as below
	   	   /dev/sgx
	8. Update expander's CPLD code.
 		a. Navigate to USB drive and directory with the Linux utility.
		b. If your expander is an RES3FV240, Run "./fw_tool.sh -c ../../cpld/FV_p00361_20171130.bin <device name>"
		c. If your expander is an RES3TV360, Run "./fw_tool.sh -c ../../cpld/TV_p00363_20171130.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. Set the RAID controller to stop bypassing SES commands through the RAID controller (default operation mode)
		a. Run "/opt/MegaRAID/storcli/storCLI64 -adpsetprop ExposeEnclDevicesEnbl 0 -aall"

 	11. Reboot the system or power cycle the JBOD.  
   
*********************************************************************************
