User Guide for Cisco Digital Media Manager 5.4.x

Bias-Free Language

The documentation set for this product strives to use bias-free language. For the purposes of this documentation set, bias-free is defined as language that does not imply discrimination based on age, disability, gender, racial identity, ethnic identity, sexual orientation, socioeconomic status, and intersectionality. Exceptions may be present in the documentation due to language that is hardcoded in the user interfaces of the product software, language used based on RFP documentation, or language that is used by a referenced third-party product. Learn more about how Cisco is using Inclusive Language.

Book Contents
Find Matches in This Book
Available Languages
Download Options

Book Title

User Guide for Cisco Digital Media Manager 5.4.x

Chapter Title

10. SNMP, Events, and Notifications

Results

Updated:
September 17, 2012

Chapter: 10. SNMP, Events, and Notifications

SNMP, Events, and Notifications

Revised: May 4, 2015
OL-15762-05

 

 

Audience
 

We prepared this material with specific expectations of you.

You monitor system events for components of Cisco DMS..

Concepts

Overview

DMS-Admin supports email (SMTP) natively.

In addition, you can purchase and install a license key to activate our SNMP Notifications Module. After you activate this module, you can start to use:

  • A network management MIB file called CISCO-DIGITAL-MEDIA-SYSTEMS-MIB.my.
  • The agent capabilities file that describes which MIB objects we support in this release.

In this framework, you can define alarms that associate system events with methods to deliver notification messages.

Timesaver The Alerts gauge at Administration > Dashboard shows the total count of notification messages delivered in the past 1 hour. Click View Alerts to jump directly to the Alerts page.

Restrictions

  • SNMP features in this release are read-only.

– Your NMS can use SNMP to submit queries to DMS-Admin but cannot use SNMP to edit the configuration of any Cisco DMS component.

– You cannot edit the (default) community string of your DMM appliance.

  • SNMPv1 and SNMPv2c are not secure protocols. You cannot use a firewall to secure SNMP traffic.
  • In this release, the SNMP Notification Module does not support the SNMPv3 protocol.

Understand SNMP Concepts

Your fully licensed and equipped DMS-Admin software can use SNMPv1 or SNMPv2c to:

  • Respond to Cisco DMS MIB schema-compliant queries from your NMS.
  • Send notification messages automatically to your NMS whenever predefined system event types occur.

Understand MIB and NMS Concepts

Any dedicated NMS that supports SNMP can load CISCO-DIGITAL-MEDIA-SYSTEMS-MIB.my into its MIB browser. CiscoWorks is one example. Your NMS can then send SNMP queries to DMS-Admin and represent its responses correctly to monitor objects from our MIB schema.

  • Cisco DMS server appliances.
  • Cisco DMPs — in the sense that, when your DMPs report their events to your DMM appliance, it forwards the appropriate SNMP alerts.
  • Cisco Digital Media Manager software.

 

Our MIB schema models three object groups.

Object Group
Description

DMS Systems Group

Models all distributed component parts of this Cisco DMS installation as a single, abstract system.

DMS Features Group

Categorizes licensed and unlicensed features.

DMS Inventory Group

Lists the devices that constitute your Cisco DMS installation and describes their operational status.

Understand IP Address Conflict Events

An address conflict occurs when a DHCP server assigns to one registered DMP the exact dynamic IP address that some other registered DMP used previously.

  • When the DMP that previously used the address is no longer in active use, you should delete the record of it in Digital Signs.
  • When the DMP that previously used the address is one that should remain active, confirm that it is still running and still connected to the network. Then, restart it and confirm that its DHCP server does not assign IP addresses with expiration dates.

Understand Supported Event Types

Global Event Categories

Categories
Notification Messages

All Internal Events

List all signals exchanged between and among the internal components of Cisco DMS. Most users attribute little or no significance to these events.

All Notifiable Events

List all.

Deployment Failures

Messages list recently failed deployments of content for all components of Cisco DMS.

Deployment Successes

Messages list recently failed deployments of content for all components of Cisco DMS.

DMP Event Categories

Categories
Notification Messages

Outages

List all registered but unreachable DMPs.

Restarts

List all registered DMPs that restarted recently.

IP Conflicts

List all registered DMPs with IP address conflicts.

IP Registrations

List all newly registered DMPs.

Failover Cluster Event Categories

Categories
Notification Messages

Cluster Node Outages

List instances when either node in any failover pair is not responsive.

Cluster Node Activations

List instances when either node in any failover pair becomes responsive.

WAAS Event Categories

Categories
Notification Messages

WAAS Connections

Lists instances when DMM established a connection to a WAAS share.

WAAS Disconnections

Lists instances when DMM lost its connection to a WAAS share.

WAAS Low Disk Space

Lists instances when the WAAS share was low on disk space.

Understand Notification Methods

Email

Activates automatic delivery of email notification messages for all corresponding event types.

SNMP

Activates automatic delivery of SNMPv2c notification messages to your NMS for all corresponding event types.

Syslog

Activates automatic delivery of notification messages to your Syslog collector.

All

All of the above.

Workflow

1. Configure SNMP Server Settings for Your DMM Appliance

2. Populate the MIB Browser in Your NMS

Procedures

Enable or Disable Email

You can enable or disable the email service (SMTP) on your DMM appliance. When this service is enabled, DMS-Admin can send email notifications automatically to you or other interested parties whenever system events of predefined types occur.

