Configure the ADC built-in agent to manage instances

A built-in agent is available on Citrix ADC MPX, VPX, Gateway instances running the version 12.0.56.20 and later and on Citrix ADC SDX instances running version 13.0 61.x and later. You can initiate this agent on the ADC instance instead of installing a dedicated agent in your data center or public cloud. The built-in agent enables communication between the instance and Citrix ADM service.

Note

Built-in agent is available only on the following Citrix ADC instance types:

  • Citrix ADC MPX
  • Citrix ADC VPX
  • Citrix ADC SDX
  • Citrix Gateway

The built-In agent is ideal for smaller ADC standalone or HA pair deployments. If you have multiple ADC instances, use a dedicated agent for deployments. This agent ensures you have better data aggregation capabilities than the built-in agent. For more information, see Install an agent on-premises.

Citrix ADM service supports management and monitoring of Citrix ADC instances using built-in agents. However, the following features are not supported in the built-in agent:

  • Application dashboard
  • Web Insight
  • SSL insight
  • HDX insight
  • Gateway insight
  • Security insight
  • Advanced analytics
  • Pooled licensing

Prerequisites

Before you configure a built-in agent on the Citrix ADC instance, ensure the following:

  • The Citrix ADC (MPX, VPX, or Gateway) instance is running on the version 12.0.56.20 or later. The SDX instance is running version 13.0.61.x and later.

  • A DNS name server is added on the Citrix ADC instance.

    For more information, see Add a name server.

  • You have a Citrix Cloud account. For more information, see Sign up for Citrix Cloud.

Note

For all information related to ports and other system requirements, see System Requirements.

Configure the built-in agent

Perform the following tasks to configure the ADC built-in agent:

  1. Sign in to Citrix Cloud.

  2. On the Application Delivery Management tile, click Manage. Then, select the region that suits your business need. For more information, see Manage Citrix ADM with Express account

    Citrix ADM Express account

  3. Click Get Started.

    Get started

  4. Select On Premises as the ADC deployment type.

    Select On-Premises ADC deployment type

  5. Select Built-in Agent.

    Important

    To use the built-in agent, your Citrix ADC instance must be on version 12.0 build 56.20 and higher.

    Select Built-in agent

    A service URL and an activation code are generated and displayed on the GUI.

  6. Copy the Service URL and Activation code.

    The agent uses the service URL to locate the service and the activation code to register with the service. Skip step 7 if you are an MPX or a Gateway customer.

    Copy service URL and activation code

  7. If you are an SDX or a VPX user, initiate the built-in agent using an SSH client. MPX and Gateway users must skip this step.

    1. Log on to your Citrix ADC instance. For more information, see Access a Citrix ADC.

    2. Navigate to the /var/mastools/scripts directory and type the following command:

      On the SDX instance

      ./mastool_int.sh <user-name> <service-url> <activation-code> -sdx
      

      or

      ./mastool_init.sh <device-profile-name> <service-url> <activation-code> -sdx -profile
      
      

      Note

      ADM discovers all VPX instance running on that SDX and you don’t have to register the VPX instances individually.

      For VPX instances not running on an SDX appliance, type one of the following commands depending on the VPX software version.

      For VPX image version 13.0 61.x or 12.1 57.x and higher, run the following command:

      ./mastools_init.sh <username> <password> <service_url> <activation_code>
      

      If you register the VPX instance for the first time and the VPX image version is lower than 13.0 61.x or 12.1 57.x, run the following command:

      ./mastools_init.sh <username> <password> <service_url> "MAS;<activation_code>"
      
      • In <username>, enter Citrix ADC user name.

      • In <password>, enter the ADC password.

      • In <service_url>, paste the URL that you have copied in the previous step.

      • In <activation_code>, paste the activation code that you have copied in the previous step.

      CLI initiates built-in agent

    Note

    In an HA pair, complete the registration on the primary node. If you run the registration on the secondary node, the following message appears:

    Please run the registration command on the primary node.

  8. Return to the ADM service page and click Register Instance.

  9. In Add Instances, view the instance where you initiated the built-in agent. Ensure the instance is in the Up status and click Next.

    Add instances

  10. Click Done.

Complete built-in agent configuration

After successful built-in agent configuration, you can access the ADM features such as:

  • Virtual server and analytics – Apply licenses to your virtual server to manage ADC instances. For more information, see Manage subscriptions.

  • Application dashboard – To view all applications in a holistic way. For more information, see Application management and dashboard.

  • Infrastructure analytics – This feature helps you to visualize the factors that resulted or might result in an issue on the instances. For more information, see Infrastructure Analytics.

Note

You can also configure the built-in agent by navigating to the Networks > Agents > Generate Activation code page. Copy and paste the URL and activation code to an ADC instance and discover that instance.

After the built-in agent is initiated, navigate to Networks > Instances > Citrix ADC. This page displays the details about the managed instance discovered using the built-in agent.

Configure the ADC built-in agent to manage instances