Current File : //lib/python2.7/site-packages/salt/proxy/netmiko_px.pyc
�
���^c @@ s' d Z d d l m Z d d l Z y: d d l m Z d d l m Z d d l m Z e Z
Wn e k
ru e Z
n Xy d d l
m Z Wn! e k
r� d d l m Z n Xd g Z d Z e j e � Z i Z d � Z d
� Z d � Z d � Z d
� Z d � Z d � Z d � Z d � Z d S( s
Netmiko
=======
.. versionadded:: 2019.2.0
Proxy module for managing network devices via
`Netmiko <https://github.com/ktbyers/netmiko>`_.
:codeauthor: Mircea Ulinic <ping@mirceaulinic.net> & Kirk Byers <ktbyers@twb-tech.com>
:maturity: new
:depends: netmiko
:platform: unix
Dependencies
------------
The ``netmiko`` proxy modules requires Netmiko to be installed: ``pip install netmiko``.
Pillar
------
The ``netmiko`` proxy configuration requires the following parameters in order
to connect to the network device:
- ``device_type`` - Class selection based on device type. Supported options:
- ``a10``: A10 Networks
- ``accedian``: Accedian Networks
- ``alcatel_aos``: Alcatel AOS
- ``alcatel_sros``: Alcatel SROS
- ``apresia_aeos``: Apresia AEOS
- ``arista_eos``: Arista EOS
- ``aruba_os``: Aruba
- ``avaya_ers``: Avaya ERS
- ``avaya_vsp``: Avaya VSP
- ``brocade_fastiron``: Brocade Fastiron
- ``brocade_netiron``: Brocade Netiron
- ``brocade_nos``: Brocade NOS
- ``brocade_vdx``: Brocade NOS
- ``brocade_vyos``: VyOS
- ``checkpoint_gaia``: Check Point GAiA
- ``calix_b6``: Calix B6
- ``ciena_saos``: Ciena SAOS
- ``cisco_asa``: Cisco SA
- ``cisco_ios``: Cisco IOS
- ``cisco_nxos``: Cisco NX-oS
- ``cisco_s300``: Cisco S300
- ``cisco_tp``: Cisco TpTcCe
- ``cisco_wlc``: Cisco WLC
- ``cisco_xe``: Cisco IOS
- ``cisco_xr``: Cisco XR
- ``coriant``: Coriant
- ``dell_force10``: Dell Force10
- ``dell_os10``: Dell OS10
- ``dell_powerconnect``: Dell PowerConnect
- ``eltex``: Eltex
- ``enterasys``: Enterasys
- ``extreme``: Extreme
- ``extreme_wing``: Extreme Wing
- ``f5_ltm``: F5 LTM
- ``fortinet``: Fortinet
- ``generic_termserver``: TerminalServer
- ``hp_comware``: HP Comware
- ``hp_procurve``: HP Procurve
- ``huawei``: Huawei
- ``huawei_vrpv8``: Huawei VRPV8
- ``juniper``: Juniper Junos
- ``juniper_junos``: Juniper Junos
- ``linux``: Linux
- ``mellanox``: Mellanox
- ``mrv_optiswitch``: MrvOptiswitch
- ``netapp_cdot``: NetAppcDot
- ``netscaler``: Netscaler
- ``ovs_linux``: OvsLinux
- ``paloalto_panos``: PaloAlto Panos
- ``pluribus``: Pluribus
- ``quanta_mesh``: Quanta Mesh
- ``ruckus_fastiron``: Ruckus Fastiron
- ``ubiquiti_edge``: Ubiquiti Edge
- ``ubiquiti_edgeswitch``: Ubiquiti Edge
- ``vyatta_vyos``: VyOS
- ``vyos``: VyOS
- ``brocade_fastiron_telnet``: Brocade Fastiron over Telnet
- ``brocade_netiron_telnet``: Brocade Netiron over Telnet
- ``cisco_ios_telnet``: Cisco IOS over Telnet
- ``apresia_aeos_telnet``: Apresia AEOS over Telnet
- ``arista_eos_telnet``: Arista EOS over Telnet
- ``hp_procurve_telnet``: HP Procurve over Telnet
- ``hp_comware_telnet``: HP Comware over Telnet
- ``juniper_junos_telnet``: Juniper Junos over Telnet
- ``calix_b6_telnet``: Calix B6 over Telnet
- ``dell_powerconnect_telnet``: Dell PowerConnect over Telnet
- ``generic_termserver_telnet``: TerminalServer over Telnet
- ``extreme_telnet``: Extreme Networks over Telnet
- ``ruckus_fastiron_telnet``: Ruckus Fastiron over Telnet
- ``cisco_ios_serial``: Cisco IOS over serial port
- ``ip`` - IP address of target device (not required if ``host`` is provided)
- ``host`` - Hostname of target device (not required if ``ip`` is provided)
- ``username`` - Username to authenticate against target device, if required
- ``password`` - Password to authenticate against target device, if required
- ``secret`` - The enable password if target device requires one
- ``port`` - The destination port used to connect to the target device
- ``global_delay_factor`` - Multiplication factor affecting Netmiko delays
(default: ``1``)
- ``use_keys`` - Connect to target device using SSH keys (default: ``False``)
- ``key_file`` - Filename path of the SSH key file to use
- ``allow_agent`` - Enable use of SSH key-agent
- ``ssh_strict`` - Automatically reject unknown SSH host keys (default:
``False``, which means unknown SSH host keys will be accepted)
- ``system_host_keys`` - Load host keys from the user's "known_hosts" file
(default: ``False``)
- ``alt_host_keys`` - If ``True``, host keys will be loaded from the file
specified in ``alt_key_file`` (default: ``False``)
- ``alt_key_file`` - SSH host key file to use (if ``alt_host_keys=True``)
- ``ssh_config_file`` - File name of OpenSSH configuration file
- ``timeout`` - Connection timeout, in seconds (default: ``90``)
- ``session_timeout`` - Set a timeout for parallel requests, in seconds
(default: ``60``)
- ``keepalive`` - Send SSH keepalive packets at a specific interval, in
seconds. Currently defaults to ``0``, for backwards compatibility (it will
not attempt to keep the connection alive using the KEEPALIVE packets).
- ``default_enter`` - Character(s) to send to correspond to enter key (default:
``\n``)
- ``response_return`` - Character(s) to use in normalized return data to
represent enter key (default: ``\n``)
- ``always_alive`` - In certain less dynamic environments, maintaining the
remote connection permanently open with the network device is not always
beneficial. In that case, the user can select to initialize the connection
only when needed, by setting this option to ``False``. By default this option
is set to ``True`` (maintains the connection with the remote network device)
- ``multiprocessing`` - Overrides the :conf_minion:`multiprocessing` option,
per proxy minion, as the Netmiko communication channel is mainly SSH
(default: ``False``)
Proxy Pillar Example
--------------------
.. code-block:: yaml
proxy:
proxytype: netmiko
device_type: juniper_junos
host: router1.example.com
username: example
password: example
.. code-block:: yaml
proxy:
proxytype: netmiko
device_type: cisco_ios
ip: 1.2.3.4
username: test
use_keys: true
secret: w3@k
i ( t absolute_importN( t ConnectHandler( t NetMikoTimeoutException( t NetMikoAuthenticationException( t clean_kwargst netmikoc C@ s t s t d f St S( s>
Proxy module available only if Netmiko is installed.
sB The netmiko proxy module requires netmiko library to be installed.( t HAS_NETMIKOt Falset __virtualname__( ( ( s9 /usr/lib/python2.7/site-packages/salt/proxy/netmiko_px.pyt __virtual__� s
c C@ s | j d i � } | j d t � | d <| j � } | j d d � | j d | j d t � � t d <yS t | � } | t d <t t d <| t d <t t d <t d s� t d j � n WnK t k
r� } t
j d
d t �n& t k
r} t
j d
d t �n Xt S(
sP
Open the connection to the network device
managed through netmiko.
t proxyt multiprocessingt proxytypet always_alivet proxy_always_alivet
connectiont initializedt argst ups& Unable to setup the netmiko connectiont exc_infoN(
t getR t copyt popt Nonet Truet netmiko_deviceR t
disconnectR t logt errorR ( t optst
proxy_dictt netmiko_connection_argsR t t_errt au_err( ( s9 /usr/lib/python2.7/site-packages/salt/proxy/netmiko_px.pyt init� s&
c C@ sT t j d | j d d � � t d s* t St � rP t � rP t d j j j � St
S( s?
Return the connection status with the network device.
s Checking if %s is still alivet idt R
R ( R t debugR R R t pingR t remote_connt transportt is_aliveR ( R ( ( s9 /usr/lib/python2.7/site-packages/salt/proxy/netmiko_px.pyt alive s
c C@ s t j d t � S( s'
Connection open successfully?
R ( R R R ( ( ( s9 /usr/lib/python2.7/site-packages/salt/proxy/netmiko_px.pyR& s c C@ s t j d t � S( s+
Connection finished initializing?
R ( R R R ( ( ( s9 /usr/lib/python2.7/site-packages/salt/proxy/netmiko_px.pyR s c C@ s
t d � S( s,
Closes connection with the device.
R ( t call( R ( ( s9 /usr/lib/python2.7/site-packages/salt/proxy/netmiko_px.pyt shutdown s c C@ s
t j d � S( s'
Return the connection object.
R ( R R ( ( ( s9 /usr/lib/python2.7/site-packages/salt/proxy/netmiko_px.pyt conn* s c C@ s t d S( s)
Return the Netmiko device args.
R ( R ( ( ( s9 /usr/lib/python2.7/site-packages/salt/proxy/netmiko_px.pyR 1 s c O@ sf t | � } t d sL t t d � } t | | � | | � } | j � | St t d | � | | � S( s,
Calls an arbitrary netmiko method.
R
R R ( R R R t getattrR ( t methodR t kwargsR t ret( ( s9 /usr/lib/python2.7/site-packages/salt/proxy/netmiko_px.pyR+ 8 s
( t __doc__t
__future__R t loggingR R t netmiko.ssh_exceptionR R R R t ImportErrorR t salt.utils.argsR t
salt.utilst __proxyenabled__R t getLoggert __name__R R R R" R* R& R R, R- R R+ ( ( ( s9 /usr/lib/python2.7/site-packages/salt/proxy/netmiko_px.pyt <module>� s4
Mini Shell