network management system 5 linux

8/10/2019 Network Management System 5 Linux

http://slidepdf.com/reader/full/network-management-system-5-linux 1/24

NMS5LXrelease 6.3 and successive ones

Network Management System 5 Linux

Administrator manual

Volume 1/1

MN.00143.E - 002



The information contained in this handbook is subject to change without notice.

Property of Siae Microelettronica S.p.A. All rights reserved according to the law and according to theinternational regulations. No part of this document may be reproduced or transmitted in any form orby any means, electronic or mechanical, without written permission from Siae Microelettronica S.p.A.

Unless otherwise specified, reference to a Company, name, data and address produced on the screendisplayed is purely indicative aiming at illustrating the use of the product.

HP®, and HP-UX are Hewlett Packard Company registered trademarks.

LINUX term is a trademark registered by Linux Torvald, the original author of the Linux OperatingSystem. LINUX is freely distributed according to the GPL (GNU Public License).

SUSE® is a SUSE LINUX Products GmbH registered trademark

Oracle® is a Oracle Corporation registered trademark.

“Mondo Rescue” is freely distributed according to the GPL (GNU Public License).

Other products cited here in are constructor registered trademarks.



NMS5LX 6.3 Administrator manual – MN.00143.E - 002 1

NMS5LX 6.3ADMINISTRATOR MANUAL

CONTENTS

PREFACE.......................................................................................................................2

1. NMS5-LX ADMINISTRATOR RESPONSABILITIES..........................................................3

1.1 Provide suitable hardware/software for running NMS5-LX...........................................3

1.1.1 Hardware characteristics ............................................................................3

1.1.2 Software requirements ..............................................................................3

1.1.3 File systems configuration..........................................................................4

1.1.4 Enable correct network services..................................................................4

1.1.5 Enable X-Client remote connection..............................................................4

1.2 Provide correct codewords and licenses ...................................................................4

1.3

Maintaining NMS5-LX.............................................................................................5

2. INSTALLING NMS5-LX..................................................................................................6

2.1 Complete LINUX/ORACLE/NMS5-LX Installation ........................................................6

2.2 Oracle and NMS5-LX manual installation ..................................................................7

2.2.1 Unloading NMS5-LX directories...................................................................7

2.3 Setting the environment.........................................................................................7

2.4 Configuring NMS5-LX.............................................................................................8

2.5 Creating other NMS5-LX users ................................................................................9

3. CONTROLLING ACCESS TO NMS5-LX ..........................................................................10

4.

USING GRAPHICAL MENU TO START AND STOP NMS5-LX ..........................................11

5. CUSTOMIZING NMS5-LX.............................................................................................12

6. MODIFY WORKSTATION IP-ADDRESS........................................................................15

7. BACKING UP AND RESTORING NMS5-LX DATABASE ..................................................16

7.1 NMS5-LX DATABASE BACKUP/RESTORE.................................................................16

8. RESETTING NMS5-LX DATABASES..............................................................................17

9. TROUBLESHOOTING...................................................................................................18

10. SAVING NMS5-LX INSTALLATION..............................................................................19

11. ANNEX-A ....................................................................................................................20

11.1 Preparing to install Oracle ....................................................................................20



2 NMS5LX 6.3 Administrator manual – MN.00143.E - 002

PREFACE

The purpose of this manual is to give the administrator of the NMS5-LX system the necessaryinformation to put the application into service, perform maintenance during NMS5-LX use andachieving good performance for the operators.

This manual covers the following topics:

o Hardware characteristics

o Software characteristics

o Resource dimensioning

o System tuning

o NMS5-LX installation

o Maintenance

o Troubleshooting




1. NMS5-LX ADMINISTRATOR RESPONSABILITIES

The Network Management System 6 has been developed by SIAE Microelettronica over the power ofthe Linux operating system in order to increase performance and capabilities of network monitoringand management.

