Extreme Networks ISM Provision User Manual

Network Infrastructure
Manager User Guide

Infrastructure Client for ISM Provision

Extreme Networks, Inc.

3585 Monr oe Street

Santa Clara, California 95051

[phone]

http://www.extremenetworks.com

Published: April, 2002

Part number:100 120-00 rev0 1

©2002 Extreme Networks, Inc. All rights reserved. Extreme Networks and BlackDiamond are
registered trademarks of Extreme Networks, Inc. in the United States and certain other jurisdictions.
ExtremeWare, ExtremeWare Vista, ExtremeWorks, ExtremeAssist, ExtremeAssist1, ExtremeAssist2,
PartnerAssist, Extreme Standby Router Protocol, ESRP, SmartTraps, Alpine, Summit, Summit1,
Summit4, Summit4/FX, Summit7i, Summit24, Summit48, Summit Virtual Chassis, SummitLink,
SummitGbX, SummitRPS, and the Extreme Networks logo are trademarks of Extreme Networks, Inc.,
which may be registered or pending registration in certain jurisdictions. The Extreme Turbodrive logo
is a service mark of Extreme Networks, which may be registered or pending registration in certain
jurisdictions. Specifications are subject to change without notice.

All other registered trademarks and service marks are property of their respective owners.

ii

Contents

Preface

Introduction ix

Terminology x
Conventions x
Related Publications xii

1 Infrastructure and Services Management Provision

Overview

Overview 1-1
Summary of Features 1-2
How ISM Provision works 1-3

Yo u r Netw ork D evic es 1 - 4
ISM Provision Server 1-4
Device Communicators 1-4
Network Infrastructure Manager Client 1-5
IP Service Manager Client 1-5

2 Starting Network Infrastructure Manager

Overview 2-1

Starting Network Infr astructure Manager 2-1

3 Network Infrastructure Manager Overview

Network Infrastructure Manager User Gu ide iii

Network Infrastructure Manager Overview 3-1

Summary of Features 3-1
NIM Views 3-2

Selecting NIM Views 3-2
Network Provision View 3-5
Network Inventory View 3-6
Providers Administration View 3-7
Server Administration View 3-8
Change Control View 3-9

NIM Icons 3-9

Open Changes 3-10
Save Changes 3-10
Modify Object 3-10
Copy 3-10
Paste 3-10
Delete 3-10
Move Device 3-11
Verify Configuration 3-11
Synchronize 3-11
Commit Changes 3-11
Revert Change s 3-11
Help 3-11

4 Network Provisioning

Overview 4-1
Network Provision View Panels 4-3

Network Panel 4-4
Te mplates P an el 4 -5
Verification Pa nel 4-5

Properties Panel 4-5
Configuration Objects 4 -5
Key Information 4-6
Unsupported Configuration Commands 4-6
Managed and Unmanaged Devices 4-7
View Device Configurations 4-8

View a Single Configuration Object 4-8

iv Network Infrastructur e Manager Us er Guide

View Multiple Configuration Objects 4-15
Modify Visible Configuration Options 4-18
Modify View Options 4-20

Create and Modify Network Device Config urations 4-20

Add a New Device 4-21
Add a Configuration Object 4-22
Modify a Configuration Object 4-26
Copy a Device or other Object 4-29
Save Changes Without Changing Network Configuration 4-34
Remove Changes (Revert to Server State) 4-34
Change an Unmanaged Device into a Managed Device 4-35

Access Extreme Devices Directly 4-39

Use Telnet to acc ess a devi ce 4-39
Use Extreme WebVista to access a device 4-40

5 Managing the Network Inventory

Overview 5-1
Manage the Network Inventory List 5-2

Add a Device to the Network Inventory 5-2
Modify a Network Inventory Device Listing 5-10
Delete a Device from the Network Inventory 5-11
Import Inventory File 5-11
Export Inventory File 5-15

Manage the Network Inventory Devices 5-16

Upload Devices 5-16
Save Running Configuratio ns 5-18

6 Managing Providers

Overview 6-1
The Infrastructure Provider 6-2
Device Access 6-2
Managing Providers 6-2

Create a Provider and Provider Accounts 6-2
Limit Provider Device Access 6-5

Network Infrastructure Manager User Gu ide v

7 Managing the ISM Provision Server

Overview 7-1
Communicators Tab 7-2
Logs Tab 7-3
Control Tab 7-4
Manage Device Communicators 7-4

Add a Device Communicator 7-5

Modify a Device Communicator 7-5

