3D Connexion OL-12491-01 manual

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31

Go to page of

A good user manual

The rules should oblige the seller to give the purchaser an operating instrucion of 3D Connexion OL-12491-01, along with an item. The lack of an instruction or false information given to customer shall constitute grounds to apply for a complaint because of nonconformity of goods with the contract. In accordance with the law, a customer can receive an instruction in non-paper form; lately graphic and electronic forms of the manuals, as well as instructional videos have been majorly used. A necessary precondition for this is the unmistakable, legible character of an instruction.

What is an instruction?

The term originates from the Latin word „instructio”, which means organizing. Therefore, in an instruction of 3D Connexion OL-12491-01 one could find a process description. An instruction's purpose is to teach, to ease the start-up and an item's use or performance of certain activities. An instruction is a compilation of information about an item/a service, it is a clue.

Unfortunately, only a few customers devote their time to read an instruction of 3D Connexion OL-12491-01. A good user manual introduces us to a number of additional functionalities of the purchased item, and also helps us to avoid the formation of most of the defects.

What should a perfect user manual contain?

First and foremost, an user manual of 3D Connexion OL-12491-01 should contain:
- informations concerning technical data of 3D Connexion OL-12491-01
- name of the manufacturer and a year of construction of the 3D Connexion OL-12491-01 item
- rules of operation, control and maintenance of the 3D Connexion OL-12491-01 item
- safety signs and mark certificates which confirm compatibility with appropriate standards

Why don't we read the manuals?

Usually it results from the lack of time and certainty about functionalities of purchased items. Unfortunately, networking and start-up of 3D Connexion OL-12491-01 alone are not enough. An instruction contains a number of clues concerning respective functionalities, safety rules, maintenance methods (what means should be used), eventual defects of 3D Connexion OL-12491-01, and methods of problem resolution. Eventually, when one still can't find the answer to his problems, he will be directed to the 3D Connexion service. Lately animated manuals and instructional videos are quite popular among customers. These kinds of user manuals are effective; they assure that a customer will familiarize himself with the whole material, and won't skip complicated, technical information of 3D Connexion OL-12491-01.

Why one should read the manuals?

It is mostly in the manuals where we will find the details concerning construction and possibility of the 3D Connexion OL-12491-01 item, and its use of respective accessory, as well as information concerning all the functions and facilities.

After a successful purchase of an item one should find a moment and get to know with every part of an instruction. Currently the manuals are carefully prearranged and translated, so they could be fully understood by its users. The manuals will serve as an informational aid.

