Oracle® Communications Network Intelligence Release Notes Release 3.4.1 E23548-01 September 2011

This document provides release notes for Oracle Communications Network Intelligence. Refer to the following: ■

New Features

■

Fixes and Enhancements in This Release

■

Known Issues

■

Troubleshooting Tips

■

Third Party Products and Licensing

New Features This section describes new features, and enhancements to existing features, for this release.

Configuration Management You can capture live configuration changes to network resources in Network Intelligence; for example: site creation, equipment modification, or trail deletion, and view these actions, and interactions with other supported entities, in a configuration plan. The contents of the configuration plan can be exported in several formats, or viewed in a report. Configuration plans apply to the following entities: ■ ■

■

Sites Equipments, and the associated equipment hierarchy, that is, cards, ports, logical ports, and so on Trails, and the associated trail hierarchy

Outage Manager Enhancements In Network Intelligence 3.4.1, the following changes have been made to Outage Manager: ■ ■

■

You can bulk load the entities to be analyzed. Impacted trails have been categorized into service-affecting, and non-service-affecting, to allow you to prioritize service restoration. Outage reports can be saved, filtered, viewed, and exported, to allow focused analysis of the outage impact.

1

Upgrading Trails You can upgrade the trail definition associated with a trail so that the trail can carry more traffic. You can upgrade the cards on each of the trail’s terminating ends.

Updating Trail Status In Bulk You can now update the status of many trails at once. You can select a number of trails and change the status of all trails to a new value; for example: when taking a set of trails out of service. Trails can be selected using the Bulk Update tool, or from the impacted trails routing report generated as part of an outage plan.

Using Service Definitions for Unrouted Trails When creating unrouted trails, you can specify a service trail definition rule that enables the trail definition and capacity fields to be automatically and consistently populated in the circuit configuration wizard.

Creating a Routed Trail Over Unstructured Parent Trails You can create routed trails (structured, or unstructured) over unstructured parent trails. If a routing solution uses one or more of these parents, on acceptance of the solution, bandwidth is consumed from the parents' available bandwidth and the service demand trail is assigned as a child of the parent unstructured trail. You can view the unstructured parents using the traversal view for the child trail. You can view a child trail using the payload view of the unstructured parents. The capacity required for parent trail holders is the child trail capacity reduced by the service overbooking rate specified by the service demand policy. This capacity is defined as a trail holder capacity in the capacity tree browser.

Editing Trail Holder Names When Creating a Signal Structure Within Network Intelligence, trails can be structured or unstructured. A structured trail has a defined signal structure that defines the set of child trail holders (timeslots) that the trail payload supports. When adding a signal structure to a trail definition, you can now create unique names for each timeslot.

Adding Logical Ports to a Physical Port You can add a logical port to a physical port from the equipment hierarchy view. You can use one, or more, templates to create logical ports associated with a particular port definition.

Mapping Enhancement for Geographic Views A basic outline of world maps is now automatically installed with Network Intelligence. The field names on the Site Details screen are now X/Y, rather than Easting/Northing and Longitude/Latitude.

2

Using Telecom Domain Packs In Network Intelligence 3.4.0, technology specific metadata modelling (such as that applied to capacities) was removed from the core Network Intelligence installation, and is now available in the form of reference telecom domain model packs. You can use script loading to install telecom domain models after installing Network Intelligence. Reference telecom domain packs are available for the following domains: ■

Carrier Ethernet

■

MPLS-TP

■

SDH

■

PDH

■

ATM

■

Frame Relay

■

2G

■

3G

■

DWDM

■

LTE

■

HSPA

This feature provides more flexibility at implementation time in partitioning the data model to contain only domains that are of interest. Telecom domain packs are available on request from the Network Intelligence Product Management team.

Fixes and Enhancements in This Release Table 1 lists bugs fixed and customer-requested enhancements addressed in Network Intelligence 3.4.1. Table 1

Fixed Issues and Customer Enhancements in Network Intelligence 3.4.1

Bug Number

Customer SR

Notes

12547714

3-3425728771

Requirement

12542406

3-3568062191

Path routing solutions do not specify whether trails are protected. Solution Routing solutions now display the protection type of each trail using a small lock shaped icon and the protection status text beside every trail.

3

Table 1 (Cont.) Fixed Issues and Customer Enhancements in Network Intelligence 3.4.1 Bug Number

Customer SR

Notes

11782769

3-2857251751

Requirement Configuration changes to a plan need to be captured for later use. Solution You can now create a configuration plan to associate any configuration changes to sites, equipments, and trails made using Network Intelligence. When you have carried out the configuration management, you can save the configuration changes to a report. See also "Configuration Management".

