Polycom RealPresence Manageability Instrumentation Solution Guide · 2016. 12. 3. · Polycom video...

13
Polycom, Inc. 1 SOLUTION GUIDE Polycom ® RealPresence ® Manageability Instrumentation Version 1.0.0 | March 2014 | 3725-67755-001/A

Transcript of Polycom RealPresence Manageability Instrumentation Solution Guide · 2016. 12. 3. · Polycom video...

Page 1: Polycom RealPresence Manageability Instrumentation Solution Guide · 2016. 12. 3. · Polycom video and collaboration environments and infrastructure that include the Manageability

Polycom, Inc. 1

SOLUTION GUIDE

Polycom® RealPresence®

Manageability Instrumentation

Version 1.0.0 | March 2014 | 3725-67755-001/A

Page 2: Polycom RealPresence Manageability Instrumentation Solution Guide · 2016. 12. 3. · Polycom video and collaboration environments and infrastructure that include the Manageability

Polycom® RealPresence® Manageability Instrumentation Solution Guide

Polycom, Inc. 2

Copyright ©2014, Polycom, Inc. All rights reserved. No part of this document may be reproduced, translated into another language or format, or transmitted in any form or by any means, electronic or mechanical, for any purpose, without the express written permission of Polycom, Inc.

6001 America Center Drive San Jose, CA 95002 USA

Trademarks

Polycom®, the Polycom logo and the names and marks associated with Polycom products are trademarks and/or service marks of Polycom, Inc. and are registered and/or common law marks in the United States and various other countries. All other trademarks are property of their respective owners. No portion hereof may be reproduced or transmitted in any form or by any means, for any purpose other than the recipient's personal use, without the express written permission of Polycom.

End User License Agreement

By installing, copying, or otherwise using this product, you acknowledge that you have read, understand and agree to be bound by the terms and conditions of the End User License Agreement for this product.

Patent Information

The accompanying product may be protected by one or more U.S. and foreign patents and/or pending patent applications held by Polycom, Inc.

Open Source Software Used in this Product

This product may contain open source software. You may receive the open source software from Polycom up to three (3) years after the distribution date of the applicable product or software at a charge not greater than the cost to Polycom of shipping or distributing the software to you. To receive software information, as well as the open source software code used in this product, contact Polycom by email at [email protected].

Disclaimer

While Polycom uses reasonable efforts to include accurate and up-to-date information in this document, Polycom makes no warranties or representations as to its accuracy. Polycom assumes no liability or responsibility for any typographical or other errors or omissions in the content of this document.

Limitation of Liability

Polycom and/or its respective suppliers make no representations about the suitability of the information contained in this document for any purpose. Information is provided “as is” without warranty of any kind and is subject to change without notice. The entire risk arising out of its use remains with the recipient. In no event shall Polycom and/or its respective suppliers 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 Polycom has been advised of the possibility of such damages.

Customer Feedback

We are striving to improve our documentation quality and we appreciate your feedback. Email your opinions and comments to [email protected].

Visit the Polycom Support Center for End User License Agreements, software downloads, product documents, product licenses, troubleshooting tips, service requests, and more.

Page 3: Polycom RealPresence Manageability Instrumentation Solution Guide · 2016. 12. 3. · Polycom video and collaboration environments and infrastructure that include the Manageability

Polycom, Inc. 3

Contents

About This Guide ...................................................................................................... 4

Conventions Used in this Guide .................................................................................... 4

Information Elements ..................................................................................................... 4

Typographic Conventions .............................................................................................. 5

Get Started with Polycom® RealPresence® Manageability Instrumentation ........ 6

Get Help and Support Resources .................................................................................. 8

About Polycom Unified SNMP Data Model and MIB Structure ............................. 9

What Is SNMP? ............................................................................................................... 9

The Unified SNMP Data Model and MIB Structure ........................................................ 9

About Polycom Unified Syslog .............................................................................. 11

What Is Syslog? .............................................................................................................11

How Polycom Unified Syslog Works ............................................................................11 Syslog Message Documentation ................................................................................................... 11

Get Help ................................................................................................................... 12

Frequently Asked Questions ........................................................................................12

Polycom and Partner Resources ..................................................................................12

The Polycom Community ..............................................................................................13

Page 4: Polycom RealPresence Manageability Instrumentation Solution Guide · 2016. 12. 3. · Polycom video and collaboration environments and infrastructure that include the Manageability

Polycom, Inc. 4

About This Guide

This solution guide uses a number of conventions that help you to understand information and perform

