Release Notes for Ipswitch WhatsConnected v3.1

In this File

Release Information

Release information

Product name

Ipswitch WhatsConnected

Version

3.1.1

Release date

v3.1 May 2012

v3.1.1 December 2012

Introducing WhatsConnected

WhatsConnected is a layer 2 and layer 3 network discovery and visualization application that equips network managers with a comprehensive tool set to accurately discover, inventory, configure, document, and visualize device connectivity, including VLAN overlays, down to the individual port. Layer 2 discovery and mapping accesses the physical infrastructure information embedded in devices to provide significantly more detailed topology information than Layer 3 discovery mechanisms. In addition to widely used IP discovery protocols, such as ICMP, ARP, and SNMP, Layer 2 discovery leverages a number of other mechanisms to discover devices including industry standard Link Layer Discovery Protocol or LLDP, as well as equipment manufacturer proprietary discovery protocols.

With Layer 2 information available about how devices in your network are connected, their interdependencies, and their locations, you can locate problems and resolve them more easily. WhatsConnected helps you understand your network from top to bottom and focus on keeping it running securely and at peak performance.

WhatsConnected provides the key functions network professionals need to discover, map, search, document, and troubleshoot networks.

New in WhatsConnected v3.1

The following is a list of the new and updated functionality added to WhatsConnected in this release:

Topology maps can now be exported to Adobe .pdf files.
A new report, The Discovery Task Log, displays the results of Discovery Tasks that attempted to run, whether successfully or otherwise, during a specified time period.
The Assign OID dialog allows users to associate object identifiers with specific devices.
A new tool, the Subnet Calculator, aids users network configuration; this tool calculates ranges of subnets for specific IP addresses based on network bits, subnet bits, and host bits.
The Email Settings dialog stores the SMTP settings used to email Discovery Task alerts and Scheduled Reports. This dialog gives you the ability to test email addresses before configuring tasks or scheduled reports.
The Edit MIB II option allows you to make system changes (name, contact, location) to multiple SNMP devices at one time, saving you the trouble of having to manually configure each device separately.
Discovery can now scan for and display port duplex settings that so users can determine if ports are configured correctly.
Ability to store a user-specified number of older versions of the discovery file for historical purposes.
Network hub has been added to the map display. Hubs are detected in the discovery scan and are displayed on the map as a connection point in an effort to more accurately represent network topology.
Additional SNMP OIDs have been added to the discovery engine to more accurately identify devices.
Three new tabs have been added to the Device Categories viewer: AP Clients, Access Points, and Rogue Access Points. These new tabs display information for wireless devices.

System requirements

WhatsConnected runs on several 32-bit and 64-bit Windows operating systems. The following is a list of the Windows operating system and release requirements for WhatsConnected:

Windows 7 Ultimate
Windows Server 2008 SP2
Windows Server 2008 R2 SP2
Windows Vista Ultimate (SP2 recommended)
Windows Vista Business (SP2 recommended)
Windows Server 2003 Standard SP2

WhatsConnected can also run on 32-bit and 64-bit virtual machine environments.

Important: If WhatsConnected is hosted on VMWare ESX, ESXi or Microsoft Hyper-V Server 2008, to avoid licensing issues, make sure that you assign a static MAC address to the virtual machine that on which WhatsConnected is operating.

Microsoft .NET Framework 4.0 is required.
If you are installing WhatsConnected plugin with WhatsUp Gold, Microsoft .NET Framework 4.0 is included in the install.

If you are installing the WhatsConnected standalone application, you must install Microsoft .NET Framework 4.0 before installing WhatsConnected. Find the most recent version of Microsoft .NET Framework 4.0 on the Microsoft website.

Hardware requirements

	Recommended	Required
Processor(s)	Dual-core	Single-core
Processor speed	2 GHz or more	2 GHz
RAM	4 GB	2 GB
Hard drive space for application	8 GB or more	8 GB
Network interface card	1 Gbps	100 Mbps
CD-ROM or DVD-ROM	Required if installing from CD-ROM. Not required for download installations.	Required if installing from CD-ROM. Not required for download installations.
Video display resolution	1280 x 1024 or higher	1024 x 768