The large amount of information involved during NMS5-LX activity is managed using the OracleDBMS. The NMS5-LX administrator should be aware of these three components (LINUX, Oracle andNMS5-LX) and their properties and relationships in order to ensure the maximum throughput inmanaging his telecommunication network.

The main administrator tasks, with a detailed description of each activity, follow.

1.1 Provide suitable hardware/software for running NMS5-LX

Before installing the application, you must take care that your PC is suited for the task it is proposedfor.

Running NMS5-LX in fact involves a high demand of machine resources, for graphics, databaseoperations, speedy event handling and general performances.

So, in order to get the best results in managing your network with NMS5-LX, the following is theminimum configuration.

1.1.1 Hardware characteristics

The target server used in SIAE during NMS5-LX testing is a PC with following HW characteristics:

• CPU : Pentium 4 3,2 GHz

• RAM : 1024 DDR PC3200

• HARD DISK : HD 80 GB 7200 rpm SATA

• DVD +/- RW: present

• GRAPHIC CARDS: AGP cards with 64Mb ram managing 1280x1024 to 75Hz.

• MONITOR: managing 1280x1024 resolution, at least 75Hz in case of analogue monitor.

• NETWORK CARDS: supporting 10/100 Mbits speed.• MOUSE: 3-button mouse.

1.1.2 Software requirements

Running NMS5-LX requires the following software:

• LINUX SUSE 9.3

• Oracle 10.g

• OSF Motif 2.1, X11 r.6




1.3 Maintaining NMS5-LX

To ensure the conditions demanded for the correct operation of NMS5-LX do not loose their validityalong with system utilisation, the System Administrator must take care of Alarm History dimension,file system occupation, log files dimension or looping processes.




2. INSTALLING NMS5-LX

NMS5-LX con be installed on a PC following two different procedures:

o Using the provided DVD “Complete LINUX/ORACLE/NMS5-LX Installation DISK” whichconfigures your PC starting from the re-installation of the operating system. This procedureis described in chapter 2.1

o Manually installing Oracle and NMS5-LX on a PC where LINUX ha been already installed andconfigured. This procedure is described in chapter 2.2

2.1 Complete LINUX/ORACLE/NMS5-LX Installation

By using this procedure it is possible to configure a PC for the usage of NMS5-LX starting from there-installation of the SUSE LINEX Operating System.

The DVD has been prepared using “Mondo Rescue” which is a SW freely distributed according to theGPL (GNU Public License).

Execute following commands to implement the procedure:

1. Configure the BIOS of you PC selecting the DVD device to be the primary boot path

2. Insert the provided DVD labelled as “Complete LINUX/ORACLE/NMS5-LX Installation DISK”in the DVD device of you PC.

3. Reboot you PC

4. Accept the automatic selection for the proposed procedure5. From the proposed “How should I restore” window select “Automatically” choice

6. From the proposed “Read From” window select “DVD disks” choice

7. Accept the automatic selection for the proposed procedure

8. Press “YES” to the proposed selection in the alert window

9. Wait for the installation procedure that will take several minutes....

10. Press OK to the proposed selection and then remove the DVD from the device

11. Enter command “exit” to reboot the PC

12. After the reboot select “SUSE 9.3” to the proposed selection

13. Login in the system as user “root” password “root”

14. Press “YES” in the “New HW found” window that requires the reconfiguration of the HD

15. Select “NO” in the “Partitioning” window

16. The PC is now correctly configured as regards the whole LINUX, ORACLE and NMS5-LXinstallations.




2.2 Oracle and NMS5-LX manual installation

Before proceeding with Oracle and NMS5-LX installation pleas verify the your LINUX SUSE 9.3installation satisfies to the requirements described in chapter 1.1.3 1.1.4 and 1.1.5.

In order to install Oracle please follow the procedure described in chapter 11 (ANNEX-A).

After having correctly installed Oracle and having created NMS5-LX Oracle DB you can proceed withNMS5-LX installation.

