Connector updates

Periodically, Citrix releases updates to increase the performance, security, and reliability of the Cloud Connector or Connector Appliance. By default, Citrix Cloud installs updates on each connector, one at a time, as soon as these updates become available. To ensure updates are installed timely without unduly affecting your users’ Citrix Cloud experience, you can schedule these updates for a preferred time of day and a preferred day of the week. You can also verify your connectors are up-to-date by comparing the current connector version in your resource location with the target version in Citrix Cloud.

Preferred time of day

When you specify a preferred time of day, Citrix Cloud installs updates 24 hours after they become available, at your preferred time. For example, if your preferred time of day is 2:00 AM US Pacific time and an update becomes available on Tuesday, Citrix Cloud waits for 24 hours and then installs the update at 2:00 AM the next day.

Preferred day of the week

When you specify a preferred day of the week, Citrix Cloud waits for seven days before installing updates on your preferred day. This seven-day waiting period gives you enough time to choose whether to install the update on demand or wait for Citrix Cloud to install it on your preferred day. Depending on the day of the week you select and the day on which updates become available, Citrix Cloud might wait to install updates for up to 13 days.

Example of an 8-day waiting period

On Monday, you configure Tuesdays at 6:00 PM as your preferred day for updates. Later that day, Citrix Cloud notifies you that there’s an update available and displays the Update button. If you don’t initiate the update, Citrix Cloud waits for seven days and then installs the update the next day, on Tuesday at 6:00 PM.

Example of a 13-day waiting period

You configured Mondays at 6:00 PM as your preferred time of day for updates. On Tuesday, Citrix Cloud notifies you that there’s an update available and displays the Update button. If you don’t initiate the update, Citrix Cloud waits for seven days and then installs the update six days later, on Monday at 6:00 PM.

Update notifications and on-demand updates

When updates are available, Citrix Cloud informs you with an alert in your Notifications. Also, each connector displays the date and time when the update will be installed.

After Citrix Cloud notifies you of an available update, each connector displays an Update button so you can install the update sooner than your preferred time or day. After you select Update for each connector, Citrix Cloud queues the updates and installs them one at a time. You can’t cancel updates after you initiate them.

After the update finishes, Citrix Cloud displays the date of the last update. If some updates cannot be completed, a notification is sent informing you.

Choose an update schedule

1. From the Citrix Cloud menu, select Resource Locations.

2. Locate the resource location you want to modify and, from the ellipsis menu, select Manage Resource Location.

   

3. Under Choose your update method, select Set a maintenance start time and choose the preferred day, time, and timezone for installing updates.
   • To specify only a preferred time of day, select the hour and timezone that you want updates to be installed. Citrix Cloud installs updates 24 hours after they become available, at your preferred time.
   • To specify a preferred day of the week, select the hour, day, and timezone. Citrix Cloud waits for seven days after updates become available before installing them on your preferred day.

After you configure your update schedule, Citrix Cloud displays it next to the resource location name.

The start time you select is applied to all connectors regardless of the timezone in which they are located. If you have connectors in different timezones, Citrix Cloud installs updates at your selected time and timezone. For example, if you schedule updates for 2:00 AM in the US Pacific timezone, and you have connectors in London, Citrix Cloud starts to install the update on those connectors at 2:00 AM US Pacific time.

Note:

If the connector experiences an issue during update installation, the installation pauses until the issue is resolved. Because updates are installed on each connector, one at a time, a paused update on one connector can prevent updates on all remaining Cloud Connectors in your Citrix Cloud account.

Unscheduled updates

Even if you choose a preferred time or day for installing updates, Citrix Cloud might still install an update as soon as possible after it becomes available. Unscheduled updates occur when:

• The update can’t be installed at the preferred time within 48 hours of its availability. For example, if your preferred time is 2:00 AM and the connector is offline for three days following the update release, Citrix Cloud installs the update immediately when the connector is back online.
• The update contains a fix for a critical security or feature issue.

Compare Cloud Connector versions

You can check to see which version of the Cloud Connector is running in your resource location and whether it’s the latest version. This information helps you verify that the Cloud Connector is updating successfully.

Note:

This information is not available for Connector Appliances.

From the Resource Locations page, select the Cloud Connectors tile for the resource location you want to manage. Then, expand the tile for the Cloud Connector.

The Current version number is the version of the Cloud Connector software currently running on the Cloud Connector machine. The Target version number is the latest version of the Cloud Connector software that Citrix released. If the machine was updated successfully, the Current and Target version numbers match.

Troubleshooting update failures

Conflicting software installed on your Cloud Connector machine or unexpected errors during maintenance can result in the Cloud Connector failing to update and service outages. For information on dealing with a failed update following Cloud Connector maintenance, visit Resolve a Failed Cloud Connector Maintenance.

If the Cloud Connector isn’t updating successfully, you can start troubleshooting issues by verifying the following conditions:

• The Cloud Connector is powered on and connected to Citrix Cloud using the Cloud Connector Connectivity Check utility.
• Proxy and firewalls are configured correctly.
• Required Windows services are in the Started state.
• Advanced logging is enabled on the Cloud Connector.

For instructions for troubleshooting Cloud Connector update failures, see CTX270718 in the Citrix Support Knowledge Center.

For troubleshooting assistance, you can send Citrix Cloud Connector logs to Citrix. For information, see Log Collection for Citrix Cloud Connector.