HP T9576G06, T9576H01 Management Manual

SNMP Configur ation and Management Manual

Abstract

This manual describes how to install, start, configure, and stop the HP Simple Network Management Protocol (SNMP) Agent and subagents. The SCF commands used by SNMP are described. This manual also discusses the objects in the Management Information Bases (MIBs) used by the agent and subagents. The SNMP Agent and its subagents comply w ith SNM P Requ est s for Comm ent (R F Cs) so that SNM P-comp l iant management applications, known as SNMP managers, can manage various resou rces on an HP NonStop™ host.

Product Version

SNMP Agent (T9576G06), T9576H01)

Supported Release Version Updates (RVUs)

This manual supports the G06.24 RVU and all subsequent G-series RVUs and the H06.03 RVU and all subsequent H-series RVUs until otherwise indicated by its replacement publication.

Part Number Published

424777 -006 July 20 05

Document History

Part Number Product Version Published

424777- 002 SNMP Ag ent (T9576G06) May 2002 424777- 003 SNMP Ag ent (T9576G06) November 2002 424777- 004 SNMP Ag ent (T9576G06) December 2003 424777- 005 SNMP Ag ent (T9576G06) Septem ber 2004 424777- 006 SNMP Ag ent (T9576G06, T9576 H 01) July 2004

Subagent Product Versions IPX/SPX Sub agent (T8170D30)

TCP/IP Subagent (T7862G05) Ethernet/Token Ring Subagent (T0326G06) Trap Multiplexer (T1041G06) NonStop NET/MASTER Trap Subagent (T8491D20) EMS Trap Subagent (T9632D31) Host Resources Subagent (T8496G04) ONS Subagent (T8103D40)

Hewlett-Packard Company—424777-006

SNMP Configuration and Management Manual

Glossary Index Examples Figures Tables

What’s New in This Manual xxiii

Manual Information xxiii New and Changed Information xxiv

About This Manual xxv

Your Comments Invited xxv Audience xxv Purpose xxvi Organization xxvi Related Reading xxviii Notation Conventions xxviii

Part I. Installing and Configuring SNMP

1. The NonStop SNMP Environment

Subsystem Components 1-4

SNMP Manager Station 1-4 SNMP Manager 1-5 PDU 1-5 MIB 1-5 SNMP Agent 1-5

SNMP Subagent 1-6 Toolkits 1-6 Message Protocol 1-6

General SNMP Message Format 1-7

Request PDUs 1-7

Response PDU 1-8

Trap PDU 1-8

Transmitting and Receiving SNMP Packets 1-8 Information Protocol 1-9

SNMP Naming Scheme 1-10

The Management Information Base 1-12

Contents

SNMP Configuration and Management Manual—424777-006

1. The NonStop SNMP Environment (continued)

Traps 1-14 Architectural Overview of NonStop SNMP 1-14 RFC Compliance 1-17 Related Documents 1-18

2. Installing and Configuring the SNMP Agent

Installation 2-1 Before You Configure the SNMP Agent Operations Environment 2-1 Initialization Tasks 2-3 The Default SNMP Agent 2-3 The SNMPCTL File 2-6 Configure the SNMCTL File to Control the SNMP Agent 2-6 RUN Command 2-7

Special Considerations for Users of Logical Network Partitions (LNPs) 2-12

Startup Parameter Summary 2-13

WARM | COLD Custom Configuration Parameters for the RUN Command 2-14

The SNMPCTL File and TRAPPORT 2-16 PARAM Statements’ Custom Configuration for the RUN Command 2-16 Using SCF to Configure Components of the SNMP Agent Environment 2-16

SNMP Agent Process 2-16

Security 2-16

Request/Response Connections 2-17

Trap Connections 2-17

Trap Por t 2-17 Configuring the SNMP Agent Through SNMP Requests 2-17

Request/Response Connections 2-17

Trap Connections 2-17

Authentication Table Entries 2-17

Managing Configuration Definitions Through SNMP 2-18 Single-Node and Multiple-Node Scenarios 2-19 Starting Multiple SNMP Agents on Each Node 2-23 Stopping the SNMP Agent 2-24 Configuring the EMS Collector 2-25

Using the COLLECTOR Startup Parameter 2-26

Using the SCF ALTER PROCESS Command 2-26 Configuring Security 2-26

Authenticating Requests Received Over TCP/IP 2-26

Authenticating Requests Received Using the IPC Interface 2-31

Contents

SNMP Configuration and Management Manual—424777-006

iii

2. Installing and Configuring the SNMP Agent (continued)

After a Request Has Been Authenticated 2-31 Security Scenarios for SNMP Managers Using TCP/IP 2-32

Configuring TCP/IP Request/Response Connections 2-34

Single-Agent Connections 2-35 Multiple-Agent Connections 2-35 Remote Connections 2-37

Configuring Trap Destinations 2-38

Dynamically Generated Trap Destinations 2-40 Forwarding Traps to Managers Communicating Through IPC 2-41 Disabling the Sending of Traps 2-41 Single-Host Connections 2-42 Multiple-Host Connections 2-43

3. MIBs Supported by th e SNMP Agent

SNMP Agent MIB Groups 3-1 RFC Compliance 3-2 Installation 3-2 System Group 3-3

MIB Objects 3-3 RFC Compliance 3-5

SNMP Group 3-6

MIB Objects 3-7 RFC Compliance 3-10

zagInternal Group 3-10

MIB Objects 3-11 SNMP Manager Access to Private MIB Objects 3-20 Table Row Management Overview 3-22 Managing Table Rows From SNMP Managers 3-24

Creating a Table Row 3-28

Default Values for Table Row Objects 3-29

Activating Table Row Entries 3-29

Deactivating Table Row Entries 3-30

Modifying Table Row Entries 3-30

Deleting a Table Row 3-30 Configuring the SNMP Agent Through SNMP Requests 3-30

Request/Response Connections 3-30

Trap Connections 3-30

Authentication Table Entries 3-31

Contents

SNMP Configuration and Management Manual—424777-006

4. Introduction to SCF for the SNMP Agent

Part II. SCF for the SNMP Agent

4. Introduction to SCF for the SNMP Agent

Tasks You Can Perform With SCF 4-1 SCF and the DSM Family of Products 4-2

