How To Install and Run Compaq Management Notice
How To Install and Run Compaq Management Agents for Servers for Linux Notice ©2001 Compaq Computer Corporation Compaq, Compaq Insight Manager, NetFlex, NonStop, ProLiant, ROMPaq, and SmartStart are registered United States Patent and Trademark Office. Alpha, AlphaServer, AlphaStation, ProSignia, and SoftPaq are trademarks and/or service marks of Compaq Computer Corporation. Netelligent is a trademark and/or service mark of Compaq Information Technologies Group, L.P. in the U.S. and/or other countries. Microsoft, MS-DOS, Windows, and Windows NT are trademarks and/or registered trademarks of Microsoft Corporation. Pentium, Xeon, Pentium II Xeon, and Pentium III Xeon are registered trademarks of Intel Corporation. UNIX is a registered trademark of The Open Group. SCO, UnixWare, OpenServer 5, and UnixWare 7 are registered trademarks of the Santa Cruz Operation. Linux is a registered trademark of Linus Torvalds. Red Hat is a registered trademark of Red Hat, Inc. Caldera Systems and OpenLinux are either registered trademarks or trademarks of Caldera Systems. TurboLinux is a trademark of Turbo Linux, Inc. SuSE is a registered trademark of SuSE AG. Other product names mentioned herein may be trademarks and/or registered trademarks of their respective companies. The information in this publication is subject to change without notice and is provided "AS IS" WITHOUT WARRANTY OF ANY KIND. THE ENTIRE RISK ARISING OUT OF THE USE OF THIS INFORMATION REMAINS WITH RECIPIENT. IN NO EVENT SHALL COMPAQ BE LIABLE FOR ANY DIRECT, CONSEQUENTIAL, INCIDENTAL, SPECIAL, PUNITIVE OR OTHER DAMAGES WHATSOEVER (INCLUDING WITHOUT LIMITATION, DAMAGES FOR LOSS OF BUSINESS PROFITS, BUSINESS INTERRUPTION OR LOSS OF BUSINESS INFORMATION), EVEN IF COMPAQ HAS BEEN ADVISED OF THE POSSIBILITY OF SUCH DAMAGES. The limited warranties for Compaq products are exclusively set forth in the documentation accompanying such products. Nothing herein should be construed as constituting a further or additional warranty. How to Install and Run Compaq Management Agents for Servers for Linux Contents 1 INTRODUCTION........................................................................................1 1.1 Integrated Management Features ............................................................................. 1 1.2 Compaq Insight Management Software Architecture.................................... 1 Compaq Management Agents for Servers.................................................................................. 2 Compaq Insight Manager.................................................................................................................. 2 Compaq Insight Manager XE ........................................................................................................... 3 2 INSTALLING MANAGEMENT AGENTS FOR SERVERS FOR LINUX.................................................................................................................3 2.1 System Requirements ....................................................................................................... 3 2.2 Agents Dependencies ........................................................................................................ 4 Foundation Agents Dependencies.................................................................................................. 4 Server Agents Dependencies........................................................................................................... 5 Storage Agents Dependencies ........................................................................................................ 5 NIC Agents Dependencies ................................................................................................................ 6 2.3 Installing and Configuring Compaq Management Agents for Servers . 6 Post-Installation Configurations ..................................................................................................... 8 SNMP Agent Configuration ............................................................................................................... 8 Adding Compaq Management Agents eXtension (cmaX) to SNMP Agent.................... 11 Snmpd and Agent Start/Kill scripts and snmpd (under /etc/rc.d) Configuration ..... 14 2.4. Uninstalling Compaq Management Agents for Servers for Linux...... 14 2.5. Compaq Management Agents for Server Files.............................................. 15 Foundation Agent Files .................................................................................................................... 15 Server Agent Files ............................................................................................................................. 16 Storage Agents Files......................................................................................................................... 17 NIC Agents Files ................................................................................................................................. 18 3 ACCESSING COMPAQ WEB-ENABLED MANAGEMENT AGENTS FOR SERVERS ................................................................................................19 3.1. Device Home Page......................................................................................................... 19 3.2. Browser Requirements ............................................................................................... 20 3.3 Security.................................................................................................................................... 20 3.4 Viewing Subsystem and Status Information..................................................... 21 3.5 Title Frame............................................................................................................................. 21 -i- 3.6 Summary Page .................................................................................................................... 21 3.7 Navigation Frame............................................................................................................... 22 3.8 Data Frame ............................................................................................................................ 22 4 USING MANAGEMENT AGENTS FOR SERVERS.............................22 4.1 Using the Foundation Agent ........................................................................................ 22 Linux SNMP Daemon ........................................................................................................................ 22 Compaq Foundation Peer................................................................................................................ 23 Compaq Management Agents Configuration File................................................................... 24 Foundation Data Collection Agents ............................................................................................. 25 Compaq Foundation Data Registry ............................................................................................. 25 Configuring Foundation Data Collection Agents..................................................................... 25 4.2 Using the Server Agent .................................................................................................. 29 Linux SNMP Daemon ........................................................................................................................ 29 Compaq Server Peer......................................................................................................................... 30 Compaq Management Agents Configuration File................................................................... 30 Server Data Collection Agents ...................................................................................................... 31 Compaq Server Data Registry ...................................................................................................... 31 Configuring Server Data Collection Agents.............................................................................. 32 4.3 Using the Storage Agent................................................................................................ 35 Linux SNMP Daemon ........................................................................................................................ 35 Compaq Storage Peer ...................................................................................................................... 35 Compaq Management Agents Configuration File................................................................... 36 Storage Data Collection Agents.................................................................................................... 37 Compaq Storage Data Registry .................................................................................................... 38 Configuring Storage Data Collection Agents ........................................................................... 39 4.4. Using the NIC Agent ................................................................................................... 41 Command Line Arguments............................................................................................................. 42 5 TROUBLESHOOTING .............................................................................43 5.1. Problems Working with Compaq Insight Manager................................... 43 Cannot Manage Server from Compaq Insight Manager ...................................................... 43 Grayed-out Utilization Button ....................................................................................................... 43 Missing File System Space Used Information in the Mass Storage Window ............... 44 Grayed-out System Board, Expansion Boards, or Configuration Buttons.................... 44 Missing SCSI Drive Information in the Mass Storage Window ......................................... 44 Added SCSI Devices Do Not Appear........................................................................................... 45 Missing or 0-Value SCSI Hard Drive Serial Number or Capacity..................................... 45 Grayed-out Button for a SCSI Controller.................................................................................. 45 Missing Drive Array in the Mass Storage Window................................................................. 45 Grayed-out IDA Controllers in the Mass Storage Window ................................................. 46 Grayed-out FCA Controllers in the Mass Storage Window................................................. 46 Grayed-out IDE Controllers in the Mass Storage Window ................................................. 46 Grayed-out Recovery Button in the Device View Window ................................................. 46 - ii - Grayed-out Auto Recovery Button in the Recovery Window............................................. 46 Grayed-out Environment Button in the Recovery Window ................................................ 47 Grayed-Out Remote Insight Button in the Recovery Window .......................................... 47 5.2 Problems Working with SNMP-Based Management Programs ............... 47 Unable to Change Any Values on the Managed Server....................................................... 47 Unable to Set Thresholds on Compaq MIB Items.................................................................. 48 No SNMP Traps/Alarms Received ................................................................................................ 49 No User-Defined SNMP Traps Received..................................................................................... 49 5.3. Problems Using Management Agents for Servers ...................................... 50 Disabling SNMP Sets for a Specific Agent ................................................................................ 50 Disabling SNMP Traps for a Specific Agent .............................................................................. 50 Disabling Remote Reboot................................................................................................................ 50 The Compaq Peer Will Not Run .................................................................................................... 51 Compaq Web-enabled Management Agents for Servers .................................................... 51 - iii - 1 Introduction 1.1 Integrated Management Features PC networks are increasingly important to many businesses and organizations. As these networks become larger and more complex, two facts have become clear: ! ! The network and its components are becoming indispensable to the organization. Maintaining minimum downtime and maximum performance for the network is crucial for overall productivity. Responding to this demanding, business-critical PC network environment, Compaq established the Server Management Technology Framework, which includes integrated management features and management tools for manageable devices on the network. Manageable devices may include servers, workstations, desktops, portables, routers, switches, and hubs. A significant requirement for any server operation is the ability to manage fault conditions, monitor performance, and control security and configuration, as well as to control devices remotely. Each hardware subsystem—such as disk storage, system memory, and system processor—has a robust set of built-in management capabilities. In addition to fault prevention, Compaq Full-Spectrum Fault Management keeps your systems up and running in the unlikely event of a failure, and delivers rapid device recovery to normal operations following a fault. To provide timely status and the means for remote control, Compaq developed management tools that put you in charge of integrated management featuresCompaq Insight Manager and the Compaq Server Management Agents. 1.2 Compaq Insight Management Software Architecture The Compaq Insight Management application has client/server architecture similar to other network management solutions. This architecture includes of the agent software (Compaq Management Agents for Servers) and the management application software (Compaq Insight Manager). -1- Compaq Management Agents for Servers Compaq Management Agents for Servers operates on devices, performing in-depth monitoring of device states by collecting and measuring parameters. These parameters indicate the current state of a particular subsystems by counting the occurrence of a particular event (for example, the number of read operations performed on a disk drive) or by monitoring the state of a critical function (for example, whether the cooling fan is operating). Compaq Management Agents for Servers is divided into four separate packages: ! ! ! ! Compaq Foundation Agents Compaq Server Agents Compaq Storage Agents Compaq NIC Agents Compaq Management Agents for Servers provides access to device management data using a Web browser and industry-standard HTTP protocol. This browser method allows you to access data from anywhere that you have network access. Compaq Management Agents for Servers provides information to management applications such as Compaq Insight Manager, and can generate alarm notifications if significant changes occur in the fault or performance aspects of system operation. Information is delivered to and from Management Agents for Servers via Simple Network Management Protocol (SNMP). Compaq Insight Manager Compaq Insight Manager provides intelligent monitoring and alerting, as well as visual control of your Compaq hardware. In the unlikely event of a hardware failure, Compaq Insight Manager also provides a full complement of remote maintenance and control services. Note: To install Compaq Insight Manager on the management console, refer to the Compaq Insight Manager User Guide. http://www.compaq.com/products/servers/management/index.html -2- Compaq Insight Manager XE Compaq Insight Manager XE leverages the power of the Internet to provide web-based systems management, and is a key enabler of Compaq's vision for virtual presence. Compaq Insight Manager XE reduces systems management cost, improves operational efficiency and effectiveness, and minimizes systems downtime. It provides device management capabilities that consolidate and integrate management data from Compaq and third-party devices using SNMP, DMI and HTTP. With Compaq Insight Manager XE, you can monitor and manage groups of servers, clients, clusters and networking products anywhere, anytime from a standard web browser. 2 Installing Management Agents for Servers for Linux 2.1 System Requirements To install Compaq Management Agents for Servers for Linux on Compaq servers, the hardware and software described in Table 2-1 is required. Table 2-1 System Requirements Hardware and Software Minimum Requirements System PCI-bus, Intel Pentium (or compatible) processor Disk Space 8 MB of disk space for installation, 15 MB (or more) at run time, depending on your system configuration. Software 1. Red Hat Linux 7.0 with “ucd-snmp-4.1.2” and “compat-libstdc++” RPMS or Red Hat Linux 7.1 with “ucd-snmp-4.2” and ”compat-libstdc++” RPMS or SuSE Linux 7.0 with “ucdsnmp-4.1.1” and “compat” RPMS 2. Compaq Linux Health & Wellness Driver (cpqhealth) 3. Device drivers from Compaq (See Agents README files for details) -3- 2.2 Agents Dependencies For detailed information on Agent Dependencies including device drivers, refer to the agent README files, which can be downloaded, from the Agents SoftPag listed in section 2.3. The following describes the dependencies associated with the Compaq Management Agents for Linux on Compaq Servers: IMPORTANT: The appropriate dependencies, including device drivers, ucd-snmp RPM and other RPM’s, must be installed before installing the Compaq Management Agents. Install the Dependencies listed below before installing the Agents. Foundation Agents Dependencies ! For Red Hat Linux 7.0, the Foundation Agents (cmafdtn) requires “ucd-snmp” RPM version 4.1.2, “compat-libstdc++” RPM Version 6.2 and Compaq Health and Wellness Driver (cpqhealth) version 2.1.0. ! For Red Hat Linux 7.1, the Foundation Agents (cmafdtn) requires “ucd-snmp” RPM version 4.2, “compat-libstdc++” RPM version 6.2 and Compaq Health and Wellness Driver (cpqhealth) version 2.1.0. ! For SuSE Linux 7.0, the Foundation Agents (cmafdtn) requires “ucdsnmp” RPM version 4.1.1, “compat” RPM and Compaq Health and Wellness Driver (cpqhealth) version 2.1.0. Note: If default “High” or “Medium” firewall configuration was selected during the installation of Red Hat Linux 7.1, external SNMP requests will be “REJECTED” by the system and the server will become unmanageable. (There are significant security implications to configuring firewall and the ipfw(4), ipchains(8), ipchains-save(8) and ipchains-restore(8) manpages should be regarded as mandatory reading before making any change to firewall configuration.) The system should start “ACCEPT”ing external SNMP requests (e.g. from CIM or other management consoles) with following command: %ipchains -I input -s 16.101.168.68/255.255.255.255 \ -d 16.101.169.69/255.255.255.255 -I eth0 -p udp -j ACCEPT Where “16.101.168.68” is the IP Address of remote system running CIM or other management console and “16.101.169.69” is the IP Address running on the “eth0” interface of the Red Hat Linux 7.1 server. -4- IMPORTANT: For detailed information on Foundation Agents Dependencies refer to the Foundation Agents README file which can be found in SoftPaq16349: Compaq Foundation Agents for Linux or in Compaq Management CD version 5.10 at /agents/linux/eng/compaq/cmafdtn/readme. Server Agents Dependencies The Server Agents (cmasvr) requires that the Foundation Agents be installed on your system before installation. If you have a Remote Insight Lights Out Edition (RILOE) board installed in your system and you want to monitor it with the server agents, then the Remote Insight Driver (cpqrid) 2.1.0 should be installed. IMPORTANT: For detailed information on Server Agents Dependencies refer to the Agent README file which can be found in SoftPaq16350: Compaq Server Agents for Linux or in Compaq Management CD at /agents/linux/eng/compaq/cmasvr/readme. Storage Agents Dependencies The Storage Agent requires that the Foundation Agents be installed on your system before installation. Kernel related patches are required for the following drivers that are on your system: ! If you have the Intelligent Drive Array Adapter then you will need to load one of the following required drivers: " Compaq CISS Driver " Compaq SMART2 Driver Note: In order for the Storage Agent to work properly, the Compaq SMART2 Driver should have version 1.0.10 or later ! If you have a Fibre Channel Host Adapter then you will need to load the required FCP-SCSI Driver: " Red Hat 7.0 corresponds to Kernel version 2.2.16 Compaq drivers patches may be downloaded from the following location: ftp://ftp.compaq.com/pub/products/drivers/linux/released Apply the specific patches corresponding to the kernel version on your system. Follow the Linux Documentation for adding the appropriate patches to the Kernel. IMPORTANT: For detailed information on Storage Agents Dependencies refer to the Agent README.cmastor file which can be found in SoftPaq16352: Compaq Storage Agents for Linux or in Compaq Management CD at /agents/linux/eng/compaq/cmastor/readme. -5- NIC Agents Dependencies The NIC Agent requires that the Foundation Agents be installed on your system before installation. The NIC Agent is supported on Red Hat Linux 7.1. and SuSE Linux 7.0. IMPORTANT: For detailed information on NIC Agents Dependencies refer to the Agent README file which can be found in SoftPaq16351: Compaq NIC Agents for Linux or in Compaq Management CD at /agents/linux/eng/compaq/cmanic/readme. NIC Supported Drivers Compaq tested and supported NIC drivers can be downloaded from the following URL: http://www.compaq.com/products/servers/linux/linux-drivers.html 2.3 Installing and Configuring Compaq Management Agents for Servers Compaq Management Agents for Servers are available on the Compaq Management CD and on the Web. To install agents from Management CD, follow these steps: 1. Insert the Compaq Management CD into the CD-ROM drive and log in as the “root” user. 2. Mount the Compaq Management CD at the directory /mnt/cdrom (Red Hat Linux) or /cdrom (SuSE Linux) by entering the following commands: mount/dev/cdrom 3. Change current directory to CD mount point: cd/mnt/cdrom cd/cdrom (Red Hat Linux) (SuSE Linux) 4. Read the following files for the dependencies required for installing the Compaq Management Agents for Servers: ! ! ! ! /agents/linux/eng/compaq/cmafdtn/readme /agents/linux/eng/compaq/cmasvr/readme /agents/linux/eng/compaq/cmastor/readme /agents/linux/eng/compaq/cmanic/readme -6- Install the dependencies before proceeding with the following commands: sh/mnt/cdrom/agents/linux/eng/compaq/install The “install” script will install/upgrade all four agents packages one at a time. 5. Follow the directions on the screen. 6. Unmount the Compaq Management CD using the following commands: cd/ umount/dev/cdrom 7. Remove the Compaq Management CD from the CD-ROM drive. 8. After the "Post-Installation Configurations". Use the following commands to start the agents: /etc/rc.d/init.d/cmafdtn start /etc/rc.d/init.d/cmasvr start /etc/rc.d/init.d/cmastor start /etc/rc.d/init.d/cmanic start Important: Each agent package can also be installed separately. Refer to the readme files in each package for installation instructions. Remember that Foundation Agents should always be installed first. To install agents from the Web using Softpaqs, download the following Compaq Management Agents for Servers Softpaqs: ! ! ! ! SoftPaq16349: Compaq Foundation Agents for Linux SoftPaq16350: Compaq Server Agents for Linux SoftPaq16352: Compaq Storage Agents for Linux SoftPaq16351: Compaq NIC Agents for Linux From the following Compaq support website: http://www.compaq.com/support/files/server/us/index.html Follow the instructions on the website to un-tar the Softpaqs. Read the Softpaq README files for installation instructions. Note: SNMP agent (snmpd) must be restarted after the installation(s) of Compaq Management Agents for Servers. Command “/etc/rc.d/init.d/snmpd restart” can be used to restart SNMP agent. -7- Note: SNMP agent (snmpd) and Compaq Web agent (cmawebd) will be restarted automatically after the installation(s) of Compaq Management Agents for Servers. Post-Installation Configurations After the installation of the Compaq Management Agents, the following configurations are needed for Compaq Management Agents for Servers to function properly: ! SNMP agent configuration (community string and trap destinations configurations in “snmpd.conf”) ! Adding Compaq Management Agents eXtension (cmaX) to SNMP Agent (snmpd) ! Snmpd and Agents Start/Kill scripts (under /etc/rc.d) configuration. SNMP Agent Configuration Proper operation of Compaq Management Agents for Servers requires that you first configure the SNMP software. Currently, only UCD SNMP agent is supported. Refer to the online manual pages “#man 5 snmpd.conf” and “#man 5 snmp_config” for more information. It is important that "snmpd.conf" files are protected against unauthorized access. Note: There are significant security implications to configuring “snmpd.conf”, and the snmp_config(5) and snmpd.conf(5) manpages should be regarded as mandatory reading before proceeding. Note: It is the user’s responsibility to configure “snmpd.conf” files properly. Multiple snmpd.conf files are supported by snmpd. By default, "/usr/share/snmp/snmpd.conf" is the first one used by snmpd but that can be changed through "SNMPCONFPATH" environment variable (Refer to the online manual pages “#man 5 snmp_config” and “#man 5 snmpd.conf” for more information). You may need to manually create “/usr/share/snmpd/snmpd.conf” (or other snmpd.conf files) since there might be no snmpd.conf file to be used by snmpd at runtime. (“/etc/snmp/snmpd.conf”, although it is delivered by ucd-snmp RPM (Red Hat) or ucdsnmp RPM (SuSE), it is NOT used by snmpd by default.) You can use “snmpwalk”, “snmpget”, “snmpset”, “snmptrap”, “snmptrapd” and other tools to test and validate your SNMP agent configuration. An example snmpd.conf, which includes configuration instructions and can be modified to fit your environment, is included in Foundation Agents RPM. It can be found at: /opt/compaq/foundation/etc/snmpd.conf.cma -8- For Compaq Management Agents for Servers to work properly, the “localhost” (127.0.0.1) requires SNMP READ (GET) privileges at minimum. “localhost” SNMP WRITE (SET) privileges are required for enabling SNMP WRITE (SET) capability in Compaq Web Agent and Compaq Remote Insight Agent. For SNMP READ/WRITE privileges, Compaq Management Agents for Servers look for “rocommunity” and “rwcommunity” entries in “snmpd.conf” files. Examples: rocommunity localread 127.0.0.1 rwcommunity localwrite 127.0.0.1 rocommunity allread -9- Note: The default community string for Compaq Insight Manager is "public". If you use a different community string, you must also enter it on the management console responsible for the device. To change the community string in Compaq Insight Manager, select the Device Setup button from the Task List menu. The Device Setup window opens and provides space for you to set the community string. (For more information, refer to the section on Community Strings in the Compaq Insight Manager User Guide.) For sending SNMP Traps, Compaq Management Agents for Servers use the information in the “trapcommunity” and “trapsink” entries in “snmpd.conf” files. Examples: trapcommunity commontrap trapsink 127.0.0.1 localcma trapsink 172.25.52.101 cmalinux After configuring “snmpd.conf”, use the following commands to activate new configurations: %kill -HUP `/sbin/pidof snmpd` %/etc/rc.d/init.d/cmafdtn restart %/etc/rc.d/init.d/cmasvr restart cmasvrpeerd %/etc/rc.d/init.d/cmastjor restart cmastorpeerd %/etc/rc.d/init.d/cmanic restart Note: The performance of SNMP Get/Set operations may be poor when “view” entry exists in “snmpd.conf” and the “subtree” field of “view” entry is not “.1” (e.g. “system”): View systemview included system You can perform a test by changing the subtree field to “.1” temporally: View systemview included .1 and run the “%kill –HUP `/sbin/pidof snmpd`” command. If the SNMP performance improves after the change, you should consider changing the “snmpd.conf”. Read snmp_config(5), snmpd.conf(5) manpages and other UCD SNMP documentation before making the change. - 10 - Adding Compaq Management Agents eXtension (cmaX) to SNMP Agent In order to support Compaq SNMP MIBs, Compaq Management Agents eXtension (cmaX) needs to be compiled into UCD SNMP agent (snmpd). To do this, you need to install UCD SNMP source from Red Hat CD #2 (SRPM CD) or from SuSE CD #6 UCD SNMP 4.1.2 is supported under Red Hat Linux 7.0. To install UCD SNMP 4.1.2 source RPM: Insert Red Hat Linux 7.0 CD #2 (SRPM CD) into CDROM drive. %mount/dev/cdrom %rpm –i /mnt/cdrom/SRPMS/ucd-snmp-4.1.2-8.src.rpm %cd/usr/src/redhat/SOURCES %tar xvzf ucd-snmp-4.1.2.tar.gz %patch –p0 < ucd-snmp-4.1.2-rpm40.patch %umount/dev/cdrom Remove Red Hat Linux 7.0 CD #2 (SRPM CD) from CDROM drive. UCD SNMP 4.2 is supported under Red Hat Linux 7.1. To install UCD SNMP 4.2 source RPM: Insert Red Hat Linux 7.1 CD #2 (SRPM CD) into CDROM drive. %mount/dev/cdrom %rpm –i /mnt/cdrom/SRPMS/ucd-snmp-4.2-12.src.rpm %cd/usr/src/redhat/SOURCES %tar xvzf ucd-snmp-4.2.tar.gz %patch –p1 –d ucd-snmp-4.2 < ucd-snmp-4.1.2-bug18153.patch %patch –p0 –d ucd-snmp-4.2 < ucd-snmp-4.2-fromcvs.patch %patch –p0 < ucd-snmp-4.1.2-rpm40.patch %umount/dev/cdrom Remove Red Hat Linux 7.1 CD #2 (SRPM CD) from CDROM drive. UCD SNMP 4.1.1 is supported under SuSE Linux 7.0. - 11 - To install UCD SNMP 4.1.1 source RPM: Insert SuSE 7.0 CD #6 into CDROM drive. %mount /dev/cdrom %rpm –i /cdrom/full-names/src/ucd-snmp-4.1.1-58.src.rpm %cd /usr/src/pages/SOURCES %tar xvzf ucd-snmp-4.1.1.tar.gz %umount /dev/cdrom Remove SuSE Linux 7.0 CD #6 from CDROM drive. You are now ready to add Compaq Management Agents eXtension (cmaX) to snmpd. You must login as “root”. To add cmaX to snmpd, you can execute “/opt/compaq/foundation/etc/snmpdbld” script (recommended): % /opt/compaq/foundation/etc/snmpdbld To build snmpd manually, follow the instructions below: Note: If your snmpd also includes other extensions, you can not use “snmpdbld” script and you also need to include all the extensions in the “--with-mib-modules” flag of “./configure” commands below. To add cmaX manually under Red Hat Linux 7.0 with UCD SNMP 4.1.2, use following commands: % SNMPVER=4.1.2 %cd/usr/src/redhat/SOURCES/ucd-snmp-$SNMPVER %mv ./agent/mibgroup/mibII/interfaces.c \ ./agent/mibgroup/mibII/interfaces.c.orig %cp ./opt/compaq/foundation/src/interfaces.c.$SNMPVER \ ./agent/mibgroup/mibII/interfaces.c %cp/opt/compaq/foundation/src/cmaX.[ch] \ ./agent/mibgroup %./configure --with-mib-modules=cmaX \ --with-ldflags=”-lpthread” --prefix=/usr %make %/etc/rc.d/init.d/snmpd stop %mv/usr/sbin/snmpd /usr/sbin/snmpd.orig %cp ./agent/snmpd /usr/sbin/snmpd %/etc/rc.d/init.d/snmpd start - 12 - To add cmaX manually under Red Hat Linux 7.1 with UCD SNMP 4.2, use following commands: % SNMPVER=4.2 %cd/usr/src/redhat/SOURCES/ucd-snmp-$SNMPVER %cp/opt/compaq/foundation/src/cmaX.[ch] \ ./agent/mibgroup %./configure --disable-shared --with-mib-modules=cmaX \ --with-ldflags=”-lpthread” --prefix=/usr %make %/etc/rc.d/init.d/snmpd stop %mv/usr/sbin/snmpd /usr/sbin/snmpd.orig %cp ./agent/snmpd /usr/sbin/snmpd %/etc/rc.d/init.d/snmpd start To add cmaX manually under SuSE Linux 7.0 with UCD SNMP 4.1.1, use following commands: % SNMPVER=4.1.1 %cd/usr/src/packages/SOURCES/ucd-snmp-$SNMPVER %cp/opt/compaq/foundation/src/cmaX.[ch] \ ./agent/mibgroup %mv ./agent/mibgroup/mibII/interfaces.c \ ./agent/mibgroup/mibII/interfaces.c.orig %cp ./opt/compaq/foundation/src/interfaces.c.$SNMPVER \ ./agent/mibgroup/mibII/interfaces.c %./configure --with-mib-modules=cmaX \ --with-ldflags=”-lpthread” --prefix=/usr %make %/etc/rc.d/init.d/snmpd stop %mv/usr/sbin/snmpd /usr/sbin/snmpd/orig %cp ./agent/snmpd /usr/sbin/snmpd %/etc/rc.d/init.d/snmpd start - 13 - Snmpd and Agent Start/Kill scripts and snmpd (under /etc/rc.d) Configuration During installation, Compaq Management Agents for Servers are configured to start automatically after SNMP agent (snmpd) is started. If no snmpd Start script is turned on at any runlevel, it will be turned on at the default boot runlevel. The start/kill scripts are listed for the following agents: ! ! ! ! ! UCD SNMP Agent: /etc/rc.d/init.d/snmpd Compaq Foundation Agents: /etc/rc.d/init.d/cmafdtn Compaq Server Agents: /etc/rc.d/init.d/cmasvr Compaq Storage Agents: /etc/rc.d/init.d/cmastor Compaq NIC Agents: /etc/rc.d/init.d/cmanic 2.4. Uninstalling Compaq Management Agents for Servers for Linux To uninstall the Compaq Management Agents for Servers for Linux: 1. Log in as the root user. 2. Enter the following commands: rpm -e cmanic rpm -e cmasvr rpm -e cmastor rpm -e cmafdtn IMPORTANT: Compaq Foundation Agents must be the last one to be removed, because it is required by other Agents RPMs. - 14 - 2.5. Compaq Management Agents for Server Files Foundation Agent Files Table 2-2 lists the Foundation Agent files used by the Compaq Management Agents for Servers for Linux. Table 2-2 Foundation Agent Files File Description /etc/rc.d/init.d/cmafdtn /opt/compaq/foundation/bin/cmapeerd Compaq Foundation Agents manual startup/shutdown script Compaq Foundation Peer daemon /opt/compaq/foundation/bin/cmawebd /opt/compaq/foundation/bin/libcpqhmmo.so Compaq Web Agent daemon Compaq HTTP server shared library (Common HMMO Service Provider for Linux) used by Web Agent daemon Linux host OS agent daemon for collecting host MIB information /opt/compaq/foundation/bin/cmahostd /opt/compaq/foundation/bin/cmathreshd Threshold agent daemon that implements User Defined Thresholds for the threshold MIB. /opt/compaq/cma.conf Compaq Management Agents (cma) configuration file. This file is shared by all agents and is created during installation if it does not already exist. /opt/compaq/webagent/* Contains data component of Web Agent for the Foundation Agents (template files, gif files, html files, and so on.) /opt/compaq/foundation/etc/cmafdtnobjects.conf Contains the MIB objects support by the Foundation Agents. Used by Compaq Management Agents eXtension (cmaX). /opt/compaq/foundation/etc/cmafdtn /opt/compaq/foundation/etc/cmafdtnpeerd Overall Compaq Foundation Agents startup/shutdown script Compaq Foundation Peer startup/shutdown script /opt/compaq/foundation/etc/cmahostd /opt/compaq/foundation/etc/cmathreshd Compaq Host agent startup/shutdown script Compaq Threshold agent startup/shutdown script /opt/compaq/foundation/etc/cmawebd /opt/compaq/foundation/etc/snmpd.conf.cma Compaq Web agent startup/shutdown script Example snmpd.conf file for Compaq Management Agents /opt/compaq/foundation/etc/snmpdbld Script that rebuilds snmpd to include Compaq Management Agents eXtension (cmaX). Compaq Management Agents Extension (cmaX) which will be complied into snmpd. Bug fix for UCD SNMP /opt/compaq/foundation/src/cmaX.[ch] /opt/compaq/foundation/src/interfaces.c.4.1.1 and interfaces.c.4.1.2 /var/spool/compaq/foundation/registry/ Compaq Foundation Data Registry. Holds MIB data files containing information collected by Compaq Foundation agents. Compaq management agents error log & message file. /var/spool/compaq/cma.log - 15 - Server Agent Files Table 2-3 lists the Server Agent files used by the Compaq Management Agents for Servers for Linux. Table 2-3 Server Agent Files File Description /etc/rc.d/init.d/cmasvr Compaq Server Agents manual startup/shutdown script /opt/compaq/server/bin/cmasvrpeerd Compaq Server Peer daemon /opt/compaq/server/bin/cmahealthd Linux Health agent daemon for monitoring server health MIB information /opt/compaqserver/bin/cmastdeqd Standard Equipment agent daemon for collecting Standard Equipment MIB information. /opt/compaq/server/bin/cmasm2d Linux RIB agent daemon for monitoring RIB MIB information and providing SNMP RIB pass through /opt/Compaq/server/etc/cmasvr Compaq Server Agents manual startup/shutdown script /opt/compaq/server/etc/cmasvrpeerd Compaq Server Peer daemon /opt/compaq/server/etc/cmahealthd Linux Health agent daemon for monitoring server health MIB information /opt/compaqserver/etc/cmastdeqd Standard Equipment agent daemon for collecting Standard Equipment MIB information. /opt/compaq/server/etc/cmasm2d Linux RIB agent daemon for monitoring RIB MIB information and providing SNMP RIB pass through /opt/compaq/cma.conf Compaq Management Agents (cma) configuration file. This file is shared by all agents packages and is created during installation if it does not already exist. /opt/compaq/webagent/* Contains Data component of Web Agent for Server Agents (template files, gif files, html files, and so on.) /opt/compaq/server/etc/cpqbssa.txt Compaq Insight Base System Agent Product Database File /opt/compaq/foundation/etc/cmasvrobjects.conf Contains the MIB objects support by Server Agents. Used by Compaq Management Agents Extension (cmaX). /var/spool/compaq/server/registry/ Compaq Server Data Registry. This holds MIB data files containing information collected by Compaq Server Agents. /var/spool/compaq/cma.log Compaq management Agents error log & message file. - 16 - Storage Agents Files Table 2-4 lists the Storage Agent files used by the Compaq Management Agents for Servers for Linux. Table 2-4 Storage Agent Files File Description /etc/rc.d/init.d/cmastor Compaq Storage Agents manual startup/shutdown script /opt/compaq/storage/bin/cmastorpeerd Compaq Storage Peer daemon /opt/compaq/storage/bin/cmaidad Compaq Drive Array Agent for collecting Intelligent Drive Array MIB information /opt/compaq/storage/bin/cmafcad Compaq Fibre Channel Array Agent for collecting Fibre Channel Array MIB information /opt/compaq/storage/bin/cmaided Compaq IDE Agent for collecting IDE MIB information /opt/compaq/storage/bin/cmascsid Compaq SCSI Agent for collecting SCSI MIB information /opt/compaq/storage/etc/cmastor Overall Compaq Storage Agents startup/shutdown script. /opt/compaq/storage/etc/cmastorpeerd Compaq Storage Peer startup/shutdown script /opt/compaq/storage/etc/cmaidad Compaq Drive Array agent startup/shutdown script /opt/compaq/storage/etc/cmafcad Compaq Fibre Cahnnel Array agent startup/shutdown script /opt/compaq/storage/etc/cmaided Compaq IDE agent startup/shutdown script /opt/compaq/storage/etc/cmastorpeerd Compaq Storage Peer startup/shutdown script /opt/compaq/storage/etc/cmaidad Compaq Drive Array agent startup/shutdown script /opt/compaq/storage/etc/cmafcad Compaq Fibre Cahnnel Array agent startup/shutdown script /opt/compaq/storage/etc/cmaided Compaq IDE agent startup/shutdown script /opt/compaq/storage/etc/cmascsid Compaq SCSI agent startup/shutdown script /opt/compaq/storage/etc/cmastorobjects.conf Contains the MIB objects supported by Storage Agents. Used by Compaq Management Agents Extension (cmaX). /var/spool/compaq/storage/registry/ Compaq Storage Data Registry. This holds MIB data files containing information collected by Compaq Storage Agents. /var/spool/compaq/cma.log Compaq management Agents error log and message file. - 17 - NIC Agents Files Table 2-5 lists the NIC Agent files used by the Compaq Management Agents for Servers for Linux. Table 2-5 NIC Agent Files File Description /etc/rc.d/init.d/cmanic Compaq NIC Agent manual startup/shutdown script /etc/rc.d/rc*.d/S99cmanic Compaq NIC Agent startup scripts are installed at same runlevels that snmpd is configured to start at during the installation of the NIC Agent /etc/rc.d/rc*.d/K02cmanic Compaq NIC Agent shutdown scripts are installed at the same runlevels that snmpd is configured to shutdown at during the installation of the NIC Agent /opt/compaq/nic/bin/cmanicd Compaq NIC Agent daemon /opt/compaq/nic/etc/cmanicobjects.conf Contains a list of SNMP Object Identifiers used by Compaq Foundation Agent. Referenced in /opt/compaq/cmaobjects.conf /opt/compaq/webagent/cqmgnics Directory containing Compaq NIC Web Agent templates /opt/compaq/webagent/cqmgnics.ini Compaq Web Agent configuration file /opt/compaq/nic/etc/README Compaq NIC Agent README /usr/man/man8/cmanicd.8.gz Compaq NIC Agent daemon manual page /var/spool/compaq/nic/messages_fifo Compaq NIC Agent trap notification FIFO; syslogd is configured to distribute messages to this FIFO /etc/syslog.conf Modified to distribute messages to Compaq NIC Agent trap notification FIFO /var/spool/compaq/cma.log Compaq Management Agents error log and messages file - 18 - 3 Accessing Compaq Web-enabled Management Agents for Servers The Web-enabled Compaq Management Agents for Servers allows you to view subsystem and status information from a Web browser, either locally or remotely. To view data locally, use one of the following URLs: http://127.0.0.1:2301/ http://localhost:2301/ To view data remotely, use the following URL: http://machine:2301/ Where machine is the IP address or the computer name under DNS. Note: Notice that the URL is followed by:2301. This is the port or socket number that the Web-enabled Management Agents for Servers use to communicate with the browser. If this number is not specified, your browser might attempt to connect to another Web page if the managed server is running a Web server. After your enter the URL, the Device Home Page displays. 3.1. Device Home Page The Device Home Page is the first page displayed when you access the device at port 2301. This page displays available Compaq Web-enabled services. Anonymous access to information is available without logging in when the Device Home Page is launched for the first time. To log in as a different user, select the Anonymous Link. The login screen displays. Refer to Section 3.3 for more information on user accounts. The following options are available on the Device Home Page: ! ! ! ! ! ! Compaq Management Agents—Select this link to view Subsystem and Status Information about a device that is running Compaq Management Agents for Servers. Refresh—Select this link to reload the Device Home Page. Options—Select this link to set attributes for the device. Devices—Select this link to display the Device List. Logout—Select this link to log out from the Device Home Page. Compaq on the Internet—Select this link to view Compaq Web-based support links. - 19 - 3.2. Browser Requirements The minimum browser requirements include support for tables, frames, Java, and JavaScript. Additional browsers or the browsers mentioned used with different operating systems, may or may not work correctly, depending upon the specific implementations of the required browser technologies. The browser requirements include TCP/IP protocol and are listed below in Table 3-1. Table 3-1 Browser Requirements To View Systems Running Browser Requirements Red Hat Linux 7.0/7.1 Windows: Netscape Communicator 4.51 or later and Microsoft Internet Explorer 4.0.1 or later. SuSE Linux 7.0 Linux Netscape Communicator v4.74 on Red Hat 7.0, Netscape Communicator v4.76 on Red Hat 7.1 and Netscape Communicator v4.73 on SuSE 7.0. IMPORTANT: You must turn on the following options for the Management Agents for Servers to work properly: ! Enable Java ! Enable JavaScript ! Accept all cookies 3.3 Security The Web-enabled Compaq Management Agents for Servers for Linux allows SNMP sets for some system parameters. This capability requires security that includes three predefined users and passwords that are defined in Table 3-2. Table 3-2 Security Account User Name Anonymous Anonymous User User Public Operator Operator Operator Administrator Administrator Administrator - 20 - Password Note: These are the only user accounts available in this step, and the user names cannot be changed. You do have the option of changing the passwords. Anonymous access to information is available without logging in when the Device Home Page is launched for the first time. There are three types of data: Default (read only), Sets (read/write), and Reboot (read/write). The *.INI file located in the /opt/compaq/webagent directory is the configuration files used by the Web-enabled Compaq Management Agents. The Web-enabled Management Agents for Servers service must be stopped and restarted for any changes to take effect. Do not modify anything except the read/write levels. 3.4 Viewing Subsystem and Status Information Select Compaq Management Agents from the Device Home Page to view subsystem and status information for the device. This section describes how to navigate through the management information. The date and time displayed at the top of the Device Home Page shows the local time the page was last received by your Web browser. To refresh this frame, select the Refresh link at the top of the Device Home Page. 3.5 Title Frame The Title Frame, located in the upper-left corner of the browser window, displays the following links: ! Agent Help—Use this link to navigate to this help page. ! Summary—Use this link to quickly navigate back to the list of degraded or failed components on the Summary Page. ! Device Home—Use this link to return to the Device Home Page. ! Options—Use this link to go to the Options Page and set options for Display Mode (frames or no frames), Help Icons, and Auto Refresh intervals. 3.6 Summary Page The first Summary Page displays the device name, type, contact information, location, and IP address, as well as a list of failed or degraded items. To view detailed information about a failed or degraded item, click on the item. The colored ball and square icons next to the individual items in the list below indicate the status of each item. Device status is unknown. Device status is OK. Device status is degraded. Device status is failed. - 21 - Note: In the no Frames version of this software, the Summary page fills the entire browser window. Each subsequent page has the equivalent of the contents of the Title Frame at the top with links to Help, Summary, Device, Home, and Options pages. The Summary page in the no-frames version displays all device categories and items within each category. These items are sorted by status. To view detailed information about an item, click on the item. 3.7 Navigation Frame The Navigation Frame, located below the Title Frame on the left side of the browser window, lists all of the subsystems with components that are available for the devices. The colored ball and square icons next to the various items in the list indicate the status of those items. A legend for the colored balls is displayed at the bottom of the frame. Select a component in the left frame to display detailed information about it in the right frame. 3.8 Data Frame The Data Frame comprises the remainder of the browser window and displays detailed information about the selected items. This window also displays the Summary Page when the Summary option is selected from the Title Frame. Note: Some items may split the Data Frame into subframes. The subframes follow the same organizational structure as the main frame. The navigation data in a subframe is on the left and the detailed information in a subframe on the right. 4 Using Management Agents for Servers 4.1 Using the Foundation Agent Linux SNMP Daemon A UCD SNMP agent must be installed under Linux and is located in the /usr/sbin/snmpd directory. The UCD SNMP agent provides SNMP service over UDP/IP-based networks. The UCD SNMP agent provides an extension mechanism for supporting vender-specific MIBs. Compaq Management Agent eXtension (cmaX) has been developed by Compaq for supporting Compaq MIBs (enterprises.232). Remote management consoles issues SNMP Get and Set packets over a UDP/IP network to the local SNMP agent. - 22 - The SNMP agent is started and stopped from a shell script. It is user-configurable and can be started automatically at system startup and stopped automatically at system shutdown. You can manually start and stop the SNMP daemon by entering the following commands: /etc/rc.d/init.d/snmpd start /etc/rc.d/init.d/snmpd stop Compaq Foundation Peer The Compaq Foundation Peer extends the SNMP “enterprise” MIB to include Compaq Foundation MIB data. The Compaq Foundation Peer supports SNMP Get, Set, and Trap operations on data items defined in the Compaq Host and Threshold MIBs. Compaq Foundation MIB data is gathered by data collection agent processes (Host OS and Threshold Agents). Each agent collects and saves MIB data in files that are read by the Foundation Peer during SNMP Get commands. SNMP Set commands are routed by the Foundation Peer to the agent responsible for managing the selected MIB data item. SNMP trap commands are generated by data collection agents and routed to the Foundation Peer. At SNMP agent startup time, Compaq Host and Threshold MIB items in the file /opt/compaq/foundation/etc/cmafdtnobjects.conf are read by Compaq Management Agents eXtension (cmaX) and registered with the SNMP agent. During the installation, the Foundation Peer is configured to startup automatically when the SNMP agent is running and to shutdown automatically when the SNMP agent exits. Linux runlevel configuration tools can be used to change Foundation Peer configuration. Foundation Peer (cmafdtnpeerd) should be started after SNMP agent “snmpd” is started and be killed after “snmpd” is killed. The Foundation Peer can be started manually by issuing the following command: /etc/rc.d/init.d/cmafdtn start cmafdtnpeerd The Foundation Peer can be stopped manually by issuing the following command: /etc/rc.d/init.d/cmafdtn stop cmafdtnpeerd - 23 - Compaq Management Agents Configuration File Compaq Management Agents Configuration file "/opt/compaq/cma.conf" is shared by all Compaq Management Agents for Servers packages. Currently, only trap email notification configuration and base socket number (used by cmaX) are supported. Compaq Management Agents for Servers is capable of sending email notifications in addition to the SNMP traps. The “trapemail” entries in configuration file /opt/compaq/cma.conf configures the email commands, which are then read by the Foundation Peer during its initialization. Note: If this configuration file is edited, the Foundation Peer software must be restarted before the configuration modification is effective. You can do this by entering the following commands: /etc/rc.d/init.d/cmafdtn restart cmafdtnpeerd The syntax of the trapemail lines is: trapemail mail_command “trapemail” is the keyword indicating the rest of the line is the command for sending trap email. In “mail_command”, you should provide the full path of your email command, the subject and the recipients. The “mail_command” should read standard input for the body of the email. Multiple “trapemail” lines may be defined in /opt/compaq/cma.conf. A default line will be added during installation if none exists: trapemail /bin/mail -s 'Compaq Management Agents Trap Alert' root The “cmaXSocketBase” entry in configuration file /opt/compaq/cma.conf configures the starting socket port used for communications between cmaX and Peers. The entry is not needed unless "bind() failed!" message showed up in Agents log file /var/spool/compaq/cma.log. Example: cmaXSocketBase 12345 - 24 - Foundation Data Collection Agents Each Compaq Foundation Data Collection Agent gathers and saves MIB data to files in the Compaq Foundation Data Registry. MIB data is periodically updated by the data collection agents at configurable poll intervals. SNMP set commands are performed by the agent responsible for managing the selected MIB data item. SNMP trap commands are generated by data collection agents. Compaq Foundation Data Registry The Compaq Foundation Data Registry (/var/spool/compaq/foundation/registry) is comprised of standard Linux directories and associated files. Each file in the data registry is a logical object containing “n” related data items. Note: Compaq MIB items supported by Linux Foundation data collection agents are listed in /opt/compaq/foundation/etc/cmafdtnobjects.conf file. Configuring Foundation Data Collection Agents Host OS Agent The Host OS Agent gathers data for the Compaq Host OS MIB. This data includes: ! ! ! ! Server/Host name and OS version number CPU utilization information (for each CPU) over 1-minute, 5-minute, 30-minute, and 60-minute intervals Linux File System information (for each mounted file system) Software version information The Host OS agent executable is /opt/compaq/foundation/bin/cmahostd. The following command line arguments can be used with the Host OS agent executable: -p poll_time—specifies the number of seconds to wait between data collection intervals (default is 15 seconds). The minimum value allowed is 1 second. The maximum value allowed is 60 seconds. This argument is required. -s set_state—specifies whether SNMP set commands are allowed for this agent. A set_state of OK means that SNMP set commands are allowed. A set_state of NOT_OK means that SNMP set commands are not allowed. Default set _state is OK. -t trap_state—specifies whether SNMP trap commands are allowed for this agent. A trap_state of OK means that SNMP trap commands are allowed. A trap_state of NOT_OK means that SNMP trap commands are not allowed. Default trap _state is OK. - 25 - During installation, this agent is configured to start automatically after SNMP agent (snmpd) is started and to stop after snmpd is stopped. The Host OS Agent can be started manually by issuing the command: /etc/rc.d/init.d/cmafdtn start cmahostd The Host OS Agent can be stopped manually by issuing the command: /etc/rc.d/init.d/cmafdtn stop cmahostd Threshold Agent The Threshold Agent implements the Compaq Threshold MIB. Users can set thresholds on counter or gauge type MIB variables. Each selected MIB variable is periodically sampled by the threshold agent at a rate defined by the user. MIB data values are compared to user-configured thresholds. If a configured threshold is exceeded, an alarm trap is sent to the configured SNMP trap destination and to Linux email (configurable through "trapemail" entries in /opt/compaq/cma.conf file). Userconfigured alarm thresholds are permanently saved in the data registry until deleted by the user. For further information on “Set Thresholds,” refer to the Compaq Insight Manager User Guide help file. Threshold agent executable is /opt/compaq/foundation/bin/cmathreshd. The following command line arguments can be used with the Threshold agent executable: -p poll_time—specifies the rate at which the threshold agent checks to see if any MIB items need to be sampled. The suggested value is 5 seconds. The minimum value allowed is 1 second. The maximum value allowed is 60 seconds. This argument is required. -s set_state—specifies whether SNMP set commands are allowed for this agent. A set_state of OK means that SNMP set commands are allowed. A set_state of NOT_OK means that SNMP set commands are not allowed. The default set_state is OK. -t trap_state—specifies whether SNMP trap commands are allowed for this agent. A trap_state of OK means that SNMP trap commands are allowed. A trap_state of NOT_OK means that SNMP trap commands are not allowed. The default trap _state is OK. - 26 - During installation, this agent is configured to start automatically after SNMP agent (snmpd) is started and to stop after snmpd is stopped. The Threshold Agent can be started manually by issuing the command: /etc/rc.d/init.d/cmafdtn start cmathreshd The Threshold Agent can be stopped manually by issuing the command: /etc/rc.d/init.d/cmafdtn stop cmathreshd The Threshold entries can be removed using the following procedure: 1. Run the Foundation Agents stop script to stop the Threshold agent by typing: /etc/rc.d/init.d/cmafdtn stop cmathreshd 2. Delete the threshold entries from the Threshold Data Registry file by typing: rm /var/spool/compaq/foundation/registry/threshold/entry* 3. Run the Foundation Agents start script to start the Threshold Agent by typing: /etc/rc.d/init.d/cmafdtn start cmathreshd Web Agent The Web Agent runs as a daemon and converts SNMP information into HTML so that it can be viewed from a Web browser. The Web Agent provides Web pages containing management information about Compaq servers. The Web Agent allows users to view subsystem and status information of Compaq Servers from a Web browser, either locally or remotely. The Web Agent also provides extensive SET capabilities. See the “Web-Enabled Compaq Management Agents User Guide” for more information about the Web Agent. This guide can be found on the Compaq Management CD at /docs/eng/imaug.pdf. To view data locally, use one of the following URLs: http://127.0.0.1:2301/ http://localhost:2301/ To view data on remote systems, use the following URL: http://RemoteSystem:2301/ where RemoteSystem is the IP address or the DNS domain name of remote system. - 27 - Note: Notice that the URL is followed by :2301. This is the port number that the Web Agent uses to communicate with the browser. If this number is not specified, the browser might connect to another Web page if the managed server is running a web server. After entering the URL, the Device Home Page is displayed. Click on the “Compaq Management Agents” icon to start viewing the Web pages provided by the Web Agent. For Web Agents to work properly, the “localhost” (127.0.0.1) requires SNMP READ (GET) privileges at minimum. “localhost” SNMP WRITE (SET) privileges is required for enabling SNMP WRITE (SET) capability in Web Agent. See “SNMP Agent Configuration” section for more information. - 28 - The Web agent Start/Kill script is: /opt/compaq/foundation/etc/cmawebd During installation, this agent is configured to start automatically after SNMP agent (snmpd) is started and to stop after snmpd is stopped. The Web Agent can be started manually by issuing the command: /etc/rc.d/init.d/cmafdtn start cmawebd The Web Agent can be stopped manually by issuing the command: /etc/rc.d/init.d/cmafdtn stop cmawebd All four agent packages carry the data component consisting of template files, gif files, and html files that will be installed under the Web Agent root directory: /opt/compaq/webagent. During removal of the package, the same files will be removed from: /opt/compaq/webagent. 4.2 Using the Server Agent Linux SNMP Daemon An UCD SNMP agent (RPM name: ucd-snmp) must be installed under Linux and is located in /usr/sbin/snmpd. The UCD SNMP agent provides SNMP service over UDP/IPbased networks. The UCD SNMP agent provides an extension mechanism for supporting vender-specific MIBs. Compaq Management Agent eXtension (cmaX) has been developed by Compaq for supporting all the Compaq MIBs (enterprises.232). Remote management consoles issue SNMP “get and set” packets over a UDP/IP network to the local SNMP agent. The SNMP agent is started and stopped from a shell script. It is user-configurable and can be started automatically at system startup and stopped automatically at system shutdown. You can manually start and stop the SNMP daemon by entering the following command: /etc/rc.d/init.d/snmpd start - 29 - Compaq Server Peer The Compaq Server Peer extends the SNMP “enterprise” MIB to include Compaq Server MIB data. The Compaq Server Peer supports get, set, and trap operations on data items defined in the Compaq Health, Standard Equipment and RIB MIBs. Compaq Server MIB data is gathered by data collection agent processes (Health, Standard Equipment and RIB Agents). Each agent collects and saves MIB data in files that are read by the Server Peer during SNMP get commands. SNMP set commands are routed by the Server Peer to the agent responsible for managing the selected MIB data item. SNMP trap commands are generated by data collection agents and routed to the Server Peer. At SNMP agent startup time, Compaq Health, Standard Equipment and RIB MIB items in the file /opt/compaq/Server/etc/cmasvrobjects.conf are read by Compaq Management Agents eXtension (cmaX) and registered with the SNMP agent. During the installation, the Server Peer is configured to startup automatically when the SNMP agent is running and to shutdown automatically when the SNMP agent exits. Linux runlevel configuration tools can be used to change Server Peer configuration. Server Peer (cmasvrpeerd) should be started after the SNMP agent “snmpd” is started and be killed after “snmpd” is killed. The Server Peer can be started manually by issuing the following command: /etc/rc.d/init.d/cmasvr start cmasvrpeerd The Server Peer can be stopped manually by issuing the following command: /etc/rc.d/init.d/cmasvr stop cmasvrpeerd Compaq Management Agents Configuration File Compaq Management Agents Configuration file /opt/compaq/cma.conf is shared by all Compaq Management Agents for Servers packages. Currently, only trap email notification configuration and base socket number used by cmaX are supported. Compaq Management Agents for Servers is capable of sending email notifications in addition to the SNMP traps. The “trapemail” entries in configuration file /opt/compaq/cma.conf configures the email commands, which are then read by the Server Peer during its initialization. - 30 - Note: If this configuration file is edited, the Server Peer software must be restarted before the configuration modification is effective. You can do this by entering the following commands: sh/etc/rc.d/init.d/cmasvr restart cmasvrpeerd The syntax of the trapemail lines is: trapemail mail_command where “trapemail” is the keyword indicating that the rest of the line is the command for sending trap email. In “mail_command”, provide the full path of your email command, the subject and the recipients. The “mail_command” should read standard input for the body of the email. Multiple “trapemail” lines may be defined in /opt/compaq/cma.conf. the following default line will be added during installation if none exists: trapemail/bin/mail -s 'Compaq Management Agents Trap Alert' root The “cmaXSocketBase” entry in configuration file /opt/compaq/cma.conf configures the starting socket port that is used for communications between cmaX and Peers. The entry is not needed unless "bind() failed!" message displays in agents log file /var/spool/compaq/cma.log. Example: cmaXSocketBase 12345 Server Data Collection Agents Each Compaq Server Data Collection Agent gathers and saves MIB data to files in the Compaq Data Registry. MIB data is periodically updated by the data collection agents at configurable poll intervals. SNMP set commands are performed by the agent responsible for managing the selected MIB data item. SNMP trap commands are generated by data collection agents. Compaq Server Data Registry The Compaq Server Data Registry (/var/spool/compaq/server/registry) is comprised of standard Linux directories and associated files. Each file in the data registry is a logical object containing “n” related data items. Note: Compaq MIB items supported by Linux Server data collection agents are listed in /opt/compaq/server/etc/cmasvrobjects.conf file. - 31 - Configuring Server Data Collection Agents Standard Equipment Agent The Standard Equipment Agent gathers data for the Compaq Standard Equipment MIB. The data includes: ! ! ! PCI slot information Processor and coprocessor information Standard peripheral information (serial ports, diskette drives, and so on) The Standard Equipment Agent executable is: /opt/compaq/server/bin/cmastdeqd The following command line arguments can be used with Standard Equipment Agent: ! -p poll_time—specifies the number of seconds to wait between data collection intervals. The minimum allowed value is 1 second and the default value is 60 seconds. ! -s set_state—specifies whether SNMP set commands are allowed for this agent. A set_state of OK (default) means that SNMP set commands are allowed. A set_state of NOT_OK means that SNMP set commands are not allowed. ! -t trap_state—specifies whether SNMP trap commands are allowed for this agent. A trap_state of OK (default) means that SNMP trap commands are allowed. A trap_state of NOT_OK means that SNMP trap commands are not allowed. ! -r reboot_state—specifies whether a remote management station can reboot this device. A reboot_state of OK (default) means that remote reboots are allowed. A reboot_state of NOT_OK means that remote reboots are not allowed. During installation, this agent can be configured to start automatically after SNMP agent (snmpd) is started and to stop after snmpd is stopped. The Standard Equipment Agent is started manually by issuing the command: /etc/rc.d/init.d/cmasvr start cmastdeqd The Standard Equipment Agent can be stopped manually by issuing the command: /etc/rc.d/init.d/cmasvr stop cmastdeqd - 32 - System Health Agent The System Health Agent gathers data for the Compaq Health MIB. The data collected include critical (NMI) errors, correctable memory (ECC) errors, system hang/panic detection, temperature conditions, and fan failures. Both critical errors and correctable memory errors (ECCs) are monitored by the System Health driver. A critical error, such as an uncorrectable memory error, is logged in the Integrated Management Log. The error is then retrieved by the System Health Agent. Correctable memory errors (ECC) are monitored by the System Health driver. If a correctable memory error occurs, the error is corrected and logged in the Integrated Management Log. The error is then retrieved by the System Health Agent. The operating temperature of the system is monitored by the System Health driver. If the normal operating temperature is exceeded, or a cooling fan fails, System Health driver sends a notice of the problem. It will make an entry in the Integrated Management Log, and then (optionally) shuts down the system to avoid hardware damage. Automatic shutdown is configured through the Compaq System Configuration Utility. Fan failure is detected by the System Health driver. If a required fan or a CPU fan fails, the system can be gracefully shutdown. The System health agent executable is /opt/compaq/server/bin/cmahealthd. The following command line arguments can be used with System Health agent: ! ! ! -p poll_time—specifies the number of seconds to wait between data collection intervals. The minimum allowed value is 1 second and the default value is 60 seconds. -s set_state—specifies whether SNMP set commands are allowed for this agent. A set_state of OK (default) means that SNMP set commands are allowed. A set_state of NOT_OK means that SNMP set commands are not allowed. -t trap_state—specifies whether SNMP trap commands are allowed for this agent. A trap_state of OK (default) means that SNMP trap commands are allowed. A trap_state of NOT_OK means that SNMP trap commands are not allowed. During installation, this agent is configured to start automatically after SNMP agent (snmpd) is started and to stop after snmpd is stopped. The System Health Agent can be started manually by issuing the command: /etc/rc.d/init.d/cmasvr start cmahealthd The System Health Agent is stopped manually by issuing the command: /etc/rc.d/init.d/cmasvr stop cmahealthd - 33 - Remote Insight Agent The Remote Insight Agent gathers data for the Compaq Remote Insight MIB. The data includes: ! Configuration and statistical information for the Remote Insight Board (RIB) ! Events logged onto the RIB ! Configuration and statistical information for the Remote Insight NIC For Remote Insight Agents to work properly, the “localhost” (127.0.0.1) requires SNMP READ (GET) privileges at minimum. “localhost” SNMP WRITE (SET) privileges is required for enabling SNMP WRITE (SET) capability in Remote Insight Agent. See “SNMP Agent Configuration” section for more information. The Remote Insight Agent executable is: /opt/compaq/server/bin/cmasm2d The following command line arguments can be used with Remote Insight Agent: ! ! ! ! -p poll_time—specifies the number of seconds to wait between data collection intervals. The minimum allowed value is 1 second and the default value is 60 seconds. -s set_state—specifies whether SNMP set commands are allowed for this agent. A set_state of OK (default) means that SNMP set commands are allowed. A set_state of NOT_OK means that SNMP set commands are not allowed. -t trap_state—specifies whether SNMP trap commands are allowed for this agent. A trap_state of OK (default) means that SNMP trap commands are allowed. A trap_state of NOT_OK means that SNMP trap commands are not allowed. During installation, this agent is configured to start automatically after SNMP agent (snmpd) is started and to stop after snmpd is stopped. - 34 - The Remote Insight Agent can be started manually by issuing the command: /etc/rc.d/init.d/cmasvr start cmasm2d The Remote Insight Agent is stopped manually by issuing the command: /etc/rc.d/init.d/cmasvr stop cmasm2d 4.3 Using the Storage Agent Linux SNMP Daemon An UCD SNMP agent (RPM name: ucd-snmp) must be installed under Linux and is located in /usr/sbin/snmpd. The UCD SNMP agent provides SNMP service over UDP/IPbased networks. The UCD SNMP agent provides an extension mechanism for supporting vender-specific MIBs. Compaq Management Agent eXtension (cmaX) has been developed by Compaq for supporting all the Compaq MIBs (enterprises.232). Remote management consoles issues SNMP Get and Set packets over a UDP/IP network to the local SNMP agent. The SNMP agent is started and stopped from a shell script. It is user-configurable and can be started automatically at system startup and stopped automatically at system shutdown. You can manually start and stop the SNMP daemon by entering the following commands: /etc/rc.d/init.d/snmpd start /etc/rc.d/init.d/snmpd stop Compaq Storage Peer The Compaq Storage Peer extends the SNMP “enterprise” MIB to include Compaq Storage MIB data. The Compaq Storage Peer supports Get, Set, and Trap operations on data items defined in the Compaq Storage MIB. Compaq Storage MIB data is gathered by data collection agent processes. Each agent collects and saves MIB data in files that are read by the Compaq Storage Peer during SNMP get commands. SNMP set commands are routed by the Compaq Storage Peer to the agent responsible for managing the selected Storage MIB data item. SNMP trap commands are generated by data collection agents and routed by the Compaq Storage Peer to the SNMP daemon. At Compaq Storage Peer startup time, all Compaq MIB items in the file /opt/compaq/storage/etc/cmastorobjects.conf are read by Compaq Management Agents eXtension(cmaX) and registered with the SNMP Agent. - 35 - During installation, the Compaq Storage Peer is configured to startup automatically when the SNMP agent is running and to shutdown automatically when the SNMP agent exits. Linux run level configuration tools can be used to change Storage Peer configuration. Storage Peer (cmastorpeerd) should be started after SNMP agent “snmpd” is started and be killed after “snmpd” is killed. The Compaq Storage Peer can be started manually by issuing the following command: /etc/rc.d/init.d/cmastor start cmastorpeerd The Compaq Storage Agents can be stopped manually by issuing the following command: /etc/rc.d/init.d/cmastor stop cmastorpeerd Compaq Management Agents Configuration File Compaq Management Agents Configuration file /opt/compaq/cma.conf is shared by all Compaq Management Agents for Servers packages. Currently, only trap email notification configuration and base socket number used by cmaX are supported. Compaq Management Agents for Servers is capable of sending email notifications in addition to the SNMP traps. The “trapemail” entries in configuration file /opt/compaq/cma.conf configures the email commands, which are then read by the Storage Peer during its initialization. Note: If this configuration file is edited, the Storage Peer software must be restarted before the configuration modification is effective. You can do this by entering the following commands: /etc/rc.d/init.d/cmastor restart cmastorpeerd - 36 - The syntax of the trapemail lines is: trapemail mail_command where “trapemail” is the keyword indicating that the rest of the line is the command for sending trap email. In “mail_command”, you should provide, the full path of your email command, the subject and the recipients. The “mail_command” should read standard input for the body of the email. Multiple “trapemail” lines may be defined in /opt/compaq/cma.conf. The following default line will be added during installation if none exists: trapemail /bin/mail -s 'Compaq Management Agents Trap Alert' root The “cmaXSocketBase” entry in configuration file /opt/compaq/cma.conf configures the starting socket port that is used for communications between cmaX and Peers. The entry is not needed unless "bind() failed!" message displayed in agents log file /var/spool/compaq/cma.log. Example: cmaXSocketBase 12345 Storage Data Collection Agents Each Compaq Data Collection Agent gathers and saves Storage MIB data to files in the Compaq Storage Data Registry. MIB data is periodically updated by the data collection agents at configurable poll intervals. SNMP set commands are performed by the agent responsible for managing the selected MIB data item. SNMP trap commands are generated by data collection agents. The Compaq IDA agent can be started manually by issuing the following command: /etc/rc.d/init.d/cmastor start cmaidad The Compaq IDA agent can be stopped manually by issuing the following command: /etc/rc.d/init.d/cmastor stop cmaidad The Compaq FCA agent can be started manually by issuing the following command: /etc/rc.d/init.d/cmastor start cmafcad The Compaq FCA agent can be stopped manually by issuing the following command: /etc/rc.d/init.d/cmastor stop cmafcad - 37 - The Compaq IDE agent can be started manually by issuing the following command: /etc/rc.d/init.d/cmastor start cmaided The Compaq IDE agent can be stopped manually by issuing the following command: /etc/rc.d/init.d/cmastor stop cmaided The Compaq SCSI agent can be started manually by issuing the following command: /etc/rc.d/init.d/cmastor start cmascsid The Compaq SCSI agent can be stopped manually by issuing the following command: /etc/rc.d/init.d/cmastor stop cmascsid Compaq Storage Data Registry The Compaq Storage data registry (/var/spool/compaq/storage/registry) is comprised of standard Linux directories and associated files. Each file in the data registry is a logical object containing “n” related data items. - 38 - Configuring Storage Data Collection Agents For more information on configuring Data Collection Agents, choose from the following: IDA Agent The IDA Agent gathers data for the Compaq Intelligent Drive Array (IDA) MIB. The data includes: ! ! ! ! IDA controller information IDA accelerator information IDA logical drive information IDA physical drive information During installation, the IDA Agent is configured to start up automatically when the snmpd is running and to shutdown automatically when snmpd is not running. The IDA Agent is located in /opt/compaq/storage/bin/cmaidad. It can be started manually by issuing the following command: /opt/compaq/storage/bin/cmaidad –p poll_time where poll_time is the number of seconds between data collection intervals. The suggested poll_time is 60 seconds (default). The minimum poll_time is 5 seconds. Note: Increasing the agent poll_time setting improves system performance but decreases the data collection rate. Conversely, decreasing the agent poll_time setting increases the data collection rate but may decrease system performance. FCA Agent The FCA Agent gathers data for the Compaq Fibre Channel Array (FCA) MIB. The data includes: ! ! ! ! ! ! ! ! ! ! FCA host controller information FCA array controller information FCA array accelerator information FCA logical drive information FCA physical drive information FCA storage system chassis information FCA storage system power supply information FCA storage system fan information FCA storage system temperature information FCA storage system backplane information - 39 - During installation, the FCA Agent is configured to start up automatically when snmpd is started and to shutdown automatically when snmpd is stopped. The FCA Agent is located in /opt/compaq/storage/bin/cmafcad. It can be started manually by the following command: /opt/compaq/storage/bin/cmafcad -p poll_time where poll_time is the number of seconds between data collection intervals. The suggested poll_time is 60 seconds (default). The minimum poll_time is 5 seconds. Note: Increasing the agent poll time setting improves system performance but decreases the data collection rate. Decreasing the agent poll time setting increases the data collection rate but may also decrease system performance. IDE Agent The IDE Agent gathers data for the Compaq IDE MIB. The data includes: ! ! ! IDE host controller information ATA disk information ATAPI device information During installation, the IDE Agent is configured to start up automatically when snmpd started and to shutdown automatically when snmpd is stop. The IDE agent is located in /opt/compaq/storage/bin/cmaided. It can be started manually by the following command: /opt/compaq/storage/bin/cmaided -p poll_time where poll_time is the number of seconds between data collection intervals. The suggested poll_time is 15 second. The minimum poll_time is 5 seconds. - 40 - SCSI Agent The SCSI Agent gathers data for the Compaq SCSI MIB. The data includes: ! ! SCSI host controller information SCSI disk drive information Note: Compaq storage box and tape drive information is not supported in this release. During installation, the SCSI Agent is configured to start up automatically when snmpd is started and to shutdown automatically when snmpd is stopped. The SCSI Agent is located in /opt/compaq/storage/bin/cmascsid. It can be started manually by the following command: /opt/compaq/storage/bin/cmascsid –p poll_time where poll_time is the number of seconds between data collection intervals. The suggested poll_time is 15 seconds. The minimum poll_time is 5 seconds. 4.4. Using the NIC Agent The Compaq NIC Agent gathers data for the Compaq NIC MIB from NIC device drivers supporting the /proc file system reporting format. The data includes: ! ! Physical mapping and configuration data for each network interface. Network statistics for Ethernet interfaces. Information is provided for Compaq controllers. Limited information may be provided for other NICs. During installation, the NIC agent is configured to automatically startup at the same runlevels as the snmpd daemon. You can manually start and stop the cmanic daemon (cmanicd) by entering the following commands: /etc/rc.d/init.d/cmanic start /etc/rc.d/init.d/cmanic stop You can restart the NIC Agent using the following command: /etc/rc.d/init.d/cmanic restart Note: Anytime snmpd.conf or snmpd.local.conf configuration files are changed, or the SNMPCONFPATH environment variable is changed, the cmanic daemon must be restarted. - 41 - A Compaq NIC Agent README file is placed in the /opt/compaq/nic/etc directory after installation. The README file contains the most up-to-date information on Compaq NIC Agents. Command Line Arguments The following command line arguments can be passed to cmanicd from the /opt/compaq/nic/etc/cmanicd script: -p poll_time—specifies the number of seconds between data caching/poll intervals. NIC drivers are only queried when a request comes in and the cached information is older than the specified poll interval. The default value is 20 seconds. The minimum poll time is 10 seconds. -s set_state—specifies whether SNMP set commands are allowed for this agent. A set_state of OK (default) means that SNMP set commands are allowed. A set_state of NOT_OK means that SNMP set commands are not allowed. -t trap_state—specifies whether the NIC agent is allowed to send traps or not. A trap_state of OK (default) indicates the NIC agent may send SNMP traps. A trap_state of NOT_OK means that NIC agent is not allowed to send traps. For example, to set the poll interval to 30 seconds and prevent traps one would change PFLAGS= to PFLAGS=”-p30 -t NOT_OK” in the /opt/compaq/nic/etc/cmanicd script. Traps are configured using the standard SNMP configuration file (snmpd.conf). Please refer to the snmpd.conf manual page for the most up to date configuration information. Anytime snmpd.conf or snmpd.local.conf configuration files are changed, or the SNMPCONFPATH environment variable is changed, the cmanic daemon must be restarted. - 42 - 5 Troubleshooting 5.1. Problems Working with Compaq Insight Manager The following topics provide information on resolving problems while working with Compaq Insight Manager: Cannot Manage Server from Compaq Insight Manager Check if the network is working by pinging the Server from the system running Compaq Insight Manager. Make sure that Compaq Insight Manager is using the correct community string which is defined in Server’s “snmpd.conf” files (Default files are /usr/share/snmp/snmpd.conf, /usr/lib/snmp/snmpd.conf and $HOME/.snmp/snmpd.conf). Make sure that “Post-Installation Configurations” had been performed properly. Check the Host OS Agent status with the Linux command ps -ef | grep cmahostd. If the agent is not running, make sure that Foundation Agents Start script is installed properly under /etc/rc.d/ (For Red Hat Linux, use “%/sbin/chkconfig –list cmafdtn” command). Start the Host Agent manually using the following command: /etc/rc.d/init.d/cmafdtn start cmahostd If the Host OS agent is running and not reporting data, or if it was correctly started but is no longer running, check the file /var/spool/compaq/cma.log for error messages. You must be logged in as “root” to access this file. If your system is running Red Hat 7.1 and was configured with Firewall security level “High” or “Medium”, the incoming SNMP requests might be “REJECTED” by the server. The server can be configured to “ACCEPT” SNMP requests using “ipchains” command. See “Foundation Agents Dependencies” for more information. Grayed-out Utilization Button Check the Host OS Agent status with the Linux command ps -ef | grep cmahostd. If the agent is not running, make sure that Foundation Agents Start script is installed properly under /etc/rc.d/ (/ (For Red Hat Linux, use “%/sbin/chkconfig –list cmafdtn” command). Start the Host Agent manually using the following command: /etc/rc.d/init.d/cmafdtn start cmahostd - 43 - If the agent is running and not reporting data, or if it was correctly started but is no longer running, check the file /var/spool/compaq/cma.log for error messages. You must be logged in as “root” to access this file. Missing File System Space Used Information in the Mass Storage Window Check the Host OS Agent status with the Linux command ps -ef | grep cmahostd. If the agent is not running, make sure that Foundation Agents Start script is installed properly under /etc/rc.d/ (For Red Hat Linux, use “%/sbin/chkconfig –list cmafdtn” command). Start the Host agent manually using the following command: /etc/rc.d/init.d/cmafdtn start cmahostd If the agent is running and not reporting data, or if the agent was correctly started but is no longer running, check the file /var/spool/compaq/cma.log for error messages. You must be logged in as “root” to access this file. Grayed-out System Board, Expansion Boards, or Configuration Buttons Check the Standard Equipment Agent status with the Linux command ps -ef | grep cmastdeqd. If the agent is not running, make sure that Server Agents Start script is installed properly under /etc/rc.d/ (For Red Hat Linux, use “%/sbin/chkconfig –list cmasvr” command). Start the Standard Equipment Agent manually using following command: /etc/rc.d/init.d/cmasvr start cmastdeqd If the agent is running and not reporting data, or if the agent was correctly started but is no longer running, check the file /var/spool/compaq/cma.log for error messages. You must be logged in as “root” to access this file. Missing SCSI Drive Information in the Mass Storage Window Check the SCSI agent status with the command ps -ef | grep cmascsid. If the agents are not running, they must be started (refer to the start/stop documentation for the appropriate agent). If the agent is running and not reporting data or, if it was correctly started but is no longer running, check the file /var/spool/compaq/cma.log for error messages. You must be logged in as “root” to access this file. - 44 - Added SCSI Devices Do Not Appear To minimize system overhead, the “cmascsid” process does not search for new hardware every poll_time. There will be a delay of up to 32 times the poll interval, which is normally every 30 seconds, up to 16 minutes in the default case, before new SCSI devices are discovered by “cmascsid” and reported to Compaq Insight Management Console. Once the hardware has been discovered, its status is checked each poll_time and reported to Compaq Insight Management Console when it has changed. Missing or 0-Value SCSI Hard Drive Serial Number or Capacity Most SCSI hard drives do not make this information available to the host when the drive media are not spinning. Hot-pluggable drives do not start spinning until the operating system attempts to open them. Obtaining this information requires access to the drive. After the drive is first opened, to minimize system overhead, there may be a delay of up to 32 times the poll_time of the “cmascsid” process before updated information is available to Compaq Insight Management Console. Grayed-out Button for a SCSI Controller Information about the configuration of the device indicates that a SCSI controller is installed but no further information is available. Several conditions result in a grayed-out button: ! The SCSI agent process “cmascsid” may not be running. ! The SCSI controller may have been disabled by the Compaq System Configuration Utility. ! This may be an unsupported controller. Missing Drive Array in the Mass Storage Window Check the Mass Storage Agent status with the Linux command ps -ef | grep cmaidad. If the agent is not running, it must be started (refer to the start/stop documentation for the appropriate agent). If the agent is running and not reporting data, or if it was correctly started but is no longer running, check the file /var/spool/compaq/cma.log for error messages. You must be logged in as “root” to access this file. - 45 - Grayed-out IDA Controllers in the Mass Storage Window Check the IDA Monitoring Agent status with the Linux command ps -ef | grep cmaidad. If the agent is not running, it must be started (refer to the start/stop documentation for the appropriate agent). Grayed-out FCA Controllers in the Mass Storage Window Check the FCA Monitoring Agent status with the Linux command, ps -ef | grep cmafca. If the agent is not running, it must be started (refer to the start/stop documentation for the appropriate agent). Grayed-out IDE Controllers in the Mass Storage Window Check the IDE Agent status with the Linux command ps –ef | grep cmascsid. If the agents is not running, it must be started(refer to start/stop documentation for the appropriate agent). Grayed-out Recovery Button in the Device View Window Check to make sure your system supports the System Health agent features. Check the System Health Agent status with the Linux command ps -ef | grep cmahealthd. If the agent is not running, it must be started (refer to the start/stop documentation for the System Health agent). Grayed-out Auto Recovery Button in the Recovery Window Check to make sure your system supports this feature. Check the System Health Agent status with the Linux command ps -ef | grep cmahealthd. If the agent is not running, it must be started (refer to the start/stop documentation for the System Health Agent). - 46 - Grayed-out Environment Button in the Recovery Window Information about the environmental conditions of the system cannot be obtained. Check the System Health Agent status with the Linux command ps -ef | grep cmahealthd. If the agent is not running, it must be started (refer to the start/stop documentation for the System Health Agent). Check to make sure your system supports this feature. This feature is supported only on Compaq ProLiant servers. Grayed-Out Remote Insight Button in the Recovery Window A grayed-out Remote Insight button can be caused by one of the following: ! ! ! The Remote Insight Controller may not be configured properly. The Remote Insight driver may not be installed The Remote Insight Agent cmasm2d may not be running 5.2 Problems Working with SNMP-Based Management Programs For more information on resolving problems working with SNMP-based management programs, choose from the following: ! ! ! ! Unable to Change Any Values on the Managed Server Unable to Set Thresholds on Compaq MIB Items No SNMP Traps/Alarms are Received No User-Defined SNMP Traps are Received Unable to Change Any Values on the Managed Server Make sure that the SNMP agent, the Peer and the agent processing the set are all running. Check the agent command line arguments in the agent’s start script files. Verify that the either argument -s OK is present or default set_state is OK for the agent. This process enables SNMP sets for this agent only. Verify that the server SNMP community string defined in your snmpd.conf (using “rwcommunity” keyword) matches the community string defined at the management console. If you are using Compaq Insight Manager, the Community String can be set in “Device SetUp” window (for more information, refer to the section covering community strings in the Compaq Insight Manager User Guide help file). - 47 - If you change the snmpd.conf files, you need to refresh snmpd and Agents with following commands: %kill – HUP `/sbin/pidof snmpd` %/etc/rc.d/init.d/cmafdtn restart %/etc/rc.d/init.d/cmasvr restart cmasvrpeerd %/etc/rc.d/init.d/cmastor restart cmastorpeerd %/etc/rc.d/init.d/cmanic restart Unable to Set Thresholds on Compaq MIB Items Check the Threshold agent status with the following Linux command: ps -ef | grep cmathreshd If the agent is not running, make sure that Foundation Start script (cmafdtn) is installed properly under /etc/rc.d/ (For Red Hat Linux, use “%/sbin/chkconfig –list cmafdtn” command). Start the Threshold agent using following command: /etc/rc.d/init.d/cmafdtn start cmathreshd If the agent is running and not reporting data, or if it was correctly started but is no longer running, check the file /var/spool/compaq/cma.log for error messages. You must be logged in as “root” to access this file. Verify that the server SNMP community string defined in your snmpd.conf (using “rwcommunity” keyword) matches the community string defined at the management console. If you are using Compaq Insight Manager, the Community String can be set in “Device Setup” window (for more information, refer to the section covering community strings in the Compaq Insight Manager User Guide help file). If sets still do not work, perform the following procedure: Stop the Threshold agent using the following command: /etc/rc.d/init.d/cmafdtn stop cmathreshd Delete previous alarm threshold files with the command: rm –f /var/spool/compaq/foundation/registry/threshold/* Start the Threshold agent using the following command: /etc/rc.d/init.d/cmafdtn start cmathreshd - 48 - No SNMP Traps/Alarms Received Make sure that SNMP agent, the Peer, and the agent that generates the trap are all running. Check the snmpd.conf file on your Linux system. Make sure that there is an IP address defined in the “trapsink” lines that matches the IP address of your management station. . If you changed the snmpd.conf files, you need to refresh snmpd and agents with following commands: %kill – HUP `/sbin/pidof snmpd` %/etc/rc.d/init.d/cmafdtn restart %/etc/rc.d/init.d/cmasvr restart cmasvrpeerd %/etc/rc.d/init.d/cmastor restart cmastorpeerd %/etc/rc.d/init.d/cmanic restart Test the traps by setting a threshold on an item that will cause a trap using the “Set Threshold” feature of Compaq Insight Manager (refer to the section, “Set Threshold,” in the Compaq Insight Manager User Guide for more information). If traps still do not function, try having your Linux device send traps to itself. Run the Linux SNMP trap receiving utility “snmptrapd –P”. Next, generate a trap to localhost using the Linux snmptrap utility. The Linux “snmptrapd –P” should display the trap. (See “man snmptrapd” and “man snmptrap” for more information). No User-Defined SNMP Traps Received Check the Threshold Agent status with the Linux command ps -ef | grep cmathreshd. If the agent is not running, make sure that Foundation Agent s Start script (cmafdtn) is installed properly under /etc/rc.d/ (For Red Hat Linux, use “/sbin/chkconfig –list cmafdtn” command.) Start the Threshold Agent using following command: /etc/rc.d/init.d/cmafdtn start cmathreshd Check the Threshold Agent command line arguments. Verify that the argument -t NOT_OK is NOT present in the /opt/compaq/foundation/etc/cmathreshd file. If the agent is running and not reporting data or, if it was correctly started but is no longer running, check the file /var/spool/compaq/cma.log for error messages. You must be logged in as “root” to access this file. - 49 - 5.3. Problems Using Management Agents for Servers The following topics provide information on resolving problems working with Management Agents for Servers: ! ! ! ! ! Disabling SNMP Sets for a Specific Agent Disabling SNMP Traps for a Specific Agent Disabling Remote Reboot Compaq Peer Will Not Run Compaq Web-enabled Management Agents for Servers Disabling SNMP Sets for a Specific Agent Stop the agent associated with the desired MIB. Change the agent command line argument “set” switch to “-s NOT_OK” in the agent’s start script. This procedure disables SNMP sets for this agent only. Restart the agent. Disabling SNMP Traps for a Specific Agent Stop the agent. Change the agent command line trap argument “trap” switch to “-t NOT_OK” in the agent’s start script. This procedure disables SNMP traps for this agent only. Restart the stopped agent. Disabling Remote Reboot Stop the Server Standard Equipment Agent using following command: /etc/rc.d/init.d/cmasvr stop cmastdeqd Edit /opt/compaq/server/etc/cmastdeqd and change the cmastdeqd agent command line reboot switch to “-r NOT_OK”. This procedure disables SNMP reboots for this device only. Restart Standard Equipment agent. - 50 - The Compaq Peer Will Not Run Check the /var/spool/compaq/cma.log file for messages. If you changed the snmpd.conf files, you need to refresh snmpd and agents with following commands: %kill – HUP `/sbin/pidof snmpd` %/etc/rc.d/init.d/cmafdtn restart %/etc/rc.d/init.d/cmasvr restart cmasvrpeerd %/etc/rc.d/init.d/cmastor restart cmastorpeerd %/etc/rc.d/init.d/cmanic restart Compaq Web-enabled Management Agents for Servers The Linux Web Agent has been tested with the following browsers: ! Microsoft Internet Explorer 4.0.1, 5.0 and 5.5, Netscape Communicator 4.51 and 4.70 on Windows 95, Windows 98, Windows NT 4.0 and Windows 2000. ! Netscape Communicator v4.74 on Red Hat Linux 7.0, Netscape Communicator v4.76 on Red Hat Linux 7.1. and Netscape Communicator v4.73 on SuSE 7.0. The minimum browser requirements must be met for viewing the Web-enabled Management Agents for Servers. Depending on how they were implemented, some browsers may or may not work correctly when used with different operating systems. - 51 -
© Copyright 2024