Contents

Preface
Part I Overview

1. Introducing Solstice Enterprise Manager

1.1 What is Solstice EM?

1.1.1 What Can You Manage With Solstice EM?
1.1.2 Who Uses Solstice EM?

1.2 Solstice EM Features
1.3 Solstice EM Components

1.3.1 Solstice EM Architecture
1.3.2 Solstice EM Network Management Tools

1.4 Basic Solstice EM Concepts

1.4.1 Network Management Software
1.4.2 Agents and Stations
1.4.3 Management Information Servers

1.4.3.1 More About MIS Databases
1.4.3.2 More About the MIS Nerve Center
1.4.3.3 More About PMI and MPAs
1.4.3.4 MIS Ancillary Services
1.4.3.5 More About MIS Data Access
1.4.3.6 More About Object Orientation

1.4.4 Network Management Protocols

1.4.4.1 More About RPC
1.4.4.2 About MIBs

1.5 Solstice EM APIs

1.5.1 API Modules
1.5.2 Application Development Support Tools

1.6 Related Reading
1.7 Solstice EM Tools--Complete Listings

2. Network Management and the Solstice EM Architecture

2.1 The Agent/Manager Model
2.2 Client/Server Architecture
2.3 Distributed Management
2.4 Network Management Protocol Support

2.4.1 RPC Support

2.5 Simple Requests

2.5.1 SNMP Support
2.5.2 CMIP Support

2.5.2.1 Telecommunications Management Network

2.5.3 Other Network Management Protocols
2.5.4 Java Dynamic Management Kit Agents

2.6 Object Classes and Event Notification Types
Part II Customizing Solstice EM Tools

3. Using Solstice EM for Fault Management

3.1 Fault Management Summary

3.1.1 Before Starting Fault Management

3.2 Using Fault Management
3.3 Viewing Fault Status

3.3.1 Changing the Color Associated with a Severity
3.3.2 Alarm Severity Propagation
3.3.3 Access to Tools, Features, and Database Objects

3.4 Reporting Faults as Alarms
3.5 The Event Logs Tool and Alarm Logging

3.5.1 Receiving Network Information

3.5.1.1 Polling
3.5.1.2 Monitoring Device Availability

3.5.2 Event Notifications

3.5.2.1 Example: Monitoring Event Notifications from CMIP Agents

3.5.3 Using SNMP Traps

3.5.3.1 Monitoring SNMP Traps with Nerve Center Requests
3.5.3.2 Creating a Separate Log for Enterprise-Specific Trap Notifications
3.5.3.3 Forwarding Events from SunNet Manager Consoles

4. Using the Alarm Service

4.1 Network View Nodes
4.2 Alarm Management
4.3 The Alarm Service
4.4 Configuring the Alarm Service

4.4.1 Adding Logs to emAlarmLogList
4.4.2 Deleting Logs from the Event Logs Window
4.4.3 Turning Off the Alarm Service

4.5 Alarm Information Display in Solstice EM Tools

4.5.1 Alarm Information Display in Alarms Window
4.5.2 Alarm Information Display in Network Views

4.6 User-configurable Alarm Log Record Filter for Alarm Service

5. Using the Event Logs Tool

5.1 Log Process Overview

5.1.1 Attributes of a Log
5.1.2 Log Records Generated by Nerve Center Request Actions

5.2 Starting the Event Logs Tool
5.3 Using the Event Logs Tool

5.3.1 Accessing Logs on a Remote MIS
5.3.2 Importing Logs from a File into the Event Logs Tool
5.3.3 Configuring Display of Log Properties
5.3.4 Adding Tools to the Event Logs Menu

5.4 Defining the CMIS Filter

5.4.1 A CMIS Filter That Accepts Notifications of a Specific Type
5.4.2 CMIS Filter with Multiple ANDs
5.4.3 A CMIS Filter That Accepts All Notifications
5.4.4 A CMIS Filter That Accepts No Notifications

5.5 Sample CMIS Filters

5.5.1 Creation of an Object Instance
5.5.2 Deletion of an Object Instance
5.5.3 Attribute Value Change of an Object Instance
5.5.4 State Changes Received From Agent

5.6 Event Logs Tool Configuration File
Part III Network Management Protocol Support

6. Managing Devices Using RPC Agents

6.1 Types of RPC Agent Management
6.2 Preparing for Device Management with RPC Agents
6.3 RPC Management Protocol Adapter
6.4 RPC MPA Configuration Parameters

7. Using Cooperative Consoles with Solstice EM

