Back to Contents Page

Installing and Configuring the SNMP Subagent

Dell™ PowerEdge™ Expandable RAID Controller 3/Di INSTALLATION GUIDE

  Installing the PERC 3/Di SNMP Subagent on Windows or NetWare

  Setting up SNMP on NetWare

  Installing and Configuring on Linux


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

Note: Before installing the PERC 3/Di 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 3/Di SNMP Subagent on Windows or NetWare

The kit containing the PERC 3/Di 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 3/Di SNMP Subagent on a Windows NT or Windows 2000 system:

  1. If FAST is installed on your system, from a command prompt window, stop the remote agent by entering the following command:

net stop afa_agent

  1. Stop the SNMP service by entering the following command in a command prompt window:

net stop snmp

  1. If FAST 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

  1. Place the diskette that contains the PERC 3/Di SNMP Subagent software in the diskette drive.

  2. Install the PERC 3/Di SNMP Subagent software by copying all the files from the NT\SNMP folder on the diskette to the C:\Program Files\PERC2\AFA folder.

  3. Use the Windows NT Registry Editor (regedt32) to add an entry for the SNMP Subagent, as follows:

    1. At the command prompt, run regedt32.

    1. In the Registry Editor, locate the following key and select it:

HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Services
\SNMP\Parameters

    1. Choose Add Key from the Edit menu.

    2. In the Key Name field, type ExtensionAgents, and click OK.

    3. In the Registry Editor window, select the newly added ExtensionAgents key, and choose Add Value from the Edit menu.

    4. In the Value Name field, type AFASNMP. Set the Data Type to REG_SZ, and click OK.

    5. In the String field, enter the following:

SOFTWARE\Adaptec\RaidController\AFA\CurrentVersion

Click OK.

  1. 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

    1. Choose Add Value from the Edit menu.

    2. In the Value Name field, type Pathname. Set the Data Type to REG_EXPAND_SZ, and click OK.

    3. In the String field, enter the following:

%SystemDrive%\program files\PERC2\AFA\AFASNMPE.DLL

    1. Click OK and exit the Registry Editor.

  1. If FAST is installed on your system, from a command prompt window, enter the following command to restart the SNMP service:

net start snmp

  1. If FAST 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. 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.

To set up a NetWare system to generate SNMP traps:

  1. 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.

  2. 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

Installing and Configuring on Linux

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

Installing or Upgrading the PERC 3/Di SNMP Subagent

To install or upgrade the afasnmp SNMP Subagent:

  1. 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"
  1. Log on as root or become superuser.

  2. If upgrading from an earlier release, check to see if the afasnmp SNMP Subagent for your controller already exists on your system. If it does exist, 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

    1. 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

  1. Install the afasnmp SNMP Subagent.

    1. Place the CD-ROM containing the afasnmp SNMP Subagent in the CD- ROM drive.

    1. Mount the drive on /mnt by entering a command like the following, replacing cdrom_LUN with the logical unit number of your CD-ROM device (in most cases the default device is fd0):

mount -f pcfs /dev/cdrom_LUN /mnt

    1. Change your working directory to /mnt by entering the following command:

cd /mnt

    1. 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

    1. When the installation completes, unmount the diskette drive by entering the following command:

umount /mnt

    1. Remove the afasnmp SNMP Subagent CD-ROM from the drive.

Configuring the PERC 3/Di SNMP Subagent

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

  1. Log on as root or become superuser.

  2. 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.
  1. 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.

  1. 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

  1. 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

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

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

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

Back to Contents Page