VMware

VMware vCenter Infrastructure Navigator 5.7 Release Notes

VMware vCenter Infrastructure Navigator Version 5.7 | 22 September 2013 | Build 1317456

Last Document Update: 23 September 2013

This release note describes the following topics:

Introduction to vCenter Infrastructure Navigator

VMware vCenterTM Infrastructure NavigatorTM is an application awareness plug-in to vCenter Server that provides continuous dependency mapping of applications. vCenter Infrastructure Navigator offers application context to virtual infrastructure administrators, to monitor and manage the virtual infrastructure inventory objects and actions. Administrators can use vCenter Infrastructure Navigator to understand the impact of change on the virtual environment in their application infrastructure. vCenter Infrastructure Navigator helps virtual infrastructure administrators perform the following tasks:

  • Make accurate first-level triage decisions to help either eliminate a problem, or associate a problem with the virtual infrastructure when business service users report problems.
  • Assess change impact. Manage and communicate virtual infrastructure issues for critical applications.
  • Understand the application and business impact of changes to the virtual infrastructure on applications.

Licensing

The Open Source Licenses (OSL) file for the virtual appliance is available at /root/open_source_licenses.txt. You can retrieve the file by running the scp root@<appliance IP>:open_source_licenses.txt command.

Supported VMware Environments

vCenter Infrastructure Navigator is supported on vCenter Server 5.1 U1 and 5.5, with the vSphere Web Client 5.5.

In addition to all builds of ESXi 5.x, the following ESX/ESXi versions are supported.

  Server ESX (ServerPkg) ESXi (VMvisorPkg)
4.1.0 P03

433742, 449664,
477600, 477631,
502767, 502790,
538356, 538358,
582267, 582832,
659050, 659051
702113, 702114,
721871, 721872,
800380, 800386,
811143, 811144,
874690, 883381,
918807, 988178,
1005035, 1034475,
1040946

433803, 449808,
502847, 502854,
544764, 544767,
582837, 523955,
584154, 650334,
659759, 659760
702896, 702897,
728620, 728622,
810405, 811866,
811867, 811904,
811905, 902946,
902947, 993546

433804, 449810,
502848, 502855,
582815, 582819,
583032, 601443,
606757, 661102,
661103, 702956,
702957, 728621,
728623, 810419,
811869, 811906,
811907, 874829,
890840, 919174,
964601, 993568,
1005273, 1034605,
1041093

4.0.0 U3

398348, 398350,
480973, 480974,
504849, 504850,
538074, 660575,
660580, 702116,
702117, 721907,
721909, 989856,
989865

403553, 481212,
481518, 523312,
523313, 540755,
540756, 660861,
660869, 703609,
703665, 728611
728612, 990419,
991257

403554, 403555,
481180, 481213,
523315, 523318,
660862, 660870,
702894, 702895,
728607, 728608,
990420, 991258

3.5 P25 391406, 437453,
604481, 702112,
725354, 725378,
988599

408533, 634899,
634900, 702903,
726914, 726917,
989175

409724, 630714,
630715, 702539,
702904, 726915,
727049, 1014937

You can view an interoperability matrix by clicking this link.

What's New in this Release

vCenter Infrastructure Navigator 5.7 provides the following new features:
  • The vFabric Hyperic agent management functionality provided by vCenter Infrastructure Navigator 5.7 enables you to automate the deployment of vFabric Hyperic agents in your virtual environment and to monitor and manage the agents' status.
  • Users who do not have Admin credentials, but who have "Read" or higher credentials for a virtual machine, can view the vCenter Infrastructure Navigator interface on that machine. The content that is displayed in vCenter Infrastructure Navigator maps on a virtual machine is relative to the access permissions of the user. vCenter Infrastructure Navigator settings can only be accessed by a user with Admin credentials.

vCenter Infrastructure Navigator Documentation

Additional documentation is available through the vCenter Infrastructure Navigator 5.7 Documentation Center.

Upgrading from Version 2.0 to Version 5.7

Prerequisite Before you upgrade vSphere Infrastructure Navigator from version 2.0 to version 5.7, verify that you are using vCenter Server 5.5.

Procedure

  1. On your instance of the vSphere Infrastructure Navigator management interface API (http://<your-vin-ip>:5480), click Update > Settings.
  2. Select the Use Specified Repository option and type http://vapp-updates.vmware.com/vai-catalog/valm/vmw/302ce45f-64cc-4b34-b470-e9408dbbc60d/5.7.0.798.latest/ in the Repository URL text box.
  3. On the Status tab, click Check Updates.
    A notification that an update has been found appears.
  4. Click Install Updates.
    The update process begins. Updating can take several minutes.
  5. When the update is complete, restart the vSphere Infrastructure Navigator virtual machine.
  6. Verify that the vSphere Infrastructure Navigator virtual machine is up and running, and restart the vSphere Web Client service.

Note: If the vSphere Infrastructure Navigator or vCenter Server IP address is changed during the upgrade procedure, you must rebind vSphere Infrastructure Navigator with vCenter Server.

Known Issues

The following issues are known to exist in vCenter Infrastructure Navigator 5.7.

  • vSphere Infrastructure Navigator does not support the installation of vFabric Hyperic agents on virtual machines running Windows 2003.
  • You cannot have more than one instance of MSSQL on a virtual machine. If you do have multiple instances with different versions, for example MSSQL 2010 and MSSQL 2012, on the same virtual machine, both services will be discovered as the latest version.
  • When a virtual machine with multiple IP addresses has several services running on the same port, those services are not discovered.
  • Non-ASCII characters are not accepted in passwords in vCenter Infrastructure Navigator.
  • If failover occurs in HA and FT environments, it is difficult to predict whether vCenter Infrastructure Navigator can still monitor the virtual machines that have failed over.
  • Some configurations of vCenter Infrastructure Navigator might be present on the ESX hosts and virtual machines that were previously discovered by vCenter Infrastructure Navigator but were removed before performing the uninstall process of vCenter Infrastructure Navigator.
  • Discovery fails on Linux virtual machines where the temporary directory is a symlink and the virtual machine is installed with VMware Tools version 3.5. You can fix this issue by either updating VMware Tools to a more recent version or by not having the temporary directory symlink.
  • After the uninstall process of vCenter Infrastructure Navigator is completed, the uninstall message stating that the uninstall process is complete does not appear unless you manually refresh the vSphere Web Client.
  • When multiple vCenter Severs are working in a SSO mode, you must log in as a domain administrator that exist on all the vCenter servers to view the vCenter Infrastructure Navigator portlets, and dependency maps.
  • If the Windows Management Instrumentation Command-line (WMIC) service is removed or disabled on a virtual machine, vCenter Infrastructure Navigator does not discover any services running on that virtual machine. In addition, the vSphere Web Client displays an Access failed. Unable to run 'wmic' command on the guest operating system message.
  • vCenter Infrastructure Navigator carries out the discovery process appropriately only if the free disk space available on each of the discovered virtual machines is greater than 5MB. vCenter Infrastructure Navigator displays an error message indicating insufficient space, and the discovery process on that specific virtual machine is stopped until the required free disk space is available.
  • vCenter Infrastructure Navigator does not discover all the versions of a specific service. See vCenter Infrastructure Navigator User's Guide for a detailed list of supported services and their supported versions.
  • When the vShield Manager 5.0 appliance is discovered, the vCenter Infrastructure Navigator user interface does not display the used ports of the discovered service.
  • IPv6 address format is not supported by vCenter Infrastructure Navigator.
  • When you click Show More Dependencies in the dependency map, a group of virtual machines is expanded and added to the dependency map. However, you cannot collapse the same group of virtual machines by clicking the same button. You need to hide the virtual machines one after the other.
  • vCenter Infrastructure Navigator takes approximately 40 seconds to display the dependency map of a virtual machine with more than 70 dependencies.
  • Sometimes the host name of the vCenter Infrastructure Navigator appliance might not persist across reboots and is reset to localhost.localdomain.
  • In a dependency map, when you click the expand or collapse icon to view the list of services within a virtual machine, the layout of dependency map might change. The virtual machine that you have just clicked might move to a different location within the dependency map.
  • If the host name of the vCenter Server does not have a DNS name, vCenter Infrastructure Navigator displays an error message when it exposes data to the vCenter Server inventory service.
  • After the successful upgrade of vCenter Infrastructure Navigator virtual appliance, the latest appliance version is not updated on the Summary tab of the vSphere Client and vSphere Web Client. The Settings tab of the vCenter Infrastructure Navigator home page and the Plug-in Management page in the vSphere Web Client display the correct version.
  • If an external machine has DNS lookup defined, but does not have reverse DNS lookup defined, the dependency map and dependency tab in the vSphere Web Client does not display the external DNS name, but instead displays the external IP address.
  • Info Panel categorizes all processes with a unique key, process identification (PID), for each entry, but PID is not shown in the Info Panel. As a result, you can see same process name associated with different port or one process name is associated with a list of ports.
  • The length of the DNS name of the external virtual machines might vary from one environment to another.
  • After you deploy vCenter Infrastructure Navigator on a vCenter Server 5.1 that does not have a Fully Qualified Domain Name (FQDN) that is resolvable by the DNS, vCenter Infrastructure Navigator fails to register at the vCenter Extension vService. This issue does not occur on a VCVA because VCVA inserts localhost.localdom as the vCenter Server name.
    Workaround: Type the IP address of the vCenter Server in the vCenter Server name text box and deploy the vCenter Infrastructure Navigator virtual appliance again.
  • In the Dependency Map, if you click the unknown service link before spotlighting a virtual machine, the Dependency Map might become unavailable.
    Workaround: Log out from the vSphere Web Client and log in again. To prevent this, first spotlight the virtual machine and then click the unknown service link.
  • vShield Edge discovery is not supported because of security provisions limitation.
  • You cannot start the SRM integration on a vCenter Server where multiple SRM instances are installed because vCenter Infrastructure Navigator supports only one installed SRM instance with the default SRM extension name.
  • VMware signed certificates might get revoked. vCenter Infrastructure Navigator does not check the revocation of the certificates and hence you might not be notified if certificates get revoked. If the certificates get revoked, you can change them manually or contact VMware technical support for assistance.
  • On some occasions, incorrect message appear in the vSphere Web Client, Access failed. An unknown session error has occurred when no free space is left on the target virtual machine. The correct message that should appear is Disk is Full.
  • If you have vCenter Infrastructure Navigator virtual appliance deployed on vCenter Server 5.1 and if you upgrade vCenter Server 5.1 to vCenter Server 5.5, you must restart the vCenter Infrastructure Navigator virtual appliance.
  • Some user interface elements, such as the inventory table or the Navigator portlet on the Summary tab, might take few minutes to populate the data, depending on the number of related services running in your environment.
  • After the upgrade of vCenter Infrastructure Navigator from version 2.0 to version 5.7, the An internal error has occurred - index 0 specified is out of bounds error message appears in the vSphere Web Client.
    Workaround: Clear the cache of the browser and log in again in the vSphere Web Client.
  • Discovery fails on virtual machines with a BusyBox Linux installation. with the error Could not find command: netstat. The command is installed on the machine but it does not have all the parameters that vCenter Infrastructure Navigator uses while netstat is running.