Embedded Support Partner User Guide Document Number 007-4065-009 CONTRIBUTORS Revised by Darrin Goss Production by Karen Jacobson Engineering contributions by the System and Site Support Tools Group COPYRIGHT © 1999, 2000, 2001, 2002, 2003 Silicon Graphics, Inc. — All Rights Reserved This document contains proprietary and confidential information of SGI. The contents of this document may not be disclosed to third parties, copied, or duplicated in any form, in whole or in part, without the prior written permission of SGI. LIMITED RIGHTS LEGEND Use, duplication, or disclosure of the technical data contained in this document by the Government is subject to restrictions as set forth in subdivision (c) (1) (ii) of the Rights in Technical Data and Computer Software clause at DFARS 52.227-7013 and/or in similar or successor clauses in the FAR, or in the DOD or NASA FAR Supplement. Unpublished rights reserved under the Copyright Laws of the United States. Contractor/manufacturer is SGI, 1500 Crittenden Lane, Mountain View, CA 94043. TRADEMARKS AND ATTRIBUTIONS Silicon Graphics, SGI, Challenge, InPerson, IRIX, O2, Octane, Onyx, Onyx2, Origin, and the SGI logo are registered trademarks, and Altix, CASEVision, Key-O-Matic, Performance Co-Pilot, and Supportfolio are trademarks of Silicon Graphics, Inc., in the United States and/or other countries worldwide. CrayLink is a trademark of Cray, Inc. Linux is a registered trademark of Linus Torvalds, used with permission by Silicon Graphics, Inc. MIPS is a trademark of MIPS Technologies, Inc., used under license by Silicon Graphics, Inc. Netscape is a trademark of Netscape Communications Corporation. UNIX is a registered trademark and X Window System is a trademark of The Open Group. U.S. Robotics and Sportster are trademarks of 3Com Corporation. All other trademarks are the property of their respective owners. Embedded Support Partner User Guide Document Number 007-4065-009 Contents List of Figures xi List of Tables xix What’s New in this Document xxi 1. Introduction 1 Distribution 3 Base Package 3 Extended Package 4 Named Groups 6 Full and Light Nodes 7 TCP/IP Protocol 9 Group Management Over Hierarchies 9 Simplified Group Management Configuration 11 Enhanced Configuration for SGM Clients 11 Central Logbook Capability 11 ESP Benefits 12 ESP Architecture 14 Core Software 19 System Support Database (SSDB) 19 ESP and SGM DSOs 19 Monitoring Software 21 Configuration Monitoring 21 Event Monitoring 22 Availability Monitoring 25 Notification Software 26 Console Software 28 Web-based Interface 28 iii Contents Command Line Interface 29 External Tools 30 Performance Monitoring Tools 30 Diagnostic Tools 31 RAID Monitoring Tools 31 Remote Support Capability 31 Security Features 32 System Performance Impact of ESP 33 2. Accessing ESP 35 Using the Command Line Interface 35 Using the Web-based Interface 42 Opening a URL in a Web Browser 44 Using the Embedded_Support_Partner Icon (ESP for the IRIX OS Only) 49 Using the launchESPartner Command (ESP for the IRIX OS Only) 55 Configuring Single System Management 59 Configuring Group Management 60 3. Administering ESP 63 Setting Up the Customer Profile 64 Using the Web-based Interface 64 Using the Command Line Interface 67 Setting Up the Network Permissions 68 Using the Web-based Interface 68 Using the Command Line Interface 70 Setting Up the User Permissions 71 Viewing the Current Users 71 Using the Web-based Interface 71 Using the Command Line Interface 72 Adding a User 73 Using the Web-based Interface 73 Using the Command Line Interface 76 Updating a Password 77 Using the Web-based Interface 77 iv Contents Using the Command Line Interface 79 Updating Permissions for a User 80 Using the Web-based Interface 80 Using the Command Line Interface 83 Deleting a User 85 Using the Web-based Interface 85 Using the Command Line Interface 86 Manipulating Database Archives 87 Using the Web-based Interface 87 Using the Command Line Interface 89 4. Setting Up the ESP Environment 91 Setting Up the System Serial Number (ESP for the Linux OS Only) 92 Setting the System Serial Number (Single System Manager Mode) 93 Setting the System Serial Number (System Group Manager Mode) 95 Setting Up the Global Configuration Parameters 97 Using the Web-based Interface 97 Using the Command Line Interface 102 Setting Up the Paging Parameters (ESP for IRIX OS Only) 105 Setting Up the Modem Parameters (ESP for IRIX OS Only) 107 Using the Web-based Interface 107 Using the Command Line Interface 109 Setting Up the Paging Service Provider Parameters (ESP for IRIX OS Only) 110 Using the Web-based Interface 110 Using the Command Line Interface 112 Setting Up the Paging Parameters (ESP for the IRIX OS Only) 112 Using the Web-based Interface 112 Using the Command Line Interface 113 Setting Up the System Parameters (Single System Manager Mode Only) 114 Setting Up the System/Client Parameters (System Group Manager Mode Only) 116 Adding a New SGM Client 116 Updating the System or a Client 122 Updating the SGM Server 123 Updating an ESP 3.0 SGM Client 125 v Contents Updating an ESP 2.0 SGM Client 129 Unsubscribing SGM Clients 131 Setting Up the Authentication Password 133 Adding a Password for a New Server 133 Updating the Password for an Existing Server 134 Using the Command Line Interface to Configure SGM Settings 135 Importing and Exporting ESP Environments 137 5. Configuring ESP 139 Configuring Events 139 Managing Event Profiles 140 Using the Web-based Interface 140 Using the Command Line Interface 143 Viewing Event Classes and Events 145 Adding Events 146 Using the Web-based Interface 146 Using the Command Line Interface 163 Updating Events 164 Using the Web-based Interface 164 Using the Command Line Interface 171 Updating Multiple Events at the Same Time (Batch Updating) 173 Using the Web-based Interface 173 Using the Command Line Interface 177 Deleting Events 178 Using the Web-based Interface 178 Using the Command Line Interface 180 Subscribing Events from SGM Clients 182 Using the Web-based Interface 182 Using the Command Line Interface 186 Configuring Actions 187 Viewing the Existing Actions 187 Adding Actions 188 Using the Web-based Interface 188 vi Contents Using the Command Line Interface 200 Updating Actions 201 Using the Web-based Interface 201 Using the Command Line Interface 205 Disabling and Enabling Actions 206 Using the Web-based Interface 206 Using the Command Line Interface 207 Configuring Performance Monitoring 208 Using the Web-based Interface 208 Using the Command Line Interface 215 Configuring System Monitoring 216 Using the Web-based Interface (Single System Manager Mode) 216 Using the Web-based Interface (System Group Manager Mode) 220 Using the Command Line Interface 222 6. Viewing Reports 225 About Reports 225 Events Registered Reports 229 Using the Web-based Interface (Single System Manager Mode) 229 Using the Web-based Interface (System Group Manager Mode) 235 Using the Command Line Interface 241 Actions Taken Reports 242 Using the Web-based Interface (Single System Manager Mode) 242 Using the Web-based Interface (System Group Manager Mode) 244 Using the Command Line Interface 246 Availability Reports 247 Using the Web-based Interface (Single System Manager Mode) 247 Using the Web-based Interface (System Group Manager Mode) 250 Using the Command Line Interface 253 Diagnostic Result Reports 254 Using the Web-based Interface (Single System Manager Mode) 254 Using the Web-based Interface (System Group Manager Mode) 256 Using the Command Line Interface 258 vii Contents Hardware Reports 259 Hardware Inventory Reports 259 Using the Web-based Interface (Single System Manager Mode) 259 Using the Web-based Interface (System Group Manager Mode) 262 Using the Command Line Interface 265 Hardware Changes Reports 266 Using the Web-based Interface (Single System Manager Mode) 266 Using the Web-based Interface (System Group Manager Mode) 268 Using the Command Line Interface 270 Software Reports 271 Software Inventory Reports 271 Using the Web-based Interface (Single System Manager Mode) 271 Using the Web-based Interface (System Group Manager Mode) 275 Using the Command Line Interface 277 Software Changes Reports 278 Using the Web-based Interface (Single System Manager Mode) 278 Using the Web-based Interface (System Group Manager Mode) 280 Using the Command Line Interface 281 System Reports 282 System Inventory Reports 282 Using the Web-based Interface 282 Using the Command Line Interface 285 System Changes Reports 286 Using the Web-based Interface (Single System Manager Mode) 286 Using the Web-based Interface (System Group Manager Mode) 288 Using the Command Line Interface 289 Site Reports (System Group Manager Mode Only) 290 Using the Command Line Interface 292 7. Using the ESP Logbook 293 About the ESP Logbook 293 viii Contents Viewing Logbook Entries 293 Using the Web-based Interface (Single System Manager Mode) 293 Using the Web-based Interface (System Group Manager Mode) 295 Using the Command Line Interface 297 Adding a Logbook Entry 298 Using the Web-based Interface (Single System Manager Mode) 298 Using the Web-based Interface (System Group Manager Mode) 300 Using the Command Line Interface 303 8. Sending Notifications 305 About the espnotify Tool 305 Command Line Options for Displaying a Message on the Console 305 Displaying a Message on an X Window System Display 306 Sending an E-mail Message 308 Invoking espnotify from ESP 309 Example: Creating an Action to Send an E-mail 309 9. Logging Events from Applications and Scripts 313 Event Classification and Sequence Numbers 313 Using the Event Manager API 314 Using the emgrlogger and esplogger Tools 314 Example 1 316 Example 2 316 10. Default Event Classes and Types 317 ESP for the Linux OS 317 Default Event Classes 317 Default Event Types 318 ESP for the IRIX OS 321 Default Event Classes 321 Default Event Types 323 11.