Installing and Upgrading WhatsConnected

To install WhatsConnected:

Note: The install file may include the product serial number at the end of the file name. If it is included, the serial number automatically activates the application at the end of the install process. If the serial number is not included, you can manually activate the application. For more information, see Activating WhatsConnected.

Launch the WhatsConnected installation program by double-clicking the downloaded executable provided in either the email sent to you from Ipswitch or in your account on the WhatsUp Customer Portal.
Read the welcome screen. Click Next. The License Agreement dialog appears. If you accept the terms of the license agreement, select I accept the terms of the license agreement.
- To print a copy of the license agreement, click Print. The license agreement is sent to the default printer.
- If you do not accept the terms of the license agreement, click Cancel to exit the installation program.
Tip: To view the WhatsConnected User Guide, click View User Guide. To view the WhatsConnected Release Notes, click View Release Notes.
Select the installation directory for the WhatsConnected application files.
The default path is C:\Program Files\Ipswitch\WhatsConnected. We recommend that you use the default path.

Tip: The Program Files directory name may vary if on a 64-bit system (for example, Program Files(x86) or Program Files). You can install WhatsConnected to a different location. To select a different location, click Change.

After you select the installation directory, click Next. The Ready to Install the Program dialog appears.
Click Install. The setup program installs and configures WhatsConnected.
When the installation completes, the InstallShield Wizard Complete dialog appears.
- To download the WhatsConnected User Guide, select the Download and View User Guide option.
- To launch the WhatsConnected program automatically upon completion of installation, select the Launch WhatsConnected option.
Click Finish. The setup program closes.

Installing and Upgrading WhatsConnected

Note: WhatsConnected is no longer accessible from the Tools menu in the WhatsUp Gold console. WhatsConnected is accessible through the operating system's Start menu. (Start > All Programs > Ipswitch WhatsConnected > WhatsConnected)

To install WhatsConnected:

Note: To launch the WhatsConnected installation program, you must run the WhatsUp Setup. For more information see Running WhatsUp Setup.

Read the welcome screen. Click Next. The License Agreement dialog appears. If you accept the terms of the license agreement, select I accept the terms of the license agreement.
- To print a copy of the license agreement, click Print. The license agreement is sent to the default printer.
- If you do not accept the terms of the license agreement, click Cancel to exit the installation program.
Tip: To view the WhatsConnected User Guide, click View User Guide. To view the WhatsConnected Release Notes, click View Release Notes.
Select the installation directory for the WhatsConnected application files.
The default path is C:\Program Files\Ipswitch\WhatsConnected. We recommend that you use the default path.

Tip: The Program Files directory name may vary if on a 64-bit system (for example, Program Files(x86) or Program Files). You can install WhatsConnected to a different location. To select a different location, click Change.

After you select the installation directory, click Next. The Ready to Install the Program dialog appears.
Click Install. The setup program installs and configures WhatsConnected.
When the installation completes, the InstallShield Wizard Complete dialog appears.
Click Finish. The setup program closes.

Upgrade paths for WhatsConnected

Note: When you upgrade WhatsUp Gold to version 14.3 and later on a server with WhatsConnected licensed for use, WhatsConnected is removed from the server. If you want WhatsConnected on the same server as WhatsUp Gold, you must obtain a separate license for WhatsConnected and run the WhatsUp Setup program, then select the WhatsConnected install option on that server. For additional help and information about managing your product license, go to the WhatsUp Customer Portal.

WhatsConnected is upgraded using the WhatsConnected installation program. The following matrix describes the tasks required to accomplish the supported upgrade scenarios.

