Release Notes for Ipswitch WhatsUp Gold v14.3.1

In this File

Release Notes for Ipswitch WhatsUp Gold v14.3.1

Release information

Product name	WhatsUp Gold
Version	v14.3.1
Release date	August 2010

New in WhatsUp Gold 14.3.1

WhatsVirtual plug-in

Added support in WhatsVirtual for VMware ESX 4.0, including:
- Updated VMware workspace reports:
  - Virtual Host (Home / Device)
  - Virtual Host List (Home)
  - WhatsVirtual Events (Home)
  - Virtual Server Attributes (Home / Device)
  - Virtual Machine Instant CPU Utilization (Home / Device)
  - Virtual Machine Disk Utilization (Home / Device)
  - Virtual Machine Memory Utilization (Home / Device)
  - Virtual Machine Instant Interface Utilization (Home / Device)

New in WhatsUp Gold v14.3

WhatsUp Gold Standard, Premium, Distributed, and MSP

Added paging functionality to tabular reports (such as Group CPU Availability and Action Log) to allow users to easily navigate extensive amounts of report data.
Added an option to the Preferences dialog (GO > Configure > Preferences) to allow users to set the default maximum number of records a tabular report should display.
Updated the WhatsUp Gold console Welcome Center to include usability improvements and link to the Quick Start Assistant and other information resources.
Added an evaluator pane to the WhatsUp Gold evaluator's license that includes the license serial number, links to: technical support, the Knowledge Base, the WhatsUp Gold community forum, product documentation, the WhatsUp Guru, and tutorial videos.
Added several new pre-configured workspace views to the WhatsUp Gold web interface with a more intuitive and user-friendly approach to creating custom workspace views.
Added functionality to run WhatsUp Gold in FIPS 140-2 mode. You can enable this mode from the WhatsUp Gold console's Program Options (Configure > Program Options > General).
Added the Monitors Applied full report that details the monitors that have been applied to all of the devices in a specific device group.
Added two new Alert Center percent variables (%AlertCenter.Threshold.NewItemNames and %AlertCenter.Threshold.CurrentItemNames) that returns the display names of new items that triggered a notification and the display names of existing items in a notification.
Added device the clone feature to the Device right-click menu.
Improved WhatsUp Gold data rollup performance in the database.
Added support Microsoft SQL Server Cluster environments: 32-bit or 64-bit Microsoft SQL Server Cluster 2005, 2008, or 2008 Standard or Enterprise Edition.

WhatsVirtual plug-in

Added support in WhatsVirtual to monitor virtual systems running on VMWare vCenter and track virtual systems as they move from one physical server to another.
Added a new VMware scan method in discovery and updated the virtualization device role to identify vCenter servers.
Added vCenter server event monitoring, and included a new VMware Threshold in the Alert Center to monitor and alert on virtualization events. Monitoring on the following types of vCenter virtualization events has been enabled:
- High Availability
- Virtual machine migration events (vMotion)
- Security related events
- Others (User configured, custom event list)
Updated and added support in WhatsVirtual for VMware vCenter Server 4.0 monitoring, VMWare ESXi 3.5 and VMWare ESXi 4.0, including:
- Updated VMware workspace reports:
  - Virtual Host (Home / Device)
  - Virtual Host List (Home)
  - WhatsVirtual Events (Home)
  - Virtual Server Attributes (Home / Device)
  - Virtual Machine Instant CPU Utilization (Home / Device)
  - Virtual Machine Disk Utilization (Home / Device)
  - Virtual Machine Memory Utilization (Home / Device)
  - Virtual Machine Instant Interface Utilization (Home / Device)
- Added WhatsVirtual Events report (System > General)
- Updated VMware Performance Monitors for operation with vCenter Server
- Added new Data center, cluster and virtual host hierarchical structures in Device View
- Updated VMware Credential Type to include vCenter servers
- Updated VMware Actions to communicate with vCenter servers

WhatsUp Gold Flow Monitor plug-in

Added support for Network Based Application Recognition (NBAR) network traffic in WhatsUp Gold Flow Monitor. The NBAR classification engine provides network devices with the ability to recognize difficult-to-classify protocols that use dynamic TCP/UDP port assignments. This feature provides a more complete view of network traffic and helps accurately diagnose network traffic related issues. The Top NBAR Applications report displays the top applications as identified using Cisco's NBAR classification engine.
Added Class Based Quality of Service (CBQoS) support in WhatsUp Gold Flow Monitor. This allows Flow Monitor to report based on the Class of Service (COS) that each flow uses. The Class Based Quality of Service (CBQoS) report provides information about the effectiveness of class-based policies applied to an interface for all of the defined classes.
Added new Flow Monitor time graph format (stacked time graphs) to the Flow Monitor workspace reports.
Added new Flow Monitor user friendly configuration utility to configure NetFlow on Cisco devices, such as routers and switches.
Added new Flow Monitor port mapping to associate one or more ports with an application. This mapping supports the Top Applications report, which displays the applications with the highest amount of traffic for the selected interface.
Added new Flow Monitor feature to allow users to remove a Flow Monitor source and delete all associated source data in the database.

WhatsConnected plug-in

Added support the Manual Links feature to allow users to manually configure the link between two devices in the topology map. This helps users manage the occasional issue where WhatsConnected encounters a device (or set of devices) where the discovery information does not provide enough device details to determine the topology. The Manual Links feature helps define a device and its relationship with other network devices.
WhatsConnected plug-in is not installed with WhatsUp Gold. During an upgrade to WhatsUp Gold 14.3 or later, WhatsConnected plug-in is removed and must be installed and enabled separately. See the WhatsConnected release notes for system requirements, installation instructions, and product updates.

