Contents

Release Notes

- Software Compatibility

- UIM Software Development Kit

- UIM 7.4 New Features

- Platform Upgrade

- Support for Multiple Pending Configurations

- Bulk Edit Characteristics of Telephone Number Entities

- New System Property to Configure Search Criteria Operators for Specific Entities

- Oracle Communications Network Service Orchestration Renamed

- Orchestrating VNFs Using OpenStack Heat Templates

- Orchestrating the Clearwater IMS

- Integrating to External EMSs for Managing VNF Configuration

- Enhanced NFV Orchestration RESTful APIs

- Updated Descriptor Files for VNF Sample Cartridges

- Fixed Issues in UIM 7.4

- Known Issues in UIM 7.4

- Documentation Accessibility

Oracle® Communications Unified Inventory Management

Release Notes

Release 7.4

E88056-01

December 2017

This document provides information about Oracle Communications Unified Inventory Management (UIM) Release 7.4. The document includes information about the following topics:

- Software Compatibility

- UIM Software Development Kit

- UIM 7.4 New Features

- Fixed Issues in UIM 7.4

- Known Issues in UIM 7.4

- Documentation Accessibility

Software Compatibility

See ”Unified Inventory Management System Requirements” in UIM Installation Guide for a full list of software requirements.

UIM Software Development Kit

You must use the Software Development Kit (SDK) delivered with UIM 7.4 instead of the SDK delivered with Oracle Communications Design Studio 7.3.5.2.

UIM 7.4 New Features

UIM 7.4 includes the following new features and enhancements:

- Platform Upgrade

- Support for Multiple Pending Configurations

- Bulk Edit Characteristics of Telephone Number Entities

- New System Property to Configure Search Criteria Operators for Specific Entities

- Oracle Communications Network Service Orchestration Renamed

- Orchestrating VNFs Using OpenStack Heat Templates

- Orchestrating the Clearwater IMS

- Integrating to External EMSs for Managing VNF Configuration

- Enhanced NFV Orchestration RESTful APIs

- Updated Descriptor Files for VNF Sample Cartridges

Platform Upgrade

With UIM 7.4, the application platform now supports the following upgraded software versions:

- Oracle Fusion Middleware 12c (12.2.1.3.0)

- Oracle WebLogic Server 12c (12.2.1.3.0)

- Oracle Database Enterprise Edition 12c Release 2 (12.2.0.1)

- AspectJ 1.8.10

Support for Multiple Pending Configurations

UIM 7.4 now supports multiple pending configurations, which means that more than one configuration can be in progress at a given time. The multiple pending configuration functionality is available only for non-network services. You determine if a service is a network service by the Network Oriented Service Type attribute setting on the service entity. For network services, only one configuration can be in progress at a time.

The multiple pending configuration functionality is enabled by the uim.mpcenabled system property in the system-config.properties file. The default is for the functionality to be enabled. See UIM System Administrator's Guide for information about this property.

You can also create multiple pending configurations for a service using the Service Fulfillment Web Service. See UIM Web Services Developer's Guide for more information.

You can create an in-progress configuration before or after any existing in-progress configuration when:

- The multiple pending functionality is enabled in the system-config.properties file.

- Each configuration version is associated to its own Business Interaction.

The effective date on the Business Interaction determines the start date for the configuration. You can create configurations before or after a configuration that is in progress; however, the start date must always be on or after the current date, and each pending configuration version must have a different start date. See UIM Concepts for more information.

Note:
Enabling the multiple pending configurations functionality may affect the existing integrations with northbound and southbound systems. The multiple pending configurations functionality allows you to create multiple in-progress service configurations, regardless of whether the existing service configurations are in In Progress or Completed status. If you do not want the application to allow the creation of a new in-progress service configuration version until an existing service configuration version is completed, you must disable this functionality by setting the uim.mpcenabled system property to false in the system-config.properties file:

uim.mpcenabled=false

Bulk Edit Characteristics of Telephone Number Entities

You can now bulk edit the characteristics of one or more Telephone Number entities from the Telephone Number - Bulk Edit page. See UIM System Administrator's Guide and the UIM online Help for more information.

New System Property to Configure Search Criteria Operators for Specific Entities

A new system property, uim.entitySearch.operators, has been added in the system-config.properties file. This property enables you to choose which search operators should be displayed in the search page for the following entities:

- Service

- Physical Device

- Party

- Logical Device

- Custom Object

- Inventory Group

You can set the following values for this property:

- EQUALS

- CONTAINS

- STARTS_WITH

- ENDS_WITH

