Citrix introduced the Call Home (v1) technology in the XenApp 7.6.300 VDA in Sep 2015 to collect a core set of diagnostic data for troubleshooting.

This version required manual interaction to upload information to the Citrix Insight Services.

Manually interacting with each VDA does not scale for large deployments and forces administrators to develop their own strategies to trigger uploads. This Tech Preview release offers automated scheduled uploads to alleviate this pain-point.

To try this Tech Preview, upgrade your Call Home v1 on the XenApp 7.6.300 or XenApp 7.7 VDA. See below for configuration and other important information.

(As an update to this blog, the feature is now officially available in the XenApp 7.8 release.)

How to schedule uploads?

Automatic uploads can be scheduled daily or weekly.

Uploads are, by default, set to a weekly schedule run on Sundays at 3:00am. Deployments with a large number of VDAs may see a sudden burst of traffic if all of them upload at the same schedule. The Call Home service implements a random delay of up to 2 hours to reduce a flurry of network activity.

Credentials for scheduled uploads

Uploads require administrators to provide their ‘My Citrix’ credentials when configuring the Call Home schedule.

The Call Home service registers immediately with the Citrix Insight Services using these credentials. Credentials are never persisted.

How to configure periodic uploads in provisioned machines?

Setting up Call Home configuration in the master image eliminates having to repeat configuring each VDA. See PowerShell command for ‘Master Image’ below.

Interacting with Call Home

The Call Home (Tech Preview) offers new PowerShell cmdlets to schedule automatic diagnostic information uploads.

How to Enable Scheduled Uploads?

#setup MyCitrix credentials

$cred = Get-Credentials

#enable the automatic upload by providing credential information

Enable-CitrixCallHome -Credential $cred

Enable scheduled Call Home upload to Citrix

Continuing will enable periodic, scheduled uploads of Call Home telemetry packages to a Citrix server.

This information will be used for troubleshooting and diagnostics support purposes, as well as to improve the quality, reliability, and performance of our products subject to the Citrix Insight Services Policy at https://cis.citrix.com/legal/ and Citrix Privacy Policy at http://www.citrix.com/about/legal/privacy.html.

Are you sure you wish to upload this information?

[Y] Yes  [A] Yes to All  [N] No  [L] No to All  [S] Suspend  [?] Help (default is “Y”): y

Get-CitrixCallHome

IsEnabled

———————

True

IsMasterImage

——————-

False

How to Disable Scheduled Uploads?
#disable automatic uploads

Disable-CitrixCallHome

Get-CitrixCallHome

IsEnabled

———————

True

IsMasterImage

——————-

False

How to schedule daily uploads

#setup to upload @11.20PM every night

$timespan = New-TimeSpan -Hours 23 -Minutes 20

#invoke cmdlet to setup daily uploads @11.20PM

Set-CitrixCallHomeSchedule -TimeOfDay $timespan -UploadFrequency Daily

#confirm schedule – ignore DayOfWeek for daily uploads

Get-CitrixCallHomeSchedule

StartTime

—————–

23:20:00

DayOfWeek

—————–

Sunday

UploadFrequency

—————–

Daily

How to schedule weekly uploads

#setup to upload @11.20PM every night

$timespan = New-TimeSpan -Hours 23 -Minutes 20

#invoke cmdlet to setup weekly uploads on Wednesdays @11.20PM

Set-CitrixCallHomeSchedule -TimeOfDay $timespan -DayOfWeek Wed -UploadFrequency Weekly

#confirm schedule

Get-CitrixCallHomeSchedule

StartTime

—————–

23:20:00

DayOfWeek

—————–

Wednesday

UploadFrequency

—————–

Weekly

How to schedule uploads for provisioned machines

#setup MyCitrix credentials

Enable-CitrixCallHome -Credential $cred -MasterImage

#confirm that the credentials are set for the MasterImage

Get-CitrixCallHome

IsEnabled

———————

True

IsMasterImage

——————-

False

 

Note: Unlike manual uploads, scheduled uploads can be directed to Citrix Insight Services only and not to network file shares in this version.

Call Home Privacy Policies

This information will be used for troubleshooting and diagnostic purposes, as well as the quality, reliability and performance of products subject to the Citrix Insight Services Policy at https://cis.citrix.com/legal and Citrix Privacy Policy at http://www.citrix.com/about/legal/privacy.html.