ProVision Installation and Administration Guide

Installation andAdministration Guide

PVV_I&A_guide_cov_0304.qxd 18/3/04 9:07 AM Page 2

ProVision V 5.4Installation and Administration Guide

ProVision V 5.4 Installation and Administration Manual

614-330053-001 Rev 007 April 2005Copyright 2003 - 2005 by Stratex Networks

All rights reserved. No part of this publication may be reproduced, transmitted, transcribed, stored in a retrieval system, or translated into any language or computer language, in any form or by any means, electronic, magnetic, optical, chemical, manual or otherwise, without the prior written permission of Stratex Networks. To request permission, contact [email protected].

DisclaimerStratex Networks makes no representation or warranties with respect to the contents hereof and specifically disclaims any implied warranties or merchantability or fitness for any particular purpose. Further, Stratex Networks reserves the right to revise this publication and to make changes from time to time in the content hereof without obligation of Stratex Networks to notify any person of such revision or changes.

TrademarkDMC Net is a registered trademark and SPECTRUM, QUANTUM, Altium, Altium ADR, XP4, DART, and DXR are trademarks of Stratex Networks. ProVision is a registered trademark of Stratex Networks.Cisco is a registered trademark of Cisco Systems, Inc.Microsoft and Windows are registered trademarks and Windows NT is a trademark of Microsoft Corporation.UNIX is a registered trademark in the U.S. and other countries, exclusively licensed through X/Open Company, Ltd.Sun, Sun Microsystems, SunDocs, AnswerBook, AnswerBook2, SunExpress, and Solaris are trademarks, registered trademarks, or service marks of Sun Microsystems, Inc.

For sales information, contact one of the following regional Stratex Networks offices, during normal business hours.

For Customer Service, contact one of the regional Technical Help Desks listed below.

You can also call your local Stratex Networks office. Contact information is available on our website, www.stratexnet.com

Corporate Headquarters Americas Headquarters

Europe Headquarters

Stratex Networks120 Rose Orchard WaySan Jose, CA 95134-1358 U.S.A.

Stratex NetworksRegus, Central BoulevardBlythe Valley Business ParkSolihull, Westmidland B90 8AGUnited Kingdom

Phone: +1 408 943 0777Facsimile: +1 408 944 1801

Phone: +44 1564 711084Facsimile: +44 1564 711335

Asia Pacific Headquarters Middle East, Africa, and CIS Headquarters

Stratex Networks10 Ang Mo Kio Street 65#03-13 TechpointSingapore 569059

Stratex NetworksAPI World TowerSuite 302 ASheikh Zayed RoadDubai, P.O. Box 32423United Arab Emirates

Phone: +65 6484 7780Facsimile: +65 6484 7768

Phone: +97 1433 25600Facsimile: +97 1433 25700

Americas Technical Help Desk EMEA Technical Help Desk Asia Pacific Technical Help Desk

Stratex Networks120 Rose Orchard WaySan Jose, CA 95134-1358 U.S.A.

Stratex Networks4 Bell DriveHamilton International Technology ParkBlantyre, ScotlandG72 0FBUnited Kingdom

Stratex NetworksBldg 10, Unit BPhilexcel Industrial ParkClark Special Economic ZoneClark FieldPampanga, Philippines

Phone:+1 800 362 9283 (from within the US)+1 408 944 3602 (English)

+1 408 944 3664 (Spanish)

Phone: +44 1698 717 230 Phone: +63 45 599 5192

[email protected] [email protected] [email protected]

ContentsAbout This ManualWelcome to ProVision V .............................................................................. xiPurpose.......................................................................................................... xiIntended Audience ....................................................................................... xiiAdditional Resources ................................................................................... xiiOrganization................................................................................................ xiiiConventions and Terminology.................................................................... xiv

Chapter 1. Introduction

Chapter 2. Installing ProVisionPrerequisites................................................................................................ 2-2

Platform Requirements ........................................................................ 2-2Operating System ........................................................................ 2-2Hardware ..................................................................................... 2-3

ProVision Installation CD Set ............................................................. 2-4Eclipse Installation CD........................................................................ 2-4Licensing Considerations..................................................................... 2-4Tracker Box ......................................................................................... 2-5Databases ............................................................................................. 2-5Nodes Supported.................................................................................. 2-5Administrator Username and Password............................................... 2-5ProVision Server IP Address ............................................................... 2-5

Pre-Installation Tasks.................................................................................. 2-6Setting Up Computer Equipment ........................................................ 2-6Setting the Administrative Rights........................................................ 2-6Changing Regional Options................................................................. 2-6614-330053-001 Rev 007 April 2005 v

Disabling PC Power Saving Setting .................................................... 2-7Tracker Box Installation ...................................................................... 2-7

Connecting the Tracker Box........................................................ 2-8Setting the Ring Cadence ............................................................ 2-8

Installation Procedures.............................................................................. 2-15Installing ProVision Server Software ................................................ 2-15Installing ProVision Client Software................................................. 2-17

Client Software Installation Via CD.......................................... 2-18Client Software Installation From the Server ............................ 2-19

Installing Portal Software on Server.................................................. 2-21Uninstallation Procedures ......................................................................... 2-23

Uninstalling ProVision Server Software ........................................... 2-23Uninstalling ProVision Client Software ............................................ 2-24

What Next? ............................................................................................... 2-24

Chapter 3. Upgrading to ProVision VPrerequisites ................................................................................................ 3-1Procedures................................................................................................... 3-2

Upgrading From ProVision 2.3/3.0 To ProVision V v5.4................... 3-2ProVision 2.3/3.0 - Topology Migration Tool ............................. 3-3

Upgrading ProVision V 5.3 to 5.4 ....................................................... 3-8Upgrading earlier ProVision V versions (excluding 5.3) to v5.4 ...... 3-10

Chapter 4. Licensing ProVisionTrial Evaluation ProVision License ............................................................ 4-2Permanent Server License Application....................................................... 4-3Licensing Procedures .................................................................................. 4-3

Determining the Servers IP Address .................................................. 4-3Requesting a Permanent License ......................................................... 4-4Activating ProVision Server License .................................................. 4-4

Chapter 5. Setting Up ProVisionPrerequisites ................................................................................................ 5-2Setting Up Procedures................................................................................. 5-3vi Stratex Networks

ProVision V Installation and Administration GuideChapter 6. Access ControlProVision User Security Groups................................................................. 6-2Practical Applications ................................................................................. 6-4

When Would I Use Access Control? ................................................... 6-4Why Would I Use Access Control?..................................................... 6-4Access Control Process Diagrams ....................................................... 6-5

ProVision User Access Control ................................................... 6-5Radio Security Access Control.................................................... 6-6

Parameters............................................................................................ 6-7Interdependencies ................................................................................ 6-7

Prerequisites ................................................................................ 6-7Dependencies............................................................................... 6-7

Access Control Procedures ......................................................................... 6-8Creating ProVision User Accounts...................................................... 6-8Viewing/Changing a ProVision User Account.................................. 6-11Deleting a ProVision User Account .................................................. 6-13Viewing the Security Log.................................................................. 6-14Adding/Editing Radio Security Access Accounts ............................. 6-15Clearing Radio Security Access ........................................................ 6-18

Chapter 7. Migrating TopologyParameters................................................................................................... 7-1Interdependencies ....................................................................................... 7-2Topology Import/Export Procedures........................................................... 7-3

Topology Import.................................................................................. 7-3Topology Export.................................................................................. 7-4

Chapter 8. Database ManagementPractical Applications ................................................................................. 8-1

When Would I Manage the ProVision Database? ............................... 8-1Why Would I Manage the ProVision Database?................................. 8-1When Would I Backup the ProVision Database?................................ 8-2Workflow Diagrams ............................................................................ 8-4

Parameters................................................................................................... 8-6614-330053-001 Rev 007 April 2005 vii

Interdependencies ....................................................................................... 8-6Prerequisites......................................................................................... 8-6

