Netcool/Precision IP README
Build 3.6.0.22

Introduction
============
This README contains information on issues fixed in Netcool/Precision for IP Networks 3.6.0.22

For more information about V3.6 please refer to the latest version of the Release Notes

This build should be used with the Solaris 8/9/10 for SPARC, Redhat Enterprise Linux 3.0, AIX 5.3, Windows XP Professional and Windows 2003 Server operating systems.

Prerequisites and Installation
==============================

Netcool/Precision IP 3.6.0.22 is available as separate fix packs for Solaris, AIX, Windows and Redhat Linux.

For more information on prerequisites and minimum recommended system requirements, refer to the Netcool/Precision IP 3.6 Release Notes and Installation and Deployment Guide.

Known Issues with V3.6 (V3.6.0.22)
==================================
IY96323	50090	TIMEDSTITCHER ABORTS WHEN NUMBER OF MESSAGES EXCEEDS THE LIMIT OF RENDEZVOUS BUS
-----------------------------------------------------------------------------------------------------------
	46761	PortChannel membership is not discovered on Cisco 3500 devices.


Summary of Fixes for V3.6 (V3.6.0.22)
=====================================
	18749	ncp_disco must give an appropriate error message when an agent library is missing
-----------------------------------------------------------------------------------------------------------
Updated the code so that it would check for library, incase of both compiled and combined agents. Before, when any library of a combined agent was missing the ncp_disco was not reporting it.

	22918	Cisco Devices discovered and placed in Device class instead of Cisco class hierarchy
-----------------------------------------------------------------------------------------------------------
Device is categorised as Cisco BPX device and repective aoc files are updated.

IY88491	43562	DEVICES NOT BEEN FOUND/CONNECTED IN TOPOVIZ    HUAWEI NE08E AND  CISCO 3745
-----------------------------------------------------------------------------------------------------------
If the device is post VRP 3 then the StandardSwitch agent will now get the data required from the device.

	48834	Bug in Perl APIs ncp_disco_agent access to DNS and ARP queries causing errors when request fails
-----------------------------------------------------------------------------------------------------------

	48850	Timed stitcher threading problem downloading cache from ncp_dh_snmp
-----------------------------------------------------------------------------------------------------------
The monitor timed stitcher could sometimes use the community strings from verSecurityTable instead of the cached values from the SNMP helper at startup, while the data was being transferred from the SNMP helper. This will no longer happen unless the SNMP helper is not running.

IY94356	49160	REDISCOVERING A DEVICE VIA NO SNMP ACCESS INTERFACE CAN ERASE  PREVIOUS DISCOVERED DATA USING SNMP ACCESS ENABLED INTERFACE
-----------------------------------------------------------------------------------------------------------
Fixed rediscovery issue where data was lost if SNMP accessible device was rediscovered via a non-SNMP accessible IP.

	49538	Minor improvement to perl SDK access to cache files.
-----------------------------------------------------------------------------------------------------------
Minor improvement to Perl SDK access to cache files.

IY97225	50640	TIMEDSTITCHERS NEED LOG FILES W/O USING INSERT TO MONITORSCHEMA
-----------------------------------------------------------------------------------------------------------
Modified the ncp_monitor binary so that it launches (via ncp_ctrl) ncp_m_timedstitcher with a -debug option.  The debug level will be that of ncp_monitor.  So any value assigned to ncp_monitor's -debug switch in CtrlServices.cfg will also be used by ncp_m_timedstitcher processes.

IY99016	51444	NCP_STORE CORE DUMPS UPON FAILING SANITY VALIDATION DURING  DATA MIGRATION FROM DISCOVERY DATABASE TO MODEL
-----------------------------------------------------------------------------------------------------------
fixed by allowing ncp_store to ignore the same record  and log where validation is failing and continue further processing instead of aborting.

IY99192	51547	SUBNETS NOT CREATED DUE TO DUPLICATE IP, EVEN THOUGH DUPLICATE  IP IS ON A PE'S VRF INTEFACE.
-----------------------------------------------------------------------------------------------------------
A new m_SubnetFiltering option has been added to disco.config to provide fine control over what to include as part of a subnet. See DiscoSchema.cfg for details.

	51770	Telnet  Helper failing to establish the connections with any devs
-----------------------------------------------------------------------------------------------------------

IY99713	51780	MPLS AGENTS SHOULD CREATE IMPOSITION DATA ENTRIES EVEN FOR  LABEL-LESS PATHS
-----------------------------------------------------------------------------------------------------------
Modified so that the MPLS agent will  not drop the MPLS paths where there is not a label.

	52541	[SVT] disco's instrumentation.ipAddresses not being refreshed on Full Redisoc
-----------------------------------------------------------------------------------------------------------
Fix issue where on FullDiscovery, GUI discovered IPs, subnets doesn't update.

	52893	Add pstack and gcore to cc_Toolbox and fix X11R6 entry in PATH in bash script
-----------------------------------------------------------------------------------------------------------

	52918	Update the gateway to handle interface events having LocalPriObj="ospfIfEntry.192.168.1.2.0" and alike
-----------------------------------------------------------------------------------------------------------
Fixed if you upgrade to Nckl 1.4 and get the latest versions of Precision, but only from 3.6 and upwards.

IZ02412	53007	COMPAQ PROLIANT BL P-CLASS GBE INTERCONNECT SWITCH SWITCHES CAN  RETURN MASSIVE AMOUNTS OF SNMP DATA AND MAKE NCP_DH_SNMP CORE
-----------------------------------------------------------------------------------------------------------
Compaq ProLiant BL p-class GbE interconnect switches are no longer analysed by the StandardSwitch agent.  This is because they can make the SNMP helper go into an infinite loop.

IZ03912	53436	AMOS CORE DUMP DURING TOPOLOGY UPDATE.
-----------------------------------------------------------------------------------------------------------
AMOS could core dump during a topology update if a topology record in the previous topology was corrupt. This affected all versions, but is now fixed.

