RIVERBED PRODUCT RELEASE NOTES
Product: SteelCentral NetIM
Release Date: September 1, 2021
Version: 2.4.0
1) Contents
7) Issues Fixed in NetIM 2.4.0
2) About SteeelCentral NetIM
Riverbed® SteelCentral™ NetIM is an integrated solution for mapping, monitoring, and troubleshooting your IT infrastructure. With NetIM, you can capture infrastructure topology information, detect performance issues, map application network paths, diagram your network, and troubleshoot infrastructure problems. Additionally, you can manage infrastructure issues within the context of application, network, and end-user experience for a blended view of overall performance.
NetIM provides agentless infrastructure component monitoring to deliver a comprehensive picture of how your infrastructure is affecting network and application performance and how that impacts end-user experience. NetIM offers a broad overview of how the devices on your network are performing to complement your network and application performance management visibility. NetIM includes:
· Real-Time Monitoring – NetIM leverages multiple approaches (e.g., synthetic testing, SNMP, CLI) to identify new and changed infrastructure components.
· Analytics – Measure current performance and identify violations.
· Topology and Paths – Visualize and triage issues quickly.
· Troubleshooting – Search-based workflows and on-demand network paths help you to quickly identify and troubleshoot infrastructure performance issues.
· Event and Alert Visibility – Configure alerts based on metric threshold violations, syslogs, and traps and use the Alerts page to view, filter, and drill-down into details.
· Reporting – Report on infrastructure inventory, configuration, and performance metrics.
3) About NetIM 2.x
Riverbed® SteelCentral™ NetIM version 2.x represents a major change from previous releases in terms of scalability, software architecture and deployment. NetIM 2.x is provided as multiple OVAs (“virtual appliances” containing both operating system and NetIM application) for installation on VMware ESXI 6.5, 6.7, and 7.0 hypervisors. Native cloud images for Azure and Amazon Web Services are also available. NetIM 2.x’s underlying operating system support is Ubuntu 18.04.2. Before installing NetIM 2.4.0, thoroughly review the system requirements document and installation guide. If you are migrating from NetIM 1.x, also review the migration guide. If you are updating from NetIM 2.3.1, review the ISO update guide.
4) What’s New in NetIM 2.4.0
· Alerting & Notification
o Enhanced Alerts Manager supporting “Active Alerts”
o Alert Suppression
§ Site-based Alert Suppression
§ Site Gateway Configuration
· Reporting
o Business Hours Support
§ Business Hour-aware Roll-up
§ Business Hour-aware Reporting
o Report Export Scheduling for Performance Summary Reports
o Wireless LAN Controller Metrics
§ WLC Statistics (default)
§ WLC SSID Statistics (default)
§ WAP Statistics (default)
§ WLC Mobility Statistics
§ WAP Channel Statistics
§ WAP Ethernet Statistics
o Group Status
o Site Gateway Status
o F5 Throughput
· IP SLA Views
o All Tests page
o Tests by Site & Group tab
o Tests by Device tab
· Enhanced Synthetic Test Visualization
o Dedicated view for each Synthetic Test
o Launch to Synthetic Test view
· Custom Views Enhancements
o Gauge support
o Histogram support
· Usability
o Device Manager
§ per-user views via column customization
o Legacy Alert page alerts table
§ Interface alerts rendering speed improvement
§ Full csv export support
o Rollup Wizard
§ Rollup retention periods
· 3 months (90 days) for raw samples
· 24 weeks for hourly samples
· 104 weeks (2 years) for daily samples
o Portal REST API support
§ Synthetic Test TCP Port and other configuration properties are now available in Portal
§ “*” searches in Portal now perform a model-wide search in NetIM in order to provide all objects
o WebUI User Experience
§ Progress Indication while client-side model is initializing/bootstrapping
§ Client-side model bootstrapping relaxed for direct launch from NetProfiler and Portal for IP Address Search page, Device page, Group page, and Site page
· Supportability
o NetIM Infrastructure
§ Swarm Service Out-of-Memory HPROF visibility and download per service
§ System Uptime support
§ Targeted remapping support
o netimsh docker subnet checks
§ ipscan command
o Improved reporting correctness in Device Polling Statistics Details
· Security & Vulnerability Updates
o Java updated to OpenJDK 1.8.0_302
o Webserver updated to Tomcat 8.5.69
o Cassandra updated to 3.11.10
o Ubuntu 18.04 LTS kernel and package updates
- NOTE: All NetIM VMs will be rebooted as part of the ISO update process. Please plan accordingly and request appropriate permissions in your organization.
5) Important Notices
· NetIM’s WebUI is subject to change without notice. Resource location in the web application app may change from release-to-release. Any external bookmarks or links to content embedded in iframes will need to be updated post-upgrade.
· SteelCentral Portal Support
o Support for REST API integration (shown in Portal data sources as “NetIM”) and support for the legacy DCL integration (shown in Portal data sources as “NetIM <2.3.0”) are supported.
§ You should refrain from connecting NetIM to Portal using both integrations simultaneoulsy. Both integrations are available for migration purposes, but should not be used simultaneously, except in a limited manner to enable migration to the REST integration.
§ Enabling multiple active Portal integrations simultaneously or multiple active Portals simultaneously to the same NetIM for extended periods of time will increase load on NetIM and is not supported.
· “app.sh EXPORT_METRICS” and “app.sh EXPORT_SYNTHETIC_TEST_METRICS” scripts are deprecated in NetIM 2.x.
o REST APIs should be used to extract metrics.
6) Future Deprecations
· SteelCentral Portal and NetIM now support integration via REST APIs (shown in Portal data sources as “NetIM”). Support for the legacy DCL integration (shown in Portal data sources as “NetIM <2.3.0”) is expected to be deprecated in the future. If possible, you should plan to migrate your existing Portal Dashboards to the new integration over the course of 2021.
7) Issues Fixed in NetIM 2.4.0
· NETIM-7603 Synthetic test should drill down directly to test details
· NETIM-7611 Poller Status UI takes a long time to render for large networks
· NETIM-9004 Add scoped Alert Summary/Details visualizations to the Monitored Path screen
· NETIM-9736 Prevent component-service create massive # of components for UDMs
· NETIM-9799 Report Piechart Section Selection Should Filter Report Tabular Content Display
· NETIM-10005 Support Checkpoint Bond Interfaces as Aggregate Interfaces
· NETIM-10289 A Hosts Vendor Should Be the ouiName.
· NETIM-10325 Exception while parsing Aruba device
· NETIM-10368 CLI Live Type Ahead does not work - TypeError: r.getClientRects is not a function
· NETIM-10543 Expose launch URLs to Portal
· NETIM-10951 NetIM missing Cisco MIBs in /lib/mibs/third-party/cisco/v4
· NETIM-11120 The Network Model Service indexer queue should be bounded to eliminate the potential for an OOM
· NETIM-11132 Add new H3C devices based on HH3C-PRODUCT-ID-MIB
· NETIM-11187 When changes are made to health profiles the health of the impacted elements should be recalculated within 1-2 polling cycles of those elements
· NETIM-11320 Object Types in Portal need to be updated when a new UDM is created/removed
· NETIM-11406 Alert Profiles - Creating alert profiles take longer as the number of alert profiles increases
· NETIM-11450 Ability to create, preview, save, recall, and delete search expressions (including interface filters)
· NETIM-11455 Portal launch back to NetIM for synthetic tests Test Details does not work
· NETIM-11501 File Comparison menus are slow to display when two large files are loaded for comparison
· NETIM-11548 Cloned used-defined metric shown with original name when viewed in Portal
· NETIM-11558 Topology - Object Actions menu is always on top of Topology Actions menu drop down
· NETIM-11659 Alert Profile editor buttons should not scroll
· NETIM-11690 Failure to collect/archive several F5 Config Files when using vt100 terminal. Other F5s work fine with vt100.
· NETIM-11716 Network Neighbors Full Screen work flow issue when going from Group Neighbors to Schematic Layout
· NETIM-11769 Device Manager - Menu item for Collect and Import should work for WMI enabled devices
· NETIM-11814 Restore Group Status and Availability to NetIM
· NETIM-11829 Log PowerShell cmds executed
· NETIM-11832 Site Topology Tab to Full-Page View Loads the Geographic Heatmap instead of Topology View
· NETIM-11840 Indicate Age of Detected IP host in table and backplane view via annotations to UI elements (annotation to Table, list or graph/backplane)
· NETIM-11855 Powershell generates numerous files in tmp folder
· NETIM-11872 Import from Active Directory should not set windows devices CLI to active/enabled
· NETIM-11874 Custom Views - Device View - Alert Summary panel will not delete unless Show Details selected
· NETIM-11918 Optimize the way we poll different properties in same WMI class
· NETIM-11942 SNMP Port Change does not get pushed to workers. Requires swarm upload to be performed.
· NETIM-11957 Topology View - Modifying any saved view changes the Created By time stamp to current time
· NETIM-11971 Poller History message for WMI failure indicates 'Device Not Reachable via SNMP'
· NETIM-11983 Only the first 100 alerts were exported by default in Legacy Alerts Manager
· NETIM-12004 RFE: A way to hide the local authentication tab on the login page instead of disabling it
· NETIM-12081 Support merge/patching of DeviceMap.txt such that user provided additions and modifications are preserved and merged with the latest deviceMap.txt
· NETIM-12086 Provide updated online documentation with 2.4.0
· NETIM-12118 Device Manager: Provide All "Names" Available for Display - DeviceName, SysName, HostName, Prompt, DisplayName
· NETIM-12124 Asynchronous PowerShell collection to improve performance
· NETIM-12142 Interface alerts tab take long time to load
· NETIM-12151 NetIM display overall weighted average availability of 100% for the entire month
· NETIM-12154 Generating too many REST API transactions to create Alert Profiles results in too many open files in system
· NETIM-12158 Default Heapsize for Network Metric Import Should be increased
· NETIM-12159 Performance Reports not working for Device Availability reports with time periods greater than one day
· NETIM-12160 Heatmap group filtering not working correctly.
· NETIM-12161 Custom View edit modal jumps to the top of the screen when toggling input switches
· NETIM-12166 Display the local server engine id in hex along with ascii on the notifications snmp configuration modal dialog windows
· NETIM-12169 Incorrect alert profile name appears in Email and Syslog notification messages when using basic notification template for device object.
· NETIM-12170 Syslog notification is not working in case of using invalid notification template for device object.
· NETIM-12182 Missing alerts in Alert Manager when receiving notification for some devices
· NETIM-12196 SNMP Port Change and other settings do not get pushed to workers and services re-started
· NETIM-12197 Improve Scalability of PowerShell-based WMI Poller by Using Async Job-Based approach
· NETIM-12203 Alerts table should provide component info when metric violation is by a specific component
· NETIM-12238 ANP Calculation Should Allow Complete Re-calculation Option ("Do Not Use Cache" Option)
· NETIM-12265 Grouping Rules - when choosing a Filtered Network the condition "equals to" doesn't work properly and the criteria is not matched
· NETIM-12268 Nightly chain keeps taking longer to complete, then AUX causes a restart and it goes back to faster Nightly Refresh Times but then repeats the same symptom
· NETIM-12290 AppNetwork Path show iproute command for F5 TMOS devices does not display route
· NETIM-12315 AppNetwork Path show ip route command for Steelhead device isnt working
· NETIM-12334 With active/standby F5 pair AppNetwork Path should pick active one
· NETIM-12337 Need to add get SNMP bulk exclusion for Cisco ASR1002HX
· NETIM-12426 Alert Profiles - User and Restricted role should not be able to click 'Add' button
· NETIM-12478 The Search bar in "Apply to Synthetic Test" section of Alert Profiles does not work.
· NETIM-12499 NetIM Infrastructure - Distinguish between Manager and DM for 'Cassandra' listings
· NETIM-12520 NetIM Infrastructure - When a service is down, downloading logs never completes or gives msg service down
· NETIM-12527 netimsh commands for swarm hprof listing, harvesting, pruning
· NETIM-12538 If you choose a different splunk template and make it default, it does not get applied correctly
· NETIM-12549 NetIM Infrastructure - Graphs y-axis values should not have exceedingly long entries
· NETIM-12558 SNMP community string is not propagated to the Workers after AutoConfig
· NETIM-12563 Would like to group by country in addition to country code in Portal with NetIM 2.3.1 REST integration
· NETIM-12566 NetIM Infrastructure - Services tab - Add capability to sort columns
· NETIM-12584 Discovery with Active Directory can result in hang
· NetIM-12593 Model changes in NetIM 2.3.1 require that NetIM be removed as a data source in Portal, Portal re-started, and NetIM re-added as a data source. This is required for both DCL and REST integrations.
· NETIM-12621 Improve Model Deletion Workflow in Device Mgr
· NetIM-12639 Portal 3.5.0 dashboard panels created using NetIM 2.3.0’s REST API integration AND including User-Defined Metrics will need to be recreated upon upgrade to NetIM 2.3.1 due to a NetIM model change that affects User-Defined Metrics.
· NETIM-12641 Observed NPE in poller log after deleting UDMs
· NETIM-12648 View and download logs of stopped and failed service tasks and containers.
· NETIM-12650 Ability Trigger a thread dump to log via the Swarm Services UI
· NETIM-12651 hprof visibility and download
· NETIM-12660 After Delete UDM the associated Polling Profile "Last Modified" timestamp not updated
· NETIM-12663 SNMP community string is not propagated to the Workers after AutoConfig
· NETIM-12677 NetIM Infrastructure - Mobile view - enhancement request - ability to scroll to right on Advanced tab to see full msg
· NETIM-12712 Unable to login to VM after disk space issue, netimsh gets into a bad state
· NETIM-12721 With active/standby F5 pair the status is not set correctly after cfg import
· NETIM-12739 Handle mapping of deleted components within NMS
· NETIM-12742 NetIM sends out multiple crossing messages for same device when only one notification crossing is expected
· NETIM-12743 clear imported tags - should not clear the imported tags for the xml files.
· NETIM-12760 [Service Admin] The service log download should create a zip file of the task logs
· NETIM-12769 Collected Files should have a governor on the files size and provide a dialog that file is over limit
· NETIM-12796 Alerts table shows object name incorrectly as Ifc>SubIfc and csv export also shows it incorrectly. Need to include the SysName for context in the ObjectName
· NETIM-12816 WMI Discovery is getting into a hung state
· NETIM-12826 Fix the import_cert.sh in common so that certificates with any file name can be imported
· NETIM-12834 Add wmi-poller to netimsh scale command
· NETIM-12841 Synthetic test topN search is not working in Portal
· NETIM-12843 Portal Proxy Service always returns synthetic test results with type 'VNES_TEST' instead of their actual type
· NETIM-12846 Threshold Violation Tolerance drop-down in the Edit Alert Profile displays only first digit of numbers.
· NETIM-12853 QoS_Class_Map_Stats2 properties not displayed in Object Selection Wizard for Portal in REST Based Integration
· NETIM-12866 Block non-admin roles from accessing NetIM Infrastructure pages
· NETIM-12889 Filters are not working correctly in Portal when duplicated target URIs belong to different synthetic test profile name
· NETIM-12890 Need to expose synthetic test TCP port and other parameters as object property (facet) to Portal
· NETIM-12905 When running ISO update, check ssh idle time and warn the user or automatically set longer idle time temporarily
· NETIM-12908 Large database size causes the Save_Restore tool to generate hprofs
· NETIM-12926 WMI Discovery is locking all the discovery threads and causes the master schedule to stall
· NETIM-12948 Portal dashboard timeout when waiting for a response for a TopN request for a metric name with underscore in name
· NETIM-12952 Portal search for NetIM synthetic tests metric data failed on target application filters
· NETIM-12955 Synthetic Test Facets (as defined in SystemObjectTypeModel.res) Need to be Provided to Portal REST Integration
· NETIM-12956 HPROF cleanup / Max Number of HPROFs cronjob per container to avoid out-of-disk space
· NETIM-12957 Discovery service entered self preservation mode after network instability, following loss of DHCP Service.
· NETIM-12968 Global Discovery Settings Wizard has a "Previous" button on first page of wizard that causes issues if pressed
· NETIM-12977 Synthetic Tests need capability to show graph or table with history for success or failures
· NETIM-12985 Handle deletion of child components which are not pushed to index by logstash when deleting parent components
· NETIM-12989 F5 parser doesn't import interfaces
· NETIM-12999 NetIM opens a large number of files and causes a SocketException
· NETIM-13007 Portal topN searches do not correctly apply synthetic test filter fields when processing the search results
· NETIM-13019 Network Metric TopN is not returning the correct IdType for Synthetic Tests
· NETIM-13027 Use Devices API Enhancement to improve Device Manager responsiveness
· NETIM-13031 TopN uses an 'average' aggregation which does not take into account enum values correctly
· NETIM-13036 Add option to trigger a thread dump to the Swarm Services UI
· NETIM-13040 TopN search fails to return result for monitored path related metrics in Portal
· NETIM-13054 Poller Status should not show WMI device as successful when metrics start failing to be collected
· NETIM-13064 Group Required & Optional Services in separate tables in the NetIM Infra. Services tab to avoid confusion on overal NetIM LED status indicator
· NETIM-13116 Provide way to check for overlapping IP subnets in netimsh
· NETIM-13131 Clients reporting receiving "return to normal" without receiving over threshold alert
· NETIM-13166 Observed OSW error when Portal search for monitored path with bad URI address
· NETIM-13190 MIB-Based Collection of NetIM Core Model should use same logic for success/complete vs partial as swarm
· NETIM-13196 Elasticsearch OOM when performing Garbage Collection.
· NETIM-13197 Observed first notification for synthetic test is return to normal
· NETIM-13211 Revert to All Objects Search for Portal
· NETIM-13212 Revisit TopN response to enums, currently returns average for Portal, consider "last" value instead
· NETIM-13214 Need a time range selection for monitored path page
· NETIM-13219 Change WMI password columns to TEXT
· NETIM-13251 When selecting multiple objects in metrics page, it does not show line chart for individual objects separately
· NETIM-13299 Basic/Advanced ifType interface filters in Alert profiles aren't working as expected
· NETIM-13305 Avoid model bootstrapping when NetIM webUI is URL launched from other products such at NetProfiler or Portal
· NETIM-13307 Remove overhead of session summary stats in Devices API calls
· NETIM-13362 Portal proxy log show server exception when displaying rollup metric data for monitored path
· NETIM-13365 Observed Portal panel errors for some of the topN UDM dashboard panels after restarting Portal (see NETIM-13412)
· NETIM-13390 After SAVE_RESTORE import, device health by type shows sysObj IDs rather than device types
· NETIM-13391 General Settings page, SNMP Poller section, Timeout and Retries are greyed out in UI, cannot modify
· NETIM-13393 Handle stale model components from 2.3.1 when upgrading to 2.4
· NETIM-13411 NetIM is failing to persist the responses from an HTTP synthetic test with https://splunk.com as the target UR because the response is too large
· NETIM-13438 Increase NMS and Elastic Search Heapsize to 2GB for NetIM 2.4.0 GA
· NETIM-13439 Some devices stop receiving health metrics in UI
· NETIM-13462 Change WMITEST default to "Test Individual"
8) Known Issues
· NetIM-5148 NetIM does not support NetPlanner’s and NetAuditor’s “import network using an existing archive" feature.
· NetIM-7581 Default SNMP Trap receiver port is set to 8162 / Syslog receiver port is set to 8514. See KBA S33800.
· NetIM-8336 Generic Metrics Import collection interval changes require a NetIM core services restart
· NetIM-8483 Device Health will be unknown for devices that require more than 2 times their set polling interval to collect data. Contact Riverbed Global Support to modify this behavior.
· NetIM-8660 Site and Group level metrics cannot be imported via Generic Metrics Import
· NetIM-9236 "Configuration Changes - Last 7 Days" panel is limited to displaying 1000 changes per day.
· NetIM-9397 Default Alerts are controlled from the Metric Thresholds page and overwrite any changes made to the Default Alerts
· NetIM-9494 User-Defined Metrics (UDMs) and their polled data do not immediately appear in SteelCentral Portal after creation. You must restart SteelCentral Portal service after the User Defined Metrics are created. Allow approximately 10 minutes plus the polling frequency of the UDM for NetIM to map UDMs and provide data to Portal.
· NetIM-10284 Interface level syslog messages are mapped to Device level.
· NetIM-11018 Importing custom attribute values from file may generate an erroneous dialog indicating that not all entries were imported even though they are imported
· NetIM-11146 Interface related UDMs should be polled on the same schedule as standard out-of-the-box interface metrics in order to provide component names correctly
• NetIM-11184 WebDriver synthetic test with latest Chrome browser will require newer version of chromedriver
· NetIM-11206 Deleting thousands of devices from the network model via Device Manager is slow to complete. Contact Riverbed Global Support for alternatives if you wish to delete all devices.
· NetIM-11869 SNMP Polling History will indicate active devices for polling even if WMI polling is the only polling being performed. This is expected and due to the device status (ping) poller) being part of the SNMP poller.
· NetIM-11482 In some workflows, you may encounter an error when adding SAML IdP in Web UI but the configuration is persisted correctly and restarting NetIM Core Services causes the newly added IdP to be shown in the WebUI.
· NetIM-12830 Splunk notification certificate validation is disabled in Notification Sender in 2.4.0 such that Splunk sending will still work after 2.4.0 patch. Certificate validation for the Notification Sender can be re-configured after the 2.4.0 ISO patch is applied
· NetIM-13412 Portal panels created prior to 2.4.0 with a TopN search and that reference UDMs may be corrupted and require re-creation. Panels created using the Object Search Wizard (OSW) will not encounter this issue. Workarounds: In 2.3.1, create the UDM panels by first searching for those UDM objects in the OSW, and not through topN or re-create the panels after patching to 2.4.0.
· NetIM-13441 In 2.4.0, WMI polling will fail if the user account used for collection and polling does not have access to the Windows Service metric class. If there is a failure for one WMI metric class, then the entire job will fail. You can avoid this by either providing the WMI user account access to the Windows Service metric class or disable polling of the Windows Service metric class
9) Migration/Update
Migrating from NetIM 2.3.1
Seamless update from 2.3.1 is supported and preserves settings and data with minor exceptions. Refer to the “SteelCentral™ NetIM Virtual Edition ISO Update Guide” for detailed information on updating from NetIM 2.3.1.
Migrating from NetIM 1.5.x
Seamless “one-click” update from NetIM 1.x is not supported. However, settings and data may be migrated using export and import utilities. Refer to the “Migrating to NetIM 2.x” document for detailed information on migrating from NetIM 1.x. Before proceeding with migration, ensure that the Windows Settings for “Region and language” are set to “United States” and “English (United States)” on the NetIM 1.x system. The database backup/restore and settings backup/restore will fail if you do not follow this requirement.
If you are not interested in preserving settings and data, consider migrating only your device list. NetIM 1.x’s, NetCollector’s, and NetSensor’s device list file format is compatible with NetIM 2.x’s device list file format. The exported device list file can be imported into NetIM 2.x’s Device Manager via the Import option under the Import/Export menu or via the Add/Discover Devices wizard.
10) Software Requirements
NetIM supports local authentication as well as integration with SAML 2.0-compatible Identity Providers and TACACS+ servers.
See the NetIM System Requirements for complete installation requirements.
NetIM is compatible with SteelCentral NetPlanner, NetAuditor, Portal, UCExpert, and NetProfiler subject to certain limitations, version requirements, and required client modifications. Patches to other clients may be required for full compatibility.
See Knowledge Base Article S27459 on SteelCentral Interoperability and Knowledge Base Article S29125 for current compatibility and limitations.
11) Contacting Riverbed
Options for contacting Riverbed include:
· Internet - Find out about Riverbed products at http://www.riverbed.com.
· Support - If you have problems installing, using, or replacing Riverbed products, contact Riverbed Technical Support or your channel partner who provides support. To contact Riverbed Technical Support, please open a trouble ticket at https://support.riverbed.com or call 1-888-RVBD-TAC (1-888-782-3822) in the United States and Canada or +1 415 247 7381 outside the United States.
· Professional Services - Riverbed has a staff of engineers who can help you with installation, provisioning, network redesign, project management, custom designs, consolidation project design, and custom-coded solutions. To contact Riverbed Professional Services, go to http://www.riverbed.com or email proserve@riverbed.com.
· Documentation - Riverbed continually strives to improve the quality and usability of its documentation. We appreciate any suggestions you may have about our online documentation or printed materials. Send documentation comments to techpubs@riverbed.com.
©2021
Riverbed Technology. All rights reserved. Riverbed and any Riverbed product or
service name or logo used herein are trademarks of Riverbed Technology. All
other trademarks used herein belong to their respective owners. The trademarks
and logos displayed herein may not be used without the prior written consent of
Riverbed Technology or their respective owners.