skip to Main Content
1-732-659-9059 info@bluesodium.com

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

Back To Top