7.1 Cooperative Console Forwarding
7.2 Filtering Criteria for Information Forwarding
7.3 Cooperative Consoles Configuration and Operation
7.4 Receiving SunNet Manager Alarms

8. SunNet Manager Application Support

8.1 Solstice EM Compatibility with SunNet Manager
8.2 Access to Solstice EM Features from SNM Applications
8.3 Adding an SNM Application to Solstice EM

8.3.1 Forwarding Event and Topology Information from SunNet Manager to Solstice EM
8.3.2 SunNet Manager Application Support

8.4 Information for Configuring Specific SNM Applications

8.4.1 Running Solstice EM and Applications on Hosts With a New IP Address or Name
8.4.2 Configuring Remedy's Action Request System (ARS) to Work with Solstice EM
8.4.3 Configuring Konfig 2.4 to Work with Solstice EM
8.4.4 Configuring Optivity 7.0 to Work with Solstice EM
8.4.5 Configuring Landmark's Performance Works to Work with Solstice EM

8.5 Importing an SNM Database into Solstice EM
8.6 Access to SNM Agents by SNM Applications
8.7 Access to SNM Agents by Solstice EM Applications

8.7.1 Configuration
8.7.2 Agent Support
8.7.3 Support for SNM Proxy Agents

9. SNMP Management

9.1 SNMP Managed Components
9.2 SNMP Management Protocol Adapter
9.3 SNMP MPA Configuration
9.4 Specifying the Version of SNMP Used

9.4.1 Calling the set_management_protocol Function of the EMSnmpAgent Class
9.4.2 Using the PMI to Set the managementProtocol Attribute

10. SunNet Manager SNMP Proxy Agents

10.1 Proxy Agents
10.2 SNMP Proxy Agent Operation
10.3 SNMP Trap Daemon (em_snmp-trap) Operation
10.4 Schema Files
10.5 SNMP Version 2 Support

10.5.1 SNMPv2 Enhancements

10.5.1.1 Structure of Management Information
10.5.1.2 Protocol Operations

10.5.2 SNMPv2 Files
10.5.3 Using the v2mib2schema Program

11. Mapping SNMP Traps to CMIP Event Notifications

11.1 SNMP Support
11.2 Trap Daemon Operation

11.2.1 Starting the Trap Daemon
11.2.2 Stopping the Trap Daemon

11.3 The Structure of SNMP Traps

11.3.1 SNMPv1
11.3.2 SNMPv2c

11.4 Default Trap Mapping

11.4.1 Default Method for Specifying the Source of an Alarm

11.4.1.1 SNMPv1
11.4.1.2 SNMPv2c

11.4.2 Default perceivedSeverity Values
11.4.3 Default probableCause Values
11.4.4 Default additionalText Information
11.4.5 Default Event Notification Type
11.4.6 Default Location of Information from Trap Variable Bindings

11.5 Trap Daemon Behavior When No Mapping is Provided
11.6 Format of trap_maps File

11.6.1 Enterprise Mapping Blocks

11.6.1.1 SNMPv1
11.6.1.2 SNMPv2c

11.6.2 Mapping Records

11.6.2.1 SNMPv1
11.6.2.2 SNMPv2c

11.6.3 <attr-value> Definitions

11.6.3.1 Constant
11.6.3.2 Trap Variable Binding Value
11.6.3.3 Trap Variable Binding Name
11.6.3.4 Trap Variable Binding Index
11.6.3.5 Embedding Strings in varbind Expressions
11.6.3.6 Defining and Using varbind-to-substring Tables

11.7 Customizing the Mapping of SNMP Traps

11.7.1 Overview
11.7.2 How to Customize SNMP Trap Mapping
11.7.3 Configuring CMIP notification managedObjectClass

11.7.3.1 The keyword $ALLVARS
11.7.3.2 The Keyword $NORFC2089

11.7.4 Attribute Type Mapping
11.7.5 Wild Cards for trap_mapping
11.7.6 Using FDN Templates to Specify the Source of a Trap

11.7.6.1 Understanding FDNs and RDNs
11.7.6.2 Building FDN Templates

11.8 Distributed Trap Handling

11.8.1 Filtering SNMP Traps for Other Managers

12. Configuring Communication With CMIP Agents

12.1 Tasks for Setting Up Your System to Manage CMIP Agents
12.2 Preparing the System for CMIP Configuration

12.2.1 Determining the Distribution Model
12.2.2 Installing the Required SunLink Products
12.2.3 Gathering Your Configuration Information