2.2.1 Unloading NMS5-LX directories

Insert the CD/DVD labelled “NMS5LX rel X.Y Installation”.

The system should recognize the new CD/DVD automatically in the directory /media/siae

As Linux user “root” execute:

o cd /opt

o tar zxvf /media/siae/NMS_LX_INSTALL_XYX.TAR.Z ./nms5ux (whereNMS_LX_INSTALL_XYX.TAR.Z is the file contained in the CD ROM and XYX is the release ofNMS5-LX installed )

WARNING

Before going further with the installation of NMS5-LX please verify you have the software activationcodewords from SIAE.

2.3 Setting the environment

Execute following commands to set the correct environment needed by NMS5-LX to run:

• Set the default values for some NMS5-LX system parameters executing the command:

cd /opt/nms5ux/install

./nms5ux_createlink.sh

• Activate the NMS5-LX codewords provided by SIAE by creating and editing the file

/opt/tmn5ux/.ems6d.cw

• Open the file /etc/services and append the following lines, required by the software thatmanages communication between NMS5-LX software modules:

r_hdlc 4210/tcp

s_hdlc 4211/tcp

Z_MM 22377/tcp

Z_BMF 22378/tcp

Z_EB 22379/tcp

Z_RMSG 22380/tcp




Z_SPMD 22381/tcp

Z_DB 22382/tcp

Z_EMS6D 22385/tcp

Z_EXTMA 22386/tcp

RemPortSNMP 22400/tcp

RemPort 22300/tcp

RemPortLegacySwdl 22600/tcp

RemPortRm 22700/tcp

SmitPort 22500/tcp

OvTrapd 24300/tcp

Siaew 24200/tcp

SiaewEvn 24100/tcp

• Edit file /opt/nms5ux/local_env/Nms5uxProfileUser and properly modify the line which

sets variables TMN5DR and EMS6D and put them to result of uname -n Linux command.

• Edit /opt/nms5ux/conf/app-defaults/Nms5ux and properly modify the line which setsthe *ipHost variable and enter the IP ADDRESS of your workstation. In same file look forvariable clientList and set it to result of uname –a Linux command followed by “;”.

• Add environment variables necessary for running NMS5-LX to the root user .profile file; editfile /root/.profile and enter new line:

. /opt/nms5ux/local_env/Nms5uxProfileUser

• Log out and then login again as root in order to set the current environment variables.

• Edit file /etc/skel/.profile and add line:


2.4 Configuring NMS5-LX

• Login as Linux user Oracle and:

− Start-up oracle listener and NMS5-LX database with commands:

N.B.: Before executing following commands please verify that file /etc/oratab hasbeen correctly modified as described in ANNEX-A at the end of NMS5-LX Oracle

Database procedure.

• cd $ORACLE_HOME/bin

• ./lsnrctl start

• dbstart

• As Linux user “root” execute the following scripts sequence and monitor possible malfunctions(failure in dropping database tables is not to be considered as an error):

./nms5ux_createdb.sh

• Create Linux group “nms5ux” .

• Create Linux user “nms5ux” belonging to Linux group “nms5ux ”.

• Edit file /home/nms5ux/.profile and verify that there is the line





3. CONTROLLING ACCESS TO NMS5-LX

The NMS5-LX system can be started at various operating levels; each level (in a bottom-upsequence) gives the operator a growing visibility over NMS5-LX functionality, enabling the use ofoptions, procedures etc.

The NMS5-LX system has 5 operative levels:

Superuser Is the administrator of the system. Only this user can create, delete or modifyusers, passwords and their operating level.

PrivilegedAdvancedNormal

Entry These four levels are assigned with the visibility of only some of the NMS5U-LXsystem functions

Review the Appendix section of the NMS5-LX users manual for complete listing of all functionsavailable for each level.




4. USING GRAPHICAL MENU TO START AND STOP NMS5-LX

NMS5-LX activity takes place by mean of a pool of daemons that, interacting with each otherperform all the communications, data management and event handling tasks.