Database Management Procedures ............................................................. 8-7Stopping the ProVision Server ............................................................ 8-7Starting the ProVision Server .............................................................. 8-7Removing ProVision From System Services ...................................... 8-9Installing ProVision as a System Service .......................................... 8-10Backing Up the ProVision Database ................................................. 8-11Restoring the ProVision Database ..................................................... 8-12Checking the Database Integrity........................................................ 8-15Changing Database Purging Criteria ................................................. 8-17Resetting the Database....................................................................... 8-18

Chapter 9. Northbound Interface (NBI)Introduction................................................................................................. 9-1

NBI Event Management ...................................................................... 9-3How Does NBI Event Management Work?................................. 9-3What Data Does an Event Contain? ............................................ 9-5System Integration - ProVision V Events MIB ........................... 9-5

NBI Performance Data Management................................................... 9-9How Does NBI Performance Data Management Work?............. 9-9

Practical Applications ............................................................................... 9-11Why have Event Management NBIs?................................................ 9-11Why have Performance Data Management NBIs? ............................ 9-11When do I Configure the NBI Forwarding Formats? ........................ 9-11Whats Involved in Setting Up an Event NBI? ................................. 9-11

Interdependencies ..................................................................................... 9-12NBI Procedures ......................................................................................... 9-13

NBI Event Management .................................................................... 9-13Deploying an Event NBI .......................................................... 9-13Testing an Event NBI Configuration ......................................... 9-18Saving/Printing an Event NBI Configuration Report................ 9-20Editing an Event NBI Configuration ......................................... 9-21Event NBI Filter Settings .......................................................... 9-23Enabling/Disabling an Event NBI ............................................. 9-26viii Stratex Networks

ProVision V Installation and Administration GuideDeleting an Event NBI .............................................................. 9-26Renaming an Event NBI............................................................ 9-27

NBI Performance Data Management................................................. 9-28Deploying a Performance Data NBI.......................................... 9-28Editing a Performance Data NBI Configuration ....................... 9-31Performance Data NBI Configuration....................................... 9-32Enabling/Disabling a Performance Data NBI ........................... 9-33Deleting a Performance Data NBI............................................. 9-33Renaming a Performance Data NBI .......................................... 9-34

Chapter 10. System DescriptionArchitecture .............................................................................................. 10-1ProVision Deployment Options ................................................................ 10-3

Single Server/Client Deployment ...................................................... 10-3Server with Standalone Clients.......................................................... 10-4

Network Intelligence................................................................................. 10-5Device Support .................................................................................. 10-5Communication Frequencies With Network Devices ....................... 10-6

Network Management Concepts............................................................... 10-7Network Management and SNMP..................................................... 10-7Managers, Agents, and MIBs ............................................................ 10-7

Manager-Agent Model .............................................................. 10-8Manager and Agent Communication......................................... 10-9Information Exchange and the MIB.......................................... 10-9MIB Organization.................................................................... 10-10

Internet and Enterprise-Specific MIBS ........................................... 10-11Managing Proprietary Protocol Stratex Networks Devices............. 10-11

More About Protocol Mediation and the Proxy ...................... 10-11SNMP Traps and Managed Devices................................................ 10-12

Index 614-330053-001 Rev 007 April 2005 ix

About This Manual

Welcome to ProVision VThis describes how to prepare for, install, license, setup, and administer ProVision V.

ProVision V is a network management tool developed by Stratex Networks that supplies management solutions to the Stratex Networks SNMP and proprietary-protocol products running on your network.

PurposeThe purpose of this manual is to provide the technical information necessary to enable you to:

Install ProVision V

Upgrade to ProVision V

License ProVision V

Set up ProVision V

Administer ProVision V access control

Migrate the network topology to ProVision V

Manage the ProVision V database

Configure the Northbound interfaces614-330053-001 Rev 007 April 2005 xi

Intended AudienceThe information in this manual is designed for the following roles:

Additional ResourcesThe following are additional resources:

ProVision V User Guide (PN 614-330055-001)

Describes the features and uses of the ProVision network management system and provides task-oriented assistance in using the product to create and maintain a graphical representation of your network enterprise. This document describes how to start and exit user sessions, how to monitor and manage device status, performance, and event reporting, how to configure Stratex Networks devices, and how to generate supporting reports and graphs.

Role Brief Description

Network Security Manager Provides details on the ProVision user and radio security accounts, including adding, changing, and removing user accounts and configuring radio security accounts.

ProVision Administrator Provides details on maintaining the ProVision server itself, including tasks such as database backing up, restoring and purging, and stopping and starting the ProVision service.xii Stratex Networks

ProVision V Installation and Administration GuideOrganizationThis guide is organized into the following chapters:


Provides a brief introduction to ProVision and its features.

Chapter 2. Installing ProVision

Details the installation prerequisites and the procedures required to install ProVision.

Chapter 3. Upgrading to ProVision V

Provides the procedures for upgrading from ProVision 2.3, or ProVision 3, to ProVision V.

Chapter 4. Licensing ProVision

Provides information on the licensing requirements and procedures for ProVision.

Chapter 5. Setting Up ProVision

Details what you need to do to get ProVision running and monitoring the network.

Chapter 6. Access Control

Describes the user accounts and security groups, and details how to add users and set up radio security accounts.

Chapter 7. Migrating Topology

Details how to export the network topology and how to import the topology xml file.

Chapter 8. Database Management

Details all the database management functions, including backing up the database, checking the database integrity, and resetting the database.

Chapter 9. Northbound Interface (NBI)

Describes ProVisions support of Northbound event integration with higher-level management solutions.

Chapter 10. System Description

Describes the architecture, the platform hardware and software requirements, deployment options, and an overview of network intelligence and network management concepts.614-330053-001 Rev 007 April 2005 xiii

Conventions and TerminologyGraphical Cues

The following icons function as graphical cues used to characterize particular types of associated supporting information.

Use of Bold Font

Bold font is used for the names of on-screen elements such as; fields, buttons, and drop-down selection lists, tabs, for keywords, commands and for keys on the keyboard.

Bold font is also used to indicate commands that the user needs to type in.

Use of Italic Font

Throughout this manual italic font is used to emphasize words and phrases, to introduce new terms, and for the titles of printed publications.

Common Terminology

ClickPoint the mouse pointer at the item you want to select, then quickly press and release the left mouse button.

Right-ClickPoint the mouse pointer at the item you want to select, then quickly press and release the right mouse button.

A caution icon denotes important information pertaining to damage to equipment, loss of data, or corruption of files.

A warning icon denotes danger to life and/or limb.

A note icon denotes additional information you may require to complete the procedure or understand the function.xiv Stratex Networks


ProVision V is Stratex Networks new-generation Element Management System (EMS). ProVision is synonymous with the network management of Stratex Networks devices. As the new-generation EMS, ProVision V builds on our expertise, experience, and user feedback to provide significant advances in functionality and ease of use.

The ProVision network management base is interoperable with third party products and proprietary operational support systems, and is easily extensible through a variety of standards-based and proprietary management protocols.

ProVision V delivers an advanced, flexible, software solution for managing the devices running on your networkincluding Stratex Networks SNMP and proprietary protocol products and other SNMP-based devices.

This manual includes chapters specific to the following operations:

Installation and upgrade

Chapters 2, 3, and 4

Administration

Chapters 5 through 10614-330053-001 Rev 007 April 2005 1-1

Chapter 2. Installing ProVision

This chapter describes the installation requirements and the procedures for installing ProVision. Figure 2-1 shows an overview of the processes involved in installing, setting up, and managing ProVision.Figure 2-1. Installation Overview 614-330053-001 Rev 007 April 2005 2-1

PrerequisitesThis topic includes the following information:

Platform Requirements on page 2-2

ProVision Installation CD Set on page 2-4

Eclipse Installation CD on page 2-4

Licensing Considerations on page 2-4

Tracker Box on page 2-5

Databases on page 2-5

Nodes Supported on page 2-5

Administrator Username and Password on page 2-5

ProVision Server IP Address on page 2-5

Platform RequirementsThis topic details the hardware and software specifications required to run ProVision V.

Operating SystemTable 2-1. ProVision Server and Client PC Requirements

Operating System PV V Server PV V Client

Windows 2000 Pro X X

Windows XP Pro X X

Windows 2003 Server X -

Solaris 9 X Not supported2-2 Stratex Networks

