Product Documentation

Known issues

January 24, 2017

Smart Tools does not send email notifications for server registrations, default monitoring alerts, and blueprint and script deployment status, even if email notifications are enabled (My Profile > Email Notifications > Send me notifications). If you have custom monitoring alerts configured, Smart Tools continues to send notifications for these alerts. As a workaround, log on to Smart Tools to view these items.

  • For deployment status, click Manage and locate the script or blueprint deployment you want to view. The Manage page displays the overall deployment status. For additional details, click the deployment to view the Deployment Details page.
  • To view a list of registered servers (servers with the Smart Tools Agent installed), click Manage and then click the Servers tab.


December 22, 2016

Smart Check

  • Sites discovered through Call Home or Citrix Scout cannot be removed from Smart Check through the Smart Tools web site. To remove these Sites from the XenApp and XenDesktop Sites page in Smart Check, log on to Citrix Insight Services and remove the Site’s data uploads. Afterward, refresh the XenApp and XenDesktop Sites page in Smart Check. (CAM-7525)
  • Smart Check might display two separate listings for the same Site if the Site Agent is first installed, then uninstalled, and then re-installed. This issue can occur if the Site Agent is uninstalled very quickly after the Site was added, or if the Site Agent is re-installed very quickly after it was uninstalled. Because Smart Check requires an interval to discover Sites when the Site Agent is installed or uninstalled, this issue can occur if the agent is being uninstalled or re-installed while Smart Check is discovering the Site. To avoid this issue, wait a few minutes before uninstalling or re-installing the Site Agent. (CAM-8080)
  • The date that Smart Check displays for when an update was found might not match the current date or the date listed on the update’s article in the Citrix Support Knowledge Center. To determine when an update was released, click the link to the Knowledge Center article, supplied in the update’s description in Smart Check. (CAM-8137)
  • Smart Check might not display alerts for XenDesktop services that are disabled. This issue occurs because Smart Check runs checks only on enabled services. Disabled services are skipped when running checks. (CAM-8155)
  • When a new XenApp and XenDesktop Site is added to Smart Check and checks are attempted, Smart Check might display “No issues found” on the Site’s Health Report tab, even if the checks could not be completed. To work around this issue, click Get error output for information to help resolve any Site errors that might be preventing successful checks. (CAM-8193)
  • Smart Check email notifications might have the subject line “Smart Check did not find any issues,” even if some checks do not run successfully. However, the body of the email notification specifies which checks could not be completed. As a workaround, open the Smart Check email notification to verify all checks ran successfully. If the notification lists any checks that could not be completed, log on to Smart Tools, view your Site’s Health Report, and click Get error output for more information about the incomplete checks. (CAM-8196)
  • Smart Check might report differing numbers of issues and updates for a Site with the Smart Tools Site Agent installed and with no Site Agent installed. For example, when the Site has the Site Agent installed, Smart Check displays 20 issues in the Site’s report. However, without the Site Agent installed, Smart Check reports only 5 issues. When the Site Agent is installed, Smart Check runs checks on all the Delivery Controllers, Machine Catalogs, and Delivery Groups that are detected in the Site. Without the Site Agent, Smart Check relies on Site data from Call Home or Citrix Scout, which might include only components selected by the Citrix administrator. (CAM-8239)
  • After changing the time zone on a Delivery Controller, Smart Check temporarily displays differing times for scheduled health checks. If the time zone on a Delivery Controller is changed to a different time zone and the Site data is synced in Smart Check, Smart Check displays the updated time and time zone for the next run of health checks on the Site’s Health Report page. However, the schedule for each set of health checks remains set at the original time, even though the time zone is updated. To resolve this issue, allow Smart Check to run checks at the next scheduled time (the earlier of the differing times). After the checks run successfully, the schedule for each set of checks is updated to match the time and time zone displayed on the Site’s Health Report page. (CAM-8249)
  • Smart Check incorrectly flags the Citrix administrator account *MachineName*_scalextreme_user and displays the alert “Citrix administrator missing from domain user group.” This issue might occur with Sites that were previously deployed using a Smart Tools blueprint. To work around this issue, dismiss the alert, which hides it for the entire Site. (CAM-8256)
  • After “Perform all Checks” is selected for a Site, Smart Check might experience an error and display the following error output: Smart Tools experienced a problem. Please retry your action or refresh your browser. If the issue persists, contact Citrix Support for assistance. This issue can occur when Smart Check attempts to perform all checks on a XenApp and XenDesktop 7.6 Site for a prolonged period of time, but times out. As a workaround, restart the Citrix Broker Service and the Citrix Environment Test Service and then run the checks again. To restart these services, perform the following actions:
  1. On the affected machine, click Start, type services.msc, and then press ENTER.
    1. From the Services console, select Citrix Broker Service and then click Restart.
    2. Repeat Step 2 for the Citrix Environment Test Service.


Smart Migrate

When selecting a XenApp 7.x controller for migration, Smart Tools might display controllers that are powered off as well as controllers that are powered on. As a workaround, verify the XenApp controller you want is actually powered on before migrating the deployment. (CAM-4178)

October, 31 2016

When deploying a blueprint, the deployment times out if it takes longer than 24 hours to complete. This issue also occurs when a deployment is paused before finishing and then resumed more than 24 hours later. (CAM-6980)

October, 15 2015

  • When a blueprint containing a Mount Volume step is deployed to a Citrix CloudPlatform resource location, the Mount Volume configuration steps are not displayed in the Lifecycle Management UI. Currently, Lifecycle Management does not support the configuration of Mount Volume step for Citrix CloudPlatform.
  • For non-root user accounts, agent installation fails on a machine that runs Ubuntu operating system on vSphere resource location. Agent installation is successful for root user accounts.
  • The following error message appears after you Add a check or blueprint to your account and click Actions > View: This blueprint is invalid and it cannot be loaded

Note: The issue is inconsistent and does not occur for all the blueprints.

  • If a blueprint deployment is unsuccessful, the step output does not refresh and display the appropriate error message in the Lifecycle Management UI. Reload the page to view the appropriate error message.

Known issues