Documente Academic
Documente Profesional
Documente Cultură
Administrator manual
Volume 1/1
MN.00143.E - 002
NMS5LX 6.3
ADMINISTRATOR MANUAL
CONTENTS
PREFACE.......................................................................................................................2
1.
2.
1.1.2
1.1.3
1.1.4
1.1.5
1.2
1.3
INSTALLING NMS5-LX..................................................................................................6
2.1
2.2
2.3
2.4
2.5
3.
4.
5.
CUSTOMIZING NMS5-LX.............................................................................................12
6.
7.
8.
9.
TROUBLESHOOTING ...................................................................................................18
PREFACE
The purpose of this manual is to give the administrator of the NMS5-LX system the necessary
information to put the application into service, perform maintenance during NMS5-LX use and
achieving good performance for the operators.
This manual covers the following topics:
Hardware characteristics
Software characteristics
Resource dimensioning
System tuning
NMS5-LX installation
Maintenance
Troubleshooting
1.
The Network Management System 6 has been developed by SIAE Microelettronica over the power of
the Linux operating system in order to increase performance and capabilities of network monitoring
and management.
The large amount of information involved during NMS5-LX activity is managed using the Oracle
DBMS. The NMS5-LX administrator should be aware of these three components (LINUX, Oracle and
NMS5-LX) and their properties and relationships in order to ensure the maximum throughput in
managing his telecommunication network.
The main administrator tasks, with a detailed description of each activity, follow.
1.1
Before installing the application, you must take care that your PC is suited for the task it is proposed
for.
Running NMS5-LX in fact involves a high demand of machine resources, for graphics, database
operations, speedy event handling and general performances.
So, in order to get the best results in managing your network with NMS5-LX, the following is the
minimum configuration.
1.1.1
Hardware characteristics
The target server used in SIAE during NMS5-LX testing is a PC with following HW characteristics:
1.1.2
Software requirements
Oracle 10.g
1.1.3
For the installation and utilization of NMS5-LX and its components we recommend the following
settings as regards file system dimensioning:
/tmp
2 GB
/home
2 GB
/var
3 GB
/usr
4 GB
/root
2 GB
/opt
8 GB
/oradata
10 GB
The last file system is specific for the NMS5-LX application and contains the Oracle data files for the
NMS5-LX Oracle database.
We also recommend using the LVM (Logical Volume Manager) to manage the logical organization of
the partitioning and the reiser fs for the file systems formatting.
1.1.4
In order to correctly use all the functionalities provided by NMS5-LX you have to enable following
network services:
o
FTP
RLOGIN
TELNET
1.1.5
In order to allow the operator to login remotely to NMS5-LX application you have to configure the
Display Manager:
o
1.2
1.3
Maintaining NMS5-LX
To ensure the conditions demanded for the correct operation of NMS5-LX do not loose their validity
along 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
Manually installing Oracle and NMS5-LX on a PC where LINUX ha been already installed and
configured. This procedure is described in chapter 2.2
2.1
By using this procedure it is possible to configure a PC for the usage of NMS5-LX starting from the
re-installation of the SUSE LINEX Operating System.
The DVD has been prepared using Mondo Rescue which is a SW freely distributed according to the
GPL (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.
3.
Reboot you PC
4.
5.
From the proposed How should I restore window select Automatically choice
6.
From the proposed Read From window select DVD disks choice
7.
8.
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-LX
installations.
2.2
Before proceeding with Oracle and NMS5-LX installation pleas verify the your LINUX SUSE 9.3
installation 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 with
NMS5-LX installation.
2.2.1
cd /opt
WARNING
Before going further with the installation of NMS5-LX please verify you have the software activation
codewords from SIAE.
2.3
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 that
manages 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
Add environment variables necessary for running NMS5-LX to the root user .profile file; edit
file /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.
2.4
Configuring NMS5-LX
N.B.: Before executing following commands please verify that file /etc/oratab has
been 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
Execute commands:
cd /opt/nms5ux/start
./nmsWinMenu
stop/restart Oracle and then stop/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 first login
and password) and create a new Nms5-LX User (Menu Option->System Users) 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 NMS5LX by entering the following command:
cd /opt/nms5ux/start
./nmsWinMenu
2.5
Create a new Linux user (i.e. peter) belonging to Linux group nms5ux.
As NMS5-LX Superuser create a new user from NMS5-LX System User application, associated
to new Linux user (peter) with desired privileges and map.
Log out from workstation and log in as the new user peter and execute.
cd /opt/nms5ux/start
./nmsWinMenu
3.
The NMS5-LX system can be started at various operating levels; each level (in a bottom-up
sequence) gives the operator a growing visibility over NMS5-LX functionality, enabling the use of
options, procedures etc.
Superuser
Privileged
Advanced
Normal
Entry
Is the administrator of the system. Only this user can create, delete or modify
users, passwords and their operating level.
These four levels are assigned with the visibility of only some of the NMS5U-LX
system functions
Review the Appendix section of the NMS5-LX users manual for complete listing of all functions
available for each level.
10
4.
NMS5-LX activity takes place by mean of a pool of daemons that, interacting with each other
perform 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 have
configured (see the last part of this document).
Start-up Functions
Shutdown Functions
Check Functions
If you select Shutdown Functions a new interface is displayed with following icons
If you select Start-up Functions a new interface is displayed with following icons
If you select Check Functions a new interface is displayed with following icons
11
5.
CUSTOMIZING NMS5-LX
The customisation of the NMS5-LX system consists in the re-definition of some of the parameters
used by SIAE applications.
The following tables lists some of the system parameters that might be of any interest for the
system 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 with
support of SIAE personnel.
In file /opt/nms5ux/conf/app-defaults/Nms5ux you will find following parameters
Reference string
Meaning
Default value
Value range
DateFormat
1 - ddmmyyyy
0 - Extended 1
- ddmmyyyy 2
- mmddyyyy 3
- yyyymmdd
MaxRecPrim
100
MaxRecGio
100
It represents the max
number of PM daily record
to be exported
nms5trapd*autoDeleteTimeOffsetHistory
90
>0
nms5trapd*maxRecordInHistory
50000
>0
nms5trapd*maxRecordInTrLog
1000
>0
1000
>0
5000
>0
10
>0
*warningEvents:
*maxEvents:
*MaxSmnpSameTime:
12
>0
>0
Reference string
*NumEqReadTable:
*TimeReadTable:
Meaning
Default value
Value range
10
>0
>0
Reference string
Meaning
Default value
Value range
expirationTimeOffset
>0
ackLct
0 No
1- Yes
ackAlr
0
Set to 1 it sets NMS5-LX
to visualize with a star
above the Equipment
symbol the Alarms
presence not Ack condition
0 No
1- Yes
ackUndef
0 No
1- Yes
13
14
Reference string
Meaning
Default value
Value range
alrBellManagement
0 No Utter
1 Utter
alrBellSeverity
It configures NMS5LX
graphical application to
utter if the received alarm
has a specific severity
0
4
3
2
1
Always
= Critical
>= Major
>= Minor
>= Warning
6.
If you need to modify your workstation IpAddress please follow this procedure:
edit files
/opt/nms5ux/conf/SiaeRoutingTable.auto
/opt/nms5ux/conf/SiaeIfConfig.auto
15
7.
NMS5-LX gives the operator the possibility to save his data for security; the system stores all
information regarding network topology and equipment configuration (Oracle NMS5-LX database). In
addition, it is also possible to backup and restore the Alarm History or Performance Monitoring tables
only. It is recommended to perform a weekly backup, but take care of situations where a large
amount of changes occur in the network.
The "Database Backup"
below:
7.1
In order to backup the system database tables contents onto the hard disk, the user has to select
the 'Backup to disk' toggle button and press the OK button which initiates the backup procedure. The
backed 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 as
requested; for the NMS5-LX database files (tmn5ux database and OV files) you should follow these
steps:
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
16
8.
The following procedure gives the NMS5-LX administrator the ability to recover an abnormal
situation when a complete reset of the whole network is necessary.
N.B.: Following commands completely delete all NEs present in network.
Execute commands:
cd /opt/nms5ux/start
./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:
cd /opt/nms5ux/start
./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 first
login and password) and create a new Nms5-LX User (Menu Option->System
Users) 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 NMS5LX by entering the following command:
cd /opt/nms5ux/start
./nmsWinMenu
login in NMS5-LX graphical application (see chapter 4 for details in using nmsWinMenu
application)
17
9.
TROUBLESHOOTING
During NMS5-LX system use each operator should pay close attention to the tasks he is performing
so 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 currently
causing 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 to
understand 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 to
minimize response time.
First of all, try to discriminate between the nature of the problem; if you suspect the trouble is a
bug,
The clearer the problem description, the quicker SIAE will be able to provide a patch to resolve the
problem.
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
If this is unhelpful please store HPUX and the NMS5-LX log files in a tape and send them to SIAE for
examination, using procedure
su - root
cd /opt/nms5ux/tools
./save_nms5ux_log
then send SIAE the files NMS5.LOG.Z and TMN5.LOG.Z
18
10.
The recommended procedure to backup the NMS5-LX installation is the same that SIAE uses to
provide 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 distributed
according to the GPL (GNU Public License).
To create a new DVD to save PC installation execute following steps:
Using YaST - Hardware - CD-ROM drives find the /dev/hdx associated to that device
19
11.
ANNEX-A
11.1
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 remember
that dba is the Operating System Group Name that has the capabilities for the installation
and maintenance operations.
/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
20
-> 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 in
a temporary directory of you Linux PC the zip file provided in the CD labeled Oracle 10g
R1 (10.1.0.4) Patch Set and then execute:
o
unzip p4163362_10104_LINUX.zip
21
22