HB HiVision64 Us
HB HiVision64 Us
HB HiVision64 Us
4 Manual
Hirschmann Network Management
Manuals and software are subject to copyright. All rights reserved. Copying, duplication, trans-
lation, conversion to any electronic medium or machine-readable form in whole or in part are not
permitted. The only exception applies to production of a backup of the software for the user's
own backup purposes. For devices with embedded software, the end-user license agreement
on the enclosed CD applies
The performance features described here are binding only if they have been expressly guaran-
teed in the contract. This publication has been created by Hirschmann Automation and Control
GmbH according to the best of our knowledge. Hirschmann reserves the right to change the con-
tents of this manual without prior notice. Hirschmann can give no guarantee in respect of the
correctness or accuracy of the details in this publication.
Under no circumstances can Hirschmann be held liable for any damage arising in any connec-
tion with use of the network components or their operating software. We also refer to the condi-
tions of use stated in the license agreement.
Contents
1 Introduction 11
1.1 HiVision management shell 12
1.2 The HiVision basic structure 15
1.2.1 The HiVision program 15
1.2.2 The HiVision management platform 16
1.3 With HiVision manageable products 17
1.4 Supported MIBs 21
2 Installation 23
2.1 File structure of the HiVision CD 26
2.2 PC-StandAlone solution for Windows 27
2.2.1 Installation requirements 27
2.2.2 Installation 28
2.2.3 Program start 29
2.2.4 Updates 31
2.2.5 Deinstallation 32
2.3 PC-StandAlone solution for Linux 33
2.3.1 Installation prerequisites 33
2.3.2 Installation 34
2.3.3 Program start 35
2.3.4 Updates 36
2.3.5 Deinstallation 37
2.4 Integration with HP OpenView for Windows 38
2.4.1 Installation prerequisites 38
2.4.2 Installation 39
2.4.3 Program start 40
2.4.4 Updates 41
2.4.5 Deinstallation 41
2.5 Integration in HP OpenView for HP-UX 42
2.5.1 Installation prerequisites 42
2.5.2 Installation 43
2.5.3 Program start 44
HiVision
Release 6.4 06/07 5
Contents
2.5.4 Updates 46
2.5.5 Deinstallation 46
2.6 Trap destinations of the agent 48
2.7 OPC server under Windows 50
2.7.1 Installation 51
2.7.2 Updates 51
2.7.3 Deinstallation 52
3 Overview of HiVision 53
3.1 Function overview 56
3.1.1 Main window 56
3.1.2 Device window 57
3.1.3 Detail window 58
3.1.4 License window 59
3.2 Using HiVision 60
3.2.1 Requirements 60
3.2.2 Getting started with HiVision 61
HiVision
6 Release 6.4 06/07
Contents
HiVision
Release 6.4 06/07 7
Contents
HiVision
8 Release 6.4 06/07
Contents
A Appendix 243
A.1 Frequently asked questions 244
A.2 Device information 245
A.2.1 RMS 245
A.2.2 MIKE, MULTIMIKE and FCMA 245
A.2.3 ETH-12TP/M 246
A.2.4 FEH-24TP 247
A.2.5 RS2-../.. 247
A.2.6 MICE 248
A.2.7 ETS-14TP, -30TP, -16TP Plus, -32TP Plus,
FES-08TP Plus, -16TP Plus and -16TP 249
A.2.8 GES-24TP/2SX/FES-24TP 249
A.2.9 GES-24TP Plus, GES-24FX 250
A.2.10 ALS family 251
A.2.11 GLS family 251
A.2.12 MACH 3000 252
A.2.13 GRS family 252
A.2.14 FastIron series 252
A.2.15 BAT54-Rail 253
A.2.16 LION-24 TP 253
HiVision
Release 6.4 06/07 9
Contents
HiVision
10 Release 6.4 06/07
Introduction
1 Introduction
HiVision
Release 6.4 06/07 11
Introduction 1.1 HiVision management shell
Intuitive operation makes the use of functions both straightforward and rapid.
The network components are displayed as gray scale images. Color overlay-
ed status displays, click-on context menus at port, group and device level
provide further detailed information.
Multiple help functions and integrated expert knowledge facilitate effective
management without requiring special expertise on the part of the user
HiVision
12 Release 6.4 06/07
Introduction 1.1 HiVision management shell
HiVision
Release 6.4 06/07 13
Introduction 1.1 HiVision management shell
HiVision
14 Release 6.4 06/07
Introduction 1.2 The HiVision basic structure
The scope of delivery includes the core program with all modules. The mo-
dules and PSMs cannot be run without valid license keys. The core program
already contains the Rack Monitoring System administration and the basic
administration of unknown devices.
As an introductory offer, you can use HiVision without a license for the
unrestricted administration of a single agent.
HiVision
Release 6.4 06/07 15
Introduction 1.2 The HiVision basic structure
When the mouse pointer is positioned over an MIB attribute, the descrip-
tion of the MIB attribute is shown by a bubble help.
Writeable MIB attributes can be reset in this window. The prerequisite is
the appropriate access entitlements.
HiVision
16 Release 6.4 06/07
Introduction 1.3 With HiVision manageable products
The following list shows the name of the products from the Hirschmann pro-
duct range, which are manageable with HiVision 6.4.
Table 1: Manageable interface cards for concentrators, hubs, MC, ASGE family
HiVision
Release 6.4 06/07 17
Introduction 1.3 With HiVision manageable products
HiVision
18 Release 6.4 06/07
Introduction 1.3 With HiVision manageable products
HiVision
Release 6.4 06/07 19
Introduction 1.3 With HiVision manageable products
HiVision
20 Release 6.4 06/07
Introduction 1.4 Supported MIBs
HiVision 6.4 supports the Hirschmann Private MIBs as well as the following
standard MIBs:
D rfc1213-MIB-II.mib
D rfc 1215-MIB-II.mib
D rfc1398-ETHER.mib
D rfc1493-BRIDGE.mib
D rfc1512-FDDI.mib
D rfc1516-REPEATER.mib
D rfc1724-RIP.mib
D rfc1757-RMON.mib
D rfc1850-OSPF.mib
D rfc1903-SNMPv2-TC.mib
D rfc1907-SNMPv2.mib
D rfc2037.mib
D rfc2096.mib
D rfc2233.mib
D rfc2239-MAU.mib
D rfc2613-SMON.mib
D rfc3621.mib
D IANAifType-MIB.mib
D ieee802-1-p.mib
D ieee802-1-q.mib
HiVision
Release 6.4 06/07 21
Introduction 1.4 Supported MIBs
HiVision
22 Release 6.4 06/07
Installation
2 Installation
HiVision
Release 6.4 06/07 23
Installation
HiVision
24 Release 6.4 06/07
Installation
In the first part of this chapter, the file structure on the HiVision CD is detailed.
This is followed by the section on installation, subdivided according to the
various shells. The chapter on installation is concluded by the procedure for
setting an agent's trap targets.
HiVision
Release 6.4 06/07 25
Installation 2.1 File structure of the HiVision CD
HiVision
26 Release 6.4 06/07
Installation 2.2 PC-StandAlone solution for Windows
HiVision
Release 6.4 06/07 27
Installation 2.2 PC-StandAlone solution for Windows
2.2.2 Installation
Administration entitlements are required before you can install HiVision.
V Select the language and follow the instructions in the installation program.
Note: At the end of the installation, the HiVision set-up program checks
whether the SMScom program is already installed. If it is not installed,
HiVision gives you the option of starting the SMScom installation program.
If you want to install SMSCom later, you will find the installation program for
SMSCom in your HiVision directory, in the OEM-Setups sub-directory.
The function of SMScom is to send short messages when events occur
(see “Short Message Service (SMS)” on page 70).
Note: When you are installing the OPC Server software, refer to “Installation”
on page 51.
HiVision
28 Release 6.4 06/07
Installation 2.2 PC-StandAlone solution for Windows
V HiVision saves
– all the default settings in the Preferences.xml file
– as well as other informations in further files
specifically for every user, in the directory
My documents\.hivision.
With the HIVISION_HOME environment variable, you can assign another
path to HiVision for these files on your network management station. You
click with the right mouse button on the My Computer symbol on your
desktop and select Properties:environment. In Variable you
enter the environment variable HIVISION_HOME and in Value you enter
the path. Then move the directory .hivision to this location.
V Start HiVision with the symbol on the desktop or from the start menu:
Start:Programs:Hirschmann:HiVision:HiVision 6.4
Or start HiVision with a command-line parameter:
Select the "HiVision 6.4" icon with the right mouse button under
Start:Programs:Hirschmann:HiVision. In the "Properties" win-
dow, enter the desired option(s) after the program name.
Parameter Meaning
-EditLicense (-L) Edit licences
help Display available options
-OpenAgentImage (-oi) <IP-Address> No network scan, only scan <IP-Address> and open
image
-ReadOnly HiVision is readonly
-remote Send commandline to a running HiVision
-ScanAgent (-a) <IP-Address> No network scan, only scan <IP-Address>
-SyntaxChecker Checks PSMs for syntax errors and consistency
HiVision
Release 6.4 06/07 29
Installation 2.2 PC-StandAlone solution for Windows
V Enter the communities for Snmp access to the agents in the Protocol
configuration window
(Configuration:Preferences:Protocol Configuration...):
public is the default read community and private is the default set
community.
Enter the IP address in the 'IP Address' field in the form x.x.x.x.
Each 'x' stands for a number from 0 to 255. The asterisk, used here as
the so-called 'wildcard', stands for any number from 0 to 255. If the IP
address of an agent is not entered explicitly in this dialog, then HiVision
proceeds with the settings in the *.*.*.* line.
The status symbols in the agent overview flash while HiVision is reading data
for these devices from the network.
HiVision
30 Release 6.4 06/07
Installation 2.2 PC-StandAlone solution for Windows
2.2.4 Updates
V Install HiVision according to “Installation” on page 28.
The new version of HiVision takes on the Preferences.xml file
(see “Program start” on page 29) of the earlier HiVision installation.
HiVision can take on the settings of an earlier HiVision installation before
release 6.0 if both HiVision installations are located on the same level of
the same root directory (e.g. C:\Program\Hirschmann).
You can deinstall an earlier version by following “Deinstallation” on
page 32.
When you are installing the OPC Server software, refer to “Installation” on
page 51.
HiVision
Release 6.4 06/07 31
Installation 2.2 PC-StandAlone solution for Windows
2.2.5 Deinstallation
Note: The license file HiVision key and other configuration files are remo-
ved by deleting the Hirschmann directory.
HiVision
32 Release 6.4 06/07
Installation 2.3 PC-StandAlone solution for Linux
HiVision
Release 6.4 06/07 33
Installation 2.3 PC-StandAlone solution for Linux
2.3.2 Installation
You require the administration rights on your network management station to
install HiVision.
HiVision
34 Release 6.4 06/07
Installation 2.3 PC-StandAlone solution for Linux
V HiVision saves
– all the default settings in the Preferences.xml file
– as well as other informations in further files
specifically for every user, in the directory $HOME/.hivision
With the HIVISION_HOME environment variable, you can assign another
path to HiVision for these files on your network management station.
Therefore move the directory .hivision to this location.
/opt/HiVision/bin/hi_trapd.sh -s↵
V The Acrobat Reader acroread is needed to view the Online manual. Set
the environment variable PATH correspondingly.
Parameter Meaning
-EditLicense (-L) Edit licences
help Display available options
-OpenAgentImage (-oi) <IP-Address> No network scan, only scan <IP-Address> and open
image
-ReadOnly HiVision is readonly
-remote Send commandline to a running HiVision
-ScanAgent (-a) <IP-Address> No network scan, only scan <IP-Address>
-SyntaxChecker Checks PSMs for syntax errors and consistency
HiVision
Release 6.4 06/07 35
Installation 2.3 PC-StandAlone solution for Linux
V Enter the communities for Snmp access to the agents in the Control con-
figuration window
(Configuration:Preferences:Control Configuration...):
public is the default read community and service is the default write
community.
Enter the IP addresses of the agents in the 'IP Address' field in the form
x.x.x.x.
Each 'x' stands for a number from 0 to 255. The asterisk, used here as
the so-called 'wildcard', stands for any number from 0 to 255. If the IP
address of an agent is not entered explicitly in this dialog, then HiVision
proceeds with the settings in the *.*.*.* line.
The status symbols in the agent overview in the main window flash while
HiVision is reading in data for these devices from the network.
2.3.4 Updates
V If an earlier version of HiVision is installed, then
– deinstall it before the new installation, according to “Deinstallation” on
page 37
or
– move the directory /opt/HiViision to another location before the new
installation.
HiVision
36 Release 6.4 06/07
Installation 2.3 PC-StandAlone solution for Linux
2.3.5 Deinstallation
Read/write access to the root directory is required for deinstallation of
HiVision.
Note: In this process the license file and the VLAN configuration is removed
also.
HiVision
Release 6.4 06/07 37
Installation 2.4 Integration with HP OpenView for Windows
HiVision
38 Release 6.4 06/07
Installation 2.4 Integration with HP OpenView for Windows
2.4.2 Installation
V Insert the HiVision CD in drive.
If the set-up program does not start automatically, then you start it manu-
ally in the "Windows" directory of the HiVision CD.
V Select the language and follow the instructions in the installation program.
HiVision
Release 6.4 06/07 39
Installation 2.4 Integration with HP OpenView for Windows
V HiVision saves
– all the default settings in the Preferences.xml file
– as well as other informations in further files
specifically for every user, in the directory
My documents\.hivision.
With the HIVISION_HOME environment variable, you can assign another
path to HiVision for these files on your network management station. You
click with the right mouse button on the My Computer symbol on your de-
sktop and select Properties:environment. In Variable you enter
the environment variable HIVISION_HOME and in Value you enter the
path. Then move the directory .hivision to this location.
Parameter Meaning
-EditLicense (-L) Edit licences
help Display available options
-OpenAgentImage (-oi) <IP-Address> No network scan, only scan <IP-Address> and open
image
-ReadOnly HiVision is readonly
ReadOnlyOVw HiVision ist readonly mit einer readonly OpenView
Ansicht
-remote Send commandline to a running HiVision
-ScanAgent (-a) <IP-Address> No network scan, only scan <IP-Address>
-SyntaxChecker Checks PSMs for syntax errors and consistency
HiVision
40 Release 6.4 06/07
Installation 2.4 Integration with HP OpenView for Windows
2.4.4 Updates
V Deinstall HiVision according to “Deinstallation” on page 41.
2.4.5 Deinstallation
V For deinstallation, select in the start menu:
Start:Programs:Hirschmann:Deinstallation of HiVision
Toolbox
Note: The license file HiVision key and other configuration files are removed
by deleting the HiVision directory.
HiVision
Release 6.4 06/07 41
Installation 2.5 Integration in HP OpenView for HP-UX
HiVision
42 Release 6.4 06/07
Installation 2.5 Integration in HP OpenView for HP-UX
2.5.2 Installation
If HP OpenView is active, it must be closed via File:Exit before starting
installation.
V Install HiVision with the program “swinstall”. “swinstall” is part of “HP Soft-
ware Distributor”.
Start the program by typing
swinstall↵
Note: If the NNM is installed as part of a bundle, (e.g. ITO bundle, ITO-
EngOrzAll), an error message will be issued. It can be bypassed by swit-
ching off the option “Enforce Script Failures” in the menu Options.
HiVision
Release 6.4 06/07 43
Installation 2.5 Integration in HP OpenView for HP-UX
Without starting HP OpenView you may verify the installation with the aid of
the HP tool swverify.
V HiVision saves
– all the default settings in the Preferences.xml file
– as well as other informations in further files
specifically for every user, in the directory $HOME/.hivision
With the HIVISION_HOME environment variable, you can assign another
path to HiVision for these files on your network management station.
Therefore move the directory .hivision to this location.
V The Acrobat Reader acroread is needed to view the Online manual. Set
the environment variable PATH correspondingly.
HiVision
44 Release 6.4 06/07
Installation 2.5 Integration in HP OpenView for HP-UX
Parameter Meaning
-EditLicense (-L) Edit licences
help Display available options
-OpenAgentImage (-oi) <IP-Address> No network scan, only scan <IP-Address> and open
image
-ReadOnly HiVision is readonly
-remote Send commandline to a running HiVision
-ScanAgent (-a) <IP-Address> No network scan, only scan <IP-Address>
-SyntaxChecker Checks PSMs for syntax errors and consistency
HiVision
Release 6.4 06/07 45
Installation 2.5 Integration in HP OpenView for HP-UX
2.5.4 Updates
V Deinstall HiVision according to “Deinstallation” on page 46.
Note: With Release 4.0 HiVision uses new device symbols. Delete symbols
of earlier releases in the shell.
2.5.5 Deinstallation
If HP OpenView is active, it must be closed via File:Exit before starting
deinstallation.
HiVision
46 Release 6.4 06/07
Installation 2.5 Integration in HP OpenView for HP-UX
Note: After deinstallation, the vendor field of the OpenView database is still
set to Hirschmann.
Note: For deinstallation you always need the deinstallation program which
matches the installation program with the same version number.
HiVision
Release 6.4 06/07 47
Installation 2.6 Trap destinations of the agent
In the main window, click on the agent of your choice with the right
mouse button and select Agent Dialog in the context menu.
Select the Security tab page and click on Trap Destination in
the left frame.
Enter the IP address of your management station under IP
Address. Make a valid Community Index entry (see Community
Entry). Switch the status to valid in order to enable traps to be
sent to this IP address.
After selecting the desired agents in the main window, click the Multi
Device Configuration button on the tool bar.
Function status
display
"Set" button
HiVision
48 Release 6.4 06/07
Installation 2.6 Trap destinations of the agent
After the next scan, HiVision displays only those configuration set-
tings which all selected agents have in common.
Display Meaning
Grey No message, e.g. no function has been started yet.
Red Action ended with error, e.g. due to incorrect Set Community.
Yellow, Action being carried out.
flashing
Green Action successfully completed.
Blue Action can not be carried out, e.g. because this action is not
implemented for the agent.
HiVision
Release 6.4 06/07 49
Installation 2.7 OPC server under Windows
OLE For Process Control (OPC) is a standardized interface for process data
management in the automation industry used for exchanging data objects
between applications. OPC is based on Microsoft’s Object Linking and Em-
bedding (OLE) method, which is widely known today as the Distributed Com-
ponent Object Model (DCOM).
The Hirschmann HiControl OPC Server is both an OPC Data Access server
and an OPC Alarm und Event server. In combination with the Windows 2000
or XP SNMP Trap Service it provides the SNMP Trap functions from certain
Hirschmann network components to the OPC Alarm und Event interface. In
connection with the HiVision network management software, HiControl pro-
vides a status display and a status updating facility for all network compon-
ents which can be managed by HiVision.
Answers to the frequently asked questions, for example integration into pro-
cess visualization systems, can be found on Hirschmann’s Internet site (see
“Frequently asked questions” on page 244).
HiVision
50 Release 6.4 06/07
Installation 2.7 OPC server under Windows
2.7.1 Installation
You usually install HiControl in conjunction with HiVision.
If you install it later, the procedure is the same as for the installation of
HiVision.
2.7.2 Updates
V Deinstall HiControl with the (de-)installation program with which you
installed it.
HiVision
Release 6.4 06/07 51
Installation 2.7 OPC server under Windows
2.7.3 Deinstallation
V For deinstallation, select from the start menu:
Start:Programs:Hirschmann:HiVision 6.4:(Un)Install
components.
HiVision
52 Release 6.4 06/07
Overview of HiVision
3 Overview of HiVision
HiVision
Release 6.4 06/07 53
Overview of HiVision
HiVision
54 Release 6.4 06/07
Overview of HiVision
This brief overview gives you the basics on the structure of the HiVision net-
work-management software - as well as the principles behind the application
philosophy.
HiVision
Release 6.4 06/07 55
Overview of HiVision 3.1 Function overview
Menu bar
Tool bar
Card-index
Status bar
Bubble help
Column can be sorted by clicking
HiVision
56 Release 6.4 06/07
Overview of HiVision 3.1 Function overview
U Using
– Column contents can be sorted by clicking the column heading
– Column width can be adjusted by dragging the column border
– Multiple selection with Ctrl and Shift like in Windows
– Bubble help can be called up depending on pointer location
– Search function via context menu with the right mouse button.
Menu bar
Tool bar
Device card-index
- Display of
device functions
Status bar
HiVision
Release 6.4 06/07 57
Overview of HiVision 3.1 Function overview
Menu bar
Tool bar
Card-index
for
- Configuration
- Performance
- Faults
- Security
- Index
Status bar
HiVision
58 Release 6.4 06/07
Overview of HiVision 3.1 Function overview
HiVision
Release 6.4 06/07 59
Overview of HiVision 3.2 Using HiVision
3.2.1 Requirements
HiVision requires:
D An existing network concept
D The completed hardware installation of the devices to be managed
D The completed base configuration (such as IP parameters) of the devices
to be managed, so that the network management station can communi-
cate with the agents of the devices
D The completed SNMP community assignment of the devices to be mana-
ged, so that the network management station also has access to the
agents
SNMP controls access permissions to the agents. Every SNMP agent
from Hirschmann has two tables:
- Community entries and
- Community access
The community entry table defines who can access the agents with write
and read permissions.
The community access table defines which computer, identified by IP
address, can be used to access the agents.
The Hirschmann agents have the following default configuration:
IP: *.*.*.*, which means that every computer can be used to access
the agents.
Read permission with the public community
Write permission with the service or private community
HiVision
60 Release 6.4 06/07
Overview of HiVision 3.2 Using HiVision
U PSM configuration
If you are not using GRS in your network, you can speed up the start pro-
cess for HiVision.
V Select Configuration:Preferences:PSMs.
V Select the line GRS in the left column and click on the field with the ar-
row pointing to the right.
V Click on Apply.
Note: HiVision can only manage those agents that are displayed in this
window (see Fig. 7) with valid read and write permissions.
HiVision
Release 6.4 06/07 61
Overview of HiVision 3.2 Using HiVision
Write community
Read community
IP address of the agent that these
communities can access.
U Device configuration
V In the detail window, configure the individual devices according to your
network concept. The Port Manager function enables you to configure
the ports for all the devices in one window.
U Network monitoring
V To customize your network monitoring, set the parameters for status
propagation, RMON threshold value, link monitoring, etc.
HiVision
62 Release 6.4 06/07
Overview of HiVision 3.2 Using HiVision
U Network availability
Make sure to evaluate the following when network problems occur:
– Status propagation
The status propagation lets you track problems as far as the detail level.
The pop-up information gives you the quickest overview of the most
important situations.
– Traps
The event messages are triggered right after an event occurs, enabling
the network administrator to act immediately.
HiVision
Release 6.4 06/07 63
Overview of HiVision 3.2 Using HiVision
HiVision
64 Release 6.4 06/07
"HiVision" main window
HiVision
Release 6.4 06/07 65
"HiVision" main window
The main window appears on the screen when HiVision is started. It consists
of four parts:
D the menu bar
D the tool bar
D the card index, which provides information to the whole network with re-
spect to the selected cardfile
D the status line
Menu bar
Tool bar
Card-index
Status bar
Bubble help
Column can be sorted by clicking
HiVision
66 Release 6.4 06/07
"HiVision" main window 4.1 Menu bar
The menu bar is right at the top of the main window. It facilitates overall ope-
ration of HiVision. The main feature is the setting of the configuration and the
view selection. Overall operation also includes programming and license ad-
ministration not to mention quitting HiVision.
Edit
Rescan1
Rescan Range...1
Stop scanning1
Add Device...1
Delete Device...
Device Description...
Agent Dialog
Update Device
Update MAC Address table
Multi Device Configuration...
Multi-Port-Manager
Multi-Port-Analyzer
Show Events
Acknowledge Events
Delete Events
Simulate Events
Acknoledge all Events
Delete all Wvents
Properties...
View
Polling...
Address Resolution Table...
Product Families...
Locate MAC Address
HiVision
Release 6.4 06/07 67
"HiVision" main window 4.1 Menu bar
Configuration
Port Status Configuration...
Interface Status Configuration...
PowerSupply Status Configuration...
Fan Status Configuration...
Relais Status Configuration...
ACA Status Configuration...
Router Status Configuration...
Chassis Status Configuration...
Protocol Status Configutaion...
Preferences...
Tools
Ping1
Telnet
Web Interface
SNMP Browser
VLAN-Manager
Clear...
Import stations
Rescan agents
Reload MAC tables
Guess uplink...
Agent list...
Agent properties
New...
Delete
Edit...
Clone...
Mgnt stations...
Analysis
Save
Load
Disable VLANS...
Traps...
Windows
Help
Program Info
Commandline Parameters
Release Notes...
Tutorials...
HiVision on the Web...
Technical Support
HiVision Manual
HiVision
68 Release 6.4 06/07
"HiVision" main window 4.1 Menu bar
4.1.1 Preferences
The Configuration:Preferences dialog allows you to enter default set-
tings for the operation of HiVision.
Setting Description
Scan Ranges (see “Scan Range” on page 80)
Agent List (see “Device List” on page 81)
Protocol Configuration (see “SNMP access permission” on page 61)
Event Dialog Default setting for the event categories displayed when you
open an event window.
Event Actions (see “Event actions” on page 100)
Event Log (see “Protocol file” on page 99)
Mail (see “Mail” on page 71)
SMS (see “Short Message Service (SMS)” on page 70)
Ext. Applications Dialog for HiVision access to external programs
PSMs (see “Creating a PSM” on page 193)
Agenten Handling Dialog for setting the scope of the data that HiVision calls up
from the agent (see “Device Handling” on page 72).
Look & Feel (see “Look & Feel” on page 73)
Language HiVision offers you an American or German interface. If you
change the language setting, it becomes effective when you
restart HiVision.
Security (see “Security” on page 74)
HiVision Licenses (see “Licenses” on page 75)
Service Information for specialists carrying out service work.
HiVision saves the default settings specifically for every user in the
Preferences.xml file, in the directory
$HOME/.hivision.(Linux),
C:\WINNT\Profiles\user\My documents\.hivision (Windows NT)
or My documents\.hivision (Windows 2000/XP/Vista/2003 Server see
“Program start” on page 29).
HiVision
Release 6.4 06/07 69
"HiVision" main window 4.1 Menu bar
HiVision
70 Release 6.4 06/07
"HiVision" main window 4.1 Menu bar
V If you enter the telephone number of your modem in the SMS sender
field, it is sent along with the message. Thus you can identify HiVision
as the sender in your mobile telephone display.
V If you mark the Log Errors field, then HiVision records in a log file
any errors occurring when SMSs are sent.
V With Apply HiVision saves the settings.
U Mail
By defining event actions you can get HiVision to carry out actions when
specific events occur. One of these actions is sending e-Mails. Under
Configuration:Preferences:Mail you enter the e-Mail parame-
ters that HiVision passes on to the e-Mail program to send an e-Mail.
HiVision
Release 6.4 06/07 71
"HiVision" main window 4.1 Menu bar
U Device Handling
With this dialog you can specify the scope of the data that HiVision calls
up from the device, and how this data will be processed.
D DNS - Domain Name Service
"Resolve Hostnames via DNS" gets HiVision to call up the host names
of the detected devices from the Domain Name Server, and to display
them in a separate column of the main window. Because calling up a
Domain Name Server is usually very time-consuming, this slows down
the starting process of HiVision considerably. In the default setting,
therefore, DNS is deactivated.
D Manage Unknown Agents
Unknown agents are displayed in the main window and can be mana-
ged. Otherwise, HiVision discards all the data of unknown agents.
D Manage ping-devices
Non-SNMP-capable devices appear in the main window, and they can
be managed.
D Show Unknown Agents
Unknown agents are displayed in the main window when Manage
Unknown Agents is marked. With Show Unknown Agents you set
the default setting in the View:Product Families to unknown.
D Load MAC Tables on startup
Read the Forwarding Database (FDB) from all the agents with FDB on
starting HiVision.
Independently of this setting, HiVision automatically reads the FDB
when you open a device window, and a button in the tool bar allows
you to read in the FDB at any time.
D Remove permanently
When you are deleting a device in the main window with Edit:Remo
ve device, a confirmation window appears. This confirmation win-
dow opens with "Remove permanently" already marked as the default
option.
D IpNetToMedia-Tabellen beim Start laden
lesen der ARP-Cache-Information aus der IpNetToMedia-Tabelle aller
Agenten beim Start von HiVision.
D Edit Traps
Evaluate traps received and display the result, e.g. status change, in
the windows.
D Index Page First
Place the index page at the start of the card index.
D Show Protocol Column
Displays the protocol column in the device overview in the main
window.
HiVision
72 Release 6.4 06/07
"HiVision" main window 4.1 Menu bar
HiVision
Release 6.4 06/07 73
"HiVision" main window 4.1 Menu bar
U Security
The Security setting allows you to operate HiVision in observation mode.
In the observation mode, HiVision only read accesses agents.
V Mark "Read Only".
V Click on OK to save the setting in the preferences file. The setting is
now effective.
To return to the normal operating mode from the observation mode, you
require write access to the preferences file.
V Mark "Read Only".
V Click on OK to save the setting in the preferences file. The setting is
now effective.
HiVision
74 Release 6.4 06/07
"HiVision" main window 4.1 Menu bar
4.1.2 Licenses
In normal HiVision mode, the license window under Configuration:Pre
ferences:HiVision Licenses is read-only.
Note: When a license key is edited, the appropriate field is highlighted in red.
On correct entry of the last character of the license key, the background color
changes from red to green.
HiVision
Release 6.4 06/07 75
"HiVision" main window 4.1 Menu bar
This means that the settings are transferred to all devices listed in the main
window. This applies to both selected as well as non-selected devices.
The Configuration window displays all parameters that can be set in any de-
vice that can be displayed in the window. Devices that only support a limited
number of parameters ignore the remaining parameters.
You can set shared status configurations for certain ports of different devices
in the multi-port manager (see “Port Manager/Port Analyzer” on page 83).
HiVision
76 Release 6.4 06/07
"HiVision" main window 4.1 Menu bar
Just how a status is evaluated is set in the configuration menu. These confi-
guration settings apply for the surface in which they are activated.
HiVision
Release 6.4 06/07 77
"HiVision" main window 4.1 Menu bar
The most critical status color in each case is forwarded to the next highest
level. If for example, the status color of a port is red, then the status symbol
of the device, to which this port belongs, is also displayed in red. If the status
symbol is yellow or red, then the bubble help displays the reason for this
status. The bubble help contains the causes of error/warning conditions
within the device. Here HiVision takes into account all the levels right down
to the detail level.
HiVision
78 Release 6.4 06/07
"HiVision" main window 4.1 Menu bar
Example: A terminal device is directly linked to a port of the MACK 3000 via
a TP cable.
When the terminal device is switched off, the port of the MACH 3000 identi-
fies a link error. The status of the link error is error . If the evaluation
error has been assigned in the configuration menu, then the port is presen-
ted in the color red (see Fig. 12).
Since a deactivated terminal device does not as a rule represent a serious
fault, a network administrator may less pay attention to this event. Therefore
he may assign the status link error an evaluation free to his choice. If he
assigns the evaluation Warning to the status link error the port will
get yellow when the terminal device is switched off.
HiVision
Release 6.4 06/07 79
"HiVision" main window 4.1 Menu bar
U Scan Range
The Configuration:Preferences:Scan Ranges dialog allows
you to set the IP address range that HiVision scans in the connected net-
work.
Mark "Scan the network during program start" to query the entire network
for agents in the IP address area when HiVision is started.
D "New" defines a new IP address area.
D "Duplicate“ creates a copy of a marked IP address area.
D With "Edit" you change the marked IP address area.
D With "Delete" you delete the marked table entry.
HiVision
80 Release 6.4 06/07
"HiVision" main window 4.1 Menu bar
Note: If the agent list is active, then HiVision additionally queries the
agents entered in the agent list during the program start.
U Device List
Saving the IP addresses found in the device list under Configura
tion:Preferences:Device List makes it possible for HiVision to
look specifically for these addresses after HiVision is restarted. This
makes HiVision start faster. Devices that are not found in the network,
although they are in the device list, are displayed in red. In the status line
HiVision displays the successfull loading of the device list.
The Configuration:Preferences:Device List dialog allows
you to enter devices in this list, and to remove them.
With the "left" arrow key you add the devices marked in the "Discovered
devices" list to the device list.
With the "right" arrow key you remove the devices marked from the
device list.
With the "Ping device" arrow key you add the devices marked in the "Dis-
covered devices" list to the device list as Ping devices.
With "Add device" you enter an IP address, which HiVision puts into the
device list.
Mark "Load device list on startup", to query the entire network for the
devices in the device list when starting HiVision.
Note: If the scanning areas are active, HiVision additionally queries the
devices in the IP address areas on startup.
HiVision
Release 6.4 06/07 81
"HiVision" main window 4.1 Menu bar
Note: If a router or gateway is displayed in the agent window, you are provi-
ded with a fairly comprehensive list.
V On the "Agents" filecard, select all agents or the agents to which you think
the devices with the MAC addresses you are looking for are connected.
V Click on "Update MAC address table". If you have marked "Load agent list
on startup" under Configuration:Preferences:Agent Handling,
then HiVision has already loaded the MAC addresses.
HiVision
82 Release 6.4 06/07
"HiVision" main window 4.1 Menu bar
V Click on MAC Address in the header line to sort the table by MAC
addresses.
Click the right-hand mousekey on the headline to open a search-window.
The ports can be shared by a number of devices. The ports of a device can
belong to different port groups.
V Mark
D the devices in the main window whose ports you want to group toge-
ther or
D the ports in the device window that you want to group together.
V With the menu item View:Remove Port, you can remove ports from the
list. When you open this window again, the ports appear again.
V To add more ports to the table, click on a table field with the right mouse
button and select Add Port in the context menu or click on a port in
a device window and pull it into the multi-port manager or multi-port
analyzer window.
HiVision
Release 6.4 06/07 83
"HiVision" main window 4.1 Menu bar
U Port Manager
The port manager allows you to enter the same settings for a number of
ports, even for all the devices, in one step.
V Mark the lines in which you want to enter settings.
V In the selection fields to the left of the table, select the settings you
wish to apply to all the lines marked.
V When you click on "Set" in the tool bar, HiVision sends the new set-
tings to the agents. You can change these settings individually at a la-
ter date with another port selection in the port manager, or per port in
the detail window.
Application example:
In the default setting of the port status configuration, the condition color
green is assigned to the condition symbol for a connection error.
This setting is logical if there is a terminal device connected to a port.
If there are connections to switches or hubs, then a connection error
represents a serious error, which must be treated as such.
Select the ports in the device window and click on "Port manager" in the
tool bar.
Mark the ports in the Port Manager window and select Configura
tion:Port Status Configuration in the menu bar.
Check the "Link" box and select the red condition symbol for the "Error"
condition. Click on "Accept" and then "OK".
With "Set" you transfer the settings to the agent. Click on "Start" to carry
out the transfer and on "Save" to save the settings permanently on the
agent.
HiVision
84 Release 6.4 06/07
"HiVision" main window 4.1 Menu bar
U Port Analyzer
In the port analyzer window you will find a table of the selected ports. It
contains the counter contents for
– Performance,
– Collisions and
– CRC errors.
V In the Type selection window, you specify which counter values are
displayed in the table.
V Click on Polling Interval to specify the interval at which the port analy-
zer queries the counter values.
The small interval shows in seconds the time interval at which the port
analyzer queries all the counters, with the exception of the collision
counter. The length of the small interval depends on the amount of
data to be queried. Because a query process can take a number of se-
conds, the value should be set at a minimum of 5 seconds.
The big interval shows in seconds the time interval at which the port
HiVision
Release 6.4 06/07 85
"HiVision" main window 4.1 Menu bar
The counter contents provide the expert with information about the struc-
ture of the network and allow him/her to detect any errors in the configu-
ration.
HiVision
86 Release 6.4 06/07
"HiVision" main window 4.1 Menu bar
With multi-device configuration, you can also load and save configurations in
the devices and carry out a software update.
The status column provides information on the success of the action carried
out:
D Green light:
Action successfully completed.
D Red light:
Action failed. The speech bubble help provides information on the cause
of the failure. With the "Repeat failed action" key, you can start the action
again after resolving the error. In this case, HiVision starts the action for
the devices for which the action failed.
D Blue light:
The device does not support the action.
Repeat
failed
action
HiVision
Release 6.4 06/07 87
"HiVision" main window 4.1 Menu bar
HiVision
88 Release 6.4 06/07
"HiVision" main window 4.2 Tool bar
The tool bar is located just below the menu bar. It is provided to simplify ope-
ration. The tool bar makes it unnecessary to open the various windows in or-
der to obtain a particular view.
File:Exit,
HiVision can also be exited by pressing the 'ESC' key.
File:Export...
s equivalent to double clicking the selected line in the device list and
opens the device window with detailed information on the device. This
tool is useful where several lines have been simultaneously selected
Edit:Acknowledge Events
Edit:Stop scanning
HiVision
Release 6.4 06/07 89
"HiVision" main window 4.2 Tool bar
View:Product Families
Edit:Port-Manager
Edit:Port-Analyzer
Tools:Telnet
Tools:Web Interface
VLAN Manager:Load...
VLAN Manager:Save...
VLAN Manager:New...
VLAN Manager:Delete...
User groups:Duplicate...
VLAN Manager:Edit...
Help:Program Info...
HiVision
90 Release 6.4 06/07
"HiVision" main window 4.3 Card index
U Multiple selection
Selection of several devices, which follow one another directly in the list:
V Select the first required device.
V Select the last required device with pressed shift key.
=>All devices which are between these two devices in the list, are sel-
ected. Previously made selections are cancelled.
Selection of individual devices from previously made selections:
V Select an individual device with pressed Ctrl key.
=>Changing the selection status of this device. Previously made
selections remain unchanged.
HiVision
Release 6.4 06/07 91
"HiVision" main window 4.3 Card index
U Device selection
The Edit menu item allows you to
D Add devices by entering the IP address (Add Agent).
D Add devices by querying the active address range again (Rescan).
D Add devices by scanning an IP address range (Rescan Range).
D Remove selected devices (Delete Device). HiVision deletes the
data set stored for this device.
Changes in the agent window have no effect on the event table (see
“Events” on page 96) and the agent list (see “Device List” on page 81).
HiVision
92 Release 6.4 06/07
"HiVision" main window 4.3 Card index
U Column topic
Click the column heading once and the card contents are sorted accor-
ding to column topic.
Column Meaning
Type Product family:
Industrial Line
Backbone Switch
Workgroup Switch
ETHERNET Hub
FDDI Hub
Rack Monitor
Ping device
Unknown
Status Device status (see “Status propagation” on page 77)
P Protocols to which the device responds. When you position the mouse poin-
ter on a symbol, a bubble displays details.
HiVision
Release 6.4 06/07 93
"HiVision" main window 4.3 Card index
Column Meaning
Product Product identifier or content of the MIB Variable System Description.
System Location Location of the device, any entry may be made.
System Name Name for identifying the device, any entry may be made.
Special Infos Overview of more detailed information.
SW Version Software version of the agent currently running.
Note: If the product field for a device is empty then it is likely that
− the access right is not unique (e.g. no SNMP community).
the first device in the device list which does not have the "unknown"
type in the device list is administered by HiVision even without a licence.
− the agent of the device is not licensed or
− the version number of the agent is not supported (see readme file).
U Search
The search function allows you to quickly find specific devices, IP
addresses etc.
You click with the right mouse button on a table field to open the applica-
ble context menu.
HiVision
94 Release 6.4 06/07
"HiVision" main window 4.3 Card index
HiVision first checks the device accessibility via SNMP. If a device is not
accessible via SNMP, then HiVision tries to access the device via ICMP.
With Edit:Add Device you can add non-SNMP-capable devices to
the device list. If you select Non-SNMP in the type field, then HiVision
assigns the "non-SNMP-capable device" symbol to this device.
U Device properties
V Click with the right mouse button on the line of the device, or on a num-
ber of marked devices, to open the relevant context menu. Select
Preferences.
D The "Device info“ tab page allows you to enter the content for the
device list.
D The "Protocols" tab page enables you to read and change the SNMP
parameter default values set by HiVision.
D The "Double-click action“ tab page enables you to select the action
which is called up by a double-click on the agent line. Example: with
the Web browser option for devices which have Web-based man-
agement, a double-click on the agent line opens the Web-based man-
agement screen directly.
For non-SNMP-capable devices, HiVision sets the default value to
Web browser.
HiVision
Release 6.4 06/07 95
"HiVision" main window 4.3 Card index
4.3.2 Events
This filecard shows
D all traps received from the management station
D inconsistancies in the network that HiVision detects with the aid of SNMP
queries
D information about the program execution of HiVision
HiVision evaluates the table entries and displays the effects in the individual
windows.
If the Log function is activated (see “Log files” on page 104) HiVision adds an
event entry to the protocol file as soon as it occurs.
U Event categories
In the list above the table you can mark specific event categories so that
they are not displayed in the table. HiVision still registers the event cate-
gories not displayed.
HiVision
96 Release 6.4 06/07
"HiVision" main window 4.3 Card index
U Table properties
D You click on the column header to sort the tab card contents in terms
of column subject.
D If you click with the right mouse button in a table field, you open a con-
text menu with search functions.
D You can delete selected entries by means of the recycle bin in the tool
bar.
D You can acknowledge selected entries by means of the bell in the tool
bar. HiVision displays acknowledged entries colourlessly in the
"Agents" tab card.
D You can simulate receiving an event again by selecting the entry in the
table and choosing Edit:Simulate Event. This function allows you
to test your event actions (see “Event actions” on page 100).
D The Edit menu item provides you with the following table-editing
functions:
– acknowledge selected events
– delete selected events
– acknowledge all events
– delete all events
– simulate receiving the selected event again
HiVision
Release 6.4 06/07 97
"HiVision" main window 4.3 Card index
U Table contents
For every event that occurs, HiVision enters a line in this table. Depen-
ding on the category selection, the event lines are either displayed or
invisible.
HiVision allows you to query (polling) device details regularly (see “Detail
polling” on page 129). The polling is active if there is an arrow next to the
symbol.
Column Meaning
Ack A tick here indicates that the user has confirmed this
entry.
Time Time the event ocurred in year/month/day/hour/minute/
second format plus a counter for events occuring within
the same second.
Cat Category the event belongs to.
Source Device causing the event message.
Component Device component causing the event message.
Message Name of the event.
Description Description of the event.
HiVision
98 Release 6.4 06/07
"HiVision" main window 4.3 Card index
U Protocol file
The Configuration:Preferences:Event Log dialog allows you to
D activate/deactivate the recording of all events in a file.
D change the default file name. HiVision completes the file name auto-
matically with the addition of .log.
D specify the maximum number of protocol entries per file. If the current
protocol file contains the maximum number of entries, then HiVision
sets up a new file. HiVision completes the file name with a counter
number. Example: HiViLog01.log, HiViLog02.log, etc.
D specify the maximum hard disc space the protocol files can use.
You can open the protocol file with Microsoft Excel or a text editor.
HiVision
Release 6.4 06/07 99
"HiVision" main window 4.3 Card index
V Click on "Clone". A window shows you a list of the events that have oc-
curred up to this point. Select the event you want and click on "OK". HiVi-
sion then automatically fills in the event definition fields in this window.
If the event you want is missing from the list, then fill in the fields
– Catagory,
– Source,
– Component,
– Message and
– Description
For this you must know the exact text message. If you enter "Wildcards"
(* and ?), you reduce the possibility of errors.
"Wildcards" also allows you to define an action for several events. If you
enter, for example, Port * for the component, then the event triggers the
action at all the ports of this source.
D Active
Mark this field if you want HiVision to carry out this action when the
event occurs.
D Category
In the selection window, select the event category that will trigger the
action.
D Source
In the selection window, select the source (HiVision or the IP address
of an agent) from which the event message will be received.
D Component
Enter the component (e.g. agent, module 1, port 2) that relates to the
event.
D Message
Enter the object ID and the object identifier of the required event, or
select a text from the selection window in this line.
D Description
Enter the description of the event. This is usually the description text
of the MIB variables.
HiVision
100 Release 6.4 06/07
"HiVision" main window 4.3 Card index
V In the following you specify the action to be carried out when the event
message is received.
D Action
Select the action from the selection field. The selection consists of:
– Sending SMS messages
– Sending e-mails
– Opening the information window on the network management stati-
on
– Executing a system command
D Action Message
Enter the message to be contained in, for example, an e-mail you want
to send. The bubble help shows you a variable you can include when
sending the mail.
Example:
"At $TIME, the $CATEGORY appeared in the $SOURCE."
D Timeout
Enter the time after which HiVision should stop trying to carry out the
action.
D Retries
Specify how often the timeout can occur before HiVision stops attemp-
ting to carry out the action.
D Allowing for the time period of an action
It takes a certain amount of time to carry out an action. For example,
sending an e-mail via the selection process takes considerably longer
than opening an information window.
If the same event recurs within the time period for an action, an error
message is generated.
By clicking on this field you avoid this error message. However, you do
not receive any information as to whether this event has occurred wi-
thin this action time period.
HiVision
Release 6.4 06/07 101
"HiVision" main window 4.3 Card index
HiVision
102 Release 6.4 06/07
"HiVision" main window 4.4 Status line
The status line at the bottom of the main window is divided into two areas:
D Status messages
D Symbol area
HiVision
Release 6.4 06/07 103
"HiVision" main window 4.4 Status line
Note: When the mouse pointer is positioned over a symbol, a bubble help
with an explanation of this symbol appears.
U Data transmission
The symbols provide information about the data transmission (traps and
SNMP queries) between agents and HiVision.
Note: When the lightning bolt in the trap symbol in the StandAlone version
is crossed out, then start the Trapdaemon (see “Program start” on page
29 and “Program start” on page 35).
U Platform change
With platform-integrated versions, an additional symbol makes it possi-
ble to change over directly to the platform.
U Log files
The colored display of this symbol indicates that events are saved in a
protocol file as they occur (see “Protocol file” on page 99.
HiVision
104 Release 6.4 06/07
Device window
5 Device window
HiVision
Release 6.4 06/07 105
Device window
When a device line is double-clicked in the main window, the associated de-
vice window opens with the accompanying ip address and, if available, the
device name in the head line.
In the managment shell there are additional possibilities to open the device
window of a selected device:
D select HiVision:OpenDevice in the menu bar or
D select HiVision:OpenDevice with the right-hand mouse button in the
context menu.
Note: If a device still does not appear in the main window of HiVision during
initialization, an earlier entry can be induced via the management shell. To
do so open the device window on the platform level with HiVision:Open
Device in the context menu for the symbol.
In the context menu the line HiVision:OpenDevice is missing, if the shell
has not identified the device as Hirschmann agent yet. To speed up identifi-
cation close HP OpenView / IBM NetView and enter the following lines:
ovstop↵
ovstart ovwdb↵
ovw -fields¿
ovstart ovtopmd↵
ovtopofix -u↵
ovstart↵
Restart HP OpenView.
The device window consists of a menu line, the tool bar, a card index with
five cards and the status line. The card index has 6 cards:
D Image
D Physical map
D Logical map (for unknown agents, MIKE and MultiMIKE agents)
D Device info
D Events
HiVision
106 Release 6.4 06/07
Device window
The status line is highlighted with the symbol on the right. The color and
the term show the status of the whole device:
Ok
Warning
Error
Note: The states of the symbols are determined when the device window is
opened.
The content of a device window is updated:
− when the interface cards equipment is changed
− after View:Reload
− when a trap with content which affects the symbol color is received.
– when the MAC address table is reloaded.
HiVision
Release 6.4 06/07 107
Device window 5.1 Tool bar
The tool bar is located just below the menu bar. It is provided to simplify ope-
ration. The tool bar makes it unnecessary to open the various windows in or-
der to obtain a particular view.
File:Print...
File:Export...
Edit:Port-Manager.
Edit:Port-Analyzer.
Edit:Acknowledge Events
View:Reload
HiVision
108 Release 6.4 06/07
Device window 5.1 Tool bar
Tools:Telnet...
Tools:Web Interface
Help:Program Info...
HiVision
Release 6.4 06/07 109
Device window 5.2 Image
5.2 Image
U Color symbols
The ports are overlayed color symbols. The status of the port is indicated
by the color as well as the form of the symbol:
HiVision
110 Release 6.4 06/07
Device window 5.2 Image
U Bubble help
When the mouse pointer is positioned on certain device parts, the asso-
ciated bubble help appears. It contains the most important status infor-
mation.
U Colored border
The symbols have colored borders.
The significance of each color corresponds to the color assginment (see
Table 12 on page 77) .
U Bubble help
When the mouse pointer is positioned on certain device parts, the asso-
ciated bubble help appears. It contains the most important status infor-
mation.
The bubble help for the symbol indicates the logical, physical and
SNMP states.
U Net number
“all” is the default. This means that all possible colored symbols are
superimposed at the ports on the device image.
Note: When a particular net number is selected, then symbols are just su-
perimposed on those ports associated with the selected net number.
HiVision
Release 6.4 06/07 111
Device window 5.2 Image
HiVision
112 Release 6.4 06/07
Device window 5.3 Physical Map
This index card shows a representation of the physical device in tree struc-
ture. It enables the cause of a status change to be identified.
Example: A link error occurs at a twisted pair port. Thereupon the status
symbol of the affected device goes red. A quick glance in the map shows im-
mediately which port is causing the status propagation.
U Bubble help
When the mouse pointer is positioned on certain device parts, the asso-
ciated speech bubble appears. It contains the most important status
information.
The bubble help for the symbol indicates the logical, physical and
SNMP states.
U MAC addresses
The MAC addresses are listed in addition to the port symbols. These
MAC addresses are associated with the devices, which are connected to
this port. If several devices are connected to one port, then the number
of devices connected appears in this field. You will obtain a list of all
MAC addresses by selecting “Security” with the right-hand mousekey on
the port (see page 120).
Special case TYDE and IYDE: The MAC addresses of all attached
devices are displayed at Port 1.
HiVision
Release 6.4 06/07 113
Device window 5.3 Physical Map
U IP addresses
The MAC- and IP-addresses are listed in addition to the port symbols.
These addresses are associated with the devices, which are connected
to this port. If several devices are connected to one port, then three dots
appear in this field. You will obtain a list of all addresses by selecting
“Security” with the right-hand mousekey on the port (see page 120).
In assigning MAC address to IP address, HiVision uses the IpNetToMe-
dia entries of the IP MIB on the agents in the network. You activate this
function by marking Load ipNetToMedia Tables on startup
under Configuration:Preferences:Agent Handling.
HiVision
114 Release 6.4 06/07
Device window 5.4 Logical Map
This card represents the logical design of unknown agents, MIKE and Multi-
MIKE agents. The assignment of port to interface is immediately recognizab-
le. HiVision fetches RMON 1 (Statistics) and 2 (History) at the interface level.
U Bubble help
When the mouse pointer is positioned on certain device parts, the asso-
ciated bubble help appears. It contains the most important status infor-
mation.
The bubble help for the symbol indicates the logical, physical and
SNMP states.
HiVision
Release 6.4 06/07 115
Device window 5.5 Device information
“Reload”: reloading from the agent MIB and updating the display
“Set”: fields with a white background can be edited. “Set” writes the
indicated values into the MIB of the agent.
HiVision
116 Release 6.4 06/07
Device window 5.6 Events
5.6 Events
The card shows the events for this agent. You will find more information on
the event window under “Events” on page 96.
HiVision
Release 6.4 06/07 117
Device window 5.7 Index
5.7 Index
The Index tab page allows you to find detailed information quickly that is
made available by the device window.
U Subject table
When you have found the term you want in the subject table, you can
double click on this line to go directly to the tab page of the device
window containing this term.
HiVision
118 Release 6.4 06/07
Detail window
6 Detail window
HiVision
Release 6.4 06/07 119
Detail window
Detail windows can be opened within the device window (image, physical
structure and logical structure cards) or at interface-card level, port level and
interface level or with an agent, chassis, power supply unit, fan or AutoCon-
figuration Adapter symbol. A drop-down menu is opened with the right hand
mousekey on a device detail. The selection of the required topic opens the
appropriate detail window.
Each topic represents a card index in the detail window. If a detail window is
open, then it is possible to switch directly to the next topic via the card
selection.
When a detail window is opened, HiVision polls the current values at the
agent. Attributes not supported by the agent are displayed by HiVision in red.
HiVision
120 Release 6.4 06/07
Detail window 6.1 Tool bar
The tool bar is located just below the menu bar. It is provided to simplify ope-
ration. The tool bar makes it unnecessary to open the various windows in or-
der to obtain a particular view.
File:Export...
Edit:Acknowledge Events
View:Reload
HiVision
Release 6.4 06/07 121
Detail window 6.1 Tool bar
Tools:Telnet...
Configuration:Polling configuration...
Help:Program Info...
HiVision
122 Release 6.4 06/07
Detail window 6.2 Information presentation
You receive detailed information of the device at all levels, e.g. agents, chas-
sis, card, port, power supply and fan level.
For this the Hirschmann agents put a whole series of counters and tables.
This allows an analysis of network events down to the layer 1 of the ISO/OSI
base reference model. The extensive configuration possibilities permit an in-
dividual customization to your own network environment.
HiVision
Release 6.4 06/07 123
Detail window 6.2 Information presentation
U Setting
Under Edit:PreferencesÉ you will find entry fields for the:
– Log to file
– Path name of a log file
– Polling interval. When starting the Grapher, it accepts the value that
has been set under
Configuration:SNMP Configuration
– Duration of the data storage.
U Representation
The SNMP monitor provides the table values. The following display
options are available:
– Line diagram or bar diagramm,
– Pie chart and
– Table.
In the line/bar diagram you can change the horizontal scale with Zoom
in and Zoom out. To enlarge the scale, click the scroll bar at the top or
bottom and drag it in a vertical direction.
HiVision
124 Release 6.4 06/07
Detail window 6.2 Information presentation
Fig. 17: Example for the display of the performance on port level with
graphic representation (platform version)
U Log files
The Grapher offers three methods for creating log files:
D File:SaveÉ saves the table contents as a text file.
D Edit:Copy copies the table contents onto the (Clipboard).
D Edit:Preferences writes the table values to the log file on an on-
going basis.
HiVision
Release 6.4 06/07 125
Detail window 6.2 Information presentation
1 iso
3 org
6 dod
1 internet
4 pr
2 mgmt
1 mib-2
16 rmon
1 statistics
2 history
3 alarm
9 event
Polling with RMON 1 and 2 always takes place at a device interface. HiVision
presents device interfaces of Hirschmann switches in the "Physical struc-
ture". For all other agents, the device interface is presented in the “logical
structure” in the device window (see “Logical Map” on page 115). Switches
directly link interface and port. RMON 1 and 2 are therefore also available at
port level.
Configuration of alarms and eventsfor any variables (RMON 3 and 9) takes
place at agent level.
HiVision
126 Release 6.4 06/07
Detail window 6.2 Information presentation
Hinweis: In order to make RMON 2, 3 and 9 functions available, you will re-
quire write entitlement for the agent.
Starting from the device window, selecting "Security" in the context menu
of the agent symbol opens the agent window.
The choice of an RMON alarm in the filecard Security indicates the adju-
stable parameters (see Fig. 19).
HiVision
Release 6.4 06/07 127
Detail window 6.2 Information presentation
HiVision
128 Release 6.4 06/07
Detail window 6.2 Information presentation
The "Event" card in the device window lists the status changes. Apart from
the message indicating which result led to the change in status, HiVision also
stamps the time of the change.
HiVision
Release 6.4 06/07 129
Detail window 6.2 Information presentation
HiVision
130 Release 6.4 06/07
Detail window 6.3 Configuration settings
HiVision
Release 6.4 06/07 131
Detail window 6.3 Configuration settings
HiVision
132 Release 6.4 06/07
Detail window 6.3 Configuration settings
U HIPER-Ring
Before you start configuring a HIPER-Ring you specify
D all the switches in the HIPER-Ring
D the ringports of the individual switches
D the switch that assumes the redundancy manager function. A single
active redundancy manager (RM) controls the HIPER-Ring function in
a HIPER-Ring.
HiVision
Release 6.4 06/07 133
Detail window 6.3 Configuration settings
Setting Meaning
Mode create, to make an entry.
Red. board Slot number of the redundant port
Red. port Port number of the redundant port in the format module.port.
HiVision
134 Release 6.4 06/07
Detail window 6.3 Configuration settings
HiVision
Release 6.4 06/07 135
Detail window 6.3 Configuration settings
HiVision
136 Release 6.4 06/07
Detail window 6.3 Configuration settings
U General
This dialog is for displaying general parameters and for setting the TTL
(time to live). The ICMP TTL Exceeded parameter enables you to
prevent this message from being sent (disable).
Entering a DHCP server IP address activates the BOOTP/DHCP relay
agent. It allows you to work mit BOOTP/DHCP across IP subnet
boundaries.
U IP Interfaces
This dialog allows you to configure the IP interfaces of the router.
D Index: serial number for the identification of an interface.
D Name: name of your choice for an interface.
D IP adress: IP address of the interface.
D Network mask: network mask for the network with which the inter-
face is connected.
D Vlan ID: assignment to a VLAN.
D Admin Status: switch (on/off) for the interface.
D Oper Status: operating status of the interface. If there is no router
module, then there are no ticks in this column.
Note: Agent and router interfaces have their own individual IP addresses.
By means of a router, the agent is accessible from other subnetworks. A
pre-condition of this is that the interface of the routers must be connected
to the subnetwork of the agent (IP interfaces). Thus the router can forward
data packets from other subnetworks to the agent.
If for security reasons you want to protect the agent from being accessed
from other subnetworks, then allocate to the agent a subnetwork not con-
nected to any interface of the router module. In this case, the Gateway
entry is no longer valid for the agent.
Note: The subnetwork of the router interface and the PPP settings must
not overlap.
HiVision
Release 6.4 06/07 137
Detail window 6.3 Configuration settings
Note: If you intend to set up a router redundancy, you will have the option
of entering the table contents of the "IP Interface" dialog in the "Router
Redundancy" dialog. HiVision then accepts the entries made in the "Rou-
ter Redundancy" dialog in the "IP Interfaces" dialog.
U ARP Table
As with every other terminal device, the router obtains the IP addresses
within the connected (sub)networks with the aid of the Address Resolu-
tion Protocol (ARP).
The ARP table contains the allocation of MAC address to IP address and
provides space for up to 8192 (2048) ARP entries.
The Third column enables you to assign a type to entries in this table.
D other: unknown type.
D invalid: with a click on Write you delete this entry.
D dynamic: the age of this entry is monitored continuously, and it can
be changed by means of routing protocols. This entry is deleted when
you restart, or 10 minutes after the last transmission to this address.
D static: this entry is not subject of age monitoring and is no longer
available after a restart.
U Routing table
The entries in the routing table specify to which IP interface a received
data packet is sent.
HiVision
138 Release 6.4 06/07
Detail window 6.3 Configuration settings
The static routing table supports up to 256 entries for network routes,
and up to 1024 entries for host routes.
When the routing interface receives a data packet, the router module first
looks in the routing table for an entry with the host IP target address. If
this entry does not exist, then the router module looks for an entry with
the network mask. The last opportunity for transmitting the data packet is
to send it to the IP address entered as a default gateway. If this entry
does not exist either, then the data packet is not transmittable, and the
sender is informed of this via ICMP.
HiVision
Release 6.4 06/07 139
Detail window 6.3 Configuration settings
You enter the settings for the router redundancy in the detail window of the
router. With a double-click on the router module in the device window you
enter the "Configuration" detail window.
V "General" dialog
Carry out a general router configuration (see “General” on page 137).
With "Set" HiVision transfers the settings to the agent.
HiVision
140 Release 6.4 06/07
Detail window 6.3 Configuration settings
U Application example:
The following example shows the main components and settings for cor-
rectly configuring the HiRRP function.
Subnet 2 Subnet 4
149.218.20.xyz 149.218.30.xyz
149.218.20.13 149.218.30.13
Router 1 Router 2
Router/Switch 149.218.10.101 149.218.10.201 RouterSwitch
MACH 3002 MACH 3002
HiVision
Release 6.4 06/07 141
Detail window 6.3 Configuration settings
HiVision
142 Release 6.4 06/07
Detail window 6.3 Configuration settings
IP address: 149.218.20.13
Subnet mask:255.255.255.0
Default Gateway: 149.218.20.1
SN 2
SN 1 VLAN Green
Router 2
MACH 3002
Router/Switch
RouterSwitch
MACH 3002
Router 1
IP address: 149.218.30.13
Subnet mask:255.255.255.0
Default Gateway: 149.218.30.1
VLAN Blue
Switch = SN 4
MACH 3002
SN = Subnet
HiVision
Release 6.4 06/07 143
Detail window 6.3 Configuration settings
HiVision
144 Release 6.4 06/07
Detail window 6.4 Index
6.4 Index
The Index tab page allows you to find detailed information quickly that is
made available by the device window.
U Subject table
When you have found the term you want in the subject table, you can
double click on this line to go directly to the tab page of the device
window containing this term.
HiVision
Release 6.4 06/07 145
Detail window 6.4 Index
HiVision
146 Release 6.4 06/07
VLAN manager
7 VLAN manager
HiVision
Release 6.4 06/07 147
VLAN manager
To create and manage VLANs you must first have worked out a VLAN
concept.
VLANs can also be configured virtually, which means that configuration can
take place in HiVision before the final hardware installation of the devices.
HiVision
148 Release 6.4 06/07
VLAN manager 7.1 The function of the VLAN manager
HiVision
Release 6.4 06/07 149
VLAN manager 7.1 The function of the VLAN manager
HiVision
150 Release 6.4 06/07
VLAN manager 7.1 The function of the VLAN manager
Group yellow
A B
VLAN ID = 2
C
Group brown
VLAN ID = 3 D
Group green,
VLAN ID = 1
VLAN ID = 4 VLAN ID = 6
Group yellow,
VLAN ID = 2
G E
F
VLAN ID = 5
Group green
HiVision
Release 6.4 06/07 151
VLAN manager 7.1 The function of the VLAN manager
D Search function
To search for particular entries in a table, right-click on a field in the hea-
der line.
D Edit field
Double-click a field in a table to edit it. HiVision will then open the appro-
priate window.
D Shortcut menu
Right-click on a field in a table to open a shortcut menu to help you edit it.
D Sort function
Click on a field in the table header line to sort the table.
D Simultaneously editing several lines
Use "Ctrl" or the "Shift" key to select several lines in a table for editing.
HiVision enters the modified values in all the selected lines. Fields marked
ignore remain unchanged.
- Menu bar
- Toolbar
- Filecards
- View
HiVision
152 Release 6.4 06/07
VLAN manager 7.1 The function of the VLAN manager
HiVision
Release 6.4 06/07 153
VLAN manager 7.2 Port-based VLANs
VLAN yellow
VLAN green
149.218.32....
MACH 3002
...100
...101
port ...100:1
VLAN green
VLAN yellow
port ...110:1
149.218.32....
MACH 3002
...110
HiVision
154 Release 6.4 06/07
VLAN manager 7.2 Port-based VLANs
HiVision
Release 6.4 06/07 155
VLAN manager 7.2 Port-based VLANs
V Highlight the agents you require in the right-hand column and click the left
arrow button with the port icon to move them to the left-hand column.
If you click the right arrow button, the highlighted line in the left-hand co-
lumn is deleted.
HiVision shows the agents' ports in the middle of the VLAN Manager win-
dow.
HiVision
156 Release 6.4 06/07
VLAN manager 7.2 Port-based VLANs
Note: For the GES 24TP Plus always enter all available ports.
HiVision
Release 6.4 06/07 157
VLAN manager 7.2 Port-based VLANs
V If you want to enter the VLAN ID yourself, select Override and enter the
VLAN ID.
V A cross in the Default group checkbox identifies the group to which all
ports are assigned if they are not assigned to a group.
V On the Members filecard you can select the ports which will belong to the
group.
V Select Action: Add and click OK. HiVision assigns the selected ports to
the group (see Fig. 38).
HiVision
158 Release 6.4 06/07
VLAN manager 7.2 Port-based VLANs
U Uplink
V Click on the Edit field on the VLAN Manager filecard and select VLAN
ports.
V Select the lines of the ports which are provided for linking different
switches.
V Right-click in the Role field and select Edit.
Uplink
The port supports GVRP.
The port transmits frames from VLAN 1 without tag and frames of
other VLANs with tag.
HiVision
Release 6.4 06/07 159
VLAN manager 7.2 Port-based VLANs
HiVision
160 Release 6.4 06/07
VLAN manager 7.2 Port-based VLANs
Note: Do not transmit the settings to the agents before you have made sure
that your network management station still has access with these settings.
The network management station needs access to the port to which you are
connected, so that you can continue making configurations in the network.
Note: With MACH 3000 and GRS HiVision switches off the Spanning Tree
algorithm at all ports except Uplink ports.
HiVision
Release 6.4 06/07 161
VLAN manager 7.2 Port-based VLANs
Note: If you expressly wish to have the Spanning Tree algorithm at an Uplink
port, then check this setting.
HiVision
162 Release 6.4 06/07
VLAN manager 7.3 MAC-based VLANs
HiVision
Release 6.4 06/07 163
VLAN manager 7.3 MAC-based VLANs
Group yellow
149.218.32. A
MACH 3002 B
100
C
101
D
port 100:1
Group brown
G E
port 110:1 F
149.218.32.
MACH 3002
110
HiVision
164 Release 6.4 06/07
VLAN manager 7.3 MAC-based VLANs
V Highlight the MACH 3000s you require in the right-hand column and click
the left arrow button without the port icon to move them to the left-hand
column.
If you click the right arrow button, the highlighted line in the left-hand co-
lumn is deleted.
HiVision
Release 6.4 06/07 165
VLAN manager 7.3 MAC-based VLANs
HiVision
166 Release 6.4 06/07
VLAN manager 7.3 MAC-based VLANs
HiVision
Release 6.4 06/07 167
VLAN manager 7.3 MAC-based VLANs
If you have already defined the groups and port access rights, then you can
still assign the group membership and port access rights in this window. On
initial configuration it is easier to perform these settings later.
– Filecard
– Action selection
V To identify your network management station, mark it and click the right
mouse button. Select Mgmt stations.... Note that HiVision assigns
the VLAN with the ID 1 to the network management station's group. This
means all devices in the same group are also assigned to the VLAN with
the ID 1 (see “The network management station as a user” on page 153).
HiVision
168 Release 6.4 06/07
VLAN manager 7.3 MAC-based VLANs
V A cross in the Default group checkbox identifies the group to which all
stations are assigned if they are not assigned to a group.
V On the Members filecard you can select the stations which will belong to
the group.
HiVision
Release 6.4 06/07 169
VLAN manager 7.3 MAC-based VLANs
V Under Security specify whether the stations in the group can be con-
nected to any port – select Unbound – or certain ports only – select
Bound.
This setting is important for devices which, for security reasons, may not
be replicated without authorization.
Groups whose stations are often used in different places should be given
the setting Unbound.
V Under Security specify how the agent reacts in the event of an access
violation.
HiVision
170 Release 6.4 06/07
VLAN manager 7.3 MAC-based VLANs
U Uplink
V Click on the Edit field on the VLAN Manager filecard and select Port
security.
V Select the lines for the ports with the same connection type.
V Right-click in the AC field and select Edit.
HiVision
Release 6.4 06/07 171
VLAN manager 7.3 MAC-based VLANs
Uplink
The port supports GVRP.
The port transmits frames from VLAN 1 without tag and frames of
other VLANs with tag.
User
Only non-tagged packets are transmitted. The port only accepts
those stations selected under Allowed stations.
Group
Only non-tagged packets are transmitted. The port only accepts the
group selected under Allowed groups.
HiVision
172 Release 6.4 06/07
VLAN manager 7.3 MAC-based VLANs
Known
Only non-tagged packets are transmitted. The port only accepts
those stations entered in the switch's forwarding list.
World
Only non-tagged packets are transmitted. The port allows access for
all stations.
HiVision
Release 6.4 06/07 173
VLAN manager 7.3 MAC-based VLANs
HiVision
174 Release 6.4 06/07
VLAN manager 7.3 MAC-based VLANs
Note: Do not transmit the settings to the agents before you have made sure
that your network management station still has access with these settings.
The network management station needs access to the port to which you are
connected, so that you can continue making configurations in the network.
Note: With MACH 3000 HiVision switches off the Spanning Tree algorithm at
all ports except Uplink ports.
HiVision
Release 6.4 06/07 175
VLAN manager 7.3 MAC-based VLANs
Note: If you expressly wish to have the Spanning Tree algorithm at an Uplink
port, then check this setting.
The network management station sends the same user and group informati-
on to each agent.
Each agent receives the port security data which is relevant to it.
Transmission sta-
tus:
Yellow - active
Red - transmission
error
Green - transmissi-
on completed
Once the transmission has been completed, the transmission status indicator
flashes and the window is closed. After the transmission has been completed
this user group management configuration is active.
HiVision
176 Release 6.4 06/07
VLAN manager 7.4 VLAN configuration example
149.218.19.76
GES-24TP Plus
Network Management
Station
VLAN yellow VLAN green
VLAN brown
ID = 1
149.218.19.208
MACH 3002
HiVision
Release 6.4 06/07 177
VLAN manager 7.4 VLAN configuration example
HiVision
178 Release 6.4 06/07
VLAN manager 7.4 VLAN configuration example
HiVision
Release 6.4 06/07 179
VLAN manager 7.4 VLAN configuration example
V Highlight the agents you require in the right-hand column and click the left
arrow button with the port icon to move them to the left-hand column.
HiVision
180 Release 6.4 06/07
VLAN manager 7.4 VLAN configuration example
U Creating groups
HiVision
Release 6.4 06/07 181
VLAN manager 7.4 VLAN configuration example
HiVision
182 Release 6.4 06/07
VLAN manager 7.4 VLAN configuration example
Fig. 54: Creating the yellow and green groups in the same way as the brown
group
HiVision
Release 6.4 06/07 183
VLAN manager 7.4 VLAN configuration example
U Uplink
HiVision
184 Release 6.4 06/07
VLAN manager 7.4 VLAN configuration example
HiVision
Release 6.4 06/07 185
VLAN manager 7.4 VLAN configuration example
Fig. 58: Highlighting the management connection port and selecting "Mgmt
stations"
HiVision
186 Release 6.4 06/07
VLAN manager 7.4 VLAN configuration example
HiVision
Release 6.4 06/07 187
VLAN manager 7.4 VLAN configuration example
HiVision
188 Release 6.4 06/07
VLAN manager 7.4 VLAN configuration example
HiVision
Release 6.4 06/07 189
VLAN manager 7.4 VLAN configuration example
HiVision
190 Release 6.4 06/07
VLAN manager 7.4 VLAN configuration example
HiVision
Release 6.4 06/07 191
VLAN manager 7.4 VLAN configuration example
HiVision
192 Release 6.4 06/07
Creating a PSM
8 Creating a PSM
HiVision
Release 6.4 06/07 193
Creating a PSM
HiVision
194 Release 6.4 06/07
Creating a PSM
This chapter explains how to create a PSM using the BinTec X1000 routers
as an example.
HiVision
Release 6.4 06/07 195
Creating a PSM 8.1 Preparation
8.1 Preparation
HiVision
196 Release 6.4 06/07
Creating a PSM 8.1 Preparation
– "Traps" cards
The "Traps" card shows the traps received from HiVision.
Depending on the product, you can omit the card or define new ones.
HiVision
Release 6.4 06/07 197
Creating a PSM 8.1 Preparation
Cards
Device image
Symbols for
Device functions
(parts)
As a rule, these cards are divided into a left and right area. The left side
displays a tree for selecting details that are displayed on the right-hand
side. HiVision provides two way to display these details:
– List display and
– Dialog display
HiVision
198 Release 6.4 06/07
Creating a PSM 8.1 Preparation
The list display is to be used when you wish to have lines displayed as in
a table.
The dialog display is designed for those cases in which you wish to view
and edit a single-column matrix.
HiVision
Release 6.4 06/07 199
Creating a PSM 8.1 Preparation
HiVision
200 Release 6.4 06/07
Creating a PSM 8.2 Creating a PSM structure
V Open HiVision.
HiVision
Release 6.4 06/07 201
Creating a PSM 8.2 Creating a PSM structure
V Enter the name of the PSM after Name. HiVision uses this name to create
the directory structure.
Enter the type designation after Agent identifier. Put a prefix before
the type designation that uniquely identifies the manufacturer. The prefix
"Hm" is reserved for Hirschmann.
Enter the system object identification (SysOID) of the product from the sy-
stem table after Agent sysObjectID.
Check As simple as possible, if you want your PSM to include only
a limited number of few functions. HiVision then combines the files
Agent.xml, AgentDialog.xml and Component.xml into one file
(see Fig. 74).
V Click OK.
The newly created PSM appears in blue in the column of available PSMs
in the PSM Configuration window. The blue color indicates that HiVision
has not yet loaded this PSM. Select the PSM and click the arrow pointing
left. The PSM also appears in blue in the left column. HiVision will load
this PSM when you restart the program.
In the meantime, HiVision has created the proper directory structure with the
template in the HiVision directory. The templates already contain the values
that you entered in New PSM window.
HiVision
202 Release 6.4 06/07
Creating a PSM 8.2 Creating a PSM structure
HiVision
|Ðdata
| |ÐBinTec
| | |Ðbitmap
| | | |ÐBinTec.xpm
| | |Ðconfig
| | | |ÐAgent.xml
| | | |ÐAgentDialog.xml
| | | |ÐComponent.xml
| | | |ÐProductFamily.xml
| | | |ÐPsmInfo.xml
| | | |ÐSysOidList.xml
| | |Ðdoc
| | |Ðimage
| | | |ÐX1000.jpg
| | |Ðmib
V Quit HiVision.
V Copy the private MIBs into the mib folder (see Fig. 74).
V Copy the standard MIBs that have not yet been loaded into the mib folder
(see Fig. 74).
Standard MIBs that are loaded by HiVision are located in the HiVisi
on\data\kernel\mib folder.
HiVision
Release 6.4 06/07 203
Creating a PSM 8.2 Creating a PSM structure
HiVision
204 Release 6.4 06/07
Creating a PSM 8.3 Agent in the main window
HiVision displays each agent in a line of the main window. The largest part of
the display is taken up by HiVision polling the MIB variables of the agent. The
display for the product family and the product name is defined in the PSM.
HiVision
Release 6.4 06/07 205
Creating a PSM 8.3 Agent in the main window
HiVision
206 Release 6.4 06/07
Creating a PSM 8.4 Agent in the Device window
8.4.1 Cards
The AgentDialog.xml template already describes the HiVision standard
cards. Modify the "AgentDialog.xml" on page 224 file to fit your needs.
HiVision
Release 6.4 06/07 207
Creating a PSM 8.4 Agent in the Device window
HiVision
208 Release 6.4 06/07
Creating a PSM 8.5 Agent window
The "AgentDialog.xml" on page 224 file describes how the agent appears in
HiVision:
– Agent window,
– Device window,
– Agent dialog boxes,
– Dialog boxes of the symbols for device functions.
HiVision
Release 6.4 06/07 209
Creating a PSM 8.6 Editing PSM files
As the file structure(see Fig. 74) shows, there are 7 files to be edited. These
include configuration files in the XML format and also bitmap files.
The files in the XML format (V1.0) can be edited with a text or XML editor.
The DTD files that describe the structure of the XML files, i.e. describe the
visual text representation, are contained in HiVision.
The logical structure of the contents of the XML files consists of the definition
of elements. An element can possess several attributes. Attributes are assi-
gned a value:
<Element1 Attribute1="Value1" Attribute2="Value2" ></Element1>
These lines create the element Element1 with the attributes Attribute1
and Attribute2.
HiVision
210 Release 6.4 06/07
Creating a PSM 8.6 Editing PSM files
Tables in the sections for the individual files contain the possible elements
and attributes.
The "Mandatory" column indicates whether the element /attribute is required
in the file or can be used optionally.
Note: If the meaning column contains a default value, the entry is then requi-
red, but HiVision eliminates the need for entering an attribute. In this case,
HiVision accepts the default value. In the example above, you are required
to enter the attribute Type since the default value (Config), (see Table 23
on page 214) does not correspond to the value (Mib).
HiVision
Release 6.4 06/07 211
Creating a PSM 8.6 Editing PSM files
8.6.1 PsmInfo.xml
After opening the PsmInfo.xml file, check to make sure that HiVision has
prepared the contents of the file as far as possible.
<PsmInfoName="BinTec"
Version="1.0"
Copyright="Copyright 2001 Hirschmann Electronics .."
Description="Definition of BinTec Router Agents">
<File Name="mibbipx.mib"Type="Mib"/>
<File Name="mibbospf.mib"Type="Mib"/>
<File Name="mibbox.mib"Type="Mib"/>
<File Name="BnTcFamily.xml"Type="Config"/>
<File Name="SysOidList.xml"Type="Config"/>
<File Name="BnTcAgent.xml"Type="Config"/>
<File Name="BnTc_component.xml"Type="Config"/>
<File Name="BnTc_dialog.xml"Type="Config"/>
<File Name="BnTc_outname.xml"Type="Config"/>
</PsmInfo>
V List all file names of the MIBs that you have copied into the mib folder
8.2.1MIB files.
Pay particular attention to the order. HiVision reads the MIBs in the order
they are listed in this file. A MIB that, for example, imports another MIB,
cannot be loaded until the imported MIB has been loaded.
HiVision
212 Release 6.4 06/07
Creating a PSM 8.6 Editing PSM files
Agent file
This file contains the general description of the agent of the PSM pro-
duct. Name the agent.xml template according to its agent (Example:
BnTcAgent.xml). If the PSM contains several agents, you can copy
this file with the name of another agent or describe several agents in a
single file.
Component file
This file contains the list of the product images. Name the compo
nent.xml template according to its agent (Example:
BnTc_Component.xml).
HiVision
Release 6.4 06/07 213
Creating a PSM 8.6 Editing PSM files
Translation file
This file contains a list of terms for display in HiVision with the translation
into the language used. Name the LanguageTable.conf template
according to its agent (Example: BnTc_LanguageTable.conf). If the
PSM contains several agents, you can add a copy of this file with the
name of another agent or describe several agents in a single file.
This file can be omitted if you only want to display agent-specific terms in
a single language.
List all files that belong to your PSM in the PsmInfo.xml file.
Manda- Num-
Element Attribute Meaning tory ber
PsmInfo Defines PSM (name, version, ...) and names 1
files that belong to the PSM
Name Name of the PSM yes
Version Version number of the PSM yes
Description Brief description of the PSM yes
Copyright Copyright string yes
File Subelement of PsmInfo any
List of files that belong to the PSM
Name File name yes
Type Type of the file. Possible are: optional
Mib, Config or Language default: Config
and with HiVision 6.1 additionally: Manual and
Readme
HiVision
214 Release 6.4 06/07
Creating a PSM 8.6 Editing PSM files
8.6.2 Productimage.jpg
This file represents the gray-level image of the product.
Place the product image of "Image file" on page 200 in the image folder (see
Fig. 74). If several products belong to the PSM, place all the image files of
this PSM in this folder.
8.6.3 SysOidList.xml
The system object identification list (SysOid) contains the names of the pro-
ducts that belong to this PSM and are to be detected by HiVision. If HiVision
detects a known SysOid during a network scan, HiVision creates a record for
this agent with this agent type.
<Resources>
<AgentSysOid
SysOid="1.3.6.1.4.1.272.4"
AgentID="BnTcX1000" />
</Resources>
V HiVision has already entered the name and the SysOid of the product in
the file that you entered when you created the new PSM.
If the PSM is to contain more than this product, add one element to this
file for each new product.
<Resources>
<AgentSysOid
SysOid="1.3.6.1.4.1.272.4"
AgentID="BnTcX1000" />
<AgentSysOid
SysOid="1.3.6.1.4.1.xy.4"
AgentID="Phantastic" />
</Resources>
HiVision
Release 6.4 06/07 215
Creating a PSM 8.6 Editing PSM files
Table 24: Element list for the system object identification list
8.6.4 ProductFamily.xpm
HiVision display the symbols of the product family which the agent in this line
belongs to in the left column of the agent card in the main window.
V Create a bitmap file that displays the symbol for each product family.
Save the bitmap file in the XPM or BMP format in the bitmap folder.
HiVision places an XPM template in the bitmap folder.
The file has a size of 20 x 20 pixels.
Transparent surfaces for the status display are possible for files in the
XPM format.
HiVision
216 Release 6.4 06/07
Creating a PSM 8.6 Editing PSM files
8.6.5 ProductFamily.xml
In the main window, HiVision displays the symbols of the product family
which the agent in this line belongs to in the left column of the agent card.
<Resources>
<ProductFamily
ProductFamilyID="BnTcBinTec-Router"
Label="BinTec-Router"
Symbol="BnTcRouter.xpm"
SortIndex="210" />
</Resources>
V Enter the product family name after Label that is to be displayed in HiVi-
sion. HiVision displays the product name in a speech bubble once you
place the mouse pointer on the symbol.
V Enter the name of file that contains the symbol of the product family after
Symbol(see "ProductFamily.xpm" on page 216).
V Enter a whole number with which you can influence the sort order in the
main window of HiVision after SortIndex.
The permissible number range is 200 to 999. The smaller the number, the
higher the agent appears in the list.
V If your PSM contains more that one product family, enter an element for
each product family.
HiVision
Release 6.4 06/07 217
Creating a PSM 8.6 Editing PSM files
8.6.6 Agent.xml
This file describes the line of the agent of the product as it appears in the
main window of HiVision and determines the status display. The status dis-
play also includes the symbols in the status line of the Device window as well
as the definition of the status forwarding.
<!-- XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX-->
<!-- X Definition Main windowX-->
<!-- XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX-->
<AgentAgentID="BnTcX1000"
ProductFamilyID="BnTcBinTec-Router"
ChassisVar="sysDescr.0"
ProductVar="sysDescr.0"
SwVersionVar="biboAdmSWVersion.0"
SupportsTelnet="Yes"
CalcPhysState="Yes"
PhysStateName="Physical State">
The upper section of this files describes the agent line in the main window.
This is where you determine what is to appear in the columns of the agent
line, whether HiVision activates the Telnet function and how HiVision for-
wards the physical status.
The lower section of this file describes the symbols for the device-specific
functions (parts). Here you determine which file contains the symbol, what
the symbol is to be called, and from which MIB variables the status of the
symbol is calculated.
<!-- XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX-->
<!-- X Definition symbols of device functionsX-->
<!-- XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX-->
<PartPartID="LAN_Button"
Label="$$LANSTATUS"
Symbol="LAN.xpm"
Instance="3"
ExprAvailable="ifOperStatus.1000.3!=0">
<PartStatus
Name="LAN-Status"
ExprOk="ifOperStatus.1000.3==1"
ExprWarning="ifOperStatus.1000.3==5"
ExprError="ifOperStatus.1000.3==2"
/>
HiVision
218 Release 6.4 06/07
Creating a PSM 8.6 Editing PSM files
</Part>
<PartPartID="ISDN_Button"
Label="$$ISDNSTATUS"
Symbol="ISDN.xpm"
Instance="7"
ExprAvailable="ifOperStatus.10001.7!=0">
<PartStatus
Name="ISDN-Status"
ExprOk="ifOperStatus.10001.7==1"
ExprWarning="ifOperStatus.10001.7==5"
ExprError="ifOperStatus.10001.7==2"
/>
</Part>
</Agent>
The following list contains the definition of the possible elements and
attributes:
Manda-
Element Attribute Meaning tory Number
Agent Agent definition any
AgentID String for communication with the agent yes
(AgentDialog.xml).
ProductFamilyID Assigns the agent to this family. To set this yes
value, see ProductFamily.xml
ChassisVar This variable holds the chassis name. HiVi- optional
sion displays this name in the "Product"
column of the main window.
ChassisFix Permanent assignment of the chassis optional
name. HiVision displays this name in the
"Product" column of the main window.
ChassisFix Formula for chassis name optional
DialogSelectVar Selects a product version. optional
SwVersionVar This variable holds the software version. optional
ShowSpecialInfo Possible: Yes or No, default: Yes optional
SupportsTelnet Supports the Telnet agent. Enter 'Yes' so optional
that HiVision activates the menu item,
Possible: Yes or No, default: No
Supports Web If the agent supports Web-based manage-
ment, then enter Yes so that HiVision activa-
tes the menu item (in HiVision 6.1 and
upwards:
Possible: Yes or No, default: No)
HiVision
Release 6.4 06/07 219
Creating a PSM 8.6 Editing PSM files
Manda-
Element Attribute Meaning tory Number
CalcPhysState Calculate physical status, optional
Possible: Yes or No, default: No
PhysStateName Name of the physical status to be displayed optional
in the speech bubble help,
default: physical state
CalcLogState Calculate logical status, optional
Possible: Yes or No, default: No
LogStateName Name of the logical status to be displayed in optional
the speech bubble help,
default: logical state
GeneratePorts A port is generated for each interface. optional
The device must have interfaces.
Possible: Yes or No
Default: No
MaxPortNumber This is the maximum number a port can optional
have. If the number is exceeded, no port is
generated. This prevents ports being crea-
ted for internal interfaces (Router, Vlan, ...).
PortIfIndexFor- Formula for calculating the port number optional
mula from the interface index. This port number is
internal (not for display) and is used by
some agents, e.g. in private MIBs, for
instantiation.
PortNoFormula Formula for calculating the port numbers optional
(for display) from the interface index
Example: "((InterfaceIndex-1)%64)+1"
IF index from 1-64 on card 1, from 65-127
on card 2, etc.
CardNoFormula Formula for calculating the card number optional
(for display) from the interface index
Example: "(IntCast((InterfaceIndex-1)/
64))+1"
IF index from 1-64 on card 1, from 65-127
on card 2, etc.
SupportsIfMau- For Port Manager: If-Mau-MIB is supported optional
Mib Possible: Yes or No
Default: No
VlanManDriver Driver for Vlan Manager optional any
Possible: None, Dot1q, FastIron
Default: None
HiVision
220 Release 6.4 06/07
Creating a PSM 8.6 Editing PSM files
Manda-
Element Attribute Meaning tory Number
SpecialInfo Subelement of agent optional any
Variables that are to be displayed in Special-
Info,
Without entry no special info is displayed
- with entry but without variable, the default
special info will be displayed (supported
MIBs)
- the text is displayed for each variable
- several variable are possible: Display:
in picture: separated by commas
in the speech bubble help: in new line
Text Text to be displayed yes
MibVariable The content of the variable is displayed yes
Instance Poll variable with this instance optional
This instance is also used to differentiate
between identical function symbols, for
example power supplies, see also
"Agent.xml" on page 218.
EnumString For Enums: use EnumString instead of the optional
integer,
Possible: Yes or No, default: No
BubbleHelp Subelement of agent any
Variables that are to be displayed in the
speech bubble agent
Text Text to be displayed yes
MibVariable Contents of the MIB variable that is to be yes
displayed
Instance Poll variable with this instance optional
EnumString for Enums: use EnumString instead of the optional
integer, if possible
Yes or No, default: No
IgnoreTrap Subelement of agent any
Normally, all variable traps are examined
that contribute to the status. Here you can
make the setting that this trap should not be
used for status changes.
TrapName MibName of the trap yes
Part Subelement of agent any
Definition of a symbols for displaying
device-specific functions
PartID Symbol ID yes
(Reference for Agent_Dialog.xml)
Label Name of the symbol for display yes
Symbol Symbol icon for display yes
see "ProductFamily.xpm" on page 216
Instance Instance of the symbol (number) yes
HiVision
Release 6.4 06/07 221
Creating a PSM 8.6 Editing PSM files
Manda-
Element Attribute Meaning tory Number
Position Position of the symbol optional
(see "Component.xml" on page 232)
HideInstance In the physical representation, the display of optional
the instance is suppressed (helpful if only
one instance can exist)
possible: Yes or No, default: No
ExprAvailable Formula indicating whether the symbol optional
exists: if there is no formula, the symbol is
always created
PartStatus Subelement of Symbol (not of agent) Defini- any
tion of a subsymbol status. A symbol can
have several substatuses
Name Name of the status (speech bubble help) yes
ExprOk Formula with variable and instance for OK yes
status (green)
ExprWarning Formula with variable and instance for optional
warning status (yellow)
ExprError Formula with variable and instance for error optional
status (red)
PortMana- Formula for querying and setting port char- any
gerConfig acteristics in the Port Manager
Example in data/fastiron/config/Agent.xml
resource file
Attribute Characteristic of port yes
Possible: Admin, FullDuplex, Speed,
AutoNeg, FlowControl, LinkAlarm, Name
Default: Admin
HiVision
222 Release 6.4 06/07
Creating a PSM 8.6 Editing PSM files
U Variable
In order for HiVision to determine the correct value of a variable, it is
necessary to indicate an instance for the variable,
for example: hmChassisName.1. The correct instanz of a variable you
can find with an SNMP browser.
A variable can be assigned to a number or string. Via SNMP, a variable is
often output as a number that has been assigned a string according to
the MIB definition. In this case, the number is called "ENUM", and the
assigned string "ENUMSTRING."
In case you wish to replace an ENUM with a ENUMSTRING, insert
"ENUMSTRING" after the instance,
for example: hmProduct.1:ENUMSTRING.
U Status display
The formula for calculating the status can have constants and any num-
ber of variables. All variables in the formula are to be specified with an
instance.
The worst case of the individual statuses are always displayed in the
main window.
The table lists the permissible operands for the calculation formula (see
Tab. 26 on page 223). Operators with a higher priority are executed first.
Parenthetical expresions with ( and ) are permitted. The formula is
considered fulfilled if the result is not equal to 0. The calculation syntax
follows that of the C programming language).
HiVision
Release 6.4 06/07 223
Creating a PSM 8.6 Editing PSM files
8.6.7 AgentDialog.xml
This file describes the dialogs. The structure is hierarchical. The description
of the contents of the first window is at the beginning. This is followed by the
description of the contents of the windows that appear in the first window as
the consequence of an action.
<!-- XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX-->
<!-- X Definition Main windowX-->
<!-- XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX-->
<Resources>
<Dialog Name="Agent_Device"
Type="TabBook"
Title="%IpAddr"
AgentID="BnTcX1000">
<SubDialog Name="Agent_Image" />
HiVision
224 Release 6.4 06/07
Creating a PSM 8.6 Editing PSM files
The first block determines the card index and which index cards are loca-
ted in the card index of the Device window.
<Dialog Name="Agent_Image"
Type="AgentImage"
Title="$$IMAGE"
AgentID="BnTcX1000">
</Dialog>
<Dialog Name="Agent_PhysMap"
Type="AgentPhysMap"
Title="$$MAP"
AgentID="BnTcX1000">
</Dialog>
<Dialog Name="Agent_LogMap"
Type="AgentLogMap"
Title="$$AGENT_LOGICAL_MAP"
AgentID="BnTcX1000">
</Dialog>
<Dialog Name="Agent_Trap"
Type="TrapLog"
Title="Traps"
AgentID="BnTcX1000">
</Dialog>
<Dialog Name="Agent_DeviceDescription"
Type="Dialog" Title="$$DEVICEDESCRIPTION"
AgentID="BnTcX1000">
<Group Name="Group_BnTcX1000_DeviceDescription" />
</Dialog>
The second block determines the contents of the cards in the card index.
These cards can contain an image, the logical or physical structure, a
trap list etc. (see Table 28 on page 229).
HiVision
Release 6.4 06/07 225
Creating a PSM 8.6 Editing PSM files
<MibGroup Name="Group_BnTcX1000_DeviceDescription">
<MibName Name="sysDescr" Instance="0" />
<MibName Name="sysDescr" Instance="0" />
<MibName Name="sysDescr" Instance="0" />
<MibName Name="sysContact" Instance="0" />
<MibName Name="sysName" Instance="0" />
<MibName Name="sysLocation" Instance="0" />
</MibGroup>
The third block describes, if needed, the details of the window contents.
<!-- XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX-->
<!-- X Definition Agent window (card index / Karteikasten) X-->
<!-- XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX-->
<Dialog Name="Agent"
Type="TabBook"
Title="%IpAddr: Agent" *
AgentID="BnTcX1000">
<SubDialog Name="Agent_Configuration" />
<SubDialog Name="Agent_Performance" />
<SubDialog Name="Agent_Fault" />
<SubDialog Name="Agent_Security" />
</Dialog>
* %IPAddr represents a variable, see "Variables for agent dialogs" on page
230.
The first block determines the card index and which cards are located in
the card index of the Agent window.
HiVision
226 Release 6.4 06/07
Creating a PSM 8.6 Editing PSM files
<Dialog Name="Agent_Configuration"
Type="TreeBook"
Title="$$CONFIGURATION" *
AgentID="BnTcX1000">
<SubDialog Name="Agent_Trap_Destination" />
<SubDialog Name="Agent_ISDN_Call_Table" />
<SubDialog Name="IP_Route_Table" />
</Dialog>
* $$ represents a variable, see "Variables for agent dialogs" on page 230.
The second block determines the contents of the cards in the card index.
These cards can contain the most varied information (see Table 28 on
page 229).
<Dialog Name="Agent_Trap_Destination"
Type="EditList"
Title="Trap Destination"
AgentID="BnTcX1000">
<VarName Name="biboAdmTrapHostAddr" />
<VarName Name="biboAdmTrapHostStatus" />
</Dialog>
<Dialog Name="Agent_ISDN_Call_Table"
Type="ShowList"
Title="ISDN Call Table"
AgentID="BnTcX1000">
<VarName Name="biboDialIfIndex" />
<VarName Name="biboDialType" />
<VarName Name="biboDialDirection" />
<VarName Name="biboDialNumber" />
<VarName Name="biboDialSubaddress" />
<VarName Name="biboDialClosedUserGroup" />
<VarName Name="biboDialStkMask" />
<VarName Name="biboDialScreening" />
</Dialog>
The third block describes, if needed, the details of the window contents.
V Check which existing dialogs are useful for describing your product. Make
the necessary changes to the file and add any information you may need.
HiVision
Release 6.4 06/07 227
Creating a PSM 8.6 Editing PSM files
Manda-
Element Attribute Meaning Number
tory
Dialog Definition of a dialog box any
Name Name of the dialog box yes
Type Type of the dialog box, see "List of the yes
dialog types" on page 229
Title Dialog-box heading, variables are per- yes
mitted, see "Variables for agent dia-
logs" on page 230
AgentID Applies to this agent type optional
Parameter Parameter (depend on the dialog type) optional
see "Parameter list for dialog types" on
page 231
Instance Normal dialog box: The instance is for- optional
med from the values of these variables.
Numbering begins with 0! The instance
cannot be edited. Example: "0,1,2":
The instance is based on the first 3
values of the dialog.
LoadOnPopup When a subdialog is opened, the MIB optional
variables are reread.
Possible: Yes or no, default: No
OneVarPerSetPdu Dialog: when making the setting, optional
always pack one variable into a PDU,
in case the agent accepts only one
variable per PDU.
Possible: Yes or no, default: No
DialogSelect The dialog applies only to DialogSelect. any
The agent determines its DialogSelect
through DialogSelectVar in Agent.xml.
Name DialogSelect = yes
Contents of DialogSelectVar.
SubDialog Subelement of dialog subdialog only in any
TabBook or TreeBook
Name Name of the subdialog yes
Group Subelement of dialog only normal dia- any
log: The variables of this group are dis-
played in the dialog
Name Dialog displays this group of variables yes
Table 27: Element list for the appearance of the Agent dialog boxes
HiVision
228 Release 6.4 06/07
Creating a PSM 8.6 Editing PSM files
Manda-
Element Attribute Meaning tory Number
VarName Subelement of dialog any
Only in ListDialogs: Display these
variables
Name Name of the Mib variables yes
ReadOnly MibVariable is read-only for this dialog: optional
Yes or no, default: No
Instance Do not query variable, but extract it optional
from the Oid of the first queried varia-
ble, see Determining variable from the
instance
VarOid Subelement of dialog only List dialogs: any
Only use display these variables, if the
MibName is not unique!
Oid Oid of the Mib variables yes
Table 27: Element list for the appearance of the Agent dialog boxes
The list of dialog types demonstrates the possibilities that HiVision provides
for dialogs.
HiVision
Release 6.4 06/07 229
Creating a PSM 8.6 Editing PSM files
The variable list for agent dialogs shows the placeholders that HiVision pro-
vides. Placeholders make it possible to define a display whose contents is
read from an MIB.
Keyword Meaning
$$TOKEN Keyword from the "LanguageTable.conf" on
page 236 translation files
%IpAddr IP address of the agent with the name in
parentheses (if present)
%PartName Name of the part
%agentNo Number of the agent (normally 1)
%ipAddr IP address of the agent
%boxNo Number of the housing (always 1)
%portNo Number of the port
%interfaceIndex Number of the interface (ifIndex from MIB II)
%partNo Number of a symbol for device-specific
function
HiVision
230 Release 6.4 06/07
Creating a PSM 8.6 Editing PSM files
The parameter list shows the parameters that use the various dialog types.
<DialogName="Agent_Trap_Destination"
Type="TabBook"
Title="$$ISDNSTATUS"
AgentID="BnTcX1000">
<SubDialog Name="Agent_ISDN_Call_Table" />
</Dialog>
HiVision
Release 6.4 06/07 231
Creating a PSM 8.6 Editing PSM files
8.6.8 Component.xml
This file describes which image file HiVision assigns to the PSM products and
sets the image display.
<Resources>
<ComponentName="X1000"
Orientation="Vertical"
Width="1336"
Height="917"
Zoom="250"
Image="X1000sw.jpg"
</Component>
<ComponentName="BINTEC-X4000"
Orientation="Vertical"
Width="735"
Height="857"
Zoom="500"
Image="x4000sw.jpg"
</Component>
</Resources>
V For Name enter exactly the name that you have defined in the agent.xml
file with ChassisVar or ChassisFix.
V Enter the width and height of the product image for the variables Width
and Height.
V With the value for Zoom you can set the size with which HiVision displays
the product image in the device window.
The value 1000 stands for the factor 1.
V If the PSM describes several products, repeat the procedure for each pro-
duct.
HiVision
232 Release 6.4 06/07
Creating a PSM 8.6 Editing PSM files
8.6.9 action.xml
This file describes actions and their implementation for the respective
agents.
Mandat
Element Attribute Meaning ory Number
Action Definition of an action any
ActionID String for identifying the action yes
Name Name (not used at present) yes
HelpText Help text (not used at present) optional
Param (Entry) Parameters which require the any
action. If no parameters exist, the dialog
is empty.
Type Type of entry field. Possible: Text, Bool, yes
Enum. Default: Text
ParamID Under this ID, the value in the action yes
implementation can be used.
Name This string is displayed in the dialog. yes
Description This string is displayed as speech bubble optional
help in the dialog.
ActionImplemen- Implementation of an action for an agent any
tation type
ActionID ID of the action (see above) yes
AgentID ID of the agent yes
Command An action can consist of a number of any
commands.
Type Type of action (set or poll variable). Possi- yes
ble: Set, Poll, Check. Default: Set
MibVariable Variable to be set only for Set Instance. only for
Instance of the variable to be set. Set
Expression Set: value to be set. Otherwise: formula to yes
be evaluated.
IgnoreTime- A Timeout can be ignored. Possible: Yes, optional
out No. Default: No
OnTimeout Value of a formula when a Timeout optional
Expression- occurs. Possible: Yes, No. Default: No
True
PollInt_dezi Polling interval (in 1/10 sec.) optional
Sec
HiVision
Release 6.4 06/07 233
Creating a PSM 8.6 Editing PSM files
Mandat
Element Attribute Meaning ory Number
MaxPoll- Maximum number of polling attempts optional
Count Optional PollLimitRetVal value of a for-
mula when the max. number of polling
attempts has been carried out. Possible:
OK, Error. Default: Error
ExecIf Formula with condition leading to inter- optional
ruption
U Definition of actions
Definition of general actions. Example: SaveConfigLocal,
SoftwareUpdate or RebootAgent. The description of the action also
specifies whether entry parameters are necessary. In the above
examples, they are only necessary for SoftwareUpdate (URL of the
software image).
U Implementation of actions
These actions can now be implemented for every agent type (if the agent
supports this action). An action consists of a number of commands,
which are carried out in sequence. They can be of the following types:
D Set: set an MIB variable to a value.
A fixed value or an entry parameter can be set.
D Poll: poll a variable (until it fulfills a formula).
Polling can also be carried out until a Timeout comes, or as long as a
Timeout is coming.
D Check: the result of the entire action is determined by the evaluation
of this formula.
The check should be the last command of an action.
U Call-up in dialogs
The actions can now be used in multi-agent dialogs. They are located
below the dialog called MultiDevConf and they are of the type
ActionDialog.
HiVision
234 Release 6.4 06/07
Creating a PSM 8.6 Editing PSM files
8.6.10 outname.xml
Use this file to assign additional attributes to an MIB variable .
<Resources>
<Mib variableName="biboAdmTrapHostStatus"
Label="Status" DeleteValue="2">
</MibVariable>
<Mib VariableName="biboAdmTrapHostStatus"
Label="TrapHostAddr">
</MibVariable>
</Resources>
In the example above, two MIB variables are given new attributes.
The assignment Label=ÓStatusÓ causes the name biboAdmTrapHost
Status to be replaced by the display Status.
The assignment DeleteValue="2" informs HiVision to provide a selec-
tion field called delete and permit a new entry. This assignment requires
HiVision, if no corresponding value exists in the MIB for the MIB variable.
Manda-
Element Attribute Meaning tory Number
MibVariable Description of an MIB variable any
Name Name of the variable (from MIB) yes
Label This value is displayed in the dialog optional
DeleteValue This value allows you to delete and create optional
a table line
SendOnly- During deletion only this variable is sent optional
ThisVarFor- Possible values: Yes or No
Delete Default: Yes
DefaultValue This value is displayed by default upon optional
creation
OffsetValue Offset is subtracted from the variable for optional
display
Creatable This value is not required when created optional
Possible: Yes or No, default: Yes
Monitorable Adds a selection field for the SNMP moni- optional
tor to the dialog (from HiVision 6.1).
Possible: Yes/No.
Default:
– Yes for counter variables
– No for integer variables
HiVision
Release 6.4 06/07 235
Creating a PSM 8.6 Editing PSM files
Manda-
Element Attribute Meaning tory Number
BitString The string is displayed as a hex (01 02 optional
FF) or decimal (001 002 256) number:
Hex or Dec
AllowedValue Subelement of MibVariable for string: dis- any
play popup, not edit field
Value Display these values as popup yes
MapValue Subelement of MibVariable Definition of any
an Enums here. Display as popup.
Value Value yes
Output Display string yes
ReadOnlyValue Subelement of MibVariable Definition of any
values that should not be written
Value Do not write this value yes
8.6.11 LanguageTable.conf
The language table is for adapting the PSM to various languages. HiVision
can translate terms that are displayed in the dialogs by using the variables
(see Table 29 on page 230) with the help of the language table. Two prece-
ding $ signs identify a variable that HiVision translates using the language ta-
ble (language table).
The following rule applies for the structure of the LanguageTable.conf file:
– Each line begins with the name of the variable to be translated followed
by the language ID and the translation term.
– Variable, language ID and translation term are separated by a tab or
blanks.
– Should the translation be followed by a blank, separate the variable from
the language ID with an additional blank.
– The language IDs are:
ENG for English,
GER for German,
FRE for French,
SPA for Spanish.
HiVision
236 Release 6.4 06/07
Creating a PSM 8.6 Editing PSM files
– Enter one line per language for each variable. If a line is missing for a lan-
guage, HiVision then inserts the English term.
– The #-character identifies the start of a comment. A comment ends with
the end of a line
– If an entry consists of several lines, "\n" creates a line feed.
############################################################
#
# LanguageTranslationTable File
#
# Supported Languages:
# ENG English
# GER German
#
############################################################
LANSTATUSENGLAN state
ISDNSTATUSENGISDN state
HiVision
Release 6.4 06/07 237
Creating a PSM 8.7 Testing PSM
As an alternative to starting with the command line parameters, you can also
start a PSM check in Windows from the starting menu:
Start - Programs - Hirschmann - HiVision Toolbox -
HiVision - HiVision with Syntaxchecker.
U Dialogs
The syntax checker checks the following criteria in the AgentDia
log.xml file:
– Are all subdialogs present?
– Are not-used dialogs defined?
– Are dialogs repeated?
– Are the groups used available?
– Can the title be translated into the language set?
– Can the placeholders (%portNo) be translated?
– Are all dialogs available (Agent, Agent_Description, Function symbol
dialogs)?
HiVision
238 Release 6.4 06/07
Creating a PSM 8.7 Testing PSM
U Components:
The syntax checker checks the following criteria in the Component.xml
file:
– Are any components repeated?
– If the component defines an image, does the image exist?
U Product families
The syntax checker checks the following criteria in the ProductFa
mily.xml file:
– Are any components defined more than once?
– Is a sort index used more than once?
– Does the icon exist?
U AgentSysOids
The syntax checker checks the following criteria in the SysOID
List.xml file:
– Is a SysOid used more than once?
– Does the AgentID exist?
U Agents
The syntax checker checks the following criteria in the agent.xml file:
– Do the MIB variables exist that are used in
ChassisVar,
DialogSelectVar,
SWVersionVar,
SpecialInfoVar und
BubbleHelpVar
– Do the traps exist that are specified in IgnoreTrap?
U AddMibAttributes
The syntax checker checks the following criteria in the Outname.xml
file:
– Are MIB variables defined twice?
HiVision
Release 6.4 06/07 239
Creating a PSM 8.7 Testing PSM
U MibGroups
The syntax checker checks the following criteria in all dialogs:
– Are groups defined more than once?
– Are superfluous groups defined?
– Are MIB variables repeated in a group?
– Is the MIB access list valid?
Error messages:
Dialog XXX defined but not used
Dialog XXX found YYY times
Dialog XXX not found
Group XXX not found
Dialog XXX: title cannot be translated: title: YYY
Dialog XXX: title with part token cannot be translated: title: YYY
Component XXX defined twice!
Component XXX: image YYY not found
Product Family XXX: uses same SortIndex as YYY, SortIndex: ZZZ
Product Family XXX: Symbol YYY not found
Agent SysOid Entry XXX found twice
Agent SysOid Entry: AgentID not found: YYY
Agent XXX: YYY: Mib Variable ZZZ not defined in loaded MIBs
Agent XXX: YYY: Trap ZZZ: not defined in loaded MIBs
Additional MIB Attribute for Mib Variable XXX: defined twice
Mib Variable XXX: not defined in loaded Mibs
Mib Variable XXX: not defined in loaded Mibs
Group XXX: defined twice
Group XXX: not used
Group XXX: Mib Variable YYY: defined twice
Group XXX: mib access list cannot be translated: access: YYY
HiVision
240 Release 6.4 06/07
Creating a PSM 8.7 Testing PSM
HiVision
Release 6.4 06/07 241
Creating a PSM 8.7 Testing PSM
HiVision
242 Release 6.4 06/07
Appendix
A Appendix
HiVision
Release 6.4 06/07 243
Appendix A.1 Frequently asked questions
You will find detailed information on all the Hirschmann Competence Center
services on the Website:
U Application examples
Unter Help:Tutorials or in the directory .../HiVision/data/kernel/doc/
you will find application examples in Html format:
Subject File
Router-Redundancy routerred/index.html
VLAN-Manager vlans/index.html
Polling polling/index.html
Integration in HP OpenView div/HpOVwIntegration_us.html
HiVision
244 Release 6.4 06/07
Appendix A.2 Device information
A.2.1 RMS
The SNMP configuration of the agent is carried out via Telnet.
U Gauges
HiVision allows you to edit MIKE gauges. You can create and delete gau-
ges via the Telnet interface.
U MAC addresses
The TYDE and IYDE cards do not recognize port assignment. All the
MAC addresses detected are assigned to port 1. In the physical map,
therefore, the MAC addresses received for all the ports appear at port 1.
HiVision
Release 6.4 06/07 245
Appendix A.2 Device information
U Link status
FastSXM2 recognizes the link status for optical ports when the Spanning
Tree is switched off.
U RMON
100EATP10 does not send any values to the agent:
– Packet sizes (RMON performance).
– Undersize and oversize (RMON fault). The agent sends the value 0.
A.2.3 ETH-12TP/M
Creating gauges:
When you are creating a gauge, default values are used.
In the Agent:Configuration:Create gauge you specify the default va-
lues before creating the gauge.
Changing gauges
V Delete gauge
V Change default values
V Create gauge
Port gauges
The SNMP access to the port gauges always applies to all 3 possible gau-
ges. Thus the 3 gauges behave like one gauge.
HiVision
246 Release 6.4 06/07
Appendix A.2 Device information
A.2.4 FEH-24TP
The user interface allows you to configure a new trap target address. You ac-
cess the user interface via Telnet. HiVision allows you to open a Telnet ses-
sion.
A.2.5 RS2-../..
U Software update
Software updates from versions before 5.0 cause an immediate re-start
as soon as the new software has been transferred in full.
Software updates from versions 5.0 and higher require the user to initiate
the re-start after the software transfer.
U Port mirroring
Although this function is displayed in releases 5.0 and earlier of the
RS2 software, the RS2 supports this function only from release 6.0.
During the configuration of this function (see the Configuration tab page
in the agent window), the device supports "copyBoth".
HiVision
Release 6.4 06/07 247
Appendix A.2 Device information
A.2.6 MICE
HiVision
248 Release 6.4 06/07
Appendix A.2 Device information
A.2.8 GES-24TP/2SX/FES-24TP
The agents support port mirroring within a group (ports 1-8, 9-16 and 17-24).
Under Agent:Configuration:Portmirroring you set the port mirro-
ring function.
You set the AddressAgingTime in the agent directly via the user interface.
HiVision
Release 6.4 06/07 249
Appendix A.2 Device information
U Port settings
In the port manager (see “Port Manager/Port Analyzer” on page 83), the
display of Speed and Vollduplex is valid when there is a Link
Status display at the port effected.
HiVision
250 Release 6.4 06/07
Appendix A.2 Device information
HiVision
Release 6.4 06/07 251
Appendix A.2 Device information
HiVision
252 Release 6.4 06/07
Appendix A.2 Device information
A.2.15 BAT54-Rail
HiVision does not support the VLAN function of the BAT54-Rail.
A.2.16 LION-24 TP
HiVision does not readout the MAC address table of the LION-24 TP.
HiVision
Release 6.4 06/07 253
Appendix A.2 Device information
V Quit OpenView
V ovstop, ovstart ovwdb, ovw -fields, ovstart ovtopmd, ovtopofix -u, ovstart
V Restart OpenView
or
or
HiVision
254 Release 6.4 06/07
Appendix A.3 Hirschmann Competence
In the long term, excellent products alone do not guarantee successful custo-
mer relationships. It is the all-round service that makes a difference world-
wide. In the global competitive market, the Hirschmann Competence Center,
with its complete spectrum of innovative services, has its nose ahead of the
competition in the following three ways:
D The consulting encompasses an all-round technical service ranging from
system assessment and network planning to configuration.
D The training includes basic training, product instruction and user training
with certification.
D The support services range from starting operation and on-call services
to maintenance concepts.
In choosing the Competence Center, you are making a decision without any
compromises. With the individualized customer range of services you can
select those services you want to avail of.
Internet:
http://www.hicomcenter.com
HiVision
Release 6.4 06/07 255
Appendix A.3 Hirschmann Competence
HiVision
256 Release 6.4 06/07
Appendix A.4 Readers Comments
What do you think of this manual? It is our intention that our manuals descri-
be affected products completely and also provide important information so
that the product can be used without problem. Your comments and ideas
help us to raise the quality and level of information in this documentation.
HiVision
Release 6.4 06/07 257
Appendix A.4 Readers Comments
General Comments:
.......................................................................................................................
.......................................................................................................................
.......................................................................................................................
.......................................................................................................................
Dear user,
D-72654 Neckartenzlingen
HiVision
258 Release 6.4 06/07
A.5 Index
A.5 Index
HiVision
Release 6.4 06/07 259
A.5 Index
HiVision
Release 6.4 06/07 260
A.5 Index
P sensor 130
packet error 63 Set 108, 121
Parameter list 231 setup 110
PC stand-alone version 13 Shortcut menu 152
PDF file 204 SMS 70
Performance 85, 120 SMScom 70
Physical map 106, 197 SNMP 60, 92, 95
Polling 98, 120, 129 SNMP configuration 61, 161, 175, 245
Polling interval 124, 129 SNMP monitor 86, 124
Pop-up information 63 SNMP parameters 95
Port access rights 168, 174 SNMP states 115
Port analyzer 85 SNMP variable 251
Port assignment 245 Sort 93
Port group 83 Sort function 152
Port manager 84 Sort index 239
Port Mirroring 247 Spanning tree 162, 175
Port mirroring 249 Special information 196
Port status 76, 129 Standard MIB 203
Port-based 154 Start 41, 45
Power Supply 76 Start window 73
PPP 137 startup 81
Preferences file 74 state 107
Product family 196, 205, 213, 216 static address table 247, 248, 252
Product image 213, 215, 232 statistics 63
Program start 81 status 77, 107, 110
protocol 95 status bar 56
Protocol file 99 Status calculation 129, 223
Protocol Status 76 status color 78
PSM 195 Status display 218
Status forwarding 218
Q status information 111
quitting 67 Status line 66, 197, 218
Status propagation 62, 63, 77, 79
R status symbol 78
Rack Monitoring System 15, 130, 131 subdevice buttons 110
Read permission 60 Subnetwork 137
receive port 247, 248, 252 Subnetwork mask 139
Redundancy manager 133 Symbols 208
Relay Status 76 Syntax errors 238
Reload 108, 121 SyntaxChecker 91
RMON 115, 126, 246, 249, 252 SysOid 202, 213, 215, 239
RMS 131, 245 system assessment 255
Router 137 System MIB 197
Router Redundancy 139
Router Status 76 T
Routing table 138 Table 123, 151
Target address 139
S Telephone network 70
sampling rate 127 Telnet 122, 247
scan procedure 61 Templates 201
scanning area 95 Text file 125
Search 152 Third-party devices 195
Search function 94 Timeout 245
Security 74, 120 tool bar 56, 66, 89, 108, 121
HiVision
261 Release 6.4 06/07
A.5 Index
U
Uplink 159
User groups 163
user training 255
V
Variable list 230
version 12
view selection 67
Virtual 157
VLAN ID 149, 158
VLAN ID assignment 153
VLAN identification 149
W
Web browser 95
Web-based management 95
X
XML format 210
Xpm files 195
Z
Zoom 232
HiVision
Release 6.4 06/07 262