cc/td/doc/product/rtrmgmt/bluelist/cwblue31
hometocprevnextglossaryfeedbacksearchhelp
PDF

Table of Contents

Preparing to Install CiscoWorks Blue Applications
Hardware and Software Requirements for UNIX Workstations
Collecting Data for Installation on UNIX
Cisco IOS Software Requirements
Configuring Trap Destinations in Cisco IOS Routers
Setting Kernel Parameters on HP-UX Systems
Becoming the Root User
Using Key Devices

Preparing to Install CiscoWorks Blue Applications


This chapter provides information on preparing to install CiscoWorks Blue Maps and SNA View on UNIX workstations.

This chapter includes the following main sections:

Hardware and Software Requirements for UNIX Workstations

This section lists the workstation requirements and Cisco IOS software requirements.

Workstation Software Requirements

CiscoWorks Blue Maps and SNA View run on the following systems:

CiscoWorks Blue and Network Management Systems

CiscoWorks Blue is not dependent on running with a network management system. The SNA View dependency view allows you to highlight a router and launch both CiscoView and CiscoWorks from that window. The programs run independently and do not share data.

Trap Processing

The network management systems offer some benefits in monitoring and improving performance. By receiving DLSw traps from the network management system, CiscoWorks Blue can update its database of DLSw peer and circuit status quickly if Cisco IOS is configured to send the traps to the network management system and the CiscoWorks Blue workstation. CiscoWorks Blue also takes the DLSw and SNASw traps and converts them into a more human-readable format and sends them back as traps to the local network management system. For example, CiscoWorks Blue displays MAC addresses and link names.

Discovery

CiscoWorks Blue preforms discovery by learning the routers discovered by the network management system and running its own discovery for DLSw, SRB, and TN3270. With this feature, users are not required to build a seed file of all of the routers that need to be managed.

Workstation Hardware Requirements

All platforms require the following hardware and software:

Installation Authority Requirement

To install CiscoWorks Blue SNA View, you must have root authority on the machine you are installing the software.

Verifying UNIX Workstation Requirements

Table 2-1 lists commands that you can enter to verify hardware and software requirements on all platforms.

Table 2-1   Hardware and Software Verification Commands

Verify  On AIX  On HP-UX  On Solaris 

Hard disk space

df -k

bdf

df -k

Operating system version

oslevel

uname -a

uname -a

NMS version

lslpp -L nv6000.base.obj

/usr/sbin/swlist | grep "Network Node Manager"

pkginfo | grep SNM

/opt/OV/bin/ovversion

RAM size

lscfg | grep mem1

lsattr -E -l mem0 -F "description value"2

/usr/sam/lbin/getmem

dmesg | grep mem

 

Swap space size

lsps -s

swapinfo

swap -s

X Window System version

Ask your system administrator.

 

On an IBM RISC System 6000 workstation.

On a Power-PC workstation.

System Software Requirements

Your workstation must meet the following software requirements to run CiscoWorks Blue SNA View:

Make sure JavaScript and cookies are enabled.

Sun Solaris Patch Requirements

The Solaris patches listed by version in this section are required for you to install Maps and SNA View. You can install these separately or as a jumbo patch from Sun Microsystems, Inc. To obtain the patches, contact your Sun Microsystems representative or download them from the Sun web site.

Solaris 2..6 Patches

The following minimum patch level is required on Solaris Version 2.6:

Required HP-UX Patches

HP suggests using the following 10 patches for using the jre on HP-UX. Without these patches, you can encounter a problem in which the jre runtime is unable to initialize. After you install the patches, the problem will be solved. After you install the patches, and the MsgLogClient starts, then the jre is working.

If your system already has a jre bundle installed, it may not require these patches and you can ignore them.

If you encounter a JRE initialization problem, you must install the following patches to solve the JRE initialization problem:

The HP-UX patches listed by version in this section are required for you to install Maps and SNA View. To obtain these patches, contact your Hewlett Packard representative.


