EMS-BGF

Version 13

Solaris
Installation Guide
4BGHT6-EMSW-248

EMS-BGF Installation Guide V13 Catalog No: X35371 February 2011 1st Edition

Copyright by ECI Telecom, 2002-2011. All rights reserved worldwide. This is a legal agreement between you, the end user, and ECI Telecom Ltd. (ECI Telecom). BY OPENING THE DOCUMENTATION AND/OR DISK PACKAGE, YOU ARE AGREEING TO BE BOUND BY THE TERMS OF THIS AGREEMENT. IF YOU DO NOT AGREE TO THE TERMS OF THIS AGREEMENT, PROMPTLY RETURN THE UNOPENED DOCUMENTATION AND/OR DISK PACKAGE AND THE ACCOMPANYING ITEMS (INCLUDING WRITTEN MATERIALS AND BINDERS OR OTHER CONTAINERS), TO THE PLACE FROM WHICH YOU OBTAINED THEM. The information contained in the documentation and/or disk is proprietary and is subject to all relevant copyright, patent, and other laws protecting intellectual property, as well as any specific agreement protecting ECI Telecom's rights in the aforesaid information. Neither this document nor the information contained in the documentation and/or disk may be published, reproduced, or disclosed to third parties, in whole or in part, without the express prior written permission of ECI Telecom. In addition, any use of this document, the documentation and/or the disk, or the information contained therein for any purposes other than those for which it was disclosed, is strictly forbidden. ECI Telecom reserves the right, without prior notice or liability, to make changes in equipment design or specifications. Information supplied by ECI Telecom is believed to be accurate and reliable. However, no responsibility whatsoever is assumed by ECI Telecom for the use thereof, nor for the rights of third parties, which may be affected in any way by the use and/or dissemination thereof. Any representation(s) in the documentation and/or disk concerning performance of ECI Telecom product(s) are for informational purposes only and are not warranties of product performance or otherwise, either express or implied. ECI Telecom's standard limited warranty, stated in its sales contract or order confirmation form, is the only warranty offered by ECI Telecom. The documentation and/or disk is provided AS IS and may contain flaws, omissions, or typesetting errors. No warranty is granted nor liability assumed in relation thereto, unless specifically undertaken in ECI Telecom's sales contract or order confirmation. Information contained in the documentation and in the disk is periodically updated, and changes will be incorporated in subsequent editions. If you have encountered an error, please notify ECI Telecom. All specifications are subject to change without prior notice. The documentation and/or disk and all information contained therein is owned by ECI Telecom and is protected by all relevant copyright, patent, and other applicable laws and international treaty provisions. Therefore, you must treat the information contained in the documentation and disk as any other copyrighted material (for example, a book or musical recording). Other Restrictions. You may not rent, lease, sell, or otherwise dispose of the documentation and disk, as applicable. YOU MAY NOT USE, COPY, MODIFY, OR TRANSFER THE DOCUMENTATION AND/OR DISK OR ANY COPY IN WHOLE OR PART, EXCEPT AS EXPRESSLY PROVIDED IN THIS LICENSE. ALL RIGHTS NOT EXPRESSLY GRANTED ARE RESERVED BY ECI Telecom. All trademarks mentioned herein are the property of their respective holders. ECI Telecom shall not be liable to you or to any other party for any loss or damage whatsoever or howsoever caused, arising directly or indirectly in connection with this documentation and/or disk, the information contained therein, its use, or otherwise. Notwithstanding the generality of the aforementioned, you expressly waive any claim and/or demand regarding liability for indirect, special, incidental, or consequential loss or damage which may arise in respect of the documentation and/or disk and/or the information contained therein, howsoever caused, even if advised of the possibility of such damages. The end user hereby undertakes and acknowledges that they read the "Before You Start/Safety Guidelines" instructions and that such instructions were understood by them. It is hereby clarified that ECI Telecom shall not be liable to you or to any other party for any loss or damage whatsoever or howsoever caused, arising directly or indirectly in connection with you fulfilling and/or failed to fulfill in whole or in part the "Before You Start/Safety Guidelines" instructions.

Contents
About This Guide..................................................................... 1-1
Overview .......................................................................................................... 1-1 Intended Audience ........................................................................................... 1-1 What You Need to Know .................................................................................. 1-2 Document Conventions .................................................................................... 1-2 Related Documentation .................................................................................... 1-3 Obtaining Technical Documentation ................................................................ 1-3

Installing EMS-BGF on Solaris ............................................... 2-1

Overview .......................................................................................................... 2-1 Installation Procedures ..................................................................................... 2-2

GUI Cut-Through (GCT) .......................................................... 3-1

Overview .......................................................................................................... 3-1 Checking the Configuration .............................................................................. 3-3

