Netcool Wireless Admin Guide

8/2/2019 Netcool Wireless Admin Guide

1/188

Administration Guide

Netcool Performance Manager for Wireless

Version 9.1.2


2/188

Note

Before using this information and the prod uct it supp orts, read the information in Notices and Tradem arks on page 171.

This edition applies to version 9.1.2 of Tivoli Netcool Performance Manager for Wireless and to all subsequent releases and

modifications until otherwise indicated in new editions.

This edition replaces 0000-0000-00.

Copyright International Busin ess Machines Corporation, 2008. All rights reserved.

US Government Users Restricted Rights - Use, duplication or disclosure restricted by GSA ADP Schedule Contract with IBM Corp.


3/188

Copyright IBM Corp. 2008 iii

Contents

1 About This Documentation . . . . . . . . . . . . 1Audience. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1

Required Skills and Knowledge . . . . . . . . . . . . . . 1

Document Conventions . . . . . . . . . . . . . . . . . . . . 1

Blank pages . . . . . . . . . . . . . . . . . . . . . . . . . . . 2

Document Structure . . . . . . . . . . . . . . . . . . . . . . . 3

User Publications . . . . . . . . . . . . . . . . . . . . . . . . 3

Viewing the Online Help . . . . . . . . . . . . . . . . 4

Viewing the Publications in PDF . . . . . . . . . . 4

2 Tivoli Netcool Performance Manager forWireless Architecture Overview . . . . . . . . 5Introduction . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5

Listing current software versions . . . . . . . . . . 5

Server Layer . . . . . . . . . . . . . . . . . . . . . . . . . . 6Client Layer . . . . . . . . . . . . . . . . . . . . . . . . . . 7

Tivoli Netcool Performance Manager for Wireless

Server Architecture - The Core Framework . . . . 8

Technology Packs . . . . . . . . . . . . . . . . . . . . . . 8

Extraction, Transformation and Loading (ETL)

Data Layer . . . . . . . . . . . . . . . . . . . . . . . . . . . 9

Tivoli Netcool Performance Manager for

Wireless Application Framework . . . . . . . . . . 9

Summaries . . . . . . . . . . . . . . . . . . . . . . . . . . . 10

Services . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10

Client Operation Functions . . . . . . . . . . . . . . . 11

Server Operation Functions . . . . . . . . . . . . . . . . 13

3 Setup Tasks . . . . . . . . . . . . . . . . . . . . . . . 15Overview . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 15

Software Install Summary . . . . . . . . . . . . . . . . . 16

Datasource setup . . . . . . . . . . . . . . . . . . . . . . . . 16

LDAP - Directory Server setup . . . . . . . . . . . . . 16

Crontab setup . . . . . . . . . . . . . . . . . . . . . . . . . . 17

Virtuo User setup . . . . . . . . . . . . . . . . . . . . . 17

Root User Setup . . . . . . . . . . . . . . . . . . . . . . 18

Additional entries and scripts . . . . . . . . . . . . 18

SAP setup . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 19

SAP configuration . . . . . . . . . . . . . . . . . . . . 19

4 Starting and Stopping Tivoli NetcoolPerformance Manager for Wireless . . . . 23Overview . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 23

Oracle Database . . . . . . . . . . . . . . . . . . . . . . . . . 24

Starting the Oracle Database . . . . . . . . . . . . . 24

Stopping the Oracle Database . . . . . . . . . . . . 24

Directory Server . . . . . . . . . . . . . . . . . . . . . . . . . 24

Starting the Directory Server . . . . . . . . . . . . 24

Stopping the Directory Server . . . . . . . . . . . 24

Process Monitor . . . . . . . . . . . . . . . . . . . . . . . . . 24

Starting the Process Monitor . . . . . . . . . . . . . 24

Stopping the Process Monitor . . . . . . . . . . . . 25

Process Manager . . . . . . . . . . . . . . . . . . . . . . . . . 25

Starting the Process Manager . . . . . . . . . . . . 25

Stopping the Process Manager . . . . . . . . . . . . 25Tivoli Netcool Performance Manager for Wireless

25

Starting Tivoli Netcool Performance Manager

for Wireless . . . . . . . . . . . . . . . . . . . . . . . . . . 25

Stopping Tivoli Netcool Performance Manager

for Wireless . . . . . . . . . . . . . . . . . . . . . . . . . . 26

NetworkAssure Complete startup and shutdown 26

NetworkAssure Complete Startup . . . . . . . . . 26

Tivoli Netcool Performance Manager for Wire-

less Complete Shut down . . . . . . . . . . . . . . . . 27

5 Tivoli Netcool Performance Manager for

Wireless Application Administration . . . 29User Administration . . . . . . . . . . . . . . . . . . . . . . 30Overview. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 30

User Administration Basics . . . . . . . . . . . . . . . . 31

Tivoli Netcool Performance Manager for Wire-

less Users . . . . . . . . . . . . . . . . . . . . . . . . . . . . 31

Groups . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 31

Roles . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 32

Privileges . . . . . . . . . . . . . . . . . . . . . . . . . . . . 32

User Management . . . . . . . . . . . . . . . . . . . . . . . 36

Adding Users . . . . . . . . . . . . . . . . . . . . . . . . . 36

Editing Users . . . . . . . . . . . . . . . . . . . . . . . . . 37

Deleting Users . . . . . . . . . . . . . . . . . . . . . . . . 37

Creating and Deleting Groups . . . . . . . . . . . . 38Adding and Removing Users to/from Groups 39

Assigning and de-assigning Users to/from a

Role . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 39

Role Management . . . . . . . . . . . . . . . . . . . . . . . 40

Creating and Deleting Roles . . . . . . . . . . . . . 40

Assigning/De-assigning Privileges to a Role 41

User Administration Command Line Tool . . . . . 42

Usage . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 42

Listing Users . . . . . . . . . . . . . . . . . . . . . . . . . 43

Adding Users . . . . . . . . . . . . . . . . . . . . . . . . . 43

Modifying a Users password . . . . . . . . . . . . 44

Deleting Users . . . . . . . . . . . . . . . . . . . . . . . . 44

6 Tivoli Netcool Performance Manager forWireless Operations Tasks . . . . . . . . . . . 45Daily Loader Operations Tasks . . . . . . . . . . . . . 45

Checking Loader Status . . . . . . . . . . . . . . . . . 45

Checking for bad files . . . . . . . . . . . . . . . . . . 46

Loader Housekeeping . . . . . . . . . . . . . . . . . . . . . 49

Disk Space Usage . . . . . . . . . . . . . . . . . . . . . 49

Checking TFP_SHM_MIN_SIZE. . . . . . . . . . . . 49


4/188

iv Tivoli Netcool Performance Manager for Wireless: Adm inistration Gu ide

TFP_NC_STABILITY. . . . . . . . . . . . . . . . . . . . 51

7 Datasource, Agent and KPI CacheAdministration . . . . . . . . . . . . . . . . . . . . . 53Datasource Administration . . . . . . . . . . . . . . . . 54

Usage . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 54

Listing Datasources . . . . . . . . . . . . . . . . . . . . 55

Activating a Datasource . . . . . . . . . . . . . . . . 55

Deactivating a Datasource . . . . . . . . . . . . . . 55

Agent Maintenance . . . . . . . . . . . . . . . . . . . . . . 56

Overview of Agent Activities . . . . . . . . . . . . 56

Agent activities and log files . . . . . . . . . . . . . 58

agent_admin Command Line Tool . . . . . . . . 58

KPI Cache Management . . . . . . . . . . . . . . . . . . 65

Exporting User Defined Calculations . . . . . . 65

Importing User Defined Calculations . . . . . . 65

Synchronize internal computation engine KPI

cache . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 66

8 System Maintenance . . . . . . . . . . . . . . . . 69Overview . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 69

Schedule Administration . . . . . . . . . . . . . . . . . . 70

Scheduled Jobs . . . . . . . . . . . . . . . . . . . . . . . 70

Usage . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 71

Scheduling System Maintenance . . . . . . . . . 72

Listing the Status of All Scheduled Jobs . . . 72

Administrative Options for schedule_admin

Script . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 73

Reporting on the Server Status . . . . . . . . . . . . . 75

Database Check . . . . . . . . . . . . . . . . . . . . . . . 75

Listener Check . . . . . . . . . . . . . . . . . . . . . . . 75

Directory Server Check . . . . . . . . . . . . . . . . . 75

SAPMON Check . . . . . . . . . . . . . . . . . . . . . . 76


Wireless Check . . . . . . . . . . . . . . . . . . . . . . . 76

Log Files Check . . . . . . . . . . . . . . . . . . . . . . 76

Database Monitoring . . . . . . . . . . . . . . . . . . . 77

Unix System Monitoring . . . . . . . . . . . . . . . . 77