Note   Hewlett Packard often obsoletes old patches and incorporates their functions in new patches with different numbers. In the following sections, we list both the original patch we require and the latest patch, that we are aware of, that contains the required functions.

HP-UX 11.00 Patches

The following minimum patch levels are required on HP-UX Version 11.00:

AIX Patches

The AIX patches listed by version in this section are required for you to install Maps and SNA View on AIX Version 4.3 or higher. To obtain the patches, contact your IBM AIX representative.

AIX 4.3

The following patches are required on AIX Version 4.3:

Collecting Data for Installation on UNIX

During installation, you might be asked to provide information needed by the installation program, such as the locations of key programs or the identifications of ports to be used. You should collect the following information in advance to make the installation process easier.

Network Management System (NMS)

The installation program might ask for the directory path to an NMS, such as NetView for AIX, HP OpenView, or SunNet Manager. When one of these systems is found, the installation program can integrate CiscoWorks Blue applications with the NMS.

Netscape

The installation asks for the directory path and name of the Netscape executable program. Do not enter a Netscape shell script.

Port Numbers

The installation program assigns port numbers to several applications, including the port number used by the web server. If the default ports are unavailable, the installation program asks you for an available port number that it can assign.

CiscoWorks 2000

The URL for the CiscoWorks 2000 web page.

Domain name

Be prepared to supply a 1-8 character, uppercase domain name to identify your host connection.

Protocols

The installation needs to know which protocols are running in your network so that the appropriate programs can be set to start automatically (DLSw, RSRB, TN3270, and APPN/SNASw).

Seed files

If you will discover the network from seed files, you should carry over any seed files from previous installations.

License keys

Be prepared to enter the license keys for UNIX (one for Maps and one for SNA View).

APPN/SNASw topology agent name—This procedure is optional and applies to Maps only. After installation is complete, you might need to edit the cwbinit file or use the Configuration utility to enter the host name of the APPN/SNASw network topology agent.

Mainframe information

If TCP/IP is used between the mainframe and the workstation, the installation program needs the host name or TCP/IP address of the mainframe.

If LU 6.2 is used between the mainframe and the workstation, verify the basic LU 6.2 connectivity by using the following host command:
D NET,APING=NETID.CPNAME

Cisco IOS Software Requirements

For routers to be managed by CiscoWorks Blue Maps applications, all routers must be running a Cisco IOS release indicated below:

Configuring Trap Destinations in Cisco IOS Routers

This section describes how to configure a router for use with CiscoWorks Blue Maps and SNA View. For detailed information about configuring the Cisco IOS software with the snmp-server command, see the Cisco IOS Configuration Fundamentals Command Reference. The following trap configuration methods are described in this section:

Configuring Cisco IOS Software in Managed Routers

Configure the Cisco IOS software in every managed router using the following command:

snmp-server community string RO

Where:

string is the community string (a password for access to SNMP) in this router.

RO specifies read-only access to SNMP in this router.

Configuring Traps in RSRB-Enabled Routers

For the trap daemon (cwbtrapd) to perform optimally for RSRB, all RSRB-enabled routers must specify their addresses in the traps that they generate. Therefore, you must configure the Cisco IOS software in every RSRB-enabled router using the following command:

snmp-server trap-source interface

Where:

interface specifies the router interface (such as tokenring1) whose IP address is used as the local address for RSRB peering and is stamped on the traps that this router generates.


Note   The information in this section applies to Ciscoworks Blue only if you are running a UNIX workstation with an NMS during an installation.

Configuring Trap Destinations in DLSw- and RSRB-Enabled Routers

To use router-generated traps, all DLSw- and RSRB-enabled routers must specify the CiscoWorks Blue Maps network management host as the destination of DLSw and RSRB traps. Therefore, you must configure the Cisco IOS software in every DLSw- and RSRB-enabled router.


Note   The information in this section applies to Ciscoworks Blue only if you are running a UNIX workstation with an NMS during an installation.

To configure a DLSw router, use the following command:

snmp-server host address string dlsw