12.3 Compile and Load CMIP Agent Object Types into MIS
12.4 Starting and Configuring SunLink OSI
12.5 Access Control
12.6 Starting and Configuring SunLink CMIP 9.0
12.7 Starting and Configuring the CMIP MPA
12.8 Runtime Parameters

12.8.1 Auxiliary Server Container
12.8.2 CMIP MPA Object
12.8.3 em_cmip Parameters
12.8.4 Sample Program to Retrieve Runtime Parameters

12.9 Configuring Multiple MPAs on One System

13. Configuring CMIP MPA Overload

13.1 Understanding CMIP MPA Overload
13.2 Configuration Parameters

13.2.1 Overload Control Parameter
13.2.2 Overload Notification Parameter
13.2.3 Overload Threshold Parameter
13.2.4 Minimum Threshold Parameter
13.2.5 Overload Instruction Parameter
13.2.6 Poll Interval Parameter

13.3 Management Information Tree of Overload Control Objects
13.4 GDMO Classes

13.4.1 Mapping Between Attributes of the GDMO Classes and Configuration Parameters
13.4.2 emOverloadControlContainer Class
13.4.3 emOverloadController Class
13.4.4 mpaOverloadController Class
13.4.5 Overload Sample Programs

13.4.5.1 get_agent_admin_state
13.4.5.2 overload_action
13.4.5.3 overload_alarm
13.4.5.4 overload_get
13.4.5.5 overload_set
13.4.5.6 set_agent_admin_state

Part IV Nerve Center

14. Nerve Center Overview

14.1 Nerve Center Components
14.2 Nerve Center Documentation
14.3 Nerve Center Operation

14.3.1 How a Request Gets Information

14.3.1.1 Where and When a Request's Notifications Arise
14.3.1.2 When Information From Managed Objects can Arrive

14.3.2 Variables and Attributes in a Request

14.3.2.1 Attributes
14.3.2.2 System Variables
14.3.2.3 User Variables
14.3.2.4 How Notifications and Poll Responses are Delivered

14.3.3 Where and When a Condition is Evaluated
14.3.4 Action at a Transition

14.3.4.1 Supported Actions
14.3.4.2 Logging an Event
14.3.4.3 Forwarding an SNMP Trap

14.3.5 Specifying the Objects to be Polled
14.3.6 Alarm Logging and the Alarm Service

15. Requesting Data in Solstice EM

15.1 Polling for Data in Solstice EM

15.1.1 Direct Polling
15.1.2 Indirect Polling
15.1.3 Event Request Polling

15.2 Subscribing for Events

15.2.1 Combining Polling and Event-Subscription

15.3 Using Solstice EM Tools for Polling
15.4 Working with Basic Requests

15.4.1 Viewing Basic Request Information
15.4.2 Creating, Modifying, and Initiating Basic Requests

15.5 Working with Advanced Requests

15.5.1 Creating, Modifying, and Initiating Advanced Requests

15.6 Building Blocks: States, Transitions, and Conditions

15.6.1 State Machine Diagrams
15.6.2 Sample Request Template

15.6.2.1 Setting the Target Managed Object
15.6.2.2 Polling for an SNMP Attribute

15.6.3 Controlling Fault Status Color

15.6.3.1 Using alarmOi() to Clear Previous Alarms
15.6.3.2 Alarm-logging Tips

15.7 Designing Request Templates
15.8 Requests Based on Polling

15.8.1 Adding States
15.8.2 Adding Conditions
15.8.3 Adding Transitions

15.9 Polling RPC Agents

15.9.1 Targeting the RPC ping-reach Group
15.9.2 Correlating Information from Multiple Polls

15.10 Requests Based on Event Subscription

15.10.1 Event Logging and Alarm Service Monitoring of Alarm Logs
15.10.2 Mapping of SNMP Traps to CMIP Event Notifications

15.11 Subscribing for Enterprise-Specific SNMP Traps

15.11.1 Initiating the Event Subscription
15.11.2 Listening for Incoming Events

15.12 Requests that Combine Subscription and Polling

15.12.1 Checking for a Correct Target

15.13 Building Request Definitions

16. Debugging Request Templates

16.1 Nerve Center Debugging Agents
16.2 Activating RCL Print Statements
16.3 Turning Off Debug Agents

17. Building Templates for SunNet Manager Event Requests

17.1 RPC Agents
17.2 Nerve Center's SNM Event Request Capability
17.3 SNM Alarms
17.4 Building SNM Event Request Templates

17.4.1 Subscribing for SNM Events
17.4.2 Sending an SNM ping Event Request
17.4.3 Waiting for a Response to the Event Request

18. Building Advanced Requests

18.1 Components of Request Templates