Subsystem Programmatic Interface 4-2

The Subsystem Control Point 4-2 Objects 4-3

Object Attributes 4-3

Object Hierarchy 4-4

Object States 4-4 The PROCESS O bject 4-5

Naming Conventions: PROCESS Object 4-5

PROCESS Object States 4-6

PROCESS Object Attributes 4-6

Default PROCESS Object 4-6 The ENDPOINT Object 4-8

Naming Conventions: ENDPOINT Object 4-8

ENDPOINT Object States 4-9

ENDPOINT Object Attributes 4-10

Default ENDPOINT Object 4-10 The PROFILE Object 4-12

Naming Conventions: PROFILE Object 4-12

PROFILE Object States 4-14

PROFILE Object Attributes 4-14

Default PROFILE Object 4-14 The TRAPDEST Object 4-16

Naming Conventions: TRAPDEST Object 4-16

TRAPDEST O bject States 4-17

TRAPDEST Object Attributes 4-18

Default TRAPDEST Objects 4-18

SCF-Configured Trap Destination Limitations: Broadcast Only 4-19 Running SCF 4-21 Entering SCF Commands 4-21

SCF Commands for Managing Your SCF Session 4-21

SCF Commands for Managing a Subsystem 4-22

Sensitive and Nonsensitive Commands 4-23

Command Modifiers 4-23

Entering Multiple Commands at a Prompt 4-23

Contents

SNMP Configuration and Management Manual—424777-006

4. Introduction to SCF for the SNMP Agent (continued)

Continuing a Command to the Next Line 4-23

Directing Output to a File 4-24 Error Messages 4-24 SCF Online Help 4-24

Displaying Help for NonStop Agent SCF Commands 4-24

Displaying Help for SCF Error Messages 4-25 SCF Information Specific to the NonStop Agent 4-25

The SCF Product Module for the NonStop Agent 4-26

Before You Can Issue SCF Commands Against the NonStop Agent 4-26

SCF Configuration and the TCPIP^PROCESS^NAME Startup Parameter 4-27

5. SCF Commands for the SNMP Agent

Configuration Restrictions: Attribute Conflicts 5-2 ABORT Command 5-3

ABORT ENDPOINT Command 5-3

ABORT PROFILE Command 5-4

ABORT TRAPDEST Command 5-5 ADD Command 5-5

ADD ENDPOINT Command 5-6

ADD PROFILE Command 5-8

ADD TRAPDEST Command 5-10 ALTER Command 5-13

ALTER ENDPOINT Command 5-13

ALTER PROCESS Command 5-15

ALTER PROFILE Command 5-16

ALTER TRAPDEST Comman d 5-17 DELETE Command 5-19

DELETE ENDPOINT Command 5-19

DELETE PROFILE Command 5-19

DELETE TRAPDEST Command 5-20 INFO Command 5-21

INFO ENDPOINT Command 5-21

INFO PROCESS Command 5-22

INFO PROFILE Command 5-23

INFO TRAPDEST Command 5-24 NAMES Command 5-25 START Command 5-26

START ENDPOINT Command 5-26

Contents

SNMP Configuration and Management Manual—424777-006

5. SCF Commands for the SNMP Agent (continued)

START PROFILE Command 5-26 START TRAPDEST Command 5-27

ST ATUS Command 5-28

STATUS ENDPOINT Command 5-28 STATUS PROCESS Command 5-29 STATUS PROFILE Command 5-30 STATUS TRAPDEST Command 5-31

STOP Command 5-32

STOP ENDPOINT Command 5-33 STOP PROFILE Command 5-33

STOP TRAPDEST Co mmand 5-34 TRACE Command 5-35 VERSION Comm and 5-37

Part III. Troubleshooting

6. SNMP Agent PTrace Facility

Introduction to PTrace 6-1 Running PTrace 6-3

Starting a Noninteractive PTrace Session 6-3

Starting an Interactive PTrace Session 6-4 Device Type 6-4 PTrace Commands 6-4

PTrace Commands Supported by the NonStop Agent 6-5

PTrace Commands Not Supported by the NonStop Agent

6-5

Subset of Useful NonStop Agent PTrace Commands

6-5

FROM Command 6-6 NEXT Command 6-7 RECORD Command 6-9 SELECT Command 6-10

7. Troubleshooting the SNMP Agent

Troubleshooting Strategy 7-1 Diagnosing Startup Errors 7-1 Identifying Unavailable Resour ces 7-2

Underlying Request/Response Connection Resources 7-2 Underlying Trap Destination Resources 7-2

Using EMS Filters 7-2

Contents

SNMP Configuration and Management Manual—424777-006

vii

7. Troubleshoot ing the SNMP Agen t (continued)

7. Troubleshooting the SNMP Agent (continued)

Creating a Filter 7-3 Compiling the Filter 7-4 Displaying Filtered Event Messages 7-4

Using Trace Records 7-4

TCP/IP 7-5 SNMP Agent 7-5

Diagnosing Request Errors 7-6

Part IV. SNMP Subagents

8. TCP/IP Subagent

Architectural Overview 8-1

The TCP/IP Subagent and Its Managed Resources 8-4 The NonStop TCP/IP Subagent and the SNMP Agent 8-4 The Parallel Library TCP/IP Subagent and Its Managed Resources 8-4 The NonStop TCP/IPv6 Subagent and its Managed Resources 8-5 Standard MIB-II Groups Supported by the TCP/IP Subagent 8-5 Private MIB Objects Supported by the TCP/IP Subagent 8-7 MIB Value Derivation 8-7 Unavailable Resources 8-8 Reporting Values for Uninstrumented Objects 8-8 Refreshing MIB Values 8-9

Initiating Backup Process Takeover 8-10 Related Documents 8-11 RFC Compliance

8-11

Installing the TCP/IP Subagent

8-11

Installation Steps 8-11 Before Starting the TCP/IP Subagent 8-12 Starting the TCP/IP Subagent 8-12 Stopping the TCP/IP Subagent 8-16 Configuring a Running TCP/IP Subagent 8-16

Querying a Running TCP/IP Subagent 8-16

Controlling a Running TCP/IP Subagent 8-17 ZTSA MIB Objects 8-20

State Object/Resource Object Pairs 8-28 Interfaces Group 8-30