Delete a Device Communicator 7-6

View Device Communicator Logs 7-7
Manage ISM Provision Server 7-8

Vi ew O t h e r C o n n e c t ed Us e r s 7- 8

Send Broadcast Message 7-9

Stop Server 7-10

View Server L og 7-11

8 Change Control

Overview 8-1
Jobs 8-2
Configuration Versions 8 -2
Change Control Tasks 8-3

View Current Job Change s 8-3

View Committed, Scheduled, or Saved Jobs 8-4

Delete Scheduled or Saved Jobs 8-7

Create Configuration Version 8-7

Rollback to a Configura tion Version 8-9

A ISM Provision Devices, Images, and Modules

Supported D evices, Image s and Module s A-1

B ISM Provision Rules

8-10

Overview B-1

vi Network Infrastructur e Manager Us er Guide

C ISM Provision Server Maintenance

Overview C-1
Database Backup Utilit y C-1

Database Backup Utilit y Location C-2
Using the Database Backup Utility C-2
Installing a Backup Da tabase C-3

Adding a License Key C-3

Index

Network Infrastructure Manager User Gu ide vii

viii Network Infrastructur e Manager Us er Guide

Preface

This Preface provides an overview of this guide, describes guide conventions, and lists
other publications that may be useful.

Introduction

This guide provides the required information t o manage a network us ing Extreme
Networks’ Network Infrastructure Manager (NIM) client as the i nterface for Extreme
Networks’ Infrastructure and Services Mana gement Provision (ISM Provision).

This guide is intended for use by network administrators who are responsible for
configuring network equipmen t. It assumes a basic working kno wledge of:

• Local area networks (LANs).

• Ethern et conc epts.

• Ethernet switching and bridging concepts.

• Routing concepts .

• Internet Protocol (IP) co ncepts.

• Routing Information Protocol (RIP) and Open Shortest Path First (OSPF).

• Simple Network Managemen t Protocol (SNMP).

Additionally, this g uide assumes a familia rity with the features and function ality of

ExtremeWare Software and with Extreme Networks’ hardw a re. Se e t h e s ec t ion , “Related
Publications”, for documents covering Extreme Networks’ Softwa re and Hardware.

Network Infrastructure Manager User Gu ide ix

If the information i n the release notes sh ipped with your softw are differs from the
information in this guide, follow the release no tes.

Terminology

When features, functionality, or operation is specific to t he Summit, Alpine, or
BlackDiamond switch family, the family name is used. Explanations about features and
operations that are the same across all Extreme switch product families sim ply refer to
the product as the “Extreme device” or “Extreme switch.” Explanations about features
that are the same for all devices managed by Network In frastructure Manager (both
Extreme devices and others) simply refer to “devices.”

Conventions

Table 1 and Table 2 list conventions that are used throughout this guide.

Table 1: Notice Icons

Icon Notice Type Alerts you to...

Note Important features or instructions.

Caution Risk of personal injury, system damage, or loss of data.

Warning Risk of severe person al injury.

Table 2: Text Convent ions

Convention Description

Screen displays This typeface indicates command syntax, or represents information

as it appears on the screen.

Screen displays
bold

This typeface indicates how you would type a particular command.

x Network Infrastructure Manager Us er Guide

Conventions

Table 2: Text Convent ions (continued)

Convention Description

The words “enter”
and “type”

[Key] names Key names are written with brackets, such as [Return] or [Esc].

Words in Bold type GUI elements are written in bold type. Example: menu items, buttons,

Words in italicized type Italics emphasize a point or denote new terms at the place where

When you see the word “enter” in this guide, you must type
something, and then press the Return or Enter key. Do not press the
Return or Ente r key when an inst ruction simpl y says “type.”

If you must press two or more keys simultaneously, the key names
are linked with a plus sign (+). Example:

Press [Ctrl]+[Alt]+[Del].

field names

they are defined in the text. Italics are also used to denote variables,
such as VLAN names, or user account names.

Network Infrastructure Manager User Gu ide xi

Related Publications

The publications related to this one are:

• ISM Provision Installation Guide

• IP Service Manager User Guide

• ExtremeWare Software User Guide

Documentation for Extreme Networks products is available on the World Wide Web at
the following location :

http://www.extremenetworks.com/

xii Network Infrastructure Manage r User Guide

1

Infrastructure and Services
Management Provision Overview

Overview