Installed Version	Upgrade Target	Upgrade Tasks
WhatsUp Gold v12.3.x or 14.x with WhatsConnected	WhatsUp Gold v15.0 with WhatsConnected v3.0 (same server)	To upgrade: Run the WhatsUp Setup program on the server you want to upgrade, and select both WhatsUp Gold and WhatsConnected for upgrade.
WhatsUp Gold v14.3 with WhatsConnected v2.1.x	WhatsUp Gold v15.0 with WhatsConnected v3.0 (same server)	To upgrade: Run the WhatsUp Setup program on the server you want to upgrade, and select both WhatsUp Gold and WhatsConnected for upgrade.
WhatsUp Gold v12.x or 14.x with WhatsConnected	WhatsConnected v3.1 (*Standalone)	To upgrade: Backup your WhatsConnected configuration (see Backing up the WhatsConnected configuration for instructions). Run the WhatsUp Setup program on the server you want the WhatsConnected v3.1 Standalone installation (see Installing WhatsConnected for instructions). Restore your WhatsConnected configuration (see Restoring the WhatsConnected configuration for instructions).
WhatsConnected v2.1.x or 3.0 (*Standalone)	WhatsConnected v3.1 (*Standalone)	To upgrade: Run the WhatsUp Setup program.

Note: *WhatsConnected (Standalone) refers to a WhatsConnected installation on a server other than the one where WhatsUp Gold is running.

Exporting WhatsConnected maps to WhatsUp Gold

Beginning with WhatsConnected v2.0, you can export topology maps to WhatsUp Gold. Use the following matrix to determine what version of WhatsUp Gold you can export maps to according to the version of WhatsConnected you have installed.

Installed version	Exports maps to
WhatsConnected v2.0 - 2.x	WhatsUp Gold v14.3 - 14.3x
WhatsConnected v3.0	WhatsUp Gold v14.4 - 14.x
WhatsConnected v3.1	WhatsUp Gold v15.0 - 15.x

Backing up the WhatsConnected configuration

Important: To prevent WhatsConnected instabilities during restoration, you must upgrade your current WhatsConnected installation to the same version as your target WhatsConnected installation (WhatsConnected v2.1.1 or later) prior to backing up your WhatsConnected configuration.

To backup your current WhatsConnected configuration:

Log in to the machine where WhatsConnected is installed and navigate to the C:\Program Files\Ipswitch\ directory.
Copy the C:\Program Files\Ipswitch\WhatsConnected\Config directory to a temporary location on the machine on which WhatsConnected is to be installed.
If you want to maintain your discovery information, save a copy of your discovery files to the machine on which WhatsConnected is to be installed.
If you have associated any images with custom device categories, copy these images to a temporary location on the machine on which WhatsConnected is to be installed.

Upgrading WhatsConnected

To upgrade WhatsConnected:

Read the Welcome Screen. Click Next. The License Agreement dialog appears. If you accept the terms of the license agreement, select I accept the terms of the license agreement.
- To print a copy of the license agreement, click Print. The license agreement is sent to the default printer.
- If you do not accept the terms of the license agreement, click Cancel to exit the installation program.
Tip: To view the WhatsConnected User Guide by click View User Guide. To view the WhatsConnected Release Notes click View Release Notes.
Select the installation directory for the WhatsConnected application files.
The default path is C:\Program Files\Ipswitch\WhatsConnected. We recommend that you use the default path.

Tip: The Program Files directory name may vary if on a 64 bit system (for example, Program Files (x86)). You can install WhatsConnected to a different location. To select a different location, click Change.

After you select the installation directory, click Next. The Ready to Install the Program dialog appears.
Click Install. The setup program installs and configures WhatsConnected.
When the installation completes, the InstallShield Wizard Complete dialog appears.
Click Finish. The setup program closes.

Restoring the WhatsConnected configuration

To restore the WhatsConnected configuration:

Restore your configuration.
1. Log in directly to Microsoft Windows using the Administrator account on the server you want to upgrade to WhatsConnected.
Note: If you do not have an account called Administrator, use an account that has full administrative privileges to the computer.
1. Navigate to the location where you stored the backup of the \Config directory.
2. Copy the backup copy of the \Config directory to the C:\Program Files\Ipswitch\WhatsConnected\ directory.
Note: This will overwrite the current \Config directory with the backup copy of the \Config directory. When prompted by the operating system, accept this overwrite.
Restore any custom device category images.
1. Navigate to the Device Category Configuration dialog (Configure > Device Category...). The Device Category Configuration list appears.
2. Select the Device Category to which you want to restore the image, and click Edit. The Device Category edit dialog will open.
3. Click the Browse button and browse to the location of the image, then click Open. The image appears in the Device Category Configuration dialog.
4. Click OK. The Device Category Configuration dialog closes.
5. Click OK. The Device Category list closes.
If you want to connect to a remote WhatsUp Gold server, update the WUG Server Endpoint Library to ensure connectivity between WhatsConnected and WhatsUp Gold.
Note: When you restore your WhatsConnected configuration, you may need to modify your network to allow for connection between WhatsConnected and the WUG Server Endpoint.
1. Navigate to the WhatsUp Gold Remote Servers list (Configure > WUG Server Endpoint Library).
2. Click Add to create a new WUG Server Endpoint, or Select a WUG Server from the list and click Edit to edit an existing WUG Server connection. The New / Edit WhatsUp Gold Remote Server dialog opens.
3. Make the necessary changes to the Remote Server.
  - Name. Enter the name you want to associate with the remote WhatsUp Gold server.
  - Description. Enter a description of the remote WhatsUp Gold server.
  - Host Name / IP Address. Enter the hostname or IP address of the remote WhatsUp Gold server.
  - Port. Enter the port which the remote WhatsUp Gold server will listen for connections from WhatsConnected.
4. Click OK. The New/Edit WhatsUp Gold Remote Server dialog closes. The new or edited WhatsUp Gold server appears in the WhatsUp Gold Remote Servers List.
5. Click Close. The WhatsUp Gold Remote Servers list closes.

Activating WhatsConnected

Note: Beginning with WhatsUp Gold 14.3 and following, WhatsConnected is not included in WhatsUp Gold licensing, and therefore requires a separate license.

If WhatsConnected is installed using the installation application downloaded from the web link provided in the purchase confirmation email, the program is fully functional immediately after installation.

If the WhatsConnected license is not automatically activated during installation, you can manually activate WhatsConfigured using the activation program in the WhatsUp Gold group on the Windows Start menu.

To activate WhatsConnected manually:

Note: Before you start the manual activation process, make sure that you have your product serial number available to use in the activation program.

Click Start > Programs > Ipswitch WhatsConnected > Manage WhatsConnected License. The activation program appears.
- or -
If you run the WhatsConnected console at the end of the installation, it displays an Invalid License dialog. Click Purchase/Unlock to start the license activation process.
Follow the on-screen instructions to complete the product activation.

Note: When the activation is complete, a confirmation page indicates the license has been activated. If the activation does not complete successfully, you may be behind a proxy or firewall that is blocking the activation request. In this case, click the Offline button, then follow the onscreen instructions.

For more help and information about licensing, go to the WhatsUp Customer Portal.

Uninstalling WhatsConnected

You can un-install WhatsConnected by un-installing from the Windows system Control Panel, or by using the WhatsUp Setup setup program.

To uninstall WhatsConnected:

Start the un-install program:
Navigate to the Windows system Control Panel, select WhatsConnected from the program list and click Uninstall. The Setup dialog prompts you with the following question, "Do you want to completely remove the selected application and all of its features?"

- or -
1. Run the WhatsUp Setup. For more information, see Running WhatsUp Setup. On the Install Options dialog, select the WhatsConnected product option, then click Next.
Note: The WhatsUp Setup program detects any currently installed Ipswitch WhatsUp branded software and determines which installation options are available (New Installation, Upgrade, Repair or Un-install). This information is displayed to the right of the product name and version.
1. On the License Information dialog, select Use existing installed license, then click Next.
2. On the Installation Summary dialog, ensure that the currently installed version of WhatsConnected is displayed as the product selected for repair or uninstall, then click Next. The Welcome dialog of the WhatsConnected Installation program will appear.
3. Select Remove to uninstall WhatsConnected.
Tip: Select Repair to reinstall all program features installed by the previous setup.
Click Yes. The un-install program runs. The Uninstall Complete dialog appears.
Click Finish. The setup program closes.

