VMware vRealize Operations for Horizon 6.2.1 Release Notes
vRealize Operations for Horizon 6.2.1 | 17 MAR 2016
Last Document Update: 21 NOV 2016
Check frequently for additions and updates to these release notes.
These release notes include the following topics:
VMware vRealize™ Operations for Horizon™ extends the functionality of VMware vRealize™ Operations Manager™ to monitor and manage VMware Horizon™ with View™ environments.
vRealize Operations for Horizon collects data about your resources and presents that data in preconfigured dashboards for both real-time and predictive analysis.
What's New in This Release
vRealize Operations for Horizon 6.2.1 includes the following new features.
- As of 21 NOV 2016, there is a new vRealize Operations for Horizon Broker
Agent available that addresses an issue caused by an expired digital signature. See Resolved Issues for more information.
- VMware Horizon 7 Support - In addition to Horizon 6, customers deploying Horizon 7 can also monitor day-to-day operations and on-going performance of their new environment. Metrics and dashboards generate valuable infrastructure capacity, resource usage, user activities, and more of their Horizon 7 deployment.
vRealize Operations for Horizon has the following limitations.
- The RMI registry port 3091 is reused in vRealize Operations for Horizon 6.2.1 adapter.
The communications ports are 3099 and 3101 for the Horizon 6.2.1 message server. The message server objects for Horizon 6.1 and 6.2.1 are registered to this port.
- Physical desktops in a pool are not monitored
Physical desktops included in a desktop pool are not monitored or shown in the user interface. However, physical RDS hosts are monitored and shown in the user interface.
- High availability (HA) is not supported
vRealize Operations for Horizon 6.x does not support high availability (HA). If a View Adapter instance is moved to a different cluster node, the broker and desktop agents can no longer communicate with the View Adapter and the vRealize Operations for Horizon solution stops functioning. For solutions to this problem, see KB: 2092874: Best practices for configuring vRealize Operations for Horizon when HA is enabled.
- You should wait sometime after the adapter service is restarted. Otherwise the adapter might not get started.
- Make sure the vRealize Operations Manager does not have multiple network cards for multiple sub networks. It might make adapter instance bind to incorrect IP address.
- The adapter configuration file /usr/lib/vmware-vcops/user/plugins/inbound/V4V_adapter3/conf/msgserver.properties and /usr/lib/vmware-vcops/user/plugins/inbound/V4V_adapter3/work/msgserver.properties should be updated at the same time.
- The Broker Agent 6.1 and Desktop Agent 6.1 cannot communicate with Adapter 6.2.1 even if pairing is succeeded because TLS 1.0 is disabled by default. A hand shake exception will be thrown.
- The configuration file of old adapter instance is not purged during upgrade. Therefore, if other SSL protocol/ciphers is configured in adapter side, the broker and desktop agent might cause a hand shake failure. Configure some protocol and ciphers on adapter and agents.
- The adapter can run on the collector node. It cannot run on the data node or the replica node.
Top of Page
This section contains notes on the licensing of vRealize Operations for Horizon 6.2.1.
- To run vRealize Operations for Horizon, customers need to enter two keys.
- A single vRealize Operations Manager license key.
- A 10 pack or 100 pack vRealize Operations Manager license key that monitors your desktop virtual machines.
- The VMs must be part of the appropriate licensing groups in order to ensure accurate licensing. For detailed licensing instructions, see Adding a vRealize Operations for Horizon License Key and Associate View Objects with Your vRealize Operations for Horizon License Key in the vRealize Operations for Horizon Installation guide.
Customers upgrading from vCenter Operations Manager to vRealize Operations Manager may perceive this licensing change as a reduction in the number of virtual machines they can manage. This is not the case - following the above steps and the steps in the vRealize Operations for Horizon Installation guide will ensure that all your VMs are monitored and are license compliant.
- The vRealize Operations Manager component license that is included is for Horizon-supporting infrastructure monitoring. A separate vRealize Operations Manager license is required for non-Horizon infrastructure monitoring.
This section contains notes on the installation process for each vRealize Operations for Horizon component. For complete installation instructions, see the vRealize Operations for Horizon Installation document.
- vRealize Operations Manager for Horizon 6.2.1 is compatible with the following Horizon and vRealize Operations Manager versions:
- VMware Horizon with View 6.0.x
- VMware Horizon 7
- You download the vRealize Operations for Horizon installation files from the VMware download page.
- You can download the preconfigured View dashboards file (Dashboards_V4VAdapter-6.2.1-xxx.zip) and report templates file (Reports_V4VAdapter-6.2.1-xxx.zip) from the VMware download page. View dashboards and reports are installed automatically when you install vRealize Operations for Horizon. These files are provided in case problems occur during or after installation and you need to restore the dashboards or reports to their original state. For information about importing dashboards and reports, see the vRealize Operations Manager documentation.
- You install the View adapter on a vRealize Operations Manager cluster node or remote collector.
- You install the vRealize Operations for Horizon broker agent on a View Connection Server host in your View environment.
- Your View version determines how you install the desktop agent component of vRealize Operations for Horizon.
- Horizon Desktop Agent includes a version of vRealize desktop agent. Horizon 6.0.1 ships Desktop Agent 6.0, Horizon 6.1 and 6.2 ships Desktop Agent 6.1, and Horizon 6.2.1 ships Desktop Agent 6.2.1. Check the VMware website for the latest available version.
- For sizing and scaling guidelines, see KB 2098051: vRealize Operations for Horizon sizing guidelines.
This section contains notes of the upgrade processes. For complete upgrade instructions, see the vRealize Operations for Horizon Installation document.
- You can upgrade to vRealize Operations for Horizon 6.2.1 from vRealize Operations for Horizon 6.2 and vRealize Operations for Horizon 6.1. Customers with vRealize Operations for Horizon 6.0 must first upgrade to vRealize Operations for Horizon 6.1 before upgrading to vRealize Operations for Horizon 6.2.1.
- During the upgrade process, the dashboards, views, and reports from the vRealize Operation for Horizon 6.1 are retained and new dashboards, views, and reports are added. Old dashboards, views and reports are identified by the View prefix, and the new dashboards, views and reports are prefixed with Horizon. You can remove old dashboards, views, and reports.
- After the adapter upgrade, enable the port numbers 3099, 3100, and 3101. Edit the /opt/vmware/etc/vmware-vcops-firewall.conf file in the vRealize Operations Manager.
Due to an existing limitation, vRealize Operations Manager cluster must be restarted after the upgrade for the process to complete.
Sessions that were active during upgrade may not report data after the upgrade is complete. Restart the desktop agent for the active sessions that are not reporting.
During the Broker Agent upgrade process from 6.1 or 6.2 to 6.2.1, vRealize Operations for Horizon broker agent service is stopped, configuration is preserved, Broker agent is uninstalled, and the new version of Broker Agent is installed.
When the Broker Agent configuration utility launches, on the first screen of the wizard the vRealize Operations Manager IP address/FQDN IP and the pairing credentials have to be re-entered and paired. The subsequent screen will have the data populated from the preserved configuration file of the previous installation. This includes data such as Horizon Credentials and Events DB configurations.
In case of upgrade, the Broker Agent service is not started automatically. On the Configure The Broker Agent Service screen of the Broker Agent Configuration Utility wizard, the broker agent service has to be started. Click Next and on the last page of the wizard, click Finish.
TLS 1.2 is enforced by default in vRealize Operations for Horizon Adapter 6.2.1. The Adapter cannot communicate with older desktop Agents running with TLS 1.0, such as vRealize Operations for Horizon Desktop Agent 6.1. VDI Pools, RDS Pools, or Apps running with older desktop Agents are monitored by default. To monitor pools running with older desktop Agents, administrators need to log on to vRealize Operations Manager collector node and add enforcesslprotocols = false to the /usr/lib/vmware-vcops/user/plugins/inbound/V4V_adapter3/work/msgserver.properties file. Horizon Adapter instance has to be restarted. Broker Agent and Horizon Adapter instance pairing might be required.
- Add the command: TCPPORTS="$TCPPORTS 3099:3101" after TCPPORTS="$TCPPORTS 3091:3094" in /opt/vmware/etc/vmware-vcops-firewall.conf
- Restart the firewall: /etc/init.d/vmware-vcops-firewall restart
- Check the status of the firewall: /etc/init.d/vmware-vcops-firewall status
Internationalization (I18N) Support
The vRealize Operations for Horizon user interface and documentation are both available in English, Japanese, French, German, Simplified Chinese, Traditional Chinese, and Korean.
Top of Page
Prior Releases of vRealize Operations Manger for Horizon
Features that were introduced in prior releases of vRealize Operations Manager for Horizon are described in the release notes for each release, along with existing known issues
This section contains resolved issues for this release.
- The vRealize Operations for Horizon Broker Agent that released with VMware vRealize Operations for Horizon 6.2.1 in March 2016 uses a digital signature that has since expired. As
a result, the broker agent service cannot start up correctly, which will cause errors. To resolve the issue, update to the new
vRealize Operations for Horizon Broker Agent. See KB 2147906 for more information.
- In the event of non-availability of the Adapter or the Broker agent, the Desktop Agent continously tried to refresh Group Policy to get Adapter connection repaired. Multiple such instances of Desktops requiring GPO refreshment caused hike in the CPU usage of the Domain Controller.
- You can now configure the View API Port using the Broker Agent Configuration Utility.
- Metric units are not seen in vRealize Operations Manager 6.0.3 and in vRealize Operations Manager for Horizon 6.1 View Overview dashboard.
- TopN Analysis widgets in the applications pools column on the View RDS Pools dashboard are always empty. The affected widgets include Top Application Session PCoIP Latency, Top Application Session PCoIP TX Bandwidth, Top Application Session TX Packet Loss, and Top Application Session Logon Time.
- The floating pool and dedicated pool cannot be distinguished.
- The stopped session cannot be deleted automatically.
- The logon duration is more accurate.
This section contains known issues for this release.
- In the Broker Agent Utility for Horizon, the test for Desktop Pool ID in the optional Specify Desktop Pools, fails if this ID is different from the Desktop Pool name.
Workaround: Enter the correct Desktop Pool ID, ignore the error message and click Next for the configuration.
- When vRealize Operations for Horizon solution is upgraded to 6.1, duplicate session objects would appear
When vRealize Operations for Horizon solution is upgraded to 6.1, duplicate session objects would appear. Newer object will have a
machine_id and the older object is without a
machine_id. Only the session objects containing a
machine_id will fetch the metrics. Session Objects without
machine_id are stale and will not fetch any metrics (because of vRealize Operations Manager limitation of not deleting stale objects immediately). This is applicable to VDI session objects only.
- Horizon pods that are no longer being monitored still appear in the Horizon dashboards
If you stop monitoring a Horizon pod, the Horizon pod resource continues to appear in the Horizon dashboards.
Workaround: Manually delete the Horizon pod resource and all Horizon Connection Server, security server, and pool resources related to this Horizon pod from the vRealize Operations Manager user interface.
Existing linked-clone desktops must be recomposed
If you created desktop pool images that utilize linked clones prior to installing vRealize Operations for Horizon, you must to recompose the linked clones to include the vRealize Operations for Horizon desktop agent in the image.
User names that include multibyte characters might not appear correctly in the vRealize Operations Manager user interface
Network-related alerts are not generated for user sessions that were established before the View adapter was set up
The following alerts are not generated for user sessions that were initiated before the configuration of a View adapter instance: PCoIP|Round Trip Latency (ms)
and PCoIP|Packet Loss Percent. See KB 1030695: PCoIP performance is slower than expected for troubleshooting high latency and packet loss issues.
Changing the adapter name causes the View Adapter Status dashboard to display incorrect data
If the name of the View adapter instance is changed, the health of the View Adapter in the Select View Adapter widget and the health of the objects in the View Adapter Status widget are unknown on the View Adapter Status dashboard. These problems occur because the View Adapter Collector resource does not automatically update to reflect the name change of the vCenter Operations for Horizon View adapter instance.
Workaround: Do not change the adapter name. If the adapter name has already been changed, update the adapter name in the vRealize Operations for Horizon user interface.
Objects deleted from View are not automatically deleted from vRealize Operations Manager
For example, if you delete a desktop pool in View Administrator, that object still appears in vRealize Operations Manager. Object relationships are removed in vRealize Operations Manager.
Certain View reports return inconsistent or incorrect results
The View Desktop Pool Usage and View Application Pool Usage reports return inconsistent or incorrect results in the Connected and Disconnected Desktop Sessions sections.
If a View adapter receives data from more than 1,000 desktop agents, the ARP cache on the vRealize Operations Manager collector node is not large enough to handle all of the necessary entries in the cache.
Workaround: For a solution to this problem, see KB 2096607: Adjusting the ARP cache on a vRealize Operations Manager remote collector node.
Scoreboard widgets on the View Overview, View Remote Session Details, View RDS & and View Adapter Self Health dashboards do not refresh
Most scoreboard widgets are configured to refresh every two minutes, but this problem prevents auto-refreshing. This problem is most apparent if the affected dashboards are always kept open.
Click the Perform Multi-Select Interaction button on master widget's toolbar to reinitiate interactions and refresh the corresponding scoreboard widgets. For example, on the View Overview dashboard, click the Perform Multi-Select Interaction button on the View Pods widget toolbar to refresh the Pod Indicator Metrics scoreboard widget.
- Tab traversal does not work in the correct order while configuring the Broker Agent utility.
- If you restart a connection server machine, the Broker Agent cannot initialize the event db type. The following message appears:
WARNING: Exception creating connection for EventDBListener: Unsupported Event DB.
Workaround: Restart the Broker Agent service.
- Blank view sessions are listed in the vRealize Operations Administrator UI after the Adapter receives the desktop Agent data.
Workaround: Perform the following steps:
- Click the pencil icon on the top right corner of the widget.
- In the pop-up window, go to Select which tags to filter, expand Collection States and ensure the Collecting option is selected.
- Click Save.
Sessions Counts do not get updated in the Farm Widget in Horizon RDS pool and RDS hosts dashboards.
Workaround: Wait for the next topology refresh.