This release note and the software that accompanies it are copyright (c) 2012, LSI 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 LSI 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 LSI CORPORATION.


====================
Package Information:
====================
SNMP version = 14.11.0100
Generic SNMP Agent version = 3.18.0.2
SAS-IR Data Collector version = 1.35-01
SAS-IR MIB File	version = 1.28-01
Storelibir version = 5.07-00
Storelibir-2 version = 20.00-00
Storelibir-3 version = 7.00-00
OS supported = RHEL 4, 5, 6, 7 and SLES 9, 10, 11 and 12 and Citrix Xenserver 6.0
This package can be installed on all x64 systems.


=======================================
Prerequisite for LSI SNMP installation:
=======================================
The LSI SNMP agent application depends upon standard SNMP Utils package. 
Please ensure that the SNMP-Util package is present in the system before installing LSI SNMP agent  rpm. 
SNMP-Util package includes the rpm's net-snmp-libs , net-snmp-utils  and additional dependent RPM's.
Please make sure that these RPM's are installed from the OS media before installing the LSI SNMP agent rpm.

Prior to install SNMP, check for existence of libstdc++.so.6
Library is present in /usr/lib directory. If not present/ installed, 
then install the Linux software component RPM that provides these libraries.
These RPM's will be available in the OS DVD. 

Note:
1. Net-SNMP rpm installation is required before we install agent rpms. 
   RHEL 4.8:
				net-snmp-5.1.2-18.el4.x86_64.rpm
                net-snmp-utils-5.1.2-18.el4.x86_64.rpm
    RHEL5.4
				lm_sensors-2.10.7-4.el5.x86_64.rpm 
                net-snmp-utils-5.3.2.2-7.el5.x86_64.rpm
                net-snmp-5.3.2.2-7.el5.x86_64.rpm
    RHEL 5.3
                lm_sensors-2.10.7-4.el5.x86_64.rpm
                net-snmp-5.3.2.2-5.el5.x86_64.rpm 
                net-snmp-utils-5.3.2.2-5.el5.x86_64.rpm
    RHEL 5.5
                net-snmp-5.3.2.2-9.el5.x86_64.rpm
                net-snmp-utils-5.3.2.2-9.el5.x86_64.rpm
				
	RHEL 5.6
				net-snmp-5.3.2.2-9.el5_5.1.x86_64.rpm
				net-snmp-utils-5.3.2.2-9.el5_5.1.x86_64
				
	RHEL 5.7
				net-snmp-5.3.2.2-14.el5_5.1.x86_64.rpm
				net-snmp-utils-5.3.2.2-14.el5_5.1.x86_64
				
	RHEL 5.8
				net-snmp-5.3.2.2-17.el5_5.1.x86_64.rpm
				net-snmp-utils-5.3.2.2-17.el5_5.1.x86_64
				
	RHEL 5.9
				net-snmp-5.3.2.2-20.el5_5.1.x86_64.rpm
				net-snmp-utils-5.3.2.2-20.el5_5.1.x86_64
				
	RHEL 5.10
				net-snmp-5.3.2.2-20.el5.x86_64.rpm 
				net-snmp-utils-5.3.2.2-20.el5.x86_64 
				
	RHEL 5.11
				net-snmp-5.3.2.2-22.el5_10.1.x86_64.rpm 
				net-snmp-utils-5.3.2.2-22.el5_10.1.x86_64.x86_64
	
	RHEL 6.0
				net-snmp-5.5-27.el6.x86_64.rpm
				net-snmp-utils-5.5-27.el6.x86_64
				
	RHEL 6.1
				net-snmp-5.5-31.el6.x86_64.rpm
				net-snmp-utils-5.5-31.el6.x86_64.rpm
				
	RHEL 6.2
				net-snmp-5.5-37.el6.x86_64.rpm
				net-snmp-utils-5.5-37.el6.x86_64.rpm
				
	RHEL 6.3
				net-snmp-5.5-39.el6.x86_64.rpm
				net-snmp-utils-5.5-39.el6.x86_64.rpm
				
	RHEL 6.4
				net-snmp-5.5-44.el6.x86_64.rpm
				net-snmp-utils-5.5-44.el6.x86_64.rpm
			
	RHEL 6.5
				net-snmp-5.5-49.el6.x86_64.rpm
				net-snmp-utils-5.5-49.el6.x86_64.rpm
				
	RHEL 6.6
				net-snmp-5.5-49.el6_5.3.x86_64.rpm
				net-snmp-utils-5.5-49.el6_5.3.x86_64.rpm
	
	RHEL 7.0
				net-snmp-5.7.2-18.el7.x86_64.rpm
				net-snmp-utils-5.7.2-18.el7.x86_64.rpm

	SLES  11
             	net-snmp-5.4.2.1-8.1.x86_64.rpm
             	perl-SNMP-5.4.2.1-8.1.x86_64.rpm
						
	SLES11 SP3
				net-snmp-5.4.2.1-8.12.16.1.1.x86_64.rpm
				perl-SNMP-5.4.2.1-8.12.16.1.x86_64.rpm
				
	SLES12
				net-snmp-5.7.2.1-3.8.x86_64.rpm
				perl-SNMP-5.7.2.1-3.8.x86_64.rpm