11731086

3-2857133771

Requirement The ability to bulk load a list of entities for outage analysis is required. Solution You can now create a resource group, import a list of entities, and load that group into Outage Manager.

11722928

3-2856921921

Requirement Outage reports showing customized, filtered output for multiple entities are required. Solution You can now use Outage Manager to filter the output in the reports.

Known Issues There are no known issues in this release.

Troubleshooting Tips This section describes issues you may encounter when installing, configuring, or operating Oracle Communications Network Intelligence. The information contained in this section complements the Troubleshooting chapter in Network Intelligence Installation and System Administration Guide. Refer to the following: ■

Increasing Network Intelligence Database Installer Memory

■

Increasing WebLogic Domain Memory

■

Configuring WebLogic Domains With Separate Listen Ports

■

Defining the DATAPUMP Directory Before Importing Map Data

Increasing Network Intelligence Database Installer Memory In certain situations, the Network Intelligence database installer can run out of memory. If you encounter memory errors during the installation process, please use the following command at a console prompt:

4

java -Xms512m -Xmx512m -jar netintel-installer.jar

Refer to the following article, that describes the Java application launcher, for further information: http://download.oracle.com/javase/6/docs/technotes/tools/windows/java.html.

Increasing WebLogic Domain Memory In certain situations, the Oracle WebLogic Server domain on which Network Intelligence is deployed may not have sufficient memory. To prevent this, configure the JVM arguments for initial and maximum heap size. For permanent generation out of memory errors, configure the maximum permanent size argument. In the following example, the initial, and maximum heap size is set to 1024 Mb, and the maximum permanent size is set to 512 Mb: -Xms1024m -Xmx1024m -XX:MaxPermSize=512m

Note: The -XX:MaxPermSize setting is specific to the HotSpot JDK.

Refer to the WebLogic documentation for further information.

Configuring WebLogic Domains With Separate Listen Ports If you are configuring multiple WebLogic domains on the same server; for example: separate domains for Network Intelligence and MapViewer, you must configure each domain with its own unique listen port. The listen port can be configured when creating the domain, or can be changed using the domain console. This port number is used in the URL to access the WebLogic console and the deployed applications. Refer to the WebLogic documentation for further information.

Defining the DATAPUMP Directory Before Importing Map Data In the sample SQL for importing map data in the “Using Prepackaged Outline Maps” section of the Network Intelligence Pre-Installation Tasks chapter of Network Intelligence System Administration and Installation Guide, it is not explicitly stated that you must first define the DATAPUMP directory before executing the impdp command. To create the DATAPUMP directory, follow these steps. These commands are examples, and may be different for your installation: 1.

Log in to SQL*Plus as SYSTEM, and execute the following scripts: SQL> create or replace directory DATAPUMP as '/home/oracle/installfiles'; SQL> grant read, write on directory DATAPUMP to NI_MAP;

Where DATAPUMP is the directory containing the dump file to be imported, and NI_MAP is the username into whose schema the data is being imported. 2.

Exit to the command line, and execute the impdp command as described in the procedure in the “Using Prepackaged Outline Maps” section, that is: $ impdp ni_core_map/ni_core_map@athe6db remap_schema=ni_map_dump:ni_core_map TRANSFORM=oid:n:type

5

DUMPFILE=DATAPUMP:ni_map_34100.dmp LOGFILE=DATAPUMP:ni_map_dump_34100.log

Third Party Products and Licensing This section describes third party software used with Network Intelligence.

Commercial and Open Source Software Table 2 lists the commercial and open source software distributed with the core product. Table 2

Commercial and Open Source Software Distributed with Network Intelligence

Vendor

Product

License

Purpose

IBM

ILOG JViews Diagrammer

Commercial

Advanced graphics software.

Apache

Commons Lang Apache Software A suite of common utilities. License, Version 2.0

Apache

Log4J

Apache Software Logging framework. License, Version 2.0

Apache

Spring Framework

Apache Software Layered Java/J2EE application License, Version 2.0 framework.

Apache

Acegi Security

Apache Software Security framework used to secure License, Version 2.0 products.

Apache

Quartz

Apache Software Scheduling system. License, Version 2.0

Apache

ANT Installer

Apache

Apache

Ehcache

Apache Software Java distributed cache for general License, Version 2.0 purpose caching.

Apache

Velocity

Apache Software Scripting templates. License, Version 2.0

Apache

AppFuse

Apache Software Web project framework. License, Version 2.0

Apache

Incanto

Apache Software Used by database installer to run License, Version 2.0 SQL*PLUS scripts.

