Giter VIP home page Giter VIP logo

netmiko's Introduction

PyPI Downloads

Netmiko

Multi-vendor library to simplify Paramiko SSH connections to network devices

Python 2.7, 3.5, 3.6

Requires:

  • Paramiko >= 2.4.1
  • scp >= 0.10.0
  • pyyaml
  • pyserial
  • textfsm

Supports:

Regularly tested
  • Arista vEOS
  • Cisco ASA
  • Cisco IOS
  • Cisco IOS-XE
  • Cisco IOS-XR
  • Cisco NX-OS
  • Cisco SG300
  • HP Comware7
  • HP ProCurve
  • Juniper Junos
  • Linux
Limited testing
  • Alcatel AOS6/AOS8
  • Apresia Systems AEOS
  • Calix B6
  • Cisco WLC
  • Dell OS9 (Force10)
  • Dell OS10
  • Dell PowerConnect
  • Extreme ERS (Avaya)
  • Extreme VSP (Avaya)
  • Extreme VDX (Brocade)
  • Extreme MLX/NetIron (Brocade/Foundry)
  • Huawei
  • IP Infusion OcNOS
  • Mellanox
  • NetApp cDOT
  • OneAccess
  • Palo Alto PAN-OS
  • Pluribus
  • Ruckus ICX/FastIron
  • Ubiquiti EdgeSwitch
  • Vyatta VyOS
Experimental
  • A10
  • Accedian
  • Aruba
  • Ciena SAOS
  • Citrix Netscaler
  • Cisco Telepresence
  • Check Point GAiA
  • Coriant
  • Dell OS6
  • Dell EMC Isilon
  • Eltex
  • Enterasys
  • Extreme EXOS
  • Extreme Wing
  • Extreme SLX (Brocade)
  • F5 TMSH
  • F5 Linux
  • Fortinet
  • MRV Communications OptiSwitch
  • Nokia/Alcatel SR-OS
  • QuantaMesh
  • Rad ETX

Tutorials:

Standard Tutorial:

https://pynet.twb-tech.com/blog/automation/netmiko.html

Secure Copy Tutorial:

https://pynet.twb-tech.com/blog/automation/netmiko-scp.html

SSH Proxy:

https://pynet.twb-tech.com/blog/automation/netmiko-proxy.html

Common Issues:

https://github.com/ktbyers/netmiko/blob/develop/COMMON_ISSUES.md

Documentation (Stable)

http://netmiko.readthedocs.io/en/stable/index.html

Examples:

Create a dictionary representing the device.

Supported device_types can be found here, see CLASS_MAPPER keys.

from netmiko import ConnectHandler

cisco_881 = {
    'device_type': 'cisco_ios',
    'ip':   '10.10.10.10',
    'username': 'test',
    'password': 'password',
    'port' : 8022,          # optional, defaults to 22
    'secret': 'secret',     # optional, defaults to ''
    'verbose': False,       # optional, defaults to False
}

Establish an SSH connection to the device by passing in the device dictionary.

net_connect = ConnectHandler(**cisco_881)

Execute show commands.

output = net_connect.send_command('show ip int brief')
print(output)
Interface                  IP-Address      OK? Method Status                Protocol
FastEthernet0              unassigned      YES unset  down                  down
FastEthernet1              unassigned      YES unset  down                  down
FastEthernet2              unassigned      YES unset  down                  down
FastEthernet3              unassigned      YES unset  down                  down
FastEthernet4              10.10.10.10     YES manual up                    up
Vlan1                      unassigned      YES unset  down                  down

Execute configuration change commands (will automatically enter into config mode)

config_commands = [ 'logging buffered 20000',
                    'logging buffered 20010',
                    'no logging console' ]
output = net_connect.send_config_set(config_commands)
print(output)
pynet-rtr1#config term
Enter configuration commands, one per line.  End with CNTL/Z.
pynet-rtr1(config)#logging buffered 20000
pynet-rtr1(config)#logging buffered 20010
pynet-rtr1(config)#no logging console
pynet-rtr1(config)#end
pynet-rtr1#

TextFSM Integration

Netmiko has been configured to automatically look in ~/ntc-template/templates/index for the ntc-templates index file. Alternatively, you can explicitly tell Netmiko where to look for the TextFSM template directory by setting the NET_TEXTFSM environment variable (note, there must be an index file in this directory):

export NET_TEXTFSM=/path/to/ntc-templates/templates/

More info on TextFSM and Netmiko.

Questions/Discussion

If you find an issue with Netmiko, then you can open an issue on this projects issue page here: https://github.com/ktbyers/netmiko/issues

If you have questions or would like to discuss Netmiko, a Netmiko channel exists on this Slack team. To join, visit this url and request access to the Slack team. Once access is granted you can join the #netmiko channel.


Kirk Byers
Python for Network Engineers
https://pynet.twb-tech.com

netmiko's People

Contributors

ktbyers avatar jcrotts avatar nmusser avatar plucena24 avatar mirceaulinic avatar ravenblue12 avatar nmisaki avatar broncofan avatar tonypnode avatar maximumg avatar smk4664 avatar lindsayhill avatar mww012 avatar ggabriele avatar jobec avatar mileswdavis avatar static0verride avatar rptetzloff avatar lamiskin avatar ahmadbarrin avatar jumpojoy avatar tknv avatar ylebiannic avatar tyler-8 avatar rollerr avatar vnznznz avatar supertylerc avatar koumiyata avatar jonathanccfeng avatar ebeahan avatar

Watchers

 avatar  avatar

Recommend Projects

  • React photo React

    A declarative, efficient, and flexible JavaScript library for building user interfaces.

  • Vue.js photo Vue.js

    ๐Ÿ–– Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.

  • Typescript photo Typescript

    TypeScript is a superset of JavaScript that compiles to clean JavaScript output.

  • TensorFlow photo TensorFlow

    An Open Source Machine Learning Framework for Everyone

  • Django photo Django

    The Web framework for perfectionists with deadlines.

  • D3 photo D3

    Bring data to life with SVG, Canvas and HTML. ๐Ÿ“Š๐Ÿ“ˆ๐ŸŽ‰

Recommend Topics

  • javascript

    JavaScript (JS) is a lightweight interpreted programming language with first-class functions.

  • web

    Some thing interesting about web. New door for the world.

  • server

    A server is a program made to process requests and deliver data to clients.

  • Machine learning

    Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.

  • Game

    Some thing interesting about game, make everyone happy.

Recommend Org

  • Facebook photo Facebook

    We are working to build community through open source technology. NB: members must have two-factor auth.

  • Microsoft photo Microsoft

    Open source projects and samples from Microsoft.

  • Google photo Google

    Google โค๏ธ Open Source for everyone.

  • D3 photo D3

    Data-Driven Documents codes.