IZ04308	53576	ALL ICONS DISPLAYED IN A ROW & SOME VIEWS ARE BLANK IN A TWO  TIER MYSQL ARCHITECTURE
-----------------------------------------------------------------------------------------------------------
This was a defect within the error handling code when a saved view was updated. Blank views no longer get saved and therefore all devices do not end up in a line.

	53605	HuaweiMPLSTelnet agent produces incorrect data on devices partially lacking RT data
-----------------------------------------------------------------------------------------------------------
HuaweiMPLSTelnet agent now supports VPN configurations that don't have both import and export route targets



Known Issues with V3.6 (V3.6.0.21)
==================================
IY96323	50090	TIMEDSTITCHER ABORTS WHEN NUMBER OF MESSAGES EXCEEDS THE LIMIT OF RENDEZVOUS BUS


Summary of Fixes for V3.6 (V3.6.0.21)
=====================================

IY89596	46263	Incorrect entry for OSPF trap  in NcoGateInserts.cfg - wrong precendence and wrong bucket	
-----------------------------------------------------------------------------------------------------------
The following entry exists in the file NcoGateInserts.cfg:

insert into config.precedence values (900,   "LinkDownIfIndex", "SNMPTRAP-IETF-OSPF-TRAP-MIB-ospfTxRetransmit");

BUT the entry should be as follows (precedence should be zero not 900)

insert into config.precedence values (0,     "NbrFail",         "SNMPTRAP-IETF-OSPF-TRAP-MIB-ospfTxRetransmit");

The OSPF event SNMPTRAP-IETF-OSPF-TRAP-MIB-ospfTxRetransmit is not of type LinkDown but is merely an event saying that a neighbour is trying to reconnect that has previously failed.  It should have a precedence of 0 because this event should never suppress anything else.

IY93382	48822	CISCOOSPFTELNET AGENT INTRODUCING OUTPUT IN THE WRONG FORMAT  	
-----------------------------------------------------------------------------------------------------------
OSPF discovery agents modified to both support multiple neighbours per interface and to correctly parse sub interfaces in telnet data. This avoids an OQL insert error and ensures OSPF neighbours are assigned to the correct interfaces.

IY94108	49124	LAYER 3 CONNECTIVITY IS SHOWING THROUGH IN THE LAYER 2 VIEW  	
-----------------------------------------------------------------------------------------------------------
To improve the topology Cisco Switch agents now treat VLAN interfaces as virtual even when ifType is not propVirtual (53) (i.e. when the device applies the ifType of the underlying interface to the virtual interface).

IY95151	49449	INPACKETERROR AOCDEFINEDTHRESHOLD USES 75% CPU 3.6.0.13	
-----------------------------------------------------------------------------------------------------------
Performance improvements to the monitor timed stitcher process.

IY95268	49518	CHECKINTERFACESTATUS.STCH ASSUMES IF IFOPERSTATUS IS THERE MEANING THE IFINDEX WILL BE THERE - THIS ASSUMPTION IS WRONG	
-----------------------------------------------------------------------------------------------------------
Improved handling of poor snmp response in the stitchers ( handling of valid ifOperStatus but invalid ifIndex responses ).

IY96578	50222	GATEWAY FAILS TO PROCESS EVENTS WHICH CONTAIN 	
-----------------------------------------------------------------------------------------------------------
The Precision Gateway fails to process evens which contain back slash \ characters in their Identifier field. A code change to the Precision Gateway was made to use a second \ character to escape the first.
	
50290	Missing MPLS router links	
-----------------------------------------------------------------------------------------------------------
When Ping Verification was enabled Precision would prevent ping polling (as desired) but would also prevent some stitchers processing the interface (unexpected side affect). This has been fixed: When Ping Verification is selected (disco.config) it will only affect polling.

IY96912	50377	MODEL HAS DUPLICATE DEVICE, ENTITYTYPE = 1 3.5.0.26  	
-----------------------------------------------------------------------------------------------------------
Stitchers modified to avoid duplicate device creation during device rediscovery via a newly added IP.

IY96913	50381	TIMEDSTITCHER EXITS IF LATENCY TOO LOW  	
-----------------------------------------------------------------------------------------------------------
The monitor stitchers now gracefully handle the situation where the latency is too low for them to download the topology from model at startup.

IY96979	50459	The ASRetProcessing does not update the workingEntities table  with AddressSpace values as it is supposed to  	
-----------------------------------------------------------------------------------------------------------
The ASRetProcessing does not update the workingEntities table with AddressSpace values as it is supposed to.  Because of this, the connectivity is incorrectly created  between different address spaces (all empty=not set).  The line:
 m_WorkAddress = eval(text,'$name');"    has been changed to:    
 "m_WorkAddress = eval(text,'$uniqueAddress');"    in ASRetProcessing stitcher

IY97928	50861	NO VPN CONNECTIONS 3.5.0.29  MODEL_TO_MYSQL BUG  	
-----------------------------------------------------------------------------------------------------------
Sometimes Layer 3 views and MPLS VPN views in Topoviz would not show all the expected connectivity.    The problem was caused because inserts are made to the Layer3Connectivity table used by Topoviz in batches of 300 rows.  Batch inserts are used to improve performance.    However, in the event of 1 row violating the primary key on the table, the entire batch insert fails, potentially losing 299 rows of data.    ncp_model_to_mysql has been altered to check for duplicates before adding an insert into a batch when processing layer 3 connectivity.

IY97935	50862	THE TELNET HELPER NOT WAITING FOR RESPONSE OF SHOW COMMAND  
-----------------------------------------------------------------------------------------------------------
Fix to problem with NAT download of cisco routers due to regular expression '?' character being interpreted as a help request.

IY98591	51248	MODELTOMYSQL MIGRATION WILL BE UNSUCCESSFUL WHEN THERE IS NO  COLUMN PRESENT FOR ANY RECORD I.E EXTRAINFO->M_BASENAME
-----------------------------------------------------------------------------------------------------------
ncp_model_to_mysql modified to allow processing of interface records which lack ExtraInfo->m_BaseName data. Previously such records would result in inserts into MySQL failing.