WhatsConfigured plug-in

Added an option to save the WhatsConfigured task configuration to a separate text file, from the WhatsUp Gold database, in a selected folder each time the scheduled task completes successfully.

WhatsUp Gold Failover Manager

Added support for SQL Clustering: Microsoft SQL Server 2008 Enterprise Edition

Fixed in WhatsUp Gold 14.3.1

Install

Fixed an issue that caused an upgrade to overwrite previous install logs.

Database

The installer now displays a warning dialog during the upgrade wizard that advises users that the database upgrade may take some time, and thought the user interface may seem to be in a "hung" state, it is working and must be allowed to complete.

Note: The following two fixes are applied to WhatsUp Gold during the upgrade process through several additional upgrade commands. Because of this, the fixes are only applied to your version of WhatsUp Gold if you are upgrading from 14.2.x or prior to WhatsUp Gold 14.3.1. If you have already successfully installed 14.3 and upgrade to 14.3.1, these fixes are not applied. Additionally, as part of the fix, in each instance, WhatsUp Gold deletes any preferences you have saved for that part of the application. For example, to fix the Jscript error displayed in the Top Applications workspace report after an upgrade to 14.3, WhatsUp Gold deletes any preferences you have stored for the workspace report when you upgrade to 14.3.1. As a result, the next time you view the Top Applications workspace report, its default display settings are restored. You can restore the preferences associated with a fix by following the instructions listed in the KB article to which it is linked.

Discovery

Fixed an issue that caused an SSH credentials error after an upgrade from 14.2.x to 14.3, for discovery in the web interface, if previous SSH settings existed. To restore the preferences deleted as a result of this fix, see the following KB article.

Workspace Reports

Fixed an issue that caused the Top Applications workspace report to throw a Jscript error after an upgrade from 14.2.x to 14.3 by integrating a delete command into the 14.3 upgrade script. To restore the preferences deleted as a result of this fix, see the following KB article.

Reports

Fixed an issue that caused a Jscript error when switching to or from Business Hours reporting.

Flow Monitor plug-in

Fixed an issue that caused Flow sources to stop receiving data and a resulting logged exception (an item with the same key has already been added) after enabling CBQoS.

WhatsVirtual plug-in

Fixed an issue that caused some virtual devices that were associated with VMWare Hosts to not appear in the Device Properties dialog in the web interface.

Fixed in WhatsUp Gold v14.3

Install

Fixed an issue that prevented an upgrade from 14.x to 14.x.x to delete the 14.x program group from the Start menu.

Resolved a problem that prevented an upgrade of WhatsUp Gold using a Microsoft SQL Server 2008 instance from installing SQL client tools or SQL connectivity components.

Alert Center

Fixed an issue that caused the Alert Center to log a SQL syntax error at every poll of a threshold after a Flow Monitor group, that was used as an exclusion in the threshold, is deleted from Flow Monitor.

Web Interface

Fixed an issue that caused an uppercase "s" in LDAP credential Authorize DN field to crash the web service. The UI was redesigned to help a user save the correct values.

Discovery

Resolved a problem that caused a hosts file import discovery to not use the hostname provided in the selected text file.

Fixed an issue that prevented SSH credentials from populating in the available credentials list, when configuring a discovery scan and the subsequent failed tests, of any SSH Monitors configured for a device role, as well as failure of discovery to add SSH monitors to discovered devices.

WhatsConnected plug-in

Fixed an issue that caused an unhandled exception error in the Device Viewer dialog when a user attempted to display Device Viewer data for a WhatsUp Gold device that had not been exported from WhatsConnected, but has a WhatsConnected right-click menu and has more than 16k of Layer 2 data.

Flow Monitor plug-in

Resolved a problem that required that Top Sender Groups to be edited in order for them to display properly in the Interface Details Report.

The NFArchive database was previously created with the recovery model set to FULL and had the potential to fill a user's harddrive if they didn't make periodic backups; it has been changed to use the SIMPLE recovery method to alleviate this problem and to be consistent with the NetFlow database.

Reports

Resolved a problem that caused date links in the Tail of State Change Log workspace report to open full reports with a custom date range for today from 00:00:00 to 00:00:00 (0 minute time frame).

Fixed a problem that was causing several reports to throw an APS error.

Implemented a new SQL clause for Business Hours to stop several instances of too many data points displaying in the Ping Response Time report's graph due to lack of order in the previously provided SQL clause for the Business Hour date range.

If an LDAP user generates a request for a report export to PDF from a local machine, WhatsUp Gold authenticates without a password so that the report can successfully be exported to PDF.

Performance Monitors

Stopped an instance of haulted data collection for interfaces not supporting errors and discards (EAD) by polling OIDs related to EAD separately when SNMPv1 credentials are used.

Active Script Performance Monitor - fixed an issue that caused GetReferenceVariable to return an Invalid Security Model in Security Parameters error.

General

Upgraded to OpenSSL 0.9.8n binaries to further secure network data.

Implemented new performance counters so that Ipswitch engine and web server counters are available on Windows Server 2008 64-bit OS.

About WhatsUp Gold editions

These release notes apply to all editions of WhatsUp Gold. However, some features referenced in these release notes are only available in certain editions. The table below indicates which features are available in each edition.

	Standard Edition	Premium Edition	MSP Edition	Distributed Edition