MIB Objects 8-31

Contents

SNMP Configuration and Management Manual—424777-006

viii

8. TCP/IP Subagent (continued)

RFC Compliance 8-38

ifTable Maintenance 8-38 IP Group 8-40

MIB Objects 8-41

RFC Compliance 8-48

ipAddrTable Maintenance 8-50

ipRouteTable Maintenance 8-50

ipNetToMediaTable Maintenance 8-51 ICMP Group 8-51

MIB Objects 8-52

RFC Compliance 8-55 TCP Group 8-56

MIB Objects 8-57

RFC Compliance 8-60

tcpConnTable Maintenance 8-61 UDP Group 8-61

MIB Objects 8-62

RFC Compliance 8-63

udpTable Maintenance 8-63 Traps Generated by the TCP/IP Subagent 8-64 EMS Support 8-64

Data Definitions 8-67

Subsystem ID 8-68

Tokens in ZTSA Event Messages 8-68

Event Message Descriptions 8-70

1001: ZTSA-EVT-SUBAGENT-AVAIL 8-70

1002: ZTSA-EVT-SUBAGENT-UNAVAIL 8-72

1003: ZTSA-EVT-AGENT-OBJ-AVAIL 8-75

1004: ZTSA-EVT-AGENT-OBJ-UNAVAIL 8-77

1005: ZTSA-EVT-BACKUP-OBJ-AVAIL 8-79

1006: ZTSA-EVT-BACKUP-OBJ-UNAVAIL 8-82

1007: ZTSA-EVT-EMSCOLL-OBJ-AVAIL 8-85

1008: ZTSA-EVT-EMSCOLL-OBJ-UNAVAIL 8-87

1009: ZTSA-EVT-TCPIP-OBJ-AVAIL 8-90

1010: ZTSA-EVT-TCPIP-OBJ-UNAVAIL 8-92

1011: ZTSA-EVT-OUT-OF-MEMORY 8-95

1012: ZTSA-EVT-INTERNAL-FAULT 8-97

1013: ZTSA-EVT-CONFIGURATION-INVALID 8-99

Contents

SNMP Configuration and Management Manual—424777-006

8. TCP/IP Subagent (continued)

1014: ZTSA-EVT-TAKEOVER-BY-BACKUP 8-101

1015: ZTSA-EVT-LANMON-OBJ-UNAVAIL 8-102

1022: ZTSA-EVT-PIFGETSTATUS-ERROR 8-103

1023: ZTSA-EVT-PIFGETATTR-ERROR 8-105

1039: ZTSA-EVT-LIFGETATTR-ERROR 8-106

1041: ZTSA-EVT-PIFGETSTATS-ERROR 8-108

Converting Events to Traps 8-109

9. EMS Trap Subagent

Architectural Overview 9-1 RFC Compliance 9-3 Installation 9-4

Dependencies 9-4

Installation Steps 9-4 Configuration 9-8

Event Filter 9-8

Trap Connections 9-9 Starting and Stopping the Subagent 9-9 The Trap PDU 9-10 The EMS Trap MIB 9-12

10. NonStop NET/MASTER Trap Subagent

Architectural Overview 10-1 RFC Compliance 10-3 Installation 10-3

Dependencies

10-3

Installation Steps

10-4

Configuration 10-9

Modifying GENTRAP 10-9

Trap Connections 10-13 Starting and Stopping the Subagent 10-13 The Trap PDU 10-14 The EMS Trap MIB 10-14 Messages 10-18

openagent Failures 10-18

sendtrap Failures 10-19

closeagent Failures 10-20

Contents

SNMP Configuration and Management Manual—424777-006

11. Host Resources Subagent

Architectural Overview 11-1

Standard MIB Groups 11-1

MIB Extens ions 11-3

Proactive Hardware Manage ment 11-5

Refreshing MIB Values 11-5

MIB Value Management 11-6

Obtaining Information About the Subagent 11-6

Initiating Backup Process Takeover 11-7

Monitoring the Open System Services (OSS) File System 11-7

Related Documents 11-8

RFC Compliance 11-8 Installation 11-8

Dependencies 11-8

Installation Steps 11-9 Configuration 11-10 Starting and Stopping the Subagent 11-12 Troubleshooting the Subagent 11-21

EMS Event Messages 11-22

Startup Problems 11-22

Manager Timeouts 11-22 hrSystem Group 11-25

MIB Objects 11-25

Sample Data 11-27

RFC Compliance 11-28 hrSystem Group Maintenance 11-28 hrStorage Group 11-29

MIB Objects 11-30

Sample Data 11-33

RFC Compliance 11-34

hrStorage Group Maintenance 11-34 hrDevice Group 11-35

MIB Objects 11-39

Sample Data 11-47

RFC Compliance 11-49

hrDevice Group Maintenance 11-50 hrSWRun Group 11-53

MIB Objects 11-54

Sample Data 11-57

Contents

SNMP Configuration and Management Manual—424777-006

11. Host Resources Subagent (continued)

RFC Compliance 11-58

hrSWRun Group Maintenance 11-58 hrSWRunPerf Group 11-59

MIB Objects 11-59

Sample Data 11-60

RFC Compliance 11-61

hrSWRunPerf Grou p Maintenanc e 11-61 zhrmTableInfo Group 11-62

MIB Objects 11-64

Sample Data 11-76

zhrmTableInfo Group Maintenance 11-77 zhrmThreshold Group 11-77

MIB Objects 11-78

Sample Data 11-84

zhrmThreshold Group Maintenance 11-84 zhrmDevUnavail Group 11-85

MIB Objects 11-85

Sample Data 11-90

zhrmDevUnavail Group Maintenance 11-90 zhrmSaProcess Group 11-91

MIB Objects 11-91

Sample Data 11-94

zhrmSaProcess Group Maintenance 11-95 zhrmRefresh Group 11-96

MIB Objects 11-96

Sample Data 11-98

zhrmRefresh Group Maintenance 11-98 Traps 11-99

Routing Traps 11-100

Enabling Traps 11-100

Thresholds and Traps 11-100

Trap PDU 11-101

zhrmTra pDevi ceStateCh ange Trap 11-102

zhrmRAMThreshold Trap 11-103