Before You Begin

  • Log in to DMM.

Procedure

Step 1 Click Administration.

Step 2 Choose Settings > External Servers > SMTP.

Step 3 Enter the required values to start or stop email service on your DMM appliance.

You must enter these values or you cannot send notification messages:

Value
Description

Notification Operations

Click the radio button to enable or disable the SMTP service.

Hostname or IP address

The globally routable IP address or DNS-resolvable hostname of your DMM appliance.

Port

The number to identify which TCP port is reserved for SMTP traffic. The standard port assignment is :25.

From

The email address, root@ <FQDN>, where FQDN is the globally DNS-resolvable FQDN of your DMM appliance.

BCC

Step 4 Click Save.

Step 5 Stop. You have completed this procedure.

 

Configure SNMP Server Settings for Your DMM Appliance

Cisco DMS can convey its notifications to an external SNMP server.

Before You Begin

  • Log in to DMM.

Procedure

Step 1 Click Administration.

Step 2 Choose Settings > SNMP.

Step 3 Click the Server Status radio button to enable or disable SNMP monitoring.

Step 4 Enter in the Host field the routable IP address or DNS-resolvable hostname of your NMS.

Step 5 Enter in the Port field the numeric UDP port assignment reserved for SNMP traffic.

Step 6 Apply the community string.

Step 7 Enter in the Community String field the password to identify that community.

Tip The default Community String value is public.

Step 8 Click Save.

Step 9 Stop. You have completed this procedure.

 

Populate the MIB Browser in Your NMS

Procedure

Step 1 Log in to your Cisco.com account on ftp.cisco.com.

Step 2 Navigate to .

Timesaver Alternatively, go to http://cisco.com/go/dms/mib.

Step 3 Download these files:

Step 4 Load both files into your network management system (NMS).

Tip Manufacturer documentation for your NMS should tell you how to do this.

Step 5 When your NMS prompts you to enter the SNMP port number for your DMM appliance, use the port number :161.

Step 6 Stop. You have completed this procedure.

 

Configure Alert Reports and Notification Settings

Define Alert Report Parameters

Before You Begin

  • Log in to DMM.

Procedure

Step 1 Click Administration.

Step 2 Click Alerts.

Step 3 Click Alert Reports.

Step 4 Click the radio button to choose a monitoring mode.

    • In Live Monitor Mode, we refresh displayed values in almost-real time.
    • In Snapshot Mode, we do not refresh displayed values.

Step 5 Choose the range of dates.

Step 6 Choose a n event type from the Type list, and then click Apply .

Step 7 Click Save.

Step 8 Stop. You have completed this procedure.

 

Define Notification Rules

Before You Begin

  • Log in to DMM.
  • Each target type imposes its own preconditions, as follows, for the delivery of notification messages.
    • Email

    You must:

    • Configure SMTP.
    • Enable notification operations for SMTP.
    NMS

    You must:

    • Purchase and install a license key that activates the SNMP Notification Module.
    • Configure SNMP.
    • Enable notification operations and query operations for SNMP.
    Syslog

    You must:

    • Configure Syslog.
    • Enable notification operations for Syslog.

Procedure

Step 1 Click Administration.

Step 2 Choose Alerts > Notification Rules.

Step 3 Check the check boxes to turn On one or more notification methods for each listed event type.

OR

Uncheck every check box for an event type to stop its delivery of notication messages through any medium or channel.

Step 4 (Optional) Did you check Email?

If so, you activated the Recipent field, which is now editable. Enter the email address that should receive notification messages.

Note Enter only one email address in this field. It rejects any entry that contains multiple email addresses (CSCts96411).

Tip You can enter a unique recipient address for each notification rule.

Step 5 Click Save.

Step 6 Stop. You have completed this procedure.

 

Reference

FAQs and Troubleshooting

FAQs

SMTP FAQs

Q. What might interfere with the delivery of configured email notifications for events that the Alert Browser shows?

Explanation This might happen when DMM cannot connect to your SMTP server — due to either a misconfiguration or a service outage (SMTP error 421). To determine the cause, get copies of your DMM system logs from AAI and inspect /var/log/dms/EmsService.log file.

Recommended Action Make sure the SMTP server configuration is correct in DMS-Admin. If the configuration is correct, test with a different mail server.

SNMP and MIB FAQs

Q. Which SNMP versions does the MIB support?

The MIB supports SNMPv1 and SNMPv2 in this release.

Note This release does not support SNMPv3.

Q. If multiple DMPs become unreachable at the same time, will I receive separate SNMP notifications for each?

Maybe. This can occur when you configure DMS-Admin to send SNMP notifications for unreachable DMPs.

Note This release does not support notification throttling.

Q. Where can I download the MIB and its agent capabilities file?

Log in to your Cisco.com account and go to ftp://ftp.cisco.com/pub/mibs/v2/. Alternatively, go to http://cisco.com/go/dms/mib.

Q. Which object groups does the MIB support?

This release supports:

  • cdmsSystem
  • cdmsFeatures
  • cdmsInventory

To understand these object groups, see the agent capabilities file.

Q. Can I configure the community for my SNMP agent to accept ‘get’ requests?

Yes, from the public community.

Q. Can I configure the community for my SNMP agent to accept ‘set’ requests?

No, not in this release.

Q. Can I configure the community for my external SNMP server, which receives traps?

No, not in this release.

Was this Document Helpful?

FeedbackFeedback

Contact Cisco