Application and Hardware Management
Monitor Microsoft Exchange
Monitor SQL Server and MySQL
Monitor applications via WMI
Monitor device hardware, such as cooling systems, power supplies, and temperature monitors
Monitor printers and APC UPS devices
Monitor web content
Monitor device network statistics
Monitor device file and folder properties
Monitor email and FTP servers
Monitor wireless access points (WAPs)
Monitor Unix/Linux environments over SSH
Real-time Monitoring
View real-time data about devices in reports
Quickly access real-time data via InstantInfo popups
Monitor performance data with the Web Performance Monitor
View real-time information about tasks running on a device using the Web Task Manager
Distributed Monitoring
Monitor devices on networks segmented across multiple geographic locations
View report data from multiple remote sites from one central location
Optional Plug-ins
WhatsUp Gold Flow Monitor. This plug-in provides insight into how efficiently your network is performing and how bandwidth is utilized, giving you detailed information to assess network quality of service and quickly resolve traffic bottlenecks. For more information, see the WhatsUp Gold Flow Monitor User Guide on the WhatsUp Gold web site.
WhatsUp Gold WhatsConfigured. This configuration management plug-in automates, and reduces the time and effort required to backup, compare, and upload configuration files for networking devices and alerts when configuration changes are detected. For more information, see the WhatsUp Gold web site.
WhatsUp Gold WhatsVirtual. This plug-in lets you monitor virtual environments using WhatsUp Gold. The WhatsVirtual plugin provides WhatsUp Gold with the ability to discover, map, monitor, alert, and report on virtual environments. For more information, see the WhatsUp Gold web site.
WhatsUp Gold VoIP Monitor. This plug-in delivers the ability to monitor and report on your network's capacity to support and maintain acceptable performance for VoIP call quality. For more information, see the WhatsUp Gold web site.
Optional applications
WhatsUp Gold WhatsConnected. This plug-in is a Layer 2/3 network mapping tool that discovers, maps and documents your network down to the individual port, making it simple to visualize the physical topology and understand device interconnections. For more information, see the WhatsUp Gold web site.
Access from mobile devices
WhatsUp Gold Mobile Access. Allows you to conveniently view your network's status from a mobile device at any time. For more information, see the WhatsUp Gold Mobile Access User Guide.

System requirements

WhatsUp Gold software requirements

Operating System (32-bit and 64-bit)	WhatsUp Gold OS support	SQL Database OS Support -Local/Remote Microsoft® SQL Server® 2005 Express Edition (included) -32-bit Microsoft® SQL Server® 2005 Standard or Enterprise Edition (optional) -32-bit or 64-bit Microsoft SQL Server 2008 Standard or Enterprise Edition (optional)	SQL Server Cluster Database Support -Remote 32-bit or 64-bit Microsoft SQL Server Cluster 2005 or 2008
Windows 7 Ultimate
Windows Vista Ultimate (SP2 recommended)
Windows Vista Business (SP2 recommended)
Windows XP Professional SP3 (32-bit only)
Windows Server 2003 SP2			*
Windows Server 2003 R2 SP2			*
Windows Server 2008 SP2
Windows Server 2008 R2 SP2

*Windows Enterprise or Datacenter

Important: If using Microsoft SQL Server Cluster 2005 or 2008, WhatsUp Gold must be configured to use a remote database. Installing WhatsUp Gold on the same server as the database cluster is not supported.

Important: WhatsUp Gold does not support non-English versions of Microsoft® SQL Server® 2005, Microsoft SQL Server 2008, or Microsoft SQL Server Cluster 2005 or 2008.

32-bit and 64-bit support for virtual server environments

Important: If WhatsUp Gold 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 WhatsUp Gold is operating on.

IIS 6, IIS 7, or Ipswitch Web Server
WhatsUp Gold Web interface: Microsoft Internet Explorer 7.0, Microsoft Internet Explorer 8.0, or Firefox 3.0
WhatsUp Gold Mobile interface: Mobile Safari 2.2, Microsoft Internet Explorer Mobile 6.1, or Opera Mini 4.2
Microsoft .NET Framework 3.5 (required), Microsoft .NET Framework 3.5 SP1 included in install
Important: Microsoft .NET Framework 3.5 SP1 is not compatible with Windows SharePoint Services 2.0. If you are running SharePoint Services 2.0, you should not upgrade or install WhatsUp Gold. WhatsUp Gold requires Microsoft .NET Framework 3.5 SP1 and automatically installs this package if not present on the system. For more information about the issue, see the Microsoft Knowledge Base article.
Microsoft Windows Scripting Host v5.7 (or later)
Note: Windows Scripting Host is installed with the Windows operating system. To verify your version, run cscript.exe at a command prompt. If you need to update Windows Scripting Host, refer to the Microsoft Windows Scripting Host site.
Microsoft SAPI 5.1 (required for Text-to-Speech actions)
WhatsVirtual plug-in supports virtual hosts and virtual machines running on VMware virtual environments including: VMware vCenter Server 4.0, VMWare ESXi 3.5 or 4.0, and ESX 4.0.

Additional software requirements for WhatsUp Gold Flow Monitor

WhatsUp Gold Flow Monitor has the same base system requirements as Ipswitch WhatsUp Gold v14.3.1. In addition, WhatsUp Gold Flow Monitor requires:

Ipswitch WhatsUp Gold v14.3.1 Standard Edition, Premium Edition, MSP Edition, or Distributed Edition
At least one routing device that supports NetFlow versions 1, 5, and 9
- or -
At least one routing device that supports sFlow versions 2 and 5

Note: WhatsUp Gold Flow Monitor performs well in most installations that use SQL Server 2005 Express. However, some large data collections, that require 4 GB of data storage or more or where data is collected and archived over a long period of time, may require 32-bit MS SQL Server 2005 Standard or Enterprise Edition, 32-bit or 64-bit Microsoft SQL Server 2008 Standard or Enterprise Edition, or 32-bit or 64-bit Microsoft SQL Server Cluster 2005 or 2008 (all editions except Microsoft SQL Server Express edition).

Hardware requirements

	Recommended	Required
Processor(s)	WhatsUp Gold: Dual-core Flow Monitor: Quad-core	WhatsUp Gold: Single-core Flow Monitor: Dual-core
Processor speed	2 GHz or more	2 GHz
RAM	WhatsUp Gold: 4 GB Flow Monitor: +4 GB	WhatsUp Gold: 2 GB Flow Monitor: +2 GB
Hard drive space for application, SQL Server Express Edition dbase application, and supporting framework	3 GB	2 GB
Hard drive space for dbase and dbase logs	WhatsUp Gold: 8 GB or more Flow Monitor: +16 GB or more	WhatsUp Gold: 4 GB Flow Monitor: +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
Sound card	SAPI-capable sound card required for Text-to-Speech actions	Not required
Modem and phone line	Required for pager, SMS, and beeper actions; modem pooling is not supported	Not required
GSM modem	Required for SMS Direct actions	Not required

Note: The WhatsConnected, WhatsConfigured, and VoIP Monitor plug-in system requirements are the same as the WhatsUp Gold requirements. Additionally, the VoIP Monitor requires Cisco IP-SLA compatible devices.

Note: WhatsUp Gold can be installed and will operate on virtual machines powered by 32-bit or 64-bit VMWare ESX 4, ESXi 3.5 or 4.0, and Microsoft Hyper-V Server 2008, as long as the virtual server's guest OS resources meet that of the WhatsUp Gold system requirements.

Installing or upgrading

Note: You can upgrade from WhatsUp Gold 11.x, 12.x, or 14.x.

Note: This product requires activation; for help activating WhatsUp Gold, go to My Ipswitch Help and Support.

Installing using Microsoft® SQL Server® 2005 Express Edition

To install WhatsUp Gold using the default Microsoft® SQL Server® 2005 Express Edition instance:

Log in directly to Microsoft Windows using the Administrator account (if you do not have an account called Administrator, use an account that has full administrative privileges to the computer).
Caution: We do not recommend using Terminal Services or Remote Desktop to install WhatsUp Gold.
Start the installation program:
- If you downloaded an electronic version of WhatsUp Gold, double-click on the downloaded file.
- If you purchased a WhatsUp Gold CD-ROM, insert the CD-ROM into the appropriate drive. If it does not run automatically, click Start, select Run, then enter the CD path followed by AutoRun.exe (for example, D:\AutoRun.exe).
Read the Welcome screen.
Click a link to view a Help resource.

Ensure that Hide advanced installation options is selected.

Click Next. The License Agreement dialog appears.
Read the license agreement. 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.
Click Next to continue. The Microsoft SQL Server Installation Options dialog appears.
Select Install Microsoft SQL Server 2005 Express Edition on this machine.
Click Next to continue.
Select the install directories for Microsoft® SQL Server® 2005 Express Edition. The application and data files are installed in default directories. To change the locations, click Browse to find and select a different directory for the application files or the data files.
Important: Make sure that you have a large capacity drive selected for data storage. The data files for WhatsUp Gold can reach a maximum size of 22 GB.

Important: During the initial installation, databases are created for WhatsUp Gold Flow Monitor. These initial databases are limited in size, but are increased the first time the Flow Monitor collector initializes. If at least 16 GB of disk space are available when the collector initializes, the maximum size of the Flow Monitor databases is increased to 4 GB each (16 GB total including transaction logs). If less than 16 GB is available, the maximum size of the Flow Monitor databases is limited proportionately to the amount of free disk space. If your license includes WhatsUp Gold Flow Monitor, we strongly recommend that you verify that you have at least 16 GB of free disk space before installing.
Click Next. The SQL Account Password dialog appears.
Specify a User Name for the account and enter and confirm a Password. You also have the option to Keep the default password.
Click Next. The installation directory dialog appears.
Select the installation directory for the WhatsUp Gold application files.
The default path is C:\Program Files\Ipswitch\WhatsUp. 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 WhatsUp Gold to a different location. To select a different location, click Change.

After you select the installation directory, click Next.

Note: If the installation program detects data from a previous installation of WhatsUp Gold, the Backup Web and Report Files dialog appears. We recommend that you select Back up the existing Web and report files, then click Next.

The Enable Web Server dialog appears.
Determine if you want to enable the WhatsUp web server.
- To enable the WhatsUp web server, select Yes and enter a port. The default port is 80.
  Important: You must select a port that is not already in use. If the port you enter is in use, you must enter a different port or stop the service using the entered port before you can continue installing WhatsUp Gold. If you choose to stop the service running on the port you want to use, you must disable it permanently. If you only disable it temporarily, a port conflict will occur the next time the disabled service is started.
- To use Microsoft Internet Information Services, select No, then see the Configuring the web server section of the Installing and Configuring WhatsUp Gold guide.
After making a selection, click Next. The Specify Web interface Admin account Password dialog appears.

Note: If the Windows firewall is enabled when WhatsUp Gold is installed, the port you specify is opened in the Windows Firewall. This allows other computers on the network to log on to the WhatsUp Gold web interface.
Either select to Keep the default Admin password, or enter and confirm a new password.
Click Next to install WhatsUp Gold.
Click Install to install WhatsUp Gold. The setup program installs and configures WhatsUp Gold.
When the installation completes, the InstallShield Wizard Complete dialog appears.
To see the release notes after the installation program closes, select View WhatsUp Gold release notes and documentation.
Click Finish. The setup program closes.

