Application Delivery Management

Add Citrix ADC as a device in Cisco ACI using APIC

December 31, 2023

Contributed by:

You need to add a Citrix ADC as an L4-L7 device to the APIC for the network automation. The APIC performs network stitching between Leaf and the Citrix ADC device, based on the deployed service graph. You need to configure the basic settings of the device configuration, such as configuration management IP addresses, device manager, and credentials.

To register the Citrix ADC as a device in the APIC by using the APIC GUI:

On the menu bar, go to Tenants > All Tenants.
In the Work pane, double-click the tenant’s name.
In the Navigation pane, select tenant_name > L4-L7 Services > L4-L7 Devices.
In the Work pane, select Actions > Create L4-L7 Devices.
In the Create L4-L7 Devices dialog box, in the General section, do the following:
1. Select the Managed check box.
2. In the Name field, enter a name for the device.
3. In the Service Type drop-down list, select ADC.
4. In the Device Type field, select Physical.
  
  Note
  
  Make sure that for VMware ESX, you select Virtual and associate the respective Virtual Machine Manager (VMM) domain.
5. In the Physical Domain drop-down list, select the physical domain.
6. In the Mode field, select Single Node or HA Cluster, depending on your requirement.
7. In the Device Package drop-down list, select Citrix-NetScalerMAS-1.0.
8. In the Model drop-down list, select the device model. For example, Citrix ADC-MPX, or Citrix ADC-VPX.
In the Connectivity section, select Out-Of-Band or In-Band in the APIC to Device Management Connectivity field, depending on how Citrix ADC is configured in the fabric.
In the Credentials section, specify the user name and password for access to the device.
In the Device 1 and Device 2 section, respectively, complete the management related configuration.
In the Cluster section, complete the management related configuration for the cluster. Make sure that in the Device Manager drop-down list, you select the device manager you created in Adding Citrix ADM as a Device Manager in Cisco APIC
Click NEXT. The Device Configuration page appears. The hybrid mode device package does not provide device and cluster specific configuration details such as high-availability, enable/disable features and modes, configuration for NTP, SNMP, SNMP Alarms, and so on. These configurations must be done by using Citrix ADM.

Click FINISH. When you have successfully registered the device in the APIC, the device is added and is displayed in the Navigation pane. To view the registered device, in the Navigation pane, go to tenant_name > L4-L7 Services > L4-L7 Devices > device_name.

Important

After you register the device, make sure that there are no faults in the APIC. You can view the faults by clicking the Faults tab in the Work pane.

localized image

You can also register a Citrix ADC device by using APIs. The following is a sample XML payload for adding L4-L7 Device:

<polUni>

    <fvTenant name="coke">

    <vnsLDevVipname="ADCCluster1"funcType="GoTo" svcType="ADC">

     <vnsRsMDevAtt tDn="uni/infra/mDev-Citrix-NetScalerMAS-1.0" />

     <vnsRsALDevToPhysDomP tDn="uni/phys-phys"/>

     <vnsCMgmt name="devMgmt"host="10.102.102.67"port="80"/>

     <vnsCCred name="username" value="nsroot"/>

     <vnsCCredSecret name="password" value="****"/>

     <vnsRsALDevToDevMgr tnVnsDevMgrName="MAS1"/>

     <vnsCDev name="ADC1" devCtxLbl="C1">

     <vnsCIf name="1_1">

     <vnsRsCIfPathAtt tDn="topology/pod-1/paths-101/pathep-[eth1/33]"/>

     </vnsCIf>

     <vnsCIf name="1_2">

     <vnsRsCIfPathAtt tDn="topology/pod-1/paths-101/pathep-[eth1/35]"/>

     </vnsCIf>

     <vnsCMgmt name="devMgmt" host="10.102.102.65" port="80"/>

     <vnsCCred name="username" value="nsroot"/>

     <vnsCCredSecret name="password" value="****"/>

     </vnsCDev>

     <vnsCDev name="ADC2" devCtxLbl="C1">

     <vnsCIf name="1_1">

     <vnsRsCIfPathAtt tDn="topology/pod-1/paths-101/pathep-[eth1/34]"/>

     </vnsCIf>

     <vnsCIf name="1_2">

     <vnsRsCIfPathAtt tDn="topology/pod-1/paths-101/pathep-[eth1/36]"/>

     </vnsCIf>

     <vnsCMgmt name="devMgmt" host="10.102.102.66" port="80"/>

     <vnsCCred name="username" value="nsroot"/>

     <vnsCCredSecret name="password" value="****"/>

     </vnsCDev>

     <vnsLIf name="outside">
  
     <vnsRsMetaIf tDn="uni/infra/mDev-Citrix-NetScalerMAS-1.0/mIfLbl-outside"/>

     <vnsRsCIfAtt tDn="uni/tn-coke/lDevVip-ADCCluster1/cDev-ADC1/cIf-1_1"/>

     <vnsRsCIfAtt tDn="uni/tn-coke/lDevVip-ADCCluster1/cDev-ADC2/cIf-1_1"/>

     </vnsLIf>

     <vnsLIf name="inside">

     <vnsRsMetaIf tDn="uni/infra/mDev-Citrix-NetScalerMAS-1.0/mIfLbl-inside"/>

     <vnsRsCIfAtt tDn="uni/tn-coke/lDevVip-ADCCluster1/cDev-ADC1/cIf-1_2"/>

     <vnsRsCIfAtt tDn="uni/tn-coke/lDevVip-ADCCluster1/cDev-ADC2/cIf-1_2"/>

     </vnsLIf>

     </vnsLDevV

     </fvTenant>

     </polUni>

The official version of this content is in English. Some of the Cloud Software Group documentation content is machine translated for your convenience only. Cloud Software Group has no control over machine-translated content, which may contain errors, inaccuracies or unsuitable language. No warranty of any kind, either expressed or implied, is made as to the accuracy, reliability, suitability, or correctness of any translations made from the English original into any other language, or that your Cloud Software Group product or service conforms to any machine translated content, and any warranty provided under the applicable end user license agreement or terms of service, or any other agreement with Cloud Software Group, that the product or service conforms with any documentation shall not apply to the extent that such documentation has been machine translated. Cloud Software Group will not be held responsible for any damage or issues that may arise from using machine-translated content.

Add Citrix ADC as a device in Cisco ACI using APIC

December 31, 2023

Contributed by:

December 31, 2023

Contributed by:

Add Citrix ADC as a device in Cisco ACI using APIC

In this article