This pool of processes needs to be active to run NMS5-LX

NMS5-LX functionalities can be managed by a graphical menu present in directory

/opt/nms5ux/start

To access this application execute following commands:

• cd /opt/nms5ux/start

• ./nmsWinMenu

If you want to use this script to start Oracle you must know password for Linux user "oracle".

If you want to use this script to start NMS5-LX you must know password for Linux user "root".

Otherwise if you just want to start NMS5-LX graphical interface you can be the Linux user you haveconfigured (see the last part of this document).

A graphical interface will be displayed with following items:

• Start-up Functions

• Shutdown Functions

• Check Functions

• NMS5-LX application Login

• NMS5-LX Application Login Read/Only

If you select Shutdown Functions a new interface is displayed with following icons

• Oracle Platform Restart (to start-up Oracle daemons)

• NMS5LX Platform Restart (to start-up NMS5-LX daemons)

If you select Start-up Functions a new interface is displayed with following icons

• Oracle Platform Stop (to stop Oracle daemons)

• NMS5LX Platform Stop (to stop NMS5-LX daemons)

If you select Check Functions a new interface is displayed with following icons

• Oracle Check Platform (to check Oracle daemons)

• NMS5LX Check platform (to check NMS5LX daemons)

Select “NMS5LX Application Login” to start a normal NMS5-LX graphical session.

Select “NMS5LX Application Login R/O” to start an NMS5-LX graphical session with read/onlyprivileges.




5. CUSTOMIZING NMS5-LX

The customisation of the NMS5-LX system consists in the re-definition of some of the parametersused by SIAE applications.

The following tables lists some of the system parameters that might be of any interest for thesystem administrator; all of them are contained in the 2 files:

/opt/nms5ux/conf/app-defaults/Nms5ux

/opt/nms5ux/conf/app-defaults/Nms5lx

In any case we suggest that modification of parameters present in these files should be done withsupport of SIAE personnel.

In file /opt/nms5ux/conf/app-defaults/Nms5ux you will find following parameters

Reference string Meaning Default value Value range

DateFormat It represents the formatused to display date/timein applications

1 - ddmmyyyy 0 - Extended 1- ddmmyyyy 2- mmddyyyy 3- yyyymmdd

MaxRecPrim It represents the maxnumber of PM primaryrecord to be exported

100 > 0

MaxRecGio It represents the maxnumber of PM daily recordto be exported

100 > 0

nms5trapd*autoDeleteTimeOffsetHistory It represents how manydays of Alarm History aremaintained in DataBase

90 > 0

nms5trapd*maxRecordInHistory It represents how many Alarms are maintained inDataBase

50000 > 0

nms5trapd*maxRecordInTrLog It represents how manylog records are maintainedin DataBase

1000 > 0

*warningEvents:

It represents the maxnumber of records loadedby alarm history browserwithout any warningmessage

1000 > 0

*maxEvents:It represents the maxnumber of records loadedby alarm history browser

5000 > 0

*MaxSmnpSameTime:It represents the maxnumbers of SNMPoperation managedsimultaneously bybasement process: (e.g..

polling operation, AlarmRealignment )

10 > 0




Reference string Meaning Default value Value range

alrBellManagement Set to “1” it sets NMS5LXgraphical application toutter as soon a new events

is received. UsealrBellSeverity parameterto introcude furtherspecifications.

0 0 – No Utter1 – Utter

alrBellSeverity It configures NMS5LXgraphical application toutter if the received alarmhas a specific severity

0 0 – Always4 = Critical3 >= Major2 >= Minor1 >= Warning




6. MODIFY WORKSTATION IP-ADDRESS

If you need to modify your workstation IpAddress please follow this procedure:

• stop NMS5-LX Platform

• stop Oracle Platform

• modify workstation IpAddress

• restart Oracle Platform

• execute command “/opt/nms5ux/tools/routeTab_generator”