Installing using Microsoft® SQL Server® 2005 or Microsoft SQL Server 2008

You can use an existing Microsoft® SQL Server® 2005, Microsoft SQL Server 2008, or Microsoft SQL Server Cluster 2005 or 2008 to store the data collected by WhatsUp Gold. To do this, these requirements must be met:

Microsoft® SQL Server® 2005, Microsoft SQL Server 2008, or Microsoft SQL Server Cluster 2005 or 2008 English must be installed on the WhatsUp Gold host computer or another computer.

Important: Make sure that the "master" database for the existing SQL Server database instance that is hosting the WhatsUp database is configured to use case-insensitive collation.

Important: WhatsUp Gold does not support non-English versions of Microsoft® SQL Server® 2005, Microsoft SQL Server 2008, or Microsoft SQL Server Cluster 2005 or 2008.

Microsoft® SQL Server® 2005, Microsoft SQL Server 2008, or Microsoft SQL Server Cluster 2005 or 2008 must be configured to allow WhatsUp Gold to authenticate.
- If Microsoft SQL Server is installed on a remote computer, remote connections must be allowed. For more information, see How to configure Microsoft SQL Server to allow remote connections.
- Use a Microsoft SQL Server user account to connect to the database.
Microsoft SQL Server must be configured to have a user account that meets the following requirements:
- Full administrator privileges to Microsoft SQL Server, not just the WhatsUp Gold databases. WhatsUp Gold only supports accessing the database via an account with full administrator rights. WhatsUp Gold does not support using a limited access database user account.
- User's language is set to (United States) English. This can be set in the properties for the login used by WhatsUp Gold.

If you need assistance configuring or verifying these prerequisites, contact your database administrator or refer to the Microsoft SQL Server documentation.

To install WhatsUp Gold using an existing Microsoft SQL Server:

Log in directly to Microsoft Windows using the Administrator account (if you do not have an account called Administrator, use an account that has full administrative privileges to the computer).
Caution: We do not recommend using Terminal Services or Remote Desktop to install WhatsUp Gold.
Start the installation program:
- If you downloaded an electronic version of WhatsUp Gold, double-click on the downloaded file.
- If you purchased a WhatsUp Gold CD-ROM, insert the CD-ROM into the appropriate drive. If it does not run automatically, click Start, select Run, then enter the CD path followed by AutoRun.exe (for example, D:\AutoRun.exe).
Read the Welcome screen.
Click a link to view a Help resource.

Clear Hide advanced installation options. This option's selection must be cleared in order for you to use Microsoft SQL Server as the WhatsUp Gold database.

Click Next. The License Agreement dialog appears.
Read the license agreement. 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.
Click Next to continue. The Microsoft SQL Server Installation Options dialog appears.
Select Use an existing installation of Microsoft SQL Server, then click Next. The Database Server Login dialog appears.
Important: Make sure that the "master" database for the existing SQL Server database instance that is hosting the WhatsUp database is configured to use case-insensitive collation.

Tip: If you cannot remember your database server's hostname, click Browse to see a list of all database servers detected on the domain. Database servers to which you can connect but which are not configured on the same domain as the computer where you are installing WhatsUp Gold are not shown. The Browse dialog scans your entire domain, so it may take some time before showing you a list of database servers.
1. In Database server that you are installing to, enter the hostname, or hostname and instance of your database server.
Note: If you are using a database instance other than the default instance, you must include the instance name using the format <Server_Name>\<Instance_Name>.
1. In SQL Server Authentication, enter the correct Login ID and Password.
2. Click Next. The installation program attempts to validate the credentials you entered and checks for the existence of WhatsUp Gold databases on the database server.
  If WhatsUp Gold databases are found on the database server, the setup program alerts you and asks if you want to continue.
  - Select Yes to upgrade the databases and continue the installation.
  - Select No to select another Microsoft SQL Server. After the credentials are validated, the Enter Microsoft® SQL Server® 2005 Express Edition Paths dialog appears.
This dialog lists the third-party resources that the installation program installs, including Microsoft® SQL Server® 2005 Express Edition client tools (required for installations of WhatsUp Gold that use Microsoft SQL Server databases) and Microsoft .NET Framework 3.5.
Click Next. The Choose Destination Location dialog appears.
Select the installation directory for the WhatsUp Gold application files.
The default path is C:\Program Files\Ipswitch\WhatsUp. 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 WhatsUp Gold to a different location. To select a different location, click Change.

After you select the installation directory, click Next.

Note: If the installation program detects data from a previous installation of WhatsUp Gold, the Backup Web and Report Files dialog appears. We recommend that you select Back up the existing Web and report files, then click Next.

The Enable Web Server dialog appears.
Determine if you want to enable the WhatsUp web server.
- To enable the WhatsUp web server, select Yes and enter a port. The default port is 80.
  Important: You must select a port that is not already in use. If the port you enter is in use, you must enter a different port or stop the service using the entered port before you can continue installing WhatsUp Gold. If you choose to stop the service running on the port you want to use, you must disable it permanently. If you only disable it temporarily, a port conflict will occur the next time the disabled service is started.
- To use Microsoft Internet Information Services, select No, then see the Configuring the web server section of the Installing and Configuring WhatsUp Gold guide.
After making a selection, click Next. The Specify Web interface Admin account Password dialog appears.