4BGHT6-EMSW-248

ECI Telecom Ltd. Proprietary

Contents

EMS-BGF Installation Guide

ii

ECI Telecom Ltd. Proprietary

4BGHT6-EMSW-248

1
About This Guide
In this chapter:
Overview ......................................................................................................... 1-1 Intended Audience ........................................................................................... 1-1 What You Need to Know ................................................................................ 1-2 Document Conventions ................................................................................... 1-2 Related Documentation ................................................................................... 1-3 Obtaining Technical Documentation ............................................................... 1-3

Overview
This guide describes the procedures for installing the EMS-BGF software on a Solaris operating system.

Intended Audience
This guide is intended for network operations personnel and system administrators who are responsible for network element management.

4BGHT6-EMSW-248

ECI Telecom Ltd. Proprietary

1-1

About This Guide

EMS-BGF Installation Guide

What You Need to Know

This document assumes that the reader is familiar with the following:

BG-40 products BG-20 products BG-30 products BG-64 products Basic internetworking terminology and concepts Network topology and protocols Telecommunication Management Network (TMN) architecture model

Document Conventions
When applicable, this manual uses the following conventions.
Convention Indicates Example

Bold

Names of menus, commands, windows, dialog boxes, and most GUI elements Selection from a menu, or leading to another command Notes, cautions, and warnings

In the Alarms menu...

Menu > Option Borders around text

Select Update > View Objects See examples below

NOTE: Text set off in this manner presents clarifying information, specific instructions, commentary, sidelights, or interesting points of information.

CAUTION: Text set off in this manner indicates that failure

to follow directions could result in damage to equipment or loss of information.

WARNING: Text set off in this manner indicates that failure to follow directions could result in bodily harm or loss of life.

1-2

ECI Telecom Ltd. Proprietary

4BGHT6-EMSW-248

EMS-BGF Installation Guide

About This Guide

Related Documentation
The following publications may be of assistance to you regarding EMS-BGF operations:

General description documents of appropriate BroadGate products BroadGate Product Line System Specifications LightSoft Network Management System User Manual BroadGate EMS-BGF User Manual BroadGate LCT-BGF User Manual

Obtaining Technical Documentation

To obtain technical documentation related to any ECI Telecom Ltd. product, please contact: ECI Telecom Ltd. Network Solutions Division Documentation Department 30 Hasivim St. Petach Tikva 49130 - Israel Fax: +972-3-9268060 mailto:techdoc.feedback@ecitele.com
+972-3- 92660001-888- ECI-TECH (324- 8324) +972-3- 92663701-954-351- 4406 mailto:on.support@ecitele.com

ECI's XDM and BroadGate product lines are certified to comply with MEF9 and MEF14 standards.

4BGHT6-EMSW-248

ECI Telecom Ltd. Proprietary

1-3

About This Guide

EMS-BGF Installation Guide

1-4

ECI Telecom Ltd. Proprietary

4BGHT6-EMSW-248

2
Installing EMS-BGF on Solaris
In this chapter:
Overview ......................................................................................................... 2-1 Installation Procedures .................................................................................... 2-2

Overview
This guide describes the procedures for installing the EMS-BGF software on a Solaris operating system.

4BGHT6-EMSW-248

ECI Telecom Ltd. Proprietary

2-1

Installing EMS-BGF on Solaris

EMS-BGF Installation Guide

Installation Procedures
You can begin the installation after confirming that the items described in Hardware and Software Requirements are available. The installation must be performed according to the procedures described in this section.

Installing the Solaris Operating System

Before installing EMS-BGF software, the Solaris operating system (for sparc or x86) must be installed on the NM computer. NOTE: For more information about installing the Solaris
operating system, refer to relevant Solaris installation manuals.

Accessing the EMS-BGF Solaris Application Packages

Follow the procedure below to access the EMS-BGF Solaris application packages, which is used to install various EMS-BGF network management system components. Before you start: There are 3 types of the EMS-BGF application for now:

EMS-BGF for MSPP (V10.0/V11.0/V11.3/V12.0/V12.1) EMS-BGF for CESR (V11.4/V12.5) EMS-BGF for MSPP and CESR (V13)

If you previously installed any one of them, before installing the new EMSBGF, you have to run stopServer.sh to completely stop the current running EMS-BGF application and then install the required new application. After installation, restart zone and the EMS-BGF will start automatically.

2-2

ECI Telecom Ltd. Proprietary

4BGHT6-EMSW-248

EMS-BGF Installation Guide

Installing EMS-BGF on Solaris

To access the EMS-BGF application packages: 1. Log in to the non-global zone for EMS-BGF application as user: root. 2. Run "install.bgf" script. The window shows as below.