ProVision V Installation and Administration GuideHardwareTable 2-2. Minimum Hardware Specifications

Platform Min. Server specification Min. Client specification

PC

Separate Server and Client platform

1 GHz processor

512 MB RAM

2 GB HD space to install and operate

Ethernet LAN card

1 GHz processor

512 MB RAM


Ethernet LAN card

17-inch monitor

Minimum display resolution 1024 x 768

PC

Server and Client on the same platform

2 GHz processor

1,024 MB RAM


Ethernet LAN card (10/100 base-T)

17-inch monitor

Minimum display resolution 1024 x 768

Not applicable

Sun / Solaris Ultra 60 with min 1 GB RAM

SunBlade 150 with min 1 GB RAM

SunFire 280R with min 1 GB RAM

The UNIX ProVision Server is compatible with a Windows Client.614-330053-001 Rev 007 April 2005 2-3

ProVision Installation CD SetThe ProVision Installation CD set consists of two CDs:

614-500501-001

Contains the following:

Server and Client Setup applications

Topology and migration tool files

Readme file which details important information noted after the Release Notes were closed off.

614-500502-002

Contains the supporting ProVision V documentation:

Quick Start Guide

Installation and Administration Guide

User Guide

Stratex Helpset

Release Notes

Eclipse Installation CDIf there are Eclipse radios on the network, install the Eclipse craft tool, Portal, on the ProVision server. Portal enables you to log into the Eclipse radios. The Portal software is contained on the Eclipse Installation CD 857-000004-001.

Refer to the ProVision release notes for the compatible versions of Portal and ProVision software.

Licensing ConsiderationsProVision will not run without a valid product license. Either a temporary evaluation license or a permanent license is required.

Using a Trial Evaluation License

A trial evaluation license (license.xml) is included on the ProVision CD. This license is automatically installed when you install the ProVision server.

A ProVision evaluation license is valid for 30 days. When the expiry date is reached, the license key is no longer valid, all ProVision client sessions are stopped. The ProVision server, however, will remain running. The client sessions can be started only when a valid license file has been copied into the ProVision server directory.2-4 Stratex Networks

ProVision V Installation and Administration GuideUsing a Permanent License

A permanent license has no expiry date and is the standard product licensing medium. For information on requesting a permanent license, refer to Chapter 4.

Tracker BoxThe Tracker Box, where supplied, enables secure remote access to ProVision servers and radio networks. It allows Stratex Networks engineers to remotely dial into your network and to provide assistance, when required.

The Tracker Box includes a modem and an internal Ethernet card, and provides Ethernet access to your network.

The Tracker Box must be connected to the ProVision server. There is some initial configuration required to set the ringing cadence to the country of installation. However, no configuration is required on the ProVision server as the Stratex Networks Help Desk personnel perform this function.

DatabasesProVision V 5.4 supports the MySQL database, version 3.23.49-max.

Nodes SupportedProVision V 5.4 supports in excess of 10,000 nodes. Where support for more than 5,000 nodes is required, please contact Stratex for additional information.

Administrator Username and PasswordThe default administrator username and password is set as:

username: admin

password: admin

The admin password must be changed for security purposes. For more information, refer to Setting Up Procedures on page 5-3.

ProVision Server IP AddressThe ProVision Server IP address is required when applying for a ProVision license, and uploading the client.exe from the ProVision server to the client PC. To determine the Server IP address, refer to Determining the Servers IP Address on page 4-3.

The Server IP address supplied must be static, because the ProVision license is based on the IP address and the IP address is verified each time the server starts up.614-330053-001 Rev 007 April 2005 2-5

Pre-Installation TasksBefore installing ProVision, the following tasks must be performed:

Setting Up Computer Equipment on page 2-6

Setting the Administrative Rights on page 2-6

Changing Regional Options on page 2-6

Disabling PC Power Saving Setting on page 2-7

Tracker Box Installation on page 2-7

Setting Up Computer EquipmentIf computer equipment is supplied by Stratex Networks:

Unpack the equipment and verify the computer and accessories received match the equipment ordered, by checking off the packing slip.

If there are any discrepancies between the equipment ordered and the equipment supplied, or if the equipment is damaged, contact the Stratex Networks Help Desk.

Connect accessories and turn computer on.

If the computer equipment is not supplied by Stratex Networks:

Format hard drive/s and install Windows operating system, if not already installed.

Connect accessories and turn computer on.

Setting the Administrative RightsEnsure you have admin rights for the PC on which you are installing the ProVision Server software. If you do not have the correct rights, the software does not install correctly.

Changing Regional OptionsThe Regional (date and time) location must be set to an English based locale. This is so ProVision can correctly interpret the date and time of events entering the system.2-6 Stratex Networks

ProVision V Installation and Administration GuideDisabling PC Power Saving SettingBy default, computers with Windows 2000 installed go into standby power mode after 15 minutes of operation. This needs to be disabled for ProVision computers as this results in clients being unable to logon to the server.

This procedure must be performed for all server and client Windows-based computers using ProVision.

To disable power saving mode:

1. Select Start > Settings > Control Panel > Power Options.

The Power Options Properties window is displayed.

2. Change the System standby to Never.

3. To save your changes, click OK.

Tracker Box InstallationThe Tracker Box installation consists of:

Connecting the Tracker Box

Setting the Ring Cadence614-330053-001 Rev 007 April 2005 2-7

ProVision V Installation and Administration GuideConnecting the Tracker Box

Follow the connection instructions label on the top of the Tracker Box.

Setting the Ring Cadence

In some cases, it is necessary to configure the Trackers Country of installation setting to enable an outside connection to be made to the unit via the telephone connection and the PSTN.

If the Tracker box is connected to a telephone line and the device does not answer when called from outside, then more than likely the problem is related to the Tracker not recognizing the ringing cadence (frequency of occurrence of ringing signal) and therefore not recognizing that it is being called.

To change the Country of installation setting you need to connect to the tracker via a Telnet session.614-330053-001 Rev 007 April 2005 2-8

ProVision V Installation and Administration GuideConnecting Via a Telnet Session

The tracker has an RJ45 connection which is used for connecting to the Local network. This port will be used to connect to a computer, to enable the initial configuration.

The default IP address assigned to the Tracker box is 192.168.1.1 mask 255.255.255.0

The computer (laptop) must be assigned an IP address which is in the same network range, but with a different host ID to that of the Tracker box.

Configuring the Network and Host IP Address

1. Configure a laptop computer with IP address 192.168.1.5

2. Select Start > Settings > Network and Dial up Connections > Local Area Connection > Properties.

The Local Area Connection Properties window is displayed.614-330053-001 Rev 007 April 2005 2-9

3. Select TCP/IP and click Properties.

4. Enter the IP address192.168.1.5

5. Click OK.

The computers IP address is set to 192.168.1.5.

Connecting the Computer to the Tracker Box

There are two ways that the computer may be connected to the Tracker using the Ethernet connection.

Using a Hub Switch

Connecting the computer and Tracker box to the hub, using straight Cat 5 connections.

Using a crossover cable

Connecting the computer directly to the Tracker using a Cat 5 crossover cable.2-10 Stratex Networks

ProVision V Installation and Administration GuideConfirming Communication

To confirm you have communication:

1. Open a DOS window.

2. At the command prompt, typePing 192.168.1.1614-330053-001 Rev 007 April 2005 2-11

Opening a Telnet Session

To open a Telnet session to the Tracker box:

1. At the DOS prompt, type Telnet 192.168.1.1

2. Type the login and password entries.

The Tracker Configuration Menu window is displayed.

The login is admin.The password is admin.2-12 Stratex Networks

ProVision V Installation and Administration GuideChanging the Ring Cadence

To change the ring cadence:

1. Type 1 for System Settings.

2. Type 9 for country of installation.The default country of installation is typically UK.

The countries to choose from are:

3. Change this setting to the name of your country, for example, France.

The System Settings window is updated and displays the new country of installation.

4. To return to the Trackers main configuration window, type x.5. To Commit Changes and Restart, type 10.6. To close the Telnet session, click the x button in the top right corner of the

Telnet window.

7. Disconnect the computer from the Tracker box.614-330053-001 Rev 007 April 2005 2-13

