Release Notes for Ipswitch WhatsUp Gold v14

In this File

Release Notes for Ipswitch WhatsUp Gold v14

Release information

Product name	Ipswitch WhatsUp Gold v14
Version	v14.0
Release date	July 2009

New in WhatsUp Gold v14.0

Added new Welcome Center where you can access the latest information about WhatsUp Gold, such as product information, blog articles, videos, and more. The Welcome Center also includes the Quick Setup Assistant that steps you through configuring WhatsUp Gold for the first time so you can monitor your network as quickly as possible.
Added a new Discovery console and new Discovery web interface that includes an improved discovery engine to identify network devices more accurately. It also uses new device roles that can automatically create and configure monitors based on the detailed information found during the discovery process.
Note: Some functionality within Device Types has been redesigned into the new Role Settings feature located within the new Discovery Console.

Note: The new scheduled discovery replaces the active discovery feature in WhatsUp Gold versions prior to v14. Run the ConvertActiveDiscovery.exe utility to import previous active discovery schedules to the new scheduled discovery feature. The utility is located at ..\Program Files\Ipswitch\WhatsUp\ConvertActiveDiscovery.exe.
Introduced Alert Center, which provides the ability to alert on performance data. You can configure thresholds that alert on Performance, Passive, Flow Monitor, and System data.
Added support for defining a specific polling order for a device's active monitors using Critical Active Monitors (intra-device dependencies). Now you can make one monitor dependent on another monitor on the same device to avoid getting multiple alerts on the same device if network connectivity is lost.
WhatsUp Gold v14 Premium Edition includes several new active monitors:
- APC UPS
- Exchange (to support Microsoft Exchange 2007/2010 Beta1)
- Fan
- File Properties
- Folder
- FTP
- HTTP Content
- Printer
- Process
- Power Supply
- Network Statistics
- Microsoft SQL and MySQL Query
- Temperature
Added several new actions:
- SNMP Set Action
- Windows Event Log Action
- Text Log Action
Integrated a new percent variable picker for use in the Windows Event Log and Text Log actions.
Added new find device feature to search for WhatsUp Gold managed devices.
Added support for Cisco and Juniper Netscreen CPU and Memory Performance Monitors.
Added an Argument column to the Device Properties - Active Monitors, Device Properties - Polling > Up and Down Dependencies, and Critical Monitor dialogs to help differentiate network interface instances.
Added support for 64-bit versions of Windows Server 2003, Windows XP Professional, Windows Vista, and Windows 2008 Server.
Added support for MS SQL Server 2008 Standard or Enterprise Edition.
Added support for VmWare ESXi 3.0 or later.
Added support for Microsoft Hyper-V Server 2008.
Added support for ADO credential types in the Credentials Library.
Improved the Help search functionality.
Added option to change Admin password in the WhatsUp Gold installation program.
Numerous defect fixes.

New in WhatsUp Gold Flow Monitor plug-in

Changed the product name from "WhatsUp Gold NetFlow Monitor" to "WhatsUp Flow Monitor."
Added Flow Monitor user permissions to allow/disallow access for specific user(s) to Flow Monitor sources.
Added support for sFlow and J-Flow (sampled NetFlow).
Added Flow Monitor reports:
- Interface Usage
- ICMP Type workspace report*
- Packet Size Distribution workspace report*
  *Can be added as a filter to the Interface Details report
Added improved Flow Monitor report configuration to allow fields in the Top Sender and Receiver workspace reports to sort by Bytes, Packets, Flows.
Added WhoIs information for Sender and Receiver reports.
Flow Monitor performance improvements.
The interface ifIndex # is now available in the Flow Interface dialog.

Fixed in WhatsUp Gold v14.0