IY98703	51372	SNMP LINK STATUS POLLS CONSUMES ALL CPU  	
-----------------------------------------------------------------------------------------------------------
Fixed problem with encoding of negative numbers in ASN packets.
	
51392	NortelPassport and ASAgent incorrectly defined as NAT agents.	
-----------------------------------------------------------------------------------------------------------
The NortelPassport and ASAgent are currently defined as NAT agents which they are not. This leads to the NAT discovery having issues with the data from these agents. The fix is simply to modify their agent type to an accurate value

IY99109	51519	CDP/FBD DATA FOR UNDISCOVERABLE DEVICE WRONGLY USED  	
-----------------------------------------------------------------------------------------------------------
To aid resolution of topology in cases where links are to inaccessible devices with an IP address that also exists on an accessible device, a new option 'verifyDeviceId' has been added to CDPLayer.stch. This should be set to 1 if the user feels incorrect links are occuring at the edge of their network to core devices. A similar fix has been added to the SwitchFdbToConnections.stch, though no user intervention is required to this particualr fix.

IY99192	51547	SUBNETS NOT CREATED DUE TO DUPLICATE IP, EVEN THOUGH DUPLICATE  IP IS ON A PE'S VRF INTEFACE.	
-----------------------------------------------------------------------------------------------------------
A new m_SubnetFiltering option has been added to disco.config to provide fine control over what to include as part of a subnet. See DiscoSchema.cfg for details.
	
51701	On AIX, New Library libNCPCrypt.so is not added in "setup_run_as_setuid_root.sh" script	
-----------------------------------------------------------------------------------------------------------
This library is now added on AIX as per the other supported platforms.
	
51705	A few subnet objects can be lost on a multiple cycle discovery	
-----------------------------------------------------------------------------------------------------------
Due to an error in the RecreateScratchTopology.stch stitcher, it was possible for some subnet objects to be lost from the topology both on multiple cycle discoveries, and also on partial rediscoveries.    This error has now been corrected, and no subnet objects should be lost now.

IY99729	51781	ncp_ncogate sometimes terminated unexpectedly when failing over from PRIMARY to BACKUP  	
-----------------------------------------------------------------------------------------------------------
ncp_ncogate sometimes terminated unexpectedly when failing over from PRIMARY to BACKUP.  This occurred because if the ObjectServer failed-over at a crtitical moment, although the failover was correclty detected, the old connection was not always properly shutdown and this prevented a new connection from ever being established, causing ncp_ncogate to terminate. The lost connection handle is now always correctly shutdown and cleaned up.
	
IY99831	51873	REDISCOVERY OF A DEVICE IN NAT ENVIRONMENT DOESN'T BRING  COMPLETE RESULTS OF ENTITY DUE TO MISSING ADDRESSSPACE ID	
-----------------------------------------------------------------------------------------------------------
Update to discovery to better support partial rediscovery in NAT environments.

IZ00327	52114	RCA CORRELATION DOESN'T HAPPEN WHEN ATM LINK IS DISCONNECTED DUE  TO MISMATCH OF IFDESCR OF AN ENTITY IN THE TOPOLOGY	
-----------------------------------------------------------------------------------------------------------
Certain events on ATM interfaces, such as OSPF ADJCHG events, were not getting correctly assigned to interfaces but were remaining on the main node/chassis.  This affected AMOS in that the RCA would be incorrect, in particular, events of this type were not getting downstream or connected suppressed when they should.  What tended to happen was that these events would become severity 3 (MINOR/Yellow) rather than becoming suppressed and Purple because they were incorrecetly put on the main node. (They can never be root cause because these OSPF events have a precedence of zero.) The AMOS RCA rule files were modified slightly to ensure that events are correctly handled for ATM interfaces.  The file InterfaceOrModuleEventToAlert.rule and it's Clear event counterpart were all that was modified.

IZ00711	52185	model_to_mysql doesn't create layer3 or MPLS connectivity when m_Active=2 in the model database.  	
-----------------------------------------------------------------------------------------------------------
model_to_mysql doesn't create layer3 or MPLS connectivity when m_Active=2 in the model database. The problem results in certain devices not being transferred to mysql, this means topology and connectivity diagrams appear incorrect. This is changed now so that m_Active = 2 is not filtered out of the connectivity by ncp_model_to_mysql.


Summary of Fixes for V3.6 (V3.6.0.20)
=====================================

IY88385	44965	UNEXPECTED CARD/PORT/IFINDEX DATA RETRIEVED FROM CISCO SWITCH 26  00
-----------------------------------------------------------------------------------------------------------
Cisco Switch agents enhanced to support the card/port numbering scheme of 2620 routers with switch functionality.

IY91360	47952	MIB BROWSER DOESN'T WORK.  2ND NCP_D_HELPSERV PROCESS CAUSED IT.  
-----------------------------------------------------------------------------------------------------------
The Disco GUI was starting a second ncp_d_helpserv. This has now been fixed.

IY92197	48288	IN A MULTI-TIER SETUP IT'S NOT POSSIBLE TO GET  THE SYMPTOM OR  ROOT CAUSE EVENTS FOR AN ALARM ON THE TOP LEVEL.
-----------------------------------------------------------------------------------------------------------
In a multi-tier setup with collection object servers and central object server it was not possible to right click and view the symptom or root cause events for an alarm on the top level.
The Webtop right click tool was modified to pass the "ServerSerial" and "ServerName" fields to the CGI script and the CGI script was modified to use these fields to look up the root cause or symptom events.

IY93735	48969	NCOGATE PRINTS ERROR MESSAGES IN DEBUG 0, IF HEALTHCHECK EVENTS  HAS MISSING VALUE FOR NMOSEXTRAINFO->NCPDOMAIN COLUMN.
-----------------------------------------------------------------------------------------------------------
In the Precision 3.6 code stream the warning was demoted to debug level 1.

