This chapter describes the objectives, audience, organization, and conventions of the CiscoWorks Blue Maps and SNAView Workstation Installation and Administration Guide. It also points to related publications and sources of information.
Document Objectives
This guide tells you how to perform the following tasks:
Prepare to install CiscoWorks Blue Maps and SNA View.
Install, configure, and start CiscoWorks Blue Maps and SNA View.
Discover devices and perform other administration tasks using the CiscoWorks Blue Administration interface.
Control and monitor the CiscoWorks Blue processes using the CiscoWorks Blue Process Manager interface.
Verify that end users can view the Maps and SNA View information.
Control and view the messages logged by CiscoWorks Blue processes using the CiscoWorks Blue Message Logger interface.
Diagnose problems with CiscoWorks Blue Maps and SNA View.
Understand CiscoWorks Blue Maps and SNA View database table structures.
For last-minute information about using the CiscoWorks Blue Maps and SNA View applications, see the Release Notes for CiscoWorks Blue Maps and SNA View Software Release 3.0.
Audience
This guide is for the network administrator or operator who installs and configures CiscoWorks Blue Maps or SNA View software.
Users of UNIX workstations should be familiar with the following topics:
Motif window management system and/or web browsers
A network management system such as TME10 NetView for AIX, HP OpenView, or SunNet Manager
Basic UNIX commands
UNIX text editors
Document Organization
This guide contains information pertaining to using CiscoWorks Blue on UNIX workstations. CiscoWorks Blue Maps and SNA View 3.0 are both supported on AIX, HP, and Solaris UNIX platforms.
This guide is divided into the following chapters and appendices:
"Preparing to Install CiscoWorks Blue Applications," describes software and hardware prerequisites and methods of verifying compliance on various workstation platforms. It also tells you how to become the root user so that you will be authorized to install the product.
"Using the Process Manager," describes how to start and use the Process Manager to start and control the processes.
"Using the Message Log Viewer," describes how to use the message log viewer to review the messages collected from the applications.
"Using the Administration Application," describes how to start and use the CiscoWorks Blue Administration program to add, delete, and modify devices, discover the network, and specify DLSw key devices.
"Starting the User Applications," describes how to start the DLSw, RSRB, and Advanced Peer-to-Peer Networking (APPN) Motif applications and the web server from a workstation.
"Improving Performance," describes ways to improve the performance of the workstation applications.
"Event Notification Messages," describes the TRAP messages that the DLSw and APPN applications can send to the workstation network management system (NMS) when changes in network status occur.
"Database Tables," describes the structure of the Maps and SNA View database tables.
"CiscoWorks Blue Commands and Processes," tells you how to start and stop processes, and it describes the relationship between the processes and the database tables.
"CiscoWorks Blue Maps and SNA View Web Interface," provides information about accessing various functions of the CiscoWorks Blue Maps and SNA View applications by supplying a URL containing function calls and parameters.
"Mainframe and Workstation Installation Checklist," is a checklist that you can use to communicate important installation information between the Maps or SNA View workstation installer and the mainframe installer.
Document Conventions
This guide uses basic conventions to represent text and table information.
Product names use these conventions:
Cisco Works Blue refers to both Maps and SNA View applications.
Maps refers to the Motif applications and protocol-oriented web applications.
SNA View refers to the LU/PU portion of the web application.
Command descriptions use these conventions:
Commands and keywords are in boldface font.
Arguments for which you supply values are in italic font.
Elements in square brackets [ ] are optional.
Alternative but required keywords are grouped inside braces { }. Alternative selections are separated by a vertical bar (|).
Examples use these conventions:
Terminal sessions and information the system displays are printed in a screen font, with default responses in square brackets ([ ]).
Information you enter is in boldface font. Variables you enter are printed in italic font.
Nonprinting characters, such as passwords, are shown in angle brackets (< >).
This publication also uses the following conventions:
Menu items and button names are in boldface font.
A menu item you are to select is indicated by the following convention: Select Admin > Discover > Seed File.
Directories and filenames are in italic font.
TimeSaver Means the described action saves time. You can save time by performing the action described in the paragraph.
Note Means reader take note. Notes contain helpful suggestions or
references to materials not contained in the manual.
Caution Means reader be careful. You are capable of doing something that might result in equipment damage or loss of data.
Related Documentation
The CiscoWorks Blue Maps and SNA View documentation set includes the following documentation:
Release Notes for CiscoWorks Blue Maps and SNA View Software Release 3.0.1
CiscoWorks Blue Maps and SNA View Mainframe Installation Guide
CiscoWorks Blue Maps and SNA View Workstation Installation and Administration Guide
CiscoWorks Blue Maps and SNA View User Guide
CiscoWorks Blue Maps Online Help System
Installation Checklist for CiscoWorks Blue Maps and SNA View for UNIX
Quick Start for CiscoWorks Blue SNA View for UNIX
Online Help
CiscoWorks Blue Maps and SNA View include an online help system that allows users to access different levels of help information. The system provides overviews, related information, procedures, and glossary data for the applications and features. It contains both keyword and full-text search capabilities to enable users to search for specific text within the online help system.
Obtaining Documentation
Cisco provides several ways to obtain documentation, technical assistance, and other technical resources. These sections explain how to obtain technical information from Cisco Systems.
Cisco.com
You can access the most current Cisco documentation on the World Wide Web at this URL:
Cisco documentation and additional literature are available in a Cisco Documentation CD-ROM package, which may have shipped with your product. The Documentation CD-ROM is updated regularly and may be more current than printed documentation. The CD-ROM package is available as a single unit or through an annual or quarterly subscription.
Registered Cisco.com users can order a single Documentation CD-ROM (product number DOC-CONDOCCD=) through the Cisco Ordering tool:
Nonregistered Cisco.com users can order documentation through a local account representative by calling Cisco Systems Corporate Headquarters (California, U.S.A.) at 408 526-7208 or, elsewhere in North America, by calling 800 553-NETS (6387).
Documentation Feedback
You can submit comments electronically on Cisco.com. On the Cisco Documentation home page, click Feedback at the top of the page.
You can e-mail your comments to bug-doc@cisco.com.
You can submit comments by using the response card (if present) behind the front cover of your document or by writing to the following address:
Cisco Systems Attn: Customer Document Ordering 170 West Tasman Drive San Jose, CA 95134-9883
We appreciate your comments.
Obtaining Technical Assistance
Cisco provides Cisco.com, which includes the Cisco Technical Assistance Center (TAC) website, as a starting point for all technical assistance. Customers and partners can obtain online documentation, troubleshooting tips, and sample configurations from the Cisco TAC website. Cisco.com registered users have complete access to the technical support resources on the Cisco TAC website, including TAC tools and utilities.
Cisco.com
Cisco.com offers a suite of interactive, networked services that let you access Cisco information, networking solutions, services, programs, and resources at any time, from anywhere in the world.
Cisco.com provides a broad range of features and services to help you with these tasks:
Streamline business processes and improve productivity
Resolve technical issues with online support
Download and test software packages
Order Cisco learning materials and merchandise
Register for online skill assessment, training, and certification programs
To obtain customized information and service, you can self-register on Cisco.com at this URL:
The Cisco TAC is available to all customers who need technical assistance with a Cisco product, technology, or solution. Two types of support are available: the Cisco TAC website and the Cisco TAC Escalation Center. The type of support that you choose depends on the priority of the problem and the conditions stated in service contracts, when applicable.
We categorize Cisco TAC inquiries according to urgency:
Priority level 4 (P4)—You need information or assistance concerning Cisco product capabilities, product installation, or basic product configuration. There is little or no impact to your business operations.
Priority level 3 (P3)—Operational performance of the network is impaired, but most business operations remain functional. You and Cisco are willing to commit resources during normal business hours to restore service to satisfactory levels.
Priority level 2 (P2)—Operation of an existing network is severely degraded, or significant aspects of your business operations are negatively impacted by inadequate performance of Cisco products. You and Cisco will commit full-time resources during normal business hours to resolve the situation.
Priority level 1 (P1)—An existing network is "down," or there is a critical impact to your business operations. You and Cisco will commit all necessary resources around the clock to resolve the situation.
Cisco TAC Website
The Cisco TAC website provides online documents and tools to help troubleshoot and resolve technical issues with Cisco products and technologies. To access the Cisco TAC website, go to this URL:
All customers, partners, and resellers who have a valid Cisco service contract have complete access to the technical support resources on the Cisco TAC website. Some services on the Cisco TAC website require a Cisco.com login ID and password. If you have a valid service contract but do not have a login ID or password, go to this URL to register:
If you are a Cisco.com registered user, and you cannot resolve your technical issues by using the Cisco TAC website, you can open a case online at this URL:
If you have Internet access, we recommend that you open P3 and P4 cases online so that you can fully describe the situation and attach any necessary files.
Cisco TAC Escalation Center
The Cisco TAC Escalation Center addresses priority level 1 or priority level 2 issues. These classifications are assigned when severe network degradation significantly impacts business operations. When you contact the TAC Escalation Center with a P1 or P2 problem, a Cisco TAC engineer automatically opens a case.
To obtain a directory of toll-free Cisco TAC telephone numbers for your country, go to this URL:
Before calling, please check with your network operations center to determine the Cisco support services to which your company is entitled: for example, SMARTnet, SMARTnet Onsite, or Network Supported Accounts (NSA). When you call the center, please have available your service agreement number and your product serial number.
Obtaining Additional Publications and Information
Information about Cisco products, technologies, and network solutions is available from various online and printed sources.
The Cisco Product Catalog describes the networking products offered by Cisco Systems, as well as ordering and customer support services. Access the Cisco Product Catalog at this URL:
Cisco Press publishes a wide range of networking publications. Cisco suggests these titles for new and experienced users: Internetworking Terms and Acronyms Dictionary, Internetworking Technology Handbook, Internetworking Troubleshooting Guide, and the Internetworking Design Guide. For current Cisco Press titles and other information, go to Cisco Press online at this URL:
Packet magazine is the Cisco quarterly publication that provides the latest networking trends, technology breakthroughs, and Cisco products and solutions to help industry professionals get the most from their networking investment. Included are networking deployment and troubleshooting tips, configuration examples, customer case studies, tutorials and training, certification information, and links to numerous in-depth online resources. You can access Packet magazine at this URL:
iQ Magazine is the Cisco bimonthly publication that delivers the latest information about Internet business strategies for executives. You can access iQ Magazine at this URL:
Internet Protocol Journal is a quarterly journal published by Cisco Systems for engineering professionals involved in designing, developing, and operating public and private internets and intranets. You can access the Internet Protocol Journal at this URL:
