Cisco Application Policy Infrastructure Controller 1.0 With F5 Integration V1
Cisco Application Policy Infrastructure Controller 1.0 With F5 Integration V1
Scenario 2: Building a Multi-Tenant, Multiple Graphs with a single node within the APIC via the northbound API
Scenario 3: Building a Single-Tenant, Single Graph with multiple nodes within the APIC via the northbound API
o Fabric Discovery
Demonstration Requirements
Table 1. Demonstration Requirements
Required Optional
© 2014 Cisco and/or its affiliates. All rights reserved. This document is Cisco Confidential. Page 1 of 55
Cisco dCloud
Demonstration Configuration
This demonstration contains preconfigured users and components to illustrate the scripted scenarios and features of this Cisco
dCloud: The Cisco Demo Cloud
solution. All access information needed to complete the demonstration scenario, is located in the Topology and Servers menus of
your active demonstration, and throughout this script.
Topology Menu. Click on any server in the topology to display the available server options and credentials.
Servers Menu. Click on or next to any server name to display the available server options and credentials.
Demonstration Topology
The following is the virtual demonstration topology, which consists of the following virtual machines:
Workstation – Windows 8
© 2014 Cisco and/or its affiliates. All rights reserved. This document is Cisco Confidential. Page 2 of 55
Cisco dCloud
This demonstration contains preconfigured users and components to illustrate the scripted scenarios and features. All access
information needed to complete the scripted scenarios is located in the Topology and Servers menus of your active
demonstration, and throughout this script.
Demonstration Preparation
Follow the steps below to schedule and configure your environment.
BEFORE DEMONSTRATING
We strongly recommend that you go through this process at least once, before presenting in front of a live audience. This will allow
you to become familiar with the structure of the document and the demonstration.
1. Browse to dcloud.cisco.com, choose the location closest to you, and then login with your Cisco.com credentials.
3. Test your bandwidth from the demonstration location before performing any scenario. [Show Me How]
4. Verify your session has a status of Active under My Demonstrations on the My Dashboard page in the Cisco dCloud UI.
© 2014 Cisco and/or its affiliates. All rights reserved. This document is Cisco Confidential. Page 3 of 55
Cisco dCloud
5. Access the workstation named wkst1 located at 198.18.133.36 and login using the following credentials: Username:
dcloud\demouser, Password: C1sco12345.
Option 1: (Preferred) Use Cisco AnyConnect [Show Me How] and the local RDP client on yourdCloud:
laptopThe Cisco Demo
[Show Cloud
Me How].
Option 2: Use the Cisco dCloud Remote Desktop client with HTML5. [Show Me How]
6. The fabric discovery is automatically started at demo setup. Double-click the APIC Login icon and login with the
following credentials: Username: admin, Password: C1sco12345.
9. In the left menu, click Fabric Membership and check that you have the 4 devices populated as shown in Figure 3. (IP
addresses may vary.)
NOTE: The fabric discovery can take up to 15 minutes to complete. If you login before 15 minutes have passed, all devices may
not be fully discovered.
© 2014 Cisco and/or its affiliates. All rights reserved. This document is Cisco Confidential. Page 4 of 55
Cisco dCloud
NOTE: To demonstrate Fabric Discovery, reset the APIC Simulator (see Appendix A.) If only TEP-1-101 is present at login, see
Appendix B to discover the Fabric.
10. Double-click the VI Login icon and login with the following credentials: Username: demouser, Password:
C1sco12345. (If password is grayed out, click Login.)
11. Check that the bigIP virtual machine is present and running as below.
NOTE: If the bigIP VM is not present in the L4-L7 Services Resource Pool, add it manually.
© 2014 Cisco and/or its affiliates. All rights reserved. This document is Cisco Confidential. Page 5 of 55
Cisco dCloud
Demonstration Steps
System Health Dashboard
1. From the demo workstation, open Application Policy Infrastructure Controller by clicking the APIC Login icon.
2. From the menu bar, click System to display the System Health Dashboard.
Explain that you logged in with global administrative rights and your view includes all system components.
Show the single-pane view, which provides a centralized, application-level visibility with real-time application health
monitoring across the physical and virtual environments.
Show the health scores and explain how a health score is displayed for components that are being monitored by APIC,
such as:
o Fabric health
Show how the left-pane contains health scores for the overall system as well as specific components.
Show how the right-pane contains fault counts based on areas that have errors.
© 2014 Cisco and/or its affiliates. All rights reserved. This document is Cisco Confidential. Page 6 of 55
Cisco dCloud
Topology Overview
The right-pane populates with a dashboard view similar to the System Health Dashboard and contains tabs for further details
about Pod 1.
© 2014 Cisco and/or its affiliates. All rights reserved. This document is Cisco Confidential. Page 7 of 55
Cisco dCloud
Show that the ACI fabric for this demonstration contains two spines, two leafs, and three APIC controllers.
dCloud: The Cisco Demo Cloud
Explain that three controllers are the minimum number required and act as a clustered system and there is high
availability and redundancy across the APIC controllers, from a big data perspective this is similar to a Hadoop Cluster.
Explain that all hosts that connect to an ACI fabric connects to a leaf, a leaf connects to a spine, leafs communicate with
other leafs through spines, spines talk to leafs, spines do not communicate with each other.
Explain that spines only talk to leafs and provides the ability to scale out linearly, provide information on the amount of
bandwidth availability between leafs; scalability of up 288 leafs, up to 12 spines; this provides consistent, predictable,
latency from any point in the fabric to any other point in the fabric.
© 2014 Cisco and/or its affiliates. All rights reserved. This document is Cisco Confidential. Page 8 of 55
Cisco dCloud
Figure 8. Multi-Tenant with Multiple Graphs, Single Node (system will create two for each tenant)
NOTE: The Python script method calls individual XML scripts to create a series of objects. To pause the script and create an object
using an APIC wizard, see the instructions inline. Objects that can be created via wizard using this script are indicated with (*) in
the list below.
© 2014 Cisco and/or its affiliates. All rights reserved. This document is Cisco Confidential. Page 9 of 55
Cisco dCloud
Use Python High To configure the APIC objects with 20 minutes To maximize the effectiveness of this
Scripting to Build scripts, the user downloads a set of Scenario, view the relevant directories
Objects Within the configuration scripts and employs in APIC while the Python scripts are
Manual Low Use an APIC wizard and the 60 minutes See the links in each step to the
required object
Demonstration Steps
NOTE: If you have already demonstrated Scenario 3, you must Remove the APIC Objects before proceeding with this scenario,
because there is only a single bigIP device.
© 2014 Cisco and/or its affiliates. All rights reserved. This document is Cisco Confidential. Page 10 of 55
Cisco dCloud
4. From the demonstration workstation, go to the open Application Policy Infrastructure Controller window.
dCloud: The Cisco Demo Cloud
a. If the application is not open, launch Chrome and then log in with the following credentials: Username: admin,
Password: C1sco12345.
7. Expand the Tenant mgmt > Networking > External Routed Networks hierarchy and its sub-folders to show that the sub-
folders are empty.
8. Return the PuTTY window to the front, placing it so that both the PuTTY window and the APIC directories are visible.
© 2014 Cisco and/or its affiliates. All rights reserved. This document is Cisco Confidential. Page 11 of 55
Cisco dCloud
9. From the command line type ./request.py F5_Scripts/Build_MGMT_F5.cfg and hit <Enter>.
NOTE: To show the XML code as the Python script calls each XML script, substitute
dCloud: The Cisco Demo Cloud
./xml_request.py F5_Scripts/Build_MGMT_F5.cfg for the above command.
This is an example of the partial XML output for the ‘acme.xml’ script.
The Build_MGMT_F5.cfg script utilizes a series of XML scripts to perform the necessary configuration steps. It will pause
between each of the XML scripts, and the user can either press <Enter> to run the script, or type s to skip the script and
configure the object via a wizard. While the script is running, a brief description will display what that script is doing, while the
APIC window updates in real-time. When a script completes successfully, the success code 200 will appear onscreen.
a. In the APIC top menu, select TENANTS. Select ALL TENANTS from the top sub-menu.
© 2014 Cisco and/or its affiliates. All rights reserved. This document is Cisco Confidential. Page 12 of 55
Cisco dCloud
b. Return to the PuTTY window and hit <Enter> at the Hit return to process F5_Scripts/acme.xml or
press ‘s’ and return to skip this script prompt. The acme tenant is created and displayed in the
window.
c. Hit <Enter> at the Hit return to process F5_Scripts/coke.xml or press ‘s’ and return to
skip this script prompt. The coke tenant is created and displayed in the window.
NOTE: If a tenant is not displayed in the menu, click briefly to FABRIC in the top menu, and then click back to TENANTS to
refresh.
e. Expand the Tenant acme > Networking > Bridge Domains directory to show that the AppBD and webBD bridge
domains have been created.
f. Expand the Tenant acme > Networking > Private Networks folder to show that the acmeCtx private network has
been created.
h. Expand the Tenant coke > Networking > Bridge Domains directory to show that the AppBD and webBD bridge
domains have been created.
i. Expand the Tenant coke > Networking > Private Networks folder to show that the cokeCtx private network has
been created.
a. In the APIC window, select Fabric > ACCESS POLICIES from the top menus.
b. Expand the Physical and External Domains > Physical Domains folders. Click the phys domain to show that no
VLAN pools are associated with it.
c. Return to the PuTTY window and hit <Enter> at the Hit return to process
F5_Scripts/CreatePhysDomP.xml or press ‘s’ and return to skip this script prompt.
d. The uni/infra/vlanns-[webService]-dynamic VLAN Pool is now associated with the physical domain.
a. Still in FABRIC > ACCESS POLICIES, expand the Pools > VLAN hierarchy and show that no VLANs exist.
© 2014 Cisco and/or its affiliates. All rights reserved. This document is Cisco Confidential. Page 13 of 55
Cisco dCloud
b. Return to the PuTTY window and hit <Enter> at the Hit return to process
F5_Scripts/CreateVlanNamespace.xml or press ‘s’ and return to skip this script prompt.
c. The webService (Dynamic Allocation) VLAN Pool appears in the folder as it is configured. dCloud: The Cisco Demo Cloud
NOTE: The following step creates the VMware VM Provider and integrates the VMware. To perform this procedure manually, type
s and hit enter at the prompts for the CreateVmmDomP.xml script.
13. Create the VMware VM Provider and integrate the VMware as follows:
c. Expand the VM Provider VMware folder and show that there is no VMware present.
d. Return to the PuTTY window and hit <Enter> at the Hit return to process
F5_Scripts/CreateVmmDomP.xml or press ‘s’ and return to skip this script prompt.
a. From the top menu of the APIC window, select L4-L7 Services.
c. Expand the L4-L7 Services Device Types folder and show that no packages are present.
d. Return to the PuTTY window and hit <Enter> at the Hit return to process
F5_Scripts/F5DevicePackage.zip or press ‘s’ and return to skip this script prompt.
e. The F5-BIGIP-1.0.0 device package appears in the L4-L7 Services Device Types folder as it is created.
© 2014 Cisco and/or its affiliates. All rights reserved. This document is Cisco Confidential. Page 14 of 55
Cisco dCloud
NOTE: The next three steps create the device cluster, concrete device and logical interfaces in the APIC. To create these devices
dCloud: The Cisco Demo Cloud
manually, type s and hit enter at the prompts for the following scripts:
mgmt-CreateLDevVip.xml
mgmt-CreateCDev.xml
mgmt-CreateLIf.xml
16. Create the shared Device Cluster called F5 and a device called BIGIP1 as follows:
c. Expand the L4-L7 Services > Device Clusters folders and show no devices are present.
d. Return to the PuTTY window and hit <Enter> at the Hit return to process F5_Scripts/mgmt-
CreateLDevVip.xml or press ‘s’ and return to skip this script prompt.
NOTE: Although the Device Type of F5 is PHYSICAL, it is not a physical device. The PHYSICAL designation and the Contact
Aware setting of Multiple indicate that more than one tenant will share the device.
17. Create the Concrete Devices for the F5 Device Cluster as follows:
a. Return to the PuTTY window and hit <Enter> at the Hit return to process F5_Scripts/mgmt-
CreateCDev.xml or press ‘s’ and return to skip this script prompt.
b. The BIGIP1 device is created in the F5 device cluster, Expand the BIGIP1 device to display the concrete interfaces.
18. Create the logical interfaces and map them to the concrete interfaces as follows:
b. Return to the PuTTY window and hit <Enter> at the Hit return to Process F5_Scripts/mgmt-
CreateLIf.xml or press ‘s’ and return to skip this script prompt.
c. The internal and external logical interfaces show in the BIGIP1 directory and under Logical Interfaces on the
information page.
NOTE: Wait until both device clusters are in a stable state before proceeding. It may take up to 30 seconds. You may need to click
the icon.
© 2014 Cisco and/or its affiliates. All rights reserved. This document is Cisco Confidential. Page 15 of 55
Cisco dCloud
c. Expand the L4-L7 > Imported Device Clusters, folder which is empty.
d. Return to the PuTTY window and hit <Enter> at the Hit return to process F5_Scripts/acme-
CreateLDevIf.xml or press ‘s’ and return to skip this script prompt.
e. The F5 device cluster from the mgmt area is associated with acme, as indicated by the mgmt/F5 designation.
g. Expand the L4-L7 > Imported Device Clusters folder, which is empty.
h. Return to the PuTTY window and hit <Enter> at the Hit return to process F5_Scripts/coke-
CreateLDevIf.xml or press ‘s’ and return to skip this script prompt.
i. The F5 device cluster from the mgmt area is associated with coke, as indicated by the mgmt/F5 designation.
© 2014 Cisco and/or its affiliates. All rights reserved. This document is Cisco Confidential. Page 16 of 55
Cisco dCloud
20. Open another Chrome browser tab, and click the F5 BIG-IP Admin shortcut.
21. Log in with the following credentials: Username: admin, Password: C1sco12345.
23. Create the Webgraph Service Graph for each tenant, as follows:
a. In the APIC TENANTS window, select acme from the top sub-menu.
b. Expand the L4-L7 Services > Service Graphs folder, which is empty.
c. Return to the PuTTY window and hit <Enter> at the Hit return to process F5_Scripts/acme-
CreateGraphWithParams.xml or press ‘s’ and return to skip this script prompt.
f. Expand the L4-L7 Services > Service Graphs folder, which is empty.
g. Return to the PuTTY window and hit <Enter> at the Hit return to process F5_Scripts/coke-
CreateGraphWithParams.xml or press ‘s’ and return to skip this script prompt.
24. Create the SecureWebgraph Service Graph for each tenant, as follows:
a. Still in the APIC TENANTS window, select acme from the top sub-menu.
c. Return to the PuTTY window and hit <Enter> at the Hit return to process F5_Scripts/acme-
CreateSecureWebGraph.xml or press ‘s’ and return to skip this script prompt.
g. Return to the PuTTY window and hit <Enter> at the Hit return to process F5_Scripts/coke-
CreateSecureWebGraph.xml or press ‘s’ and return to skip this script prompt.
NOTE: The following four steps run the scripts that attach each Service Graph to each Contract for both Tenants. To perform the
procedure manually, type s at the prompts for the following scripts:
F5_Scripts/acme-AttachWebGraph.xml
F5_Scripts/acme-AttachSecureWebGraph.xml
F5_Scripts/coke-AttachWebGraph.xml
F5_Scripts/coke-AttachSecureWebGraph.xml
© 2014 Cisco and/or its affiliates. All rights reserved. This document is Cisco Confidential. Page 17 of 55
Cisco dCloud
NOTE: You must wait for each Virtual-Server to be created on the bigIP before proceeding to attach the next Service Graph. This
can take up to 60 seconds in some cases. If you do not wait, not all Virtual-Servers will be created on the bigIP.
25. Attach the WebGraph Service Graph to the acme tenant, as follows: dCloud: The Cisco Demo Cloud
a. Still in the APIC TENANTS window, select acme from the top sub-menu.
c. Return to the PuTTY window and hit <Enter> at the Hit return to process F5_Scripts/acme-
AttachWebGraph.xml or press ‘s’ and return to skip this script prompt.
d. Allow a few seconds for the script to finish. The WebGraph script drops into the Deployed Service Graph directory.
e. Return to the F5 admin console and see the creation of the new partition for the acme tenant and then the Virtual-
Server with an HTTP Service Port has been created. (The name of the partition will not match the name in APIC.)
26. Attach the SecureWebGraph Service Graph to the acme tenant, as follows:
a. Return to the PuTTY window and hit <Enter> at the Hit return to process F5_Scripts/acme-
AttachSecureWebGraph.xml or press ‘s’ and return to skip this script prompt.
b. Allow a few seconds for the script to finish. The SecureWebGraph script drops into the Deployed Service Graph
directory.
c. Return to the F5 admin console and see the additional Virtual-Server with an HTTPS Service Port has been created.
27. Attach the WebGraph Service Graph to the coke tenant, as follows:
a. Still in the APIC TENANTS window, select coke from the top sub-menu.
b. Expand the L4-L7 Services > Service Graphs folder, which is empty.
c. Return to the PuTTY window and hit <Enter> at the Hit return to process F5_Scripts/coke-
AttachWebGraph.xml or press ‘s’ and return to skip this script prompt.
d. Allow a few seconds for the script to finish. The WebGraph script drops into the Deployed Service Graph directory.
© 2014 Cisco and/or its affiliates. All rights reserved. This document is Cisco Confidential. Page 18 of 55
Cisco dCloud
e. Return to the F5 admin console and creation of the new partition for the coke tenant the additional Virtual-Server with
an HTTP Service Port. (The name of the partition will not match the name in APIC.)
Figure 20. Coke – WebGraph in F5 Console dCloud: The Cisco Demo Cloud
28. Attach the SecureWebGraph Service Graph to the coke tenant, as follows:
a. Return to the PuTTY window and hit <Enter> at the Hit return to process F5_Scripts/coke-
AttachSecureWebGraph.xml or press ‘s’ and return to skip this script prompt.
b. Allow a few seconds for the script to finish. The SecureWebGraph script drops into the Deployed Service Graph
directory.
c. Return to the F5 admin console and see the additional Virtual-Server with an HTTPS Service Port.
30. Click acme from the top sub-menu and expand L4-L7 Services. Click Deployed Service Graphs and show that both scripts
are also listed in applied status on acme.
32. Examine the VLANs connected to the device clusters (optional.) Perform this step for both acme and coke.
a. In the TENANT hierarchy, expand the L4-L7 Services > Deployed Device Clusters hierarchy. Click Deployed
Device Clusters and take note of the VLANs for the internal and external interfaces.
b. On the F5 tab, select either the acme or the coke tenant from the Partitions drop-down. (The names will not be acme
and coke in the Partition drop-down. The two partitions that are not Common represent the two APIC tenants.)
c. Select Networks > VLANs > VLAN List from the side menu and compare the VLAN numbers from APIC.
© 2014 Cisco and/or its affiliates. All rights reserved. This document is Cisco Confidential. Page 19 of 55
Cisco dCloud
© 2014 Cisco and/or its affiliates. All rights reserved. This document is Cisco Confidential. Page 20 of 55
Cisco dCloud
NOTE: The Python script method calls individual XML scripts to create a series of objects. To pause the script and create an object
using an APIC wizard, see the instructions inline. Objects that can be created via wizard using this script are indicated with (*) in
the list below.
Create Tenant
© 2014 Cisco and/or its affiliates. All rights reserved. This document is Cisco Confidential. Page 21 of 55
Cisco dCloud
Use Python High To configure the APIC objects with 20 minutes To maximize the effectiveness of this
Scripting to Build scripts, the user downloads a set of Scenario, view the relevant directories
Objects Within the configuration scripts and employs in APIC while the Python scripts are
Manual Low Use an APIC wizard and the 60 minutes See the links in each step to the
required object
Demonstration Steps
NOTE: If you have already demonstrated Scenario 2, you must Remove the APIC Objects before proceeding with this scenario as
we only have a single F5 bigIP device.
© 2014 Cisco and/or its affiliates. All rights reserved. This document is Cisco Confidential. Page 22 of 55
Cisco dCloud
4. From the demonstration workstation, double-click the ASDM on 198.18.128.100 icon [ ] and log in with the following
credentials: Username: admin, Password: C1sco12345.
6. The ASAv Home page will be displayed, now minimize we will check it again later.
© 2014 Cisco and/or its affiliates. All rights reserved. This document is Cisco Confidential. Page 23 of 55
Cisco dCloud
7. From the demonstration workstation, go to the open Application Policy Infrastructure Controller window.
a. If the application is not open, launch Chrome and then log in with the following credentials: Username: admin,
Password: C1sco12345.
10. Expand the Pools > VLAN hierarchy and its sub-folders to show that the sub-folders are empty.
11. Return the PuTTY window to the front, placing it so that both the PuTTY window and the APIC directories are visible.
© 2014 Cisco and/or its affiliates. All rights reserved. This document is Cisco Confidential. Page 24 of 55
Cisco dCloud
12. From the command line type ./request.py ASA_F5_Scripts/Build_ASA_F5.cfg and hit <Enter>.
NOTE: To show the XML code as the Python script calls each XML script, substitute
./xml_request.py ASA_F5_Scripts/Build_ASA_F5.cfg for the above command.
The Build_ASA_F5.cfg script utilizes a series of XML scripts to perform the necessary configuration steps. It will pause
between each of the XML scripts, and the user can either press <Enter> to run the script, or type s to skip the script and
configure the object manually via a wizard in the APIC GUI. While the script is running, a brief description will display what that
script is doing, while the APIC window updates in real-time.
© 2014 Cisco and/or its affiliates. All rights reserved. This document is Cisco Confidential. Page 25 of 55
Cisco dCloud
a. Expand the Pools > VLAN hierarchy and show that no VLANs exist.
b. Return to the PuTTY window and hit <Enter> at the Hit return to process
F5_Scripts/CreateVlanNamespace.xml or press ‘s’ and return to skip this script prompt.
c. The webService (Dynamic Allocation) VLAN Pool appears in the folder as it is configured.
a. Expand the Physical and External Domains > Physical Domains folders. Click the phys domain to show that no
VLAN pools are associated with it.
b. Return to the PuTTY window and hit <Enter> at the Hit return to process
ASA_F5_Scripts/CreatePhysDomP.xml or press ‘s’ and return to skip this script prompt.
c. The uni/infra/vlanns-[webService]-dynamic VLAN Pool is now associated with the physical domain.
NOTE: The following step creates the VMware VM Provider and integrates the VMware. To perform this procedure manually, type
s and hit enter at the prompts for the CreateVmmDomP.xml script.
15. Create the VMware VM Provider and integrate the VMware as follows:
c. Expand the VM Provider VMware folder and show that there is no VMware present.
d. Return to the PuTTY window and hit <Enter> at the Hit return to process
ASA_F5_Scripts/CreateVmmDomP.xml or press ‘s’ and return to skip this script prompt.
17. Import the F5 Device Package and create the F5 and Firewall Device Clusters as follows:
c. Expand the L4-L7 Services Device Types folder and show that no packages are present.
d. Return to the PuTTY window and hit <Enter> at the Hit return to process
ASA_F5_Scripts/F5DevicePackage.zip or press ‘s’ and return to skip this script prompt.
© 2014 Cisco and/or its affiliates. All rights reserved. This document is Cisco Confidential. Page 26 of 55
Cisco dCloud
f. dCloud:
The F5-BIGIP-1.0.0 and the CISCO-ASA-1.0.1 device packages appear in the L4-L7 Services The Cisco
Device TypesDemo Cloud
folder
as they are created by the two scripts.
a. In the APIC top menu, select TENANTS. Select ALL TENANTS from the top sub-menu.
b. Return to the PuTTY window and hit <Enter> at the Hit return to process ASA_F5_Scripts/Tenant.xml
or press ‘s’ and return to skip this script prompt. The Pepsi tenant is created and displayed in the
window. If this does not happen after several seconds, click the Refresh button. (If a Server Side Error message is
generated, wait a few seconds before refreshing again.)
d. Expand the Tenant Pepsi > Networking > Bridge Domains directory to show that the BD1, BD3, BD4 and
MgmtBD bridge domains have been created.
e. Expand the Tenant Pepsi > Networking > Private Networks folder to show that the pepsiMgmtCtx, pepsictx1 and
pepsictx2 private networks have been created.
NOTE: The next three steps create the device cluster, concrete devices and logical interfaces in the APIC. To create these devices
manually, type s and hit enter at the prompts for the following scripts:
© 2014 Cisco and/or its affiliates. All rights reserved. This document is Cisco Confidential. Page 27 of 55
Cisco dCloud
CreateLDevVip.xml
CreateCDev.xml
CreateLIf.xml
dCloud: The Cisco Demo Cloud
19. Create the Device Cluster:
c. Expand the L4-L7 Services > Device Clusters folder and show there are no device clusters present.
d. Return to the PuTTY window and hit <Enter> at the Hit return to process
ASA_F5_Scripts/CreateLDevVip.xml or press ‘s’ and return to skip this script prompt.
a. Still in TENANTS > Pepsi, expand the L4-L7 Services folder and select F5.
b. Return to the PuTTY window and hit <Enter> at the Hit return to process
ASA_F5_Scripts/CreateLIf.xml or press ‘s’ and return to skip this script prompt.
21. Create the Concrete Devices for the Pepsi tenant as follows:
a. Return to the PuTTY window and hit <Enter> at the Hit return to process
ASA_F5_Scripts/CreateCDev.xml or press ‘s’ and return to skip this script prompt.
b. The BIGIP device is created in the F5 device cluster, and the ASA device is created in Firewall. Expand each BIGIP
device to display the concrete interfaces.
NOTE: Wait until both device clusters are in a stable state before proceeding. It may take up to 30 seconds and you may need to
© 2014 Cisco and/or its affiliates. All rights reserved. This document is Cisco Confidential. Page 28 of 55
Cisco dCloud
a. Still in the Tenant Pepsi directory, expand Application Profiles, which is empty.
dCloud: The Cisco Demo Cloud
b. Return to the PuTTY window and hit <Enter> at the Hit return to Process
ASA_F5_Scripts/CreateAppProfile.xml or press ‘s’ and return to skip this script prompt.
c. The eStore application profile drops into the directory as it is created. Expand the directory to view the EPGs –
CLIENT and WEB.
a. Return to the PuTTY window and hit <Enter> at the Hit return to Process
ASA_F5_Scripts/CreateDomAtt.xml or press ‘s’ and return to skip this script prompt.
b. Expand each EPG in turn and click Domains (VMs and Bare-Metals) to see that the State is formed.
a. Expand Security Policies > Contracts and Security Policies > Filters.
b. Return to the PuTTY window and hit <Enter> at the Hit return to Process
ASA_F5_Scripts/CreateContract.xml or press ‘s’ and return to skip this script prompt.
25. Open another Chrome browser tab, and click the F5 BIG-IP Admin shortcut.
26. Log in with the following credentials: Username: admin, Password: C1sco12345.
a. In the APIC TENANTS window, select Pepsi from the top sub-menu.
b. Expand the L4-L7 Services > Service Graphs folder, which is empty.
c. Return to the PuTTY window and hit <Enter> at the Hit return to process ASA_F5_Scripts/
CreateGraphWithParams.xml or press ‘s’ and return to skip this script prompt.
NOTE: The next step runs the script that attaches the Service Graph to the Contract. To perform the procedure manually, type s at
the prompts for the ASA_F5_Scripts/AttachWebGraph.xml script:
a. Still in TENANTS > Pepsi, expand L4-L7 Services > Deployed Service Graphs, which is empty.
b. Return to the PuTTY window and hit <Enter> at the Hit return to process ASA_F5_Scripts/
AttachGraphToContract.xml or press ‘s’ and return to skip this script prompt.
© 2014 Cisco and/or its affiliates. All rights reserved. This document is Cisco Confidential. Page 29 of 55
Cisco dCloud
c. Allow a few seconds for the script to finish. webCtrct-WebGraph-Pepsi drops into the Deployed Service Graph
directory, showing the association.
30. Click the L4-L7 Services > Deployed Service Graphs folder – the script is listed in applied state. dCloud: The Cisco Demo Cloud
31. Login to VI Client (no login credentials needed – click Login) and see the creation of the additional Port-Profiles.
32. Now you will see the new port-profiles being attached to the VM’s.
34. Return to the ASA ADSM console and you will see the additional interface created.
© 2014 Cisco and/or its affiliates. All rights reserved. This document is Cisco Confidential. Page 30 of 55
Cisco dCloud
35. Return to the F5 window and select Local Traffic > Virtual Servers > Virtual Servers List from the side menus. There is a
new partition in the partition list. (The partition names do not match the tenant names in APIC.)
36. Click the partition to see the scripts attached to that tenant.
a. In the TENANT hierarchy, expand the L4-L7 Services > Deployed Device Clusters hierarchy. Click Deployed
Device Clusters. Click F5-default and Firewall-default in turn, and take note of the VLANs for the internal and
external interfaces.
b. On the F5 tab, select the apic_xxxx tenant from the Partitions drop-down. (The name will not be Pepsi in the
Partition drop-down. The partition that is not Common represent the APIC tenant.)
c. Select Networks > VLANs > VLAN List from the side menu and compare the VLAN numbers from APIC.
© 2014 Cisco and/or its affiliates. All rights reserved. This document is Cisco Confidential. Page 31 of 55
Cisco dCloud
NOTE: If performing this Scenario immediately after Scenario 2 or 3, leave the APIC window open with all the directories
expanded, to demonstrate the objects being removed in real-time.
2. The removal script runs, posting the results in the shell window. When the script has completed, the shell window closes.
© 2014 Cisco and/or its affiliates. All rights reserved. This document is Cisco Confidential. Page 32 of 55
Cisco dCloud
3. If you created the objects and have not yet closed the PuTTY window, proceed to Step 5.
4. If the PuTTY application is closed and you have to reopen it, it will be necessary to reload the Python script package, as
follows:
ii. From the top sub-menu of the APIC window, select POLICIES.
vi. Return to the PuTTY window and type ./request.py F5_Scripts/Remove_MGMT_F5.cfg at the
command prompt. Press <ENTER>.
The python script will step through multiple XML scripts to remove the objects. You can verify in the APIC GUI to see the removal
of the objects, like the tenant, VMM Domain My-vCenter and others. Once this script is completed, you can also go to the vCenter
server to see that the My-vCenter DVS has been removed.
© 2014 Cisco and/or its affiliates. All rights reserved. This document is Cisco Confidential. Page 33 of 55
Cisco dCloud
An output description provides basic information on what the script is doing (see next page.) After each completed item, the script
will return the code 200, indicating success.
dCloud: The Cisco Demo Cloud
© 2014 Cisco and/or its affiliates. All rights reserved. This document is Cisco Confidential. Page 34 of 55
Cisco dCloud
NOTE: It will take up to 5 minutes before you can login and rebuild the Fabric using one of the Fabric Discovery methods in
Appendix B.
© 2014 Cisco and/or its affiliates. All rights reserved. This document is Cisco Confidential. Page 35 of 55
Cisco dCloud
Script Configuration High Skip the configuration steps and discover the APIC Fabric automatically, as shown 1 minute, followed by
in Configure APIC Fabric Using Scripts. 15 minutes to build the
fabric
Wizard Configuration Medium Set up the APIC Fabric using the Postman–REST client, as shown in Configure 5 minutes, followed by
fabric
NOTE: The full fabric discovery can take up to 15 minutes. The apic3 controller will be discovered after all the devices are
discovered. You can check monitor the progress by selecting Topology from the Inventory pane in the APIC GUI. While the
discovery is taking place, you can complete Scenario 1, which ends in the APIC Topology window showing the discovered
elements.
Demonstration Steps
Configure APIC Fabric Using Scripts
1. From the demonstration workstation, click the Build ACI Fabric icon.
2. Type Y <Enter> at the Do you want to continue (Y/N)? prompt. The script will begin building the fabric, which will take about
15 minutes.
3. Type Y <Enter> at the Do you want to continue (Y/N)? prompt. The script will begin building the F5, which will complete
before the ACI fabric is set up.
1. From the demonstration workstation, launch ‘APIC Login’, and then log in to the Application Policy Infrastructure
Controller with the following credentials: Username: admin, Password: C1sco12345.
© 2014 Cisco and/or its affiliates. All rights reserved. This document is Cisco Confidential. Page 36 of 55
Cisco dCloud
6. Launch the Postman – REST Client [ ] from the taskbar. You are automatically be logged in. This is where you will
register the switches for the APIC.
Important: If you get a status of 403 Forbidden while performing the activity in this scenario, review the text below for more
information on the error. If you see Token was invalid (Error: Token timeout), this means that your session has timed out. You
will need to launch the APIC Login POST [ ] and then proceed with the next POST.
7. In the left-pane, click the arrow [ ] next to dCloud APIC Demo, and then click the arrow next to Create Fabric and dCloud
APIC Connectivity.
8. Go to dCloud APIC Connectivity and then choose APIC Login. Click Send to connect to the APIC.
© 2014 Cisco and/or its affiliates. All rights reserved. This document is Cisco Confidential. Page 37 of 55
Cisco dCloud
9. Review the Status of the submission. A result of 200 OK means the submission was successful.
11. Choose the Add Spine1 to Fabric post. Click Send to configure the first spine,a and then it will discover the others.
13. In the APIC application window, you can see Spine1 is now part of the Fabric Membership.
© 2014 Cisco and/or its affiliates. All rights reserved. This document is Cisco Confidential. Page 38 of 55
Cisco dCloud
15. Under Create Fabric, choose the Add Spine2 to Fabric post and then click Send to configure the second spine.
17. In the APIC window, you can see Spine2 is now part of the Fabric Membership.
19. Under Create Fabric, choose the Add Leaf2 to Fabric post.
20. Review the command for this post and you can see that it:
Names Leaf2
© 2014 Cisco and/or its affiliates. All rights reserved. This document is Cisco Confidential. Page 39 of 55
Cisco dCloud
23. In the APIC window, you can see Leaf2 is now part of the Fabric Membership.
25. Under Create Fabric, choose the Configure Leaf 1 to Fabric post, which will update the first member of the Fabric.
28. In the APIC window, you can see that Node ID and Node Name have been set for serial number TEP-1-101.
30. The discovery will continue until it finds all of the links to the other members and populates the IP Addresses.
© 2014 Cisco and/or its affiliates. All rights reserved. This document is Cisco Confidential. Page 40 of 55
Cisco dCloud
31. Wait for discovery to finish. In the APIC window, select Fabric > Inventory from the main menu. Click Topology and
demonstrate that the entire fabric has been discovered and is included in the topology.
© 2014 Cisco and/or its affiliates. All rights reserved. This document is Cisco Confidential. Page 41 of 55
Cisco dCloud
1. Start vSphere from the Task Bar by clicking the icon, and make sure the Use Windows Credentials checkbox is
checked. Click Login.
2. Click Hosts and Clusters in the Location bar to open the drop-down menu.
4. If the networking view is not expanded, then from the top view called vcva.dcloud.cisco.com, click the + to expand the view.
5. The logical data center can be expanded by clicking on the + next to the entry dCloudDC.
6. You will now notice that a new DVS has been created named My-vCenter and you can expand it. This verifies that the APIC
has connection to the VMware vCenter Server.
9. In the Add Host to vSphere Distributed Switch wizard, select vmnic2 as the target physical adapter for each switch and click
Next.
© 2014 Cisco and/or its affiliates. All rights reserved. This document is Cisco Confidential. Page 42 of 55
Cisco dCloud
10. Click Next to the end of the wizard, then click Finish.
11. Monitor the status of the host creation in the Recent Tasks bar until the Status column shows Completed.
12. Click the Hosts tab to see that the new hosts have been enabled.
NOTE: There may be a warning icon in the Status column. This can be ignored.
© 2014 Cisco and/or its affiliates. All rights reserved. This document is Cisco Confidential. Page 43 of 55
Cisco dCloud
NOTE: This procedure replaces three scripts in the automated procedure: dCloud: The Cisco Demo Cloud
Scenario 2 - Type s and <enter> at the prompts for the following scripts:
mgmt-CreateLDevVip.xml
mgmt-CreateCDev.xml
mgmt-CreateLIf.xml
Scenario 3 - Type s and <enter> at the prompts for the following scripts:
CreateLDevVip.xml
CreateCDev.xml
CreateLIf.xml
The Device Cluster in a single-tenant configuration is created within that tenant. In multi-tenant configurations, such as Scenario 2,
the Device Cluster is created in the mgmt area and shared between the two tenants.
3. Expand the L4-L7 Services > Device Clusters hierarchy, which is empty.
4. Right-click Device Clusters and select Create Device Cluster from the menu.
5. Enter the Device Cluster parameters as follows. Note that all parameters are case-sensitive. Click Next.
Name F5 F5 Firewall
© 2014 Cisco and/or its affiliates. All rights reserved. This document is Cisco Confidential. Page 44 of 55
Cisco dCloud
6. Add the Logical Interfaces by clicking the + and entering the following parameters. Note that all parameters are case
sensitive.
Scenario/Device Interface Name Interface Type dCloud: The Cisco Demo Cloud
7. Add the Concrete Device by clicking the + and entering the following parameters. Note that all parameters are case-sensitive.
st nd
8. Add the two Interfaces by clicking the + and entering the details below for 1 and 2 interfaces. Click Next.
Context Label
Interface Path or VNIC (1st interface) Node-101/eth1/30 Network adapter 2 Network adapter 2
nd
Logical Interface (2 interface) external external external
Interface Path or VNIC (2nd interface) Node-101/eth1/31 Network adapter 3 Network adapter 3
nd
Logical Interface (2 interface) internal internal internal
7. Click Next through all the screens in the Parameters tab. Do not make any changes.
8. Click Finish.
9. Review the parameters of the newly created Device Cluster. The figure below shows how it should look make sure you have
configured all section highlighted.
NOTE: Wait until all created device clusters are in a stable state before proceeding. It may take up to 30 seconds. You may need
© 2014 Cisco and/or its affiliates. All rights reserved. This document is Cisco Confidential. Page 45 of 55
Cisco dCloud
If you are performing Scenario 2, return to Step 20 and create the service graphs.
If you are performing Scenario 3, return to Step 22 and continue with the script.
© 2014 Cisco and/or its affiliates. All rights reserved. This document is Cisco Confidential. Page 46 of 55
Cisco dCloud
NOTE: This step replaces Steps 22 and 23 in Scenario 2, or Step 27 in Scenario 3. dCloud: The Cisco Demo Cloud
If you are performing Scenario 2, type s at the prompts for the following scripts:
F5_Scripts/acme-AttachWebGraph.xml
F5_Scripts/acme-AttachSecureWebGraph.xml
F5_Scripts/coke-AttachWebGraph.xml
F5_Scripts/coke-AttachSecureWebGraph.xml
If you are performing Scenario 3, type s at the prompt for the ASA_F5_Script/AttachWebGraph.xml script.
Use this procedure to attach a Service Graph to a Tenant. If there a multiple tenants or multiple service graphs in a scenario,
repeat the procedure for each graph for each tenant, as follows:
3. Expand the L4-L7 Services > Service Graphs folders, which are empty.
4. Expand the Security Policies > Contracts > webContract hierarchy and select a contract. (see table)
5. From the Service Graph drop-down, select a service graph. (see table)
© 2014 Cisco and/or its affiliates. All rights reserved. This document is Cisco Confidential. Page 47 of 55
Cisco dCloud
6. Click Submit. The selected service graph now appears in the L4-L7 Services > Service Graphs folder.
dCloud: The Cisco Demo Cloud
7. After attaching each service graph, verify the attachment in the F5 application, as follows:
b. Choose the apic_xxxx partition in the partition drop-down – the partition names will not match the APIC tenant
names. If you are performing Scenario 2, be sure that you are choosing the second partition when you review the
service graph attachment for coke.
c. Verify that the Virtual-Server with an HTTP Service Port has been created.
If you are performing Scenario 2, return to Step 24 and verify that the scripts are attached.
If you are performing Scenario 3, return to Step 28 and verify that the script is attached.
© 2014 Cisco and/or its affiliates. All rights reserved. This document is Cisco Confidential. Page 48 of 55
Cisco dCloud
© 2014 Cisco and/or its affiliates. All rights reserved. This document is Cisco Confidential. Page 49 of 55
Cisco dCloud
To avoid this, you must complete the following workaround before continuing to the next portion of the scenario.
2. Expand the vcva.dcloud.cisco.com > dCloud-Cluster > L4-L7-Services folders and select ASAv.
6. Go to the Network label field and reselect the same port-profile as already used from the drop-down list.
© 2014 Cisco and/or its affiliates. All rights reserved. This document is Cisco Confidential. Page 50 of 55
Cisco dCloud
8. Go to the Network label field and reselect the same port-profile as already used from the drop-down list.
9. Click OK.
10. Go to the APIC window and open the Properties for the Virtual Machine - ASAv. You can see a MAC address has been
assigned to each, and the port-profile is being displayed correctly in APIC.
© 2014 Cisco and/or its affiliates. All rights reserved. This document is Cisco Confidential. Page 51 of 55
Cisco dCloud
© 2014 Cisco and/or its affiliates. All rights reserved. This document is Cisco Confidential. Page 52 of 55
Cisco dCloud
8. Select webService(dynamic).
9. Create the credentials to login to the vCenter server by clicking the + next to the vCenter Credentials.
15. Create the vCenter server object by clicking the + next to vCenter/vShield.
© 2014 Cisco and/or its affiliates. All rights reserved. This document is Cisco Confidential. Page 53 of 55
Cisco dCloud
NOTE: Within this Create vCenter Domain task, it is important to enter in the information EXACTLY as shown below.
19. In the DVS Version, select DVS Version 5.5 from the drop down.
21. In the Associated Credential drop-down menu, select the credential object that was created in the previous task:
administrator.
© 2014 Cisco and/or its affiliates. All rights reserved. This document is Cisco Confidential. Page 54 of 55
Cisco dCloud
© 2014 Cisco and/or its affiliates. All rights reserved. This document is Cisco Confidential. Page 55 of 55