2. In case you are unable to install lsi snmp agent rpms, use rpm -ivh - - force *.rpm and then you can uninstall the lsi rpms using rpm -e *.rpm. 
 
3. In case of problems with installing multiple rpms and get into cyclic redundancy issue, one can install all rpms in one command line. 
   (Example: rpm  -ivh net-snmp-5.4.2.1-8.1.x86_64.rpm perl-SNMP-5.4.2.1-8.1.x86_64.rpm)


===============================================================================
Installation procedure for LSI SNMP Agent(For SUSE, RHEL and Citrix XenServer):
===============================================================================

1. LSI SNMP Agent rpm's installs the agents. 

2. rpm will take care of the necessary modification needed in the snmpd.conf
file for running the agent.
[
NB: Before installation please check,there is any pass command 
    starts with 1.3.6.1.4.1.3582 OID in snmpd.conf, if available then delete
all the old pass commands starts with 1.3.6.1.4.1.3582 OID.
(This could be possible if there is any previous LSI SNMP Agent was installed
in the system)
]
3. The snmpd.conf file structure should be same as lsi_mrdsnmpd.conf. For
reference,a sample conf file (lsi_mrdsnmpd.conf) will be there in the
/etc/lsi_mrdsnmp directory. 

4. For running SNMP query from a remote m/c add the ip address of that m/c in
the snmpd.conf file like this..

   com2sec	snmpclient	172.28.136.112		public

   Here ipaddress of the remote m/c is 172.28.136.112

5. For receiving snmp trap to a particular m/c, add the ip address of that m/c
in the com2sec section of snmpd.conf file. For example, to get Trap in
10.0.0.144, then add following line to snmpd.conf.
#       sec.name	source			community
   com2sec	snmpclient	10.0.0.144		public

6. To Run/stop the snmpd daemon.
   	/etc/init.d/snmpd start/stop
	RHEL 7.0/OEL 7.0: systemctl start/stop snmpd.service
 
7. To start/stop the SNMP Agent daemon before issuing any snmp query.
	/etc/init.d/lsi_mrdsnmpd start/stop
	RHEL 7.0/OEL 7.0: systemctl start/stop lsi_mrdsnmpd.service

8. Status of the SNMP Agent daemon can be checked by issuing the following
command...
   	/etc/init.d/lsi_mrdsnmpd status
	RHEL 7.0/OEL 7.0: systemctl status lsi_mrdsnmpd.service

9. You can issue snmp query like this...

    snmpwalk -v1 -c public localhost .1.3.6.1.4.1.3582

10. You can get the snmp trap from local m/c by issuing the following
command...
    snmptrapd -P -F "%02.2h:%02.2j TRAP%w.%q from %A %v\n" 

11. Please follow the below steps to configure traps.
	Edit /etc/lsi_mrdsnmp/sas-ir/sas_ir_TrapDestination.conf file & add ipaddress as
	shown below.

	#################################################
	# Agent Service needs the IP addresses to sent trap
	# The trap destination may be specified in this file or
	# using snmpd.conf file. Following indicators can be set
	# on "TrapDestInd" to instruct the agent to pick the IPs
	# as the destination.
	# 1 - IPs only from snmpd.conf
	# 2 - IPs from this file only
	# 3 - IPs from both the files
	#################################################
	TrapDestInd 2
	#############Trap Destination IP##################
	127.0.0.1   public
	172.28.157.149 public
	#################################################
	
NOTE:
1. If in case, 'TrapDestInd' above is set to 1, IP addresses shall be taken from '/etc/snmp/snmpd.conf' in the following format:
'com2sec snmpclient 172.28.157.149 public'
'Trapsink' and 'TrapCommunity' tokens are supported for sending customised SNMP traps.

2. To send SNMP traps to custom ports, please use as follows in 'sas_TrapDestination.conf':
'172.28.157.149:1234	testComm'
In this case, SNMP trap shall be sent to IP 172.28.157.149 at port number 1234 with community as 'testComm'.
If in case, no port number is mentioned, default SNMP trap port 162 shall be used for sending SNMP traps.
	