• edit files

− /opt/nms5ux/conf/SiaeRoutingTable.auto

− /opt/nms5ux/conf/SiaeIfConfig.auto

and modify all routing information changed by Ip Addresses modification

• edit file “/opt/nms5ux/conf/app-defaults/Nms5ux” and modified value of variable “*ipHost”with new WS ip address.

• restart NMS5-LX platform.




7. BACKING UP AND RESTORING NMS5-LX DATABASE

NMS5-LX gives the operator the possibility to save his data for security; the system stores allinformation regarding network topology and equipment configuration (Oracle NMS5-LX database). Inaddition, it is also possible to backup and restore the Alarm History or Performance Monitoring tablesonly. It is recommended to perform a weekly backup, but take care of situations where a largeamount of changes occur in the network.

The "Database Backup" (and similarly the Alarm History backup) feature behave as describedbelow:

7.1 NMS5-LX DATABASE BACKUP/RESTORE

In order to backup the system database tables contents onto the hard disk, the user has to selectthe 'Backup to disk' toggle button and press the OK button which initiates the backup procedure. Thebacked up files are created in the directory shown in the window.

In order to restore the Alarm History select the relevant menu item and enter a the filename asrequested; for the NMS5-LX database files (tmn5ux database and OV files) you should follow thesesteps:

login as root

stop NMS5-LX platform processes

change directory /usr/tmn5ux/manager/tools

execute ./TmnDbRestore

restart NMS5-LX platform processes

you don't need to be "root" any more

restart the graphical application




8. RESETTING NMS5-LX DATABASES

The following procedure gives the NMS5-LX administrator the ability to recover an abnormalsituation when a complete reset of the whole network is necessary.

N.B.: Following commands completely delete all NEs present in network.

• Execute commands:


• ./nmsWinMenu

− stop NMS5-LX Platform (see chapter 4 for details in using nmsWinMenu application)

• As Linux user “root” execute the following scripts sequence and monitor possible malfunctions(failure in dropping database tables is not to be considered as an error):

./nms5ux_createdb.sh

• Execute commands:


• ./nmsWinMenu

− restart NMS5-LX Platform (see chapter 4 for details in using nmsWinMenu application)

− login in NMS5-LX graphical application form nmsWinMenu (call SIAE to get the firstlogin and password ) and create a new Nms5-LX User (Menu “Option->SystemUsers” ) related to Linux user “nms5ux” with privileged “Superuser” associated to map

“nms5ux” .

• Log out; from now on, you can log into your Linux system as “nms5ux” user and run NMS5-

LX by entering the following command:• cd /opt/nms5ux/start

• ./nmsWinMenu

− login in NMS5-LX graphical application (see chapter 4 for details in using nmsWinMenuapplication)




9. TROUBLESHOOTING

During NMS5-LX system use each operator should pay close attention to the tasks he is performingso in the case of a problem, it is possible to recover the system as soon as possible.

In any case it is absolutely necessary to clearly identify the particular application that is currentlycausing the problem: Oracle database, NMS5-LX managers or base platform processes.

This kind of skill cannot be automatically achieved; a lot of experience needs to be gathered tounderstand NMS5-LX architecture, interpreting log files and contacting SIAE.

The next sections and descriptions can be the starting point in NMS5-LX architecture comprehension.Please pay close attention to them.

In case of a problem, you are kindly requested to give SIAE precise and clear information in order tominimize response time.

First of all, try to discriminate between the nature of the problem; if you suspect the trouble is abug,

• Try to reproduce the malfunctioning situation

• Compile and send a detailed customer trouble report

The clearer the problem description, the quicker SIAE will be able to provide a patch to resolve theproblem.

If you find problems regarding base processes or communication with network elements

• Identify the specific process that is faulty using nmsWinMenu NMS5LX check processes function

• Try to recover for example stopping and restarting base processes

If this is unhelpful please store HPUX and the NMS5-LX log files in a tape and send them to SIAE forexamination, using procedure