IY94764	49284	CISCOSNMPSWITCH AGENT IS IGNORING THE STATIC FDB ENTRIES  
-----------------------------------------------------------------------------------------------------------
Static FDB entries were ignored previously so Precision IP could not resolve the connectivity between two statically connected devices.
Precision IP will now consider that some users configure their switches to have static entries, which point to different devices. Precision IP wil no longer ignore static fdb entries, rather it will  check whether the static entry is pointing to a different device or the same device. If it's the same device we ignore, otherwise we consider it for connectivity

IY95453	49589	PARTIAL REDISCOVERY FROM GUI DOES NOT WORK  
-----------------------------------------------------------------------------------------------------------
The nodes being entered in the Partial Rediscovery text area stopped being stored as a side effect to another fix.

IY95659	49667	XMLDUMP DATA IS TOO LARGE FOR THE GUI.  "SHOW DETAILS" ERROR.  
-----------------------------------------------------------------------------------------------------------
Previously, the XMLDump field in the MySQL database, used to implement the "show details" feature in Topoviz, was truncated at 65534 characters.  This was too short for some devices.    ncp_model_to_mysql has now been altered to adjust the point at which it truncates this data to be half the max_allowed_packet setting of the MySQL server.  Therefore, if you find that "show details" is not working for some devices, it is possible to tune your MySQL database to resolve the problem.    To alter the max_allowed_packet setting, edit the file $NCHOME/platform/solaris2/mysql4.1/data/my.cnf, and find the line that says "max_allowed_packet = 1M".  Then increase the value, e.g. change 1M to 5M.  If MySQL is running, it is also necessary to change this setting in the running database.  This can be done by logging on as root and running the query "set @@global.max_allowed_packet=5000000;" (the 5000000 can be set to another value if desired).    Then stop and restart Precision to re-migrate the topology to MySQL.

IY95748	49715	HUAWEI MPLS SUPPORT FOR PRECISION IP IS NOT PROVIDED  
-----------------------------------------------------------------------------------------------------------
New MPLS layer 2 & layer 3 VPN telnet based discovery agent for Huawei devices.

IY97503	50652	Search for seed " does not work for interfaces table"  
-----------------------------------------------------------------------------------------------------------
While using "Device Search" tool, when users search for records in interface table no records are returned even though there is data in the table.
The SQL query is updated and will produce valid data from interface table.

IY98964	51363	Create a utility to encrypt plain text passwords
-----------------------------------------------------------------------------------------------------------
Problem: User credential in configuration files are stored in plain text.
The user credentials, such as SNMP community strings and Telnet passwords, for accessing network devices are stored in plain text within configuration files. This presents a security risk as anyone with read access to the file system will be able to read the passwords.
A code change has been made to allow all passwords entered via the Discovery Configuration GUI to be written to disk in an encrypted form. This feature is not used by default and must be configured in the file named ConfigSchema.cfg

IY95591	49635	POLLING STATUS IS NOT WORKING IN V3.6  
-----------------------------------------------------------------------------------------------------------
When multiple poll definitions have the same AgentKey, only those that have PollStatus = 1 will be enabled. Those with PollStatus = 0 will not be enabled.

IY96744	50311	SUBNETTOIPLAYER.STCH CAUSES NCP_DISCO TO CORE DUE TO ERROR IN  COMPARISION CODE WHEN ATTEMPTS TO SORT SUBNET RECORDS
-----------------------------------------------------------------------------------------------------------
Fixed occasional ncp_disco abort caused by issue in the SubnetToIPLayer stitcher related to the sorting of subnet records involving address space fields

45100	Ability for GUI to change SNMP and Telnet port
-----------------------------------------------------------------------------------------------------------
Telnet Port and SNMP Port can be configured via the Disco Admin GUI.



Summary of Fixes for V3.6 (V3.6.0.19)
=====================================
IY92533 (48376 48300 48313)  Stitching is taking longer than expected on a 6000 device network	
-----------------------------------------------------------------------------------------------------------
The CDPLayer, CreateScratchTopology, PostLayerProcessing and AddSwitchRouterLinks stitchers have been made more efficient/scalable. As a result, Vlan stitching performance has also been improved (Vlans with subnet 0.0.0.0 are now treated as unresolved Vlans).    In addition there was a typographic error in AddSwitchRouterLinks.stch which previously prevented it from processing RSM links

IY94223	49132	NETWORK VIEWS GENRATES HTTP STATUS 500 ERROR WHEN BROWSER LACALE  SET TO ANY OTHER LANGUAGE APART FROM UK/US/JAPANESE LANGUAGES
-----------------------------------------------------------------------------------------------------------
When the users use locale other than english or Japanese, the locale can't find property files. In this case the locale is set to null instead of using default local
	
IY93157	48726	MODELTOMYSQL CAUSES BATCH UPDATES FAIL DUE TO DUPLICATE ENTRIES  IN THE LAYER 3 CONNECTIVITY TABLE BECAUSE OF MULTINET INTERFACES	
-----------------------------------------------------------------------------------------------------------
Fix for issue with multinet interfaces causing duplicate layer 3 connections and hence causing batch inserts to fail due to primary key violations.

