Software Product Description PRODUCT NAME: TeMIP ASCII Management Toolkit V3.1 for Digital UNIX SPD 63.38.03 DESCRIPTION TeMIP for Digital UNIX[R] is a family of software products for the management of telecommunications and corporate networks, including fixed wire and mobile/cellular voice and data multi-vendor, multi- technology networks. TeMIP V3.1 provides comprehensive off-the-shelf fault and trouble mana- gement functions such as Alarm Handling, Event Logging and Trouble Ticketing for telecommunications network management. TeMIP supports the International Standards Organisation (ISO) management standards ISO 10164-x and ISO 10165-x, and the OMNIpoint 1 standards as defined by NMF and T1M1. TeMIP and its features are applicable in the context of the International Telephone Union-Telecommunication Standards (ITU-T) X.73x and Telecom Management Network (TMN) M.3010, M.3100 Recommendations. It gives network operators a global view of their networks, and enables them to activate management functions and operations from single or multiple workstations. TeMIP is built on top of the TeMIP Framework, which is an implementation of the Enterprise Management Architecture (EMA), and fully benefits from the object oriented and truly distributed software architecture. The TeMIP ASCII Management Toolkit V3.1 is part of this TeMIP program and provides the TeMIP platform with access to telecommunications equipments which, for historical reasons, do not support a standardised management interface but report management information and receive control information via an interface designed for human interaction, using a character (ASCII) terminal or a printer. As such, the TeMIP ASCII Management Toolkit extends TeMIP functionalities to all network elements that support ASCII/TL1 protocols. It also benefits from the Event Filtering and Correlation capabilities of TeMIP. Please refer to TeMIP Fault and Trouble Management Software Product Description (SPD 45.24.xx) and TeMIP Framework SPD (54.17.xx) for more information about Distribution and Event Filtering and Correlation related features. The syntax and semantics of the messages, commands and responses, which are exchanged between the network elements and the management terminal, are called the MML (Man Machine Language) specification. MML messages are specific for each type of equipment and are an equipment vendor’s property. The connection between network elements and management terminals is either a direct line with an RS232 interface, or a connection through X25 or TCP/IP networks. The TeMIP ASCII Management Toolkit is a collection of components that enable rapid building of a TeMIP ASCII/TL1 Access Module for a given type of equipment. Some components are generic, while others require slight customization to adapt them to specific equipment. After customization, a specific TeMIP ASCII/TL1 Access Module will consist of the following components: Back-End, which interfaces with the TeMIP Framework Front-End, which receives raw ASCII data from network elements, parses and maps events/alarms to standard representation which is forwarded to the Back-End Passthrough facility, which is invoked as a TeMIP Framework launched application. The ASCII Access Module Front-End components can be distributed among several systems depending on the degree of distribution needed. The customization process includes the following steps: 1. Analyse the specific MML of the equipment to be managed 2. Define the management model for the specific equipment 3. Produce a specific parser and mapper 4. Build and test the customized ASCII Access Module 5. Finalize specific end user documentation. Back-End Component The TeMIP ASCII Access Module Back-End component is composed of the Generic Access Module and the Event Sink. The Generic Access Module handles the management model defined at customization time for a specific equipment. It interacts with the TeMIP Framework executive through the TeMIP Framework programming interface. The Generic Access Module is part of the TeMIP ASCII Management Toolkit and its code does not need to be modified during the customization process. The Event Sink receives event data from the different Parser/Mappers included in the system, and transfers the data to the TeMIP Framework event management function. The Event Sink generates, from the information contained in the event data, the corresponding OSI alarms with appropriate arguments. The interface between the Event Sink and a Parser/Mapper is based on the connectionless UDP communications protocol. Both the Generic Access Module and the Event Sink need to be located on the same system as TeMIP Framework internal functions. Front-End Component The Front-End component connects network elements to the Back-End. The Front-End component is composed of a Parser/Mapper module and a Communication module. The Parser/Mapper functions parse the textual output generated by the network element and, based on the MML knowledge, map the alarm messages to corresponding events to be sent to the Event Sink. The knowledge of the specific MML is built into the Parser/Mapper module by lex and yacc specifications and the setup of mapping tables. The lexical analysis of the character stream and the split into identifiable pieces of text is done using code produced by the lex UNIX utility. The tokens to be recognized by the lexical analyser are specified to lex by regular expression. The overall parsing is performed by the code produced by the yacc UNIX grammatical analyser utility. The grammatical analyser recognizes sequences of tokens and performs the appropriate actions. The Parser/Mapper enables the following Notification and Configuration Events to be mapped and sent to the Event Sink: o Notification Events - Alarm family . Communication Alarm . Environmental Alarm . Equipment Alarm . Processing Error Alarm . Quality of Service Alarm - Security family . Integrity Violation . Operational Violation . Physical Violation . Security Service or Mechanism Violation . Time Domain Violation o Configuration Events - Object Creation - Object Deletion. Please refer to the TeMIP ASCII Management Toolkit Customization Manual for additional information. Communication towards network elements is handled by the Communication Module. This involves both connection management and transmission of data. This can be achieved directly using RS-232 lines or via a network by using X.25 or TCP/IP protocols. The connection management involves the setting up and breaking down of connections. When network elements are connected directly to the Communication Module, there is a one to one correspondence between Front-End systems and Network Elements. If Network Elements are connected by means of an Operation and Maintenance Centre (OMC), several Network Elements can be controlled through one Front-End system. The Communication Module data transmission function is used for both receiving alarm reports from the equipment and for passthrough communication. For alarm report handling it is a one-way communication; no data is sent to the network element and the information received is transferred to the Parser/Mapper. Passthrough communication is two-way: data received from the Passthrough Module is sent to the equipment and data from the equipment is forwarded to the Passthrough. If the equipment does not have separate interfaces for alarm reporting and management, the single connection is shared by the two data streams and the Communication Module is responsible for the distribution of received data to both the Parser/Mapper and the Passthrough. Passthrough Component When an alarm is reported from a network element, it is critical that an operator has access to it. The Passthrough component provides operators with access from their local workstations to the management terminal interface of the remote Network Element or the Operation and Maintenance Centre. When a Passthrough operation is selected, a DECterm is started, opening a transparent connection through the Communication Module of the Front-End component. Either a separate connection to the Network Element is established or the two data streams (asynchronous alarm reporting and command/response information) share a single connection. Data exchanged between the operator and the Network Element is sent transparently via the Communication Module. Customization Process Customization of an ASCII Access Module is the process of creating an equipment-specific access module from the object files and templates, which are provided as building blocks in the TeMIP ASCII Management Toolkit. The activities included within the customization process are the following: Management Model Definition The management model, defined in correspondence with the MML and specified using the Management Specification Language (MSL), must reflect the need of the TeMIP Alarm Handling function to distinguish different entities. As a result, the identification by the Parser/Mapper component of a specific entity is defined. This allows the Parser/Mapper to associate the incoming event/alarm to the appropriate entity. Creation of the MSL specification and corresponding dispatch table, which are used in the next activity, is helped by using templates included in the TeMIP ASCII Management Toolkit. Generic Access Module Building The Generic AM is built using the appropriate tools included within TeMIP Framework. Front-End Building This task corresponds to the building of the Parser/Mapper module. It has the following phases: 1. Study the MML used by the network element 2. Make an example input file with all alarm formats represented 3. Produce the parser specifications in the form of input to lex and yacc in order to generate the parser 4. Set up tables that map tokens of the MML to fields of an OSI alarm 5. Compile and link Parser/Mapper. Integration and Test This step allows for the use and test of the components altogether. Finalize Documentation TeMIP ASCII Management Toolkit includes template files for System Manager and Module Reference Manual documentation. These documents need to be completed to reflect the changes of the customization. For additional information, please refer to the appropriate documentation: TeMIP ASCII Management Toolkit - User's Manual TeMIP ASCII Management Toolkit - System Manager's Manual TeMIP ASCII Management Toolkit - Customization Manual TeMIP ASCII Management Toolkit - Module Reference Manual. HARDWARE REQUIREMENTS Alpha AXP Processors Supported: AlphaServer 8200 AlphaServer 8400 DEC/4600, DEC/4700 DEC/7600, DEC/7700 DEC/10600 AlphaServer 2000 AlphaServer 2100 AlphaServer 4000 AlphaServer 4100 AlphaStation 600 DEC/3500, DEC/3500S, DEC/3500X DEC/3800, DEC/3800S DEC/3900 AlphaServer 400 AlphaServer 1000 AlphaStation 200 AlphaStation 250 AlphaStation 255 AlphaStation 400 AlphaStation 500 DEC/2300S DEC/2500 DEC/3300, DEC/3300L, DEC/3300X, DEC/3300LX DEC/3400, DEC/3400S DEC/3600, DEC/3600S DEC/3700 Disk Space Requirements: Disk space required for installation: Subset copy: 2,000 Kbytes Installation: 3,500 Kbytes Disk space required for use (permanent): No specific requirement. Memory Requirements: The minimum memory supported, due to a TeMIP Framework prerequisite, is 128 Mbytes. However, the use of this software in conjunction with increased memory capability improves performance. SOFTWARE REQUIREMENTS Digital UNIX Operating System V3.2G TeMIP Framework V3.1 TeMIP Framework Developer's Toolkit V3.1 OPTIONAL SOFTWARE DEC X.25 V1.3 for UNIX GROWTH CONSIDERATIONS The minimum hardware/software requirements for any future version of this product could be different from the requirements for the current version. DISTRIBUTION MEDIA This product is also available as part of the UNIX Consolidated Software distribution on CD-ROM. Please see ordering information for each Software Media reference. ORDERING INFORMATION TeMIP ASCII Management Toolkit Software License: QL-3GWA9-AA Software Media: QA-3GWAA-H8 Software Documentation: QA-3GWAA-GZ Software Product Services: QT-3GWA*-** TeMIP ASCII Management Run-Time Software License: QL-3GXA9-AA Software Product Services: QT-3GXA*-** SOFTWARE LICENSING This software is furnished under the licensing provisions of Digital Equipment Corporation's Standard Terms and Conditions. For more information about Digital's licensing terms and policies, contact your local Digital office. License Management Facility This layered product supports the UNIX License Management Facility. License units for this product are allocated on an Unlimited System Use basis. SOFTWARE PRODUCT SERVICES A variety of service options are available from Digital. For more information, contact your local Digital office. SOFTWARE WARRANTY Warranty for this software product is provided by Digital with the purchase of a license for the product. The above information is valid at time of release. Please contact your local Digital office for the most up-to-date information. [TM] The DIGITAL Logo, DEC, DECnet, AplhaStation, AlphaServer, Digital, TeMIP are trademarks of Digital Equipment Corporation. [R]UNIX is a registered trademark in the United States and other countries licensed exclusively through X/OpenCompany Ltd. ©1996 Digital Equipment Corporation. All Rights Reserved. November 1996 AE-QDXVD-TE TeMIP ASCII Management Toolkit V3.0 for Digital UNIX SPD 63.38.02 5 5 6