Note: If the Windows firewall is enabled when WhatsUp Gold is installed, the port you specify is opened in the Windows Firewall. This allows other computers on the network to log on to the WhatsUp Gold web interface.
Either select to Keep the default Admin password, or enter and confirm a new password.
Click Next to install WhatsUp Gold.
Click Install to install WhatsUp Gold. The setup program installs and configures WhatsUp Gold.
When the installation completes, the InstallShield Wizard Complete dialog appears.
To see the release notes after the installation program closes, select View WhatsUp Gold release notes and documentation.
Click Finish. The setup program closes.

Upgrading WhatsUp Gold

The installation program can automatically upgrade WhatsUp Gold v11 and later. The installation program delivers new application files and upgrades the database. The installation program automatically upgrades databases on Microsoft SQL Server Desktop Edition, Microsoft® SQL Server® 2005 Express Edition, Microsoft® SQL Server® 2005, and Microsoft SQL Server 2008.

Note: WhatsUp Gold v12.3 or later introduces automatic database upgrades. It is no longer necessary to manually execute SQL scripts to upgrade a non-standard database.

Note: If you are using Microsoft® SQL Server® 2000, you must upgrade to Microsoft® SQL Server® 2005, Microsoft SQL Server 2008, or Microsoft SQL Server Cluster 2005 or 2008 prior to upgrading WhatsUp Gold. Microsoft® SQL Server® 2000 is no longer supported by WhatsUp Gold.

Tip: To upgrade from an older version than WhatsUp Gold v11, you must follow a supported upgrade path. For more information on supported upgrade paths, see the Updating from versions 8.x, 2005, or 2006 to v14.x Knowledge Base article or refer to the WhatsUp Gold Answers repository.

If the database is currently hosted on Microsoft SQL Server Desktop Edition or Microsoft® SQL Server® 2005 Express Edition but you want to migrate your database to Microsoft® SQL Server® 2005, Microsoft SQL Server 2008, or Microsoft SQL Server Cluster 2005 or 2008 complete the upgrade on the existing database, then follow the steps outlined in the WhatsUp Gold Database Migration Guide.

To upgrade from a previous version of WhatsUp Gold with a local SQL database:

Log in directly to Microsoft Windows using the Administrator account (if you do not have an account called Administrator, use an account that has full administrative privileges to the computer).
Caution: We do not recommend using Terminal Services or Remote Desktop to install WhatsUp Gold.
Start the installation program:
- If you downloaded an electronic version of WhatsUp Gold, double-click on the downloaded file.
- If you purchased a WhatsUp Gold CD-ROM, insert the CD-ROM into the appropriate drive. If it does not run automatically, click Start, select Run, then enter the CD path followed by AutoRun.exe (for example, D:\AutoRun.exe).
Read the Welcome screen.
Click a link to view a Help resource.

Important: During the upgrade process, WhatsUp Gold services and monitoring are stopped.

Click Next. The License Agreement dialog appears.
Read the license agreement. 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.
Click Next. The Back Up Existing Database dialog appears.
Since the installation program makes changes to the WhatsUp Gold database, we strongly recommend that you select Yes, back up the existing database.
Note: If you are upgrading from an installation of WhatsUp Gold 11.x that uses Microsoft SQL Server Desktop Edition as its database, you can select the location where you want to store the backup. For all other upgrades, the backup is made in the default backup location for the database server.

Click Next. The Back Up Web and Report Files dialog appears.
If you have modified any of the Web or Report files, select Back up the existing Web and report files. If this option is selected, the existing Web and report files are copied to a backup folder before the upgrade begins. We recommend that you select this option.
Click Next. The Ready to Install the Program dialog appears.
Click Install. The installation program begins upgrading WhatsUp Gold.
When the installation completes, the InstallShield Wizard Complete dialog appears.
To see the release notes after the installation program closes, select View WhatsUp Gold release notes and documentation.

Click Finish. The setup program closes.
Note: The next time you open the WhatsUp Gold console, the application may prompt you that the WhatsUp Gold services that were previously stopped during the upgrade must be restarted. Click Yes to restart the appropriate services at this time. If you click No, WhatsUp Gold is unable to poll your network devices until you manually restart the Polling Engine via the WhatsUp Services Manager (Start > Ipswitch WhatsUp Gold > Utilities > Service Manager).

IIS Web server support

Alternatively, you can configure Microsoft Internet Information Services (IIS) as the web server for the WhatsUp Gold web interface. For more information, see the Configuring the web server section of the Installing and Configuring WhatsUp Gold guide.

Refer to the topic, Using IIS on Windows XP or Windows 2003, if using the IIS 6 Web server for Windows XP or Windows 2003.

Refer to the topics, Using IIS on Windows Vista or Using IIS on Windows 2008, if using the IIS7 Web server for Windows Vista or Windows 2008.

Installing optional plug-ins

The files for most WhatsUp Gold optional plug-ins are installed automatically with Ipswitch WhatsUp Gold v14.3.1. Your license file determines whether or not you can access a plug-in.

To update your license or to purchase additional WhatsUp Gold plug-ins, visit the MyIpswitch portal.

Note: Beginning with the v14.3, WhatsConnected plug-in is not included in the WhatsUp Gold installation. For system requirements, installation information, and product updates, see the WhatsConnected release notes.

Additional installation notes for WhatsUp Gold