For example, if you want only the EQUALS search operator to be displayed in the Service Search page, set this property as follows:

uim.serviceSearch.operators=EQUALS

Similarly, if you want both the EQUALS and CONTAINS operators displayed in the Physical Device Search page, set this property as follows:

uim.physicalDeviceSearch.operators=EQUALS, CONTAINS

See UIM System Administrator's Guide for more information.

Oracle Communications Network Service Orchestration Renamed

Oracle Communications Network Service Orchestration has been renamed to Oracle Communications Unified Inventory Management NFV Orchestration and its documentation is now a part of UIM documentation.

Orchestrating VNFs Using OpenStack Heat Templates

UIM NFV Orchestration now supports orchestration of VNFs using Heat templates as a built-in capability. Heat is the OpenStack orchestration service that enables you to automate the orchestration of VNFs. Heat enables you to describe deployment requirements and operational behavior of complex VNFs in structured YAML text files called Heat Orchestration Templates (HOT), which are parsed and executed by the Heat engine.

The VNF descriptor XML file, which is used for onboarding the VNF, contains the new integration tag that determines whether the VNF should be orchestrated using Heat templates or not. See UIM NFV Orchestration Implementation Guide for more information.

Orchestrating the Clearwater IMS

Project Clearwater is an open source implementation of the IP Multimedia Subsystem (IMS) for cloud computing environments. NFV Orchestration now provides sample network service and VNF cartridges to orchestrate the Clearwater IMS. The network service includes the Clearwater IMS VNF and associated connectivity. The Clearwater VNF is a complex multi-component VNF that is orchestrated using OpenStack Heat.

The following sample cartridges contain the details required to perform this orchestration:

- IMS_NetworkService. This sample cartridge provides the functionality to implement an IMS network service.

- Clearwater_vIMS. This sample cartridge contains the Clearwater IMS VNF to use with the IMS network service.

See UIM NFV Orchestration Implementation Guide for more information.

Integrating to External EMSs for Managing VNF Configuration

UIM NFV Orchestration provides a framework that supports integration to external element management systems (EMSs) and configuration managers for VNF configuration management. This framework includes a generic EMS interface, which enables NFV Orchestration to determine which EMS is responsible for managing the configuration of a VNF so that NFV Orchestration can communicate with that EMS by sending notifications about the statuses of instantiation and termination lifecycle actions performed on the VNF.

The VNF descriptor XML file contains the new integration tag that enables you to specify the EMS that will manage the configuration of a VNF. See UIM NFV Orchestration Implementation Guide for more information.

Enhanced NFV Orchestration RESTful APIs

The JSON request and response of the Register EMS RESTful API have been enhanced to include a new emsUrl parameter, which enables you to specify the URL of the EMS that will manage the configuration of a VNF. See UIM NFV Orchestration Implementation Guide for more information

Updated Descriptor Files for VNF Sample Cartridges

The descriptor XML files of the following sample VNF cartridges now include a new integration element that enables you to specify the EMS that will manage the configuration of the VNF, and to specify whether you want to use Heat templates to orchestrate the VNF.

- Juniper_vSRX

- Checkpoint_NG_FW

See UIM NFV Orchestration Implementation Guide for more information.

Fixed Issues in UIM 7.4

Table 1 lists and describes the fixed issues in UIM 7.4.

Table 1 Fixed Issues in UIM Release 7.4

Bug Number

Issue

Resolution

25448535

The UIM landing page has navigation issues in selecting Engineering Work Orders, Property Locations and My Group Activities.

The navigation issues no longer occur in the UIM landing page.

22453534

Spaces between the fields of characteristics are being trimmed, when product is not configured to trim the spaces.

The code has been corrected so this issue no longer occurs.

Known Issues in UIM 7.4

Table 2 lists and describes the known issues in UIM 7.4.

Table 2 Known Issues in UIM Release 7.4

Bug Number

Description

Notes

multiple

Entity Link characteristics do not work with Connectivity, Network Domain, IP, Subnet, and Project entities.

No workaround available. Do not add characteristics of this type to these entities.

24975927

An error on ”Cannot find JNDI binding” occurs in the log files during installation.

This error shows up during UIM installations in the log file. However, it does not impact functionality. No further action is required and this error message can be safely ignored.

25227765

An ADF error occurs in creating a Custom Network Address when also assigning it to Network configuration. This issue is specific to Windows 10 and using Internet Explorer.

To workaround this issue, a Custom Network Address can be created from the Custom Network Address search page and then it can be assigned to a network configuration.

25162681

An ADF exception occurs when adding resources to an available reservation. This issue is specific to Windows 10 and using Internet Explorer.