zhrmDiskThreshold Trap 11-103 EMS Support 11-104

Data Definitions 11-105

Subsystem ID 11-105

Contents

SNMP Configuration and Management Manual—424777-006

xii

11. Host Resources Subagent (continued)

Tokens in ZHRM Event Messages 11-105

Event Message Descriptions 11-107

001: ZHRM-EVT-HRM-SA- TERMIN ATED 11-108

002: ZHRM-EVT-HRM-S A-STARTED 11-109

003: ZHRM-EVT-HRM-SA- IO-E RR 11-111

004: ZHRM-EVT-HRM -SA- NO -M EM-S PACE 11-113

005: ZHRM-EVT-HRM-S A-PROG -E RR 11-114

Related Operating System Event Messages 11-115

Converting Events to Traps 11-116

12. Trap Multiplexer Subagent/Manager

Architectural Overview 12-1

Trap-to-Event Conversion 12-1

SNMP Request Processing 12-3 Related Documents 12-3 Installation 12-4

Dependencies 12-4

Installation Steps 12-4 Configuration 12-4 Starting and Stopping the Trap Multiplexer 12-6

Using the -t and PARAM Startup Parameters 12-10 ztmxPDUSt atistics Group 12-12

MIB Objects 12-12

ztmxPDUStatistics Group Maintenance 12-15 ztmxProcess Group 12-16

MIB Objects 12-16

ztmxProcess Group Maintenance 12-20 EMS Messages 12-21

Event Summary 12-21

Data Definitions 12-25

Subsystem ID 12-26

Tokens in ZTMX Event Messages 12-26

Trap Event Message Descriptions 12-28

000: ZTMX-EVT-TRAP -COLD START 12-32

001: ZTMX-EVT-TRAP -WARMSTART 12-33

002: ZTMX-EVT-TRAP -LINK DOW N 12-34

003: ZTMX-EVT-TRAP -LINK UP 12-35

004: ZTMX-EVT-TRA P-A UTH -FAIL 12-36

Contents

SNMP Configuration and Management Manual—424777-006

xiii

12. Trap Multiplexer

Subagent/Manager (continued)

12. Trap Multiplexer Subagent/Manager (continued)

005: ZTMX-EVT-TRAP -EG P-LOS S 12-37

006: ZTMX-EVT-TRAP -E NT-SPFC 12-38

Process Event Message Descriptions 12-39

101: ZTMX-EVT-TMX- TER MINATED 12-40

102: ZTMX-EVT-TMX- STARTED 12-42

103: ZTMX-EVT-TMX- IO-ER R 12-43

104: ZTMX-EVT-TM X-N O-MEM- S PACE 12-45

105: ZTMX-EVT-TMX- -PR OG-ER R 12-46

Related Operating System Event Messages 12-47

Converting Events to Traps 12-48 Sample EMS Applicatio n 12-48

Application Components 12-48

Preparing the Application 12-49

Running the Application 12-50

Application Control Flow 12-51

Application Source Code 12-52

13. IPX/SPX Subagent (G-Series)

Architectural Overview 13-1

The IPX/SPX Subagent MIB 13-4

Refreshing IPXPROTO Object Values 13-6

Connections Between Subagent and Other Processes 13-7

Resource Utilization 13-9

Subagent Backup Process 13-10

First Failure Data Capture 13-10 Standards Compliance 13-10 Installation 13-10

Dependencies 13-11

Installation Steps 13-11 Configuration 13-12 Starting and Stopping the Subagent 13-13 Troubleshooting the Subagent 13-16

EMS Event Messages 13-16

Startup Problems 13-16

Timeouts 13-17 Novell MIB Objects 13-18

MIB Objects 13-19

ipxBasicSysTable Maintenance 13-21

Contents

SNMP Configuration and Management Manual—424777-006

xiv

13. IPX/SPX Subagent (G-Series) (continued)

Compliance With Novell MIB 13-21 HP MIB Objects 13-22

zipx Group 13-23

zisa Group 13-37 EMS Support 13-45

Subsystem ID 13-46

Tokens in ZISA Event Messages 13-46

Event Message Descriptions 13-49

1001: ZISA-EVT-SUBAGENT-AVAILABLE 13-50

1002: ZISA-EVT-SUBAGENT-UNAVAILABLE 13-52

1003: ZISA-EVT-AGENT-AVAILABLE 13-53

1004: ZISA-EVT-AGENT-UNAVAILABLE 13-55

1005: ZISA-EVT-BACKUP-AVAILABLE 13-58

1006: ZISA-EVT-BACKUP-UNAVAILABLE 13-60

1007: ZISA-EVT-EMSCOLL-AVAILABLE 13-62

1008: ZISA-EVT-EMSCOLL-UNAVAILABLE 13-64

1009: ZISA-EVT-IPXPROTO-AVAILABLE 13-66

1010: ZISA-EVT-IPXPROTO-UNAVAILABLE 13-68

1011: ZISA-EVT-MEMORY-ALLOC-FAILURE 13-70

1012: ZISA-EVT-PROCESS-TRAPPED 13-72

14. Et he r ne t Subagent

Architectural Overview 14-1

The Ethernet Subagent and Its Managed Resources 14-1

The Ethernet Subagent and the SNMP Agent 14-1

dot3 Statistics Group Supported by the Ethernet Subagent 14-3

The Ethernet Subagent MIB 14-3 Installing the Ethernet Subagent 14-5 Before Starting the Ethernet Subagent 14-5 Starting the Ethernet Subagent 14-6 Stopping the Ethernet Subagent 14-8 Initiating Backup Process Takeover 14-8 Configuring a Running Ethernet Subagent 14-9

Querying a Running Ethernet Subagent 14-9

Controlling a Running Ethernet Subagent 14-10 ZESA MIB Objects 14-11

State Object/Resource Object Pairs 14-16

Contents

SNMP Configuration and Management Manual—424777-006

14. Ethernet Subagen t (continued)

14. Et he r ne t Subagent (continued)

Ethernet-Like Statistics dot3Group 14-19

MIB Objects 14-20

RFC Compliance 14-27

dot3StatsTable Maintenance 14-28 Traps Generated by the Ethernet Subagent 14-29 EMS Support 14-30

Data Definitions 14-31

Subsystem ID 14-32