When upgrading from a previous version, information may not display correctly in the WhatsUp Gold web interface. This may be caused by browser caching issues. Clear the browser page cache to correct the issue.
The Telnet protocol handler is disabled by default in Microsoft Internet Explorer 7. In order to use the Telnet tool in WhatsUp Gold, you need to re-enable the Telnet protocol. For more information, see Re-enabling the Telnet protocol handler in the Help.
If you upgrade from a previous version of WhatsUp Gold and are running IIS 7 for Windows Vista and Windows Server 2008 with a non-administrator account, you must change to an administrator account.

Additional installation notes for WhatsUp Gold Flow Monitor plug-in

Flow Collector Service port number

The default port assigned to the Flow Collector Service is 9999. During installation, Flow Monitor automatically creates an exception for this port on the Windows Firewall if the firewall is enabled. If you change the default port number from the default setting, you need to change the exception port on the Windows firewall to the new port number.

sFlow Configuration

WhatsUp Flow Monitor now supports sFlow versions 2 and 5. For more information about configuring sFlow, see sFlow Configuration for Flow Monitor.

Additional installation notes for WhatsUp Gold VoIP Monitor plug-in

The following overview steps are required to implement the WhatsUp Gold VoIP Monitor, refer to Using WhatsUp Gold VoIP Monitor for detailed instructions:

Configure the Cisco source and destination devices for IP SLA UDP Jitter operations.
Install and configure the WhatsUp Gold VoIP Monitor.

Uninstalling WhatsUp Gold

To uninstall Ipswitch WhatsUp Gold v14.3.1 with Windows XP or 2003:

Select Start > Settings > Control Panel, then select Add or Remove Programs.
Select Ipswitch WhatsUp Gold.
Select Remove.

To uninstall Ipswitch WhatsUp Gold v14.3.1 with Windows Vista or Server 2008:

Select Start > Settings > Control Panel. The Control Panel dialog appears.
Under Programs, select Uninstall a Program.
Select Ipswitch WhatsUp Gold.
Select Remove.

You can also run the Ipswitch WhatsUp Gold installation program, then select Remove.

Select one of the following dialog options:

Remove the WhatsUp Gold application, but leave network data I have collected intact. This uninstalls the WhatsUp Gold program but keeps all your WhatsUp configuration data as well as the monitoring data you have collected. SQL Server 2005 Express will not be uninstalled.
Note: When this option is selected, all WhatsUp Gold, WhatsUp Flow Monitor data, and WhatsConnected configuration data is saved.
Remove both the WhatsUp Gold application, and all network data I have collected. This uninstalls the WhatsUp program and removes all of your WhatsUp configuration and monitoring data.
Note: When this option is selected, WhatsUp Gold also deletes all remote database data associated with this installation of WhatsUp Gold. Also, when this option is selected, all WhatsUp Gold, WhatsUp Gold Flow Monitor data, and WhatsConnected configuration data is deleted.
Also, remove the "WhatsUp" copy of SQL Server Express Edition. This also removes the WhatsUp SQL Server 2005 Express Edition instance that was created during the installation. Select this option to remove ALL WhatsUp components from the system.
Note: When this option is selected, WhatsUp Gold leaves SOME data behind, such as the \HTML directory and the \Data directory for situations where there may be user-modified or user-created files in those directories.

Troubleshooting

Potential SQL Server Express installation errors

DO NOT Use Terminal Services or Remote Desktop for the installation.
Check other services that may be running and stop these services during the install operation. These services include:
- Microsoft SQLServerAgent (for the "WhatsUp" instance)
- Microsoft COM Transaction Integrator
- Microsoft Distributed Transaction Coordinator (MS DTC)
- Microsoft Message Queuing
- Microsoft Search
- MSSQLServerOLAPService
If there was a previous, non-default installation of WhatsUp Gold or WhatsUp Professional that has been removed, a "WhatsUp" Data Source (DSN) may still exist. Remove the WhatsUp DSN from the Data Sources (ODBC) Control Panel and restart the install.
We do not recommend that you install Microsoft® SQL Server® 2005 Express Edition (and consequently WhatsUp) on a domain controller. The WhatsUp application and its SQL instance should be installed on a member workstation.

Configuring the firewall to allow WMI traffic

WhatsUp Gold uses Windows Management Instrumentation (WMI) to monitor and restart NT Services. For each device that is assigned an NT Service Active Monitor, you must supply the Windows credentials. Also, when creating a Service Restart Action, you must supply Windows credentials for each Action. Credentials must have administrative permissions on the remote server. Local accounts with credentials that match remote accounts are no longer required to monitor remote servers.

Credentials are configured in the WhatsUp Gold Credentials Library and used in several places throughout WhatsUp Gold. They can also be associated to devices in Device Properties > Credentials, or through Bulk Field Change for Credentials.

The use of WMI could have some implications if target devices are behind a firewall. To successfully monitor and/or restart NT Services, you need to modify firewall settings so that:

The RPC port (135) is open for connections.
The DCOM port range is defined and open for connections.

For more Troubleshooting information, see the Troubleshooting section in the application Help or User Guide.

Known issues in v14.3.1

The following are known issues in WhatsUp Gold v14.3.1:

Web Interface

WhatsConfigured Archive Search

1) In the WhatsConfigured Archive Search page, after clicking the Search button, the number of Archives Containing searched pattern does not update. 2) When you click View to view details for a result in the list, the detailed results do not appear. 3) An Ajax call error message dialog occassionally opens and resets the WhatsConfigured Archive Search page to blank. To work around these issues, use the WhatsConfigured Archive Search feature in the console.

WhatsConfigured Policy Audit

In the WhatsConfigured Archive Policy Audit page, when a user selects one of the archives and patterns, WhatsConfigured should display detailed matching result for this pattern at the bottom of this page, however nothing is displayed. To work around this issue, use the WhatsConfigured Archive Policy Audit feature in the console.