8. Contact the Stratex Networks Help Desk and inform them the installation is complete and the Tracker Box is connected.

9. Unplug the phone line if it is shared with other phones, or if you do not want unauthorized access.

The Stratex Networks Help Desk will request you reconnect the phone line when you request they configure the Tracker Box or you request support from them.2-14 Stratex Networks

ProVision V Installation and Administration GuideInstallation ProceduresThe installation tasks are performed in the following order:

ProVision Server computer

Install the ProVision Server software

Install the ProVision Client software

Install the Portal software (if required)

ProVision Client computer(s)

Install the ProVision Client software

Installing ProVision Server SoftwareTo install the ProVision server software:

1. Insert the ProVision Installation CD in the CD-ROM drive.

2. Via Windows Explorer access the CD directory.

3. Double-click the Server_setup file.

The License Agreement window is displayed.

4. Read the license details. To accept the license, click I Agree.614-330053-001 Rev 007 April 2005 2-15

5. Follow the installation instructions, accept all defaults, and install the server software in the default location.

The server installation and set up is detailed in a command window.

6. To close the server setup window when the setup has completed, click Close.

Once the server installation is completed the ProVision server starts automatically and runs in the background.2-16 Stratex Networks

ProVision V Installation and Administration Guide7. To verify that the ProVision server is running:

Select Start > Programs > ProVision V Server > C:\ command window. At the prompt, type pv service start

A message is displayed indicating the server is already running.

If the server is not already running, this command starts the server.

Installing ProVision Client Software

There are two ways the client software can be retrieved/installed onto a ProVision client PC.

Via the ProVision installation CD from the server or client PCs CD-ROM. This is the method described in Client Software Installation Via CD on page 2-18.

Via browser access the client PC installs the ProVision client software from the server. This option would be used, for example, if the client PC does not have a CD-ROM drive. For more information, refer to Client Software Installation From the Server on page 2-19.

Prerequisites

The ProVision server software is installed on the server computer.

The client and server computers are on the LAN.

The client software must be installed on the server and on each of the client PCs.614-330053-001 Rev 007 April 2005 2-17

Client Software Installation Via CD

To install the ProVision client software from CD:

1. Insert the ProVision Installation CD in the CD-ROM drive.

2. Click client_setup.exe.

3. Click Open.

4. Follow the installation instructions, accept all defaults, and install the client software in the default location.

5. When the installation is completed, click Close.

6. Remove the ProVision Installation CD.

Client software can be uninstalled. For more information refer to Uninstalling ProVision Client Software on page 2-24.2-18 Stratex Networks

ProVision V Installation and Administration GuideClient Software Installation From the Server

You can install a client from the Server if you do not have a CD-ROM drive or do not have the ProVision CD-ROM. You need to know the servers IP address to access the ProVision client software. If you are unsure of the IP address refer to Determining the Servers IP Address on page 4-3.

To install the ProVision client software from the server computer:

1. On the client computer open a web browser window.

2. In the Address text entry box, type http://:8080

The servers directory listing is displayed.

3. Click the client_setup.exe.

4. Click Open.

The ProVision client software must be installed on the server before running this installation.

8080 is the default port for the http service.614-330053-001 Rev 007 April 2005 2-19

5. Follow the installation instructions, accept all defaults, and install the client software in the default location.

6. When the installation has completed, click Close.2-20 Stratex Networks

ProVision V Installation and Administration GuideInstalling Portal Software on ServerThe Portal software is only required where the network contains Eclipse radios. Once installed Portal can be accessed via the Start menu and from within ProVision.

To install the Portal software:

1. Insert the Eclipse Installation CD in the CD-ROM drive.

2. From the CD, run the Eclipse Portal.exe file.

3. Follow the installation instructions and accept the defaults or customize as required.

4. On the Update ProVision Server window; click the Update Portal on ProVision Server option and click Install.614-330053-001 Rev 007 April 2005 2-21

The Portal installation is complete when the Install Complete window is displayed.

5. To finish the installation, click Done.

6. Remove the Eclipse Installation CD.2-22 Stratex Networks

ProVision V Installation and Administration GuideUninstallation Procedures

Uninstalling ProVision Server Software

You must uninstall the ProVision server software prior to upgrading ProVision to a newer version.

To uninstall the ProVision Server software:

1. Close client sessions.

2. Stop the ProVision server.

3. Select Start > Programs > ProVision V Server > Uninstall ProVision V.

The Uninstall Server Confirmation window is displayed.

4. Click Uninstall.

5. Click Close.

Before uninstalling the server software you need to backup the database and export the topology. For more information, refer to Chapter 8.614-330053-001 Rev 007 April 2005 2-23

Uninstalling ProVision Client SoftwareUpgrading to new version of ProVision software or upgrading to a new computer.

To uninstall the ProVision client software:

1. Ensure there is no client session running on this machine.

2. Select Start > Programs > ProVision V Client > Uninstall ProVision V.

The Uninstall Client Confirmation window is displayed.

3. Click Uninstall.

4. Click Close.

What Next?The next steps are:

Licensing ProVision, documented in Chapter 4.

Setting Up ProVision, documented in Chapter 5.2-24 Stratex Networks

Chapter 3. Upgrading to ProVision V

This chapter details the procedures required to upgrade to ProVision V from:

ProVision 2.3 or 3.0

ProVision V 5.3 to ProVision V 5.4

Earlier versions of ProVision V (excluding 5.3) to ProVision V v5.4

PrerequisitesThe prerequisites for upgrading ProVision are:

ProVision V Installation CD

ProVision 2.3/3.0 Topology Migration Tool

ProVision 5.3 to 5.4 Database Migration Tools

Eclipse Installation CD - required if the network has Eclipse radios deployed

Windows PC or Sun Server/Workstation - ProVision server614-330053-001 Rev 007 April 2005 3-1

Procedures

Upgrading From ProVision 2.3/3.0 To ProVision V v5.4Upgrading from ProVision 2.3 or ProVision 3.0 to ProVision V v5.4 requires the following procedures:1. ProVision 2.3/3.0 Sun server1. Install and run the topology migration tool which exports the network

topology to CemfExport.xml. Refer to ProVision 2.3/3.0 - Topology Migration Tool for the procedure.

2. ProVision V server1. Install the ProVision V v5.4 server and client software, refer to Chapter 2.

2. If there are Eclipse radios on the network install the Portal software, refer to Chapter 2.

3. If a permanent ProVision V license has been purchased, refer to Chapter 4. for license installation instructions.

4. Copy the topology file, CemfExport.xml to the ProVision V server.

5. Start a ProVision V client on the server and import the topology file. For importing topology file instructions, refer to Chapter 7.

6. Set up ProVision. Refer to Chapter 5.3-2 Stratex Networks

ProVision V Installation and Administration GuideProVision 2.3/3.0 - Topology Migration Tool

This tool extracts the network topology information from ProVision, outputs a ProVision V compatible topology file, and a log file which you can view to see any problems that were encountered.

During the duration of the topology export a window is displayed detailing what is happening and how long the export is estimated to take.

Objects with an illegal character are not exported, an error message is displayed and the objects data is listed in the export log. These objects must be manually deployed in ProVision V.614-330053-001 Rev 007 April 2005 3-3

To install and run the topology migration tool:

1. Copy the file TopologyExport_x.x.x.tar to the directory in which the tool is to be installed.

2. Extract the file TopologyExport_x.x.x.tar

tar xvf TopologyExport.tar3. Change to the newly created directory

cd TopologyExport4. Run the install script

./installThis configures the environment the tool runs in.

If you are running a Solaris 2.6 system, you will be asked to install patches. Enter 'y' to install them. After installing the patches you will be told that it may be necessary to restart your system; you do not have to do this.

This will also configure a Java runtime environment for this tool. You will be asked to accept the terms and conditions of the Java environment. After accepting these, Java will be installed and the tool is ready to run.

5. Run the tool

./exportThis creates two files, the export.log, and a file CemfExport.xml that is used to import your ProVision network topology into ProVision V.3-4 Stratex Networks

ProVision V Installation and Administration GuideView the Export Log File