CPU Sanity Check . . . . . . . . . . . . . . . . . . . . 78

Managing the Oracle Database . . . . . . . . . . . . . 79

Starting and Stopping the Oracle Database . 79

Types of Oracle Backups . . . . . . . . . . . . . . . 80

Completing an Online Backup . . . . . . . . . . . 82

Completing an Offline Backup . . . . . . . . . . . 83

Exporting Oracle Data . . . . . . . . . . . . . . . . . 83Importing Oracle Data . . . . . . . . . . . . . . . . . 84

Redo Logs . . . . . . . . . . . . . . . . . . . . . . . . . . . 85

Archiving Redo Logs . . . . . . . . . . . . . . . . . . 86

Performing Hardware Diagnostics . . . . . . . . 88

Restoring Data From Backups . . . . . . . . . . . 88

Database Space Management . . . . . . . . . . . . . . 89

Usage . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 89

Monitoring Oracle Tablespaces . . . . . . . . . . 89

Increasing Tablespace Size . . . . . . . . . . . . . . 91

Recover from a Full Tablespace . . . . . . . . . . 92

Partition Maintenance . . . . . . . . . . . . . . . . . . . . 93

Partition Maintenance Jobs . . . . . . . . . . . . . . 93

Partition Maintenance Command Line Tool . 93

Adding Partitions . . . . . . . . . . . . . . . . . . . . . . 96Deleting Partitions . . . . . . . . . . . . . . . . . . . . . 96

Pinning Partitions . . . . . . . . . . . . . . . . . . . . . 97

Unpinning Partitions . . . . . . . . . . . . . . . . . . . 97

Exporting Partitions . . . . . . . . . . . . . . . . . . . . 97

Importing Partitions . . . . . . . . . . . . . . . . . . . . 98

Showing Parameters . . . . . . . . . . . . . . . . . . . 98

Listing Parameters . . . . . . . . . . . . . . . . . . . . . 98

Updating Parameters . . . . . . . . . . . . . . . . . . . 98

Listing Partitions . . . . . . . . . . . . . . . . . . . . . . 99

List Pinned Partitions . . . . . . . . . . . . . . . . . . 99

List Sessions . . . . . . . . . . . . . . . . . . . . . . . . . 99

Update Sessions . . . . . . . . . . . . . . . . . . . . . . . 99

List Spaces . . . . . . . . . . . . . . . . . . . . . . . . . . 100Show Logs . . . . . . . . . . . . . . . . . . . . . . . . . . 100

Show Errors . . . . . . . . . . . . . . . . . . . . . . . . . 100

Show Status . . . . . . . . . . . . . . . . . . . . . . . . . 100

Managing Disk Space Usage . . . . . . . . . . . . . . 101

Monitoring the Oracle Storage Directories . 101

Monitoring the $WMCROOT/logs Directories .

101

Monitoring the $WMCROOT/var/loader/spool

Directories . . . . . . . . . . . . . . . . . . . . . . . . . . 102

Reporting the Size of the File systems . . . . 102

Backing up the File System . . . . . . . . . . . . . . . 103

Working with Log Files . . . . . . . . . . . . . . . . . . 104Information about Log Files . . . . . . . . . . . . 104

Removing Log Files . . . . . . . . . . . . . . . . . . 106

Archiving Log Files . . . . . . . . . . . . . . . . . . . 106

9 Tools . . . . . . . . . . . . . . . . . . . . . . . . . . . . 109Overview. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 109

Importing and Exporting User Documents and Re-

port Results . . . . . . . . . . . . . . . . . . . . . . . . . . . . 110

Importing definitions, templates, schedules and

folders . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 110

Exporting definitions, templates and schedules

111

Importing report results . . . . . . . . . . . . . . . . 112

Exporting report results . . . . . . . . . . . . . . . . 114Time Zone Support for Reporting . . . . . . . . . . 115

About Daylight Saving Time Rules . . . . . . 115

About Time Zone Regions . . . . . . . . . . . . . 118

Holiday Maintenance . . . . . . . . . . . . . . . . . . . . 122

List holidays . . . . . . . . . . . . . . . . . . . . . . . . 122

Add holidays . . . . . . . . . . . . . . . . . . . . . . . . 123

Delete holidays . . . . . . . . . . . . . . . . . . . . . . 123


5/188

Copyright IBM Corp. 2008 v

Data Availability . . . . . . . . . . . . . . . . . . . . . . . 124

Usage . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 124

10 LCM Administration . . . . . . . . . . . . . . . . 127Overview . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 128

Loader Configuration . . . . . . . . . . . . . . . . . 128

Loader Datasource . . . . . . . . . . . . . . . . . . . 128

NC Relations . . . . . . . . . . . . . . . . . . . . . . . . 128

Data availability . . . . . . . . . . . . . . . . . . . . . 128

Usage . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 128

Listing information for Datasources and Loader

Configurations . . . . . . . . . . . . . . . . . . . . . . . . . 131

Listing Loader Datasources . . . . . . . . . . . . 131

Listing Loader Configurations . . . . . . . . . . 131

Listing Datasources and Loader Configurations

132

Load Datasources, Loader Configurations, NC

Relations and Data Availability . . . . . . . . . . . . 132

Loading a Datasource from XML . . . . . . . . 132Loading a custom Datasource from XML . 133

Loading a Loader Configuration from XML 133

Loading NC Relations from XML . . . . . . . 133

Loading Data Availability from XML . . . . 134

Merging of Data Availability blocks from XML

134

Unload Datasources, Loader Configurations and

NC Relations. . . . . . . . . . . . . . . . . . . . . . . . . . . 134

Unloading a Datasource to XML . . . . . . . . 134

Unloading a custom Datasource to XML . . 135

Unloading a Loader Configuration to XML 135

Unloading NC Relations to XML . . . . . . . . 135

Unloading Data Availability to XML . . . . . 136Delete Datasources, Loader Configurations and NC

Relations . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 136

Deleting a Loader Configuration . . . . . . . . 137

Deleting NC Relations . . . . . . . . . . . . . . . . 137

Re-reading a Datasource . . . . . . . . . . . . . . . 138

11 SBH Administration . . . . . . . . . . . . . . . . 139Usage for Stored Busy Hour CLI. . . . . . . . . . . 139

Import Stored Busy Hour definition(s) . . . . 139

Export Stored Busy Hour definition(s) or values

140

List SBH definitions . . . . . . . . . . . . . . . . . . 140

Execute SBH definition(s) . . . . . . . . . . . . . 141Delete SBH definition(s) . . . . . . . . . . . . . . . 141

Enable/Disable calculation of Late Data for all

Busy Hour definitions . . . . . . . . . . . . . . . . . 141

12 Alarm Administration . . . . . . . . . . . . . . 143Overview . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 144

Document contexts . . . . . . . . . . . . . . . . . . . 144

Alarm Template XML Documents . . . . . . . 144

Version Numbering . . . . . . . . . . . . . . . . . . . 144

Usage . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 144

Manage Document Contexts . . . . . . . . . . . . . . . 145

Creating a Document Context . . . . . . . . . . . 146

Removing a Document Context . . . . . . . . . 146

List Alarm Templates . . . . . . . . . . . . . . . . . . . . 148Load an Alarm Template. . . . . . . . . . . . . . . . . . 148

Drop an Alarm Template . . . . . . . . . . . . . . . . . 149

Unload an Alarm Template to a File . . . . . . . . 149

13 The Summarizer and SummaryAdministration . . . . . . . . . . . . . . . . . . . . 151Summarizer . . . . . . . . . . . . . . . . . . . . . . . . . . . 152

Switching ON/OFF the summary process . . 152

Summary Log file . . . . . . . . . . . . . . . . . . . . 152

Start day of week . . . . . . . . . . . . . . . . . . . . . 154

Summary grace period . . . . . . . . . . . . . . . . . 154

Summarizing Old Loaded Data . . . . . . . . . . 155

summary_admin CLI . . . . . . . . . . . . . . . . . . . . 155Provisioning a summary . . . . . . . . . . . . . . . 155

Deleting a summary definition . . . . . . . . . . 157

Running a provisioned summary . . . . . . . . . 157

Changing the number of instances . . . . . . . . 158

Exporting summary metadata . . . . . . . . . . . 158

Listing summary definitions . . . . . . . . . . . . 159

14 Technology pack administration tools . 161The techpack_admin tool . . . . . . . . . . . . . . . . . 161

Usage . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 161

Applying a technology pack . . . . . . . . . . . . . . . 162

Exporting lists of dependencies. . . . . . . . . . . . . 162

Patching a technology pack . . . . . . . . . . . . . . . 163

Listing technology pack modules . . . . . . . . . . . 163

Uninstalling a technology pack, and loaders. . . 163