Known issues in v14.3

The following are known issues in WhatsUp Gold v14.3:

Actions

When using SNMP Set Action, the read community string is being used for credentials in place of the write community string for the WhatsUp Gold SNMP credentials. To work around this issue, enter the write credentials into the read credentials box.

Discovery

In the device discovery process, when doing a VMware Scan or an IP Range Scan and the Autoscan virtualization environments option is selected, discovery is supposed to automatically scan the VMware hosts managed by a vCenter server it has discovered. In some cases, host IP addresses are not correctly picked up during the scan of a vCenter server and hosts are not be scanned automatically as they should be. To workaround this issue:

If your discovery session type is VMware Scan: specify the IP addresses of your VMware hosts in addition of the IP address of your vCenter server in the discovery settings.
If your discovery session type is IP Range Scan: make sure the IP address of your hosts are within the range specified, or use the Smart Scan option so all your network is scanned.

Critical Active Monitors

Critical monitors are not being respected if non-critical monitors have an independent polling frequency and critical monitors are enabled. To workaround this issue, disable the critical monitor, turn off the independent polling for the active monitors that it is set on, then re-enable the critical monitor and it will now respect the critical monitor.

WhatsVirtual Performance Monitors

For VMs hosted on VMware Host, we use the VMware API to collect data through VMware host. With the API, we do not require SNMP credential settings for these VMs in order to poll the Performance Monitor data. As long as we know the VMware credential for VMware Host and relationship between VMs and VMware Host, these monitors work. However, the current discovery design uses Roles and SNMP credentials to check whether VM monitors should be selected or not when a user adds devices into WhatsUp Gold. So VMs's CPU, Memory, and Disk Performance Monitors will not be selected in the VM device properties after being added into WhatsUp Gold from discovery. A workaround for this issue is to select VMware group sub-folders, created by discovery, and use the Bulk Field Change feature (from right-click menu) to enable all CPU, Memory, and Disk Performance Monitors for all devices within selected folders.

Web Interface

Library Dialogs

The SNMP Trap Passive Monitor Instance dialog does not disable the Edit and Remove buttons when the regular expressions Match On box is empty. This causes an error if a user selects the Edit button instead of the Add button and attempts to configure a regular expression. This only occurs for the SNMP trap type.

Full Reports

Column resizing does not work for full reports in Firefox.

Translation

Exporting from the language library times out and/or causes errors with Firefox 3.6 and IIS. To workaround this issue, only export the language library if using the default web server included with WhatsUp Gold.

Multiple buttons in WhatsUp Gold are not translated in web's Go > Configure menu dialogs.

Workspace Reports

When the Top Ports workspace report is added to a workspace view in WhatsUp Gold, it lists all ports as "undefined," even though the icons for the ports are displayed correctly and clicking through applies the correct filters. To workaround this issue, delete the "undefined" filter that gets applied and filter on ports that are present (e.g. 443). The "undefined" listings go away and are replaced with the correct ports.

Device Properties Dialog

A VMWare virtual machine added to vCenter Server in device properties does not show in list until dialog is closed and re-opened. To workaround this issue, click OK then open the virtualization section again, the device appears.

Flow Monitor Reports

The Flow Monitor Interface Usage report is showing an error when sent as an attached recurring report (using the old recurring .mht report scheme). When the attached .mht file is viewed, the report page loads with an error message displayed in lieu of the report data. To workaround this issue, this report shows fine when sent using the new Scheduled Reports feature. It is only an issue with the legacy Recurring Reports (which are still available for use in the WhatsUp Gold console).

SNMP - MIBs

SNMP MIB Manager does not detect errors in MIBs.

Task Tray Application

When using the WhatsUp Gold eval install build and upgrading from previous WhatsUp Gold versions to 14.3, the upgrade calls for a reboot during the install. After the reboot, "Failed to set system tray icon." error messages may appear. The NmTaskTray process is running, however the Task Tray application is not visible. In some instances this error persist after activation and randomly pops-up while working within WhatsUp Gold until the NmTaskTray process is stopped and restarted. This issue is consistently seen in the following cases: once you reboot after install upgrade requests a reboot, adding devices after a device discovery, and after restarting the Ipswitch Service Control Manager. To work around this issue, reboot the machine a second time after the upgrade reboot request. After the reboot, the issue should stop.

Console Help

Some console help topics, that include code examples, may display the html code in the example. To workaround this issue, press F5 to refresh the page and display the code example without the html code.

WhatsUp Gold Standard, Premium, Distributed, and MSP

The option to export maps to Microsoft Visio has been removed from WhatsUp Gold. However, if you have WhatsConnected plug-in, you can export WhatsConnected maps to Visio. For more information, please see the WhatsConnected plug-in Help.

For more information

Application Help for the console and web interface. The console and web help contain 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, or the ? icon in the web interface.
Getting Started Guide. This guide provides an overview of WhatsUp Gold, information to help you get started using the application, the system requirements, and information about installing and upgrading. The Getting Started Guide is available on the WhatsUp Gold web site.
Additional WhatsUp Gold resources. For a listing of current and previous guides and help available for WhatsUp Gold products, see the WhatsUp Gold web site.
WhatsUp Gold optional plug-ins. You can extend the core features of WhatsUp Gold by installing plug-ins. For information on available plug-ins and to see release notes for each plug-in, see WhatsUp Gold plug-ins documentation.
Licensing Information. Licensing and support information is available on the MyIpswitch licensing 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.