NOTE:
	For SNMP components to work, it is necessary that linux system should
have snmp-net packages(rpm) to be already present.

	It is assumed that snmpd.conf is located at /etc/snmp for Redhat and
/etc for SuSE. Anyway, user can change the file location from
/etc/init.d/lsi_mrdsnmpd file

	RPM upgrade option is not supported until version v13.04.01.00. User needs to manually
uninstall previous SNMP package and install latest SNMP package.

	The RPM upgrade support is applicable from v13.04.01.00 to higher versions only.
		
	Command used for update: "rpm -Uvh <LSI-SNMP rpm>"
This command uninstalls the previous LSI SNMP rpm and installs the latest LSI SNMP rpm.


================================
SNMP Trap Disable functionality:
================================
User may disable SNMP Trap functionality using "-notrap" as install(install.csh) parameter.


===================
Known Restrictions:
===================

If any previous installed HPOV present in which SAS or, SAS-IR mib loaded, then clean any existing LSI Trap definition from HPOV's trapd.conf [or, reinstall HPOV].

For any set operation, user may need to wait 10-15 secs to see the changed value.

Net-SNMP service doesn't send any error message for failure of SNMP-SET even if agent returns a proper error code. This thing has been seen only if agent is implemented in "pass-thru" way.

After Loading a MIB file in HPOV, close "Alarm Categories" window and then reopen it from Fault->Alarms.

In RHEL 5 Firewall and SELinux option must be disabled.


NOTE:
1.	User can install SNMP without the trap functionality. To do so, Set "TRAPIND" envronment variable to "N" before running rpm.

	For SLES 9:
		1.  Copy /etc/snmp/snmpd.conf to /etc/snmpd.conf. 
		2.  Modify /etc/init.d/snmpd file. and change SNMPDCONF=/etc/snmp/snmpd.conf entry to SNMPDCONF=/etc/snmpd.conf.
		3. Run LSI SNMP rpm.
			
	To use SNMP in Citrix Xen Server OS, download the "net-snmp-utils" rpm from below link and install the rpm with --nodeps option.
	http://rpm.pbone.net/index.php3/stat/4/idpl/18097762/dir/centos_5/com/net-snmp-utils-5.3.2.2-17.el5_8.1.i386.rpm.html

	In case of problems with installing above NET-SNMP rpm due to dependency issues, one can install rpm using rpm -ivh *.rpm --nodeps
	To ignore the dependencies use the following command: 'rpm -ivh net-snmp-utils-5.3.2.2-17.el5_8.1.i386.rpm --nodeps'

	To enable SNMP query on the Citrix XenServer from remote machines, iptables need to be modified. This can be done as follows:
	1.	Execute following command: system-config-securitylevel-tui
	2.	Select 'Customize'
	3.	Select 'Other ports' and next add the following text: snmp:udp
	4.	Select 'OK' and again 'OK'
	5.	Restart snmp and lsi snmp services

2.	With the usage of the components version MR 5.8 or MR 6.1 firmware and MR5.5, 5.6, 5,7 & MR6.0 SNMP builds, 
	the following issue is observed with 4k drives: Wrong value will be observed When user query for logical drive stripe size.
	To avoid this issue use the latest MR 5.8 or MR 6.1 SNMP build.


==============
Fixes/Updates:
==============

14.11.00.01

MR 6.6

Defects:
1) SCGCQ00758121: SNMP ReadMe should be updated with OEL 7.0 support commands.

14.11.00.02

Enhancements:
1) SCGCQ00663903: End Customer: KDDIQuestion: According to the lsi-adaptersas.mib, 
		    KDDI think the severity of the below SNMP trap should be cr.
			
14.11.00.03

Defects:

MR 6.6

1) SCGCQ00774873: MR6.6:SNMP: HOSTOSINFO showing N/A

SyncroCS 2.1

1) SCGCQ00762199: Syncro SSHA : MSM RHEL 6.5 -> Glibc detect /usr/sbin/lsi_mrdsnmpagent : malloc(): memory corruption error while install MSM. 

14.11.00.05

Repackaged with Latest SL, SLIR2 and SLIR3 Libraries.

14.11.01.00

Repackaged with Latest SL v4.30.1 and SLIR3 v7.00 Libraries.

Defects:

MR 5.13

1) SCGCQ00789202: Windows SNMP Compilation failed "MaintenanceMode" must start with lowercase letter" this is error in mib compiler