Netcool Wireless Admin Guide
-
Upload
arunkcherian -
Category
Documents
-
view
227 -
download
0
Transcript of Netcool Wireless Admin Guide
-
8/2/2019 Netcool Wireless Admin Guide
1/188
Administration Guide
Netcool Performance Manager for Wireless
Version 9.1.2
-
8/2/2019 Netcool Wireless Admin Guide
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.
-
8/2/2019 Netcool Wireless Admin Guide
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
-
8/2/2019 Netcool Wireless Admin Guide
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
Tivoli Netcool Performance Manager for
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
-
8/2/2019 Netcool Wireless Admin Guide
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
-
8/2/2019 Netcool Wireless Admin Guide
6/188
vi Tivoli Netcool Performance Manager for Wireless: Adm inistration Gu ide
-
8/2/2019 Netcool Wireless Admin Guide
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/2/2019 Netcool Wireless Admin Guide
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
-
8/2/2019 Netcool Wireless Admin Guide
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
Tivoli Netcool Performance Manager for
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.
Tivoli Netcool Performance Manager for
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.
-
8/2/2019 Netcool Wireless Admin Guide
10/188
-
8/2/2019 Netcool Wireless Admin Guide
11/188
Copyright IBM Corp. 2008 5
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
-
8/2/2019 Netcool Wireless Admin Guide
12/188
6 Tivoli Netcool Performance Manager for Wireless: Adm inistration Gu ide
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.
-
8/2/2019 Netcool Wireless Admin Guide
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.
-
8/2/2019 Netcool Wireless Admin Guide
14/188
8 Tivoli Netcool Performance Manager for Wireless: Adm inistration Gu ide
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.
-
8/2/2019 Netcool Wireless Admin Guide
15/188
Tivoli Netcool Performance Manager for Wireless Architecture Overview 9
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.
-
8/2/2019 Netcool Wireless Admin Guide
16/188
10 Tivoli Netcool Performance Manager for Wireless: Adm inistration Gu ide
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.
-
8/2/2019 Netcool Wireless Admin Guide
17/188
Tivoli Netcool Performance Manager for Wireless Architecture Overview 11
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
-
8/2/2019 Netcool Wireless Admin Guide
18/188
12 Tivoli Netcool Performance Manager for Wireless: Adm inistration Gu ide
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.
-
8/2/2019 Netcool Wireless Admin Guide
19/188
Tivoli Netcool Performance Manager for Wireless Architecture Overview 13
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
-
8/2/2019 Netcool Wireless Admin Guide
20/188
14 Tivoli Netcool Performance Manager for Wireless: Adm inistration Gu ide
-
8/2/2019 Netcool Wireless Admin Guide
21/188
Copyright IBM Corp. 2008 15
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
-
8/2/2019 Netcool Wireless Admin Guide
22/188
16 Tivoli Netcool Performance Manager for Wireless: Adm inistration Gu ide
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.
Tivoli Netcool Performance Manager for
Wireless Software Installation
Installing Virtuo and required third party products.
Tivoli Netcool Performance Manager for
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.
-
8/2/2019 Netcool Wireless Admin Guide
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
-
8/2/2019 Netcool Wireless Admin Guide
24/188
18 Tivoli Netcool Performance Manager for Wireless: Adm inistration Gu ide
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_\*
10 2 * * * /appl/virtuo/admin/common/cron/cron_script -r -d 5 /appl/virtuo/var/
loader/dat PDO_\*
20 2 * * * /appl/virtuo/admin/common/cron/cron_script -r -d 5 /appl/virtuo/var/
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:
-
8/2/2019 Netcool Wireless Admin Guide
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=
-
8/2/2019 Netcool Wireless Admin Guide
26/188
20 Tivoli Netcool Performance Manager for Wireless: Adm inistration Gu ide
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.
-
8/2/2019 Netcool Wireless Admin Guide
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-
cess.loadcdmanortelevdor3.start.
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-
cess.loadcdmanortelevdor3.start.
timeout=30000
Defines the timeout period i.e. length of time to wait
to restart the loader if the loader fails to start.
-
8/2/2019 Netcool Wireless Admin Guide
28/188
22 Tivoli Netcool Performance Manager for Wireless: Adm inistration Gu ide
-
8/2/2019 Netcool Wireless Admin Guide
29/188
Copyright IBM Corp. 2008 23
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.
-
8/2/2019 Netcool Wireless Admin Guide
30/188
24 Tivoli Netcool Performance Manager for Wireless: Adm inistration Gu ide
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:
Execute the following command as user root:
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:
1. Execute the following command as user root:
-
8/2/2019 Netcool Wireless Admin Guide
31/188
Starting and Stopping Tivoli Netcool Performance Manager for Wireless 25
svcadm enable sapmon-na
4.4.2 Stopping the Process Monitor
To stop the Process Monitor:
1. Execute the following command as user root:
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:
1. Execute the following command as user root:
svcadm enable sapmgr-na
4.5.2 Stopping the Process Manager
To stop the Process Manager, complete the following:
Execute the following command as user root:
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:
1. Execute the following command as user root:
svcadm enable sap-na
It may take a few minutes to start all the processes.
-
8/2/2019 Netcool Wireless Admin Guide
32/188
26 Tivoli Netcool Performance Manager for Wireless: Adm inistration Gu ide
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:
1. Execute the following command as user root:
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
-
8/2/2019 Netcool Wireless Admin Guide
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.
svcadm enable sapmon-na
svcadm enable sapmgr-na
svcadm enable sap-na
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
-
8/2/2019 Netcool Wireless Admin Guide
34/188
28 Tivoli Netcool Performance Manager for Wireless: Adm inistration Gu ide
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
-
8/2/2019 Netcool Wireless Admin Guide
35/188
Copyright IBM Corp. 2008 29
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.
-
8/2/2019 Netcool Wireless Admin Guide
36/188
30 Tivoli Netcool Performance Manager for Wireless: Adm inistration Gu ide
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
-
8/2/2019 Netcool Wireless Admin Guide
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.
-
8/2/2019 Netcool Wireless Admin Guide
38/188
32 Tivoli Netcool Performance Manager for Wireless: Adm inistration Gu ide
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.
Allow access to Alarm
Manager
Web Client Allows the user to activate and deactivate alarms, and to modify
alarm definitions.
Allow access to Alarm
Viewer
Web Client Allows the user to view and acknowledge alarms.
-
8/2/2019 Netcool Wireless Admin Guide
39/188
Tivoli Netcool Performance Manager for Wireless Application Administration 33
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.
Table 9: Privilege Descriptions
Privilege Applies To Description
-
8/2/2019 Netcool Wireless Admin Guide
40/188
34 Tivoli Netcool Performance Manager for Wireless: Adm inistration Gu ide
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.
Table 9: Privilege Descriptions
Privilege Applies To Description
-
8/2/2019 Netcool Wireless Admin Guide
41/188
Tivoli Netcool Performance Manager for Wireless Application Administration 35
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.
Table 9: Privilege Descriptions
Privilege Applies To Description
-
8/2/2019 Netcool Wireless Admin Guide
42/188
36 Tivoli Netcool Performance Manager for Wireless: Adm inistration Gu ide
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.
-
8/2/2019 Netcool Wireless Admin Guide
43/188
Tivoli Netcool Performance Manager for Wireless Application Administration 37
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.
-
8/2/2019 Netcool Wireless Admin Guide
44/188
38 Tivoli Netcool Performance Manager for Wireless: Adm inistration Gu ide
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:
1. In the MANAGEUSERS tab, click the USERSBYGROUP tab.
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.
A message is displayed asking you to confirm the deletion.
4. ClickYES.
-
8/2/2019 Netcool Wireless Admin Guide
45/188
Tivoli Netcool Performance Manager for Wireless Application Administration 39
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:
1. In the MANAGEUSERS tab, click the USERSBYGROUP tab.
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.
Tip: Select more than one user using the Shift and Ctrl keys.
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.
Tip: Select more than one user using the Shift and Ctrl keys.
-
8/2/2019 Netcool Wireless Admin Guide
46/188
40 Tivoli Netcool Performance Manager for Wireless: Adm inistration Gu ide
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:
1. Click the MANAGEROLES tab.
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.
A message is displayed asking you to confirm the deletion.
4. ClickYES.
-
8/2/2019 Netcool Wireless Admin Guide
47/188
Tivoli Netcool Performance Manager for Wireless Application Administration 41
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:
1. Click the MANAGEROLES tab.
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.
-
8/2/2019 Netcool Wireless Admin Guide
48/188
42 Tivoli Netcool Performance Manager for Wireless: Adm inistration Gu ide
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.
-
8/2/2019 Netcool Wireless Admin Guide
49/188
Tivoli Netcool Performance Manager for Wireless Application Administration 43
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
-
8/2/2019 Netcool Wireless Admin Guide
50/188
44 Tivoli Netcool Performance Manager for Wireless: Adm inistration Gu ide
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
-
8/2/2019 Netcool Wireless Admin Guide
51/188
Copyright IBM Corp. 2008 45
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