18.1.1 State Machine Diagrams

18.2 Using the Design Advanced Requests Tool to Build Nerve Center Templates

18.2.1 Starting Request Designer
18.2.2 Creating a New Nerve Center Template
18.2.3 Modifying an Existing Nerve Center Template
18.2.4 Deleting Nerve Center Templates
18.2.5 Exporting Nerve Center Templates to an ASCII File
18.2.6 Importing Nerve Center Templates from an ASCII File

18.3 Conditions
18.4 States

18.4.1 Adding States to a Nerve Center Template
18.4.2 Modifying States in a Nerve Center Template

18.5 Transitions

18.5.1 Creating New State-to-State Transitions in a Template
18.5.2 Deleting Transitions from a Template
18.5.3 Reordering Transitions

18.6 Actions

18.6.1 Adding Actions at a Transition
18.6.2 Deleting Actions at a Transition
18.6.3 Reordering the Actions at a Transition

18.7 Poll Rates

18.7.1 Creating New Poll Rates
18.7.2 Modifying a Poll Rate

18.8 Modifying the Mapping of Colors to Severities
18.9 Graphical State Diagram Display

18.9.1 Creating a Template Through the State Diagram Display
18.9.2 Other Tasks in the Graphical Display

19. Nerve Center Utilities

19.1 em_ncimport and em_ncexport

19.1.1 Options
19.1.2 Examples

20. Request Condition Language

20.1 Conditions
20.2 Types of Operands
20.3 Constants
20.4 Variables in a Condition

20.4.1 Variable Names
20.4.2 Scope of Variables

20.5 Data Types
20.6 System Variables
20.7 Attributes

20.7.1 Syntax of Attribute Names

20.8 Operators

20.8.1 Logical Operators
20.8.2 Bitwise Operators
20.8.3 Precedence and Associativity

20.9 Control Structures

20.9.1 IF Constructs
20.9.2 IF ELSE Constructs
20.9.3 WHILE Constructs
20.9.4 FOREACH Constructs
20.9.5 Nested Constructs

20.10 Timestamp Arithmetic
20.11 Error Checking

21. Using RCL System Variables

21.1 System Variables

21.1.1 $eventInfo
21.1.2 $eventOI
21.1.3 $eventTime
21.1.4 $eventType
21.1.5 $messType
21.1.6 $pollfdn
21.1.7 $pollFdnSet

22. RCL Functions

22.1 Summary of RCL Built-in Functions

22.1.1 AlarmLog Functions
22.1.2 String-Handling Functions
22.1.3 Value Check Functions
22.1.4 Name Conversion Functions
22.1.5 Action Functions
22.1.6 ASN.1 Conversion Functions
22.1.7 SunNet Manager RPC Request Functions
22.1.8 Debugging Function
22.1.9 Constructed-Type Handling Functions
22.1.10 Time Functions
22.1.11 Event-Handling Functions
22.1.12 Request Control Functions

22.2 The RCL Functions

22.2.1 AddressStrToAddress
22.2.2 Alarm

22.2.2.1 Alarm Logging and Viewer Fault Status

22.2.3 AlarmOi
22.2.4 AlarmStr
22.2.5 AnyStr
22.2.6 AppendRdn
22.2.7 AsnToStr
22.2.8 CompareLists
22.2.9 Defined
22.2.10 Exit
22.2.11 Exclude
22.2.12 Extract
22.2.13 FinalStr
22.2.14 FirstStr
22.2.15 GetTimeStamp
22.2.16 Include
22.2.17 InitialStr
22.2.18 IsChoice
22.2.19 IsList
22.2.20 IsMember
22.2.21 Mail
22.2.22 NameToAddress
22.2.23 NameToOid
22.2.24 NumElements
22.2.25 OiNameToOi
22.2.26 OiToOiName
22.2.27 Print
22.2.28 ReplaceMember
22.2.29 SendAction
22.2.30 SendEvent
22.2.31 SendTrap
22.2.32 Set
22.2.33 SnmEventRequest
22.2.34 SnmKillRequest
22.2.35 StrToAsn
22.2.36 StrCat
22.2.37 Strstr
22.2.38 StrStrPlus
22.2.39 Subscribe
22.2.40 SubscribeFilter

22.2.40.1 Considerations
22.2.40.2 Examples

22.2.41 SubscribeOi
22.2.42 TrapGenericType
22.2.43 TrapSpecificType
22.2.44 Undefine
22.2.45 Unixcmd
22.2.46 UnSubscribe

Sun Microsystems, Inc.
Copyright information. All rights reserved.

Doc Set | Next | Index