If there are objects with duplicate names, the first occurrence will be exported with the name unchanged, further occurrences retain the original name but with a number in brackets added to the end of the name.

The export.log provides a summary of problems encountered during the export, and the corrective action taken.

Edit the Topology File (CemfExport.xml)

Objects will not export properly if they have an unrecognized radio type or are not reachable through the network. The tool includes as much information as possible about the object and it is commented out in the topology file. When this occurs, you are notified by a warning message. Once the export is complete, you can edit the file to uncomment the affected radios.

For example, when Altium radios are not reachable through the network the type of Altium cannot be determined and are exported as "altiumUnknown" and commented out.614-330053-001 Rev 007 April 2005 3-5

If your network has Altium radios use the following procedure to ensure each radio has the correct radio type in the export file:

1. Open CemfExport.xml.

2. Search the export file for occurrences of the Altium radios. The code will look similar to the following:

3. Change "altiumUnknown" to the correct radio type:

Altium 1 = "altium"

AltiumMX = "altiumMX"

AltiumMX 2+0 = "altiumMX2+0"3-6 Stratex Networks

ProVision V Installation and Administration Guide4. Remove the comment tags at the beginning, "" of the radio description.

If the radio was an Altium 1, the initial and edited code would look like:

5. Save and close the file.

Initial Code Edited Code

Altium-172.16.88.4/DoubleSite/Site-1/Altium-172.16.88.4172.16.88.4falsetruefalsepublicprivatefalse2ctrueconnecting

614-330053-001 Rev 007 April 2005 3-7

Upgrading ProVision V 5.3 to 5.4In this upgrade process your ProVision V database is exported and then imported when the new 5.4 ProVision V server and client software has been installed

The migration tool has two parts:1. Database Export and Conversion This is a standalone command line program that runs in the ProVision server director. It exports the current active ProVision database to an intermediate XML format. The converter then parses and modifies the XML files as necessary to convert the database from 5.3 to 5.4.

For this release the conversion includes:

Adds 15_minute_performance and daily_performance properties to TNET devices, which by default are false.

Removes the properties, state, next_state and is_agent from DXR devices.

Migrates the old services from 5.3 to the service table used in 5.4 and deletes the old service properties.

2. Database ImportThis is built into ProVision and is launched using a server command,pv import This performs a db reset and then loads the XML files contained in the into the database. It also checks for db version compatibility.

.

Perform the following procedure to upgrade from ProVision 5.3 to 5.4:

1. Export the topology file. Refer to Chapter 7.

2. Backup the ProVision V database. Refer to Chapter 8.

3. Copy the topology file and database to another folder not located in \ProVisionServer directory. Refer to Chapter 8.

4. Copy the ProVision license file, provision_license.xml, to another folder not located within \ProVisionServer directory.

5. Close all open applications.

6. From the ProVision Installation CD, copy the database migration tools, into the ProVisionVServer directory.

migration.jar and migration.bat

Scoreboards, customized event browsers and NBI configurations are not migrated from ProVision 5.3 to 5.4.3-8 Stratex Networks

ProVision V Installation and Administration Guide7. At the ProVision command prompt, typemigrate .

This provides the destination directory for the migrated database intermediate XML file.

8. Uninstall the ProVision Server and Client software. Refer to Chapter 2. .

9. Install the released ProVision Server and Client software. Refer to Chapter 2.

10. At the ProVision command prompt typepv import This provides the directory location of the migrated database intermediate XML file.

11. Copy the license file back to the folder \ProVisionServer.

12. Stop and restart PV Server. Refer to Chapter 8.


14. Start a ProVision Client session.



Ensure the is not located in \ProVisionServer directory so it will be deleted during the uninstall of PV V 5.3.1.614-330053-001 Rev 007 April 2005 3-9

Upgrading earlier ProVision V versions (excluding 5.3) to v5.4

Upgrading from an earlier version of ProVision V to v5.4 requires performing the following procedures:



3. Copy the topology file and database to another folder not located in \ProVisionServer directory. Refer to Chapter 8.

4. Copy the ProVision license file, provision_license.xml, to another folder not located within \ProVisionServer directory.

5. Uninstall the ProVision Server and Client software. Refer to Chapter 2.

6. Install the released ProVision Server and Client software. Refer to Chapter 2.

7. Copy the license file back to the folder \ProVisionServer.

8. Stop and restart PV Server. Refer to Chapter 8.


10. Import the topology file. Refer to Chapter 7.

11. Set up ProVision. Refer to Chapter 5.

Earlier versions of the ProVision V database are not compatible with ProVision V v5.4. This means you cannot restore an earlier version of the ProVision V database. However, you can import a topology file exported from a previous version of ProVision V.3-10 Stratex Networks

Chapter 4. Licensing ProVision

ProVision V solution packs group software and node licenses together in five packages depending on network size.

All solution packs include:

ProVision V software

All node licenses

1-Year Synergy

8 x 5 Help Desk support for 20 Nodes

24 x 7 support for all others

Remote access device

The following ProVision solution packs are available:

20 Nodes

100 Nodes

500 Nodes

1000 Nodes

3000 Nodes

For licensing purposes one node equals a unit that has one, or more, IP address, for example, one license per Eclipse node. Only the ProVision server software requires licensing.

A remote access device has been included in each solution pack to allow remote

The servers IP address must be supplied when requesting a license.614-330053-001 Rev 007 April 2005 4-1

support.

Trial Evaluation ProVision LicenseAs soon as the server software install is complete, the 30-day license trial automatically begins. You have 30 days trial use of the ProVision V server software. By the end of this trial period you have to obtain, and install a permanent license to continue to use the software.

Starting five days prior to the evaluation license expiring, each day the ProVision Manager will generate an event warning that the evaluation license is due to expire. The event can be viewed in the main Event Browser or by right-clicking on the ProVision V Manager icon and selecting Event Browser from the popup menu displayed.Figure 4-1. License Expiry Warning Event

A critical event is generated on the day prior to the trial license expiring. If the system does not find an updated license file when the 30-day trial period has expired all ProVision user sessions are be closed and you will not be able to start a new session. The following message is displayed indicating the license has expired.Figure 4-2. Evaluation License Expiry Message4-2 Stratex Networks

ProVision V Installation and Administration GuidePermanent Server License ApplicationThe installation of a permanent or extended evaluation license enables ProVision to operate normally, beyond the 30-day license trial period. To apply for a permanent server license, refer to Requesting a Permanent License on page 4-4.

Licensing Procedures

Determining the Servers IP AddressThe ProVision Servers IP address is required for the following:

Requesting a permanent license

Installing client software from the Server

Logging on to a ProVision Client session

To determine the servers IP address:

1. On the Server, select Start > Run.

The Run window is displayed.

2. Type cmd in the dialog box and click OK.A command window is displayed.614-330053-001 Rev 007 April 2005 4-3

3. At the prompt, typeipconfigThe computers IP details are displayed.

4. Write down the IP address.

5. Close the window.

Requesting a Permanent LicenseTo request a permanent license:

1. On the ProVision CD, find the license.txt file.

2. Fill in the required information.

3. Email this information to [email protected].

A license file is sent via email within three working days.

Activating ProVision Server LicenseUse the license file from Stratex Networks, sent as an email attachment.

To activate the ProVision Server license:

1. Select Start > Programs > ProVision V Server > C:\ Command Window.

2. At the prompt, type pv service stop3. Press Enter.

A message is displayed indicating the ProVision server has stopped.4-4 Stratex Networks

ProVision V Installation and Administration Guide4. Using Windows Explorer, copy the new provision_license.xml file to the ProVision Server folder.

5. To overwrite the old licence file with the permanent license, click Yes.

6. In the ProVision command window, type pv service start614-330053-001 Rev 007 April 2005 4-5

7. Press Enter.

A message is displayed indicating the ProVision server has started.

8. To start the ProVision Client, select Start > Programs > ProVision V Client > ProVision V Client.

9. To verify the new license is running, login to ProVision and select Help > License Details.4-6 Stratex Networks

Chapter 5. Setting Up ProVision