Ethernet Subagent (ZESA) Tokens 14-32

Standard EMS Tokens 14-32

Event Message Descriptions 14-33

3001: ZESA-EVT-SUBAGENT-AVAIL 14-34

3002: ZESA-EVT-SUBAGENT-UNAVAIL 14-36

3003: ZESA-EVT-AGENT-OBJ-AVAIL 14-39

3004: ZESA-EVT-AGENT-OBJ-UNAVAIL 14-41

3005: ZESA-EVT-BACKUP-OBJ-AVAIL 14-43

3006: ZESA-EVT-BACKUP-OBJ-UNAVAIL 14-46

3007: ZESA-EVT-EMSCOLL-AVAIL 14-49

3008: ZESA-EVT-EMSCOLL-UNAVAIL 14-51

3009: ZESA-EVT-TCPIP-OBJ-AVAIL 14-54

3010: ZESA-EVT-TCPIP-OBJ-UNAVAIL 14-56

3011: ZESA-EVT-SRL-CALL-F A ILED 14-59

3012: ZESA-EVT-INTERNAL-FAULT 14-61

3013: ZESA-EVT-CONFIGURATION-INVALID 14-63

3014: ZESA-EVT-TAKEOVER-BY-BACKUP 14-65

Converting Events to Traps 14-66

Part V. Appendices

A. SCF Command Syntax Summary for the NonStop Agent

ABORT Command A-1 ADD Command A-2 ALTER Command A-2 DELETE Command A-3 INFO Command A-3 NAMES Command A-4 START Command A-4

Contents

SNMP Configuration and Management Manual—424777-006

xvi

A. SCF Command Syntax Summary for the

NonStop Agent (continued)

A. SCF Command Syntax Summary for the NonStop

Agent (continued)

ST ATUS Command A-5 STOP Command A-5 TRACE Command A-6 VERSION Comm and A-6

B. SCF Error Messages for the NonStop Agent

Types of SCF Error Messages B-1

Command Parsing Error Messages B-1

SCF-Generated Numbered Error Messages B-1

Common Error Messages B-1

Subsystem-Specific Error Messages B-1 Common Versus Subsystem-Specific Errors B-2 SCF Error Messag es Help B-3 If You Have to Call HP B-3 NonStop Agent Error Messages B-4

SNMP Error 00001 B-4

SNMP Error 00002 B-4

SNMP Error 00004 B-4

SNMP Error 00005 B-5

SNMP Error 00006 B-5

SNMP Error 00007 B-6

SNMP Error 00009 B-6

C. Unsolicited SNMP Agent Messages

Traps C-1 Events

C-2

001: ZSMP-EVT-INVALID-CAID C-3 002: ZSMP-EVT-INTERNAL-ERROR C-3 003: ZSMP-EVT-STATE-CHANGE C-4 004: ZSMP-EVT-OSS-E RROR C-5 005: ZSMP-EVT-SOCKET-ERROR C-7 006: ZSMP-EVT-CONFIG-ERROR C-8 009: ZSMP-EVT-BAD-IPC-PDU-RCVD C-9 010: ZSMP-EVT-BAD-NMS-PDU-RCVD C-10 012: ZSMP-EVT -NO-SUCH-TRAPDEST C-10 013: ZSMP-EVT-INVALID-PDU-ON-SVC-P T C-11 014: ZSMP-EVT-GUARDIAN-ERROR C-11

Contents

SNMP Configuration and Management Manual—424777-006

xvii

Glossary

Glossary Index

Examples

Example 9-1. ASN.1 Source Code for EMS Trap MIB 9-5 Example 9-2. Example Routing Distributor Filter 9-8 Example 9-3. Example TACL Macro for Starting EMS Trap Subagent 9-11 Example 10-1. ASN.1 Source Code for EMS Trap MIB 10-6 Example 10-2. Initial Contents of GENTRAP 10-10 Example 12-1. Sample Application Filter Source Code 12-49 Example 12-2. Sample Application Output 12-51 Example 12-3. Sample Application Source Code 12-56

Figures

Figure 1-1. Default SNMP Agent/Manager Interaction Over TCP/IP 1-2 Figure 1-2. Key Components in the SNMP Environment 1-4 Figure 1-3. Format of SNMP Messages 1-7 Figure 1-4. Nodes in the SNMP Object Tree 1-11 Figure 1-5. NonStop SNMP Architecture 1-16 Figure 2-1. Default SNMP Agent/Manager Interaction Over TCP/IP 2-5 Figure 2-2. Running Multiple SNMP Agents on a Single Node 2-19 Figure 2-3. Running SNMP Agents on Multiple Nodes 2-21 Figure 2-4. Managing Overlapping Sets of Resources 2-22 Figure 2-5. Authenticating Requests Received Through TCP/IP 2-30 Figure 2-6. Multiple Local SNMP Agents, Single Host Request/Response

Connections 2-36

Figure 2-7.

Multiple Remote SNMP Agents, Single Host Request/Response

Connections 2-38 Figure 2-8. Multiple SNMP Agents, Single Host Connections 2-42 Figure 2-9. Multiple SNMP Agents, Multiple Host Connections 2-44 Figure 4-1. Overview of SCF 4-2 Figure 4-2. 4-4 Figure 4-3. The PROCESS Object 4-5 Figure 4-4. PROCESS Object State Transition Sequence 4-7 Figure 4-5. The ENDPOINT Ob ject 4-8 Figure 4-6. ENDPOINT Object State Transition Sequence 4-11 Figure 4-7. The PROFILE Object 4-13 Figure 4-8. PROFILE Object State Transition Sequence 4-15 Figure 4-9. The TRAPDEST Object 4-16

Contents

SNMP Configuration and Management Manual—424777-006

xviii

Figures (continued)

Figure 4-10. TRAPDEST Object State Transition Sequence 4-20 Figure 6-1. Recording and Displaying Trace Data 6-2 Figure 8-1. Architectural Overview of the TCP/IP Subagent 8-2 Figure 8-2. TCP/IP Subagent Scenarios 8-3 Figure 8-3. TCP/IP Subagent Resource Object States 8-29 Figure 9-1. EMS Components 9-2 Figure 9-2. EMS Trap Subagent Components 9-3 Figure 10-1. EMS and NonStop NET/MASTER Components 10-2 Figure 10-2. NonStop NET/MASTER Trap Subagent Components 10-4 Figure 11-1. Derivation of Information for RFC 1514 Support 11-2 Figure 11-2. Derivation of Information for RFC 1514 Extensions 11-4 Figure 11-3. Relationship Between hrStorageTable and hrFSTable 11-29 Figure 11-4. Relationship Among Tables in hrDevice, hrStorage, and Interfaces