Extreme Networks’ Infrastructure and Services Managemen t Provision (ISM Provision)
is a tightly connected collection of componen ts for delivering services to customers and
for managing your network. ISM P rovision allows you to easily extend services to your
network users by defining and provisioning bundles of IP services. Services are
managed as simple objects that are easy to apply to customers, but the configuratio n
changes required to support the delivery of services is managed by ISM Provision. ISM
Provision also allows you to control all or a portion of you r network, by controlling the
configurations of the devices in the netw ork.

ISM Provision is designed to ma ke it much easier to roll out changes to th e network.
You can add devices and make configuratio n changes offline and apply them to your
network later. Planned changes are verifie d against a comprehe nsive set of rules to
assure that the changes can be applied to your network and will n ot conflict with
existing configurations. Inco mplete sessions can be saved to be com pleted later.

Services provided across a group of customers can be easily modified. Once a service is
updated, the change is applied to all cus tomers using the service. ISM Provision
manages all the config uration changes to ma ke the modifications.

Network Infrastructure Manager (NIM) is the GUI client portio n of ISM Provision that
controls and manages the infrastruc ture of your network, the configurations o f your
network devices. NIM works closely wit h IP Service Manager (IPSM), the GUI client
portion of ISM Provision that a llows a provider to manage customers, service bund les,
and policy based services.

Network Infrastructure Manager User Gu ide 1-1

Infrastructure an d Services M anagement Pro vision Overview

Summary of Features

• Version Control of Network Co nfiguration

• Staging of Network Co nfiguration Change s

• Configuration rules checking

• Helps Manage the VLAN s, Access Lists, and QoS Profile s Required to Support

Subscribers

• Provides Service-Level Abstractions to Manage Subscribers

• Client/Server Java architecture - platform independent and scala ble

• Offline and on-line tool - used in both green field a nd existing network

environments

• Co-exists with other mana gement tools using CLI or SN MP

• Version control for configurati ons and deployment module f or system rollouts

• Provides an abstraction model that simplifies and autom ates both infrastructure and

subscriber provisioning life-cycles

• Distributed device communicat ion infrastructure for redundancy and scalin g

1-2 Network Infrastructure Man ager User Guid e

How ISM Provision works

NIM Client

ISM Provision
Server

How ISM Provision works

IP Service

Manager Client

Device
Communicator

Device
Communicator

Device

#1

Device

#2

Device

Device

#4

#3

Device

#5

Figure 1-1: ISM Provision Components

ISM Provision consists of severa l different components:

• ISM Provision Server

• Device Communicators

• Network Infrastructure Manager Client

• IP Service Manager Client

Device
Communicator

Device

#6

Device

#7

These components work toget her to manage another important com ponent:

Network Infrastructure Manager User Gu ide 1-3

Infrastructure an d Services M anagement Pro vision Overview

• Yo u r Netw ork D evic es
The following sections describe these components and how they interact in more detail.

Your Network Devices

The network managed by IS M Provision consists of your current existing network of
Extreme Network devices, or a subset of your devices. Many devices can be managed
by ISM Provision simultaneous ly. The devices are managed by querying th em for their
configurations, and by sending new configuration commands to them. Once ISM
Provision manages a device, it will periodically check that the device conf iguration for
changes.

ISM Provision Server

The ISM Provision server is the heart of ISM Provision . You may have m ore than one
instance of the othe r components, but on ly one server. The server contains the
information about the co nfigurations of the mana ged devices, configurations th at are
scheduled to be applied to the network a t a later time, and previous configurations. An
ISM Provision server can cont ain the configurations of a la rge number of devices, but
does not communicate with the devices directly. Instead, it uses device communicators
to handle this task.

The ISM Provision serve r also contains th e saved configura tion changes that have not
yet been applied to the network. These changes may be saved to edit later, or may be
applied at a f uture time to t he network.

Device Communicators

The device communicators control the communication between the network devices
and the ISM Provision server. All queries to devices from the ISM Provision server and
all commands from the ISM Provision server to the devices are handled by the device
communicators. To spread the processing load across hosts, there can be more than one
device communicator in an ISM Provision installation, but only one per ho st.

For example, in a network of 100 d evices all managed with the sa me ISM Provision
server, you m ight have five different device communicators, each talking with twen ty
devices. Any one managed device can only be managed by one device communicator,
otherwise conflicts will occur.

1-4 Network Infrastructure Man ager User Guid e

How ISM Provision works

Typically, you will install one devi ce communicator on the same host as t he ISM
Provision server, and then add other device comm unicators on oth er hosts as need ed to
manage the processing load of com municating with your devi ces.

Network Infrastructure Manager Client