Where:

address is the IP address of the network management host, such as 123.45.67.89.

string is the community string for access to SNMP in the network management host.

dlsw limits the traps sent to DLSw-related traps.

To enable the DLSw traps, use the following command:

snmp-server enable traps dlsw [circuit | tconn]

Where:

circuit limits the traps to DLSw circuit-related traps.

tconn limits the traps to DLSw peer-related traps.

To configure an RSRB router for traps, use the following command:

snmp-server host address string rsrb

Where:

address is the IP address of the management host, such as 123.45.67.89.

string is the read community string for access to SNMP in the management host.

rsrb sends only RSRB-related traps to address.

Configuring Trap Destinations for SNASw- and DLSW-Enabled Routers

If Cisco IOS is not configured to send traps to the CiscoWorks Blue workstation, when CiscoWorks Blue detects DLSw and APPN/SNASw resource changes, it will send traps to the local network management system to notify the operator of the state changes. However, if Cisco IOS is configured to send CiscoWorks Blue traps, then only those traps will be seen and not the existing traps.

CiscoWorks Blue receives Cisco IOS traps for DLSw encapsulation and APPN/SNASw, converts them from hexadecimal to a human-readable format and sents them back to OpenView, NetView, or SunSolstice.

To take advantage of this trap conversion, you must configure SNASw and DLSw routers to send Cisco IOS traps to the CWBlue workstation.

Enable SNASw traps with the following configuration command:

Hardy(config)#snmp-server enable traps snasw ?
  cp-cp     Enable SNMP snasw local topology tg cp-cp session traps
  dlus      Enable SNMP snasw dlus traps
  isr       Enable SNMP snasw intermediate sessions traps
  link      Enable SNMP snasw link traps
  port      Enable SNMP snasw port traps
  topology  Enable SNMP snasw local topology tg traps
  <cr>

For information about specific traps and their corresponding conversions, see "Event Notification Messages".

Setting Kernel Parameters on HP-UX Systems

If you install the CiscoWorks Blue applications on an HP-UX system, you might need to change the following kernel parameters. Use the HP-UX sam command to change the kernel parameters if they are lower than the following settings:

See your HP-UX publications for instructions on changing these values.

These values are the minimum values needed for Maps and SNA View. If you have other resource-intensive applications on this workstation, you might need to increase these values. If you are unable to start the Process Manager, if you get "out of space" errors while trying to start other CiscoWorks Blue processes, or if you get Java exceptions with the message "out of memory," try increasing the swap space.

Becoming the Root User

Before you install CiscoWorks Blue Maps or SNA View on UNIX workstations, you must have root user authority. The user named root can perform functions restricted from normal users. You can log in to your system as the root user, or you can become the root user by using the su command. You will then be asked to enter the root user's password.


Caution   If you are a relatively inexperienced UNIX user, limit your activities as the root user to the tasks described in this publication. As the root user, you can adversely affect your operating environment if you are unaware of the effects of the commands that you use.

If you are not logged in, you can log in as the root user by responding to the login prompt with the username root.

login: root
Password: rootpassword

If you are already logged in, but not as the root user, use the su command to become the root user:

% su
Password: rootpassword

Using Key Devices

This section describes how you can specify selected DLSw routers as key devices to limit some of the SNMP traffic on your network.

A key device is a router that you designate as "key." This means that the router is in close proximity to the mainframe, or it supports an important set of network resources. You can use key routers to reduce the SNMP traffic needed to manage your network, to minimize the number of devices shown on a DLSw map, and for circuit polling, which is needed for SNA correlation. You can also specify a faster polling rate for key devices.

Reduce SNMP Traffic

You can limit some of the SNMP traffic involved in discovering and polling routers by selecting only key routers that are in close proximity to the mainframe and that are responsible for handling traffic between the mainframe and other remote routers and devices in your network. If a router is marked as a key device, the poller daemon polls this router for all of the circuits in addition to the peer connections. If a router is not marked as a key device, the poller daemon polls the router for the peer connections.

