tl1 gateway user guide - ehealth- .tl1 gateway user guide page 3 restricted rights notice...

Download TL1 Gateway User Guide - ehealth- .TL1 Gateway User Guide Page 3 Restricted Rights Notice (Applicable

Post on 12-Aug-2018

221 views

Category:

Documents

1 download

Embed Size (px)

TRANSCRIPT

  • TL1 Gateway User Guide

    Document 9035087-01

    Applications & Gateways

    Titlepage

  • TL1 Gateway User Guide Page 2

    Copyright Notice

    Document 9035087-01. Copyright January 2002 Aprisma Management Technologies, Inc., 121 Technology Drive, Durham, NH 03824 USA. All rights reserved worldwide. Use, duplication, or disclosure by the United States government is subject to the restrictions set forth in DFARS 252.227-7013(c)(1)(ii) and FAR 52.227-19.

    Liability Disclaimer

    Aprisma Management Technologies, Inc. ("Aprisma") reserves the right to make changes in specifications and other information contained in this document without prior notice. In all cases, the reader should contact Aprisma to inquire if any changes have been made.

    The hardware, firmware, or software described in this manual is subject to change without notice.

    IN NO EVENT SHALL APRISMA, ITS EMPLOYEES, OFFICERS, DIRECTORS, AGENTS, OR AFFILIATES BE LIABLE FOR ANY INCIDENTAL, INDIRECT, SPECIAL, OR CONSEQUENTIAL DAMAGES WHATSOEVER (INCLUDING BUT NOT LIMITED TO LOST PROFITS) ARISING OUT OF OR RELATED TO THIS MANUAL OR THE INFORMATION CONTAINED IN IT, EVEN IF APRISMA HAS BEEN ADVISED OF, HAS KNOWN, OR SHOULD HAVE KNOWN, THE POSSIBILITY OF SUCH DAMAGES.

    Trademark, Service Mark, and Logo Information

    SPECTRUM, IMT, and the SPECTRUM IMT/VNM logo are registered trademarks of Aprisma Management Technologies, Inc., or its affiliates. APRISMA, APRISMA MANAGEMENT TECHNOLOGIES, the APRISMA MANAGEMENT TECHNOLOGIES logo, MANAGE WHAT MATTERS, DCM, VNM, SpectroGRAPH, SpectroSERVER, Inductive Modeling Technology, Device Communications Manager, SPECTRUM Security Manager, and Virtual Network Machine are unregistered trademarks of Aprisma Management Technologies, Inc., or its affiliates. For a complete list of Aprisma trademarks, service marks, and trade names, go tohttp://www.aprisma.com/manuals/trademark-list.htm.

    All referenced trademarks, service marks, and trade names identified in this document, whether registered or unregistered, are the intellectual property of their respective owners. No rights are granted by Aprisma Management Technologies, Inc., to use such marks, whether by implication, estoppel, or otherwise. If you have comments or concerns about trademark or copyright references, please send an e-mail to spectrum-docs@aprisma.com; we will do our best to help.

    http://www.aprisma.com/manuals/trademark-list.htm

  • TL1 Gateway User Guide Page 3

    Restricted Rights Notice

    (Applicable to licenses to the United States government only.)

    This software and/or user documentation is/are provided with RESTRICTED AND LIMITED RIGHTS. Use, duplication, or disclosure by the government is subject to restrictions as set forth in FAR 52.227-14 (June 1987) Alternate III (g)(3) (June 1987), FAR 52.227-19 (June 1987), or DFARS 52.227-7013 (c)(1)(ii) (June 1988), and/or in similar or successor clauses in the FAR or DFARS, or in the DOD or NASA FAR Supplement, as applicable. Contractor/manufacturer is Aprisma Management Technologies, Inc., 121 Technology Drive, Durham, NH 03824. In the event the government seeks to obtain the software pursuant to standard commercial practice, this software agreement, instead of the noted regulatory clauses, shall control the terms of the government's license.

    Virus Disclaimer

    Aprisma makes no representations or warranties to the effect that the licensed software is virus-free.

    Aprisma has tested its software with current virus-checking technologies. However, because no anti-virus system is 100 percent effective, we strongly recommend that you write-protect the licensed software and verify (with an anti-virus system in which you have confidence) that the licensed software, prior to installation, is virus-free.

    Contact Information

    Aprisma Management Technologies, Inc.

    273 Corporate Drive

    Portsmouth, NH 03801

    Phone: 603.334.2100

    U.S. toll-free: 877.468.1448

    Web site: http://www.aprisma.com

    http://www.aprisma.com

  • TL1 Gateway User Guide Page 4

    ContentsIntroduction 5

    What Is TL1? ................................................................................................................5What Is the SPECTRUM TL1 Gateway? .....................................................................5

    Honored TL1 Standards ...........................................................................................6What Does the SPECTRUM TL1 Gateway Include? ................................................7

    Using the TL1 Gateway 8

    Prerequisites for the TL1 Gateway ...........................................................................8Installation Options .....................................................................................................11Installing on a Non-SPECTRUM Machine .................................................................11Setting up Port Numbers ............................................................................................13Creating a TL1 Device Model .....................................................................................13

    TL1 Devices with Autonomous Port .......................................................................17The TL1 AlarmMap ....................................................................................................18

    Format of the AlarmMap .........................................................................................19The tl1map Utility .......................................................................................................20

    AlarmMap Extraction ..............................................................................................22Importing an AlarmMap ..........................................................................................22Examples of tl1map Usage .....................................................................................23

    The TL1 Gateway Daemon ........................................................................................26Starting the TL1 Daemon on the SPECTRUM Machine .........................................26Starting the TL1 Daemon on a Remote Machine ...................................................27Terminating the TL1 Daemon .................................................................................28

  • TL1 Gateway User Guide Page 5

    Introduction

    This section describes SPECTRUMs TL1 Gateway and the components it comprises.

    What Is TL1?Transaction Language 1 (occasionally referred to as MML (Man MachineLanguage) is a widely used protocol in telecommunications management that can be used to manage most telecom network elements in North America today. Unlike SNMP, TL1 is a man-machine interface that contains strings that humans can read and understand. Also, unlike SNMP, there is no concept of MIB in the TL1 world. TL1 was originally specified by Bellcore in 1986, and is now maintained by Telcordia Technologies in Piscataway, NJ.

    What Is the SPECTRUM TL1 Gateway?The current version of the TL1 Gateway translates TL1 events and alarms originating from a TL1 device into SPECTRUM events and alarms. It is basically a mediator from the TL1 world to the SPECTRUM world. Each TL1 device is represented by a corresponding device model within SPECTRUM. This allows you to launch the Enterprise Alarm Manager application for a particular model so that you can check for certain alarm conditions and initiate corrective action. The TL1 Gateway also supports TL1 devices that are accessible through proxy devices, also known as Gateway Network Element (GNE) devices. Figure 1 on Page 6 shows the Alarm Managers Main window with the Probable Cause tab activated. For more information on this application, refer to the Enterprise Alarm Manager Users Guide (9032065).

  • TL1 Gateway User Guide Page 6

    Figure 1: Enterprise Alarm Manager: Main Window

    Honored TL1 StandardsThe SPECTRUM TL1 Gateway implements the full range of TL1 Condition Types as specified in appendix C of Telcordia Technologies Generic Requirements GR-833-CORE, OTGR: Network Maintenance: Network Element and Transport Surveillance Messages. Issue 4, June 2000.

  • TL1 Gateway User Guide Page 7

    What Does the SPECTRUM TL1 Gateway Include? TL1-specific inference handlers that plug into SpectroSERVER.

    a daemon (TL1d) that handles communication between the TL1 devices and the SpectroSERVER.

    a model type (Gen_TL1_Dev) for generic TL1 devices

    a tool (tl1map) to manage TL1 AlarmMaps

  • TL1 Gateway User Guide Page 8

    Using the TL1 Gateway

    This section describes how to install, configure, and use the components of the TL Gateway.

    Prerequisites for the TL1 GatewayThe SPECTRUM TL1 Gateway is designed such that it can either be run on the same machine SPECTRUM is running on (Figure 2 on Page 9), or on a separate machine (Figure 3 on Page 10). Running the TL1 Gateway on a separate machine is recommended if any of the following conditions apply:

    The SPECTRUM machine hosts a SpectroSERVER that has a high work load.

    The SPECTRUM machine is short on resources like CPU and RAM.

    The SPECTRUM machine is also used by applications other than SPECTRUM.

    A high volume of TL1 traffic has to be processed.

  • TL1 Gateway User Guide Page 9

    Figure 2: TL1 Gateway Installed on SPECTRUM Host

  • TL1 Gateway User Guide Page 10

    Figure 3: TL1 Gateway Installed on Remote Host

  • TL1 Gateway User Guide Page 11

    Installation OptionsIf your configuration requires the TL1 Gateway to be run on the same machine SPECTRUM is running on, then the gateway has already been installed during the major SPECTRUM installation. In thi

Recommended

View more >