Apache

DWR

Apache Software Used with AJAX for dynamic License, Version 2.0 updates of Web pages.

Displaytag

Display Tag Library

Artistic License

Suite of custom tags for use in Web applications.

iText

iText

Commercial

Java class library for creating and manipulating PDF documents.

Jgoodies

Jgoodies Looks

Berkeley Software Distribution (BSD) License

Libraries to help create Swing applications.

Jgoodies

Jgoodies Forms

Berkeley Software Distribution (BSD) License

Library to help create Swing user interfaces.

6

Software installer program.

Table 2 (Cont.) Commercial and Open Source Software Distributed with Network Vendor

Product

License

Purpose

Jgoodies

Jgoodies Binding

Berkeley Software Distribution (BSD) License

Libraries to help create Swing applications.

Opensymphony

SiteMesh

Apache license.

Web-page layout and decoration framework.

Oracle

Java Help

Oracle Corporation Binary Code License Agreement

Used for user interface embedded user Help manual.

Oracle

JSTL

Oracle Corporation Binary Code License Agreement

JavaServer Pages Standard Tag Library.

Oracle

JavaMail

Oracle Corporation Binary Code License Agreement

Framework to build mail and messaging applications.

Oracle

Java jta.license Transaction API

Apache

iBATIS

Apache Software Persistence framework. License, Version 2.0

Apache

Struts-Menu

Apache Software Dynamic menu for Web. License, Version 2.0

SourceForge

Flib

Artistic license

SourceForge

Joda Time

Apache Software Java date and time utilities. License, Version 2.0

MIT

Prototype

MIT License

Tuckey.org

Urlrewrite

Apache Software Web filter. License, Version 2.0

Coderazzi.net

TableFilter

MIT License

Swing components to support user-driven filtering on tables.

SLF4j.net

SLF4J

MIT License

Logging framework.

Transaction management.

Data picker for Swing.

Javascript utilities.

Dependency of ehcache.

Oracle Communications Network Intelligence Release Notes, Release 3.4.1 E23548-01 Copyright © 2011, Oracle and/or its affiliates. All rights reserved. This software and related documentation are provided under a license agreement containing restrictions on use and disclosure and are protected by intellectual property laws. Except as expressly permitted in your license agreement or allowed by law, you may not use, copy, reproduce, translate, broadcast, modify, license, transmit, distribute, exhibit, perform, publish, or display any part, in any form, or by any means. Reverse engineering, disassembly, or decompilation of this software, unless required by law for interoperability, is prohibited. The information contained herein is subject to change without notice and is not warranted to be error-free. If you find any errors, please report them to us in writing. If this is software or related documentation that is delivered to the U.S. Government or anyone licensing it on behalf of the U.S. Government, the following notice is applicable: U.S. GOVERNMENT RIGHTS Programs, software, databases, and related documentation and technical data delivered to U.S. Government customers are "commercial computer software" or "commercial technical data" pursuant to the applicable Federal Acquisition Regulation and agency-specific supplemental regulations. As such, the use, duplication, disclosure, modification, and adaptation shall be subject to the restrictions and license terms set forth in the applicable Government contract, and, to the extent applicable by the terms of the Government contract, the additional rights set forth in FAR 52.227-19, Commercial Computer Software License (December 2007). Oracle America, Inc., 500 Oracle Parkway, Redwood City, CA 94065. This software or hardware is developed for general use in a variety of information management applications. It is not developed or intended for use in any inherently dangerous applications, including applications that may create a risk of personal injury. If you use this software or hardware in dangerous applications, then you shall be responsible to take all appropriate fail-safe, backup, redundancy, and other measures to ensure its safe use. Oracle Corporation and its affiliates disclaim any liability for any damages caused by use of this software or hardware in dangerous applications. Oracle and Java are registered trademarks of Oracle and/or its affiliates. Other names may be trademarks of their respective owners. Intel and Intel Xeon are trademarks or registered trademarks of Intel Corporation. All SPARC trademarks are used under license and are trademarks or registered trademarks of SPARC International, Inc. AMD, Opteron, the AMD logo, and the AMD Opteron logo are trademarks or registered

7

trademarks of Advanced Micro Devices. UNIX is a registered trademark of The Open Group. This software or hardware and documentation may provide access to or information on content, products, and services from third parties. Oracle Corporation and its affiliates are not responsible for and expressly disclaim all warranties of any kind with respect to third-party content, products, and services. Oracle Corporation and its affiliates will not be responsible for any loss, costs, or damages incurred due to your access to or use of third-party content, products, or services.

8