VMware vRealize Operations for Horizon 6.3 Release Notes
vRealize Operations for Horizon 6.3 | 16 JUN 2016
Last Document Update: 18 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™ 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.3 includes the following new features.
- As of 18 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.0.1 Support: In addition to Horizon 6, customers deploying Horizon 7.0.1 can also monitor day-to-day operations and on-going performance of their new environment. Metrics and dashboards generate valuable infrastructure capacity, resource usage, and user activities for their Horizon 7.0.1 deployment.
- Horizon 7 Blast Extreme protocol support: TX Bandwidth, Throughput, Encoded Frame Rate, and Round Trip Latency.
- Help Desk dashboard designed for help desk administrators to quickly and easily troubleshoot user sessions from one place.
- Improve scalability by automatic clearing of unused objects.
vRealize Operations for Horizon has the following limitations.
- The RMI registry port 3091 is reused in vRealize Operations for Horizon 6.3 adapter.
The communications ports are 3099, 3100, and 3101 for the Horizon 6.3 message server. The message server objects for Horizon 6.x and 7.x 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.3 even if pairing is successful because TLS 1.0 is disabled by default. A hand shake exception is thrown.
- The configuration file of old adapter instance is not purged during upgrade. Therefore, if other SSL protocol/ciphers is configured on the 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.
- When the primary controller (broker) fails, administrators must manually configure and enable the broker agent at the back-up controller (broker).
Top of Page
This section contains notes on the licensing of vRealize Operations for Horizon 6.3.
- 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 Horizon 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.
This section contains notes of the upgrade processes. For complete upgrade instructions, see the vRealize Operations for Horizon Installation document.
- You can upgrade from vRealize Operations for Horizon 6.1, 6.2, 6.2.1 to vRealize Operations for Horizon 6.3. 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.3.
- 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 (if not already enabled). 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. Or, restart the remote collector (Run service vmware-vcops --full-restart).
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, 6.2, or 6.2.1 to 6.3, 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.3. The Adapter cannot communicate with older desktop Agents running with TLS 1.0, such as vRealize Operations for Horizon Desktop Agent 6.0/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.3 in June 2016 uses an 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.
- A single vRealize Operations for Horizon 6.3 Broker Agent can scale beyond 4K desktops when used in Horizon 6.2.1 or later environment on a single View POD.
- In the event of non-availability of the Adapter or the Broker agent, the Desktop Agent continuously tries to refresh Group Policy to restore the Adapter connection. Multiple such instances of Desktops requiring GPO refreshment cause hike in the CPU usage of the Domain Controller.
- Stability - Remove View Client object to reduce the number of objects per session. This object is merged to session object.
- Performance - Fixed Broker Agent/Desktop memory leak issue.
- Performance - Fixed duplicate topology refresh tasks.
- Stability - Fixed the duplicate dummy vRealize Operations for Horizon adapter instances.
- Stability - Added smaller granularity TTL for unused object
- Stability - RMI connection enhancement.
- Stability - Fixed long onCollection time with large number of VDI Sessions. Added a configurable global map to reduce to call to get VM and datastore.
- Fixed the “No Valid License” issue.
- Stability - Reduced numbers of String Metrics.
- Fixed missing metric issue (For example, min_desktops, spare_desktops in View Pool).
- Stability - Added locks to keep data consistent.
- Shows “No Valid License” alert in alert widget.
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.
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.
- In Horizon Desktop Agent 6.1 or earlier versions, the Logon time, Logon duration, Session duration, Average Logon, Average Recollect, and Maximum Logon Time information cannot not be collected.
These metrics cannot be seen in the widgets such as Top RDS Desktop Session Logon Time in Horizon RDS Pools dashboard, Top Application Session Logon Time in RDS Pools dashboard, Top VDI Session Logon Time Horizon in VDI Pools dashboard, Horizon Remote Session in Horizon User Session Details dashboard, Pool Desktop Sessions in Horizon Desktop Usage dashboard, Top RDS Desktop Session Logon Time in Horizon user sessions dashboard, Top Application Session Logon Time in Horizon User Session dashboard, Top VDI Session Logon Time Horizon in Horizon User Session dashboard, All desktop Pools in Horizon Desktop Usage dashboard, Horizon pods in Horizon Overview dashboard.
Workaround: Upgrade the Desktop Agent version to 6.2 or later.
- Tab traversal does not work in the correct order while configuring the Broker Agent utility.
- The name of the virtual machine does not appear in the Applications Instances widget in the Horizon Application dashboard if you are using a Desktop Agent 6.1 or earlier versions.
Workaround: Upgrade the Desktop Agent version to 6.2 or later.
- Applications launched by user widget in Horizon Remote Sessions Details dashboard does not populate any data if you have installed Desktop Agent 6.1 or earlier versions on RDS Server or VDI machine.
Workaround: Upgrade the Desktop Agent version to 6.2 or later.
- 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.
When you upgrade vRealize Operations for Horizon adapter from 6.x to 6.3, the collection state of the adapter instance shows failed.
Workaround: Either restart the collector service ( Run service vmware-vcops --full-restart) or restart the vRealize Operations Manager appliance.
Log on time, average logon time, and maximum log on time values are not retained for the existing sessions after upgrading adapter from 6.x to 6.3.
Workaround: Log off and login again.
Even after the deletion of the View Pod environment, the stale entries are retained on the dashboards.
Workaround: Restart the service ( Run service vmware-vcops --full-restart). Login to vRealize Operations Manager, go to Administrator > Inventory Explorer, and select the objects and delete them manually.
For reconnected sessions, Horizon connected widget in help desk dashboard shows junk data.
Workaround: Edit the Horizon connected widget and select All Active Sessions and click Save.
If the View server is configured with IP, then the Broker Agent first tries to connect as a local host and displays a redundant error 'Could not connect to the connection server with the provided credentials.' in the utility. The second time it automatically connects to IP or host name. There is no impact on the functionality.