Table of contents for the manual

  • Page 1

    Corporate Headquarters Cisco S ystem s, In c. 170 West Tasman Driv e San Jose, CA 9 5134-1706 USA http://www.cisco.com Tel: 408 526-4000 800 553-NETS ( 6387) Fax: 408 526-4100 Customer Order Number: DOC- OL-12491-01= Text Part Number: OL -12491-01 Cisco SCA BB SNMP Real T ime Monitoring User Guide Release 3.0.5 OL-12491-01[...]

  • Page 2

    THE SPECIFICATIONS AND INFORMATION REGARDING THE PRO DUCTS IN THIS MANUAL ARE SUBJ ECT TO CHANGE WI THOUT NOTICE. ALL S TATEMENTS, INFORMATION, AND RECOMMENDATIONS IN THIS MANUAL ARE BELI EVED TO BE ACCURATE BUT ARE P RESENTED WITHOUT WARRANTY OF ANY KIN D, EXPRESS OR IMPLIED. USERS MUST TAKE FULL RESPONS IBILITY FOR THEIR APPLICATION OF ANY PRODUC[...]

  • Page 3

    Cisco SCA BB SNMP Real Time Monitoring User Guide OL-12491-01 i Preface iii Document Revision History iii Audience iii Organization iii Related Documentation iv Conventions iv Obtaining Documentation v World Wide Web v Documentation CD-ROM v Ordering Documentation v Documentation Feedback vi Obtaining Technical Assistance vi Cisco.com vi Technical [...]

  • Page 4

    Content s Cisco SCA BB SNMP Real Time Monitoring User Guide ii OL-12491-01 Using the SCA BB Real-Time Monitoring Configuration Utility 2-3 Installing the RTMCMD Utility and the RTM Report Templates 2-4 Installing the Java Runtime Environment 2-4 The Real-Time Monitoring Configuration Utility 3-1 The rtmcmd Utility 3-2 rtmcmd Utility Examples 3-3 Th[...]

  • Page 5

    Cisco SCA BB SNMP Real Time Monitoring User Guide OL-12491-01 iii This preface describes who should read the Cisco SCA BB SNMP Real-T ime Monitoring User Guide , how it is or ganized, a nd its document conventions. Document Revision History Cisco Service Center Release Part Number Publication Date Release 3.0.5 OL-12491-0 1 November, 2 006 D ESCRIP[...]

  • Page 6

    Preface Related Documentation Cisco SCA BB SNMP Real Time Monitoring User Guide iv OL-12491-01 Chapter 4 Troubleshooti ng (on page 4- 1 ) Presents error m essages and pos sible causes o f the error. Related Documentation The following publications are av ailable for the Cisco Service Control Application for Broadband: Cisco Service Contr ol Applica[...]

  • Page 7

    Preface Obtaining Documentation Cisco SCA BB SNMP Real Time Monitoring User Guide OL-12491-01 v Obtaining Documentation The following sections provide sources for obtaining documentation from Cisco Systems. World W ide W eb Y ou can access the most current Cisco documentation on the W orld W ide W eb at the following sites: • http://www .cisco.co[...]

  • Page 8

    Preface Obtaining T echnical Assistance Cisco SCA BB SNMP Real Time Monitoring User Guide vi OL-12491-01 Documentation Feedback If you are reading Cisco product documentation on the W orld W ide W eb, you can submit technical comments electronically . Click Feedback in the toolbar and select Documentation . After you complete the form, click Submit[...]

  • Page 9

    Preface Obtaining T echnical Assistance Cisco SCA BB SNMP Real Time Monitoring User Guide OL-12491-01 vii Cont acting T AC by Using the Cisco T AC Website If you have a priority level 3 (P3) or priority level 4 (P 4) problem, contact T AC by going to the T AC website http://www .cisco.com/tac . P3 and P4 level problems are defined as follows: • P[...]

  • Page 10

    [...]

  • Page 11

    Cisco SCA BB SNMP Real Time Monitoring User Guide OL-12491-01 1-1 SNMP-based monitoring tools, such as MR TG , allow network administrators to monitor the activity and health of network devices in real time. Cisco SCA BB includes an SNMP-based real- time monitoring solution, which is implem en ted using MR TG and a Round Robin Database (RRDT ool). [...]

  • Page 12

    Chapter 1 Overview Components of SNMP R T M with MRTG and RRDT ool Cisco SCA BB SNMP Real Time Monitoring User Guide 1-2 OL-12491-01 Components of SNMP RTM with MRTG and RRDT ool Following are the components of an MR TG / RRDT o ol monitoring system: • MR TG is a script that collects SNMP data from monitored devices. It monitors SNMP network devi[...]

  • Page 13

    Chapter 1 Overview Pre-defined SCA BB Real-T ime Monitoring Reports Cisco SCA BB SNMP Real Time Monitoring User Guide OL-12491-01 1-3 References Refer to the following links for R TM softwa re components documentation and download: • PyCron (for windows setups): http://www .kalab.com/fr eeware /pycr on/pycron.ht m • ActivePerl (for running MR T[...]

  • Page 14

    Chapter 1 Overview Pre-defined SCA BB Real-T ime Monitoring Reports Cisco SCA BB SNMP Real Time Monitoring User Guide 1-4 OL-12491-01 15 Subscriber Counte rs 16 RDR Counters 17 Downstream Bandwidt h per TX Que ue 18 Upstream B andwidth pe r TX Queue Reports Note the following general in formation regarding charts: • Each report is actually made o[...]

  • Page 15

    Chapter 1 Overview SCA BB Real-Time Monitoring Setup Cisco SCA BB SNMP Real Time Monitoring User Guide OL-12491-01 1-5 The following diagram shows a report example. Figure 1-2: Sam p le G raph SCA BB Real-T ime Monitoring Setup An R TM setup requires the installation of the components described in Compone nts of SNMP RTM with MRTG and RRDT ool (on [...]

  • Page 16

    Chapter 1 Overview SCA BB Real-Time Monitoring Setup Cisco SCA BB SNMP Real Time Monitoring User Guide 1-6 OL-12491-01 The RTM Directory T o view a report, R TM users browse to a URL mapped to a designated directory on their web server . This designated directory is referred to as the RTM dir ectory . Users are required to create the R TM directory[...]

  • Page 17

    Cisco SCA BB SNMP Real Time Monitoring User Guide OL-12491-01 2-1 This chapter contains the following sections: • Using MR TG and RRDT ool for Real-Time SNMP Monitoring 2-1 • W eb Server Configuration 2-2 • Using the SCA BB Real-T ime Monitoring Configuration Utility 2-3 • Installing the R TMCMD Utility and the R TM Report T emplates 2-4 Us[...]

  • Page 18

    Chapter 2 Getting S tarted Web Server Configuration Cisco SCA BB SNMP Real Time Monitoring User Guide 2-2 OL-12491-01 b) Select a report from the available reports listed on the left. The following figure is a screenshot taken after selecting an SCE device. This guide focuses on Step 5, creating the CFG and CGI files for MR TG and RRDT ool. The SCA[...]

  • Page 19

    Chapter 2 Getting S tarted Using the SCA BB Real-Time Monitoring Configuration Util ity Cisco SCA BB SNMP Real Time Monitoring User Guide OL-12491-01 2-3 < Directory "< Apache instal lation dire ctory >/htdocs/ < rtm directory >"> Options Indexes Fo llowSymLink s ExecCGI AllowOverride Indexes Order allow,deny Allow from [...]

  • Page 20

    Chapter 2 Getting S tarted Installing the RTMCMD Utility and the R TM Report T emplate s Cisco SCA BB SNMP Real Time Monitoring User Guide 2-4 OL-12491-01 Step 5 Install these CFG and CGI files into your R TM setup (see Installing the CFG and CGI Files for Use by MRTG and RRD (on page 3-5 )). Installing the RTMCMD Utility and the RTM Report T empla[...]

  • Page 21

    Cisco SCA BB SNMP Real Time Monitoring User Guide OL-12491-01 3-1 This chapter contains the following sections: • The rtmcmd Utility 3-2 • The User Configuration File 3-3 • User Configuration File Format 3-4 • Files and Directories 3-4 • Installing the CFG and CGI Files for Use by MR TG and RRDT ool The Real-T ime Monitoring Configuration[...]

  • Page 22

    Chapter 3 The Real-Time Monitoring Configuration Utility The rtmcmd Utility Cisco SCA BB SNMP Real Time Monitoring User Guide 3-2 OL-12491-01 The utility compiles the templates and the PQB file into the actual CFG and CGI files required by MR TG and RRDT ool, and stores the results in the specified target directory . The rtmcmd Utility The command-[...]

  • Page 23

    Chapter 3 The Real-Time Monitoring Configuration Utility The User Configuration File Cisco SCA BB SNMP Real Time Monitoring User Guide OL-12491-01 3-3 The following table lists these additional rtmcmd operations. T able 3-2 r t mcmd Oper ations Operation Description --version Display RTM CMD ve rsion --help Display RTMCMD help rtmcmd Utility Exampl[...]

  • Page 24

    Chapter 3 The Real-Time Monitoring Configuration Utility User Configuration File F orma t Cisco SCA BB SNMP Real Time Monitoring User Guide 3-4 OL-12491-01 rtmcmd User Configuration File Example The following is an example rtmcmd user configuration file: #The absolute p ath to the RRD tool's exe cution file s folder #Use '' or &apo[...]

  • Page 25

    Chapter 3 The Real-Time Monitoring Configuration Utility Installing the CFG and CGI Files for Use by MRTG and RRDT ool Cisco SCA BB SNMP Real Time Monitoring User Guide OL-12491-01 3-5 • rtm_dir—The R TM directory is where MR TG will create and update the RRDT ool archive files. It is recommended that the target directory provi ded to the rtmcm[...]

  • Page 26

    Chapter 3 The Real-Time Monitoring Configuration Utility Installing the CFG and CGI Files for Use by MRTG and RRDT ool Cisco SCA BB SNMP Real Time Monitoring User Guide 3-6 OL-12491-01 */5 * * * * < Fu ll path to the Perl bin d irectory >wper l.exe <Full path to the MRTG bin di rectory >mr tg <RTM directory> mrtg-cfg< SCE a[...]

  • Page 27

    Chapter 3 The Real-Time Monitoring Configuration Utility Installing the CFG and CGI Files for Use by MRTG and RRDT ool Cisco SCA BB SNMP Real Time Monitoring User Guide OL-12491-01 3-7 Step 3 Update the report CGI files—Copy the updated CGI files from the SCE folder created in the rtmcmd tar get directory to the appropriate direct ory in the R TM[...]

  • Page 28

    [...]

  • Page 29

    Cisco SCA BB SNMP Real Time Monitoring User Guide OL-12491-01 4-1 This chapter contains the following sections: • Error Message when V iewi ng a Report 4-1 • Reports Missing Data 4-3 Error Message when V iewing a Report Problem Apparent Error Message: viewing a re port returns with an error message Error opening <RRD archive name>.rrd: No[...]

  • Page 30

    Chapter 4 T roubleshooting Error Message when Viewing a Report Cisco SCA BB SNMP Real Time Monitoring User Guide 4-2 OL-12491-01 2. Cron did not invoke MR TG a) V erify Cron is configured correctly—Check the MR TG invocation command for the specific SCE platform is correct. b) If using PyCron, try running MR TG from PyCron GUI and verify it compl[...]

  • Page 31

    Chapter 4 T roubleshooting Reports Missing Data Cisco SCA BB SNMP Real Time Monitoring User Guide OL-12491-01 4-3 Reports Missing Data Problem Reports missing data. There is a sheer drop in reported traf fic. Cause and Solution Cron has stopped invoking MR TG 1. V erify the *.rrd files in the folder sce_<SCE IP> haven’t been modified during[...]