tasks.

Conventions Used in this Guide This guide contains terms, graphical elements, and a few typographic conventions. Familiarizing yourself

with these terms, elements, and conventions will help you successfully perform tasks.

Information Elements This guide may include any of the following icons to alert you to important information.

Icons Used in this Guide

Name Icon Description

Note

The Note icon highlights information of interest or important information needed

to be successful in accomplishing a procedure or to understand a concept.

Administrator Tip

The Administrator Tip icon highlights techniques, shortcuts, or productivity

related tips.

Caution

The Caution icon highlights information you need to know to avoid a hazard that

could potentially impact device performance, application functionality, or

successful feature configuration.

Warning

The Warning icon highlights an action you must perform (or avoid) to prevent

issues that may cause you to lose information or your configuration setup,

and/or affect phone or network performance.

Web Info

The Web Info icon highlights supplementary information available online such

as documents or downloads on support.polycom.com or other locations.

Timesaver

The Timesaver icon highlights a faster or alternative method for accomplishing

a method or operation.

Power Tip

The Power Tip icon highlights faster, alternative procedures for advanced

administrators already familiar with the techniques being discussed.

Troubleshooting

The Troubleshooting icon highlights information that may help you solve a

relevant problem or to refer you to other relevant troubleshooting resources.

Settings

The Settings icon highlights settings you may need to choose for a specific

behavior, to enable a specific feature, or to access customization options.

Page 5: Polycom RealPresence Manageability Instrumentation Solution Guide · 2016. 12. 3. · Polycom video and collaboration environments and infrastructure that include the Manageability

Polycom® RealPresence® Manageability Instrumentation Solution Guide

Polycom, Inc. 5

Typographic Conventions A few typographic conventions, listed next, are used in this guide to distinguish types of in-text

information.

Typographic Conventions

Convention Description

Bold Highlights interface items such as menus, menu selections, window and dialog

names, soft keys, file names, and directory names when they are involved in a

procedure or user action. Also used to highlight text to be entered or typed. .

Italics Used to emphasize text, to show example values or inputs (in this form:

<example>), and to show titles of reference documents available from the Polycom

Support Web site and other reference sites.

Blue Text Used for cross references to other sections within this document and for hyperlinks

to external sites and documents.

Courier Used for code fragments and parameter names.

Page 6: Polycom RealPresence Manageability Instrumentation Solution Guide · 2016. 12. 3. · Polycom video and collaboration environments and infrastructure that include the Manageability

Polycom, Inc. 6

Get Started with Polycom®

RealPresence® Manageability

Instrumentation

The Polycom® RealPresence® Manageability Instrumentation solution simplifies management of Polycom

RealPresence video collaboration services.

Prior to the introduction of RealPresence Manageability Instrumentation, Simple Network Management

Protocol (SNMP) Management Information Base (MIB) and Syslog formats varied across Polycom

endpoint and infrastructure products. Using RealPresence Manageability Instrumentation, you can now

collect, store, and export data in a consistent format across all Polycom endpoints and hardware, and

software infrastructure systems. Polycom video and collaboration environments and infrastructure that

include the Manageability Instrumentation solution capabilities are easier to monitor, operate, and secure.

Specifically, RealPresence Manageability Instrumentation equips your Polycom devices with two

embedded capabilities that enhance your ability to monitor them:

The Polycom Unified (SNMP) Management Information Base (MIB) provides a consistent, unified

data model and common format for all MIBs across Polycom products. The new MIB enables you

to translate data you collect with SNMP into a standardized format so you can remotely monitor

devices on a network.

● The Polycom Unified System logging (Syslog) transport format provides a system log message

format compliant with RFC 5424 that enables you to log device events locally and remotely in a

standardized way. Monitoring system logs is especially useful for troubleshooting and security

purposes.

Web Info: Read the Release Notes for the Manageability Instrumentation Solution

For known issues and workarounds for the Manageability Instrumentation solution, see Polycom® RealPresence® Manageability Instrumentation Release Notes.

RealPresence Manageability Instrumentation supports the following Polycom endpoint products:

● Polycom® RealPresence® Group Series For information, see the Polycom® RealPresence®

Group Series v4.1.1 Administrator's Guide

RealPresence Manageability Instrumentation supports the following Polycom infrastructure products:

● Polycom® RealPresence® Collaboration Server For information, see the Polycom®

RealPresence® Collaboration Server v8.3 Administrator's Guide

● Polycom® RealPresence® Access Director For information, see the Polycom® RealPresence®

