Changes in wktools Version 4.6.1.0

1) Mapper

New Features:

• New Report: End Systems Report; Building this report could be very time consuming. Therefore a new option was added: "Show time consuming reports"
• End System Search: It is now possible to look up end systems in the database.
• MAC OUI DB Download: Imports all OUIs into the DB; The data is then used for the End Systems Report and the End System Search
• Changes to wktools internals.

• Crash when building the IP Phone report. This is resolved now.

2) Configure Devices

• Added support for HTTPS Authentication.
• Telnet does not work under rare conditions. The reason was a problem with telnet options negotiation.
• Under rare conditions, wktools crashed when doing telnet sessions. This was a timing issue.

Changes in wktools Version 4.6.0.0

1) Mapper

Important: The database layout has changed. Please delete wkm.db before using the new version!

New Features:

• Visio Output: Embedded Quick Reference Guide with shape explanation and hints.
• Cisco IP Phone Parser: When IP Phone information is available (html files), it is now parsed and used in the reports and Viso shape data.
• Enhanced Hardware Information parser: A complete re-write of the "Device Information Parser" was done and included into the Mapper tool to have all information available at one point and stored in the database. Some of the additional data is also used in the Visio output. License Information and File system information is stored in the database but not used yet.
• Added csv output for some reports: Hardware; Detailled Hardware; IP Phone and Detailled Interface Errors
• Many database changes: New tables and table enhancements
• New Reports:
• Detailled Hardware Report: Includes all Chassis and Module information.
• IP Phone Report.
• Software version and device type is now extracted from the cdp output.
• The full CDP neighbor hostname is now used in the Report and Visio outputs.
• Shape Data category is only used when there is a value for it.
• Fine tuning of the L2 Report.
• "log.txt" is excluded from Parsing if in the Search directory.

• Device type was not correct for VSS devices.
• IP address information for some cdp neighbors (i.e. Cisco UCS) was not parsed correctly.
• VLAN information for Sub-Interfaces was not stored in the database.

2) Configure Devices

• Introduced a new Mapper Template for IP Phones. This template is used automatically when Modus is set to HTTP or HTTPS.
• Now it is possible to have more than one URL in the config file for HTTP and HTTPS requests.

Changes in wktools Version 4.5.0.0

1) Mapper

Important: The database layout has changed. Please delete wkm.db before using the new version!

New Features:

• Import for end systems: It is now possible to import additional devices. These devices are then included to the map and reports. Please see documentation for more information.
• New Reports:
• L2 Report with Switchport config mismatch information.
• Detailled Interface Error Report with all interface errors.
• Device Report with Device HW details.
• Report enhancements: Consecutive number for all reports, except the DIFF reports.
• Introduced new error messages and informational messages.
• If a router has STP enabled, this information is now displayed in the network map (shape data)
• New parser ofr "show interfaces switchport"; The result is included in reports (L2) and interface shape data if applicable.
• CDP information is now more used for error correction.
• INTERNAL: New and enhanced debugging capabilities.

• The ARP Table was not parsed correctly for some plattforms. This leaaded to failures in neighborship calculation.
• Under rare conditions wktools crashed during STP information parsing.
• Under rare conditions wktools crashed during ARP information parsing.
• Under rare conditions wktools crashed during neighborship calculation when evaluating cdp neighborships.
• Internal GML information was displayed. This is deactivated now.
• STP Parser for Catalyst 3500XL switches did not work correctly.
• The CAM Table Parser did not work correectly for Catalyst 3500XL Switches.
• In some cases the Chassis S/N had a leading SPACE. This is removed now.
• Catalyst 3500XL switch neighborship calculation did not work correctly.
• Problems with second run -> Failures with neighborship calculation.
• STP Parsing problems for LS1010 switches.

2) Miscellaneous Bug Fixes

• Configure Devices: When 2301 error handling was disabled, nothing was logged. Now the error itsefl is shown, but without special notification.
• Device Information Parser: Crash when license information is empty for ISR G1 routers. TThis is resolved now
• Global: The format for some log messages was incorrect.

Changes in wktools Version 4.4.4.0

1) Configure Devices

• Error detection for "2301" errors renewed.
• Solved Problem: Under rare conditions the tool stopped during "show version".
• Changed the default setting for "Modus" from "COM" to "SSH".
• Log file is now used in Silent and GUI mode.

2) Mapper

• Use cdp information to minimize inconsistencies:
• Solved problem: Extended duplex column in the report.
• Introduced a new check for Router/Switch differentiation; Needed for routers with switch module and active STP.
• Solved problem: Interface was not working correctly when some items were missing in the last interface.
• Solved problem: Hostname parser modified because under rare conditions (i.e for some APs) some parts were missing.
• If two devices with the same hostname exist, one is altered to "hostname"-1
• When two devices with the same hostname exist, "-1" is added to one of the hostnames.
• Solved problem: Sometimes a neighborship was missing for end systems (L2 Non-Switch neighborships), because the check did not use all available values.