3. From Main Installation Menu window, select option 1. The Packages Installation Menu window is displayed as below.

4BGHT6-EMSW-248

ECI Telecom Ltd. Proprietary

2-3

Installing EMS-BGF on Solaris

EMS-BGF Installation Guide

Installing EMS-BGF Server

Installing EMS-BGF server application includes:

Installing MySQL database system Installing EMS-BGF server application Initializing MySQL database system and creating EMS-BGF database

Installing MySQL Database System

To install EMS-BGF server application, MySQL database system must first be installed in the system. This section describes how to install MySQL database system. To install MySQL database system:

In the Packages Installation Menu window, select option 3: ECILmysql to install MySQL database system, as shown in the following figure.

NOTE: If MySQL database system is already installed on the station, it first must be uninstalled.

2-4

ECI Telecom Ltd. Proprietary

4BGHT6-EMSW-248

EMS-BGF Installation Guide

Installing EMS-BGF on Solaris

Installing EMS-BGF Server application

After installing MySQL database system, you can install EMS-BGF server application. To install EMS-BGF server application:

In the Packages Installation Menu window, select option 2: ECILemsbgfS to install EMS-BGF server application, as shown in the following figure.

4BGHT6-EMSW-248

ECI Telecom Ltd. Proprietary

2-5

Installing EMS-BGF on Solaris

EMS-BGF Installation Guide

Initializing MySQL Database System and Creating EMS-BGF Database

This section describes how to initialize MySQL database system and creating EMS-BGF database. NOTE: Initializing MySQL database system and creating EMS-BGF database is of high severity. If the database already exists in your system, you can decide whether to recreate it according to the situation. To initialize MySQL database system and creating EMS-BGF database: 1. To view the installation files, run "ls" under the path: /opt/EMSBGF/server/sh, as shown in the following figure.

2. Run "SetupDB.sh" to initialize MySQL database system. If failed, run the following two scripts: #>pkill mysql #>rm r /sdh_home/mysql/data

2-6

ECI Telecom Ltd. Proprietary

4BGHT6-EMSW-248

EMS-BGF Installation Guide

Installing EMS-BGF on Solaris

Then run "SetupDB.sh", as shown in the following figure.

3. Run "CreateDB.sh" to create EMS-BGF database, as shown below.

4BGHT6-EMSW-248

ECI Telecom Ltd. Proprietary

2-7

Installing EMS-BGF on Solaris

EMS-BGF Installation Guide

Starting EMS-BGF Server

Since you have installed EMS-BGF server successfully, you can run EMSBGF server on solaris as described in this section. To run EMS-BGF server:

To start EMS-BGF server service, right-click on the desktop and select EMS-BGF Server > EMS-BGF Server > Start EMS-BGF Server from the menu.

2-8

ECI Telecom Ltd. Proprietary

4BGHT6-EMSW-248

EMS-BGF Installation Guide

Installing EMS-BGF on Solaris

Installing EMS-BGF Client

This section describes how to install EMS-BGF client application. To install EMS-BGF client application:

In the Packages Installation Menu window, select option 1: ECILemsbgfC to install EMS-BGF client application, as shown in the following figure.

4BGHT6-EMSW-248

ECI Telecom Ltd. Proprietary

2-9

Installing EMS-BGF on Solaris

EMS-BGF Installation Guide

Starting EMS-BGF Client

Since you have installed EMS-BGF client successfully, you can run EMS-BGF client on solaris as described in this section. To run EMS-BGF client:

To start EMS-BGF client, right-click on the desktop and select EMS-BGF Client > EMS-BGF Client > Start EMS-BGF Client from the menu.

2-10

ECI Telecom Ltd. Proprietary

4BGHT6-EMSW-248

EMS-BGF Installation Guide

Installing EMS-BGF on Solaris

Installing Orbix
This section describes how to install Orbix. To install Corbix:

In the Packages Installation Menu window, select option 5: ECILorbix to install Orbix ASP v6.3.3 Runtime 2.10, as shown in the following figure.

4BGHT6-EMSW-248

ECI Telecom Ltd. Proprietary

2-11

Installing EMS-BGF on Solaris

EMS-BGF Installation Guide

Configuring EMS-BGF Server for Integrated

This section describes how to configure EMS-BGF server for integrated. To configure EMS-BGF server for integrated: 1. To access the configuration, right-click on the desktop and select EMSBGF Server > EMS-BGF Server > Configure EMS-BGF Server from the menu, as shown below.

2. Enter the root password, the EMS-BGF server configuration window opens as below.

2-12

ECI Telecom Ltd. Proprietary

4BGHT6-EMSW-248

EMS-BGF Installation Guide

Installing EMS-BGF on Solaris

3. From the above window, enter "I" to select the integration mode.