Access Director v3.1 Administrator's Guide

● Polycom® RealPresence® Resource Manager For information, see the Polycom®

RealPresence® Resource Manager v8.1.0 Operations Guide

Page 7: Polycom RealPresence Manageability Instrumentation Solution Guide · 2016. 12. 3. · Polycom video and collaboration environments and infrastructure that include the Manageability

Polycom® RealPresence® Manageability Instrumentation Solution Guide

Polycom, Inc. 7

The table Manageability Instrumentation Feature Matrix shows which versions of Polycom products

began support for SNMP and Syslog.

Manageability Instrumentation Feature Matrix

Product SNMP Syslog

RealPresence Group Series 4.1.3 4.1.3

RealPresence Collaboration Server 8.3 None

RealPresence Access Director 2.1.0 2.1.0

RealPresence Resource Manager v8.1 v8.1

Page 8: Polycom RealPresence Manageability Instrumentation Solution Guide · 2016. 12. 3. · Polycom video and collaboration environments and infrastructure that include the Manageability

Polycom® RealPresence® Manageability Instrumentation Solution Guide

Polycom, Inc. 8

The figure Manageability Instrumentation v1.0 reference architecture illustrates the Manageability

Instrumentation solution, showing the flow of SNMP and Syslog events between RealPresence

components. Note that to use centralized SNMP event monitoring and Syslog data collection, you need to

deploy your own SNMP monitoring software and a Syslog event collector. RealPresence components

generate log data and send the data to a remote or centralized Syslog collector. RealPresence

components also generate SNMP traps and send these to your configured SNMP listener.

Manageability Instrumentation v1.0 reference architecture

Get Help and Support Resources This guide includes a Get Help section where you can find links to Polycom product and support sites and

partner sites. You can also find information about The Polycom Community, which provides access to

discussion forums you can join to discuss hardware, software, and solution topics with colleagues. To

register with the Polycom Community, you must first create a Polycom online account.

The Polycom Community includes access to Polycom support personnel, as well as user-generated

hardware, software, and solutions topics. You can view top blog posts and participate in threads on a

number of recent topics.

Page 9: Polycom RealPresence Manageability Instrumentation Solution Guide · 2016. 12. 3. · Polycom video and collaboration environments and infrastructure that include the Manageability

Polycom, Inc. 9

About Polycom Unified SNMP Data

Model and MIB Structure

The RealPresence Manageability Instrumentation solution simplifies the monitoring process with an

enhanced SNMP monitoring MIB structure, a collection of definitions that define the properties of a

managed device. This section briefly describes key components of a typical SNMP scenario, lists the

Polycom Unified SNMP and MIB structure, and provides notes on SNMP traps used with the

Manageability Instrumentation solution.

In addition to existing SNMP MIBs, Polycom offers a new unified SNMP data model for individual product

MIBs. Note that because existing MIB modules are product-specific, administrators must provision an

SNMP client for each product.

This solution supports SNMP versions:

● v2

● v3

This section defines SNMP and explains how the Polycom unified SNMP data model generates a

consistent MIB structure across multiple Polycom products.

What Is SNMP? SNMP is a communication protocol that enables a network management system (NMS) to monitor

resources across a network. Note that Polycom does not use SNMP to write values or to manage or

control devices. Your Polycom system sends SNMP notifications to indicate certain conditions depending

on the product you are using.

SNMP communication takes place between the management system, and SNMP agents—software that

runs on the systems that the management system monitors. The SNMP agents collect local system

information and make this information available to the management system.

A typical SNMP scenario includes the following key components:

Managed device The device that the NMS is monitoring. Management data travels from the

managed device to the NMS.

Agent Software that runs on the managed device. An agent collects, stores, and transfers

management data via SNMP to the NMS, and transfers the data as variables in a format defined by

the MIB.

NMS Software running on an administrative computer that you can use to monitor, manage, and

control, devices, and that stores device information as variables.

The Unified SNMP Data Model and MIB Structure Prior to the introduction of RealPresence Manageability Instrumentation, SNMP MIBs varied across

Polycom endpoint and infrastructure products. Polycom has developed a new unified SNMP data model

Page 10: Polycom RealPresence Manageability Instrumentation Solution Guide · 2016. 12. 3. · Polycom video and collaboration environments and infrastructure that include the Manageability

Polycom® RealPresence® Manageability Instrumentation Solution Guide

Polycom, Inc. 10

that generates a consistent MIB structure across multiple Polycom products. Note that all Polycom legacy