To workaround this issue you need to navigate from the specific resource summary page to the reservation search page. You can then act on the reservation and add the resource.

25026235

The ”Go to Page” functionality is not working for the IPv4/IPv6 search results page. This issue is specific to Windows 10.

You need to use next page button instead of specific page number.

24977838

The Connectivity name is hidden after requesting a ”Show as top” option and expanding the tree. This issue is specific to Windows 10 and using Internet Explorer.

This issue is specific to Internet Explorer. This functionality does not have issues on Firefox and Google Chrome browsers. With Internet Explorer you need to avoid requesting ”Hide Children” on the connectivity tree view.

24976302

You cannot move some windows in the application, such as error and add windows. This issue is specific to Windows 10 and using Internet Explorer.

This issue is specific to Internet Explorer and Google Chrome, but this is not a problem on Firefox. No work-around available.

24976332

You are not able to drag and adjust column lengths in the application. This issue is specific to Windows 10 and using Internet Explorer.

This issue is specific to Internet Explorer and Google Chrome, but this is not a problem on Firefox. No work-around available.

25095464

The name of the window is not changing after completing editing of any entity.

No work around available.

25237751

Conditions and Reservations are hidden in all entities while in Detach window mode.

No work around available.

23112771

IPv4 network search disappears on reset of saved search.

Restart the search from left navigator bar.

22232510

During rehoming, connectivities at the VC3 level are not listed in the Impact Items tab in Rehome section of the Project Details page.

Verify the state of VC4 riders manually to inspect the impacted items down the hierarchy.

22245246

The ruleset cache is not updated when a modified cartridge is deployed to UIM. Ruleset changes do not take effect.

Restart the UIM application.

21830824

While upgrading to Release 7.3.1, you see an error stating that you are unable to revoke permissions for uimuser.

You can ignore this error. If you continue with the installation, UIM is deployed successfully.

21360819, 21360796

When you modify and redeploy rule sets containing Java or Groovy code, the modifications are not applied to the custom.ear file.

Redeploy dependent applications after you make such modifications.

19048380

When a network includes a rider pipe consuming multiple TDM connectivities, network node deletion fails.

Node deletion works correctly if the rider is a channelized connectivity rather than a pipe.

13813260

The Map View page displays a blue screen displayed when opened from the Recent Items menu.

In some cases, when you return to the Map View page by using the Recent Items menu, a blue screen is displayed rather than the correct content.

You can open the Map View page normally from the Network Summary page.

10242392

System allows the creation of duplicate IDs.

When you create ranges of equipment or logical device entities, IDs that duplicate existing entities can be created.

To avoid this issue, ensure to specify ID ranges that do not duplicate existing entities.

Note: This issue does not apply to telephone number range creation.

27014521

UIM Installation fails with Oracle Database 12.2.0.1 and the following exception occurs:

ORA-28040: No matching authentication protocol

In 12.1, the default value for the SQLNET.ALLOWED_LOGON_VERSION parameter has been updated to 11, which means that database clients using pre-11g JDBC thin drivers cannot authenticate to 12.1 database servers unless the SQLNET.ALLOWED_LOGON_VERSION is set to the old default value of 8.

As a result, the Oracle RAC database 10.2.0.5 creation using the Database Configuration Assistant (DBCA) fails with the ORA-28040 error in 12.1 Oracle Automatic Storage Management (ASM) and Oracle Grid Infrastructure environments.

Before installing UIM, do the following:

1. Add the following properties in the ORACLE_HOME/network/admin/sqlnet.ora file:

SQLNET.ALLOWED_LOGON_VERSION_SERVER=8
SQLNET.ALLOWED_LOGON_VERSION_CLIENT=8

2. Restart the database.

27217464

If you create a flow identifier and assign it to an EVC network in configuration version 1, and then in configuration version 2, if you unassign the flow identifier and try to assign another flow identifier, a duplicate configuration item is created.

No workaround available.

27212759

The network service instantiation fails for VNFs imported using TOSCA YAML for the following reasons:

- In Design Studio, the Dependent Cartridge version of the OracleComms_NSO_BaseCartridge and OracleComms_NSO_BaseTags cartridges is set to 7.3.5.0.0 for the imported VNF and network service cartridges.

- The ipVersion parameter is missing in the virtual-link elements in the network service descriptor XML file of the imported network service cartridge.

For the network service instantiation to be successful, do the following in Design Studio:

- Update the Dependent Cartridge version of the OracleComms_NSO_BaseCartridge and OracleComms_NSO_BaseTags cartridges to 7.4.0.0.0 for the imported VNF and network service cartridges.