su - root

cd /opt/nms5ux/tools

./save_nms5ux_log

then send SIAE the files NMS5.LOG.Z and TMN5.LOG.Z




10. SAVING NMS5-LX INSTALLATION

The recommended procedure to backup the NMS5-LX installation is the same that SIAE uses toprovide the DVD labeled “Complete LINUX/ORACLE/NMS5-LX Installation DISK”.

The application used to execute this procedure is “Mondo Rescue” which is a SW freely distributedaccording to the GPL (GNU Public License).

To create a new DVD to save PC installation execute following steps:

• Insert a new DVD in the DVD +/- RW device

• Using “YaST - Hardware - CD-ROM drives” find the /dev/hdx associated to that device

• Stop both NMS5-LX and Oracle platform using nmsWinMenu application

• As Linux user “root” execute the command:

o mondoarchive -OVr -d /dev/hdx -gF -s 4200M




11. ANNEX-A

11.1 Preparing to install Oracle

In order to install Oracle 10g on you Linux PC please refer to the document:

“Introduction to Oracle 10g R1 (10.1.0.3) on SUSE Linux Professional 9.3”

present in official LINUX SUSE web site.

Respect to the official document we introduced few modifications that must be taken in account

before proceeding with installation:

• Once having executed orarun package please change primary group of newly created “oracle” Linux user from “oinstall ” to “dba” and during all installation procedure rememberthat “dba” is the Operating System Group Name that has the capabilities for the installationand maintenance operations.

• Before executing ./runInstaller program verify Oracle databases locations: in preconfiguredfiles for NMS5-LX oracle environment variables are supposed to be :

ORACLE_HOME: /opt/oracle/product/10.1.0

ORACLE_BASE: /opt/oracle

ORACLE_SID: NSM5UX

NLS_LANG: AMERICAN_AMERICA.WE8ISO8859P1

ORA_NLS33 $ORACLE_HOME/ocommon/nls/admin/data

ORA_NLS10 $ORACLE_HOME/nls/data

Edit files /etc/profile.d/oracle.* and configure the environment variables as reported above.

N.B. Any differences with respect to those values must be reported in file:

/opt/nms5ux/local_env/Nms5uxProfileUser.

• At the end of the ./runInstaller execution create a new databases related to SID “ NMS5UX ”placing files in directory “/oradata” and using following settings:

-> custom

-> create new database file

-> multipurpose

-> concurrently connected user = 50

-> Dedicated Server Mode

-> choose to enable sqlplus help only

-> Global database name = NMS5UX

-> SID = NMS5UX

-> Compatible par = 8.1.0

-> Change Char Set = WE8ISO8859P1(both)-> Cntrl Files ok




-> TABLESPACES

-> SYSTEM ok

-> TOOLS ok

-> USERS

change tablespace name into “DATA” and set size=1000MB;

set extents AUTOEXT=on and NEXT=100000KB;

set storage unlimited ON;

-> RBS ok

-> TMP ok

-> create new tablespace INDX

set size=250MB;

set extents AUTOEXT=on and NEXT=10000KB;

set storage unlimited ON;

-> redo logs 1,2 3 size=5000k-> checkpoint interval = 10000000

-> checkpoint timeout = 1800000

-> archive NOT ENABLE

-> shared pool size=90485760M

-> block buffer=40480

-> create now

(sys_account_password = change_on_install

system_account_password = manager )

N.B.: Oracle patch that upgrades release up to 10.1.0.4 is also needed on your PC. Copy ina temporary directory of you Linux PC the zip file provided in the CD labeled “Oracle 10gR1 (10.1.0.4) Patch Set” and then execute:

o unzip p4163362_10104_LINUX.zip

Then follow instruction reported in associated document:

“Oracle Database Patch Set Notes, 10g Release 1 (10.1.0.4) Patch Set 2 for Linux x86”

network management system 5 linux

Documents