The Network Infrastructure Manager (NIM) client is us ed to manage changes to the
network infrastructure. With NIM you can prepare and commit changes to the current
network configuration, and add new devices to be provisioned. Before changes are
rolled out to your network, NIM tests your proposed cha nges against a set of rules
designed to spot and help you correct errors (for example, duplicate IP addresses
assigned to different VLANs).

The NIM client also manages the providers, provider accounts, and provider access to
network resources. With NIM you can define a provider and restrict that provider’s
control to a specific set of ports o n a specific set of devices. You can also restrict the
allowable VLAN IDs and IP addresses that the provider can assign.

The NIM client also manages the ISM Provision server and device communicators. You
can see the status of the server and communicators and examine their logs. You can also
see who is currently connected to the ISM Provision server and send a broadcast
message to them. You can shutdown the ISM Provision server from within NIM.

Finally, you can review the current changes in y our session, review committed, saved
and scheduled jobs, and perform configuration versioning.

IP Service Manager Client

The IP Service Manager client allows p roviders to manage subscribers (subscribers
consist of a VLAN and a single port in your netwo rk). IP Service Manager als o allows
you to configure service bundles (these correspond to Qo S profiles) and policy based
services (these correspond to access control lists) for these subscribers.

Network Infrastructure Manager User Gu ide 1-5

Infrastructure an d Services M anagement Pro vision Overview

1-6 Network Infrastructure Man ager User Guid e

2

Starting Network Infrastructure
Manager

Overview

Since the Network Infrastructure Manager (NIM) clien t is part of ISM Provision, NIM
relies on a running ISM Provision server and devi ce communicator. This chapter
assumes that you already ha ve a functionin g ISM Provision server and d evice
communicator. For information about installing and starti ng an ISM Provision server
and device communicator, see the document, ISM Provision Installation Gu ide, available
as a PDF fi le, “install-1-0.pdf”on your ISM Provision CDROM.

Starting Network Infrastructure Manager

The following is a short summary of the steps to start Network Infrastructure Manager

Summary Steps. To start Network Infrastructure Manager you must:

1 Launch the NIM Client
2 Specify the ISM Provision S erver
3 Enter a User Account Name
4 Enter the Password for the Account

Detailed Steps. The foll owing steps are a more detailed explanati on of the previous
section.

To start Network In frastructure Manager you must:

Network Infrastructure Manager User Gu ide 2-1

Starting Network Infrastructu re Manager

1 Launch the NIM Client

Launch the NIM client as you w ould launch other applicat ions on your host. For
example, Windows users can select Network Infrastructure Manager from the
Start>Programs>Extreme Networks>ISM Provision>Applications menu. Solaris
users can launch the nim executable file from the /opt/extreme/ismprov/bin
directory by using a graphical file manager appl ication to double-click on its icon, or
by typing:

/opt/extreme/ismprov/bin/nim

Once the application s tarts, you will see t he login screen similar to th e one shown in
Figure 2-1.

Figure 2-1: Network Infrastructure Manage r Login Screen

2 Specify the ISM Provision S erver

Once the login screen appears, you will specify th e ISM Provision server. Specify the
IP address of the server or the hostname by typing it into the server field. Figure 2-2
shows the login screen and server field in more detail (if the server is on the same
host as the NIM client, you can a lso specify “localhost”).

NIM will store the IP addresses and names tha t you have specified in previous
sessions, so you may fin d your server already specified, or you ma y be able to select

2-2 Network Infrastructure Man ager User Guid e

it from the drop-down list in the server field. Click on the down -arrow on the right
side of the field and select the server.

Overview

Figure 2-2: NIM Login Screen Detail

3 Enter a User Account Name

Network Infrastructure Manager User Gu ide 2-3

Starting Network Infrastructu re Manager

In the User Account field, enter your user account name. The previously accessed
account name is displayed in the field, so you m ay not need to enter a name.

4 Enter the Password for the Account

Enter the account password. The account passwords are not saved and will need to
be entered every session.

Once the information has been entered, click the Login to Server button, then the
NIM client will attempt to conn ect with the ISM Provision server. While it is
connecting you will see messag es similar to those in Figure 2-3.

Figure 2-3: The NIM Client Connecting to the IS M Provision Server

Once the NIM client is launched, you will see the Ne twork Provision view.

2-4 Network Infrastructure Man ager User Guid e

Overview

Figure 2-4: NIM Initial Scr een

When NIM launches, the Network Provision view is initially displayed. You are
now ready to us e NIM. Se e Chapter 3, Network Infrastructure Manager Overview, for
more informati on about NIM.

