Agent and connector requirements

Smart Tools Agent requirements

The Citrix Smart Tools Agent is a lightweight software package that coordinates software deployment, collects metrics, and transmits logs. The agent has two functions:

  • When installed on machines provisioned using a blueprint, the agent enables Smart Tools to monitor each server, auto-scale servers, and provide redundancy and failover.
  • When installed on a machine designated as a connector, the agent acts as a point of contact between Smart Tools and the machines in a firewalled resource location. 

You can download and install the agent on your designated machine when you begin the process of setting up your resource location. 

The following table lists the resource locations and server operating systems that the agent supports:

Resource Location Supported Operating Systems
  • Amazon EC2 
  • Citrix CloudPlatform (public cloud - existing resource locations only)
  • Microsoft Azure Classic

 This resource location is:

  • A public cloud and does not require a connector
  • Directly accessible through the Internet
  • Independent of operating systems
  • Citrix CloudPlatform (private cloud - existing resource locations only)
  • Citrix XenServer
  • VMware vSphere
  • Microsoft Hyper-V Server

Microsoft Windows:

  • Windows 7
  • Windows 8
  • Windows 10
  • Windows Server 2008
  • Windows Server 2008 R2
  • Windows Server 2012
  • Windows Server 2012 R2 
  • Windows Server 2016

 Linux: 

  • Ubuntu
  • Red Hat
  • Fedora
  • Debian
  • CentOS 

Note: To avoid connectivity issues, the system clock must be accurate on both the agent and the machine that acts as a connector.

About Citrix CloudPlatform support

Smart Tools no longer supports adding new resource locations running Citrix CloudPlatform. However, if you already have CloudPlatform resource locations in Smart Tools, you can still modify the resource location details, set up connectors, and create and deploy blueprints to these resource locations. 

Verify the Smart Tools Agent is running

On Windows:

  1. Select Start > Control Panel > System and Security > Administrative Tools > Services
  2. From the services list, locate the Citrix Smart Tools Agent Service. If the service is running, the status displays "Running."
  3. If the service is not running, right-click Citrix Smart Tools Agent Service and select Restart.

On Linux: 

  1. Run the command ps aux | grep connector
  2. Verify the output if the connector service is running. If the service is not running, run the following commands: 
    /opt/citrix/lifecycle-management/
    ./connector

Connector requirements

If your resource location resides behind a firewall, you need a machine that can act as a connector, communicating with both Smart Tools and your resource location over the Internet. 

You can use a single machine to act as a connector between multiple resource locations. For example, you can specify the same connector for both Citrix XenServer and VMware vSphere resource locations. You can specify this machine when you configure each resource location.

System requirements

To act as a connector, the machine must meet the following requirements:

  • Microsoft Windows or Linux operating system is installed. 
  • The Smart Tools Agent is installed (during resource location setup).
  • The machine can communicate with the resource location you want to use with Smart Tools.
  • Outbound access to the Internet through port 443 (HTTPS) is enabled.

For Hyper-V resource locations

To act as a connector, the machine must meet the following requirements:

  • Microsoft Windows operating system is installed. 
  • Microsoft .NET Framework 4.0 is installed.
  • The Smart Tools Agent is installed (during resource location setup).
  • The machine can communicate with the resource location you want to use with Smart Tools.
  • Outbound access to the Internet through port 443 (HTTPS) is enabled.

Note: To manage your Hyper-V server resource location with Smart Tools, you need to promote a Windows machine in the resource location to act as a connector. You cannot promote a machine to act as a connector if it runs a Linux operating system. You can manage a Linux machine with Citrix Smart Tools, but cannot promote it to act as a connector with Hyper-V. 

Overview: Set up a connector

  1. Click Resource Locations > Add Resource Location.
  2. Select the resource location you want to set up.
  3. When prompted, download the Smart Tools Agent and install it on the machine you want to use as the connector.
  4. Enter the details for your resource location and select the machine as the connector. 

When you select the machine to be the connector, Smart Tools "promotes" the agent by installing additional software on the machine and adding the machine to the list of available connectors for the resource location. 

For more details about setting up supported resource locations, see Resource Locations.

0 Comments