OpenClos is a Python script library that helps you automate the design, deployment, and maintenance of a Layer 3 IP fabric built on Border Gateway Protocol (BGP).
To create an IP fabric that uses a spine and leaf architecture, the script generates configuration files for the devices in the fabric and uses zero-touch provisioning (ZTP) to push the configuration files to the devices. You can tailor the IP fabric to your network environment by adjusting values in the template files that are associated with the script.
Note: Fabric devices must be placed in a factory-default or zeroized state to participate in an OpenClos-generated IP fabric.
When you execute the script, it automatically generates values for the following device configuration settings within the IP fabric:
-
Interface Assignments
- IP addressing
- Loopback addressing
- Subnet masks and prefixes
- Point-to-point (PTP) links
- Server VLAN ID
- Integrated routing and bridging (IRB) interface assignment
-
Control Plane
- BGP autonomous system numbers (ASN)
- BGP import policy
- BGP export policy
- BGP peer group design
- BGP next-hop self
-
High Availability
- Bidirectional Forwarding Detection (BFD) intervals
- BFD multipliers
- Ethernet operations, administration, and management (OAM)
Supported Devices and Software
- Management Server - Python 2.7.x running on an Ubuntu 14.04 or CentOS 6.x based server
- Spine Devices - QFX5100-24Q switches running Junos OS Release 14.1X53-D15 or later
- Leaf Devices - QFX5100-48S, QFX5100-96S, EX4300-48T switches running Junos OS Release 14.1X53-D15 or later, maximum of 8 spine connections
Install OpenClos on the Management Server
curl -L -u '<username>:<password>' -o OpenClos.zip https://github.com/Juniper/OpenClos/archive/<branch or tag>.zip
sudo pip install --egg OpenClos.zip
Install in development mode
curl -L -u '<username>:<password>' -o OpenClos.zip https://github.com/Juniper/OpenClos/archive/<branch or tag>.zip
unzip OpenClos.zip
cd OpenClos-<version>
sudo pip install --egg -e .
CentOS Installation Issues
- Error: Unable to execute gcc: No such file or directory
- Error: bin/sh: xslt-config: command not found, make sure the development packages of libxml2 and libxslt are installed
- Error: #error Python headers needed to compile C extensions, please install development version of Python
For all the above errors, install the following packages and reinstall OpenClos.
sudo yum install -y python-devel libxml2-devel libxslt-devel gcc openssl
- Error: error_name, '.'.join(version), '.'.join(min_version))), TypeError: sequence item 0: expected string, int found
In CentOS 5.7, if the installation of lxml 3.4 causes a problem, manually install lxml 3.3.6 and then install OpenClos sudo pip install lxml==3.3.6 --egg
Ubuntu Installation Issues
- Error: fatal error: pyconfig.h: No such file or directory
- Error: bin/sh: xslt-config: command not found, make sure the development packages of libxml2 and libxslt are installed
For all the above errors, install the following packages and reinstall OpenClos
sudo apt-get install -y python-dev libxml2-dev libxslt-dev
Windows Installation Issues
- Error: "Unable to find vcvarsall.bat"
One of the OpenClos dependent modules uses PyCrypto. If the installation generates an error message, use the platform-specific prebuilt PyCrypto software from http://www.voidspace.org.uk/python/modules.shtml#pycrypto, and then reinstall OpenClos.
Configuration on the Management Server
Database
- sqlite3 is the default database that uses a file-based database. For better performance, use a traditional database.
- To install the mysql database: issue the 'sudo apt-get install -y python-mysqldb' command, and then set the database connection parameters in openclos.yaml file.
Junos OS image Copy the Junos OS image file to OpenClos-/jnpr/openclos/conf/ztp/ This image is pushed to the fabric devices in addition to the auto-generated configuration.
Example - OpenClos-R1.0.dev1/jnpr/openclos/conf/ztp/jinstall-qfx-5-13.2X51-D20.2-domestic-signed.tgz
Global configuration for the openclos.yaml file To configure ZTP, update the REST API IP address with the server's external IP address.
Example - ipAddr : 192.168.48.201
POD specific configuration for the closTemplate.yaml file
Please update the following settings per your own specific deployment environment:
- junosImage
- dhcpSubnet
- dhcpOptionRoute
- spineCount
- spineDeviceType
- leafCount
- leafDeviceType
- outOfBandAddressList
Example - based on a 10-member IP Fabric:
- junosImage : jinstall-qfx-5-13.2X51-D20.2-domestic-signed.tgz
- dhcpSubnet : 192.168.48.128/25
- dhcpOptionRoute : 192.168.48.254
- spineCount : 4
- spineDeviceType : QFX5100-24Q
- leafCount : 6
- leafDeviceType : QFX5100-48S
- outOfBandAddressList: - 10.94.185.18/32 - 10.94.185.19/32 - 172.16.0.0/12
For more examples, see /jnpr/openclos/conf/closTemplate.yaml
Run the script
The script is available at /jnpr/openclos/tests/sampleApplication.py
Runtime issues
- Error: ImportError: No module named openclos.model
- Error: ImportError: No module named openclos.l3Clos
- Error: ImportError: No module named openclos.rest
OpenClos and its dependent module junos-eznc both use the same 'jnpr' namespace. If junos-eznc was already installed with pip, uninstall this module by issuing the "pip uninstall junos-eznc" command and then install OpenClos by issuing the "pip install OpenClos.zip --egg" command. Be sure to use '--egg' flag to avoid a 'flat' installation, which causes an import error.
Run tests
cd <path-to-OpenClos>/jnpr/openclos/tests
nosetests --exe --with-coverage --cover-package=jnpr.openclos --cover-erase
Output
The script generates the device configuration files and uses ZTP to send them to the devices.
It also generates a cabling plan in two formats:
- DOT file - cablingPlan.dot (this file can be viewed with an application like GraphViz)
- JSON file - cablingPlan.json
All generated configurations (device and ZTP configurations) are stored in the /jnpr/openclos/out/PODID-PODNAME directory
- Ubuntu standard install - "/usr/local/lib/python2.7/dist-packages/jnpr/openclos/out/PODID-PODNAME"
- Centos standard install - "/usr/lib/python2.6/site-packages/jnpr/openclos/out/PODID-PODNAME"
License
Apache 2.0
Support
If you find an issue with the software, please open a bug report on the OpenClos repository.
The Juniper Networks Technical Assistance Center (JTAC) does not provide support for OpenClos software. You can obtain support for OpenClos by visiting the OpenClos Google Group