48917	Alcatel 6800 Switch Device Support (FIT's OR0112072747)	
-----------------------------------------------------------------------------------------------------------
Alcatel 6800 switches were not discovered correctly. The switch does support the dot1q data that the StandardSwitch agent uses but it has a minor inconsistency in it's mib response that prevents us from adding the remote neighbours. The dot1qFdbPort entry gives us the port for a particular vlans forward database table. We then usually use dot1dBasePortIfIndex to translate the port entry to an actual ifIndex. In the Alcatel 6800 devices however the dot1qFdbPort is actually the ifIndex. The StandardSwitch agent has been modified to retrieve the FDB data from the Alcatel devices.

IY88273	44032	PRECISION - ROOT CAUSE ANALYSIS LOGIC IS FAULTY - AMOS (INTERFACE EVENT IS RAISED ON MAIN NODE BECAUSE TOPOLOGY HAS INTERFACE MI
-----------------------------------------------------------------------------------------------------------
Amos can give incorrect RCA results when an event is generated by a chassis that relates to an interface that has not been discovered.  

This is because Amos has little choice but to treat this event as being on the chassis instead of the interface.  An event on a chassis has more power to suppresses that does an event on an interface, hence RCA is sometimes incorrect in this situation.

This has been fixed in Precision IP 3.6 now through a new AMOS rule that has been written.
	
45835	Investigation into use of ifName in syslog rules and RCA
-----------------------------------------------------------------------------------------------------------
The requirement was to add a clause similar to:  ...and ExtraInfo->m_IfName =... in the filter section of InterfaceEventToAlert and InterfaceClearEventToAlert.

This involved adding a new OR section to the AMOS rules to make use of m_IfName (the short name) in the event record and the topology record, and a new event map is required in NcoGateSchema.cfg as well as the new entries in config.precedence that will make use of the new event map.
	
IY94953 48201	Re-work batch update threading in MODEL to prevent deadlocks	
-----------------------------------------------------------------------------------------------------------
The ncp_model process has been seen to deadlock when operating with NfAM 2.0 on Linux. Once ncp_model is deadlocked it will not respond to queries from other processes like ncp_oql. The problem was found to be a threading issue which could potentially happen in other circumstances but is thought most likely to occur when exporting data for NfAM 2.0.

IY94933 48224	Bug in decoding of SNMPv3 REPORT PDUs can cause excessive retries	
-----------------------------------------------------------------------------------------------------------
The SNMP stack has been changed to correctly interpret SNMPv3 REPORT PDUs.  Previously it would fail to decode these, leading to excessive retries and increased discovery times.  Now it interprets them as meaning the device has refused to respond to the related SNMP request.

48470	SNMP link status polling of a single interface fails	
-----------------------------------------------------------------------------------------------------------
Fixed bugs that prevented the SnmpLinkStatus monitor stitcher from polling chassis with a single interface or individual interfaces.

48594	SNMP helper can fail when returning SNMPv3 access details	
----------------------------------------------------------------------
This has now been corrected.

48819	AocDefinedThreshold monitor timed stitcher abort
----------------------------------------------------------------------
Fix for potential AocDefinedThreshold monitor stitcher, to avoid potential failure.

IY93474	 48855	TWO CISCO SWITCHES USING THE CISCO SWITCH CLUSTERING FEATURE CAUSE RECURSIVE CONTAINMENT PROBLEM	
------------------------------------------------
The AddEntityContainment stitcher has been modified to avoid this problem. 

IY93490 48865 MISSING CONNECTIVITY BETWEEN CISCO & ALLIED TELESYN SWITCHES DUE  TO BUG IN SNMP IMPLEMENATION OF ALLIED TELESYN SWITCHES.
----------------------------------------------------------------------------------------------------------
Allied Telesyn switches don't necessarily start a walk of their FDB table at the beginning.  They appear to start after the last address returned, regardless of what is asked for in an SNMP GET NEXT request.  They can be made to start at the beginning by walking the table to the end, and then walking it again.    The AlliedTelesynATSwitch agent has now been altered to work around this bug by performing walks of the FDB table on Allied Telesyn switches twice, discarding the first (possibly incomplete) walk and using the second.

49301	Topoviz always fails licensing check within NGF 1.1	
----------------------------------------------------------------------------------------------------------
Topoviz always fails the licensing check within NGF v1.1 even if licensing has been configured correctly. This has been rectified.


Summary of Fixes for V3.6 (V3.6.0.18)
=====================================

48309 The Timed (LinkDowns) and Non-Timed (PingFails) Amos rules are faulty now that we have Isolation Points	
-----------------------------------------------------------------------------------------------------------
Link-down events have higher precedence than ping-fail events on the same interface and should therefore suppress the ping-fails. It was possible under certain circumstances for the ping-fails to suppress the link-downs. The AMOS rules have been modified to prevent this from occurring.


Summary of Fixes for V3.6 (V3.6.0.17)
=====================================
Internationalisation changes only


Summary of Fixes for V3.6 (V3.6.0.16)
=====================================

30435 Would like to optimise the SwitchStpToConnections	
-----------------------------------------------------------------------------------------------------------
Memory leak in STP agents fixed.  Issue resulting in false remote neighbor records (on Bay devices) and hence a performance hit during SwitchStpToConnections stitcher processing has been resolved.

IY88379 36468 Event enrichment and RCA does not work for a lot of events   	
-----------------------------------------------------------------------------------------------------------
The Details Discovery Agent was modified to populate the m_DNSName field in the topology model.

IY88300 37774 Processes are not re-started by ctrl when ctrl is run in slave mode.	
-----------------------------------------------------------------------------------------------------------
Fixed CTRL to make it restart any failed processes when it is running in slave mode.

41768 CiscoSwitchSnmp.agnt needs changing in order to work with Cisco IOS 12.0(5.X)XX versions.
-----------------------------------------------------------------------------------------------------------
The agent filters were updated to include the new versions

IY90339 41788 Inserts containing invalid regular expressions cause controlled  exit in ncp_disco	
-----------------------------------------------------------------------------------------------------------
Disco will now give a non-fatal a warning when there is an invalid regular expression.

IY88436 42240 GlobalStatusFilter does not work on network view tree  	
-----------------------------------------------------------------------------------------------------------
The setting "topoviz.globalstatusfilter" within topoviz.properties had no effect but will now be applied to all events shown within Topoviz.

IY88272 44974 Filter for network view can not be longer than 255 chars, the rest will be truncated.	
-----------------------------------------------------------------------------------------------------------
The user is no longer restricted to entering Network View filters of less than 256 characters per table.

IY88384 45024 Polling of suspended vlans produces a response from some cisco devices that cannot be decoded.	
-----------------------------------------------------------------------------------------------------------
The CiscoSwitchSnmp agent has been modified so that it will not attempt to download the FDB table for suspended VLANs.  There is no point in doing this, and it can cause errors if SNMPv3 is being used.

IY88460 45826 Recent change to checkInterfaceStatus.stch can result in unnecessary polling	
-----------------------------------------------------------------------------------------------------------
A new disco configuration option has been added to the disco.config table defined in etc/DiscoSchema.cfg m_PingVerification.

IY88420 45861 Web Disco GUI: incorrect filter definition in disco admin gui when more than 8  "like" operators used (pre discovery filters)
-----------------------------------------------------------------------------------------------------------
Restriction was lifted

IY87156 46390 NatTextFileAgent.agnt doesn't run for devices m_HaveAccess = 0  	
-----------------------------------------------------------------------------------------------------------
Modified NATTextFileAgent to support devices without SNMP access.

IY87830 46684 Not all mpls l2vpns are displayed  	
-----------------------------------------------------------------------------------------------------------
JuniperMPLSTelnet fixed to support layer 2 VPNs which share the same local site Id yet have different VPN names.  Prefer Telnet option added to JuniperMPLSTelnet.agnt to enable user to force telnet based discovery even in cases where SNMP data is available; this is of use where a device has a buggy SNMP implementation.

IY88013 46722 Changetime field in model shows future date in 3.5.0.19  	
-----------------------------------------------------------------------------------------------------------
A fix to prevent the ChangeTime field of master.entityByName having times in the future.

46899 Traceroute agent is sending UDP packet with the source port as 0	
-----------------------------------------------------------------------------------------------------------
The source port in UDP packets sent by the Traceroute agent can now be configured by setting m_UdpSrcPort in the DiscoPingFinderSchema.cfg configuration file.

IY89158 47243 An overflow caused by an snmp get bulk response packet being too large - poller crashes	
-----------------------------------------------------------------------------------------------------------
Upon ASN packet encoding, the buffer is dynamically extended when required.

IY89822 47442 ncp_df_ping core dumps during any rediscoveries (v3.6.0.11)  	
-----------------------------------------------------------------------------------------------------------
Core dump of ncp_df_ping fixed. Prior to fix ncp_df_ping could core if an OQL status request was issued following a rediscovery (the GUI issues these automatically).

IY90324 47595 AMOS functioning in-correctly:  containment-loop checking in AMOS was faulty  	
-----------------------------------------------------------------------------------------------------------
The detector for circular containment in Amos was not detecting all types of circular containment. This has now been fixed so that all types of circular-containment are detected by Amos and handled appropriately.

IY90286 47596 Handling Compaq nic card 0 ports without an ifIndex  	
-----------------------------------------------------------------------------------------------------------
Altered the BuildInterfaceName.stch file in all the builds ( 3.5, 3.5.1, 3.6, dev ) so that where we discover an interface with a card of 0 and no ifIndex we don't as at present ignore the interface but instead build an interface name based on an ifDescr style entry.

IY90375 47606 NATGatewayRetprocessing.stch incorrectly resolving the basename  of gateway.	
-----------------------------------------------------------------------------------------------------------
Minor change to NATGatewayRetProcessing to better resolve NAT gateways without DNS.

47612 Webtool (ncp_webtool) update for special characters in passwords and non-RFC compliant hostnames	
-----------------------------------------------------------------------------------------------------------
The webtools are now able to make use of special characters in passwords and non-RFC compliant hostnames, such as fred_blogs-03.

47613 StandardBgp agent leaks memory if target device has multiple IP addresses per interface	
-----------------------------------------------------------------------------------------------------------
Resolved memory leak which could occur in StandardBgp agent when discovering devices with multiple IP addresses per interface.

47628 StandardOSPF agent may leak memory while discovering some device configurations.	
-----------------------------------------------------------------------------------------------------------
Potential memory leak in StandardOSPF agent fixed,

47630 New agent to handle Alcatel VRRP devices.	
-----------------------------------------------------------------------------------------------------------
New  perl agent to handle the Alcatel 6800 devices implementation of the VRRP mib ( RFC 2878 ).

47713 Modification to AddEntityContainment to manage interfaces stating they are uncontained.	
-----------------------------------------------------------------------------------------------------------
Fix to the AddEntityContainment stitcher to handle interfaces  suggesting they are uncontained by anything.   

47759 During discovery ncp_disco outputs 'symbol does not exist:  ARG_1' error	
-----------------------------------------------------------------------------------------------------------
Improved 'stitcher symbol does not exist' error message to show the affected stitcher.  Fixed 'symbol does not exist' error for ARG_1 due to typo in PostLayerProcessing.stch.

47803 ncp_disco core during stitching due to a non-text m_SubnetMask field	
-----------------------------------------------------------------------------------------------------------
Fixed abort of ncp_disco due to some devices issuing corrupt subnet mask data.

47862 Perl API scripts can exit with message “ERROR: App Not Authenticated”	
-----------------------------------------------------------------------------------------------------------
Fixed the fact that in some rare circumstances scripts written using the Precision Perl API would unexpectedly exit with the message "ERROR: app not authenticated.".

48054  Inferring of PE devices to handle previously discovered PEs	
-----------------------------------------------------------------------------------------------------------
Improvements to the Inference of MPLS PE devices using BGP data on CE devices.



Known Issues with V3.6 (V3.6.0.15)
==================================
None identified

Summary of Fixes for V3.6 (V3.6.0.15)
=====================================

47406 On Linux, ncp_model_to_mysql cannot create the specified domain in MySQL DB at the time of installation.
---------------------------------------------------------------------------------------------------------------
This has been resolved and is no longer and issue with Linux installations

47299	Unable to get MIB Browser tree to display if first query fails
---------------------------------------------------------------------------------------------------------------
It was found that if the first query to find the MIB tree failed, the user is unable to refresh the tree without logging out. This has been resolved.

IY89153 47432	"NGF_SERVER STOP" SCRIPT DOESN'T STOP THE PROCESS COMPLETELY  
---------------------------------------------------------------------------------------------------------------
"ngf_server stop" command doesn't shut down the java process. This is due to a thread within Topoviz not stopping correctly. The thread causing the problem has been modified so that it no longer keeps the java process alive incorrectly.

47431	Manual updates to Model not reflected topoCache-Amos
---------------------------------------------------------------------------------------------------------------
The MODEL process fails to send out updates when manual changes are made on its database during an automatic topology update from the DISCO process. This has now been resolved


Summary of Fixes for V3.6 (V3.6.0.14)
=====================================

31751 Device certification of NetToNet and Paradyne DSLAM devices
-----------------------------------------------------------------------------------------------------------
New Device Support added for these devices.

36869 Some mappings in ModelToMysql.cfg are marked as optional, but removing them prevents the connectivity tables being created.
-----------------------------------------------------------------------------------------------------------
Correctly labelled optional fields in ModelToMysql.cfg.   Previously, some fields in the interfaces section were described as optional but removing them would cause topology transfer errors.  

37186 Certification needed for Cisco FastHub 400 Series Dual-Speed Intelligent
-----------------------------------------------------------------------------------------------------------
CiscoFastHub - New agent to handle Cisco FastHub400 intelligent hub devices. The agent downloads interface, port and connectivity information to deduce the connectivity of cisco fasthub 400 intelligent hubs.

38155 Addition of OSInfo Perl Discovery Agent
-----------------------------------------------------------------------------------------------------------
New Discovery Agent that extracts information about the OS running on a device.

39405 PingPolicy in ncp_monitorconfig File: ClassSchema.cfg
-----------------------------------------------------------------------------------------------------------
Updated polls used by ncp_monitorconfig's "Ping Monitoring Policy" to defaultChassisPing instead of the old defaultPing

40341 Is Precision Discovery and Monitoring Affected By Community String Change
-----------------------------------------------------------------------------------------------------------
The following two steps provide a means to allow Precision discovery and monitoring to dynamically pick up changes to community strings:
1) Send a HUP signal to the ncp_dh_snmp process. This will cause it to re-read the SnmpStackSecurityInfo.cfg file and pick up any newly added  or changed community strings.

2) Use ncp_oql on the "SNMPHelper" service to delete the desired entries from the cache to for a rediscovery. There are two variants of OQL which can be used    delete from snmpStack.verSecurityCache where m_HostName = '191.168.1.1';    will delete a single entry and force the re-discovery of the community string from 191.168.1.1  or:    delete from snmpStack.verSecurityCache;    which will delete the entire cache and force a re-discovery of all SNMP community strings. Note that this could result in a large number of authentication failure traps as each possible community string will be tested against each device.