Network Infrastructure Manager User Gu ide 2-5

Starting Network Infrastructu re Manager

2-6 Network Infrastructure Man ager User Guid e

3

Network Infrastructure Manager
Overview

Network Infrastru cture Manager Overview

Network Infrastructure Manager (NIM) is composed of a number of views that are
organized to complement your wo rkflow. The different views allow you t o manage
different functional areas controlled by NIM. They are:

• Network Provision View

• Network Inventory View

• Providers Administration View

• Server Administration View

• Change Control View

NIM also has a number of icons and menus th at are available f rom all of the vi ews.

Summary of Features

• Layer 1 to 4 configurat ion: ports, trunks, VLANs, IP addressing, routing protocols ,

ACLs

• Extreme Networks-only device support: BlackDiamond, Alpine, and Summit (i

chipset and 24e3 only)

• Service Provider Administration (wholesale mo del support)

• ISM Provision Server Administratio n (device communicators, utilities )

• Configuration Versioning (change histories, checkpoints)

Network Infrastructure Manager User Gu ide 3-1

Network Infrastructure Manager Overvie w

• Configuration and topology import from devices and input files

NIM Views

When NIM is first launched you will be presented with the Network Provision view, as
shown in Figure 3-1. The different views are described below.

Figure 3-1: Initial NIM Network Pro vision View

Selecting NIM Views

There are four ways to select a particular view. One way is to select the desired view
from the icons near the upper righ t side of the NIM client screen, as sh own in
Figure 3-2. From left to right th e icons represent the views Network Provision, Netwo rk

3-2 Network Infrastructure Man ager User Guid e

Network Infras tructure Mana ger Overv iew

Inventory, Provide rs Adminis tration, Se rver Admi nistration , and Chan ge Control. Select
the icon to display the view.

Network Inventory

Change Control

Network Provision

Providers Administration

Server Administration

Figure 3-2: Selecting a NIM View Using Icons

A second way is to select th e View menu and choose the view, as shown in Figure 3-3.
A third way is to use the shor tcut keys also shown in Fig ure 3-3. Press the [ALT] key

Network Infrastructure Manager User Gu ide 3-3

Network Infrastructure Manager Overvie w

and a number key at the same time to use the shortcuts. F or example, press [ALT]+3 t o
choose the Providers Administration view.

Figure 3-3: Selecting a NIM View Using the Menu

A fourth way is to select the view f rom the named icons near the bottom of the NIM
client screen, just above the status line, as shown in Figure 3-4.

Figure 3-4: Selecting a NIM View Using Named I cons

3-4 Network Infrastructure Man ager User Guid e

Network Provision View

Network Infras tructure Mana ger Overv iew

Figure 3-5: NIM Network Provision View

The N etwork Provision view is used to stage changes to your network before actually
committing them to your d evices. From this view, you build configurations for new
devices, modify configurations for exis ting devices, and view the current configurations
of existing devices. Once you have made changes, you will either commit the changes
to the network, save the changes w ithout affecting the network, or throw away the
changes by reverting to the current server state.

Saved changes are not saved on th e local client ho st, but on the ISM Provision server, so
they are accessible from other NIM clients, and can be viewed and reviewed by other
NIM users. Saved changes can also be scheduled to be committed to your network at a
later time.

Committed changes are also saved on the ISM Provision server, but they are also
pushed out to your network devices. Comm itted changes become part of the current
configurations of your d evices.

Network Infrastructure Manager User Gu ide 3-5

Network Infrastructure Manager Overvie w

At any time you may test yo ur modified configuratio ns against a numb er of rules
derived from Extreme Network devices, ExtremeWare, and good networking practices.
For example, if you attempt to re-issue an IP address that would conflict wi th your
current configurations, you will be warned and the error will be identified so you can
take action. You will also be warned if you select an incompatible set of modules for an
Extreme Networks chassis.

Network In ventory View

Figure 3-6: Network Inventory View

The Network Inventory view shows you the managed devices in your network.
Managed devices are specified by their network name or IP address. ISM Provision
manages the devices through the administrator a ccount of each device. From this view
you can add and remove managed de vices, select which device communica tor talks to
each of the managed network devices, upload device configurations to the server, save
device configurations to the device’s NVRAM, and view the current status of the
device.

If you have an existing network, this is likely the first view you will use. To capture the
current state of your network you will ad d your devices to the inventory. By adding

3-6 Network Infrastructure Man ager User Guid e