IBM 5.5 - Manuals

vii Figures 1. Overview of network discovery . . . . . . . . . . . 3 2. Network circuit . . . . . . . . . . . . . . . . . . . . . . . . . 5 3. System components . . . . . . . . . . . . . . . . . . . . . 7 4. Netcool Installer Welcome window . . . . . . . 14 5. Netcool Installer Home window. . . . . ...

ix preface.fm November 27, 2006 Preface This guide describes how to install and configure IBM Tivoli Netcool ® /Precision ™ for Transmission Networks (Netcool/Precision TN) on UNIX. The guide also covers how to use Netcool/Precision TN to discover a telecommunications network, view network inventory...

Netcool/Precision for Transmission Networks 5.5 Administration Guide xii Note: Note is used for extra information about the feature or operation that is being described. Essentially, this is for extra data that is important but not vital to the user. Tip: Tip is used for additional information that ...

Preface xiii Associated publications This section provides a description of the documentation associated with Netcool/Precision for Transmission Networks. To efficiently administer Netcool/Precision for Transmission Networks, you must also understand the IBM Tivoli OMNIbus technology. IBM Tivoli Net...

Netcool/Precision for Transmission Networks 5.5 Administration Guide xiv How to send your comments Your feedback is important in helping to provide the most accurate and highest quality information. If you have any comments about this book or any other Netcool/Precision for Transmission Networks doc...

1 1Introduction.fm November 27, 2006 Chapter 1. Introduction This chapter provides an overview of Netcool ® /Precision for Transmission Networks (Netcool/Precision TN). This chapter contains the following sections: • "Introduction to Netcool/Precision TN" on page 1 • "How Netcool/Precisi...

Netcool/Precision for Transmission Networks 5.5 Administration Guide 2 In this sub-optimal environment, service providers have many manual processes. Even if an OSS retrieves real-time fault and performance data, inventory is likely to be disconnected from the network and accurate data about ports, ...

Chapter 1. Introduction 3 NETypes A NEType is an XML-based description of the management interface for a specific type of NE. An NE's management interface is usually defined according to a specific protocol. But Netcool/Precision TN is based on a protocol-independent Telecom Object Model (TOM) that ...

Netcool/Precision for Transmission Networks 5.5 Administration Guide 4 STEP 1 – discovering the existence of an NE Deep discovery starts by discovering the existence and, if possible, the type of equipment available in the network. Users specify a seed IP address/hostname, a subnet mask for the seed...

Chapter 1. Introduction 5 TL1-managed NEs, Netcool/Precision TN can use other commands (for example, the RTRV-TOPOLOGY command supported by the Fujitsu 2400) to find topological connections. Device-specific scripts can be written for inclusion with the NEType files to discover these types of NEs. Ne...

Netcool/Precision for Transmission Networks 5.5 Administration Guide 6 After discovery: alarm correlation Netcool/Precision TN can combine with Netcool/OMNIbus to provide contextual information to the NOC technician to quickly diagnose and resolve network problems. This integration with Netcool/OMNI...

Chapter 1. Introduction 7 Optionally, Netcool/Precision TN can be configured to work with Netcool/OMNIbus, enabling an operator to view a visualization of an NE, indicating precisely where a specific alarm occurred. See Figure 3 for a graphical representation of the system components. Netcool/Precis...

Netcool/Precision for Transmission Networks 5.5 Administration Guide 8 – View the topological connections, cross-connects, and circuits – Locate stranded bandwidth • Network Management: – Create NEs manually or via discovery – Delete NEs – Manage NE associations – Locate alerts in the NE, down to th...

Chapter 1. Introduction 9 GUI mode By default, the Netcool Installer runs in GUI mode. This mode uses a graphical user interface to present installation options, and includes descriptions and explanations. Console mode The Netcool Installer can also run in console mode. This mode uses a text-only us...

Netcool/Precision for Transmission Networks 5.5 Administration Guide 10 4. Manually change the environment variable $OMNIHOME . 5. Restart your Netcool products. ! ! Attention: You must not move, copy, or delete executable or other required IBM Tivoli files except as directed in the product document...

11 2installation.fm November 27, 2006 Chapter 2. Installing Netcool/Precision TN This chapter describes how to install Netcool/Precision TN on your system. Throughout this guide, the directory where you install this product is referred to as <netcool_install_dir> . If you did not install in th...