40470 Requirement to be able to specify non-default telnet ports for telnet agents.
-----------------------------------------------------------------------------------------------------------
Allows the telnet helper to query devices through the non-default telnet port - port can be configured on a per device basis.

42867 Lack of SHA support
-----------------------------------------------------------------------------------------------------------
SHA-1 can now be selected as an authentication method for SNMPv3.  This is configurable by setting m_SNMPVer3Details->m_AuthType in snmpStack.verSecurityTable in the SnmpStackSecurityInfo.cfg file.  This is a string field and has two possible values: 'MD5' or 'SHA1'.  If unspecified, MD5 is used.

43087 Port channel discovery on Cisco using telnet agent
-----------------------------------------------------------------------------------------------------------
The existing CiscoSwitchTelnet agent has been enhanced to extract port channel memberships using telnet. The agent was already able to extract this data where SNMP support was provided.

43941 The servicestate in CTRL of the ncp_config process is  2 (awaiting heartbeat)
-----------------------------------------------------------------------------------------------------------
ncp_config remains in service state 2 when run under CTRL. Service state 2 indicates that CRTL has started up the ncp_config application but is awaiting a heartbeat from it. ncp_config can now enter service state 4 (running).


44344 Add support for discovery of virtual connection endpoints on Marconi ASX/TNX devices
-----------------------------------------------------------------------------------------------------------
A new agent, ForeSysSPVC, is available.  This will discover the start and end points of virtual channels on Marconi ASX series switches.


