LightSoft NMS V1 Useful Information
Rony Horvitz

December 2003

Agenda          3 Basic Architecture Glossary (Architecture & Application) Deployment Processes Files System (Directories Structure) Launching LightSoft Configure LightSoft Utilities (LightSoft & EMS) CORBA Administration .

Basic Architecture .Concepts        Client (Java) / Server (C++) architecture Distributed Server Multi-Technology Support Open Interface Scalable Use of CORBA framework as IPC GCT to EMSs 4 .

5 . Being an internal layer of LightSoft . Additionally. standard solution for distributed objects system. COMD provides powerful features for the internal NMS communications as fault tolerance and load balancing. COMD is not visible by the customer or the operator.Basic Architecture . CORBA objects can communicate directly across a network using standard protocols.Glossary   CORBA (Common Object Request Broker Architecture) is an open. COMD aims to simplify the development of LightSoft applications¶ code by hiding details of CORBA and providing code generation wizards. regardless of the programming languages used to create objects or the operating systems and platforms on which the objects run Communication Middleware (COMD) is a CORBA based communication framework developed for LightSoft NMS.

 NMS Cluster is a collection of NMS Servers. working together as a single integrated system  Main Station is one of the WSs in the cluster.Glossary  NMS Server is an executable process in the server side of LightSoft. It can be also an NMS-Server 6 . It runs the DB.Basic Architecture . Usually we call NMS-Server to a WS running several process. In the case of single WS it is the Main Station   Plain Station is the name for all other WSs in a cluster NMS Client is a WS running where the LightSoft client can run (have been installed). each in a different WS. the CORBA services and controls the Cost Options.

It is the collection of all XC in one NE that belongs to the same trail.Application .Managed Element (NE) FE ± Functional Element WSId ± Work Station Id. Identifier of a WS in an LightSoft cluster. (In eNM-S and EMS-X 1:1 relation with ME) 7 .Glossary        SNC . Used also for identification of a process instance in Cluster Configuration  Subnet ± Unit object in the interface where an SNC can be created. NmsId ± Application identifier of an object in LightSoft NMS DbId ± Database identifier of an object TCI ± Trail Consistency Indicator ME . In EMS-XDM it is equal to XC-Set.

