Product Documentation

Deploy a blueprint using existing machines

Important: The features in this topic have been deprecated and are no longer available in Smart Tools. This topic will be removed at a later time. For more information, see What’s New in Citrix Smart Tools.


When deploying blueprints, Smart Tools can either provision and configure new machines or use existing machines that you specify. This topic describes how to deploy a Smart Tools blueprint using existing machines in your environment.

You might need to deploy blueprints with existing machines if:

  • You want to use machines in a resource location that Smart Tools does not support such as Microsoft Azure Resource Manager or Nutanix Acropolis.
  • You want to use a supported resource location such as AWS or Citrix XenServer, but don’t want to supply credentials or keys to Smart Tools.
  • You want to use physical machines in your environment with a blueprint.

Install the Smart Tools Agent

Before you can use existing machines with Smart Tools, you must first install the Smart Tools Agent on each machine you want to use with the blueprint you want to deploy. The agent communicates with Smart Tools on port 443, enabling Smart Tools to locate and configure each machine during the blueprint deployment process. Ensure each machine hosting the agent has outbound communication on port 443 enabled.

To install the Smart Tools Agent

  1. Log on as an administrator user of the machine on which you want to install the agent.
  2. Log on to the Smart Tools web site using your account credentials.
  3. From the home page, click Resources & Settings.
  4. From the Resource Locations page, click Add Resource Location.
  5. Select Citrix XenServer and click Next. Selecting this option is required only to download the agent; not to specify your resource location.
  6. Select the machine operating system and bitness (32-bit or 64-bit), if applicable, and click Download Agent. When prompted, save the package.
  7. Locate the Smart Tools Agent package and launch the installation. During installation, the agent registers the machine with Smart Tools. This can take a few minutes. When the machine is successfully registered, a green check mark appears.
  8. Click Cancel to close the Add Resource Location dialog.

Deploy the blueprint

To use existing machines with a blueprint, the blueprint must include Server steps. These steps appear as machine tiers when you configure the blueprint deployment. For each machine tier, you specify an existing machine. When the blueprint is deployed, Smart Tools uses the specified machines as targets for the other steps in the blueprint, such as installing software or configuring a server role. For more information about Server steps, see the “Server Step” section of About blueprint steps

  1. From the menu bar, click Smart Build and then point to the blueprint you want to deploy.
  2. Under Actions, click Actions > Deploy. The blueprint description page appears.
  3. Click Start deployment setup. The Overview page appears.
  4. In Deployment Name, enter a friendly name for your deployment and click Next. The Resource Location page appears.
  5. In Resource Location, select All Existing Machines and then click Next.
  6. On the Architecture page, select any applicable deployment options and click Next.
  7. Review the Pre-deployment Checklist to ensure you have the information or resources that will be needed to configure and deploy the blueprint. Click Continue. For more information, see About the pre-deployment checklist.
  8. On the Size page, perform the following actions:

    1. Select Use existing machines.
    2. In each machine tier, select a machine from the list. Repeat this step for all machine tiers in the blueprint. Click Next.
  9. On the Configuration page, enter the configuration parameters for the deployment. For more information about each parameter, click its Help icon. Click Next.
  10. (Optional) Create a deployment profile:

    1. Enter a friendly name for the profile.
    2. (Optional) Enter a description.
    3. Click Save. If you do not want to create a profile, click Cancel.
  11. On the Summary page, review the options you’ve configured.
  12. Click Deploy.

After the deployment begins, Smart Tools displays the status of the deployment in the Deployment Details page. The Deployment Details page includes the real-time progress of each step in your blueprint. Depending on machine availability and the complexity of the blueprint, the deployment might take some time to complete, and some blueprint steps might take longer than others.

Deploy a blueprint using existing machines