Cisco Prime Network Registrar IPAM 8.3.0.1 Release Notes

Available Languages

Download Options

  • PDF     (358.2 KB)
    View with Adobe Reader on a variety of devices
Updated:May 27, 2017

Bias-Free Language

The documentation set for this product strives to use bias-free language. For the purposes of this documentation set, bias-free is defined as language that does not imply discrimination based on age, disability, gender, racial identity, ethnic identity, sexual orientation, socioeconomic status, and intersectionality. Exceptions may be present in the documentation due to language that is hardcoded in the user interfaces of the product software, language used based on RFP documentation, or language that is used by a referenced third-party product. Learn more about how Cisco is using Inclusive Language.

Table of Contents

Cisco Prime Network Registrar IPAM 8.3.0.1 Release Notes

Contents

Introduction

Before you Begin

How to Apply IPAM 8.3.0.1 Patch

Important Notes

Cisco Prime Network Registrar IPAM Bugs

Resolved Bugs

Enhancement Features

Open Caveats

Using the Bug Search Tool

Related Documentation

Accessibility Features in IPAM 8.3.0.1

Obtaining Documentation and Submitting a Service Request

Cisco Prime Network Registrar IPAM 8.3.0.1 Release Notes

May 29, 2017

Note: Cisco Prime Network Registrar IPAM 8.3.0.1 patch can only be applied on an existing installation of IPAM 8.3 (8.0.33 build). To apply the patch on IPAM 8.1.2/8.1.3, you MUST first upgrade it to IPAM 8.3. After you have upgraded to IPAM 8.3, you can apply the IPAM 8.3.0.1 patch. To learn about how to apply the patch on IPAM 8.3, refer to How to Apply IPAM 8.3.0.1 Patch.

These release notes provide an overview of the fixed and open defects in IPAM 8.3.0.1, describe how to apply the patch, and how to access additional information about known problems in IPAM 8.3.0.1.

Note: You can access the most current IPAM documentation, including these release notes, online at:
http://www.cisco.com/en/US/products/ps11808/tsd_products_support_series_home.html.

Introduction

IPAM is a comprehensive software solution that helps organizations plan and maintain their IP address space and leverages that information for use by IP services such as DNS and DHCP.

IPAM is a next generation tool that offers advanced functionality:

■Centralized planning and management of the complete address space down to the individual IP address level

■Centralized DNS and DHCP configuration management

■IPv4 and IPv6 support

■Automated address utilization collection and reporting

■Address utilization forecasting and trending analysis

■APIs and Command Line Interfaces for integration with any type of system. Examples are work-flow systems, provisioning systems, change management systems, or network management systems.

Unlike other tools that maintain IP name and address data as discrete information maintained uniquely and separately, IPAM interacts with network devices and services to:

■Verify that the actual network matches the information in IPAM

■Capture and record utilization information to be able to establish historical trends

■Reclaim inactive addresses

This interaction not only maintains consistency between the planned and deployed network, but allows proactive modification to the network to adjust for IP address shortages and overages.

Before you Begin

For information on installing IPAM, refer to Cisco Prime Network Registrar IPAM 8.3 Installation Guide.

To start using the IPAM Management System, all IPAM services and the IPAM database must be started.

IPAM is licensed separately from Cisco Prime Network Registrar DHCP, DNS, and Caching DNS. When installing IPAM, you will be asked to install as a separate process using a separate license key. To receive the IPAM license, you must purchase IPAM, either individually, or as part of a Cisco Prime Network Registrar suite.

How to Apply IPAM 8.3.0.1 Patch

Note: This patch will upgrade the IPAM 8.3 version from 8.0.33 to 8.0.47 build. When this patch is applied, though the product version number remains as IPAM 8.3, the build will be upgraded from 8.0.33 to 8.0.47.