RadioTel.) 8 . XDM-4000. RAD.5 EMS-BG Other EMS Managed Equipment Syncom (SDM-1/4/16) XDM 400 / 500 / 1000 / 2000 LumiNet µSDM-1 BroadGate NT.4+v. etc.Deployment eNM LightSoft Network Management Layer eNM LightSoft Others (OSS) MTNM v.2/3 Element Management Layer EMS-Syncom Don¶t care EMS-XDM v.3+v.Basic Architecture . CU Others (ASM card.

AdminTools. General NMSGF functions NMSSBAM South bound access module (like part of AM) for requests and replies only NMSSCO NMSAlarms NMSTM NMSINS Cost options Current Alarm Management + Alarm Notification Service for forwarding alarms to all other processes Topology and Trail Management Internal Notification Service for forwarding internal notifications to all other processes NMSEventLog 9 Event log management + History . Security.Main Processes NMSEvMS notification only Event management server (like part of AM) for Upload.

Main Processes 10 .

lib ± for FixDisks libraries sh .shell scripts sql ± for SQL scripts and files sh ± home directory for user is ~nms (usually /sdh_home/nms) Bulletin ± for bulletin board NMSExplog ± alarm log export files in XML NMSTrails ± for XML trails files NotePad ± for user notepad files coresave ± for core files logs -> /var/NMS/logs ± for log files logs/run ± for run files  11 .Directory Structure   Server Side /opt/NMS/server bin ± executables db ± XML and db schema etc ± ini files  Lic ± license key file  skel ± skeleton ini files lib ± dynamic libraries patch.

Directory Structure   Client Side /opt/NMS/Client/ bin ± for executables (Empty) class ± for java classes etc ± INI File  skel . so the home directory depends on the user logged-in into the Unix  12 .for skeleton ini files  audio ± for audio files (audio alarms)  images ± for icons and images  maps ± for maps  preferences ± for user preferences (one dir per user)  properties ± for GUI resources jar ± for third party software lib ± for our libraries (jars) sh ± shell scripts The client can be run as any Unix user.

sh Used for launching LS client Supports ±d parameter for remote/local debugging 13 . EMS-X and LS together Start / Stop Server and Client  Start_NMSClient.LightSoft Launch (S & C)  NMS script Used for launching the NMS server manually Supports single and cluster configuration Start / Stop single/all processes  Root Menu New TMN environment can support eNM-S.

Configuration .INI  INI Files INI files are used in LS Server and Client for configuration of running options. In Server side one file per process + one General file In Client side only one file Note: In current version only ECI personnel should change the files  etc/skel INI files in use are located in etc directory When installing new version. INI files are put under skel It is the installer responsibility to check the correct files are used Checkinifiles can be used 14 .

sh 1 .pl db2tty SaveOutTmp.Utilities ± General         15 AdminTools NSList ShowIORHosts ShowNmsDbID ShowRealDbID threadLog.

package.Utilities ± General  AdminTools Tool for manage NMS processes (Server & Client) in run-time Menu-driven or Command-Line Command or GUI  Map WSId to host name  Close all NMS processes  Check which processes are running  Assign new WS to client  Get current active threads from a thread pool in a process  Get Current active preferences and command line parameters  Change preferences     2 Reinitialize an NMS process Change debug level: file. all Run generic method Free a WSId 16 .

IP addresses and host names of the EMSs and Clients registered in the Naming Service of LightSoft NMS  ShowNmsDbID Converts from DB Id to NMS application ID Format xx.xx  ShowRealDbID Converts from NMS application ID to database Id Format xx:xx:xx:xx 17 .Utilities ± General  3 ShowIORHosts Prints the names.xx.

pl Filters the given log file by a thread # 4  SaveOutTmp.Prints data from LightSoft NMS DB db2tty ±d nms_db ±a ± Prints all DB classes db2tty ±d nms_db ±i <DBclassName> ± Prints only instances of the given class db2tty ±d nms_db ±o DB Id ± Prints specific object 18 .Utilities ± General  threadLog.sh Save output files to /tmp when they are full  db2tty .

pl 1 .pl printPhysicalTpgLinks.Utilities .pl printSubnets.Applications         19 UMClient NMSState SecUtils FixMEOnMap CostOpViewer printActualSNCs.

Utilities .Applications  UMClient Allows to invoke for upload from command line Fast and Full upload can be invoked Different objects / upload steps can be selected Similar to ForceUpload in eNM 2  NMSState Gives upload information from LightSoft database Information includes EMS. ME and Subnet All upload states are shown Full LightSoft summary at the end Similar to NEState in eNM 20 .

Utilities .Applications  SecUtils 3 Allows some security configuration and management Force user logout Get logged users Create new user  FixMEOnMap Set coordinates of MEs and FEs Positioning using 2 parameters  Map coordinates  Relative position in the EMSs 21 .

Utilities .NmsLicenseV1 To create a license key use: /auto/tornado_home1/NMS1/LicGen/costop.sh 22 .Applications  CostOpViewer 4 Allows viewing of the installed cost-options Similar as in eNM. EMS-X Uses license key as input License key can be found at: /opt/NMS/server/etc/Lic/.

Utilities .pl printTrails.pl printTciObjects.pl Prints the specific objects¶ list from LightSoft DB 23 .Applications   printActualSNCs.pl print«.pl     printSubnets.pl 5 Prints actual SNCs in LightSoft NMS Prints topology links in LightSoft NMS Prints subnets in LightSoft NMS together with their sync status Prints al inconsistent objects between LightSoft NMS and the EMSs Prints all the Trails in LightSoft DB printPhysicalTpgLinks.

Applications  TCIUtility 6 Handles the Red-Flag counters (options 5 and 6) Use it if you think there is a problem with the displayed counters Use it for Importing / Exporting Trails to / from LightSoft   TrailExpImpUtility ManageTpgObject Manages Topology Objects (EMS. UME. Links and Ports) Actually can be used to remove objects from DB ± specially EMS 24 . Groups. ME. FE.Utilities .

Utilities ± EMS for LightSoft  RegisterEMS Utility used to register the EMS in LightSoft¶s Naming Service  UpdateNmsID In EMS-SYNCOM and EMS-XDM change the WSId in the SNC names  GetNEXY Get the NE map coordinates from the EMS into file Concatenate files from all EMSs to be in LightSoft 25 .

normally.CORBA Administration  itadmin It is an administration utility for Orbix services. itadmin help or itadmin ±help will produce a short info about configuration commands for all services. to see the contents of Naming Service:  itadmin ns list To get help about a service. itadmin ns ±help. The format of an itadmin command is. as follows:  itadmin service parameters For example. See the Orbix Administrator¶s Guide 26 . will print a short help about the Naming Service configuration commands. use option ±help. Orbix is a CORBA implementation developed by IONA Technologies. itadmin can be used to view or change configuration settings of Orbix.

CORBA Administration  NSList List the objects registered in the CORBA Naming Service Can list Managers or Services Build on top of itadmin 27 .

com 28 .Horvitz@ecitele.Rony Horvitz Rony.