managing eos extensions

The most simple and efficient way to make the most of the extensibility in eos through the use of extensions. An extension provides a pre-packaged optional feature or a set of scripts in an RPM Package Manager (RPM) or Software image extension (SWIX) format. Arista provides a variety of extensions on the eos Software Downloads page.

These sections describe basic eos extension tasks:

Installing eos extensions

Complete the following steps to install an eos extension.

  1. Download the desired extension and copy it onto the devices flash storage. 
    switch# dir 
Directory of flash:/  
-rwx 479183792 Jun 23 09:46 eos-4.13.3F.swi  
-rwx 21280296 Feb 6 16:48 arista-splunk-extension.swix  
-rwx 27 Jun 23 10:08 boot-config  drwx 4096 Sep 26 2012 schedule  
-rwx 1481 Jun 27 05:54 startup-config

  2. Copy the file from the flash storage to the extensions partition. 
    switch# copy flash:arista-splunk-extension.swix extension: 
Copy completed successfully.

  3. Install the eos extension. 
    switch# extension arista-splunk-extension.swix 
If this extension modifies the behavior of the Cli, any running Cli sessions will 
need to be reset in order for the Cli modifications to take effect.

  4. If you require extension persistence across rebooting the switch, the extension should also be copied into the boot-extensions partition. 
    switch# copy installed-extensions boot-extensions

  5. Run the extension. As the CloudVision extension adds additional CLI commands to eos, the CLI session must be restarted so that the additional commands become available. To achieve this, close the SSH or the Telnet session and open a new session.

Installing eos extensions on a Dual-Supervisor Switch

Complete the following steps to install an eos extension on a dual-supervisor switch.

  1. Copy the extension from the primary supervisor to the standby supervisors flash directory. 
    switch(s1)# copy flash:<filename>.swix supervisor-peer://mnt/flash/

  2. Establish a session to the standby supervisor from the primary. 
    switch(s1)# session peer-supervisor 
Warning: Permanently added '[127.1.0.2]:3601' (RSA) to the list of known hosts. 
Last login: Mon Aug 27 17:32:00 2018 from supervisor1 

    WARNING - you are currently logged in to the standby supervisor. 
Not all cli commands are available or supported. Any configuration 
done from this cli will not be reflected in the active supervisor's 
running config and will be lost when the active supervisor writes 
its startup config. 
switch(s2)#

  3. Repeat the steps listed in the Installing eos extensions to install the eos extension.

  4. Repeat the steps listed in the Verifying eos extensions Installation to verify the extension installation.

  5. Exit standby supervisor. 
    switch(s2)# exit 
Connection to 127.1.0.1 closed. 
switch(s1)#

Verifying eos extensions Installation

Complete the steps to verify that the eos extensions installed correctly.

  1. Run the show extensions command to verify that the eos extensions are available and installed correctly. 
    switch# show extensions 
Name Version/Release Status Extension 
------------------------------------------ -------------------------  
eosSdk-1.2.1-fl.boca-1943435.i686.rpm 1.2.1/1943435.flbocaeossd A, NI 1 
arista-splunk-extension.swix 0.95/1498976.2013ltdsplun A, I 2 
fping-2.4b2-10.fc12.i686.rpm 2.4b2/10.fc12 A, I 1 
gnuplot.swix 1.10.0/1.fc14 A, I 16 
splunkforwarder-5.0.9-213964.i386.rpm 5.0.9/213964 A, NI 1 

    A: available | NA: not available | I: installed | NI: not installed | F: forced

  2. Run the show boot-extensions command to verify that the eos extensions are enabled for boot persistence. 
    switch# show boot-extensions 
arista-splunk-extension.swix 
fping-2.4b2-10.fc12.i686.rpm 
gnuplot.swix

Uninstalling an eos Extension

Complete the following steps to uninstall an eos extension.

  1. Uninstall the existing eos extension using the no extension command. 
    switch# no extension fping-2.4b2-10.fc12.i686.rpm 
switch#show extensions 
Name                                       Version/Release              Status extension 
------------------------------------------ -------------------------    ---------- 
eosSdk-1.2.1-fl.boca-1943435.i686.rpm      1.2.1/1943435.flbocaeossd A,  NI 1 
arista-splunk-extension.swix               0.95/1498976.2013ltdsplun A,  I 2 
fping-2.4b2-10.fc12.i686.rpm               2.4b2/10.fc12 A,              NI 1 
gnuplot.swix                               1.10.0/1.fc14 A,              I 16 
splunkforwarder-5.0.9-213964.i386.rpm      5.0.9/213964 A,               NI 1

    A: available | NA: not available | I: installed | NI: not installed | F: forced

  2. Remove the extension from the boot-extension using the copy installed-extensions boot-extensions command. 
    switch# copy installed-extensions boot-extensions

    Note: If you have a Dual-Supervisor Switch, connect to the secondary supervisor using the session peer-supervisor command, repeat steps 1 and 2, and finally exit from the secondary supervisor.