Changes in wktools Version 4.4.3.0

1) Configure Devices

• Error details output modified: Each message is only displayed once and a Line Break is added after every message.
• Solved problem: Crash when gathering information from IOS devices
• Added new debugs: HEX output; Special1; Special2
• Solved problem: Sometimes Multihop did not recognize when the session to a host was closed

2) Mapper

• Added SNMP Location Parser (show snmp)
• Added the following device details in Visio Shape Data: device type, S/N
• PIX/ASA: Vlan information collected for subinterfaces
• Solved problem: a subinterface was shown as etherchannel
• Solved problem: PIX/ASA: Failover Interface were not shown in the Visio output
• If two devices with the same hostname exist, one is altered to "hostname"-1

Changes in wktools Version 4.4.2.1

1) Global

Summary Logfile/Report file: All important log entries are written to this file after wktools is closed. The Report File can be specified under Global Settings.

2) Configure Devices

A description of all listed error messages is now shown in the final report.

Changes in wktools Version 4.4.1.1

1) Configure Devices

wktools crashed when using TELNET. This is fixed now.

Changes in wktools Version 4.4.1.0

1) Global

• Added a check if wktools was edited somewhere else before saving it.
• It's now possible to disable all unwanted error messages in the Global Settings view.
• New CLI option: -v; to display the wktools version.

2) Mapper

Important: The database layout has changed. Please delete wkm.db before using the new version!

• Added VSS support.
• Added Visio VSS VSL info output.
• Fixed Crash while parsing routing information (under rare conditions)
• Added PIX 6.3 support.
• Fixed some interface related PIX/ASA issues. Because PIX/ASA is using interface names instead of physical interface in certain show outputs, it was needed to change some checks.

3) Configure Devices

• Changed the following internal checks and procedures:
• PIX/ASA name check: F/O status is now recognized when available in the ASA prompt
• PIX/ASA: only send commands, when the whole hostname was received, not only a '#'
• General name checks changes
• Timeout handling changed: Before really closing the session, a 'LF' is sent to the device to see if it is really down, or wktools was unable to handle the received data.
• When commands are still in the queue, but connection is closed, it is now checked if last command was "exit". If yes, no error is shown.
• It's now possible to disable Error "2301" directly in Configure Devices.
• SSH fallback to SSHv1 is now shown as Warning
• All CR's are now deleted when reading the config file, because this may cause problems with the Linux version.
• A Dummy Command (exit) is now added to all configuration files in SingleHop mode, to have a valid command at the end.
• Linux Version: Crash under rare conditions when SSH encounters an unknown error. This is fixed now.
• Enhanced Debugs are now available.
• Under rare conditions, wktools Linux version stopped processing after a connection error. This is fixed now.
• When an incorrect DeviceGroup file was loaded, it was overwritten on wktools exit with an empty file. This is fixed now.

Changes in wktools Version 4.4.0.0

1) Mapper

Important: The database layout has changed. Please delete wkm.db before using the new version!

• Added output options to customize the layout of the Visio drawing.
• Enhanced Report:
• Sorted interface error output
• Additional columns for the interface error output: Line number, cdp neighbor, cdp neighbor type, last clearing of interface counters)
• Diff for interface error output (last and penultimate run)
• Fixed problems with cdp Check
• Fixed Root Bridge marking
• Fixed "Logic Error" marking (mark interfaces yellow, when something was wrong with neighborship calculation)
• Fixed behavior when "Parse new" option unchecked, but "Analyze New" option checked
• Fixed STP check
• Changed STP behavior for ATM switche bridge groups (Cat8540)
• Changed interface checks -> With older IOS versions, the current speed and duplex settings are not displayed with "show interfaces"; A workaround for this is now included
• Added support for IOS 15.x
• Started with Advanced L3 Output. IOS Routing table parsed and added to the DB

2) Configure Devices

• Fixed SSH fallback error message: It's now a Warning, no more an Error.
• Fixed problems with reading config files: When a command started with SPACE, the command was ignored.
• Enhanced Debug capabilities: HEX output for Send and Receive Data
• When BEL (ASCII 0x07) is found at the end of the receive data, it is deleted
• Added Mapper commands to the MAPPER cofig file profile

Changes in wktools Version 4.3.3.2

1) Mapper

• Performance Improvements for Neighborship calculation due to sqlite upgrade to 3.7.6.2
• Performance Improvements for some Parser modules

2) Configure Devices