Chapter 2. Installing Netcool/Precision TN 13 Installing Netcool/Precision TN This section describes the Netcool/Precision TN installation process. ! ! Attention: If you want to run Netcool/Precision TN with Netcool/OMNIbus then you must install Netcool/OMNIbus first and ensure the $OMNIHOME variabl...

Netcool/Precision for Transmission Networks 5.5 Administration Guide 14 Running the installation in GUI mode To install Netcool/Precision TN on your system: 1. From a command prompt, change to the directory where you extracted the contents of the Netcool/Precision TN tar file. 2. Run the installatio...

Chapter 2. Installing Netcool/Precision TN 15 3. You will be presented with the License Agreement window. Read the license agreement and select Yes to accept it, or No if you do not accept the license agreement. Note: If you select No , the Netcool Installer will exit when you click Next . 4. If the...

Netcool/Precision for Transmission Networks 5.5 Administration Guide 16 5. Select the type of installation you want to perform and then click Next (Figure 6.) If you selected Default , go to Step 7. If you selected Custom , go to Step 6. Figure 6. Netcool Installer Setup Type window

Chapter 2. Installing Netcool/Precision TN 17 6. Select the features you want to install and then click Next (Figure 7.) Note: You can click on each feature to toggle its selection on or off. A tick indicates a selected feature and a cross indicates a deselected feature. Select the devices for which...

Netcool/Precision for Transmission Networks 5.5 Administration Guide 18 10. click Install to start the installation. Two progress bars appear, displaying the overall progress of the Netcool/Precision TN installation, as well as the installation progress of each package (Figure 8.) On completion, cli...

Chapter 2. Installing Netcool/Precision TN 19 Running the installation in console mode The console mode uses a text-based user interface to present installation options using a series of menus and prompts. To run the Netcool Installer in console mode: 1. From a command prompt, navigate to the direct...

Netcool/Precision for Transmission Networks 5.5 Administration Guide 20 9. Do either of the following: – To confirm that you want to proceed with the installation, type i and press Enter. – To view the list of packages selected prior to installation, type m and press Enter. After reviewing the packa...

Chapter 2. Installing Netcool/Precision TN 21 3. Wait for the installation to complete. A confirmation message appears at the end. On completion, the installation adds files to your system, as described in "Netcool/Precision TN directory structure" on page 28. You can view the installation l...

Netcool/Precision for Transmission Networks 5.5 Administration Guide 22 To view the installation log in console mode, enter the following command: $NCHOME/install/ncisetup -report log The log file listing appears. Viewing installed packages Netcool products are made up of packages. You can view the ...

Chapter 2. Installing Netcool/Precision TN 23 Creating the Oracle schema To create the Oracle database schema, you must first run the leap_schema.sql script located in the <netcool_install_dir> /etc/precisiontn/sql/oracle directory. This file must be loaded into the database using any client, ...

Chapter 2. Installing Netcool/Precision TN 25 Setting up a MySQL database The MySQL server and JDBC client software is not included in this version of the Netcool/Precision TN software. Download the latest MySQL server software and JDBC driver from: http://www.mysql.com Once downloaded, the JDBC dri...

Netcool/Precision for Transmission Networks 5.5 Administration Guide 26 Configuring Netcool/Precision TN To configure Netcool/Precision TN to work with an existing copy of MySQL: 1. Change directory to <netcool_install_dir> configuration directory, for example: /opt/netcool/etc/precisiontn 2. ...

Chapter 2. Installing Netcool/Precision TN 27 Creating the MySQL schema To create the MySQL database schema, you must first run the ncim.sql and leap_schema.sql scripts located in the <netcool_install_dir> /etc/precisiontn/sql/mysql directory. To create the schema: 1. Ensure that you have foll...

Chapter 2. Installing Netcool/Precision TN 29 Third-party and Open Source software Your software installation is self-contained and includes the following third-party software: • Certicom ECC (security implementation) • ILOG JTGO 3.5 (Java graphic components for OSSs) • Java Transaction API 1.0.1 • ...

Netcool/Precision for Transmission Networks 5.5 Administration Guide 30 • Xerces-J 1.4.4 • XML APIs 1.0 • XP XML Parser for Java v0.5

31 05run.fm November 27, 2006 Chapter 3. Running Netcool/Precision TN This chapter describes the process of starting and stopping Netcool/Precision TN. This chapter contains the following sections: • "Downloading NETypes" on page 31 • "Starting the product components" on page 31 • &#...

Netcool/Precision for Transmission Networks 5.5 Administration Guide 32 Step 1 – starting the database This section describes the process of starting the database used by Netcool/Precision TN. ! ! Attention: The server must be running before you start the other Netcool/Precision TN components. Consu...