Added a warning message clarifying that WinPopup actions cannot be used on Windows Vista or later, as net send command is not supported by those operating systems.
Added validation to warn if a customer performance monitor using the range of values option is configured to use a non-numeric or OCTET STRING value.
Added validation to Web Performance Monitor tool to prevent an error message when selecting an invalid WMI counter.
Began logging errors encountered while upgrading the WhatsUp Gold database to the RemoteDBConfig.txt log file.
Corrected a polling engine crash when %COMPUTERNAME% was included as part of a Windows credential used by the NT Service active monitor.
Corrected error in Active Script API that caused Context.GetProperty("DeviceID") to sometimes return the wrong ID if multiple devices were configured with the same IP address.
Corrected error that prevented WhatsUp Gold from collecting performance monitor data and updating device state in some cases.
Corrected problem that caused the WhatsUp Gold mobile interface to redirect to an incorrect port in some cases.
Corrected problem where data range was corrupted when viewing the Previous Month date range option in some cases.
Corrected problem where State Change Timeline report was enforcing group access rights even if group access rights were not enabled.
Fixed "arithmetic overflow error" in the Quarterly Availability Summary report.
Fixed "Upgrade advisor returned: -1" error sometimes seen when upgrading from versions of WhatsUp Gold using MSDE database.
Fixed error that caused traps issued by devices with more that one credential type to be duplicated in the database.
Fixed error that prevented Disk Utilization-Last Polled Value (Single Device) workspace report from reporting values for Unix devices.
Fixed issue that caused "JSON Parse error" dialogs to appear in the Web interface after long periods of inactivity.
Fixed problem that caused characters from multi-byte languages (Japanese, Chinese, and Russian) to display as question marks in some locations in the Web interface.
Fixed the State Change Timeline report to respect the start and end times specified.
Updated how active monitors that have been disabled are displayed in the Device Properties Active Monitors list. Prior to v14 a disabled active monitors were indicated with "[disabled]" appended to the disabled active monitor name. Now a disabled active monitor is indicated by the active monitor name being greyed out.
Fixed timing issue that caused NetFlow Collector service to fail to start after installation.
Modified the "Interface - Last Polled Values (Single Device)" workspace report to exclude interfaces for which no data has been collected.
To prevent Web browsers from showing security warnings when viewing Flow Monitor reports over HTTPS, added option to prevent the Flow Monitor reports from retrieving favicons when the report is viewed using SSL.
Updated split second graphs and InstantInfo popups to use devices' IP addresses instead of hostnames.
Updated the Flow Monitor Log report to respect the Access Flow Monitor Reports permission.
Corrected several typographical errors and incorrect hyperlink references in the help system.
Improved documentation for Active Script Active Monitors, Performance Monitors, and Actions.
Corrected issue that prevented Active Script Performance Monitors from accessing 64-bit WMI counters correctly.
Corrected issue that caused Web Alarms to use the wrong sound after a new sound file was selected.
Updated Attributes property page of the Device Properties dialog in the Web interface to sort attributes alphabetically.
Corrected issue that prevented filters applied to Flow Monitor workspace reports to be lost when those reports were used in recurring reports.
Updated Remote Tail of Action Activity Log workspace report to display icons even if no connection is available between the Central site and the Remote site.
Corrected error that caused the polling engine to crash if percent sign (%) was included in active monitor configurations.

About WhatsUp Gold editions

These release notes apply to all editions of Ipswitch WhatsUp Gold v14. 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
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 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.
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.
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

32-bit and 64-bit support for the following OS versions: Windows XP Professional SP2 (or later), Windows Server 2003 SP2 (or later), Windows Vista Ultimate (SP2 recommended), Windows Vista Business (SP2 recommended), or Windows Server 2008 (SP2 recommended)
32-bit and 64-bit support for the following virtual server environments: VMWare ESXi 3.0 or later and Microsoft Hyper-V Server 2008.
Important: If WhatsUp Gold is hosted on VMWare 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.
Microsoft SQL Server 2005 Express Edition (included), SQL Server 2005 Standard or Enterprise Edition or MS SQL Server 2008 Standard or Enterprise Edition (optional)
Important: WhatsUp Gold does not support non-English versions of Microsoft® SQL Server® 2005 or Microsoft SQL Server 2008.
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 v14. WhatsUp Gold v14 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)

Additional software requirements for WhatsUp Gold Flow Monitor

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

WhatsUp Gold v14 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 version 5

Note: WhatsUp Gold Flow Monitor 14 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 MS SQL Server 2005 Standard or Enterprise Edition or MS SQL Server 2008 Standard or Enterprise 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 and VoIP Monitor plug-in system requirements are the same as the WhatsUp Gold requirements. Additionally, WhatsConnected supports Microsoft Visio 2003 or 2007 English version only and 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 ESXi 3.0 or later 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 TPP3.

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

Note: The Release Notes contain the most up-to-date information about installing WhatsUp Gold. Read the release notes to prior to installing to be aware of any potential installation issues.

Before installing WhatsUp Gold, you must decide where you want to store the network management data WhatsUp Gold generates.