The ProVision server and client PCs have been installed and configured. The operating system and ProVision software have been installed and licensed. This chapter details the procedures to get ProVision running, enabling you and the NOC operators to manage the network.Figure 5-1. Setting Up ProVision Process Overview614-330053-001 Rev 007 April 2005 5-1

PrerequisitesTable 5-1 provides details of the information required to set up ProVision.

Table 5-1. Setting Up ProVision Prerequisites

Prerequisite Description

Maps The maps files required as backgrounds for the network, on the ProVision user interface.

ProVision supports the following image formats:

jpg

gif (GIF87 and GIF89a)

Note: You can use a search engine to find websites, which provide maps for countries, regions, and cities that you can download and use in ProVision.

Copy background maps into the ProVision directory \ProVisionVServer\Maps

Network Topology If upgrading from ProVision 3 you will need the network topology file which can be imported into ProVision V.

For a new network you will need a plan of the network regions, sites, racks, radios, and links to be deployed and managed in ProVision. You need this to set up the network in the ProVision user interface and if required service links between devices.

Service Topology (optional) A list of the Services (logical groupings of devices) required and the devices that are to be included in each Service.

List of the IP addresses of the radios to be deployed in the network.

The radios IP address is required when deploying the radio.

List of the ProVision users and their security group.

Required to add new ProVision users.

List of radio usernames and passwords. Applicable for XP4 radios. If a user name and password has been physically set up in the radio, you need to know what these are so you can enter the details into ProVision.5-2 Stratex Networks

ProVision V Installation and Administration GuideSetting Up ProceduresThe procedures required to set up ProVision to actively monitor and report on the radio network are detailed in Table 5-2.

Table 5-2. ProVision Set Up Procedures

Northbound Interface To configure the Northbound Interface the following are required:

IP address of north computer

Type of traps required

You also need to know if traps are to be sent and/or information sent to an ASCII-based file on the ProVision server.

Database purging criteria You need to determine how often the events and performance data should be deleted from the ProVision database.

Prerequisite Description

Procedures Description Reference

Start an admin ProVision client

The setting up procedures are performed via the ProVision user interface which is opened for a user session.

ProVision User Guide, Chapter 2 - Starting a User Session

Change the admin login password

For security purposes you must change the admin password.

ProVision User Guide, Chapter 2 - Getting Started, Changing Your Password

Set up network If upgrading import the network topology file from ProVision 3.

ProVision Installation and Administration Guide, ProVision 2.3/3.0 - Topology Migration Tool on page 3-3

If the network contains TNET devices you need to ensure the TNET proxy and radio details imported into ProVision V match the details stored in the proxy.

ProVision User Guide, Chapter 3 - Deploying and Managing Radios614-330053-001 Rev 007 April 2005 5-3

For a new ProVision network. The order/way in which you set up the network is flexible and the following is a recommendation only:

Add network containers ProVision User Guide, Chapter 3 - Deploying and Managing Radios

Import background maps ProVision User Guide, Chapter 2 - Getting Started

Deploy, link (RF and Service links), and manage devices

ProVision User Guide, Chapter 3 - Deploying and Managing Devices

Add Services

Create Scoreboard Groups

Set up Prefilters

Create customized Event Browsers

ProVision User Guide, Chapter 4 - Managing Events

Set up user accounts Required to use ProVision. Functions a user can perform are determined by their security group.

ProVision Installation and Administration Guide, Chapter 7 - Access Control

Add ProVision V XP4 radio security accounts

Only required for XP4 radios with security enabled, to allow access the radios diagnostics.

ProVision Installation and Administration Guide, Chapter 6. Access Control

Add XP Web security accounts

Only required for XP4 radios with security enabled, to allow access the radios diagnostics Via XP Web.

XP Web applications online help

Set up Northbound Interface

Required when events/traps are to be forwarded as northbound traffic for fault management, or performance date is required for performance data management.

ProVision Installation and Administration Guide, Chapter 9. Northbound Interface (NBI)

Set up database purging This determines how often and what is purged from the database.

ProVision Installation and Administration Guide, Chapter 8. Database Management

Backup the database After completing the ProVision set up, backup the database.

ProVision Installation and Administration Guide, Chapter 8. Database Management

Export the network topology

ProVision Installation and Administration Guide, Topology Export on page 7-4

Procedures Description Reference5-4 Stratex Networks

Chapter 6. Access Control

ProVision User AccessAccess to ProVision functions is controlled by security groups. A security group defines the group of functions to which a user has access. There are two predefined security groups that you can apply to a ProVision user:

NOC Operator

NOC Engineer

Part of an administrators role is to create ProVision user accounts and associate each account with at least one security group. The user account inherits the access control defined by the security groups it belongs to. A user account can belong to different security groups and these groups control their access to the ProVision functions.

Before a user can start ProVision, they must have a username and password. When the user logs in, using the username and password, ProVision validates these before starting the ProVision GUI.

A security log records user activities such as logging in, logging out and changing password. Only you, as administrator have access to the security log.Radio Security AccessXP4 radios have a security system that can be activated. If security access is required for an XP4 radio, the valid usernames and passwords are set up in the radio.

If the security system has been activated, ProVision must have a valid username and password to login into an XP4 radio and access the radios diagnostic

The requirement for XP4 radios to have username and password access enabled is determined by your companys security policy requirements.614-330053-001 Rev 007 April 2005 6-1

functions.

The security group that the ProVision user is assigned to, determines access to the XP4 diagnostics. When a ProVision user selects an XP4 radio diagnostics, ProVision requests access to the radios diagnostics. The request will contain a username and password, that has been set up in ProVision. The radio verifies the data entered and if valid allows the ProVision user access to its diagnostic functions.

ProVision User Security GroupsFigure 6-1 details the ProVision security groups and the functions associated with each group.

Table 6-1. ProVision Functions Access by Security Group

By default, there is one administrator user account that has access to all ProVision functions.

Function NOC Operator

NOC Engineer

Administrator

Launch craft tool/ WMT/ Portal Eclipse

X X X

Use search facility X X X

Configure event forwarding X

Configure platform actions (for example data purging, backup/restore)

X

View / Modify IP address of a deployed device

X X

Managing / Unmanaging X X

Sleep / Wake X X X

Acknowledging/clearing events X X X

View / Modify event log pre-filtering

X X

Diagnostics X X6-2 Stratex Networks

ProVision V Installation and Administration GuideCustomize network events X X

Initiate trouble ticket X X X

View/Modify radio message board X X X

Associate notes X X X

Configure radio X X

Software changes X

Deployment (includes topology import/export, object deletion, renaming)

X X

Enter radio licenses X

Design and configure radio IP network

X

Set network data and time X X

Inventory X X

Performance (monitoring, trend analysis)

X X X

Administer Radio Security X

Control ProVision Access X

View Security log X

Map View (zoom) X X X

Map View (unlock, select background)

X X X

Function NOC Operator

NOC Engineer

Administrator614-330053-001 Rev 007 April 2005 6-3

Practical Applications

When Would I Use Access Control?You would use access control when you want to add new users to the system, remove a user from the system, change a users logon details, and add, change, or delete a radios entry password.

Why Would I Use Access Control?This function can be used to:

Add users

Change users security group

Change user details or password

Delete users

Lock users from the application

Add radio security 6-4 Stratex Networks

ProVision V Installation and Administration GuideAccess Control Process Diagrams

ProVision User Access Control

Figure 6-1 indicates where setting up user access control happens after the ProVision installation.Figure 6-1. User Access Control in the Installation and Set Up Process614-330053-001 Rev 007 April 2005 6-5

Radio Security Access Control

Figure 6-2 indicates where setting up radio security access happens after the ProVision installation.Figure 6-2. Radio Security Access in the Installation and Set Up Process6-6 Stratex Networks

ProVision V Installation and Administration GuideParametersFor each user, you must have the following information:

Full Name or User ID

Contact Details

Default password

For each XP4 radio, if security access is enabled, you must have the radios username and password login details.

InterdependenciesThis section defines the prerequisites and dependencies for access control.

Prerequisites

ProVision V must be installed and running.

You must have the required user information; usernames and passwords.

XP4 radio security username and password.

Dependencies

Each user requires a valid User ID and password before using ProVision V.614-330053-001 Rev 007 April 2005 6-7

