Installation

The installation of pyeapi is straightforward and simple. As mentioned in the Introduction, pyeapi can be run on-box or off-box. The instructions below will provide some tips to help you for either platform.

Pip with Network Access

If your platform has internet access you can use the Python Package manager to install pyeapi

admin:~ admin$ sudo pip install pyeapi

Note

You will likely notice Pip install netaddr, a dependency of pyeapi.

Pip - Upgrade Pyeapi

admin:~ admin$ sudo pip install --upgrade pyeapi

Pip without Network Access

If you want to install pyeapi on a switch with no internet access:

Step 1: Download Pypi Package

  • Download the latest version of pyeapi on your local machine.
  • You will also need a dependency package netaddr.

Step 2: SCP both files to the Arista switch and install

admin:~ admin$ scp path/to/pyeapi-<VERSION>.tar.gz ansible@veos01:/mnt/flash/
admin:~ admin$ scp path/to/netaddr-<VERSION>.tar.gz ansible@veos01:/mnt/flash/

Then SSH into your node and install it. Be sure to replace <VERSION> with the actual filename:

[admin@veos ~]$ sudo pip install /mnt/flash/netaddr-<VERSION>.tar.gz
[admin@veos ~]$ sudo pip install /mnt/flash/pyeapi-<VERSION>.tar.gz

These packages must be re-installed on reboot. Therefore, add the install commands to /mnt/flash/rc.eos to trigger the install on reboot:

[admin@veos ~]$ vi /mnt/flash/rc.eos

Add the lines (the #! may already exist in your rc.eos)

#!/bin/bash
sudo pip install /mnt/flash/netaddr-<VERSION>.tar.gz
sudo pip install /mnt/flash/pyeapi-<VERSION>.tar.gz

Development - Run pyeapi from Source

Tip

We recommend running pyeapi in a virtual environment. For more information, read this.

These instructions will help you install and run pyeapi from source. This is useful if you plan on contributing or if you’d always like to see the latest code in the develop branch.

Important

These steps require Pip and Git

Step 1: Clone the pyeapi Github repo

# Go to a directory where you'd like to keep the source
admin:~ admin$ cd ~/projects
admin:~ admin$ git clone https://github.com/arista-eosplus/pyeapi.git
admin:~ admin$ cd pyeapi

Step 2: Check out the desired version or branch

# Go to a directory where you'd like to keep the source
admin:~ admin$ cd ~/projects/pyeapi

# To see a list of available versions or branches
admin:~ admin$ git tag
admin:~ admin$ git branch

# Checkout the desired version of code
admin:~ admin$ git checkout v0.3.3

Step 3: Install pyeapi using Pip with -e switch

# Go to a directory where you'd like to keep the source
admin:~ admin$ cd ~/projects/pyeapi

# Install
admin:~ admin$ sudo pip install -e ~/projects/pyeapi

Step 4: Install pyeapi requirements

# Go to a directory where you'd like to keep the source
admin:~ admin$ pip install -r dev-requirements.txt

Tip

If you start using pyeapi and get import errors, make sure your PYTHONPATH is set to include the path to pyeapi.

Development - Upgrade Pyeapi

admin:~ admin$ cd ~/projects/pyeapi
admin:~ admin$ git pull

Note

If you followed the directions above and used pip install -e, pip will automatically use the updated code.