Standard technology pack . . . . . . . . . . . . . . 163

Loader configurations . . . . . . . . . . . . . . . . . 164

Dependent technology packs . . . . . . . . . . . . 164

Displaying help . . . . . . . . . . . . . . . . . . . . . . . . . 165

The techpack_custom tool. . . . . . . . . . . . . . . . . 165

Usage . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 165

Option -a . . . . . . . . . . . . . . . . . . . . . . . . . . . 165

Option -s . . . . . . . . . . . . . . . . . . . . . . . . . . . 165

Appendix A: Problem Resolution andErrors . . . . . . . . . . . . . . . . . . . . 167

Appendix B: Notices and Trademarks . . . . 171


6/188

vi Tivoli Netcool Performance Manager for Wireless: Adm inistration Gu ide


7/188

Copyright IBM Corp. 2008 1

1 About This DocumentationTheAdministration Guide provides instructions and general information on how to maintain andsupport Tivoli Netcool Performance Manager for Wireless.

This guide was last updated February 8, 2008 8:17 pm.

1.1 Audience

This guide is intended for experienced system administrators, database administrators or otherprofessionals who are responsible for maintaining a Tivoli Netcool Performance Manager for Wirelessinstallation.

1.2 Required Skills and Knowledge

This guide assumes you are familiar with the following:

Oracle database software

UNIX basics (such as file structures, text editing, and permissions) A UNIX-based text editor, such as vi or emacs.

UNIX system administration.

This guide also assumes that you are familiar with your companys network and with procedures forconfiguring, monitoring, and solving problems on your network.

1.3 Document Conventions

This document uses the typographical conventions shown in the following table:

Table 1: General Document Conventions

Format Examples Description

ALL

UPPERCASE

GPS

NULL

MYWEBSERVER

Acronyms, device names, logical opera-

tors, registry keys, and some data struc-

tures.


8/188

2 Tivoli Netcool Performance Manager for Wireless: Adm inistration Gu ide

Note: Command prompts. The following shell command prompts can be seen throughout this docu-ment:

# (hash): displayed if the user is logged in as user root.

$ (dollar): displayed if the user is logged in as either the virtuo or oracle user.

1.3.1 Blank pages

Blank pages are used at the end of chapters to ensure the following chapter begins on an odd numberedpage. These pages are intentionally blank. If the guide is printed double-sided and bound, each chapterwill begin on a right-hand page.

Underscore See Document Conventions For links within a document or to the Inter-

net. Note that TOC and index links are not

underscored. Color of text is determined bybrowser settings.

Bold Note: The busy hour determiner is... Heading text for Notes, and Warnings.

SMALL CAPS The STORED SQLdialog box...

...clickVIEW...

In the main GUI window, select theFILE menu, point to NEW, and thenselect TRAFFIC TEMPLATE.

Any text that appears on the GUI.

Italic A busy houris...

A web server mustbe installed...

See the User Guide

New terms, emphasis, and book titles.

Monospace ./wminstall $ cd /cdrom/cdrom0

/xml/dict

http://java.sun.com/products/

addmsc.sh

Type OK to continue.

Code text, command line text, paths,scripts, and file names.

Text written in the body of a paragraph that

the user is expected to enter.

Monospace

Bold[root] # pkginfo | grep -i perl

system Perl5 On-Line Manual

Pages

system Perl 5.005_03 (POD Docu-

mentation)

system Perl 5.005_03

For contrast in a code example to show

lines the user is expected to enter.

# cd Used in code examples: command-linevariables that you replace with a real name

or value. These are always marked with

arrow brackets.

[square

bracket]

log-archiver.sh [-i][-w][-t] Used in code examples: indicates options.

Table 1: General Document Conventions (Continued)

Format Examples Description


9/188

About This Documentation 3

1.4 Document Structure

This document is organized in to the following chapters and appendices:

1.5 User Publications

Tivoli Netcool Performance Manager for Wireless software provides the following user publications inHTML or Adobe Portable Document Format (PDF) formats.

Table 2: Document Structure

Chapter Description


Wireless Architecture Overview

Architecture overview.

Setup Tasks Tasks accomplished as part of the installation of Tivoli

Netcool Performance Manager for Wireless.

Starting and Stopping Tivoli Netcool

Performance Manager for Wireless

Starting and stopping Tivoli Netcool Performance Man-

ager for Wireless, and Tivoli Netcool Performance Man-

ager for Wireless processes.


Wireless Application Administration

Maintaining users, roles and privileges.

Tivoli Netcool Performance Manager forWireless Operations Tasks Daily loader operations tasks.

Datasource, Agent and KPI Cache

Administration

Datasource and agent administration.

System Maintenance Scheduling maintenance, server status, maintaining

tablespaces, partitions, disk spaces usage, file system

backup and log files.

Tools Importing and exporting report definitions, time zone

administration and holiday administration.

LCM Administration Loader Configuration Manager Administration.

Alarm Administration Alarm administration tool.

The Summarizer and Summary Adminis-

tration

The Summarizer component, and data summarization

process.

Technology pack administration tools Technology pack administration.

Problem Resolution and Errors Problem resolution.

Table 3: Tivoli Netcool Performance Manager for Wireless User Documentation

Document Description

Installation Guide Instructions for installing and configuring the Tivoli Netcool Perfor-mance Manager for Wireless software.

Upgrade Guide Instructions for upgrading Tivoli Netcool Performance Manager forWireless software.


10/188


11/188


2 Tivoli Netcool Performance Managerfor Wireless Architecture Overview

2.1 Introduction

The Tivoli Netcool Performance Manager for Wireless system is comprised of the Tivoli Netcool

Performance Manager for Wireless Server and a Client layer. The Client layer is a web-based userinterface to the Tivoli Netcool Performance Manager for Wireless Server. The Tivoli NetcoolPerformance Manager for Wireless Server is used to connect a Tivoli Netcool Performance Manager forWireless user to the datasource. The Tivoli Netcool Performance Manager for Wireless Server managesthe core framework which is the basis of the Tivoli Netcool Performance Manager for Wireless product.

Tivoli Netcool Performance Manager for Wireless provides important metrics which are essential inhelping manage network infrastructure. Tivoli Netcool Performance Manager for Wireless supports thefollowing:

Network Quality Management

Reporting key performance indicators (KPIs).

Performance Optimization

Monitoring daily and hourly performances.

Isolating, analyzing and resolving problems affecting service.

2.1.1 Listing current software versions

It is possible to list the current software versions for installed Tivoli Netcool Performance Manager forWireless software.

To list currently installed software versions, as user virtuo:

sw_version

Example output:

--------------------------

Installed Virtuo software:

--------------------------

Modules:

vallent-vt-common, Virtuo, NA9.1.1.12.03


12/188


vallent-vt-jre, Virtuo, NA9.1.1.12.03

vallent-vt-ant, Virtuo, NA9.1.1.12.03

vallent-vt-java-libs, Virtuo, NA9.1.1.12.03

vallent-vt-as-core, Virtuo, NA9.1.1.12.03

vallent-vt-core, Virtuo, NA9.1.1.12.03vallent-vt-ds-conf, Virtuo, NA9.1.1.12.03

vallent-vt-db-install, Virtuo, NA9.1.1.12.03

vallent-vt-db-conf, Virtuo, NA9.1.1.12.03

vallent-vt-tao, Virtuo, NA9.1.1.12.03

vallent-vt-xerces, Virtuo, NA9.1.1.12.03

vallent-vt-alarms, Virtuo, NA9.1.1.12.03

Gateways:

vallent-vt-gway-ascii-gateway, ascii-gateway, 3.3.0.1

vallent-vt-gway-csv-gateway, csv-gateway, 3.3.0.2

vallent-vt-gway-ericsson-mgw-r4.1-xml, ericsson-mgw-r4.1-xml, 3.3.0.2

vallent-vt-gway-gateway-framework, gateway-framework, 3.3.0.5vallent-vt-gway-xml-3gpp, xml-3gpp, 3.3.0.1

Techpacks:

vallent-vt-Neutral_CDMA_BSS_NSS_GOM, Virtuo, 1.0

vallent-vt-Neutral_Core_GOM, Virtuo, 1.0

vallent-vt-Neutral_GPRS_BSS_GOM, Virtuo, 1.0

vallent-vt-Neutral_GPRS_UMTS_CN_GOM, Virtuo, 1.0

vallent-vt-Neutral_GSM_BSS_NSS_GOM, Virtuo, 1.0

vallent-vt-Neutral_UMTS_UTRAN_GOM, Virtuo, 1.0

2.1.2 Server LayerDepending on the Server(s) configuration during installation, subsystems of the Server architecture maybe deployed across several Servers. For example, the database and loading activities may reside on theDatabase Server, whilst the mediation and the remainder of the application framework may be onanother Server.