4. After selecting the integration mode, run "vi /etc/hosts" as user "root" to add the IP and hosts name of the NMS server into the hosts file, as shown below.

4BGHT6-EMSW-248

ECI Telecom Ltd. Proprietary

2-13

Installing EMS-BGF on Solaris

EMS-BGF Installation Guide

The following figure shows an example of the host table.

5. Go to NMS server zone, add a line of EMS-BGF server IP and hostname to the file: /etc/hosts in this zone. If you install EMS-BGF on a station with more than one network card, you must configure the EMS-BGF to tell the NBI which IP you want to use: 1. Go to the EMS-BGF installation folder and find the file: /etc/emsserver.properties. 2. In the file, find the string:'RegisterIORHost = 127.0.0.1'. 3. Overwrite the the default IP: 127.0.0.1 with the desired IP.

2-14

ECI Telecom Ltd. Proprietary

4BGHT6-EMSW-248

EMS-BGF Installation Guide

Installing EMS-BGF on Solaris

Installing RDR Software

The EMS-BGF Remote Data Replicator (RDR) feature provides the database backup for the EMS-BGF. To install EMS-BGF RDR:

In the Packages Installation Menu window, select option 3: ECILemsbgfSRDR to install EMS-BGF server application, as shown in the following figure.

4BGHT6-EMSW-248

ECI Telecom Ltd. Proprietary

2-15

Installing EMS-BGF on Solaris

EMS-BGF Installation Guide

Starting/Stopping RDR Server

This section describes how to start or stop RDR server on Solaris. To run/stop RDR server:

As shown below, to start the RDR server, run "runRDRServer.sh", and to stop the RDR server, run "stopRDRServer.sh".

2-16

ECI Telecom Ltd. Proprietary

4BGHT6-EMSW-248

3
GUI Cut-Through (GCT)
In this chapter:
Overview ......................................................................................................... 3-1 Checking the Configuration............................................................................. 3-3

Overview
LightSoft manages a network through an EMS (Element Management System) which provides LightSoft with the information it needs to maintain the network. There are times when you may need to use LightSoft to view windows from the EMS. Normally, this would require you to log into the EMS on the local terminal and find the information manually. To make things easier and more efficient, LightSofts GCT allows you to view EMS information without having to start an individual EMS session.

4BGHT6-EMSW-248

ECI Telecom Ltd. Proprietary

3-1

GUI Cut-Through (GCT)

EMS-BGF Installation Guide

There are two cases for the configuration according to your installation on Solaris:

Case 1: Install the EMS-BGF's server and client on the same machine (on Solaris). In this case, when you install EMS-BGFs client on the station, the GCTAdmin Service will automatically run. Case 2: Install the EMS-BGF's server on one machine, and the client on Client-Server machine, as shown in the following figure. In this case, when you install EMS-BGFs client on Client-Server machine, then GCTAdmin Service will automatically run.

From this figure, we see that the EMS Server is installed on Windows and the Client-Server is on Linux. It solves the problem that Windows does not support X-Window protocol, and provides the GCT support for integration with LightSoft.

3-2

ECI Telecom Ltd. Proprietary

4BGHT6-EMSW-248

EMS-BGF Installation Guide

GUI Cut-Through (GCT)

Checking the Configuration

When you open GCT from NMS client to EMS-BGF, there pops-up a message window in NMS, indicating that "Can't open main shelf/window for EMS", use the procedures described below to check the configuration. To check the configuration for Case 1 (server and client both on A machine): 1. Ensure that the EMS-BGF is installed on non-windows systems. 2. To Check whether the GCTAdmin services are normal, type the command "ps -ef|grep java" in terminal. If the GCTAdmin service is normal, the progress will show as below.

Otherwise, please manually run "/opt/EMSBGF/client/sh/runGCTAdmin.sh" and then try it again.

4BGHT6-EMSW-248

ECI Telecom Ltd. Proprietary

3-3

GUI Cut-Through (GCT)

EMS-BGF Installation Guide

To check the configuration for Case 2 (server on A machine and client on B machine): 1. Ensure that the EMS-BGF's client is installed on non-windows systems. 2. Check whether "GCTAdminServerIP" is the same with "B machine IP" in the file "/opt/EMS-BGF/server/etc/emsserver.properties" on A machine. If not, change it and restart the EMS-BGF's server. 3. Type the command "ps -ef|grep java" in terminal to check whether the GCTAdmin service is normal on B machine. If the GCTAdmin service is normal, the progress will show as below.

Otherwise, please manually run "/opt/EMSBGF/client/sh/runGCTAdmin.sh" with user bgf and then try it again.

3-4

ECI Telecom Ltd. Proprietary

4BGHT6-EMSW-248