• Enhanced *nix support: Added support for more prompts and Multihop for more than one *nix device.
• Crash when config file was empty. This is fixed now.
• When defining the output file in the config (with !showOutput tag), the directory is created, in case the directory in the path definition does not exist.

Changes in wktools Version 4.3.2.0

1) Global

• New wxWidgets version. Now wxWidgets version 2.8.12 is used.

2) Configure Devices

• Under rare conditions, the column size in the DeviceGroup view was too big. This is resolved now.
• Under rare conditions, wktools crashed when collecting show output from IOS devices. This is resolved now.
• New config file tag (showOutput), to specify the show Output file directly in the config file. Please see wktools documentation for more information
• Introduced some checks and warnings to prevent unwanted overwrites of the deviceGroup File.

Changes in wktools Version 4.3.1.0

1) Mapper

• Added reports: List with all interfaces with errors and STP problems; Statistics

Changes in wktools Version 4.3.0.1

1) Mapper

• Added vPC support for Nexus plattforms, including shape data output.

Changes in wktools Version 4.3.0.0

1) Mapper

Important: The database layout has changed. Please delete wkm.db before using the new version!

• Added Diff function: At the end of each run the Mapper tool does a diff between the last and the penultimate run. In a first step, the result is shown in the REPORT
• Changed database layout for diff function.
• Interface Shape Data additions: Associated Device; Speed/Duplex settings
• Added "Clear DB" and "Cleanup DB" functions
• Fixed L3 Visio output
• Added debugging capabilities; Internal changes with no impact to the tool function

2) Wizard

• Split Wizard - The Wizard is now splitted into two steps. This gives you the possibility to check and change the settings before executing.
• Changed some default settings.
• Interface Shape Data additions: Associated Device; Speed/Duplex settings
• Use empty config for http/https access for Inventory function.

3) Configure Devices

• Fixed problem with IP address file; Problems with interpreting normal IP address files.
• Crash under rare conditions. Problem fixed.
• Tool stopped operation when config file was not available. This problem only occurred when starting wktools via CLI without GUI.
• Changed behavior for IOS device return value "confirm]": Now "y" is sent instead of "yes"
• New config tags "!cmd-prefix " and "!device hostname|ip "; See documentation for more information.
• New config tag "!remove-newline"; See documentation for more information.

4) General

• Log view refresh when tool finished operation.
• wktools.xml is now written each time a profile is saved in the GUI.

Changes in wktools Version 4.2.2.0

1) Mapper

Important: The database layout has changed. Please delete wkm.db before using the new version!

• Additional data is added to Device and Interface Shape Data
• Nexus Support completed
• Enhanced Mapper documentation
• There was a problem that STP transition count errors were not shown sometimes. This is resolved now.
• Behaviour of STP Mixed has changed -> only used when STP is at least for one Vlan in blocking mode.

Changes in wktools Version 4.2.1.5

Most of the changes are houskeeping things. No major features had been added.

1) Mapper

Important: The database layout has changed. Please delete wkm.db before using the new version!

• Search Pattern now works
• wktools files like wkm.db or TempDevGrp.txt are now no more parsed
• "Analyze New" option is now always set when "Parse New" is used
• Renamed CDP options
• Now it's no more possible to have Vlan Interfaces as neighbor in the L2 view
• Modified size of some node objects to get better result of the layout algorithm
• Introduced Visio symbol for ATAs and CCTV devices
• Modified Interface Name lengths
• Added Nexus support
• Modified interface shape to get a doublespaced naming field
• Interface Marking was broken for everything else than STP. This is fixed now
• Added error checks when DB is corrupt

2) Configure Devices

• Device Group view was sometimes not visible. This is fixed now
• "Detailed Error list" look has changed
• Since SSH simplification the ordering of the protocols has changed. If you used http or https in the past, the saved profiles are now inconsistent.
• Added needed commands for Nexus devices in the Mapper template

3) Wizard

The result location and files are now noted in the log window.

Changes in wktools Version 4.2.1.0

1) Device Information Parser

Added support for NX OS devices and ISR G2 license information.

2) Configure Devices

SSH is now simplified - you do not need to seperate between SSHv1 and SSHv2 anymore. wktools always tries SSHv2 first and when it fails, it falls back to SSHv1.
Important Notice: You might have problems with existing XML profiles, since one SSH entry is removed, http and https index is now different. There is no problem with existing deviceGroup Files

3) Mapper

• Seperate icons for L2 and L3 switches. A switch is assumed as L2 switch, when it has only one active Vlan Interface. When there is more than one active VLAN interface, it is a L3 switch.
• Introduced Root bridge icon
• Root port is marked with (R)
• New icon for Voice router (VG2xx) devices

4) Wizard

Passwords are now masked.