MIBs are still available.

Manageability Instrumentation introduces the following new MIBs:

● POLYCOM-BASE-MIB.MIB An identity module you import that is used by individual MIBs.

● POLYCOM-ENDPOINT.MIB Used with RealPresence Group Series systems.

● POLYCOM-MCU.MIB Used with RealPresence Collaboration Server.

● POLYCOM-ACCESS-MANAGEMENT.MIB Used with RealPresence Access Director solution.

● POLYCOM-RESOURCE-SCHEDULE-MANAGEMENT.MIB Used with Polycom RealPresence

Resource Manager systems.

Note: MIBs Are Available from Your Product

The new unified MIBs are available from individual products. For a list of available products and to link to a product guide, see Get Started with Polycom® RealPresence® Manageability Instrumentation.

The table SNMP Traps lists notes on SNMP traps used with the Manageability Instrumentation solution.

SNMP Traps

Product SNMP Traps

RealPresence Group Series RealPresence Group Series system does not support

Integrated Services Digital Network (ISDN) and does

not include ISDN traps.

RealPresence Collaboration Server No traps

Page 11: Polycom RealPresence Manageability Instrumentation Solution Guide · 2016. 12. 3. · Polycom video and collaboration environments and infrastructure that include the Manageability

Polycom, Inc. 11

About Polycom Unified Syslog

The Polycom Unified Syslog is compliant with RFC 5424: The Syslog Protocol. This section briefly

describes Syslog, the Polycom products that comply with RFC 5424, and a list of APP-NAME values.

What Is Syslog? System logs—or Syslog—are messages that help you understand events on a device. Defined by the

Internet Engineering Task Force (IETF), Syslog is a common baseline that system administrators use to

generate, collect, and display log entries from networking devices. Using Syslog information, you can

capture highly detailed information about the status of one or more devices and sort and parse the

information to view atypical behavior through changes in operational or performance patterns that can

indicate problems. Storing Syslog data can also support your company’s compliance regulations,

enabling you to trace events affecting network reliability and to protect data, especially when you need to

demonstrate information control to auditors.

How Polycom Unified Syslog Works Prior to the introduction of RealPresence Manageability Instrumentation, Syslog formats varied across

Polycom endpoint and infrastructure products. In addition, Polycom products varied in their support for

remote logging.

The Polycom Unified Syslog is a new common Syslog format for use with the following Polycom products:

● RealPresence Group Series systems

● RealPresence Resource Manager systems

● RealPresence Access Director solution

Syslog Message Documentation

The Polycom Unified Syslog instrumentation complies with RFC 5424. For details about Syslog

messages for your Polycom product, the table Product Syslog APP-NAME Values lists APP-NAME

values for applicable Polycom products.

Product Syslog APP-NAME Values

Product APP-NAME Value

RealPresence Group Series GroupSeries

RealPresence Collaboration Server na

RealPresence Access Director RPAD

RealPresence Resource Manager RPRM

Page 12: Polycom RealPresence Manageability Instrumentation Solution Guide · 2016. 12. 3. · Polycom video and collaboration environments and infrastructure that include the Manageability

Polycom, Inc. 12

Get Help

This section provides a list of frequently asked questions, and links to Polycom, partner, and third-party

documents and web sites. In particular, you’ll find links to the Polycom Community, a number of

discussion forums you can use to share ideas with your colleagues.

Frequently Asked Questions These frequently asked questions (FAQs) may help answer your questions about the solution.

Q: Which SNMP versions does Polycom support?

A: Polycom supports SNMP versions v2c and v3.

Polycom and Partner Resources For more information about installing, configuring, and administering Polycom products, refer to

Documents and Downloads at Polycom Support.

To find Polycom partner solutions, see Polycom Global Strategic Partner Solutions.

For help with Polycom endpoint products, see Telepresence and Video on Polycom Support.

For help with Polycom infrastructure products UC Infrastructure Support on Polycom Support.

Page 13: Polycom RealPresence Manageability Instrumentation Solution Guide · 2016. 12. 3. · Polycom video and collaboration environments and infrastructure that include the Manageability

Polycom® RealPresence® Manageability Instrumentation Solution Guide

Polycom, Inc. 13

The Polycom Community The Polycom Community gives you access to the latest developer and support information. Participate in

discussion forums to share ideas and solve problems with your colleagues. To register with the Polycom

Community, create a Polycom online account. When logged in, you can access Polycom support

personnel and participate in developer and support forums to find the latest information on hardware,

software, and partner solutions topics.