Documentation

• • •

This chapter explains how to install and configure the PERC 2 SNMP Subagent on the following platforms:

Windows NT server or client
Windows 2000 server or client
Novell NetWare server
Linux

This chapter also explains how to configure HP Openview on a Windows NT or Windows 2000 client to view traps generated by the SNMP Subagent.

Note: Before installing the PERC 2 SNMP Subagent on your system, you must first install and configure the SNMP service and master agent for your operating system. For more information, refer to the appropriate SNMP master agent documentation for your operating system.

Installing the PERC 2 SNMP Subagent on Windows or NetWare

The kit containing the PERC 2 SNMP Subagent for your controller might be delivered on a CD-ROM, diskette, or can be down-loaded from the Dell Web site. These instructions assume that you will use the kit delivered on diskette.

To install the PERC 2 SNMP Subagent on a Windows NT or Windows 2000 system, follow these steps:

If FAST or Array Manager is installed on your system, from a command prompt window, stop the remote agent by entering the following command:
```
 net stop afa_agent
```
Stop the SNMP service by entering the following command in a command prompt window:
```
 net stop snmp
```
If FAST or Array Manager is installed on your system, rename the following dll files with a .nosnmp extension:
```
 C:\Program Files\PERC2\AFA\afaapi.dll
C:\Program Files\PERC2\AFA\afaappse.dll
```
Place the diskette that contains the PERC 2 SNMP Subagent software in the diskette drive.
Install the PERC 2 SNMP Subagent software by copying all the files from the NT\SNMP folder on the diskette to the C:\Program Files\PERC2\AFA folder.
Use the Windows NT Registry Editor (regedt32) to add an entry for the SNMP Subagent, as follows:
1. At the command prompt, run regedt32.
2. In the Registry Editor, locate the following key and select it:
```
 HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Services
\SNMP\Parameters
```
3. Choose Add Key from the Edit menu.
4. In the Key Name field, type ExtensionAgents, and click OK.
5. In the Registry Editor window, select the newly added ExtensionAgents key, and choose Add Value from the Edit menu.
6. In the Value Name field, type AFASNMP. Set the Data Type to REG_SZ, and click OK.
7. In the String field, enter the following:
```
 SOFTWARE\Adaptec\RaidController\AFA\CurrentVersion
```
  Click OK.
Use the Registry Editor to add an entry for the SNMP Subagent dll, as follows:
1. In the Registry Editor, locate the following key and select it:
```
 HKEY_LOCAL_MACHINE\Software\Adaptec\RaidController
\AFA\CurrentVersion
```
2. Choose Add Value from the Edit menu.
3. In the Value Name field, type Pathname. Set the Data Type to REG_EXPAND_SZ, and click OK.
4. In the String field, enter the following:
```
 %SystemDrive%\program files\PERC2\AFA\AFASNMPE.DLL
```
5. Click OK and exit the Registry Editor.
If FAST or Array Manager is installed on your system, from a command prompt window, enter the following command to restart the SNMP service:
```
 net start snmp
```
If FAST or Array Manager is installed on your system, enter the following command to restart the remote agent:
```
 net start afa_agent
```

Setting up SNMP on NetWare

NetWare systems must be configured to send SNMP traps to a Windows NT or Windows 2000 system where they can be viewed using HP Openview. For each client you want to receive traps, add an entry to the traptarg.cfg file in the sys:etc directory. Instructions for adding these entries are given in comments in the traptarg.cfg file.

Note that the Windows NT or Windows 2000 client system you select to receive the SNMP traps must be running SNMP. If you want to use HP Openview to view the traps, the client must also have HP Openview installed and configured. For information on how to configure HP Openview to view the PERC 2 controller configuration and interpret traps generated by the PERC 2 Subagent, see Configuring HP Openview to Manage a System Running the PERC 2 SNMP Subagent.

To set up a NetWare system to generate SNMP traps, follow these steps:

Install the HP NetServer Agents and Desktop Management Interface (DMI) software on your NetWare system from the networked Windows NT or Windows 2000 system that will receive the NetWare traps. For information on how to perform this installation, see the appropriate HP NetServer documentation.
To activate the NetServer Agents and DMI software, reboot your NetWare system by entering the following command at the NetWare console (or if you have rconsole configured, on your Windows NT or Windows 2000 system):
```
 nsaload
```

Linux Environment

The afasnmp SNMP Subagent for your controller may be delivered on a diskette or may be downloaded from the Dell Web site. These instructions assume that the afasnmp SNMP Subagent for your controller is being delivered on a diskette.

Installing or Upgrading the PERC 2 SNMP Subagent

To install or upgrade the afasnmp SNMP Subagent, follow these steps:

Install and configure the master SNMP agent for your Linux operating system. For more information, see the SNMP documentation for your Linux operating system.
Note: The UCD SNMP master agent that ships with RedHat Linux will not work with the afasnmp SNMP Subagent. The afasnmp SNMP Subagent requires UCD SNMP version 4.1.1 (and only this version). The UCD SNMP master agent must be built from source and configured using the configure command with the following two options:
--enable-reentrant --with-mib-modules="agentx"
Log on as root or become superuser.
If upgrading from an earlier release, check to see if the afasnmp SNMP Subagent for your controller already exists on your system, and if it does, remove it.
1. To determine if the afasnmp SNMP Subagent is installed on your Linux system, enter the following command:
```
 rpm -q afasnmp
```
  If the afasnmp SNMP Subagent exists on your Linux system, the rpm command will return the following message, where VERSION_NUMBER is the actual version of the SNMP software:
```
 afasnmp-VERSION_NUMBER
```
2. If the afasnmp SNMP Subagent already exists on your Linux system, remove it by entering the following command, replacing VERSION_NUMBER with the version number returned by the rpm -q command:
```
 rpm -e afasnmp-VERSION_NUMBER
```
Install the afasnmp SNMP Subagent.
1. Place the diskette containing the afasnmp SNMP Subagent in the diskette drive.
2. Mount the diskette drive on /mnt by entering a command like the following, replacing diskette_LUN with the logical unit number of your diskette device (in most cases the default diskette device is fd0):
```
 mount -f pcfs /dev/diskette_LUN /mnt
```
3. Change your working directory to /mnt by entering the following command:
```
 cd /mnt
```
4. Copy the afasnmp SNMP Subagent to /tmp by entering the following command:
```
 cp afasnmp.TAR /tmp
```
5. Change your working directory to /tmp by entering the following command:
```
 cd /tmp
```
6. The file afasnmp.TAR is an embedded tar file. Untar the archive by entering the following command:
```
 tar -xf afasnmp.TAR
```
7. Install the afasnmp SNMP Subagent by entering the following command, replacing VERSION_NUMBER with the actual version of the software:
```
 rpm -i afasnmp-VERSION_NUMBER.rpm
```
8. When the installation completes, unmount the diskette drive by entering the following command:
```
 umount /mnt
```
9. Remove the afasnmp SNMP Subagent diskette from the diskette drive.

Configuring the PERC 2 SNMP Subagent

To configure the afasnmp SNMP Subagent so that it can communicate with the SNMP master agent on your Linux operating system, follow these steps:

Log on as root or become superuser.
Create the following file, replacing SNMP_CONFIGFILE_PATH with the absolute path to the UCD SNMP master configuration file (the default absolute path is /usr/local/etc/snmp):

/SNMP_CONFIGFILE_PATH/afasnmp.conf
Note: If you do not create this file, no traps will be sent by the afasnmp SNMP Subagent.
Populate the file with the trap community and the trap designations for the afasnmp SNMP Subagent, using the three following sample entries as a template (you can also use the trap destination syntax listed in UCD SNMP documentation):
```
 trapcommunity "public"
 trapsink localhost
 trapsink monitor.company.com
```
Note that the values specified in afasnmp.conf should be the same as those specified in the UCD SNMP master agent configuration file, unless you want the afasnmp SNMP Subagent traps to go to another destination.
For more information on configuring UCD SNMP traps, see the appropriate UCD SNMP documentation.
If the UCD SNMP master agent is configured to start automatically at system boot-time, you can configure the afasnmp SNMP Subagent to do the same by entering the following commands:
```
 /sbin/chkconfig --add afasnmpd
 /sbin/chkconfig --level 35 afasnmpd on
```
The UCD SNMP tools expect MIBs to be installed in the MIB directory, /usr/local/share/snmp/mibs by default. If you want to use the UCD SNMP tools with the afasnmp MIB, copy the afasnmp MIB file into the MIB directory by entering the following command, replacing SNMP_MIB_DIR with the absolute path to the MIB directory:
```
 cp /usr/sbin/afa.mib /SNMP_MIB_DIR/afa.txt
```

To start the afasnmp SNMP Subagent, enter the following commands:

 /etc/rc.d/init.d/snmpd restart
 /etc/rc.d/init.d/afasnmpd start

Configuring HP Openview to Manage a System Running the PERC 2 SNMP Subagent

To configure HP Openview on a Windows NT or a Windows 2000 system to view the PERC 2 controller and traps generated by the PERC 2 SNMP Subagent, follow these steps:

Ensure that you have installed HP Openview on your Windows system. For more information, see the appropriate HP Openview documentation.
Copy the files listed in the following table from C:\Program Files\PERC2\AFA\HP_Openview to the specified destination directories. Note that the hpndisc.exe file must also be renamed to hpnovdis.exe.

User Guide



Installing and Configuring the SNMP Subagent: Dell PowerEdge™ Expandable RAID Controller 2 Installation Guide Back to Contents Page Installing and Configuring the SNMP Subagent: Dell™ PowerEdge™ Expandable RAID Controller 2 Installation Guide	Installing the PERC 2 SNMP Subagent on Windows or NetWare	Setting up SNMP on NetWare	Linux Environment	Configuring HP Openview to Manage a System Running the PERC 2 SNMP Subagent


File:	Copy to:
hpndisc.exe	C:\openview\bin\hpnovdis.exe
hpnovmap.exe	C:\openview\bin\
hpn.arf	C:\openview\registration\c\
hpn.conf	C:\openview\conf\c\
hpn.frf	C:\openview\fields\c\
hpn.ico	C:\openview\bitmaps\c\
hpn.srf	C:\openview\symbols\c\cards\
hpn.lrf	C:\openview\lrf\

Open a command prompt window, and enter the following commands:

 cd C:\openview\conf\c
 xnmevents -load hpn.conf

From a command prompt window, enter the following commands:

 cd C:\openview\fields\c
 ovw -fields

From a command prompt window, enter the following commands:

 cd C:\openview\lrf
 ovaddobj hpn.lrf
 cd C:\openview\bin
 ovstart hpnovdis

To enable SNMP reporting from FAST and the CLI, see the Flexible Array Storage Tool User's Guide or the Command Line Interface User's Guide.

To enable SNMP reporting from Array Manager, see the Dell OpenManage^{^TM}Array Manager User's Guide.

Back to Contents Page