Changes in wktools Version 4.2.0.1

1) IP List

There was a bug in Port Scanner, which is resolved now. The last few IPs with open ports were not recognized.

2) Configure Devices

Added support for NX OS devices.

Changes in wktools Version 4.2

1) General Changes

wktools 4.2 now includes a Wizard for the three most used operations:

• Draw Network Map: Draw a Visio map of your network
  Used Tools: IP List (Portscanner); Configure Devices; Mapper
• Make Inventory: Make an inventory of your Cisco devices
  Used Tools: IP List (Portscanner); Configure Devices; Device Information Parser
• Save Config: Do a Config Backup of your Cisco devices
  Used Tools: IP List (Portscanner); Configure Devices

2) IP List

IP List can now be used to scan network ranges for open ports (22, 23, 80, 443). The result is saved in a text file, which can be used as host file in "Configure Devices".

3) Configure Devices

• There was a problem with show output when the hostname contains special characters. This is resolved now.
• Crash with unsupported ip addresses (i.e. 10.034.001.192). An error handler for this problem is now included.
• New Config Tags: !EXIT and !ENDEXIT. Use this tags with Multihop and !IFRETURN, !ELSERETURN when you want to close a connection.
• Added support for Host files generated by the Port Scanner tool.

4) Mapper

• Added support for Accesspoints. The correct Visio icon is now used.
• Added error handling for cases when neighborship table is emtpy.
• Enhanced distance between nodes for Hierarchic layout.

5) Device Information Parser

Added ";" between the flash and license column headers.

Changes in wktools Version 4.1 (excluding the changes documented in beta versions)

1) General Changes

• Logfile option is no more mandatory. If it is not specified, a log file will be generated on demand. The path is shown in the settings.
• It's now possible to delete profiles directly in wktools.
• Internal http and version check changes not visible to the user.

2) Mapper

• Access Points learned by CDP are now shown correctly.
• L3 view now shows the device IPs
• Using the latest ogdf version: 2010.10
• Improved neighbor checks to minimize neighbor failures

3) Configure Devices

• Added SSHv1 support.
• HTTPS is now done with asio and openSSL; Therefore the old cryplib library can now be used again.
• Improved SSH error logs.
• Elimination of control characters returned by PIX/ASA devices in the log view.
• Hide Passwords columns in the DeviceGroup view when "Visible" option is unchecked
• Better timeout handling when remote host is not reachable.
• New Config Tags: It is now possible to react on return traffic with !IFRETURN and !ELSERETURN.
• New Config Tags: User Specified warnings and error messages are now possible with !ERROR and !WARNING
• New Config Tags: A command can now include regular expressions. The Regex refers to the previous return traffic: [rgx] and [rgxMem]
• New error code summary at the end of each run. All received error codes are listed by device.
• Improved error handling in the DeviceGroup view.
• Some error messages leaded to an infinite loop. This is resloved now.
• Sometimes the DeviceGroupFile option was not filled in. This is resloved now.
• Sometimes a refresh of the Deviceroup view leaded to a crash. This is resloved now.

Changes in wktools Version 4 Beta (4-8)

1) General Changes

• New Tool "Mapper" which automatically draws a network map. This tool is currently in Beat stadium and not publicly available.
• Centralized wktools.xml: It is now possible to define which xml to be used by the tool. It is also possible to switch between the local (in the same directory as wktools4.exe) and centralized xml

2) Mapper

• Currently L2 and L3 (basic) maps are supported
• Data source: STP, CDP, CAM Table; ARP Table.
• Output format is Visio vdx
• Supported devices: IOS Router and Switches; PIX and ASA firewalls

3) Configure Devices

• Multihop SSH behaviour improved
• Improved failure output
• Introduced DeviceGroup Save Button

Changes in wktools Version 4 Beta

1) General Changes

During porting wktools Version 3 to Version 4, I decided to drop "Compare Files" and "PIX Tools". There are lots of free available alternative compare tools like kdiff3 or WinMerge. If you need the PIX Tools functionality, please take a look at the Cisco ASDM.

The intention of wktools Version 4 is to get a platform independent version. wktools now uses wxWidgets instead of MFC and is therefore no more limited to Windows. wktools Version 4 is available for Windows and Linux.

The settings are now saved in xml format in wktools.xml. This file must be available all times, otherwise wktools will fail. A migration tool is available to migrate the Version 3 settings from Windows registry to wktools.xml. This tool is included to the zip file and is named "wktpc.exe".

2) GUI Changes

The Tool navigation tree on the left hand side is replaced by buttons, to get more place for the Tool controls itself. The Tool Settings also needs less space and are now always visible.

3) New Features

4) Missing/Not yet finished Features

wktools@spoerr.org