45244 Search list in Topoviz Hop View not sorted by name but random order
-----------------------------------------------------------------------------------------------------------
Search Results Lists in Topoviz were in a random order. They are now ordered.

45584 Fixing a bug in the GetDiscoCache.pl script
-----------------------------------------------------------------------------------------------------------
Modified GetDiscoCache script. Time stamped tar ball of disco cache now placed in $NCHOME/log/precision directory

45590 Rediscovery stitching not consistent with full discovery stitching for CMTS and Nortel Passport devices
-----------------------------------------------------------------------------------------------------------
The CMTS and Nortel Passport data layers have been added to the RecreateAndSendTopology.stch stitcher to ensure consistency and prevent potential unnecessary rediscovery activity.

45816 To add an option to Cisco switch discovery agents to enable the user to tell the agents to ignore CDP data
-----------------------------------------------------------------------------------------------------------
If the scoping section is uncommented in the following files
CiscoSwitchSnmp.agnt
CiscoSwitchTelnet.agnt

Then the CiscoSwitch have the following effect based on the differnt values of GetCDPData
 
if scoping section is specified and GetCDPData = 0, no CDP data will be retrieved for the device

if  scoping section is specified and GetCDPData = 1, CDP data will be retrieved for the device

if section is removed/commented out, CDP data will be retrieved for the device by default.

45820 Enhancement request for Precision to handle changes to ActiveX under http://support.microsoft.com/kb/912945
-----------------------------------------------------------------------------------------------------------
Due to an update to Internet Explorer the Topoviz applet required an extra click in order to use it. A different technique has now been used to start the applet so that this extra step is no longer required.

