easy-aci command reference
This reference is for the easy-aci command line tool . These commands obviously only work if you have already downloaded the easy-aci tool . You can check out the product announcement if you don’t already have the tool: easy-aci
Listed Below are the available commands, along with a brief example, and where necessary a description
✔︎ create fabric-config (f) creates json output with ACI fabric policies
easy-aci create fabric-config or easy-aci create f
✔︎ create switch-config (s) creates json output with ACI Switch config policies
easy-aci create switch-config or easy-aci create s
✔︎ create tenant-config (t) creates json output with ACI Tenant/BD/EPG configs
easy-aci create tenant-config or easy-aci create t
✔︎ create vlan-binding (vb) creates json output with EPGs that map to the listed interface. Requires a vlan to epg map in easy_aci.xlsx. Mandatory parameters are comma separated list of vlans and leaf/module/port
easy-aci create vlan-binding 3,4,5 201/1/4 or easy-aci create vb 3,4,5 201/1/4 This binds epgs associated with vlans 3,4 and 5 in your easy_aci spreadsheet to port 1/4 on leaf 201. You still need to create the interface policy group , interface selector etc for the port
✔︎ create vpc-binding (vpc-b) creates json output with EPGs that map to the listed vpc. Requires a vlan to epg map in easy_aci.xlsx. Mandatory parameters are comma separated list of vlans and vpc name
easy-aci create vpc-binding 3,4,5 201-202/myvpcname or easy-aci create vpc-b 3,4,5 201-202/4myvpcname This binds epgs associated with vlans 3,4 and 5 in your easy_aci spreadsheet to a vpc named myvpcname on leafs 201/202. You still need to create the interface policy group , interface selector etc
✔︎ parse nexus-config (n7k) Parses a Nexus 7k text config file and returns json output with Tenant/AP/BD/EPG equivalent configuration. You need to supply the name of the 7K config file.
easy-aci parse nexus-config config.txt or easy-aci parse n7k config.txt This parses the Nexus 7000 config file contained in config.txt and outputs a tenant named Production and Bridge Domain / EPG for each Layer 3 vlan found in the config file. All BD/EPGs are named by vlan id eg bd-vlan10
✔︎ remove vlan-binding (vb) creates json output to remove EPGs that map to the listed interface. Requires a vlan to epg map in easy_aci.xlsx. Mandatory parameters are comma separated list of vlans and leaf/module/port
easy-aci remove vlan-binding 201/1/4 or easy-aci remove vb 3,4,5 201/1/4 This assumes you already bound epgs associated with vlans 3,4 and 5 in your spreadsheet, to leaf 201 port 1/4. The generated output, undoes that binding. There is no side effect if the binding did not exist in the first place
✔︎ version (v) Output the version number
easy-aci version or easy-aci v
✔︎ help (h) Show Help Info
easy-aci help or easy-aci h
✔︎ generate documentation (d) Creates an MS Word Document with basic info about your ACI Fabric
easy-aci generate documentation username password https://your-apic-url or easy-aci generate d username password https://your-apic-url Generates a word document (named aci_summary) with some basic information about your ACI fabric. There is no need to pipe the output to anything.
Remember that each one of these commands (except the generate documentation command) generates json output to your screen. To use them to configure your ACI fabric, you need to pipe the output to a json file. On a Mac, you would do this by adding > filename.json to the end of the command. This way, the command output gets sent to filename.json instead of the screen. you can obviously name the file anything you want.
How to Post the OutPut to ACI
You can post the json output directly to ACI, there is no need for any external tools. Go to the main tenants menu and right click on the common tenant. It should bring you to a menu that looks like the picture below:
Click on the post menu option, which in turn brings you to a screen like below:
Edit the entry until it shows only “uni/” like in the screen below.
You can now click on browse, to select the json file you had generated and post it to ACI. Check the relevant configs in ACI to make sure things are working as you expect.
Picture by Russ Ward https://unsplash.com/photos/bqzLehtF8XE