Groups 11-38 Figure 11-5. Relationship Between hrSWRunTable and hrSWRunPerfTable 11-53 Figure 11-6. Relationship Between Threshold Values and Trap Generation 11-101 Figure 12-1. Trap Multiplexer Functions and Components 12-2 Figure 12-2. Mapping of Trap Header Variables to EMS Event Tokens 12-22 Figure 12-3. Sample Application Interactions 12-48 Figure 12-4. Sample Application Control Flow 12-52 Figure 13-1. NonStop IPX/SPX Interactions 13-2 Figure 13-2. IPX/SPX Subagent Interactions 13-3 Figure 13-3. Indexes Linking MIB Table Entries 13-5 Figure 13-4. Derivation of tdmNwServerTable Index Values 13-34 Figure 14-1. Architectural Overview of the Ethernet Subagent 14-2 Figure 14-2. Ethernet Subagent Resource Object States 14-18

Tables

Table 1-1. System Group Objects Supported by SNMP Agent's MIB 1- 13 Table 1-2. Compliance With IP Group Definitions in RFC 1213 1-17 Table 2-1. Initial Values of Objects in the SNMP Agent's MIB 2-6 Table 2-2. Summary of Startup Parameters 2-13 Table 2-3. Security Scenarios 2-32 Table 3-1. System Group Objects Supported by SNMP Agent 3-4 Table 3-2. SNMP Group Objects Supported by SNMP Agent 3-7 Table 3-3. zagInternal Group Objects Supported by SNMP Agent 3-12 Table 3-4. Access Status of SNMP Agent’s Private MIB Objects 3-20 Table 3-5. SCF and SNMP Manager Access to Table Row Objects 3-23

Contents

SNMP Configuration and Management Manual—424777-006

xix

Tables (continued)

Table 3-6. RowStatus Value Definitions 3-24 Table 3-7. RowStatus Values and Table Management Operations 3-26 Table 3-8. ENDPOINT and TRAPDEST Default Values 3-29 Table 3-9. RowStatus Values With Defined and Undefined Row Objects 3-29 Table 3-10. Initial Values of Objects in the SNMP Agent's MIB 3-32 Table 3-11. SNMP Agent Private MIB Objects That Describe the SNMP Operations

Environment 3-32 Table 4-1. States Reported by NonStop Agent Objects 4-4 Table 4-2. ENDPOINT Object States 4-10 Table 4-3. PROFILE Object States 4-14 Table 4-4. TRAPDEST Object States 4-18 Table 5-1. Summary of SCF Commands Supported for NonStop Agent

Objects 5-1 Table 6-1. Summary of NonStop SNMP Agent PTrace Commands 6-5 Table 6-2. Keywords for NonStop SNMP Agent PTrace SELECT Command 6-1 1 Table 7-1. Handling Requests That Cannot Be Processed 7-6 Table 8-1. Querying a TCP/IP Subagent Through SNMP 8-16 Table 8-2. Controlling a TCP/IP Subagent Through SNMP 8-18 Table 8-3. Private (ZTSA) MIB Objects Supported by the TCP/IP Subagent 8-21 Table 8-4. TCP/IP Subagent State Object/Resource Object Pairs 8-28 Table 8-5. Interfaces Group Objects Supported by TCP/IP Subagent 8-31 Table 8-6. Compliance With Interfaces Group Definitions in RFC 1213 8-38 Table 8-7. IP Group Objects Supported by TCP/IP Subagent 8-41 Table 8-8. Compliance With IP Group Definitions in RFC 1213 8-48 Table 8-9. ICMP Group Objects Supported by TCP/IP Subagent 8-52 Table 8-10. Compliance With ICMP Group Definitions in RFC 1213 8-55 Table 8-11.

TCP Group Objects Supported by TCP/IP Subagent 8-57 Table 8-12.

Compliance With TCP Group Definitions in RFC 1213 8-60 Table 8-13. UDP Group Objects Supported by TCP/IP Subagent 8-62 Table 8-14. Compliance With UDP Group Definitions in RFC 1213 8-63 Table 8-15. Traps Generated by TCP/IP Subagent 8-64 Table 8-16. TCP/IP Subagent Event Messages 8-65 Table 8-17. ZTSA Tokens in ZTSA Event Messages 8-68 Table 8-18.

ZEMS Tokens in ZTSA Event Messages 8-69 Table 9-1.

Objects in the EMS Trap MIB 9-13 Table 10-1. Objects in the EMS Trap MIB 10-15 Table 10-2. openagent Return Codes and GENTRAP Actions 10-18 Table 10-3. sendtrap Return Codes and GENTRAP Actions 10-19

Contents

SNMP Configuration and Management Manual—424777-006

Tables (continued)

Table 10-4. closeagent Return Codes and GENTRAP Actions 10-20 Table 11-1. Host Resources Subagent Configuration Options 11-10 Table 1 1-2. hrSystem Group Objects Supported by Host Resources Subagent's

MIB 11-26 Table 1 1-3. Compliance With hrSystem Group Definitions in RFC 1514 11-28 Table 1 1-4. hrStorage Group Objects Supported by Host Resources Subagent's

MIB 11-30 Table 1 1-5. Compliance With hrStorage Group Definitions in RFC 1514 11-34 Table 1 1-6. hrDevice Group Objects Supported by Host Resources Subagent’s

MIB 11-39 Table 1 1-7. Compliance With hrDevice Group Definitions in RFC 1514 11-49 Table 1 1-8. hrSWRun Group Objects Supported by Host Resources Subagent's

MIB 11-54 Table 1 1-9. Compliance With hrSWRun Group Definitions in RFC 1514 11-58 Table 11-10. hrSWRunPerf Group Objects Supported by Host Resources Subagent's