By default, WhatsUp Gold installs Microsoft® SQL Server® 2005 Express Edition on the same computer where WhatsUp Gold is installed. This configuration works well for most networks. However, Microsoft® SQL Server® 2005 Express Edition has a database size limit of 4 GB which may be too small to contain the data collected on larger networks.

Alternatively, you can configure WhatsUp Gold to use an existing Microsoft SQL Server database. Microsoft SQL Server is not limited in size like Microsoft® SQL Server® 2005 Express Edition, but it does require a knowledgable database administrator to configure and maintain it.

Note: The installation instructions in this document apply only to WhatsUp Gold Standard Edition and WhatsUp Gold Premium Edition. For installation instructions for WhatsUp Gold Distributed Edition or WhatsUp Gold MSP Edition, see WhatsUp Gold Distributed Edition Deployment Guide or WhatsUp Gold MSP Edition Deployment Guide.

Installing using Microsoft® SQL Server® 2005 Express Edition

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

Important: WhatsUp Gold systems running on Microsoft Windows Vista require a reboot during the install process if .NET 3.5 (SP1) has not been installed prior to the WhatsUp Gold install.

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.

Note: When installing on Windows Vista, additional steps are necessary for the Task Tray application to work properly. For more information, see Task Tray Application fails on Windows Vista in the Help.
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 button next to an additional resource to view that resource.

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.
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 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: 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 Back up 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.
  Note: 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 Configuring the web server in the Help.
  After making a selection, click Next.
  
  Note: If the 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.
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 or Microsoft SQL Server 2008 to store the data collected by WhatsUp Gold. To do this, these requirements must be met:

Microsoft® SQL Server® 2005 or Microsoft SQL Server 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 or Microsoft SQL Server 2008.

Microsoft® SQL Server® 2005 or Microsoft SQL Server 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.
- We recommend using a Microsoft SQL Server user account to connect to the database. However, if the Microsoft SQL Server database exists on the same computer or both computers are members of the same domain, you may use Windows Authentication. For more information about enabling mixed mode authentication in Microsoft SQL Server, see the Microsoft article about Authentication Mode.
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:

Important: WhatsUp Gold systems running on Microsoft Windows Vista require a reboot during the install process if .NET 3.5 (SP1) has not been installed prior to the WhatsUp Gold install.

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.

Note: When installing on Windows Vista, additional steps are necessary for the Task Tray application to work properly. For more information, see Task Tray Application fails on Windows Vista in the Help.
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 button next to an additional resource to view that resource.

Clear Hide advanced installation options. This checkbox 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.
1. In Database server that you are installing to, enter the hostname of your database server.
  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.
  
  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>.
  
  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.
2. Select the appropriate authentication method for your database server.
  - If your database server is a member of a domain and is configured to accept Windows user names, select Windows authentication. The user whose credentials you use to run WhatsUp Gold must be a member of the same domain as the database server.
  - If your database server requires SQL Server authentication, or if the Windows user account under which WhatsUp Gold runs does not have access to the database server via Windows authentication, select SQL Server authentication using Login ID and password below, then enter the correct Login ID and Password.
3. 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: 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 Back up 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.
  Note: 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 Configuring the web server in the Help.
  After making a selection, click Next.
  
  Note: If the 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.
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 or Microsoft SQL Server 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.0 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 or Microsoft SQL Server 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:

Important: WhatsUp Gold systems running on Microsoft Windows Vista require a reboot during the install process if .NET 3.5 (SP1) has not been installed prior to the WhatsUp Gold install.

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.

Note: When installing on Windows Vista, additional steps are necessary for the Task Tray application to work properly. For more information, see Task Tray Application fails on Windows Vista in the Help.
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 notice about device limit enforcement.
- Select Yes to continue the upgrade.
- Select No to abort the upgrade.
  Note: If you upgrade and you are currently managing more devices than your license allows, WhatsUp Gold will not poll your devices after the upgrade until you take additional action. To find out more about how device limits work and to determine if you are affected, see Are you managing more devices than your license allows?.
Read the Welcome screen.
Click a button next to an additional resource to view that 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.

IIS Web server support

Refer to the Help 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 Help topics, Using IIS on Windows Vista or Using IIS on Windows 2008, if using the IIS7 Web server for Windows Vista or Windows 2008.

Uninstalling WhatsUp Gold

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

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

To uninstall Ipswitch WhatsUp Gold v14 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.

