Adding instances

You can add instances either while setting up the Citrix Application Delivery Management (Citrix ADM) for the first time or later.

Instances are Citrix appliances or virtual appliances that you want to discover, manage, and monitor from Citrix ADM. You can add the following Citrix appliances and virtual appliances to Citrix ADM:

  • Citrix ADC MPX
  • Citrix ADC VPX
  • Citrix ADC SDX
  • Citrix ADC CPX
  • Citrix ADC BLX
  • Citrix Gateway
  • Citrix Secure Web Gateway
  • Citrix SD-WAN WANOP

To add instances, you must specify either the host name or IP address of each Citrix ADC instance, or a range of IP addresses. For SD-WAN instances, specify the IP address of each instance, or a range of IP addresses.

Note

Citrix ADM supports only Citrix SD-WAN WANOP.

You must specify an instance profile that Citrix ADM can use to access the instance. This instance profile contains the user name and password of the instances that you want to add to the service. For each instance type, a default profile is available. For example, the ns-root-profile is the default profile for Citrix ADC instances. The default Citrix ADC administrator credentials defines this profile. If you have changed the default admin credentials of your instances, you can define custom instance profiles for those instances. If you change the credentials of an instance after the instance is discovered, you must edit the instance profile or create a profile, and then rediscover the instance.

You can access the GUIs of Citrix ADC instances from the Citrix ADM after adding the instances in Citrix ADM. To access the Citrix ADC instances from the Citrix ADM, you must be connected to the Citrix network.

Note

  • To add Citrix ADC instances configured in a cluster, you must specify either the cluster IP address or any one of the individual nodes in the cluster setup. However, on Citrix ADM, cluster IP address represents the cluster.

  • For Citrix ADC instances set up as an HA pair, when you add one instance, the other instance in the pair is automatically added.

To add a Citrix ADC instance to Citrix ADM

Note

Perform this task to add all other ADC instances except the ADC CPX instance.

  1. Navigate to Networks > Dashboard and click All Instances. On the Instances page, click New at the top right corner of the page. On the Add Instance page, from Instance Type, select the type of instance you want to add.

    Alternatively, navigate to Networks> Instances. Under Instances, select the type of instance you want to add (for example, Citrix ADC VPX) and click Add.

  2. Select one of the following options:

    • Enter Device IP address - For Citrix ADC instances, specify either the host name or IP address of each instance, or a range of IP addresses. For SD-WAN instances, specify the IP address of each instance, or a range of IP addresses.
    • Import from file - From your local system, upload a text file that contains the IP addresses of all the instances you want to add.
  3. From Profile Name, select the appropriate instance profile, or create a profile by clicking the + icon.

  4. From Site, select the site where you want the instance to be added.

  5. From Agent, select the agent with which you want to associate the instances, and then click OK.

    If there is only one agent configured on your Citrix ADM, that agent is selected by default.

    localized image

To add Citrix ADC CPX instance in ADM

  1. Navigate to Networks > Instances. Under Instances, select Citrix ADC and select the CPX tab.

  2. Click Add.

  3. Select one of the following options:

    • Enter Device IP address. Specify either the host name or IP address of each instance, or a range of IP addresses.

    • Import from file. From your local system, upload a text file that contains the IP addresses of all the instances you want to add.

  4. In the Routable IP/Docker IP field, enter the IP address. The IP address can be either the Citrix ADC CPX instance (if it is reachable) or the Docker host.

  5. In the Profile Name field, select the appropriate instance profile, or create a profile by clicking the + icon.

    Note

    When you are creating a profile, ensure to specify the HTTP, HTTPS, SSH, and SNMP port details of the host. You can also specify the range of ports that are published by the host in the Start Port and Number of ports field.

  6. As an option, select the site where you want to deploy the CPX instance. You can create a site also by clicking Add.

  7. If available, select the Citrix ADM service agent from the list of agents.

  8. Click OK to initiate the process of adding instances to Citrix ADM.

    Note

    If you want to rediscover an instance, perform the following steps:

    1. Navigate to Networks > Instances > Citrix ADC > CPX.
    2. Select the instance you want to rediscover.
    3. From the Select Action list, click Rediscover.

To add a standalone Citrix ADC BLX instance in Citrix ADM

A standalone Citrix ADC BLX instance is a single instance that is running on the dedicated host Linux server.

  1. Navigate to Networks > Instances > Citrix ADC.

  2. In the BLX tab, click Add.

  3. Select the Standalone option from the Instance Type list.

  4. In the IP address field, specify the IP address of the BLX instance.

  5. In the Host IP address field, specify the IP address of the Linux server where the BLX instance is hosted.

  6. In the Profile Name list, select the appropriate profile for a BLX instance, or create a profile.

    To create a profile, click Add.

    Important

    Ensure you have specified the correct host user name and password of the Linux server in the profile.

  7. In the Site list, select the site where you want to add an instance.

    If you want to add a site, click Add.

  8. In the Agent list, select the Citrix ADM agent to which you want to associate the instance.

    If there is only one agent configured on your Citrix ADM, that agent is selected by default.

  9. Click OK.

Add Citrix ADC BLX standalone instance to Citrix ADM

To add high-availability Citrix ADC BLX instances in Citrix ADM

The high-availability Citrix ADC BLX instances that run on different host Linux servers. A Linux server cannot host more than one BLX instances.

  1. In the BLX tab, click Add.

  2. Select the High Availability option from the Instance Type list.

  3. In the IP address field, specify the IP address of the BLX instance.

  4. In the Host IP address field, specify the IP address of the Linux server where the BLX instance is hosted.

  5. In the Peer IP address field, specify the IP address of the peer BLX instance.

  6. In the Peer Host IP address field, specify the IP address of the Linux server where the peer BLX instance is hosted.

  7. In the Profile Name list, select the appropriate profile for a BLX instance, or create a profile.

    To create a profile, click Add.

    Important

    Ensure you have specified the correct host user name and password of the Linux server in the profile.

  8. In the Site list, select the site where you want to add an instance.

    If you want to add a site, click Add.

  9. In the Agent list, select the Citrix ADM agent to which you want to associate the instance.

    WIf there is only one agent configured on your Citrix ADM, that agent is selected by default.

  10. Click OK.

Add Citrix ADC BLX high-availability instances to Citrix ADM

To access an instance GUI from the Citrix ADM

  1. Navigate to Networks > Instances > Citrix ADC.

  2. Select the type of instance you want to access (for example, VPX, MPX, CPX, SDX, or BLX).

  3. Click the required Citrix ADC IP address or host name.

Localized image

The GUI of the selected instance appears in a pop-up window.