A DLSw circuit is represented in both of the DLSw peers through which an SNA session passes. Because part of the circuit information is duplicated in each peer router, the DLSw Maps application can find the SNA path used, even if it polls only one of the routers (a key router, for example). Polling one peer reduces the polling interval and reduces network traffic.

Minimize Displayed Devices

If you designate a set of routers as key devices, you can later display a view of just the key devices. This view is called the key devices view of the network and is described in the CiscoWorks Blue Maps and SNA View User Guide.

The key devices view of the network displays just the DLSw-enabled peer routers that are designated as key devices. The key devices view represents all the peers of a key router with one icon, which is called an aggregated peer router icon. The connection between each key router and its aggregated peer router icon is shown as a single connection called an aggregated peer connection.

To see how using key devices removes the clutter from your maps, compare the key devices view with the global view shown in the CiscoWorks Blue Maps and SNA View User Guide.

Optimize Polling

The DLSw application lets you define polling intervals. See the "Using the cwbinit File" section.

You can specify how the DLSw application polls routers for peer connection information and for circuit information. You can select from the following polling methods:

If you make no changes, the DLSw polling daemon uses all three polling methods: It polls key routers and non-key routers for peer connection information, and it polls key routers for circuit information. You can change these selections using the polling values in the cwbinit file.

You can also use the cwbinit file to configure multiple polling threads. By default, Key-----Peer polling uses five threads so that it can poll more key routers concurrently, while Non--Key--Peer polling uses only one thread by default. You can change these settings in the cwbinit file.

Choose Key Routers

This section gives you guidance in choosing which routers to designate as key devices. Usually, you want to choose key routers for the following reasons:

The following two network examples show how to choose key routers.

Data Center Routers Example

Figure 2-1 shows a network in which the two DLSw-enabled data center routers handle all the peer connections between the mainframe and the remote branch routers. In this case, you should designate these two data center routers as key devices.


Figure 2-1   Example1: Data Center and Remote Branch Routers


Concentrator Router Example

Figure 2-2 shows a network in which one DLSw-enabled concentrator router handles all the connections between the mainframe and the remote branch routers. In this case, you should designate the concentrator router as a key device.


Figure 2-2   Example 2: Concentrator and Remote Branch Routers


Define Key Devices

Initially, no routers are marked as key devices when they are added to the database. You must take some action to mark a router as a key device. You can define a router as a key device by using

Defining Key Devices Using the Seed File

For each router that you include in the seed file, you can use the key parameter to designate that router as a key device. If the key parameter is not used, the router is not a key device in the seed file. To see which routers are key devices, select Edit > Key Device(s) from the menu bar on the Motif application. In the list of routers, the key devices are highlighted.

Once you mark a router as a key device, removing the key parameter in the seed file will not change the device's status as a key device. To change the router's status as a key device, select Edit > Key Device(s) from the menu bar on the Motif application, deselect the router in the router list, and click Apply.

Defining Key Devices Using the Edit Menu

You can select the Key Device(s) menu item from the DLSw Edit menu on the Motif application to define routers as key devices. If you designate several routers as key devices, you can later display a key devices view of the network, as described in the CiscoWorks Blue Maps and SNA View User Guide. The following procedure describes how to use the Edit menu to define a key device:


Step 1   From the DLSw menu bar on the Motif application on UNIX workstations, select Edit > Key Device(s). A list of routers is displayed. If a router name is highlighted, it is a key device.

Step 2   Select those routers that you want to add to the list of key devices. Each router that you select is highlighted.

Step 3   Deselect those routers that you do not want to be key devices. The routers that you select here will not be highlighted.

Step 4   Click Apply to apply your changes in the database.

Step 5   Click Close to close the window.




hometocprevnextglossaryfeedbacksearchhelp
Posted: Tue Aug 5 15:55:42 PDT 2003
All contents are Copyright © 1992--2003 Cisco Systems, Inc. All rights reserved.
Important Notices and Privacy Statement.