Note: For customers running mysql db replication - this patch DOES update the db. Therefore you will need to rem (#) the read_only line from the my.cnf file ON THE SLAVE EXEC ONLY, restart mysql for effect in order to apply this patch. Then, after the patch is installed, remove the # sign and restart mysql. You should not have to re-set up replication as patch installations only take IPAM services offline for a short time. Monitor your http://PRIMARYEXECIP:8080/incontrol/ReplmonStats.html page after the patch is installed. If you have further questions on this, open a support ticket.

Generic Instructions to Install Patches:

The IPAM 8.3.0.1 Upgrade/Patch Utility is designed to help users automatically upgrade or patch their systems and automatically backup existing data at the same time.

Patch upgrades are when the ‘incontrol.jar’, ‘incontrol.war’, ‘inc-ws.war’ files are replaced and the originals are backed up. In some cases, files that do not reside within the.war or.jar files are also applied and the originals are backed up. Or just.sql updates are applied against the database to assist with obtaining new features.

An “in-place” upgrade is when a new version of IPAM is applied and the database schema is also upgraded to the new version. The original.war and.jar files, along with the database, are backed up.

Note: All original files will be backed up automatically to INCHOME/tmp/backup-<dateofupgrade>.

Note: Oracle users must manually backup their database before starting an upgrade. Contact your DBA for assistance.

Unix Instructions for Upgrade/Patching Tool:

Note: All commands should be run as incadmin.

1. Download the file cpnr_8_3_0_1-ipam-unix-patch.gtar.gz, copy it into /tmp directory of the IPAM Executive system, and extract the file.

2. Navigate to /tmp/cpnr_8_3_0_1-ipam-unix directory.

3. Run the following command:
. /opt/incontrol/etc/shrc (Notice the space after the dot.)

4. From /tmp/cpnr_8_3_0_1-ipam-unix, run the following command:
sh PNR83Upgrade-8.0.24-8.0.47-unix-1.bin

For restoring your original files/db

1. Run the following command:
. /opt/incontrol/etc/shrc

2. From /tmp/cpnr_8_3_0_1-ipam-unix, run the following command:
sh restore.sh INCHOME/tmp/<directory to restore>

Example: sh restore.sh /opt/incontrol/tmp/backup-<dateofupgrade>

Windows Instructions for Upgrade/Patching Tool:

1. Download the file cpnr_8_3_0_1-ipam-windows-patch.exe and copy it into C:\temp directory of the Executive server.

2. Extract the file into C:\temp directory.

3. Open a DOS prompt window and run the following command:
cd C:\temp\cpnr_8_3_0_1-ipam-windows-patch

4. Run the following command:
“c:\Program Files (x86)\Cisco\Cisco Prime Network Registrar IPAM\etc\shrc.bat”

5. Run RunUpgrade.exe.

For restoring your original files/db:

1. Open a DOS prompt window and run the following command:
cd C:\temp\cpnr_8_3_0_1-ipam-windows-patch

2. Run the following command:
“c:\Program Files (x86)\Cisco\Cisco Prime Network Registrar IPAM\etc\shrc.bat”

3. Run the following command:
restore.exe “INCHOME\tmp\<directory to restore>”

Example: restore.exe “c:\Program Files (x86)\Cisco\Cisco Prime Network Registrar IPAM\tmp\backup-<dateofupgrade>”

Important Notes

This patch includes the support for configuring SHA1-AES as SNMPv3 Privacy Protocol while adding a network element in IPAM. For more information, see CSCve12635.

Cisco Prime Network Registrar IPAM Bugs

For more information on a specific bug or to search all bugs in a particular IPAM release, see Using the Bug Search Tool.

This section contains the following information:

■Resolved Bugs

■Enhancement Features

■Open Caveats

■Using the Bug Search Tool

Resolved Bugs

Table 1 lists the key issues resolved in the IPAM 8.3.0.1 release.

 

Table 1 Resolved Bugs in IPAM 8.3.0.1

Bug ID
Description

IN-16572

In place upgrades fail when adding a duplicate constraint

IN-16611

AddChildBlock - IPv6 - Sparse allocation is not working, seems to be getting next available every time

IN-16624

Unable to use wildcard owner with ImportDeviceResourceRecord

IN-16626

Fix potential database deadlock involving Deleting IP Addresses and DNS Push tasks

IN-16628

Deleting hundreds of devices with Resource Records can take several minutes

IN-16647

ISC DHCP ‘set’ policy dictionary entry removed on upgrade to 6.0 and beyond

IN-16653

Search Device fails with HibernateException when previous search was sorted by Ipaddress

IN-16654

Advanced Search by Individual Objects returns a search count by devices but not IP addresses

IN-16681

Low Pool Report is not displaying Address Pools, but is displaying Blocks

IN-16698

Patch installer doesn’t handle changes to incinitdata.sql

IN-16762

Export to edit on Advanced Device Search by address type throws an error

IN-16777

DHCP 4.3 SQL script does not migrate user defined options from DHCP 3.x or 4.1

IN-16806

Doing a Full Server Configuration push with defined options to a CNR 8.3 Caching server fails with an exception

IN-16835

Swagger UI - Email address for support incorrect

IN-16870

@ symbol not interpreted correctly for DDNS updates

IN-16882

Search device with a selected container: Export for editing returns an empty file

IN-16884

Export Device CLI with -de and another filter throws org.springframework.jdbc.BadSqlGrammarException

IN-16891

Forward, Stub and Static-Stub zones should be allowed for Non-Managed domains

IN-16932

Advanced search preferences do not work when searching for an IP Address that returns a block

IN-16933

The GUI should prevent a user from deleting a Free block that is the only child of an Aggregate

IN-16935

Submitting a change to a block via Block Edit, after a failed attempt to Delete a block saves invalid blocks

IN-16943

[Invalid field value for field “view”.] When attempt to add a DNS Domain (only first attempt)

IN-16977

While adding a Child Container within Container Maintenance, the current selected Container is not displayed as Parent Container, but its Parent

IN-16984

DHCP File Generation - Server’s subnet appears twice if it is part of a network link (shared-network)

IN-16990

ImportDeviceResourceRec fails when importing a CNAME for other A records

IN-17002

Ignore DDNS Errors and Warnings flag is not honored for Failover DHCP server file generation

IN-17003

Ignore DDNS Errors and Warnings flag is not shown in the task summary

IN-17011

Can bypass Policy setting on Net Service by typing name

IN-17015

Router Discover fails when CIDR size provided for IPV4 addresses

IN-17032

ImportAdmin API does not update lastupdate column when an admin is modified

IN-17041

GetContainer API getContainerByName method throws NullPointerException when no container name specified

IN-17046

gsstsig-interceptor & gsstsig-updater scripts look for /opt/incontrol/conf/appliance.tag

IN-17067

The DetachBlock API can leave the database connection in a pinned state

IN-17076

Search function retains its Container value when Reset should have cleared it

IN-17077

Search result window is unable to change its sort order

IN-17083

Cannot access IPControl GUI via an IPv6 address on port 8080. Port 8443 works

IN-17087

Administrator Activity Audit report date filter uses wrong timezone

IN-17093

Advanced Search for Block or Devices: cannot clean up a selected container

IN-17103

Memory Leak in DaysLeftRegression

IN-17107

Device search by UDF using the default value in the search causes an Exception - Oracle only

IN-17115

Adding a child container can reset the “Maintain History Records” flag on the parent container

IN-17118

Administrator with restricted Access Control in Policy to child container of IPControl cannot add child container

IN-17130

SSL Updates required for Sweet32 vulnerability

IN-17135

CNR DHCP Collection differences are not always accurate for network links and interfaces

IN-17143

ImportServiceSnapshot performance suffers due to always looking for block containing addrpool

IN-17146

DNSListener fails zone transfer after MySQL wait_timeout (default 8 hours) has expired

IN-17149

Swagger Client URL Encodes username and password

Enhancement Features

Table 2 lists the key enhancement features added in the IPAM 8.3.0.1 release.

 

Table 2 Enhancement Features in IPAM 8.3.0.1

Bug ID
Description

CSCve12635

IPAM - unable to use SHA1-AES as the SNMP V3 privacy protocol

IN-16602

Add checkbox for DHCP Pushes to “Ignore Dynamic DNS Errors and Warnings”

IN-16659

DHCP Collection performance enhancement - optimize snapshot creation query

IN-16662

Allow ImportDevice CLI/API to support GetNextAvailable logic for multi-homed devices

IN-16851

Block Subnet Policy tab should show default gateway and primary WINS server even if DHCP not licensed

IN-16885

Device search by UDF takes too long and results in a timeout exception

IN-17009

Improve performance of Block Utilization Report

IN-17105

Improve the performance of the Appliance Dashboard query

IN-17159

Improve BaseTestRestServer to allow concurrent test suites

Open Caveats

Table 3 lists the open caveats in the IPAM 8.3.0.1 release.

 

Table 3 Open Caveats in IPAM 8.3.0.1
Bug ID
Description

CSCvb25366

DNS64 priority gets duplicated when creating objects through IPAM

CSCvb45951

MySQL Critical Patch Update for July 2016

Using the Bug Search Tool

Use the Bug Search tool to search for a specific bug or to search for all bugs in a release.

1. Go to http://tools.cisco.com/bugsearch.

2. At the Log In screen, enter your registered Cisco.com username and password; then, click Log In. The Bug Search page opens.

Note: If you do not have a Cisco.com username and password, you can register for them at http://tools.cisco.com/RPF/register/register.do.

3. To search for a specific bug, enter the bug ID in the Search For field and press Return.

4. To search for bugs in the current release:

a. Click the Search Bugs tab and specify the following criteria:

b. In the Search For field, enter Prime Network Registrar IPAM 8.3 and press Return. (Leave the other fields empty)

c. When the search results are displayed, use the filter tools to find the types of bugs you are looking for. You can search for bugs by status, severity, modified date, and so forth.

Note: To export the results to a spreadsheet, click the Export All to Spreadsheet link.

Related Documentation

See Cisco Prime Network Registrar IPAM Documentation for a list of IPAM 8.3 guides.

Accessibility Features in IPAM 8.3.0.1

All product documents are accessible except for images, graphics, and some charts. If you would like to receive the product documentation in audio format, braille, or large print, contact accessibility@cisco.com.

Obtaining Documentation and Submitting a Service Request

For information on obtaining documentation, submitting a service request, and gathering additional information, see the monthly What’s New in Cisco Product Documentation, which also lists all new and revised Cisco technical documentation, at
http://www.cisco.com/en/US/docs/general/whatsnew/whatsnew.html

Subscribe to the What’s New in Cisco Product Documentation as an RSS feed and set content to be delivered directly to your desktop using a reader application. The RSS feeds are a free service. Cisco currently supports RSS Version 2.0.

Cisco and the Cisco logo are trademarks or registered trademarks of Cisco and/or its affiliates in the U.S. and other countries. To view a list of Cisco trademarks, go to this URL: www.cisco.com/go/trademarks. Third-party trademarks mentioned are the property of their respective owners. The use of the word partner does not imply a partnership relationship between Cisco and any other company. (1110R)

Any Internet Protocol (IP) addresses used in this document are not intended to be actual addresses. Any examples, command display output, and figures included in the document are shown for illustrative purposes only. Any use of actual IP addresses in illustrative content is unintentional and coincidental.

© 2017 Cisco Systems, Inc. All rights reserved.

Was this Document Helpful?

FeedbackFeedback

Contact Cisco

This Document Applies to These Products