Chapter 3. Running Netcool/Precision TN 33 Note: When you first start Network Pilot, there is no password for the admin user. 4. If the Netcool/OMNIbus ObjectServer is running, you must enter the user name root , and the password assigned to the root user in Netcool/OMNIbus. 5. In the Server drop-do...

35 06visualize.fm November 27, 2006 Chapter 4. Integrating with Netcool/OMNIbus This chapter describes the process of configuring the Netcool/Precision TN server and Netcool/OMNIbus ObjectServer in order to display NE data for a selected alert in the Netcool/OMNIbus event list. This chapter contains...

Netcool/Precision for Transmission Networks 5.5 Administration Guide 36 Configuring the Netcool/OMNIbus ObjectServer version 3.6 This section describes the configuration tasks you must complete for Netcool/OMNIbus ObjectServer version 3.6. See "Configuring the Netcool/OMNIbus ObjectServer versio...

Chapter 4. Integrating with Netcool/OMNIbus 37 create table status ( ... -- MasterSerial int, -- DSD Master serial PtnEntityID varchar(255), PtnNative1 varchar(255), NmosDomainName varchar(255), primary key ( Identifier ), permanent ); create table objclass ( Tag int, Name varchar(64), ... 7. Save a...

Netcool/Precision for Transmission Networks 5.5 Administration Guide 38 Adding fields to the ObjectServer Add the PtnEntityID and PtnNative1 columns to the alerts.status table using the following steps. The column names are case-sensitive: 1. Check that the ObjectServer is running. 2. Execute the fo...

Chapter 4. Integrating with Netcool/OMNIbus 39 You can obtain a list of all the command line arguments available to Netcool/Precision TN by changing directory to <netcool_install_dir> /precisiontn/bin and entering: precisiontn -help Connecting to an ObjectServer Netcool/Precision TN connects t...

Netcool/Precision for Transmission Networks 5.5 Administration Guide 40 </properties> <properties name="Netcool User Authentication"> <property name="jdbcuser" value="root" /> <property name="jdbcpwd" value="null" /> </properties>...

Chapter 4. Integrating with Netcool/OMNIbus 41 SNMP Data Collection / Multi-Threaded Trapd probe If Netcool/Precision TN collects data from NEs via SNMP and Netcool/OMNIbus receives alerts for the same NEs from its Multi-Threaded Trapd probe, Netcool/Precision TN must be able to correlate the alerts...

Netcool/Precision for Transmission Networks 5.5 Administration Guide 42 Configuring Netcool/Webtop event lists in Netcool/Precision TN Netcool/Precision TN can display alerts for network elements via Netcool/Webtop. To configure this feature follow the steps below: 1. Modify the <webtop_install_d...

Chapter 4. Integrating with Netcool/OMNIbus 43 Adding the menu to the Netcool/Webtop desktop Before you can add the visualization menu option to Netcool/Webtop, you must have Netcool/Webtop 1.1 and the latest patches installed. For information about how to do this, see the Netcool/Webtop Administrat...

Netcool/Precision for Transmission Networks 5.5 Administration Guide 44 Starting the ObjectServer To start the ObjectServer, enter the command: $OMNIHOME/bin/nco_objserv Starting the database You must start your database as described in "Starting the database" on page 44 before starting the ...

Chapter 4. Integrating with Netcool/OMNIbus 45 2. Use the user name and the password assigned to root on your system. If no password has been assigned, leave the password field blank. Click Ok . The Netcool/OMNIbus Monitor Box window is displayed, as shown in Figure 12. Figure 12. Monitor box window

Netcool/Precision for Transmission Networks 5.5 Administration Guide 46 3. Click the View button beside the Default drop-down list to display the default event list, as shown in Figure 13. Note: No alerts from NEs are presented until you have used Network Pilot to discover, or manually connect to, t...

Chapter 4. Integrating with Netcool/OMNIbus 47 To visualize the data from the Netcool/OMNIbus alerts: 1. Ensure you have previously run Netcool/Precision TN and used Network Pilot to discover, or manually connect to, the NEs in the network. 2. Open the Netcool/OMNIbus event list, as described in ...

Netcool/Precision for Transmission Networks 5.5 Administration Guide 48 3. Right-click an alert in the event list and select Visualize from the context-sensitive menu, as shown in Figure 15. Figure 15. Visualize menu

51 07configure.fm November 27, 2006 Chapter 5. Setting configuration options This chapter describes how to configure your Netcool/Precision TN installation, and how to troubleshoot some common issues. This chapter contains the following sections: • "Configuring failover" on page 51 • "Us...

Netcool/Precision for Transmission Networks 5.5 Administration Guide 52 Figure 17 shows an overview of the network in this configuration: ! ! Attention: You must use an Oracle database to run Netcool/Precision TN in this failover configuration. Implementation overview The failover process in this co...

Chapter 5. Setting configuration options 53 – The secondary server does not repoll the NEs in the network, as this information is already present in the database. – If the problem is that the primary server's network or database connection has gone down, then as soon as the primary server detects th...

Netcool/Precision for Transmission Networks 5.5 Administration Guide 54 There is one further Oracle requirement. The default tablespace of the Oracle connection created by the primary server must be the same as the one created by the secondary. This will be the case if both servers are using the sam...

Chapter 5. Setting configuration options 55 Using Netcool/Precision TN with Cisco WAN Manager Cisco WAN Management System (CWM) is used to manage Cisco WAN devices such as Asynchronous Transfer Mode (ATM) devices and frame relays. It manages devices, topological connections among devices, and PVC (U...

Netcool/Precision for Transmission Networks 5.5 Administration Guide 56 Polling CWM topological connections To configure a polling schedule for CWM TC polling, follow the steps below: 1. Start the Network Pilot. 2. Select Actions -> Polling -> Manage Network Connection Discovery from the menu....

Chapter 5. Setting configuration options 57 Configurable properties in CiscoWanManagerExtension The CiscoWanManagerExtension extension contains various configurable parameters, all of which are Boolean. See Table 6 for further details. Table 6. Configurable parameters in CiscoWanManagerExtension Pro...

Netcool/Precision for Transmission Networks 5.5 Administration Guide 58 Configuring Netcool/OMNIbus process control Netcool/OMNIbus process control allows the Netcool/Precision TN process to be monitored and automatically restarted if it exits unexpectedly. If Netcool/Precision TN is not configured ...

Chapter 5. Setting configuration options 59 Configuring connections to known devices Netcool/Precision TN allows you to specify a set of devices with which to connect; this information is held in a plain text hosts file. This feature allows you to bypass both the Network Pilot manual creation proces...

Netcool/Precision for Transmission Networks 5.5 Administration Guide 60 neName,NEType,host,port,usr,pwd,connType,protType,scenario,run_fir st_enabled,run_always_enabled,cron_tab See Table 7 for details of each parameter. An example of one line in the hosts file is as follows: NE1,OVM_ADM_V2,10.0.0.1...

Chapter 5. Setting configuration options 61 • If any of the field values contain a comma, it must be preceded by the escape character back slash ( \ ). For example, if the password field value is the string “ibmnet,co\ol”, it is represented by the string “ibmnet\,co\\ol” . • If any of the fields con...

Netcool/Precision for Transmission Networks 5.5 Administration Guide 62 For example, to allow on-demand connectivity for all Cisco 15454 ( NEType name= “ONS15454” ) devices, add the following lines to the precisiontn.xml file: <properties name="NEPollingExtension "> <property name=&...

63 Appendix.fm November 27, 2006 Appendix A. Reference This section describes the properties and command line options used to configure Netcool/Precision TN, as well providing information about the third-party software delivered as part of Netcool/Precision TN. This appendix contains the following s...

Appendix A. Reference 65 Table A1 on page 65 describes the properties in the precisiontn.xml file. The name attributes are case sensitive and must be input exactly as they appear in the table. Table A1: Properties in the precisiontn.xml file (1 of 3) Netcool/Precision TN Component Property and Synta...

Appendix A. Reference 67 Netcool/Precision TN command line options Table A2 describes the precisiontn command line options. TopoMediatorExtens ion Netcool/Precision TN Topology property. l umos.leapx.servi ce.topo. mediator.UseCLLI Codes true|false Specifies whether Netcool/Precision TN should use C...

69 appnotices.fm November 27, 2006 Appendix B. Notices This appendix contains the following: • "Notices" on page 69 • "Trademarks and Acknowledgements" on page 71 Notices This information was developed for products and services offered in the U.S.A. IBM may not offer the products, se...

Appendix B. Notices 71 Any performance data contained herein was determined in a controlled environment. Therefore, the results obtained in other operating environments may vary significantly. Some measurements may have been made on development-level systems and there is no guarantee that these meas...