Software Packages

Cisco
Packages

Supported Versions

The following table provides an overview of the supported version matrix:

Software Version ACI 3.2(7)(LTR) ACI 4.0(1) ACI 4.0(2/3) ACI 4.1(1/2) ACI 4.2(1/2)(LTR)
Kubernetes 1.10 YES YES NO NO NO
Kubernetes 1.11 YES NO NO NO NO
Kubernetes 1.12 YES NO NO YES NO
Kubernetes 1.13 YES NO NO YES YES
Kubernetes 1.14 NO NO NO NO YES
Kubernetes 1.15 NO NO NO NO YES
The above table is what the Cisco development team has tested and validated in the lab to work between ACI and Kubernetes. This lab has been worked on Kubernetes version 1.6,1.7,1.8,1.9 and 1.10 with ACI version 3.1(1). For production environments please refer to the table in this page VMM version compatibility matrix.

ACI has long term release cycles that are supported and maintained longer for network administrators that are looking for a longer window before a need to require upgrading the fabric to a major release. The Kubernetes integration aligns to these longer release cycles sustaining various versions of Kubernetes.

Location of software

The integration of Cisco ACI and Kubernetes compromises to separate parts. A set of scripts installed via an RPM file and a series of containers. The integration script component is written in Python and is installed by download a file from CCO to match the integration version number.

It is considered a best practice to let the servers install the software from the internet Docker Hub repositories instead of downloading the container files from CCO. If you are very familiar with building a container registry, then this is an option that you can utilize.

Explanation of Cisco packages

The following table provides details on the different packages that are availabe on CCO for the integration. The versions might not exactly match here due to variations in time between document writting and CCO updates.

Package Description
Debian Packages for ACI Kubernetes 1.6 (OpenShift 3.6) tools The debian package system for Ubuntu, Debian. This version is supported for OpenShift 3.6 integration. This file contains the acc-provision scripts
Debian Packages for ACI Kubernetes 1.7 tools The debian package system for Ubunti, Debian. This version is specific to kubernetes 1.7. This contains the acc-provision scripts.
Container images and other files for ACI Kubernetes 1.6 ( OpenShift 3.6) This TAR file contains container and other utilities required for the integration. To be able to utilize the containers in this file requires setting up your own Container registery and then re-point the ACC-Provision to utilize that container registry. If you are not familiar with setting up container registries, your best option is to not utilize this and let the servers connect to the internet and download from Docker Hub.

For this lab you will not be using this file and the servers will connect to Docker Hub to download the proper docker containers.

Container images and other files for ACI Kubernetes 1.7 This TAR file contains container and other utilities required for the integration. To be able to utilize the containers in this file requires setting up your own Container registery and then re-point the ACC-Provision to utilize that container registry. If you are not familiar with setting up container registries, your best option is to not utilize this and let the servers connect to the internet and download from Docker Hub. For this lab you will not be using this file and the servers will connect to Docker Hub to download the proper docker containers.
RPM Packages for ACI Kubernetes 1.6 (OpenShift 3.6) tools RPM package system for RedHat, Centos. This version is specific to kubernetes 1.6 and for support of OpenShift 3.6. This contains the acc-provision scripts.
RPM Packages for ACI Kubernetes 1.7 RPM package system for RedHat, Centos. This version is specific to kubernetes 1.6 and for support of OpenShift 3.6. This contains the acc-provision scripts.

Step 1 - Download of package from internal lab server

For this lab we have made it super easy by placing the ACC-Provision RPM in a internal lab server that you can easily fetch. For your own deployment please visit cisco.com to get the files under Software Downloads (account required).


cd ~
wget https://svs-rtp-dmz-files.ciscolive.com/ltraci-2967/dist-rpms-4.2.2.2.tar.gz

[root@pod09-master ~]# wget https://svs-rtp-dmz-files.ciscolive.com/ltraci-2967/dist-rpms-4.2.2.2.tar.gz
--2020-01-26 09:40:35--  https://svs-rtp-dmz-files.ciscolive.com/ltraci-2967/dist-rpms-4.2.2.2.tar.gz
Resolving svs-rtp-dmz-files.ciscolive.com (svs-rtp-dmz-files.ciscolive.com)... 64.102.250.151
Connecting to svs-rtp-dmz-files.ciscolive.com (svs-rtp-dmz-files.ciscolive.com)|64.102.250.151|:443... connected.
HTTP request sent, awaiting response... 200 OK
Length: 4751078 (4.5M) [application/x-gzip]
Saving to: ‘dist-rpms-4.2.2.2.tar.gz’

100%[========================================================================================================================================>] 4,751,078   --.-K/s   in 0.07s   

2020-01-26 09:40:35 (63.8 MB/s) - ‘dist-rpms-4.2.2.2.tar.gz’ saved [4751078/4751078]

Step 2 - Install RPM package.

Once downloaded then the RPM needs to be installed. Extract the contents of the archive and then use yum to install the package.


cd ~
tar xf dist-rpms-4.2.2.2.tar.gz
yum -y localinstall acc-provision-4.2.2.2-27.el7.x86_64.rpm