The NetworkAssure Server consists of the following subsystems:

Mediation services. See Gateways and the Data Administration Tool on page 9.

NetworkAssure Application framework. See Tivoli Netcool Performance Manager for WirelessApplication Frameworkon page 9.

Platform Management Services. See Platform Management Services on page 10.

User management services. See User Management Services on page 11.

Database services. See Database Services on page 11.


13/188

Tivoli Netcool Performance Manager for Wireless Architecture Overview 7

Figure 1: Tivoli Netcool Performance Manager for Wireless Server

2.1.3 Client Layer

The client access layer is a subsystem of the JBoss Server. It is the web/HTML page Server that providesthe static and dynamic content for the web-based client user interface.

This web-based user interface is used for creating and running performance reports based on datacollected in a datasource.


14/188


2.2 Tivoli Netcool Performance Manager for Wireless ServerArchitecture - The Core Framework

The core framework or core product, forms the basis of performance management. The core product

includes software modules essential to the basic functioning of the Tivoli Netcool Performance Managerfor Wireless performance management solution.

The following diagram shows a simplified view of the core framework.

Figure 2: NetworkAssure - The Core Framework

2.2.1 Technology Packs

Technology packs are software layers that represent a particular type of technology. Technology packsallows the core framework to be applied to any underlying network technology. They are plug-and-playmodules that enable the management of a specific network technology or service. The following is a listof example technology packs:

GSM

GPRS

CDMA

UMTS

EVDO

IP

There is no tight integration between core functionality and technology packs. Technology packs can beadded, upgraded and removed independently.


15/188


2.2.2 Extraction, Transformation and Loading (ETL) Data Layer

Gateways and the Data Administration Tool

Gateways and the data administration tool are used to transfer, parse and manipulate incoming

performance data received from network elements, converting the data into a common loader format.The main output of this process is the production of a .lif file for loading into the database. Gatewaysprepare the data for performance reporting, enabling high performance data loading.

Loaders

Loaders manage the loading of data into the Oracle database. Tivoli Netcool Performance Manager forWireless functions with a diverse range of network technologies and therefore a wide range of networkelement types. Data from these diverse sources is applied in a range of formats. Before the data can beloaded into the Oracle database it must be reformatted into a standard format that the loader processesrecognizes.

On a Tivoli Netcool Performance Manager for Wireless system there may be a number of loadersrunning for a number of technologies. The loader process runs constantly taking data from the loaderspool directories and loading it into the performance database.

Loader Configuration Manager

The loader configuration manager provides a service to ensure the correct loaders are used to populatethe database for any given managed element file. The loader configuration manager is simply a mappingtool to ensure that during installation all relevant technology pack and loader xml files are used toaccurately populate the following tables in the database:

lc_relations - which defines the necessary network hierarchical relationships.

lc_loadmaps - which defines the load mapping of blocks of data for a specific ruleset to tables inthe database.

lc_ruleset - which uniquely characterizes a set of data for a particular technology and vendor,and associates this with the actual spool directory that the associated data can be retrieved from.

These tables are used to configure and associate the loaders with the applicable database tables andvendor-technology files, for accurate population of the database. Figure 1 illustrates the flow of data.

2.2.3 Tivoli Netcool Performance Manager for Wireless Application Framework

The Tivoli Netcool Performance Manager for Wireless application framework operates on a layerbetween the NetworkAssure database and the Tivoli Netcool Performance Manager for Wireless webclient. The application framework components:

Input data in the database.

Retrieve and cache data from the database upon user request.

Serve pages to the web client interface for use by the user.

Manage schedules and services to maintain the database.

Manage schedules and services related to user report generation.


16/188


2.2.4 Summaries

Tivoli Netcool Performance Manager for Wireless supports the following functionality:

Processing of summaries can be switched on and off. If summaries are switched on they will run

if they are switched off they will not run. A Summary log file is written to the appserver log file directory in $WMCROOT/logs/as/default

and the name of the log file is as-summary.log. The log file contains the following information:

Details on whether the summary process is switched on or off.

The start time for the summary process.

Details on summaries that have run in the past including how many rows were processed bythe summary.

The end time for the summary process.

The start day of the week can be set. The start day of the week can vary depending on thegeographical location. The summary process allows you to set the start day of the week to the

day the user requires. The summarizer will summarize old loaded data automatically. When the summarizer process is

started it detects whether old loaded data is loaded into the system. Data is defined as old loadeddata if it is older than 1 day. If the old loaded data has already being summarized then it will bere-summarized and the old summary data is deleted and the new summary data is populated inthe summary table. If the old loaded data is older than 1 week or 1 month it will cause weeklyand monthly summaries to be re-calculated respectively.

2.2.5 Services

Platform Management Services

The platform management services are comprised of several process utilities that work together to setup, control and monitor the NetworkAssure application Server. These tools are installed on theNetworkAssure Server and run from a Korn shell.

sapmon - This is the parent utility process to the application server process. It is responsible forthe startup and control of the NetworkAssure application framework.

sapmgr The process framework manager that registers all NetworkAssure processes includingthe application server and the loaders.

sap The utility used to display the status. It is also used to start and stop the registeredprocesses.

Business Services

The business services are the core of the Tivoli Netcool Performance Manager for Wireless application.These services provide application access and maintenance capabilities.

The following is a list of the business services:

Application server - The application Server consists of the JBoss application Server used byTivoli Netcool Performance Manager for Wireless to communicate with an LDAP Server and thedatasource to generate reports.


17/188


Agent framework and agents - The agent framework provides agents that gather informationabout the datasource and the information necessary to define a report.

Dynamic SQL Generator - The SQL generator creates queries to collect the performance data perthe report definition.

User Management Services

User management is supported by an LDAP Server and a dedicated user management Web-basedinterface. The LDAP Server provides the framework for implementation of roles, groups and users forTivoli Netcool Performance Manager for Wireless through a single sign-on authentication.

Database Services

The Tivoli Netcool Performance Manager for Wireless web client accesses data stored in the databaseon the applicable Tivoli Netcool Performance Manager for Wireless database Server. Data is stored inan Oracle Relational Database Management System (RDBMS), version 10g.

This data includes:

Performance measurements

Configuration information

Database-utilization information from the infrastructure equipment.

Configuration data for the NetworkAssure application.

For example:

The data loading formula and report definitions.

Timetables used for scheduling reports, summarizing data, archiving data and performingautomated management tasks.

2.3 Client Operation Functions

Administrators use the web-based Client user interface to complete and monitor the following:

User Management

Adding and deleting users.

Modifying user access to the database.

Modifying data within the application.

Alarm Management

Defining alarm templates and definitions to provide alarm events to users.

Reporting

Creating new reports.

Interactive data access - Viewing charts or raw data directly in the browser interface.

Charting - Viewing time-series charts by entities or fields


18/188


Drill-down - Viewing rolled-up data at a high level in the hierarchy and examining details lowerin the hierarchy when it is required.

Add charts to the workspace with the content created from saved reports.

Easily includes configuration and performance data in the same report.

It can create and visualize end-to-end KPIs called User Defined Computations (UDCs).

Exporting data, for example, data in CSV or Excel sheets for further analysis.

Monitoring report jobs and tasks running on the Server.

Downloading report results.

Scheduling reports to run on a custom schedule.

Supporting flexible time zone capabilities.

Report Vault

The report vault provides hierarchical structure which can be user defined for storing report output.Itsupports the following:

A single report repository for easy access to corporate reports. If users have the appropriatepermissions they can publish reports in the vault.

Report directories which are easy to create and navigate.

Report Grouping by any attribute of the entities. The ones mainly used are market, region,technology and time periods.

Defining standard corporate reports

Report Types

The following is a list of report types supported by Tivoli Netcool Performance Manager for Wireless:

Comprehensive - which details granular data such as hourly results. It also details aggregatedtotals.

Busy hour - Provides the greatest value for a performance metric over a defined period of time.

For example:

The busiest hour of the day, week or month

Ranking - Display the top n or bottom n values only for a data set.

For example:

The network element performing the best for any performance measurement.

The network element performing the worst for any performance measurement.

N-High Busy Hour Reports - Highlights a range of the busiest hours or the busiest days

Filtered N-High Busy Hour Reports - allows the user to filter N-High busy hour data accordingto the values of specific variables.


19/188


2.4 Server Operation Functions

Command line tools and UNIX commands are used to complete the following tasks on the applicationServer.

Monitoring application processes - sap

Starting and stopping NetworkAssure - sapmon, sapmgr, sap

Maintaining schedules - schedule_admin

Monitoring and maintaining database partitions - schedule_admin, part_admin

Monitoring agent framework (jboss) activities - review logs, agent_admin

Monitoring the health of the server and its subsystems - various unix commands

Configuring parameters for user use - holiday_admin, user_admin, tz_admin, alarm_admin