Installing optional plug-ins

The files for WhatsUp Gold optional plug-ins are installed automatically with WhatsUp Gold v14. 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.

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 version 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.

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

The following are known issues with WhatsUp Gold v14:

When upgrading from a previous version to 14, 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 new scheduled discovery replaces the active discovery feature in WhatsUp Gold versions prior to v14. Run the ConvertActiveDiscovery.exe utility to import previous active discovery schedules to the new scheduled discovery feature. The utility is located at ..\Program Files\Ipswitch\WhatsUp\ConvertActiveDiscovery.exe.
During a new discovery, WhatsUp Gold checks the maximum number of IP addresses (MaximumNumberAddressPerSession) before checking the scan exclusion list (SubnetSkipList) sometimes causing Smart Scan to exceed the maximum number of IP addresses per session. For more information, see the related KB article.
Alert Center - WUG Health Threshold: WhatsUp Web Server performance counters fail when running under terminal services with multiple logins.
Alert Center Home page report data does not load when sent as an attachment in a recurring report. To work around this issue, select the option to send the recurring report as a url link.
Recurring report emails cannot be read by Microsoft Outlook 2007. Outlook 2007 uses a different HTML rendering engine than previous versions of Outlook, and this engine does not support advanced HTML features required by the recurring reports emails. To use recurring reports with Outlook 2007, include the report as an attachment.
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.
If User Access Control (UAC) is enabled on a Windows Vista or Windows 2008 system running WhatsUp Gold and an Admin user (other than the default Admin user) logs into the system, an access to registry key denied message appears. To work around this issue, make sure that the UAC for Windows Vista or Windows 2008 is turned off for any Windows Admin using WhatsUp Gold.
Internet Explorer may leak handles if the Web Performance Monitor, Web Task Manager, or Workspace views that include a Split Second Graph report are viewed for an extended period of time (more than 12 continuous hours). Restarting Internet Explorer should resolve the issue.
In WhatsUp Gold Central Edition, the WhatsUp Engine is restarted after users visit Program Options > Central and click OK, regardless of whether a change is made on the dialog. If no change is made, users should click Cancel to exit the dialog.
In the State Change Timeline Report, any monitor having a state change that starts or ends, but does not wholly exist during the selected time period does not appear in the report. The intended behavior for this report is to display the state changes that start, or start and end during the time range. For more information see the State Change Timeline report knowledge base article.
To use the SQL Query Monitor to monitor a MySQL database, you must first download and install the MySQL .NET connector. Because of compatibility issues with later versions, only MySQL version 5.2.5 .NET connector is supported. This connector is located on the WhatsUp Gold website. This link downloads the mysql-connector-net-5.2.5.zip file. Once downloaded, extract the MySQL.Data.msi and run the MySQL Connector Setup utility by double-clicking on the MySQL.Data.msi icon. On the Choose Setup Type screen, select Typical and click Install. The MySQL .NET connector is installed at the following location: C:\Program Files\MySQL\MySQL Connector Net 5.2.5\. After the .NET connector has been installed, restart WhatsUp Gold.
WhatsUp Gold resolves to an invalid URL when you click the browse (...) button on the Device Toolbar workspace report, or right-click on a device in the Device list or Map and select Tools > Browse.
When viewing the Flow Monitor's Top Senders and Top Receivers workspace reports after upgrading from a prior version, a SQL error may be displayed instead of the report. To resolve the error, run the below SQL statement to clear the cached settings for the reports.
DELETE FROM [WhatsUp]..[WebStickyProperty] WHERE sContext = N'NetflowStickyProperties' AND (sName LIKE N'%:11110:sReportURL' OR sName LIKE N'%:11115:sReportUrl')

Note: The double periods in the SQL statement are intentional.

If you need assistance performing this operation, please contact Technical Support.
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 v14. WhatsUp Gold v14 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.

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 guides. For a listing of current and previous guides and help files available for WhatsUp Gold's multiple versions, 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.
Knowledge Base. Search the Ipswitch Knowledge Base of technical support and customer service information. The knowledge base is available on the WhatsUp Gold web site.
Support community. Use the WhatsUp Gold community site to interact with other WhatsUp Gold users and share helpful application information on the forums, view KBs and documentation, submit new product ideas, access the script library, and keep up with the latest news on the blog. The wugSpace support community for WhatsUp Gold is available on the WhatsUp Gold community site.