Dell PERC 2 Event Snap-in Readme The Dell PERC 2 Event Snap-in kit is a snap-in to the AFA_AGENT service that runs under Windows NT 4.0. Installing this snap-in causes events to be logged in the Windows NT event log whenever the PERC 2 API generates an event that would cause an SNMP trap. The strings that are logged into the Windows NT event log were derived from the strings used in the SNMP traps. This kit is compatible with all versions of Dell PERC 2, 2/Si, 3/Si, and 3/Di controllers and management API. Kit Inventory ------------- The Dell PERC 2 Event Snap-in kit consists of the following files: afaevent.dll afaevent_msg.dll readme.txt Installation ------------ Perform the following steps to install the Dell PERC 2 Event Snap-in kit: 1. Install the Dell PERC 2 applications kit on the machine. See your controller documentation for details. Note that a system restart is necessary to activate the Dell PERC 2 applications kit after it has been installed. 2. Install this Dell PERC 2 Event Snap-in kit on the machine by executing the setup.exe program found in the disk1 directory of this package. 3. Restart the computer or stop and start the AFA_AGENT. The AFA_AGENT can be stopped from the command line with the command "net stop afa_agent" and restarted with the command "net start afa_agent". Uninstallation -------------- Use NT's standard Control Panel applet, Add/Remove Software, to uninstall the Dell PERC 2 Event Snap-in kit. Since the Dell PERC 2 Event Snap-in kit is installed on top of the Dell PERC 2 NT Applications kit, it will not function correctly if you uninstall the Dell PERC 2 NT Applications kit. If you uninstall and then reinstall the Dell PERC 2 NT Applications kit, you must also uninstall and reinstall the Dell PERC 2 Event Snap-in kit. NT Registry Changes ------------------- The installation of afaagent will perform the following changes to the registry. HKEY_LOCAL_MACHINE\system\currentcontrolset\services\AFA_AGENT\Extensions\AFA_EVENT PATH = REG_SZ C:\program files\perc2\system\afaevent.dll (Substitute the actual path to the Dell PERC 2 management installation directory) HKEY_LOCAL_MACHINE\system\currentcontrolset\services\EventLog\System\afaevent EventMessageFile = REG_SZ c:\program files\perc2\system\afaevent_msg.dll TypesSupported = REG_DWORD 0x00000007 Event Log Entries ----------------- All of the Dell PERC 2 event log entries from this kit share the following attributes: 1. All entries are placed in the System event log. 2. All entries are from the source "afaevent". 3. All entries are prefaced with the name of the controller that generated the event, for example: afa0. The following table lists each of the defined Event Log entries, its type (Information, Warning or Error), and its associated text string: Event Number Type String ------------------------------------------------------------------------------------------- 69 INFORMATION %1!s!:A drive letter changed on container %2!s!. 70 INFORMATION %1!s!:A change in failover assignments occurred for container %2!s!. 71 WARNING %1!s!:A container %2!s! changed its state. 72 INFORMATION %1!s!:A file system change has occurred on container %2!s!. 73 INFORMATION %1!s!:Container %2!s! has been created. 75 INFORMATION %1!s!:Container %2!s! has been deleted. 76 ERROR %1!s!:An general error occurred on container %2!s!. 77 WARNING %1!s!:Container %2!s! is no longer in the mirroring state. 78 WARNING %1!s!:A failover operation for container %2!s! failed because there was not enough space available on the failover device. 79 WARNING %1!s!:Container %2!s! could not be unmirrored. 80 INFORMATION %1!s!:A mirror failover operation started on container %2!s!. 81 WARNING %1!s!:A failover operation failed on container %2!s!. 82 WARNING %1!s!:There is no failover device assigned to container %2!s!. 83 ERROR %1!s!:A drive that was part of the mirror set (container) %2!s! failed. 84 INFORMATION %1!s!:A rebuild operation started on container %2!s!. 85 INFORMATION %1!s!:A rebuild operation was restarted on container %2!s!. 86 ERROR %1!s!:A drive that was part of the RAID 5 set (container) %2!s! failed. 87 WARNING %1!s!:There is no failover device assigned to container %2!s!. 89 WARNING %1!s!:A failover operation for container %2!s! failed because there is not enough space available on the failover device. 90 WARNING %1!s!:The snapshot container %2!s! is almost full. 91 WARNING %1!s!:The snapshot container %2!s! is full. 92 INFORMATION %1!s!:The rebuild operation for container %2!s! has completed. 93 ERROR %1!s!:A device has failed. Bus %2!s!. Id %3!s! Lun %4!s!. 94 INFORMATION %1!s!:The controller has resumed normal I/O operations. 95 INFORMATION %1!s!:The I/O operations on the controller have been paused. 96 ERROR %1!s!:An enclosure connected to the controller has reported an error. 97 ERROR %1!s!:An enclosure connected to the controller has reported a fan failure. 98 ERROR %1!s!:An enclosure connected to the controller has reported a power supply failure. 99 ERROR %1!s!:An enclosure connected to the controller has reported an abnormal temperature reading. 100 ERROR %1!s!:An enclosure connected to the controller has reported a temperature reading above the user threshold. 101 ERROR %1!s!:The battery connected to the controller is dead. 102 INFORMATION %1!s!:The battery connected to the controller is improving. 103 ERROR %1!s!:The battery connected to the controller has lost charge. 104 INFORMATION %1!s!:The controller reports that its battery is good. 105 ERROR %1!s!:A device reported that its Failure Prediction Threshold had been exceeded. Bus %2!s!. Id %3!s! Lun%4!s!. 106 ERROR %1!s!:A Failure Prediction Threshold test occurred. Bus %2!s!. Id %3!s! Lun %4!s!. 107 WARNING %1!s!:A Device issued a warning. Bus %2!s!. Id %3!s! Lun %4!s!. 108 WARNING %1!s!:A Device issued a abnormal temperature warning. Bus %2!s!. Id %3!s! Lun %4!s!. 110 WARNING %1!s!:A device reported that its status is degraded. Bus %2!s!. Id %3!s! Lun %4!s!. 111 INFORMATION %1!s!:The failure prediction configuration changed for a device. Bus %2!s!. Id %3!s! Lun %4!s!. 112 ERROR %1!s!:The controller has reported that its battery requires reconditioning.