20/188



21/188


3 Setup TasksThis chapter describes a number of tasks that will have been performed as part of the installation ofTivoli Netcool Performance Manager for Wireless. You do not need to perform these tasks again, theyare described for information purposes.

3.1 Overview Setup tasks include:

Software install summary

Datasources

LDAP setup

Crontab setup

SAP


22/188


3.2 Software Install Summary

The Tivoli Netcool Performance Manager for Wireless architecture is typically made up of fourcomponents, each with specific functions:

The Application Component consists of the Tivoli Netcool Performance Manager for Wirelesssoftware which is used to run a Tivoli Netcool Performance Manager for Wireless framework

The Gateway Component deals with the processing of data which is downloaded fromdatasources

The Database Component consists of an Oracle Database which Tivoli Netcool PerformanceManager for Wireless uses to store data

The Client PC is used to run the Tivoli Netcool Performance Manager for Wireless GUI.

Components can be installed on a single server or distributed over several machines. For example, asingle server could be used for the Application, Gateway and Database Components, or these threecomponents could be split over three servers.

The installation of Tivoli Netcool Performance Manager for Wireless includes a number of tasks. Thefollowing table lists the main installation tasks.

3.3 Datasource setup

Datasources provide Tivoli Netcool Performance Manager for Wireless with the necessary performancedata for reports.

Datasources are typically servers that contain entity and performance data information.

For more information on Datasources see Datasource, Agent and KPI Cache Administration on page 53.

3.4 LDAP - Directory Server setup

The LDAP server is a third-party application that is used as a directory service to manage users, roles,and privileges.

Table 4: Tivoli Netcool Performance Manager for Wireless Installation

Task Description

User and Group Accounts Creation User and group accounts creation.


Wireless Software Installation

Installing Virtuo and required third party products.


Wireless Gateway Installation

Deploying gateway packages.

Tivoli Netcool Performance Manager forWireless Technology Pack Installation Installing technology packs.

Cronjob Installation Installing cronjobs.

Configuring and Starting Tivoli Netcool Per-

formance Manager for Wireless

Configuring and starting Virtuo.


23/188

Setup Tasks 17

The LDAP server is installed as a pre-requisite to the installation ofTivoli Netcool Performance Managerfor Wireless.

For information on starting and stopping the LDAP server see Directory Server on page 24.

The LDAP server needs to be started to allow users to login through the Tivoli Netcool PerformanceManager for Wireless GUI.

Tivoli Netcool Performance Manager for Wireless users, privileges, roles and groups can be altered/created through the GUI. See Tivoli Netcool Performance Manager for Wireless ApplicationAdministration on page 29.

3.5 Crontab setup

The crontab setup is installed and set up as part of the main Tivoli Netcool Performance Manager forWireless installation. The crontab is installed using the following script:

/appl/virtuo/admin/common/install/scripts/cron_install

Note: See the Tivoli Netcool Performance Manager for Wireless Installation Guide for more informa-tion on installing Cron.

The installation sets up the virtuo and root user scheduled Cron tasks.

There are two different Cron setups installed for the two different users:

virtuo user cron setup

root user cron setup

The installation uses the following two crontab files to setup the virtuo and root user crontab list.

$WMCROOT/admin/common/cron/core_root_crontab

$WMCROOT/admin/common/cron/core_virtuo_crontab

3.5.1 Virtuo User setup

The following is a sample default crontab list for a Tivoli Netcool Performance Manager for Wirelessbasic installation.

As user virtuo:

crontab -l

0 1 * * * /appl/virtuo/admin/common/cron/cron_script -r -d 31 /data/trace_archive1

\*.log.\*

0 1 * * * /appl/virtuo/admin/common/cron/cron_script -a -d 0 /data/trace_log1

\*.log.\* /data/trace_archive1

0 3 * * * /appl/virtuo/admin/common/cron/cron_script -r -d 2 /appl/virtuo/tomcat/

logs vt\*.log


24/188


0 0 * * * /appl/virtuo/admin/common/cron/cron_script -c -d 512 /appl/virtuo/logs/

loader virtuo_loader.log

30 0 * * * /appl/virtuo/admin/common/cron/cron_script -r -d 5 /appl/virtuo/logs/

loader/CHOPPED virtuo_loader.log-\*

0 2 * * * /appl/virtuo/admin/common/cron/cron_script -r -d 5 /appl/virtuo/var/

loader/bad PDO_\*


loader/dat PDO_\*


loader/log PDO_\*.log

3.5.2 Root User Setup

The following is a sample default crontab list for a Tivoli Netcool Performance Manager for Wirelessbasic installation.

Note: Some environments will have additional entries.

As user root:

crontab -l

0 23 * * * /appl/virtuo/admin/oracle/cron/roll_listener_log

0 23 * * * /appl/virtuo/admin/common/cron/cron_script -r -d 2 /var/cron log.\*

0 23 * * * /appl/virtuo/admin/common/cron/cron_script -r -d 2 /var/cron olog.\*

0 23 * * * /appl/virtuo/admin/common/cron/roll_cron_log

0 23 * * * /appl/virtuo/admin/common/cron/cron_script -r -d 2 /appl/oracle/prod-

uct/9.2.0/network/log listener.log.\*

0 10,16,23 * * * /appl/virtuo/admin/common/cron/cron_script -r -d 1 /oradump/vtdbvtdb_arch_\*

0 23 * * * /appl/virtuo/admin/common/cron/cron_script -r -d 2 /appl/virtuo/ds/

slapd-`/usr/bin/hostname`/logs access.\*

0 23 * * * /appl/virtuo/admin/common/cron/cron_script -r -d 2 /appl/virtuo/ds/

slapd-`/usr/bin/hostname`/logs errors.\*

3.5.3 Additional entries and scripts

The following script is also available:

0 2 * * * /appl/virtuo/admin/common/cron/archive_loader_data -wmcr /appl/virtuo

This scripts archives .lif data files (files produced by the gateways and processed by the loaders inlarge volumes).

Crontab entries can be added if more scripts are written or more log files are generated. Cron entries areadded by editing the cron list using crontab -e

The following files are the generated cron files - these are the files that are changed using crontab -efor root and virtuo users:


25/188

Setup Tasks 19

/var/spool/cron/crontabs/virtuo

/var/spool/cron/crontabs/root

3.6 SAP setup

SAP is a process management utility consisting of a process manager and monitor. The Process Monitormanages the restart ability of Tivoli Netcool Performance Manager for Wireless. The Process Managerregisters all the Tivoli Netcool Performance Manager for Wireless processes.

SAP scripts are installed under $WMCROOT/bin as part of the core installation.

The SAP manager and framework is started using the following commands, as user root:

svcadm enable sapmon-na

svcadm enable sapmgr-na

For more information on starting and stopping SAP utilities see Process Monitor on page 24 and Process

Manager on page 25.Tivoli Netcool Performance Manager for Wireless processes are started using the following command:

svcadm enable sap-na

Individual processes can be started using:

svcadm enable -na

Information on processes can be displayed using:

sap disp

or sap disp -l (verbose output)

Producing the following example output:NAME STATE SINCE

as STARTED Sep 15, 2006

loadcdmanortelevdor3 stopped -

3.6.1 SAP configuration

The NetworkAssure processes are automatically configured in SAP following core installation.

The SAP tool uses property files to start the application server and configured loaders. These files arestored in the following locations