- Edit the imported network service descriptor XML file, and add the ipVersion parameter in all the virtual-link elements.

Documentation Accessibility

For information about Oracle's commitment to accessibility, visit the Oracle Accessibility Program website at http://www.oracle.com/pls/topic/lookup?ctx=acc&id=docacc.

Access to Oracle Support

Oracle customers that have purchased support have access to electronic support through My Oracle Support. For information, visit http://www.oracle.com/pls/topic/lookup?ctx=acc&id=info or visit http://www.oracle.com/pls/topic/lookup?ctx=acc&id=trs if you are hearing impaired.

Oracle Communications Unified Inventory Management Release Notes, Release 7.4

E88056-01

Copyright © 2012, 2017, 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, then the following notice is applicable:

U.S. GOVERNMENT END USERS: Oracle programs, including any operating system, integrated software, any programs installed on the hardware, and/or documentation, delivered to U.S. Government end users are "commercial computer software" pursuant to the applicable Federal Acquisition Regulation and agency-specific supplemental regulations. As such, use, duplication, disclosure, modification, and adaptation of the programs, including any operating system, integrated software, any programs installed on the hardware, and/or documentation, shall be subject to license terms and license restrictions applicable to the programs. No other rights are granted to the U.S. Government.

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 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 about 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 unless otherwise set forth in an applicable agreement between you and Oracle. 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, except as set forth in an applicable agreement between you and Oracle.

Oracle Legal Notices

Copyright Notice

Copyright © 1994-2019, Oracle and/or its affiliates. All rights reserved.

License Restrictions Warranty/Consequential Damages Disclaimer

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.

Warranty Disclaimer

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.

Restricted Rights Notice

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, then the following notice is applicable:

U.S. GOVERNMENT END USERS: Oracle programs, including any operating system, integrated software, any programs installed on the hardware, and/or documentation, delivered to U.S. Government end users are "commercial computer software" pursuant to the applicable Federal Acquisition Regulation and agency-specific supplemental regulations. As such, use, duplication, disclosure, modification, and adaptation of the programs, including any operating system, integrated software, any programs installed on the hardware, and/or documentation, shall be subject to license terms and license restrictions applicable to the programs. No other rights are granted to the U.S. Government.

Hazardous Applications Notice

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.

Trademark Notice

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 trademarks of Advanced Micro Devices. UNIX is a registered trademark of The Open Group.

Third-Party Content, Products, and Services Disclaimer

This software or hardware and documentation may provide access to or information about 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 unless otherwise set forth in an applicable agreement between you and Oracle. 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, except as set forth in an applicable agreement between you and Oracle.

Pre-General Availability Draft Documentation Notice

If this document is in public or private pre-General Availability status:

This documentation is in pre-General Availability status and is intended for demonstration and preliminary use only. It may not be specific to the hardware on which you are using the software. Oracle Corporation and its affiliates are not responsible for and expressly disclaim all warranties of any kind with respect to this documentation and will not be responsible for any loss, costs, or damages incurred due to the use of this documentation.

Private Pre-General Availability Draft Documentation Notice

If this document is in private pre-General Availability status:

The information contained in this document is for informational sharing purposes only and should be considered in your capacity as a customer advisory board member or pursuant to your pre-General Availability trial agreement only. It is not a commitment to deliver any material, code, or functionality, and should not be relied upon in making purchasing decisions. The development, release, and timing of any features or functionality described in this document remains at the sole discretion of Oracle.

This document in any form, software or printed matter, contains proprietary information that is the exclusive property of Oracle. Your access to and use of this confidential material is subject to the terms and conditions of your Oracle Master Agreement, Oracle License and Services Agreement, Oracle PartnerNetwork Agreement, Oracle distribution agreement, or other license agreement which has been executed by you and Oracle and with which you agree to comply. This document and information contained herein may not be disclosed, copied, reproduced, or distributed to anyone outside Oracle without prior written consent of Oracle. This document is not part of your license agreement nor can it be incorporated into any contractual agreement with Oracle or its subsidiaries or affiliates.

Documentation Accessibility

For information about Oracle's commitment to accessibility, visit the Oracle Accessibility Program website at http://www.oracle.com/pls/topic/lookup?ctx=acc&id=docacc.

Access to Oracle Support

Oracle customers that have purchased support have access to electronic support through My Oracle Support. For information, visit http://www.oracle.com/pls/topic/lookup?ctx=acc&id=info or visit http://www.oracle.com/pls/topic/lookup?ctx=acc&id=trs if you are hearing impaired.