Fixed in WhatsConnected 3.1.1

The following issues were resolved in WhatsConnected v3.1.1:

Category	Issues	Defect ID
Discovery	Fixed an issue with looping database table that caused discovery to hang.	20882
	Fixed an issue that prevented discovery tasks from displaying different WhatsUp Gold endpoints.	20898
	Fixed an IPv6 compatibility issue with the advanced discovery setting to Ping Discovered Subnets.	20916
	Fixed scoping issue with Ping Sweep discoveries that caused the discovery scan to include devices outside of the sweep scope.	21018
General	Discovery tasks can now be copied.	20796
Export	Layer-2 links now load and rebuild more smoothly after exporting to WhatsUp Gold from WhatsConnected 3.1.1.	20829

Important: These fixes are optimized for WhatsUp Gold 16.0.2. We highly recommend that you upgrade your instance of WhatsUp Gold to version 16.0.2.

Fixed in WhatsConnected v3.1

The following issues were resolved in WhatsConnected v3.1:

Category	Issues	Defect ID
General	Fixed an issue that caused a license error dialog to popup when users double-clicked a discovery file (`.dis`).	15967
	Fixed an issue that caused the Device Filter field to disappear in the Software Update report after the report is resized to a small window size.	16624
Discovery	Fixed an issue that prevented WhatsConnected from discovering devices that do not contain an SNMP sysName.	18437
	Fixed an issue that rendered the OK button useless when users rediscovered networks or devices as well as did not allow users to open previously saved discovery files (`.dis`).	19172
	Fixed an issue that caused WhatsConnected to identify broadcast addresses as real devices.	16521
	Fixed an issue that caused Cisco module serial numbers to be excluded from WhatsConnected discovery.	17781
	Fixed an issue that caused incomplete software inventory details when discovery uses WMI credentials.	16322
	Fixed an issue that caused Hirschmann switches to have incorrect Management interface connections.	16700
	Added support for the discovery of Cisco EtherChannel ports as LAG ports.	18927
Device	Fixed an issue that caused Solaris devices to be categorized as firewall after discovery.	17170
	Fixed an issue that caused only the main IP address of a device to be listed in Subnet View. When devices have multiple IP addresses, the subnet view now shows the IP that matches the subnet selection in the subnet view.	16456
Map	Fixed an issue that prevented WhatsConnected from exporting devices with sysName to WhatsUp Gold.	18334
	Fixed an issue that caused WhatsConnected to incorrectly link HP ProCurve devices when LAG ports were not discovered completely.	19004
Licensing	Fixed an issue that disallowed license management of the WhatsConnected v3.1 from the Windows Start Menu.	19185
Install	Created a popup message that notifies users that WhatsConnected requires Microsoft .NET 4.0 extended (full) and that .NET it is no longer included in the WhatsConnected install. Users must now download the appropriate version of Microsoft .NET from the Microsoft website before installing WhatsConnected.	18567
Export	Fixed an issue that caused devices with VMWare credentials that were exported to WhatsUp Gold to not be recognized as virtual machines/hosts.	16848
	Warranty information/collection has been updated for Dell computers.	N/A

Known Issues in WhatsConnected v3.1

The following are known issues in WhatsConnected 3.1:

Juniper Switches (EX 2200/3200/4200) report switch ports as non-physical (virtual) ports which cause the end-node connectivity processing to fail.

For more information and updates

The following are information resources for WhatsConnected. This information may be periodically updated and available on the WhatsUp Gold Web site.

Application Help for the console. The console help contains dialog assistance, general configuration information, and how-to's that explain how to use the features. The Table of Contents is organized by functional area, and can be accessed from the main menu or by clicking Help in the console.
Licensing Information. Licensing and support information is available on the WhatsUp Customer Portal. The web portal provides enhanced web-based capabilities to view and manage Ipswitch product licenses.
Technical Support. Use the WhatsUp Gold Support Site for a variety of WhatsUp Gold product help resources. From here you can view product documentation, search Knowledge Base articles, access the community site for help from other users, and get other Technical Support information. The Support Site is available on the WhatsUp Gold web site.