MIB 11-60 Table 11-11. Compliance With hrSWRunPerf Group Definitions in RFC 1514 11-61 Table 11-12. zhr mTableInfo Group Ob jects Supp orte d by H ost Resour ces Subage nt's

MIB 11-64 Table 11-13. zhrmThreshold Group Objects Supported by Host Resources

Subagent's MIB 11-78 Table 11-14. zhrmDevUnavail Group Objects Supported by Host Resources

Subagent's MIB 11-86 Table 11-15. zhrmSaProcess Group Objects Supported by Host Resources

Subagent's MIB 11-92 Table 11-16. zhrmRefresh Group Objects Supported by Host Resources Subagent's

MIB 11-97 Table 11-17.

Variable Bindings in the zhrmTrapDeviceStateChange Trap 11-102 Table 11-18. Variable Bindings in the zhrmRAMThreshold Trap 11-103 Table 11-19. Variable Bindings in the zhrmDiskThreshold Trap 11-104 Table 1 1-20. Host Resources Subagent Event Messages 11-104 Table 1 1-21. ZHRM Tokens in ZHRM Event Messages 11-106 Table 1 1-22. ZSPI Tokens in ZHRM Event Messages 11-106 Table 1 1-23. ZEMS Tokens in ZHRM Event Messages 11-106 Table 12-1. Trap Multiplexer Configuration Options 12-5 Table 12-2. ztmxPDUStatistics Group Objects Supported by Trap Multiplexer’s

MIB 12-13 Table 12-3. ztmxProcess Group Objects Supported by Trap Multiplexer’s

MIB 12-17 Table 12-4. Trap Multiplexer Trap Event Messages 12-21

Contents

SNMP Configuration and Management Manual—424777-006

xxi

Tables (continued)

Table 12-5. Trap Event Token Summary 12-23 Table 12-6. Trap Multiplexer Process Event Messages 12-25 Table 12-7. ZTMX Tokens in ZTMX Event Messages 12-26 Table 12-8. ZSPI Tokens in ZTMX Event Messages 12-27 Table 12-9. ZEMS Tokens in ZTMX Event Messages 12-28 Table 13-1. IPX/SPX Subagent Configuration Summary 13-12 Table 13-2. ipxBasicSysEntry Objects Supported by the Subagent 13-19 Table 13-3. Compliance With Novell ipxBasicSys Group Definitions 13-21 Table 13-4. tdmNwInfoEntry Objects Supported by the Subagent 13-24 Table 13-5. tdmNwIPXEntry Objects Supported by the Subagent 13-27 Table 13-6. tdmNwSPXEntry Objects Supported by the Subagent 13-29 Table 13-7. tdmNwNCPEntry Objects Supported by the Subagent 13-32 Table 13-8. tdmNwServerEntry Objects Supported by the Subagent 13-35 Table 13-9. tdmNwSaConfig Objects Supported by the Subagent 13-39 Table 13-10. tdmNwSaAgentNamesEntry Objects Supported by the

Subagent 13-42 Table 13-11. tdmNwSaIPXPROTONamesEntry Objects Supported by the

Subagent 13-43 Table 13-12. IPX/SPX Subagent Event Messages 13-45 Table 13-13. ZISA Tokens in ZISA Event Messages 13-46 Table 13-14. ZSPI Tokens in ZISA Event Messages 13-47 Table 13-15. ZEMS Tokens in ZISA Event Messages 13-47 Table 14-1. Querying an Ethernet Subagent Through SNMP 14-9 Table 14-2. Controlling an Ethernet Subagent Through SNMP 14-10 Table 14-3. Private (ZESA) MIB Objects Supported by the Ethernet

Subagent 14-12 Table 14-4.

Ethernet Subagent State Object/Resource Object Pairs 14-17 Table 14-5.

dot3StatsTable Objects Supported by Ethernet Subagent 14-20 Table 14-6. Compliance With dot3 Group Definitions in RFC 1643 14-27 Table 14-7. Traps Generated by Ethernet Subagent 14-29 Table 14-8. Ethernet Subagent Event Messages 14-30 Table 14-9. ZESA Tokens in ZESA Event Messages 14-32 Table 14-10. ZEMS Tokens in ZESA Event Messages 14-33 Table C-1. Traps Generated by SNMP Agent C-1 Table C-2. SNMP Agent Event Messages C-2 Table C-3. Encoding and Decoding Errors Returned by an Open Systems

Solutions, Inc., ASN.1 Function C-6

Contents

SNMP Configuration and Management Manual—424777-006

xxii

Tables (continued)

SNMP Configuration and Management Manual—424777-006

xxiii

What’s New in This Manual

Manua l In forma tion

SNMP Configuration and Mana gement Manual

Abstract

This manual describes how to install, start, configure, and stop the HP Simple Network Management Protocol (SNMP) Agent and subagents. The SCF commands used by SNMP are described. This manual also discusses the objects in the Management Information Bases (MIBs) used by the agent and subagents. The SNMP Agent and its subagents compl y with SNMP Request s for Comment (R FCs) so tha t SNMP-co mpli ant management applications, known as SNMP managers, can manage various resources on an HP NonStop™ host.

Product Version

SNMP Agent (T9576G06), T9576H01)

Supported Release Version Updates (RVUs)

This manual supports the G06.24 RVU and all subsequent G-series RVUs and the H06.03 RVU and all subsequent H-series RVUs until otherwise indicated by its replacement publication.

Document History

Part Numb er Published

424777- 006 J uly 2005

Part Number Product Version Published

Subagent Product Versions IPX/SPX Sub agent (T8170D30)

SNMP Configuration and Management Manual—424777-006

xxiv

New and Changed Information

This revision contains these changes and additions:

Section Change

Section 1, The NonStop SNMP En v ironmentt

Notes concerning H-Series support have been included.

Section 2, Installin g and Configuring the SNMP Agent

Notes concerning H-Series support have been included.

Section 4, Introduction to SCF for the SN M P Agent

H-series informatio n has been a dded.

Section 7, Troubleshooting the SNMP Agent

H-series informatio n has been a dded.

Section 8, TCP/IP Subagent

H-series informatio n has been a dded.

Section 10.ONS Trap Subagent (D-series)

This section has been deleted.

Section 11.NonStop NET/MASTER Trap Subagent