Access Control Procedures

Creating ProVision User AccountsEach ProVision user must be assigned a unique login username and password.

A ProVision password must have at least 6 and at most 32 alphanumeric characters, and is case sensitive. Contact details are optional but this is a useful location to store phone numbers and email address information.

A user account can belong to more than one security group.

Figure 6-3 shows of an overview of creating a user account.Figure 6-3. Creating a User Account6-8 Stratex Networks

ProVision V Installation and Administration GuideTo create a user account:

1. Select Administration > ProVision User Accounts.

The ProVision User Accounts window, showing the status of each user account, is displayed.

2. Click Create.

The Create User window is displayed.

3. Type the users name into the User Name field.

4. Type any contact details into the Contact Details entry pane.

5. Click the Security Groups tab.

6. Click on the checkbox of the security group/s the user is to belong to.614-330053-001 Rev 007 April 2005 6-9

7. Click OK.

The Change Password window is displayed.

8. Type a password in the New Password box.

9. Re-type the password in the Confirm New Password box and click OK.

10. To close the ProVision User Accounts window, click Close.6-10 Stratex Networks

ProVision V Installation and Administration GuideViewing/Changing a ProVision User AccountThe following items can be changed in a user account:

Contact Details - users details change due to shifting or new phone number.

Password - user cannot remember password or suspects it is known to other users.

Lock/Unlock the Account - person on holiday or temporarily away

Change the security group - user promoted or requires access to greater functionality.

To view/change a user account:


The ProVision User Accounts window, detailing the user accounts status is displayed.

2. Highlight the user whose details you want to view/change.614-330053-001 Rev 007 April 2005 6-11

3. Click Properties.

The User Properties window is displayed.

4. To close the User Properties window, click OK.

5. To exit the ProVision User Accounts window, click Close.Related Topics Creating ProVision User Accounts on page 6-8

Deleting a ProVision User Account on page 6-13

Activity Procedure

To change the contact details Type the new or changed details in the Contact Details entry pane.

To reset the password 1. Click Password. 2. In the Change Password dialog box, type the

new password and then reconfirm by typing it again.

3. To save the new password and exit the dialog box, click OK.

To change the status of the account

Select the required status, locked or unlocked, from the Status drop-down menu.

To change the selected security group/s

Click on the Security Groups tab.

Make the changes required.6-12 Stratex Networks

ProVision V Installation and Administration GuideDeleting a ProVision User AccountYou would delete a users account when it is no longer required, for example, the person leaves the company.

To delete a user account:


The ProVision User Accounts window is displayed.

2. Highlight the user you want to delete.

3. Click Delete.

The user is deleted from the system and from the User Accounts window.

4. To exit, click Close.Related Topics Creating ProVision User Accounts on page 6-8

Viewing/Changing a ProVision User Account on page 6-11614-330053-001 Rev 007 April 2005 6-13

Viewing the Security LogThe security log enables you to check on ProVision user activities that generate normal and informational ProVision events.

The security log is displayed in an event browser window. You can change and save, the filter settings and browser options just like any other event browser.

To view the security log:

1. Right-click the ProVision Manager icon.

2. Select Security Log from the popup menu displayed.

The Security Log window is displayed.6-14 Stratex Networks

ProVision V Installation and Administration GuideAdding/Editing Radio Security Access AccountsThis function relates to XP4 radios that have access security activated, that is ProVision must provide a valid username and password to access the radios diagnostic functions.

Within ProVision you can set the username and password on a per region, site, or individual radio basis. If all XP4 radios on the network have the same username and password access, select the network and apply the username and password. Where XP4 radios have their own username and password access, enter these individually.

The username and password set up in ProVision must match those stored in the radio. When a ProVision user selects an XP4 radios diagnostics (shown in Figure 6-4) or configuration viewer, ProVision automatically sends the username and password to the radio, the radio verifies the data is valid, and allows ProVision access to its diagnostic functions.

Without a valid password, the radio ignores write data commands, for example, activate a loopback.Figure 6-4. XP4 Radio Diagnostics Menu Option

The username and password entered in ProVision for an individual radio overrides any other username and password set at a higher level in ProVision, for example, a region.614-330053-001 Rev 007 April 2005 6-15

To set or edit XP4 radio security access:

1. Select Administration > Radio Security Accounts.

The Radio Account Administration window is displayed.

2. Highlight the radio/s for which you want to add or edit, the username and password. For example, to apply the same username and password to all XP4 radios in Wellington, select the Wellington container.

3. Click Set/Edit.

The Set/Edit Password window is displayed.

4. Type in the username and press the Tab key.

To display all the XP4 radios, click Expand All Levels.6-16 Stratex Networks

5. Type in the password and press the Tab key.

ProVision V Installation and Administration Guide6. Re-type the password and click OK.

7. If you set the account details at a network, region, or site level, the following window is displayed.

Click OK.

8. To close the Radio Account Administration window, click OK.Related TopicsClearing Radio Security Access on page 6-18614-330053-001 Rev 007 April 2005 6-17

Clearing Radio Security AccessYou would clear the current radio security access details if they do not match the details stored in the radio.

To clear a radios security access details from ProVision:

1. Select Administration > Radio Security Accounts.

The Radio Account Administration window is displayed.

2. Highlight the container or radio to clear the security account details.

3. Click Clear.

The username and password are deleted.

4. To close the Radio Account Administration window, click OK.Related TopicsAdding/Editing Radio Security Access Accounts on page 6-156-18 Stratex Networks

Chapter 7. Migrating Topology

Exporting your networks topology means you never have to rebuild your ProVision network. If something goes wrong with your system, importing the topology restores the network.

ParametersThe following information is contained in the xml topology file:

Object type (container or device)

Object name

Object containment definition

Device IP addresses (primary)

SNMP community strings

Object state (Managed)

Object performance data collection state (daily enabled/disabled, 15-min enabled disabled)

Object coordinates (in Map view)614-330053-001 Rev 007 April 2005 7-1

InterdependenciesThis section defines the prerequisites and dependencies for migrating topology.

Prerequisites When upgrading from ProVision 2.3 or 3.0 to ProVision V 5.4, the topology

export file

The following parameters must be unique:

Object name

Device object IP address (primary)

DependenciesThe following functions are dependent on the network topology:

Northbound Interface7-2 Stratex Networks

ProVision V Installation and Administration GuideTopology Import/Export Procedures

Topology ImportThis function imports a previously exported network topology file. The Tree and Map Viewers are automatically populated with containers and devices.

In a ProVision 2.3/3.0 network topology file, CemfExport.xml, duplicate objects are renamed adding a bracketed number. These duplicate objects are imported into ProVision where you can rename them.

Any problems encountered during the import are displayed in the Import Results panel and recorded in the ProVisionVClient/Provision.log. Objects that were not imported can be manually deployed and managed.

To import a network > topology file:

1. Select File > Topology Import.

The Topology Import window is displayed.

2. Click the ... button.

The Open window is displayed.

3. Browse to the location of the topology file.614-330053-001 Rev 007 April 2005 7-3

4. Highlight the topology file and click Open.

The Open window closes and the Topology Import window is displayed.

5. Click Import.

6. When the import has completed, click Close.

Related Topics

Topology Export on page 7-4

Topology ExportThis function exports the network objects and hierarchy to an .xml file. The network topology can be exported for several reasons, as a backup, for support diagnostic purposes, for 3rd party northbound integration, and for future migrating to a later version of ProVision.

The filename should include the date the file was exported.

To export a network topology file:

1. Select File > Topology Export.

The Topology Export window is displayed.

2. Click the ... button and browse to the location in which to store the topology file.

The Save window is displayed.

3. Type a descriptive name in the File Name field.

4. Click Save.

The Save window closes and the Topology Export window is displayed.

5. Click Export.

The Export Results panel displays any attributes not able to be exported and, that the export is complete.

6. Click Close.

Related Topics

Topology Import on page 7-3

Save the .xml topology file in a folder outside the ProVision software folder. If you do not, the file will be deleted when ProVision is uninstalled.7-4 Stratex Networks

Chapter 8. Database Management

This details the commands and menu options that enable you to effectively manage the ProVision database.