46037 Entity Names consisting entirely of numbers cause problems in Topoviz
-----------------------------------------------------------------------------------------------------------
Numeric entity names could not be used as a seed within the Topoviz Hop View. This has now been fixed.

46111 In Disco GUI - NAT devices are prefixed with their address space names, but the 1.1.4.x devices aren't.
-----------------------------------------------------------------------------------------------------------
Improved the CiscoNATTelnet data retrieval to filter PAT entries.


IY87158 46149 Devices missing due to m_UniqueAddress not appearing in ipAddrTable
-----------------------------------------------------------------------------------------------------------
A new config option is available in the Advanced tab of the Disco Config GUI and in disco.config - m_AllowVirtual. This can have a value of 0, 1 or 2. 0 means virtual IP's are not processed, 1 means they are and 2 means they are if they are specified to be allowed in the new scope.special table (see below). By virtual we mean an IP address that exists on a device but does not show up in that devices IP table. Technically all IP addresses on a device should show up in it's IP table but this isn't always the case.

A new table has been defined in DiscoSchema.cfg with the inserts defined in DiscoScope.cfg. The table is called scope.special. It has a similar format to scope.zones but all entries are assumed to include entries. For each scope entry you can define whether IPs within that scope are management IPs, IPs which we allow to be virtual or which are out of band. The main purpose of this table is to allow us to define an IP address or range of IP address as those we allow to be virtual and/or management IPs and/or out of band.

translations.ipToBaseName has been changed to include for a specific IP whether it is a management IP and whether it is out of band.

Several changes have been made to the stitchers to utilise these new tables. IpToBaseName.stch has been altered to use these tables and to call two new stitchers. CheckValidVirtual.stch determines if the incoming IP address is allowed to be virtual. CheckIfMgmtAddress.stch checks if the given IP address is a management address.

BuildFinalEntityTable/RebuildFinalEntityTable.stch have been altered to use a new stitcher, NamingViaManagementInterface.stch. This means that if you have defined a management interface for a device we will attempt to name the entity by the corresponding name for that interface if appropriate. The stitcher AddDefinedManagementAndOutOfBand is also now called in these stitchers and will update the workingEntities.finalEntity records to denote whether an interface or chassis has a management or out of band IP address. The intention is that the AOCs can then be altered as necessary to only poll either/or management and out of band interfaces.

Finally PostLayerProcessing.stch has been altered to call a new stitcher - RemoveOutOfBandConnectivity.stch. This stitcher removes connections on out of band interfaces. The intention is to prevent the out of band management network interfering in the root cause analysis of the customer network. This stitcher can however be disabled in the usual way if necessary.


IY88319 46176 UPPER CASE CHARACTERS ARE BEING IGNORED IN THE CONVERSION OF THE  
-----------------------------------------------------------------------------------------------------------
Certain passwords were incorrectly stored by ncp_model_to_mysql, resulting in it not being able to connect to the MySQL database.  Passwords that were incorrectly stored included (but were not limited to) those beginning with the capital letter "A".

ncp_model_to_mysql has now been updated to correctly store these passwords.


46304 Bug in ncp_dh_telnet line handling for console prompt
-----------------------------------------------------------------------------------------------------------
Improved the telnet helpers handling of line feeds and carriage returns.


46361 L3ConnVisual table not created
-----------------------------------------------------------------------------------------------------------
There was a problem with the creation of the tmp table using neighbors instead of neighbors_tmp. This has been resolved.


46638 Providing example stitchers to create objects to represent an inaccessible 3rd party network within the customer network
-----------------------------------------------------------------------------------------------------------
Added some example stitchers to the contrib directory detailing how a stitcher could be used to infer the existence of an inaccessible provider network. In the example given the provider network is assumed to be an MPLS L3 network with BGP running on the CE to retrieve details of the PE devices.

46775 Problem with the handling of vlan containment on routing switches leading to poor RCA
-----------------------------------------------------------------------------------------------------------
Change to AddVlanContainers.stch to better handle vlan containment on routing switches.

46883 AuthType in SNMP setting of Disco Configuration Manager reverts to MD5 when SHA is selected.
-----------------------------------------------------------------------------------------------------------
SHA-1 can now be selected as an authentication method for SNMPv3.  This is configurable by setting m_SNMPVer3Details->m_AuthType in snmpStack.verSecurityTable in the SnmpStackSecurityInfo.cfg file.  This is a string field and has two possible values: 'MD5' or 'SHA1'.  If unspecified, MD5 is used.

46943 ncp_model_to_mysql can drop MPLS view connectivity due to duplicate inserts
-----------------------------------------------------------------------------------------------------------
Resolved ncp_model_to_mysql issue with MPLS views where connectivity could be lost in situations where a duplicate table insert was performed.


47120 and 47244 ncp_ncogate aborts if it loses a connection to the ObjectServer and cannot reconnect immediately
-----------------------------------------------------------------------------------------------------------
In versions of Precision 3.6 prior to this fix, there was a problem with ncp_ncogate if it lost its connection to the ObjectServer.  The intended behaviour if this happens is that ncp_ncogate tries to reconnect every 30 seconds until it succeeds.  Instead it was just trying to reconnect once and then aborting.    The correct behaviour has now been restored to ncp_ncogate in Precision 3.6.  It will now attempt reconnections to the ObjectServer indefinitely, matching the behaviour of 3.5 and earlier versions.

47142 Merged contrib ASCII device viewer to 3.6 branch
-----------------------------------------------------------------------------------------------------------
This contrib tool provides an ASCII representation of a devices inventory/physical containment.


IY89116 47177 NCP_F_AMOS CRASHES IF PRESENTED WITH A TOPOLOGY WITH RECURSIVE  CONTAINMENT
-----------------------------------------------------------------------------------------------------------
Previously ncp_f_amos could not accomodate a topology that included circular containment (i.e. entity A contains entity B and entity B contains entity A).    This issue is now resolved and ncp_f_amos will process such a topology. However, the accuracy of the RCA could still be impacted by such invalid topologies.