Has become section Section 10, Non Stop N ET / M ASTER Trap

Subagent.

Section 12. Host Resources Subagent

Has become Section 11, Host Resources Subagent.

Section 1 3. Trap Multiplexer Subagent/Manager

Has become section Section 12, Trap Multiplexer

Subagent/Manager.

Section 14.

IPX/SPX

Subagent

Has become section 13 with the title Section 13, IPX/SPX

Subagent (G-Series).

Section 1 5. Et hernet Subagent

Has become Section 14, Ethernet Subagent

SNMP Configuration and Management Manual—424777-006

xxv

About This Manual

The SNMP agent and subagents let custom ers manage HP NonStop systems by using SNMP managers. SNMP managers are SNMP-compliant applications that manage multiplatform networks.

This manual describes how to install, configure, and interpret information generated by the SNMP agent and its subagents. It also defines SCF commands for SNMP.

Your Comments Invited

After using this manual, please take a moment to send us your comments. You can do this by:

•

Completing the online Contact NonStop Publications form if you have Internet access.

•

Faxing or mailing the form, which is included as a separate file in Total Information Manager (TIM) collections and located at the back of printed manuals. Our fax number and mailing address are included on the form.

•

Sending an e-mail message to the address included on the form. We will immediately acknowledge receipt of your message and send you a detailed response as soon as possible. Be sure to include your name, company name, address, and phone number in your message. If your comments are specific to a particular manual, also include the part number and title of the manual.

Many of the improvements you see in manuals are a result of suggestions from our customers. Please take this opportunity to help us improve future manuals.

Audience

This manual has two audiences: NonStop system personnel and users of the SNMP manager.

•

NonStop system personnel include system managers, network managers, and operators who handle such host-based operations as SNMP agent and subagent installation, configuration, and troubleshooting. These personnel need a working familiarity with the HP NonStop Kernel operating system as well as such subsystems as TCP/IP, Subsystem Control Facility (SCF), and Event Management Service (EMS). These personnel are acquainted with basic SNMP principles.

•

Users of the SNMP manager configure and use SNMP managers to send requests to and receive responses from the SNMP agent and subagents. Users of the SNMP manager also monitor traps forwarded by the SNMP agent. These users are familiar with their management applications and with the platforms those applications run on. SNMP manager users know the format of requests and responses exchanged with SNMP agents on systems provided by different vendors.

About This Manual

SNMP Configuration and Management Manual—424777-006

xxvi

Purpose

For NonStop system personnel, this manual describes how to install and configure the SNMP agent and its subagents. It also documents the messages generated and explains how the SNMP agent and subagents fit into the overall NonStop subsystem architecture.

For users of the SNMP manager, this manual describes the MIBs supported in the NonStop SNMP environment. In addition, it documents how the SNMP agent and subagents comply with guidelines in RFCs and describes the traps generated.

Organization

This manual has five parts. Part I, Installing and Configuring SNMP, is an overview of SNMP and tells how to configure, start, stop, and manage an SNMP agent. .Part II,

SCF for the SNMP Agent, tells how to manage SNMP using the Subsystem Control

Facility (SCF). Part III, Troubleshooting describes diagnostics. P art IV, SNMP

Subagents describes the SNMP subagents. Part V, Appendices, provides reference

information. Following is a brief description of each section:

Part I, Installing and Configuring SNMP

•

Section 1, The NonStop SNMP Environment, provides a high-level view of SNMP

and how it is implemented in the NonStop environment.

•

Section 2, Installing and Configuring the SNMP Agent, describes how to configure

the SNMP agent using SCF, the RUN command, PARAM statements, and the SNMPCTL file. This section describes how to configure security, response/request connection, and trap- connection agent elements.

•

Section 3, MIBs Supported by the SNMP Agent, describes the traps and EMS

event messages that the SNMP agent generates.

Part II, SCF fo r the SNM P A gen t

•

Section 4, Introduction to SCF for the SNMP Agent, provides an overview of the

subsystem control facility (SCF) and how it can be used to manage SNMP.

•

Section 5, SCF Commands for the SNMP Agent, describes how the components

of a NonStop agent configuration are organized and managed through the SCF interface

Part III, Troubleshooting

•

Section 6, SNMP Agent PTrace Facility. describes the PTrace utility, which tracks

and maintains records of communications between processes.

•

Section 7, Troubleshooting the SNMP Agent, contains guidelines about what to do

when you encounter problems starting the SNMP agent.

About This Manual

SNMP Configuration and Management Manual—424777-006

xxvii

Organization

Part IV, SNMP Subagen ts

•

Section 8, TCP/IP Subagent, describes the subagent that facilitates management

of TCP/IP processes on SNMP systems.

•

Section 9, EMS Trap Subagent, describes the subagent that translates EMS

events into SNMP traps.

•

Section 11, Host Resources Subagent, describes the subagent that translates

Event Management Service (EMS) events routed to NonStop NET/MASTER MS into SNMP traps whose objects are defined in the EMS Trap MIB.

•

Section 12, Trap Multiplexer Subagent/Manager describes the subagent that

supports the management of hardware and software resources on the NonStop system where the subagent is installed.

•

Section 13, IPX/SPX Subagent (G-Series), describes the product that, as a

manager, receives traps from network devices and converts them into EMS events and, as a subagent, pr ovides m anag er st ation access to an MIB that de scribes tr ap conversion activities and configuration attributes.

•

Section 14, Ethernet Subagent, describes the Internetwork Packet

Exchange/Sequenced Packet Exchange (IPX/SPX) Subagent, which lets you monitor and manage NonStop IPX/SPX networks.

Part V, Appendices

•

Appendix A, SCF Command Syntax Summary for the NonStop Agent, lists the

syntax for the SCF commands supported by the NonStop agent.

•

Appendix B, SCF Error Messages for the NonStop Agent, describes the SCF error

messages specific to the NonStop SNMP agent.

•

Appendix C, Unsolicited SNMP Agent Messages, describes the EMS event

messages generated by the SNMP agent.

A Glossary

provides definitions of SNMP terms and acronyms.

About This Manual

SNMP Configuration and Management Manual—424777-006

xxviii

HP T9576G06, T9576H01 Management Manual

Specifications and Main Features

Frequently Asked Questions

User Manual