Tektronix WebMSM User Manual
User Manual
WebMSM
Web Monitoring System Manager
071-1239-02
This document supports software version 2.1.0 and above.
www.tektronix.com
Copyright ©Tektronix, Inc. All rights reserved. Licensed software products are owned by Tektronix or its suppliers
and are protected by United States copyright laws and international treaty provisions.
Tektronix products are covered by U.S. and foreign patents, issued and pending. Information in this publication
supersedes that in all previously published material. Specifications and price change privileges reserved.
Tektronix, Inc., P.O. Box 500, Beaverton, OR 97077
TEKTRONIX and TEK are registered trademarks of Tektronix, Inc.
Contacting Tektronix
Tektronix, Inc.
14200 SW Karl Braun Drive or P.O. Box 500
Beaverton, OR 97077 USA
For product information, sales, service, and technical support:
In North America, call 1-800-833-9200.
Worldwide, visit www.tektronix.com to find contacts in your area.
Warranty 9(b)
Tektronix warrants that the media on which this software product is furnished and the encoding of the programs on
the media will be free from defects in materials and workmanship for a period of three (3) months from the date of
shipment. If any such medium or encoding proves defective during the warranty period, Tektronix will provide a
replacement in exchange for the defective medium. Except as to the media on which this software product is
furnished, this software product is provided "as is" without warranty of any kind, either express or implied.
Tektronix does not warrant that the functions contained in this software product will meet Customer's requirements
or that the operation of the programs will be uninterrupted or error-free.
In order to obtain service under this warranty, Customer must notify Tektronix of the defect before the expiration of
the warranty period. If Tektronix is unable to provide a replacement that is free from defects in materials and
workmanship within a reasonable time thereafter, Customer may terminate the license for this software product and
return this software product and any associated materials for credit or refund.
THIS WARRANTY IS GIVEN BY TEKTRONIX WITH RESPECT TO THE PRODUCT IN LIEU OF ANY
OTHER WARRANTIES, EXPRESS OR IMPLIED. TEKTRONIX AND ITS VENDORS DISCLAIM ANY
IMPLIED WARRANTIES OF MERCHANTABILITY OR FITNESS FOR A PARTICULAR PURPOSE.
TEKTRONIX' RESPONSIBILITY TO REPLACE DEFECTIVE MEDIA OR REFUND CUSTOMER'S
PAYMENT IS THE SOLE AND EXCLUSIVE REMEDY PROVIDED TO THE CUSTOMER FOR BREACH OF
THIS WARRANTY. TEKTRONIX AND ITS VENDORS WILL NOT BE LIABLE FOR ANY INDIRECT,
SPECIAL, INCIDENTAL, OR CONSEQUENTIAL DAMAGES IRRESPECTIVE OF WHETHER TEKTRONIX
OR THE VENDOR HAS ADVANCE NOTICE OF THE POSSIBILITY OF SUCH DAMAGES.
Table of Contents
Preface.....................................................................................................................v
Related Material......................................................................................................vi
Manual Conventions ...............................................................................................vi
Getting Started
Overview............................................................................................................... 1-1
System Configuration ...........................................................................................1-3
WebMSM Options................................................................................................ 1-7
WebMSM Field Upgrade Kits.............................................................................. 1-8
Licensing............................................................................................................... 1-8
Passwords.............................................................................................................. 1-9
Remote User Interface ........................................................................................1-10
Installation......................................................................................................... 1-11
Minimum Requirements ..................................................................................... 1-11
User Installation.................................................................................................. 1-13
Administrator Installation................................................................................... 1-20
User Documentation ........................................................................................... 1-28
First Use for Monitoring ..................................................................................... 1-29
WebMSM Reference
WebMSM Reference........................................................................................... 2-1
User Interface Overview ....................................................................................... 2-1
Opening the WebMSM Control Panel.................................................................. 2-4
Menus and Options ............................................................................................... 2-5
Accessing Configuration Lists.............................................................................. 2-7
WebMSM Web Monitoring System Manager User Manual i
Table of Contents
WebMSM Configuration Reference
WebMSM Configuration Editor........................................................................ 3-1
Opening the WebMSM Configuration Editor....................................................... 3-2
Menus and Options ...............................................................................................3-3
Editing an Existing Configuration File .................................................................3-5
Configuration List................................................................................................. 3-6
Hot Spot Editor ...................................................................................................3-11
Stream Editor ......................................................................................................3-21
Device Editor ......................................................................................................3-24
Event Classification Editor..................................................................................3-26
Checking the Configuration against the Current License ...................................3-29
Index
ii WebMSM Web Monitoring System Manager User Manual
Table of Contents
List of Figures
Figure 1-1: System configuration - example......................................................... 1-2
Figure 1-2: Network architecture.......................................................................... 1-4
Figure 1-3: Configuration file relationships.......................................................... 1-5
Figure 1-4: Password locations............................................................................. 1-9
Figure 1-5: WebMSM Control Panel - initial user screen .................................. 1-16
Figure 1-6: WebMSM Configuration Editor - initial administrator screen ........ 1-22
Figure 1-7: WebMSM Control Panel - first use.................................................. 1-30
Figure 1-8: Configuration setup - example......................................................... 1-32
Figure 2-1: WebMSM Control Panel - open......................................................... 2-4
Figure 3-1: WebMSM Configuration Editor - open ............................................. 3-2
Figure 3-2: Select Configuration dialog box......................................................... 3-6
Figure 3-3: WebMSM Configuration List Editor ................................................. 3-7
Figure 3-4: Hot Spot Editor ................................................................................ 3-11
Figure 3-5: Hot Spot Editor - background .......................................................... 3-16
Figure 3-6: Hot Spot Details dialog box............................................................. 3-18
Figure 3-7: Hot Spot Images dialog box............................................................. 3-19
Figure 3-8: Stream Configuration Editor............................................................ 3-21
Figure 3-9: Device Configuration Editor............................................................ 3-24
Figure 3-10: Event Classification Editor ............................................................ 3-27
Figure 3-11: License - example .......................................................................... 3-29
WebMSM Web Monitoring System Manager User Manual iii
Table of Contents
List of Tables
Table 1-1: Sample files ......................................................................................... 1-6
Table 1-2: Standard WebMSM configuration....................................................... 1-7
Table 1-3: WebMSM options................................................................................1-7
Table 1-4: WebMSM field upgrade kits ...............................................................1-8
Table 2-1: Color coding - background ..................................................................2-2
Table 2-2: Color coding - buttons .........................................................................2-3
Table 2-3: Configurations menu commands ......................................................... 2-5
Table 2-4: User menu commands..........................................................................2-6
Table 2-5: License menu commands..................................................................... 2-6
Table 2-6: Configurations menu commands ......................................................... 2-7
Table 3-1: Configurations menu commands ......................................................... 3-3
Table 3-2: User menu commands..........................................................................3-4
Table 3-3: License menu commands..................................................................... 3-4
Table 3-4: Help menu commands .........................................................................3-4
Table 3-5: Configuration List Editor - File menu commands ...............................3-7
Table 3-6: Hot Spot Editor - File menu commands ............................................3-13
Table 3-7: Hot Spot Editor - Frame menu commands ........................................ 3-14
Table 3-8: Hot Spot Editor - Hot Spots menu commands...................................3-14
Table 3-9: Hot Spot Editor - Main Panel menu commands ................................3-15
Table 3-10: Hot Spot Editor - Status Banner menu commands ..........................3-15
Table 3-11: Hot Spot Details dialog box commands .......................................... 3-18
Table 3-12: Stream Configuration Editor - File menu commands ...................... 3-22
Table 3-13: Device Configuration Editor - File menu commands ...................... 3-24
Table 3-14: Event Classification Editor - File menu commands ........................3-28
iv WebMSM Web Monitoring System Manager User Manual
Preface
This manual describes the functions and use of the Tektronix WebMSM Web
Monitoring System Manager. The manual is organized into the following sections:
Getting Started
This section describes the WebMSM and provides installation instructions.
WebMSM Reference
This section provides descriptions and operational procedures for the
WebMSM.
WebMSM Configuration Editor Reference
This section provides descriptions and operational procedures for the
WebMSM Configuration Editor.
WebMSM will operate with a range of Real Time Monitoring (RTM) devices.
Each RTM user interface will have minor differences, dependent upon the features
offered by the RTM device. For this reason each RTM user interface is described
in the associated RTM User Manual.
WebMSM Web Monitoring System Manager User Manual v
Preface
Related Material
Manual Conventions
This manual is provided in portable document format (PDF) on CD.
The RTM devices that the WebMSM interacts with are documented separately.
The appropriate user manuals are supplied with the RTM devices.
The following formatting conventions are used in this manual:
On-screen buttons.
Example: Select the Streams button.
Dialog box names and field names.
Example: Enter the decimal value in the
Value field.
Menu option selections are represented thus: <menu> <option>,
Example:
File Save.
Mono-spaced text is used where ASCII text is being illustrated.
Example:
\wmsm\config.txt
'Path names' and 'filenames' are contained within single quotes.
vi WebMSM Web Monitoring System Manager User Manual
Getting Started
Getting Started
Overview
The Web Monitoring Systems Manager (WebMSM) provides complete visibility
of the error status of a transmission network.
Real time monitoring (RTM) devices can be placed at strategic points in a
transmission network. An RTM device can facilitate one or more probes; a probe
corresponds to a monitoring point in a transmission network. WebMSM licensing
is carried out on a 'per probe' basis. In addition to the licensed probes, RTM device
parameters, such as operating temperature and hard disk status, can be monitored.
All of this data can be monitored from a central point.
Transport stream monitoring data is handed from the probe point to the WebMSM;
similarly, device data is handed from the RTM device to the WebMSM. Both sets
of data will vary from probe to probe and from RTM device to RTM device. For
this reason, the Stream and Device sections of the user interface are not described
in detail in this user manual; they are described in the relevant RTM device user
manual.
The WebMSM Configuration Editor allows a complete multi-layered model of the
network to be configured and implemented. It also allows the network manager to
identify and monitor specific elements in the network, such as the status of a
particular RTM device, or to raise or lower the reporting status of errors in the
transport stream.
The WebMSM features are all accessible through the WebMSM Control Panel:
configuration selection, password management and license registration.
Configuration of systems may use one or more of the following views: Hot Spot,
Stream and Device. Each view is provided by a separate application that handles a
different aspect of system management and monitoring.
WebMSM Web Monitoring System Manager User Manual
1-1
Getting Started
Figure 1-1: System configuration - example
The Hot Spot application allows the overall state of streams and RTM devices to
be viewed in a graphical environment. Hot spots are icon-like images placed at
strategic points on a background image of a map or system diagram and linked to a
device, a stream or another hot spot view. Hot Spots also provide an overview of
the status of the linked item using color coding.
The Hot Spot views are managed by a set of configuration files that dictate the
content and linking of the various views. Any number of configurations can be
created using WebMSM Configuration Editor. On starting the WebMSM, the user
can make a selection from a configuration list.
1-2 WebMSM Web Monitoring System Manager User Manual
Getting Started
The Stream application interprets and displays stream-related information received
from the associated RTM device, including:
Tests
Programs
PIDs (packet identities)
Service information tables:
PSI/SI/PSIP - Program Specific Information (MPEG)
Service Information (DVB)
Program and Specific Information Protocol (ATSC)
The Device application interprets and displays RTM device-related information
received from the associated RTM device, including fan status and the device
event log.
System Configuration
A major feature of WebMSM is its versatility with respect to configuration.
Although always operating within a client-server architecture, the system
components can be centralized or distributed around a system.
A large network may have a dedicated Web server that holds the WebMSM
Configuration files. Users of the system would have WebMSM installed on their
own personal computer (PC); they may then choose to use either their own local
WebMSM configuration files or the WebMSM configuration files held by the
dedicated Web server.
System Security is facilitated using password files. These are held on individual
RTM devices or on a central Web server.
The monitoring data generated by some RTM devices can also be accessed by a
Remote User Interface. It is accessed through a Web browser running on a Client
PC.
Although a user can access multiple RTM devices through multiple instances of
the Remote User Interface, this is not recommended as a normal working practice.
WebMSM Web Monitoring System Manager User Manual 1-3
Getting Started
Network Architecture
The diagram below illustrates an example of WebMSM network architecture.
Figure 1-2: Network architecture
WebMSM configuration files can be stored either on the Web server, on the client
PCs, or in both locations. The files stored on the Web server are available to all
users of the network (subject to permissions), whereas those stored on client PCs
are available to only the user of that PC.
The Passwords can still be installed on a Web Server; this can either be a
monitoring device or a dedicated Web server.
NOTE. The Remote User Interface can be used from any networked PC equipped
with a Web Browser independently of the WebMSM architecture.
1-4 WebMSM Web Monitoring System Manager User Manual
Getting Started
WebMSM Configuration
Configuration of the WebMSM for a particular system setup is provided by a
hierarchy of configuration files. Each configuration file handles a specific aspect of
the system architecture and provides links to other levels. The WebMSM
Configuration Editor provides the tools (editors) needed to create and edit the
configuration files.
The diagram below illustrates the relationship between the various configuration
files.
Figure 1-3: Configuration file relationships
The configuration files are as follows:
Configuration List. The WebMSM reads this file (configlist.txt) when Configurations
Select… is selected from the WebMSM Control Panel. The configuration list
provides content for the
Select Configuration dialog box. Each entry in the
Configuration List acts as a pointer to the next level of system configuration files.
Configuration Lists are created and edited using the Configuration List Editor.
WebMSM Web Monitoring System Manager User Manual 1-5
Getting Started
Hot Spots. Hotspot views are graphical representations of systems overlaid with
active hotspots. Each hot spot provides a link to another hot spot view, a device
view or a stream view.
Hotspot configuration files (*.cfg) are created and edited using the Hot Spot
Editor.
Stream. The content for Stream views is received from an RTM device.
Stream configuration files (*.cfg) indicate which stream is to be used. The file may
also be associated with an Event Classification file. Stream configuration files are
created and edited using the Stream Configuration Editor.
Device. The content for Device views is received from an RTM device.
Device configuration files (*.cfg) indicate which device is to be used. Device
configuration files are created and edited using the Device Configuration Editor.
Event Classifications. Events in streams can be categorized and grouped.
Event Classification files (*.evc) contain the error classification data. Each
classification file can be associated with one or more streams. Event Classification
files are created and edited using the Event Classification Editor.
Sample Configuration
A sample configuration has been provided in the
SampleConfiguration directory. It
may be useful to inspect the sample files.
The directory containing the files should be copied from the CD-ROM to a suitable
location on the PC. The sample contains the following files:
Table 1-1: Sample files
Hot Spot views Stream views Device views
uk.cfg stream1.cfg device1.cfg
london.cfg stream2.cfg device2.cfg
birmingham.cfg stream3.cfg device3.cfg
edinburgh.cfg
Also:
Two graphic files: uk.gif and site.gif
One event classification file: test.evc
The primary configuration list file: configlist.txt
1-6 WebMSM Web Monitoring System Manager User Manual
Getting Started
WebMSM Options
WebMSM options are enabled using licensing. All options are available at
installation; no further installation activity is currently required. The License Key
enables those options that the customer has purchased.
The options available are given in the following tables:
Table 1-2: Standard WebMSM configuration
Nomenclature Description Deliverables
WebMSM Web-based monitoring management
software, installable application with
license for monitoring up to 4
monitoring probes.
- Web Monitoring Systems Manager installation CD
(Tektronix part number: 063-3648-xx).
- Web Monitoring Systems Manager Configuration Editor
installation CD
(Tektronix part number: 063-3649-xx).
- Option Key license for up to 4 monitoring probes.
Table 1-3: WebMSM options
Item Option Description
WebMSM 08 Additional license for adding up to eight monitoring probes to WebMSM.
16 Additional license for adding up to 16 monitoring probes to WebMSM.
32 Additional license for adding up to 32 monitoring probes to WebMSM.
64 Additional license for adding up to 64 monitoring probes to WebMSM.
UL Additional license for adding unlimited monitoring probes to WebMSM.
WebMSM Web Monitoring System Manager User Manual 1-7
Getting Started
WebMSM Field Upgrade Kits
The field upgrade kits that are available for the WebMSM are listed in the
following table:
Table 1-4: WebMSM field upgrade kits
Item Description
WebMSMF16 Additional license for adding up to 16 monitoring probes to WebMSM.
WebMSMF32 Additional license for adding up to 32 monitoring probes to WebMSM.
WebMSMF64 Additional license for adding up to 64 monitoring probes to WebMSM.
WebMSMFUL Additional license for adding unlimited monitoring probes to WebMSM.
Licensing
WebMSM uses a licensing scheme to control the number and types of probes that
can be accessed and controlled by WebMSM. The license also authorizes use of
the WebMSM Configuration Editor.
A serial number and an option key are supplied with WebMSM. The option key is
of the form '
the option key is case-sensitive.
Users are required to enter these details in either the WebMSM Client or
WebMSM Configuration Editor applications through a dialog box before they can
use any of the features. The license details will be stored on the client machine.
nnnnn-nnnnn-nnnnn-nnnnn', where 'n' is any alphanumeric character;
1-8 WebMSM Web Monitoring System Manager User Manual
Getting Started
Passwords
Security access is controlled by a combination of user names and passwords.
Currently two user names are available:
'User' enables monitoring only access to the RTM devices.
'Administrator', in addition to monitoring access, allows a range of device
parameters to be set.
Each user name may be allocated a password by the Administrator. The user name
and password details are stored in a password file, which may be stored locally or
on a Web server.
The following diagram shows the possible locations for the password file and the
accessibility:
Figure 1-4: Password locations
WebMSM Web Monitoring System Manager User Manual 1-9
Getting Started
Remote User Interface
From Figure 1-4, note the following points:
Only a user designated as an Administrator can create and save passwords.
Passwords for the installed WebMSM can be stored on the local PC or on a
Web/File Server.
Passwords created and edited on an installed WebMSM or WebMSM
Configuration Editor can be uploaded to RTM devices for use by those
accessing the device through the RUI.
Separate Remote User Interface (RUI) software, based on the WebMSM, is
supplied with some RTM devices; it may be preinstalled or supplied as an upgrade
kit. The RUI is accessed a Web browser (Microsoft Internet Explorer with
Microsoft Virtual Machine installed) of any networked personal computer. The
interface initially displays a view similar to the Hot Spot view status bar. The
buttons on the Status Bar link to a Device view and Stream view(s).
1-10 WebMSM Web Monitoring System Manager User Manual
Installation
This section describes the procedures for installing the WebMSM and the
WebMSM Configuration Editor onto a personal computer. Use these procedures to
reinstall the software if it is deleted or becomes corrupted.
Installation is described in two sections:
User installation: Installation of WebMSM, including registration of the
serial number and the license key.
A User has access to WebMSM and the monitoring functions that it provides.
Security, in the form of passwords, will be advised by the Administrator.
Administrator installation: Installation of WebMSM and the WebMSM
Configuration Editor, including registration of the serial number and the
license key and password setup.
An Administrator has access to the WebMSM Configuration Editor and
WebMSM. The WebMSM Configuration Editor allows the Administrator to
configure the system and allocate passwords.
Minimum Requirements
The minimum requirements for a client PC running the WebMSM applications are
as follows:
1 GHz Intel Pentium Processor
256 MB RAM
30 MB free disk space
Any Microsoft Windows operating system
Microsoft Internet Explorer, Version 5.0 minimum
Microsoft Java Virtual Machine installed, Version 5.00.3809 or above
1024 x 768 pixel video monitor with 256 available colors
Ethernet: 10/100 Base-T; RJ45
RTM device
It is assumed that the RTM device and the Client PC are incorporated into a
network.
WebMSM Web Monitoring System Manager User Manual
1-11
Installation
Confirm that Internet Explorer, Version 5.0 (minimum), and Microsoft Java
Virtual Machine, Version 5.0 (minimum), are present before proceeding with the
installation.
Checking Microsoft Internet Explorer Version
Open Microsoft Internet Explorer. The version number will be displayed on the
opening splash screen. Further confirmation is available by selecting
Internet Explorer.
Help About
Checking Microsoft Java Virtual Machine Version
Select the Command Prompt from the Start menu:
WindowsNT: Start Programs
WindowsXP: Start All Programs Accessories
Windows2000: Start Programs Accessories
Select the
Command Prompt.
1. Using DOS commands, navigate to the root drive; for example, C:\>.
2. Enter
jview.
The version number of the Microsoft Java Virtual Machine is displayed in the
first line of the response as follows:
Microsoft (R) Command-line Loader for Java Version 5.00.3809
…
The minimum acceptable version number is 5.00.0000.
If the Java Virtual Machine is not installed, the prompt will be redisplayed
with no response.
1-12 WebMSM Web Monitoring System Manager User Manual
Installation
Installing the Java Virtual Machine
The user must have Windows NT administrative rights to be able to install the Java
Virtual Machine.
User Installation
1. Locate the following program:
2. Run
3. Enter jview at the command prompt to confirm the Java Virtual Machine has
Installation for a User includes the following processes:
MSJAVX86.exe.
The response will indicate that the installation has been successful.
NOTE. If the user does not have Windows NT administrative rights, attempting
to install the Java Virtual Machine will elicit an error message and then go
on to indicate success. However, the installation will not succeed.
been successfully installed.
MSJAVX86.exe.
Installing WebMSM
Accessing passwords
Entering the Serial Number and License Key
A WebMSM User must be able to access real-time monitoring devices using the
WebMSM interface. For this activity all that is required is a password and the
configuration, for example, IP address. The password and configuration is supplied
and set up by the WebMSM Administrator. At first use, the User will also need to
provide the licensing data (serial number and option key).
Installing WebMSM
1. Insert the WebMSM Applications installation CD-ROM in the personal
computer CD-ROM drive.
2. On the CD-ROM, run
3. Step through the installation process, following the instructions as necessary.
WebMSM Web Monitoring System Manager User Manual 1-13
setup.exe from the root directory.
Installation
During the WebMSM installation, the following screen is displayed:
4. At this point select
Browse .
5. In the Choose Folder dialog box, if applicable, remove the space at the end of
the
Path: name.
NOTE. The additional space in the path is not present on all installation disks.
However, this check must be made to ensure correct operation.
1-14 WebMSM Web Monitoring System Manager User Manual
Installation
6. Select
OK .
7. Continue and complete the installation.
Starting WebMSM
8. Start WebMSM from either the desktop shortcut (created during installation):
Start Programs Tektronix WebMSM WebMSM option.
or the
The WebMSM cannot be used if a password file cannot be found and the
Serial Number and License Key are not registered with the program. The
password and license details are stored in separate files.
This will typically occur at first use, but it may also occur if the password or
license files are not stored locally; in this case, the user will need to identify
the location of the files.
A message is displayed when the file containing passwords cannot be found.
Similarly, a message is displayed when the file containing license details
cannot be found.
WebMSM Web Monitoring System Manager User Manual 1-15
Loading...