$WMCROOT/conf/processes/*.properties

The following is a sample application server property file:

#

# application server

#

com.comnitel.process.as.exec=@{WMCROOT}/bin/run_as

com.comnitel.process.as.params=


26/188


com.comnitel.process.as.group=asgroup

com.comnitel.process.as.start.pmgtprovider=false

com.comnitel.process.as.host=${WMCHOST}

com.comnitel.process.as.start.sequence=1

Table 5: Application Server Property File - Variable Descriptions

The following is a sample loader property file:

com.comnitel.process.loadcdmanortelevdor3.exec=\@{WMCROOT}/bin/run_loader

com.comnitel.process.loadcdmanortelevdor3.params=cdmanortelevdor3

com.comnitel.process.loadcdmanortelevdor3.group=loadcdmanortelevdor3

com.comnitel.process.loadcdmanortelevdor3.host=\${WMCHOST}

com.comnitel.process.loadcdmanortelevdor3.start.pmgtprovider=false

com.comnitel.process.loadcdmanortelevdor3.start.sequence=101

com.comnitel.process.loadcdmanortelevdor3.start.timeout=30000

Variables Description

com.comnitel.pro-

cess.as.exec=@{WMCROOT}/bin/

run_as

Describes the command that is executed when the

user executes sap start.

com.comnitel.process.as.params= The space separated command line arguments for

the process. The variable is optional.

com.comnitel.pro-

cess.as.group=asgroup

Describes the group of processes that this process

belongs to. As well as using sap start, it is possible to start a group by using sap

start . The variable is optional.

com.comnitel.pro-

cess.as.start.pmgtprovider=false

Defines whether or not the process make callbacks

to inform the framework of its init states. The vari-

able is optional and defaults to true.

com.comnitel.pro-

cess.as.host=${WMCHOST}

Defines the name of the Server that this process is

executed on.

com.comnitel.pro-

cess.as.start.sequence=1

Defines the order in which processes are started. The

numbers must be sequential. If more than one pro-

cess is given the same sequence number the user

will not know which process started first. This also

applies to the default value of 0. If two processes are

allowed to use the default value of 0 the user will not

know which process started first. The variable is

optional.


27/188

Setup Tasks 21

Table 6: Loader Property File - Variable Descriptions

Manual configuration of processes through SAP is not necessary.

Variables Description

com.comnitel.pro-

cess.loadcdmanortelevdor3.exec=\

@{WMCROOT}/bin/run_loader

Describes the command that is executed when the

users starts the loader cdmanortelevdor3.

com.comnitel.pro-

cess.loadcdmanortelevdor3.params

=cdmanortelevdor3

The name of the loader is cdmanortelevdor3.

com.comnitel.pro-

cess.loadcdmanortelevdor3.group=

loadcdmanortelevdor3

The group of processes to which the loader belongs.

com.comnitel.pro-

cess.loadcdmanortelevdor3.host=\

${WMCHOST}

Defines the name of the Server that this process is

executed on.

com.comnitel.pro-

cess.loadcdmanortelevdor3.start.

pmgtprovider=false

Defines whether or not the process make callbacks

to inform the framework of its init states. The vari-

able is optional and defaults to true.com.comnitel.pro-


sequence=101

Defines the order in which processes are started. .

The actual numbers do not have to be sequential. If

more than one process is given the same sequence

number the user will not know which process

started first. The default value is 0 and this variable

is optional.

com.comnitel.pro-


timeout=30000

Defines the timeout period i.e. length of time to wait

to restart the loader if the loader fails to start.


28/188



29/188


4 Starting and Stopping Tivoli NetcoolPerformance Manager for Wireless

This chapter describes starting and stopping the NetworkAssure system.

4.1 Overview

Several applications must be running before the Tivoli Netcool Performance Manager for Wirelessapplication can be started properly, these include:

Oracle Database

(LDAP) Directory Server

(SAP) Process Monitor

(SAP) Process Manager

Once all these applications are running, Tivoli Netcool Performance Manager for Wireless can bestarted. All the processes are automatically started upon bootup. Bootup should take place as part of the

installation of Tivoli Netcool Performance Manager for Wireless, see the Tivoli Netcool PerformanceManager for Wireless Installation Guide for more information.

For instructions on the complete startup and shutdown of Tivoli Netcool Performance Manager forWireless and Tivoli Netcool Performance Manager for Wireless processes see NetworkAssure Completestartup and shutdown on page 26.

Note: A number of status checks can be performed on Tivoli Netcool Performance Manager for Wire-less applications and processes, see Reporting on the Server Status on page 75.


30/188


4.2 Oracle Database

Note: For additional details on manually starting and stopping Oracle using SQL*Plus and the oracleuser see Starting and Stopping the Oracle Database on page 79.

4.2.1 Starting the Oracle Database

To start the Oracle Database:

1. Execute the following command as user root:

svcadm enable database-na

4.2.2 Stopping the Oracle Database

To stop the Oracle Database:

Execute the following command as user root:svcadm disable database-na

4.3 Directory Server

4.3.1 Starting the Directory Server

To start the LDAP Server:

Execute the following command as user root:

svcadm enable ldap-na

4.3.2 Stopping the Directory Server

To stop the LDAP Server:


svcadm disable ldap-na

4.4 Process Monitor

The Process Monitor manages the restart ability of the application.

Note: Distributed systems only. In a distributed environment the Process Monitor is only started on theServer containing the Application component.

4.4.1 Starting the Process Monitor

To start the Process Monitor:



31/188

Starting and Stopping Tivoli Netcool Performance Manager for Wireless 25


4.4.2 Stopping the Process Monitor

To stop the Process Monitor:


svcadm disable sapmon-na

4.5 Process Manager

The Process Manager registers all the Tivoli Netcool Performance Manager for Wireless processes.

Note: Distributed systems only. In a distributed environment the Process Manager is only started on theServer containing the Application component.

4.5.1 Starting the Process Manager

To start the Process Manager, complete the following:



4.5.2 Stopping the Process Manager

To stop the Process Manager, complete the following:


svcadm disable sapmgr-na

This command does not stop processes.

4.6 Tivoli Netcool Performance Manager for Wireless

Tivoli Netcool Performance Manager for Wireless is started and stopped using the sap command. Thesap command starts and stops all registered processes.

For instructions on the complete startup and shutdown of Tivoli Netcool Performance Manager forWireless and Tivoli Netcool Performance Manager for Wireless processes, see NetworkAssureComplete startup and shutdown on page 26.

4.6.1 Starting Tivoli Netcool Performance Manager for Wireless

To start the Tivoli Netcool Performance Manager for Wireless application:



It may take a few minutes to start all the processes.


32/188


You can check the loader logs for startup issues:

$WMCROOT/logs/loader/

Log information from the application server is written to:

$WMCROOT/logs/as/

4.6.2 Stopping Tivoli Netcool Performance Manager for Wireless

To stop the Tivoli Netcool Performance Manager for Wireless application:


svcadm disable sap-na

4.7 NetworkAssure Complete startup and shutdown

4.7.1 NetworkAssure Complete Startup

The following procedure starts the Oracle Database, the Directory Server, the Process Monitor, theProcess Manager, and all Tivoli Netcool Performance Manager for Wireless processes.

Note: If you do not need to start up the Oracle database or the Directory server ignore instructions relat-ing to starting the Oracle database and Directory server.

Note: It is possible to start up all Tivoli Netcool Performance Manager for Wireless applications, theLDAP server and the database using a single command: svcadm enable database-na ldap-na sap-mon-na sapmgr-na sap-na

Oracle Database

Start the Oracle Database:

1. Execute the following command as user root on the Tivoli Netcool Performance Manager forWireless Server(s):

svcadm enable database-na

Directory Server

Start the Directory Server:

1. Execute the following command as user root on the Tivoli Netcool Performance Manager forWireless Server(s):

svcadm enable ldap-na


33/188

Starting and Stopping Tivoli Netcool Performance Manager for Wireless 27

Tivoli Netcool Performance Manager for Wireless

Important: Distributed systems only. In a distributed system, this section should be performed only onthe server hosting theApplication component.

1. Execute the following commands to ensure SAP process management is running, and start theremaining Tivoli Netcool Performance Manager for Wireless processes.




It may take a few minutes to start all the processes.

You can check the loader logs for startup issues:

$WMCROOT/logs/loader/

Log information from the application server is written to:

$WMCROOT/logs/as/

4.7.2 Tivoli Netcool Performance Manager for Wireless Complete Shut down

The following procedure shuts down Tivoli Netcool Performance Manager for Wireless, all processes,the Process Manager, the Process Monitor, the Directory Server and Oracle.

Note: If you do not need to shut down the Oracle database or the Directory server ignore instructionsrelating to shutting down the Oracle database and Directory server.

Note: It is possible to shut down all Tivoli Netcool Performance Manager for Wireless applications, theLDAP server and the database using a single command: svcadm disable sap-na sapmgr-na sapmon-na ldap-na database-na

NetworkAssure

Important: Distributed systems only. In a distributed system, this section should be performed only onthe server hosting theApplication component.

Shut down the system as follows:1. Execute the following commands on the Tivoli Netcool Performance Manager for Wireless

Server(s):

svcadm disable sapmon-na

svcadm disable sapmgr-na

svcadm disable sap-na


34/188


Directory Server

Shut down the Directory Server:

1. Execute the following commands on the Tivoli Netcool Performance Manager for Wireless

Server(s) as user root:svcadm disable ldap-na

Oracle Database

Shut down the Oracle Database:

1. Execute the following commands on the Tivoli Netcool Performance Manager for WirelessServer(s) as user root:

svcadm disable database-na


35/188


5 Tivoli Netcool Performance Managerfor Wireless ApplicationAdministration

This chapter describes Tivoli Netcool Performance Manager for Wireless application administration.

Application administrationThis includes:

user administration and access to the Tivoli Netcool Performance Manager for Wirelessapplication.


36/188


5.1 User Administration

5.2 Overview

The Tivoli Netcool Performance Manager for Wireless User Administration tool allows you to configurea wide range of ways for users to access Tivoli Netcool Performance Manager for Wireless using:

users

groups

roles

privileges


37/188

Tivoli Netcool Performance Manager for Wireless Application Administration 31

5.3 User Administration Basics

The Tivoli Netcool Performance Manager for Wireless User Administration tool is accessed from theTivoli Netcool Performance Manager for Wireless GUI using the TOOLS tab, by selecting USERADMINISTRATION from the drop-down list box.

Figure 3: User Administration

5.3.1 Tivoli Netcool Performance Manager for Wireless Users

Tivoli Netcool Performance Manager for Wirelessusers are those users in the LDAP repository thathave been configured to use the Tivoli Netcool Performance Manager for Wireless application.

5.3.2 Groups

Groups are collections of users. Permission to access user documents such as reports is given to groups.Users can belong to more than one group. Tivoli Netcool Performance Manager for Wireless software

includes a number of predefined groups, shown in the following table, which cannot be edited. You canalso create your own groups.

Table 7: Predefined Groups

Name Description

Admin Used to group administrators together.

Everybody A group that automatically contains all of the users defined by the system.


38/188


5.3.3 Roles

Roles are collections of privileges. Roles can contain other roles. Roles are assigned to users, not togroups. Tivoli Netcool Performance Manager for Wireless software includes a number of predefinedroles, shown in the following table, which cannot be edited. You can also create your own roles. The

total set of privileges that a user has is determined by the roles assigned to that user, and the privilegesassociated with those roles.

You can view the privileges associated with a role. See Assigning/De-assigning Privileges to a Role onpage 41 for information on how to determine the privileges in a role.

5.3.4 Privileges

Privileges are a list of tasks and features available for users. Privileges are grouped into roles, which arethen applied to a particular user. The following table describes the privileges available on the TivoliNetcool Performance Manager for Wireless system.

Table 8: Predefined Roles

Name Description

Basic Web User A limited user who can only read standard report definitions, read schedule defini-

tions, read Vault documents, show users from Everybody group, show folders from

Everybody group, access the Alarm Viewer.

Normal Web User A typical user who has all the privileges of a Basic Web User and who can edit/

delete standard report definitions, run standard reports, edit/schedule definitions, has

a personal documents area, read/edit MyFavorites pages, view UDC definitions.

Power Web User An advanced user who has all the privileges of a Normal Web User and who can

also publish and edit Vault documents, view and edit UDCs, access the Alarm

Exporter and Alarm Manager, Import and Export data with the Admin tool.

System Administrator The top-level administrator having all available privileges. System administrators

have full control over Tivoli Netcool Performance Manager for Wireless software.

Table 9: Privilege Descriptions

Privilege Applies To Description

Admin: Edit Datasource

definitions

Administration

software

Allows the user to perform actions associated with agents and

agent activities.

Admin: edit users and user

data

Administration

software, Web

Client

Allows the user to edit users, groups, and roles.

Allow access to Alarm

Exporter

Web Client Allows the user to create and modify alarm targets.


Manager

Web Client Allows the user to activate and deactivate alarms, and to modify

alarm definitions.


Viewer

Web Client Allows the user to view and acknowledge alarms.


39/188


Configure Jboss Administration

software

Allows the user to configure Jboss.

Create entity and field

mappings (equivalencies)

Administration

software

Allows the user to model entity and field equivalencies. This

privilege does not apply to Tivoli Netcool Performance Man-

ager for Wireless.

Edit Agent settings Administration

software

Allows the user to modify properties and perform actions asso-

ciated with agents and agent activities.

Edit/delete any existing

reports

Web client Allows the user to modify all report results, regardless of the

assigned permissions.

Edit/delete any existing

folders or documents

Web client Allows the user to modify all saved documents, regardless of

the assigned permissions.

Edit any remote UDC defi-

nitions

Administration

software

Allows the user to create/edit/delete a remote UDC owned by

the current user.

Edit/delete enterprise

report definitions

Web client Allows the user to open and edit enterprise report definitions.

This privilege does not apply to Tivoli Netcool Performance

Manager for Wireless.

Edit/delete schedule defi-

nitions

Web client Allows the user to schedule reports to be run.

Edit/delete standard Web

report definitions

Web client Allows the user to open and edit local report definitions.

Edit entity data Administration

software

Allows the user to enter information about an entity instance

using the Entity Data Editor. This privilege does not apply to

Tivoli Netcool Performance Manager for Wireless.

Edit Holidays Administrationsoftware

Allows the user to edit holiday definitions using the HolidayAdministration tool.

Edit MyFavorite pages Web client Allows the user to create, edit, and delete customized pages in

the Web client.

Edit remote UDC defini-

tions

Administration

software

Allows the user to create/edit/delete any remote UDC owned by

any user.

Export Data with the

Admin Tool

Administration

software

Allows the user to use the export tool.

Import Data with the

Admin Tool

Administration

software

Allows the user to use the import tool.

Manage AutoDownload

entries

Web client Allows the user to manage the auto downloading of scheduled

reports that exist on remote servers. This privilege does notapply to Tivoli Netcool Performance Manager for Wireless.

Promote UDCs Administration

software

Allows the user to promote a UDC.

Publish and edit Vault doc-

uments

Web client Allows the user to organize folders and save documents to the

vault page, assuming they have the appropriate file permissions.




40/188


Read enterprise report def-

initions

Web client Allows the user to read enterprise report definitions. This priv-

ilege does not apply to Tivoli Netcool Performance Manager

for Wireless.

Read MyFavorite pages Web client Allows the user to view customized pages in the Web client.

Read reports from remote

servers

Web client Allows the user to see remote server report status from the

Monitor tab. This privilege does not apply to Tivoli Netcool

Performance Manager for Wireless.

Read schedule definitions Web client Allows the user to view report schedules.

Read standard Web report

definitions

Web client Allows the user to view local report definitions.

Read Vault documents Web client Allows the user to browse through documents that have been

published to the vault page.

Rename remote UDC defi-nitions

Administrationsoftware

Allows the user to rename a remote user-defined calculation(UDC).

Run classic reports on

remote servers

Web client Allows the user to run reports residing on a remote server. This

privilege does not apply to Tivoli Netcool Performance Man-

ager for Wireless.

Run enterprise report defi-

nitions

Web client Allows the user to run enterprise reports. This privilege does

not apply to Tivoli Netcool Performance Manager for Wireless.

Run standard Web reports Web client Allows the user to run report definitions. This privilege implies

read and edit privileges.

Show folders from Every-

body group

Web client Allows the user to see documents in a folder in which the user

does not have read or write permissions. If this privilege is not

granted, the user can only see folders available to the group(s)they belong to.

Show users from Every-

body group

Web client Allows the user to see all users, including those in groups the

user does not belong to. If this privilege is not granted, the user

can only see other users in the group(s) they belong to.

User has a Personal Docu-

ments area

Web client Allows the user to organize folders in a private area and save

documents there.

View Agent settings Administration

software

Allows the user to view agent properties and agent activities,

but not modify any associated properties or perform any associ-

ated actions.

View data availability Web client Allows user to view data availability. This privilege does not

apply to Tivoli Netcool Performance Manager for Wireless.

View Datasource defini-

tions

Administration

software

Allows the user to view agent properties and agent activities,

but not perform any actions.

View documents on remote

servers

Web client Allows the user to browse through documents on remote serv-

ers.




41/188


View enterprise data avail-

ability.

Web client Allows the user to view enterprise data availability. This privi-

lege does not apply to Tivoli Netcool Performance Manager for

Wireless.

View entity and field map-

pings (equivalencies)

Administration

software

Allows the user to view entity equivalencies, but not edit them.

This privilege does not apply to Tivoli Netcool Performance

Manager for Wireless.

View entity data Administration

software

Allows the user to view entity information in the Entity Data

Editor, but not edit them. This privilege does not apply to Tivoli

Netcool Performance Manager for Wireless.

View promoted UDCs Administration

software

View promoted user-defined-calculations (UDCs).

View remote UDC defini-

tions

Administration

software

Allows the user to view the definition for a remote user-defined

calculation (UDC).

View users and user data Administration

software

Allows the user to view users, groups, and roles, but not edit

them.




42/188


5.4 User Management

User Management covers the tasks of adding and maintaining users and groups, and associating userswith roles.

Figure 4: User Management

5.4.1 Adding Users

You must have the appropriate privileges to add a user. The Add operation adds the user to the LDAPrepository and to the database, creating both inet_user (anonymous user) and user entries. A user isadded by default to the Everybody group, and assigned the Normal Web User role.

To add a user:

1. In the MANAGEUSERS tab, click the VIRTUOUSERS tab.

2. Click the ADDUSER button.

The ADDUSER dialog is displayed.


43/188


Figure 5: Adding a user

3. Enter the users details in the appropriate fields.

4. ClickOK.

The user is listed in the LISTOFUSERS.

5.4.2 Editing Users

You must have the appropriate privileges to edit a user.

To edit a user:

1. In the MANAGEUSERS tab, click the VIRTUOUSERS tab.

2. Select the user from the LISTOFUSERS.

3. Click the EDITUSER button.

4.Edit the users details as required.You cannot alter a users login ID.

5. ClickOK.

5.4.3 Deleting Users

Deleting a Tivoli Netcool Performance Manager for Wireless user removes the user from the server. Youmust have the appropriate privileges to delete a user. The following users cannot be deleted: useradm,virtuo and sysadm.

To delete a user:

1. In theMANAGEUSERS

tab, click theVIRTUOUSERS

tab.2. Select the user from the LISTOFUSERS.

Tip: Select more than one user using the Shift and Ctrl keys.

3. Click the DELETESELECTEDUSER(S) button.


44/188


A message is displayed asking you to confirm the deletion.

4. ClickYES.

5.4.4 Creating and Deleting Groups

Groups are primarily used by Tivoli Netcool Performance Manager for Wireless users to determine whocan access their reports. You must have the appropriate privileges to create or delete a group. You cannotdelete the system predefined groups: everybody and admin.

To create a group:

1. In the MANAGEUSERS tab, click the USERSBYGROUP tab.

2. Click the ADDUSERGROUP button.

The ADDGROUP dialog is displayed.

Figure 6: Adding user groups

3. Enter a name for the group.

4. ClickOK.

The group is listed in the LISTOFAVAILABLEUSERGROUPS.

To delete a group:


2. Select the group you want to delete.

Tip: Select more than one group using the Shift and Ctrl keys.

You cannot delete a group that has one or more users associated with it.

3. Click the DELETESELECTEDUSERGROUP(S) button.


4. ClickYES.


45/188


5.4.5 Adding and Removing Users to/from Groups

Adding users to groups is an easy way to allow users access to certain folders and reports. You musthave the appropriate privileges to add a user to a group.

To add/remove a user to a group:


2. Select the group that you want to add/remove users to/from, in the LISTOFAVAILABLEUSERGROUPS.

3. Add/Remove users as required.

Users are added by dragging the user from the AVAILABLEUSERS box to the ASSOCIATEDUSERSbox.

Users are removed by dragging the user from the ASSOCIATEDUSERS box to the AVAILABLEUSERSbox.


5.4.6 Assigning and de-assigning Users to/from a Role

Assigning users to a role allows you to determine how they interact with Tivoli Netcool PerformanceManager for Wireless software. You can restrict access to folders and systems, or you can grant specialprivileges to certain classes of users. You must have the appropriate privilege to assign users to a role.

To assign/de-assign users to a role:

1. In the MANAGEUSERS tab, click the USERSBYROLE tab.

2. Select the role that you want to assign/de-assign users to/from, in the LISTOFAVAILABLEROLES.

3. Assign/de-assign users as required.

Users are assigned by dragging the user from the AVAILABLEUSERS box to the ASSOCIATEDUSERSbox.

Users are de-assigned by dragging the user from the ASSOCIATEDUSERS box to the AVAILABLE

USERS box.



46/188


5.5 Role Management

Role Management covers the tasks necessary for the setting up and maintaining of roles.

5.5.1 Creating and Deleting Roles

Creating a role allows you to group custom privileges that can then be assigned to users. You must havethe appropriate privileges to create or delete a role. You cannot delete the system predefined roles: basicweb user, normal web user, power web user and system administrator.

To create a role:

1. Click the MANAGEROLES tab.

2. Click the ADDROLE button.

The ADDROLE dialog is displayed.

Figure 7: Adding roles

3. Enter details for the role.

4. ClickOK.

The role is listed in the LISTOFAVAILABLEROLES.

To delete a role:


2. Select the role you want to delete.

Tip: Select more than one role using the Shift and Ctrl keys.

You cannot delete a role that has one or more users associated with it.

3. Click the DELETESELECTEDROLE(S) button.


4. ClickYES.


47/188


5.5.2 Assigning/De-assigning Privileges to a Role

Assigning privileges to a role allows you to group the privileges you want to assign to users. Creatingroles is convenient when several people share common privileges. See Privileges on page 32 forinformation on access rights for different privileges. You must have the appropriate privileges to assign

privileges to a role.

To assign/de-assign privileges to a role:


2. Select the role that you want to assign/de-assign privileges to/from, in the LISTOFAVAILABLEROLES.

3. Assign/De-assign privileges as required.

Privileges are assigned by dragging the privilege from the PRIVILEGESAVAILABLEFORSELECTEDROLE box to the PRIVILEGESASSOCIATEDWITH SELECTEDROLE box.

Privileges are de-assigned by dragging the privilege from the PRIVILEGESASSOCIATEDWITH SELECTEDROLE box to the PRIVILEGESAVAILABLEFORSELECTEDROLE box.

Tip: Select more than one privilege using the Shift and Ctrl keys.


48/188


5.6 User Administration Command Line Tool

The user_admin tool provide a means of creating and deleting Tivoli Netcool Performance Manager forWireless users as well as upgrading user passwords. This tool is intended to support bulk provisioning ofusers. It can be used in parallel with the User Administration GUI.

This tool cannot be used off-line. It requires a virtuo administration login to the server hosting the TivoliNetcool Performance Manager for Wireless application.

5.6.1 Usage

user_admin [-asconf conf_name] parameters

-u -p -listusers simple

-u -p -listusers detail

-u -p -listroles

-u -p -add -f -ln -uid

-up -rf [-e ]

-u -p -modify -uid -up -u -p -delete -uid

Table 10: Options for user_admin Script

Option Description

-u Administration user name.

-p Administration password.

-listusers simple List user identifiers only.

-listusers detail List all user details for all users.

-listroles List roles.

-add -f -ln

-uid -

up -rf

[-e

]

Add user.

is the users first name

is the users last name

is the users login ID

is the users password

is the name of the role file, a role filespecifies a number of roles

is the users email address, an email addressis optional.

-modify -uid -up

Modify user. is the users login ID.

is the users new password.

-delete -uid Delete user. is the users login ID.


49/188


5.6.2 Listing Users

The List operations are threefold. The two user listings consist of the user identifiers only, and thedetailed listing of all user details. The role listing consists of listing all roles in the system.

To list user ids:user_admin -u -p -listusers simple

user_admin -u -p -listusers detail

user_admin -u -p -listroles

where: is the administrators login ID is the administrators login password

5.6.3 Adding Users

The Add operation adds a user to LDAP and to the database, creating both inet_user and user entries. A

user is added by default to the Everybody group in LDAP. A user is assigned to the roles specified in therole file. A user is assigned to all datasources in the system.

To add a user:

user_admin -u -p -add -f -ln -

uid -up -rf [-e ]

where: is the administrators login ID

is the administrators login password

is the users first name

is the users last name

is the users login ID is the users password is the name of the role file, a role file specifies a number of roles is the users email address, an email address is optional

Role Files

A role file specifies a number of roles. A user is added to the Normal Web User role by default. Eachrole file is a text file with a role per line. The role name is the name of the role in LDAP, and not the userfriendly role name as specified in the user interface. When adding a user, incorrect roles will be ignoredand a warning message will be displayed. The user will be added to correctly named roles only. If allroles in the role file are incorrect, the user will still be added to the Normal Web User role.

Example of a Role File:

WebUserNormal

WebUserPower


50/188


5.6.4 Modifying a Users password

The Modify operation allows a user password to be modified. The following users may not be modified:useradm, virtuo and sysadm.

To modify a user:user_admin -u -p -modify -uid -up

where: is the administrators login ID is the administrators login password

is the users login ID is the users new password

5.6.5 Deleting Users

The Delete operation removes a user completely from the system. This includes all references to the userin the database and in LDAP. The following users may not be deleted: useradm, virtuo and sysadm.

To delete a user:

user_admin -u -p -delete -uid

where: is the administrators login ID is the administrators login password is the user login ID of the user to delete


51/188


6 Tivoli Netcool Performance Managerfor Wireless Operations Tasks

This chapter describes a number of operations tasks and housekeeping activities that are essential for theoperation of Tivoli Netcool Performance Manager for Wireless. These include:

Daily Loader Operations Tasks

Loader Housekeeping

Although not regular tasks, the following are also described:

Checking TFP_SHM_MIN_SIZE

TFP_NC_STABILITY

6.1 Daily Loader Operations Tasks

In a Tivoli Netcool Performance Manager for Wireless system there may be a number of loaders runningfor a number of technologies. The loader process runs constantly taking data from the loader spool

directories and loading it into the performance database.

The loader process is critical to the functioning of Tivoli Ne

Netcool Wireless Admin Guide

Documents

Transcript of Netcool Wireless Admin Guide