Practical ApplicationsPractical applications addresses the following questions and scenarios:

When Would I Manage the ProVision Database?

Why Would I Manage the ProVision Database?

Workflow Diagrams

When Would I Manage the ProVision Database?When installing or upgrading ProVision, you need to backup the database and the network topology.

If the database gets corrupted, you would need to restore the database from a backup.

Why Would I Manage the ProVision Database?In your role as ProVision Administrator, it is your job to ensure the database is purged and backed up regularly, and check the database integrity.614-330053-001 Rev 007 April 2005 8-1

When Would I Backup the ProVision Database?Table 8-1 answers the most frequently asked questions about backing up.

Table 8-1. Frequently Asked Questions About Backing Up

Backup Related Questions Answers

What gets backed up? The following data is copied to the hard drive when you backup the ProVision database:

Security data

User accounts, security groups, radio security accounts

Configuration data

Deployed network topology, device configuration and status

You also have the option to backup the event and/or the performance data.

How often should I perform a backup? Stratex Networks recommends the following backup procedures:

Daily

Backup the ProVision database to a CD-RW, CD-RO or network drive. For overviews of the recommended daily and weekly backup procedures, refer to Figure 8-1 on page 8-4, and Figure 8-2 on page 8-4.

Monthly

Copy the last database backup to a CD-RO, which is then stored off-site. Figure 8-3 on page 8-5 for an overview of the recommended monthly procedure.

Annually

Backup the network topology file.

Adhoc

Prior to any upgrade of ProVision.

When any significant changes are made to the database, a database backup (including event and performance data) and a copy of the network topology file should be copied to CD.

When should I backup? You should select a time when there is minimal operator activity on ProVision.

When the system is performing a backup, ProVision automatically locks object deployment, alarm processing, software installation, and the network topology.8-2 Stratex Networks

ProVision V Installation and Administration GuideWhat happens during the backup? When you initiate a database backup, ProVision creates a backup folder, copies the database into the folder, and updates the backuplisting.xml file.

The following screen shot shows the location of the backup folder and an example of the naming standard used.

The following diagram shows a breakdown of the naming convention used.

How big are the backup files? The size of the database backup is determined by the following factors:

Number of devices on the network

Type of devices, for example, an XP4 radio generates more events than an Altium radio

Event pre-filtering

Frequency of the database purging

Backup Related Questions Answers614-330053-001 Rev 007 April 2005 8-3

Workflow DiagramsFigure 8-1. Daily Backup Diagram

Figure 8-2. Weekly Backup Diagram8-4 Stratex Networks

ProVision V Installation and Administration GuideFigure 8-3. Monthly Backup Diagram614-330053-001 Rev 007 April 2005 8-5

ParametersTable 8-2 defines the commands accessible via the ProVision Server command window.Table 8-2. ProVision Commands

InterdependenciesThis section defines the prerequisites for managing the database.

PrerequisitesYou must have a ProVision client running to access the following menu options from the user interface:

Database backup

Database purge

For more information on the database purge and backup options, refer to the ProVision User Guide.

Command Description

pv service start Starts the ProVision service

pv service stop Stops the ProVision service

pv service install Installs ProVision as an operating system service

pv service remove Removes ProVision as an operating system service

pv db restore Restores a database backup, launches interactive tool

pv db check Runs an integrity check on the database

pv db reset Destroys all database contents

pv help Displays this message8-6 Stratex Networks

ProVision V Installation and Administration GuideDatabase Management Procedures

Stopping the ProVision ServerThere are times when you will need to stop the ProVision Server, for instance, prior to uninstalling the server software. >

To stop the ProVision Server:

1. Select Start > Programs > ProVision V Server > C:\ command window.

2. At the prompt, type pv service stop

3. Press Enter.

A message is displayed indicating the ProVision server has stopped.

Related Topics Starting the ProVision Server on page 8-7

Backing Up the ProVision Database on page 8-11

Restoring the ProVision Database on page 8-12

Checking the Database Integrity on page 8-15

Changing Database Purging Criteria on page 8-17

Resetting the Database on page 8-18

Starting the ProVision ServerWhen the server computer is turned on, the ProVision Server software automatically starts and runs in the background. However, if you have stopped the ProVision Server, you must manually start the ProVision Server.

To manually start the ProVision Server:

1. Select Start > Programs > ProVision V Server > C:\ Command Window.

2. At the prompt, type pv service start614-330053-001 Rev 007 April 2005 8-7

3. Press Enter.

A message is displayed indicating the ProVision server has started.

Next StepStopping the ProVision Server on page 8-7Related Topics Backing Up the ProVision Database on page 8-11




Resetting the Database on page 8-188-8 Stratex Networks

ProVision V Installation and Administration GuideRemoving ProVision From System ServicesUse this command when you want to start the server computer without the ProVision server starting automatically.

If you have removed ProVision from the system services, you cannot start the ProVision server or a client user session until you install ProVision as a system service.

To remove ProVision from system services:


2. At the prompt, type pv service remove

3. Press Enter.

The command windows message indicates ProVision has been removed.Next StepInstalling ProVision as a System Service on page 8-10Related Topics Starting the ProVision Server on page 8-7

Stopping the ProVision Server on page 8-7






Removing ProVision from the system services does not remove any of the ProVision files.614-330053-001 Rev 007 April 2005 8-9

Installing ProVision as a System ServiceYou would use this command to install ProVision as a system service, if you removed it. Once you have installed ProVision as system service you also need to start the ProVision server.

To install ProVision as a system service:


2. At the prompt, typepv service install

3. Press Enter.

The command windows message indicates ProVision has been installed.Next StepStarting the ProVision Server on page 8-7Related Topics Stopping the ProVision Server on page 8-7

Removing ProVision From System Services on page 8-9






ProVision V Installation and Administration GuideBacking Up the ProVision DatabaseTo manually backup the ProVision database:

1. Start a ProVision user session.

The ProVision user interface is displayed.

2. From the menu bar, select Administration > Database Backup.

The Database Backup window is displayed.

3. In the Backup Descriptions field, type a description of the backup.

4. To include the event and/or performance data, click the required options.

5. Click Backup.

The following screen indicates a successful backup.

6. Click OK.

7. To close the Database Backup window, click the X in the top right corner.Related Topics Restoring the ProVision Database on page 8-12




The description you enter is written in the backuplisting.xml file, located in the \ProVisionVServer\MySQL\Backup folder.614-330053-001 Rev 007 April 2005 8-11

Restoring the ProVision DatabaseYou would restore the ProVision database from a backup if the database were corrupted. The restore overwrites the existing data in the database with the backup data.

Database backups can be stored locally on the Server hard drive, on a network drive, or externally on a CD.

For ProVision to restore from a backup, the backup folder and backuplisting.xml file must be in the following directory:

\ProVisionVServer\mysql\backup

To restore the ProVision database:

1. Ensure the backup folder and backuplisting.xml file are in the following directory:

\ProVisionVServer\mysql\backup

If you are restoring from a backup that has been stored on CD, you must remove the Read-only setting from its Properties.8-12 Stratex Networks

ProVision V Installation and Administration Guide2. Stop all client sessions, by having the operators log off from ProVision.


4. At the prompt, type pv db restoreThe following message is displayed indicating ProVision needs to be shutdown.

5. To close the ProVision server, press Enter.

The Restore Database window is displayed, listing the backups.

6. Select the required backup and click Restore.614-330053-001 Rev 007 April 2005 8-13

7. To observe the restore actions, click the Command Window screen.

When the restore is complete, the following message window is displayed.

8. Click OK.

9. To close the Restore Database window, click Exit.

10. To restart the ProVision server, type pv service start

11. To start a ProVision user session and verify the restore was successful, select Start > Programs > ProVision V Client > ProVision V Client.

Next StepChecking the Database Integrity on page 8-15Related Topics Starting the ProVision Server on page 8-7



ProVision V Installation and Administration GuideChecking the Database IntegrityYou would check the databases integrity if ProVision is not displaying information

ProVision Installation and Administration Guide

Documents

trademarks of stratex

obligation of stratex

stratex networksregus

local stratex networks

registered trademarks

stratex networksall

contact information

regional technical help