Compaq Software Product Description ________________________________________________________ PRODUCT: Compaq TeMIP Expert V1.0 for SPD 70.65.00 DIGITAL UNIX[R] DESCRIPTION TeMIP for DIGITAL UNIX. 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.2 provides comprehensive off-the-shelf fault and trouble management functions such as Alarm Handling and Event Logging for telecommunications network management. TeMIP supports the International Standards Organization (ISO) management standards ISO 10164-x and 10165-x. TeMIP and its features are applicable in the context of the International Telephone Union- Telecommunication Standards (ITU-T) X.73x and Telecommunication Management Network (TMN) M.3010, M3100 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, and fully benefits from the object oriented and truly distributed software architecture. TeMIP Expert Features TeMIP Expert is the expert system part of the TeMIP Solution Set for Service Assurance. It is the foundation for building decision support systems that use TeMIP Framework. In particular, it can can be used to perform alarm filtering and correlation. TeMIP Expert is also available as an individual product. TeMIP Expert is based on: o ILOG Rules, a development environment to build expert systems o TeMIP Expert System Access (ESA), a dedicated TeMIP integration product, with specific precustomization for ILOG Rules These products are used to build the TeMIP Expert application, a fully integrated TeMIP management module included in the TeMIP Solution Set for Service Assurance. It is important to note that the TeMIP Expert is not a black-box TeMIP Correlation FM but a means to obtain a customized ESA PM with the final stages of customization done by the user. The unique integration of TeMIP and ILOG Rules through ESA simplifies the expert system development process. By producing a true TeMIP management module, it also makes available the benefits of TeMIP distribution. The final solution is optimized; its complexity is reduced; its maintenance is made easier; and smooth evolution is possible. TeMIP Expert simplifies the programming of the expert system by offering a ready-to-use environment for the interaction between ILOG Rules and TeMIP. When TeMIP Expert is customized by defining ILOG Rules rules, it complements TeMIP's network view and applications by adding intelligent reasoning to events and conditions that happen in the network. TeMIP Expert provides a powerful environment for developing and deploying rule-based applications that manage complex, dynamic operations. An operational expert system management module is obtained by defining rules in this environment. TeMIP Expert can process various information such as events and alarms, equipment states, route availability and usage. These are correlated by ILOG Rules to detect critical situations immediately. Actions can then be prioritized and automated to help operators take the most efficient decisions, either when a problem occurs in the network, or when a service is being adversely affected. TeMIP Expert Components The TeMIP Expert is made up of three parts: o TeMIP Expert System Access (ESA) V1.0 o ILOG Rules for C++ 6.0 o TeMIP Expert Developer's Toolkit TeMIP ESA V1.0 The role of TeMIP ESA is to give ILOG Rules (and therefore the rule builder) simplified access to TeMIP services and data. It provides high-level TeMIP-related services suitable for expert systems. ESA comprises a fixed Service Provider part and a customizable Service Adapter part. The ILOG Rules environment relies on services provided by both parts. ILOG Rules for C++ 6.0 Together with TeMIP, ILOG Rules ensures minimum disruption of services delivered by the network by: o Continually checking for potential problems before they adversely affect operations o Turning complex operational data into useful information by analyzing the data with knowledge- based models o Diagnosing the root cause of time-critical problems and taking the correct actions o Maintaining optimal operating conditions o Co-ordinating activities and information in complex operational processes ILOG Rules V6.0 provides an inference engine for C++ with a knowledge base that is based on the ILOG Rules object model. There are also tools supplying graphical user interfaces to work with rules at various levels. The ILOG Rules environment allows rule builders to generate business rule processors. The ILOG Rules inference engine The ILOG Rules V6.0 inference engine makes use of an optimized RETE algorithm - the industry standard for high-performance rule-based systems - to perform pattern matching on conditions in forward-chaining mode. The performance of this algorithm is independent of the number of rules and perfectly scaleable for applications involving large numbers of objects and events. The ILOG Rules V6.0 knowledge base The ILOG Rules knowledge base is stored in an internal database. In TeMIP Expert, the ILOG Rules knowledge base is populated/updated by means of the following: o A Population Request o Alarms, Alarm Objects and Events received after a Collection Request or OC Monitoring Request is started o A Reply to a TeMIP Call (especially a SHOW directive) The ILOG Rules V6.0 tools for rule-building ILOG Rules tools for rule building include an editor, a compiler, and a debugger. Important features of the rules environment are as follows: o You can group rules into rule sets and, within a rule set, into packets to structure the rule base and control rule activation and deactivation. o You can give rules a priority, which allows precise priority management o You can perform logical justification management to eliminate facts deduced from hypotheses that have since turned out to be false by defining logical rules. The resulting logical objects are maintained automatically by the ILOG Rules device known as the Truth Maintenance System (TMS). o You can use time-triggered watchdogs to express conditions within a relative or absolute time window. o The flow of action is completely determined at run time, where rule activation is triggered by asynchronous events. For instance, the reception of an alarm by the inference engine may activate one or more rules. TeMIP Expert Developer's Toolkit Components The TeMIP Expert Developer's Toolkit provides the following items: o An ILOGRules Object Model Translator called msl2ilr o An ILOG Rules object model of basic TeMIP facilities o Precustomization of the ESA Service Adapter o A makefile to automate the building of the fully customized ESA PM that will be plugged in as the TeMIP Expert management module with optional ILOG Rules rule compilation o Example rulesets ILOG Rules Object Model Translator The ILOG Rules Object Model Translator is called msl2ilr. It translates TeMIP MSL specifications into an ILOG Rules object model. This tool produces the .hxx, .cxx and .ilr files needed to build a Customized ESA PM. Thus the user can focus on writing rules without having to define a second object model with a different syntax. Furthermore, this translation makes the ILOG Rules Builder tool TeMIP dictionary driven. ILOG Rules modeling of TeMIP The TeMIP Expert provides an ILOG Rules modeling of TeMIP concepts useful when building rules to manage a TeMIP network. This includes an ILOG Rules class for each of the following: o TeMIP Entity (parent of all TeMIP entity classes) o TeMIP Alarm Objects o TeMIP Alarms (OSI Notification Events) o TeMIP Events (OSI Configuration Events) o Part of the ESA Service Provider C++ API, offered (through the ESAServicesProvider class) at the ILOG Rules programming level, so that the user can directly perform TeMIP Calls, collect alarms/events, and monitor Operation Context (OCs) in the Action part of the production rules without having to perform C++ coding. Test predicates for implementing comparisons between classes representing TeMIP objects are also supplied. Precustomization of the ESA Service Adapter Replies to TeMIP Calls, collected alarms/events, and changes to monitored OCs are automatically dispatched to update the expert system's Working Memory (WM). All reply parameters and alarm fields are automatically decoded and made available to the user so that they can be used in comparisons in the Condition part of production rules. The precustomization consists of overrides for the following ESA Service Adapter overridable methods: o OnTranslate() and OnTransmit() These methods process the TeMIP Call Reply. The OnTransmit() override contains code used for asynchronous requests to assert collected Alarm Objects, Alarms and Events in the ILOG Rules WM or retract them from it. The OnTranslate() override provides default behavior for the standard TeMIP directives SHOW, SET, CREATE, and DELETE. It can easily be augmented for non-standard TeMIP directives. o OnConnect() and OnDisconnect(). These methods are concerned with the connection to, and disconnection from, ILOG Rules. The OnConnect() override will most likely have to be augmented to populate the ILOG Rules WM from the contents of the TeMIP MIR, and to perform alarm collection and OC monitoring in a more efficient way. This can entail some simple C++ coding. The predefined ESA Service Adapter overrides should be sufficient for 90% of the needs of a typical development environment. They reduce the user customization required for the initialization of the expert system at run time. Module-building makefile with rule compilation The makefile compiles .hxx, .cxx and .ilr files to generate the TeMIP Expert management module, and embeds ILOG Rules. It can optionally call the ILOG Rules compiler. The handling of rule compilation by the makefile allows the user to mix compiled rules (for greater efficiency) with interpreted rules (for greater user-friendliness). Example rulesets Two sets of self-documented example rules are provided, one for simple programming and one for advanced programming. Final customization by the user User customization is required in the following areas: o The user will need to produce some C++ code to specify what needs to be done at start-up time, such as OC monitoring, alarm/event collecting, and retrieving the contents of the TeMIP MIRs. These operations cannot be predefined because only the user knows which OCs need to be monitored, which alarms need to be collected (and how), and which attributes of which entities must be made visible to ILOG Rules. However, the C++ code can be obtained by ILOG Rules programming. o If compiled rules are required, these must be inserted into the supplied rules file for compilation when the module is built. o After generating the ILOG Rules object model using the supplied translator, msl2ilr, the user will have to recompile TeMIP Expert using the supplied makefile. The first and last steps are mandatory. DOCUMENTATION The TeMIP Expert document set includes three categories of documents: ILOG documentation: ILOG Rules for C++ 6.0 - User's Manual ILOG Rules for C++ 6.0 - Reference Manual ILOG Rules for C++ 6.0 - Guide to Interpreted Rules ESA documentation: TeMIP ESA Installation Guide, AA-RDM1A-TE TeMIP ESA Reference Guide, AA-RDM2A-TE TeMIP ESA Development Guide, AA-RDM3A-TE Expert documentation: This is integrated with the TeMIP Solution Set for Service Assurance documentation. Chapter on TeMIP Expert in Compaq TeMIP Solution Set for Service Assurance  Getting Started AA-RG2VA-TE HARDWARE REQUIREMENTS Alpha Enterprise System Class: AlphaServer 8200, 8400 Compaq AlphaServer GS60, GS140 Alpha Departmental System Class: AlphaServer 2000, 2100, 4000, 4100 AlphaStation 600 Alpha Workgroup System Class: DIGITAL Personal Workstation au series DIGITAL Ultimate Workstation 533au2 AlphaServer 800, 1000A, 1200 Disk Space Requirements: Disk space required for installation: 43, 000 Kbytes Disk space required for use (permanent) 43, 000 Kbytes These figures refer to the disk space required on the system disk. The sizes are approximate; actual sizes may vary depending on the user's system environment, configuration, and software options. Memory Requirements: For runtime systems the minimum memory requirement is 128 Mbytes; this also takes into consideration the memory requirements of TeMIP Framework. For development systems the minimum memory requirement is 256 Mbytes; this also takes into consideration the memory requirements of TeMIP Framework. Note that if more memory is made available for use with the TeMIP Expert software, performance will be improved. SOFTWARE REQUIREMENTS DIGITAL UNIX Operating System V4.0D TeMIP Framework V3.2. Visual TeMIP C++ Developer Toolkit V2.0 DEC C++ V5.7 GROWTH CONSIDERATIONS The minimum hardware/software requirements for any future version of this product may be different from the requirements for the current version. YEAR 2000 READY This product is Year 2000 Ready. "Year 2000 Ready" products are defined by Compaq as products capable of accurately processing, providing, and/or receiving date data from, into and between the twentieth and the twenty-first centuries, and the years 1999 and 2000, including leap year calculations, when used in accordance with the associated Compaq product documentation and provided that all hardware, firmware and software used in combination with such Compaq products properly exchange accurate date data with the Compaq products. For additional information visit Compaqs DIGITAL Products Year 2000 Ready web site located at http://ww1.digital.com/year2000/warranty.asp. To ensure that this product is Year 2000 Ready, code assessment and system tests to verify the transition between December 31st 1999 and January 1st 2000 were utilized. To ensure that this product interoperates properly with other hardware and software, the system tests involving third-party product ILOG Rules and Compaqs TeMIP V3.2 are applicable, as these products were verified as being Year 2000 Ready. DISTRIBUTION MEDIA This product is distributed with the media for TeMIP Solution Set for Service Assurance. Software Media and Documentation: QA-69MAA-H8 Software Documentation only: QA-69MAA-GZ ORDERING INFORMATION Two part numbers are related to TeMIP Expert: TeMIP Expert and TeMIP ESA. In addition, a package part number exists for the combination of the two. TeMIP Expert System Access (ESA) traditional license: Software License: QL-64SA*-AA Software Product Services: QT-64S**-** TeMIP Expert traditional license: Software License: QL-69QA9-AA Software Product Services: QT-69Q**-** Software Media and Documentation : QA-69HAA-H8 Hardcopy Documentation Only : QA-69HAA-GZ SOFTWARE LICENSING This software is furnished under the licensing provisions of Compaq Computer Corporation's Standard Terms and Conditions. For more information about the COMPAQ licensing terms and policies, contact your local COMPAQ office. ILOG RULES LICENSING TeMIP Expert includes the licenses for the ILOG Rules product, both development and run-time. These licenses are restricted to the use of ILOG Rules in conjunction with TeMIP. The ILOG Rules licence is valid for unlimited run-time use for 15 developers. DIGITAL UNIX LICENSE MANAGEMENT This product supports the UNIX FLEXlm Software License Key system. License units are allocated on a system usage basis. The licensed software can be used up to the limit specified in the license file. The scheme used is trust based, which means that it does not use any machine specific values to rigidly enforce license compliance. A FLEXlm key must be obtained using the request form provided with the Cover Letter, temip-license-form.txt. SOFTWARE PRODUCT SERVICES A variety of service options are available from COMPAQ. For more information on these services or other available Network Management Services, contact your local COMPAQ office. SOFTWARE WARRANTY This software is provided by COMPAQ with a 90 day conformance warranty in accordance with the COMPAQ warranty terms and applicable to the license purchase. The above information is valid at time of release. Please contact your local COMPAQ office for the most up-to-date information. [R] UNIX is a registered trademark in the United States and other countries licensed exclusively through X/Open Company Ltd. [R] FLEXlm is a registered trademark of GLOBEtrotter Software, Inc. TM ILOG and ILOG Rules are trademarks of ILOG, Inc. TM The Compaq Logo, DEC, AlphaStation, AlphaServer, DIGITAL and TeMIP are trademarks of Compaq Computer Corporation and its affiliated companies. (C)1999 Compaq Computer Corporation. All Rights Reserved. April 1999 AE-RG38A-TE