Current File : //lib/python2.7/site-packages/salt/states/junos.pyo
�
���^c @@ sD d Z d d l m Z m Z m Z d d l Z d d l m Z e j � Z d � Z
e
d d d d � � Z e
d � � Z
e
d � � Z e
d
� � Z e
d � � Z e
d � � Z e
d
� � Z e
d � � Z e
d � � Z e
d � � Z e
d d � � Z e
d � � Z e
d � � Z e
d � � Z e
d � � Z d S( uz
State modules to interact with Junos devices.
==============================================
:maturity: new
:dependencies: junos-eznc, jxmlease
.. note::
Those who wish to use junos-eznc (PyEZ) version >= 2.1.0, must
use the latest salt code from github until the next release.
Refer to :mod:`junos <salt.proxy.junos>` for information on connecting to junos proxy.
i ( t absolute_importt print_functiont unicode_literalsN( t wrapsc @ s t � � � f d � � } | S( Nc @ s% � | | � } | d d | d <| S( Nu changesu outu result( ( t argst kwargst ret( t function( s5 /usr/lib/python2.7/site-packages/salt/states/junos.pyt wrapper s ( R ( R R ( ( R s5 /usr/lib/python2.7/site-packages/salt/states/junos.pyt resultdecorator s u xmlc K@ sr i | d 6i d 6t d 6d d 6} | d k rQ t d | | | | | � | d <n t d | | | | � | d <| S( ua
Executes the given rpc. The returned data can be stored in a file
by specifying the destination path with dest as an argument
.. code-block:: yaml
get-interface-information:
junos:
- rpc
- dest: /home/user/rpc.log
- interface_name: lo0
Parameters:
Required
* cmd:
The rpc to be executed. (default = None)
Optional
* dest:
Destination file where the rpc output is stored. (default = None)
Note that the file will be stored on the proxy minion. To push the
files to the master use the salt's following execution module: :py:func:`cp.push <salt.modules.cp.push>`
* format:
The format in which the rpc reply must be stored in file specified in the dest
(used only when dest is specified) (default = xml)
* kwargs: keyworded arguments taken by rpc call like-
* timeout:
Set NETCONF RPC timeout. Can be used for commands which
take a while to execute. (default= 30 seconds)
* filter:
Only to be used with 'get-config' rpc to get specific configuration.
* terse:
Amount of information you want.
* interface_name:
Name of the interface whose information you want.
u nameu changesu resultu u commentu junos.rpcN( t Truet Nonet __salt__( t namet destt formatR R R ( ( s5 /usr/lib/python2.7/site-packages/salt/states/junos.pyt rpc" s '" c K@ s= i | d 6i d 6t d 6d d 6} t d | | � | d <| S( uJ
Changes the hostname of the device.
.. code-block:: yaml
device_name:
junos:
- set_hostname
- comment: "Host-name set via saltstack."
Parameters:
Required
* hostname: The name to be set. (default = None)
Optional
* kwargs: Keyworded arguments which can be provided like-
* timeout:
Set NETCONF RPC timeout. Can be used for commands
which take a while to execute. (default = 30 seconds)
* comment:
Provide a comment to the commit. (default = None)
* confirm:
Provide time in minutes for commit confirmation. If this option is specified, the commit will be rollbacked in the given time unless the commit is confirmed.
u nameu changesu resultu u commentu junos.set_hostname( R
R ( R
R R ( ( s5 /usr/lib/python2.7/site-packages/salt/states/junos.pyt set_hostnameV s "c K@ s: i | d 6i d 6t d 6d d 6} t d | � | d <| S( u�
Commits the changes loaded into the candidate configuration.
.. code-block:: yaml
commit the changes:
junos:
- commit
- confirm: 10
Parameters:
Optional
* kwargs: Keyworded arguments which can be provided like-
* timeout:
Set NETCONF RPC timeout. Can be used for commands which take a while to execute. (default = 30 seconds)
* comment:
Provide a comment to the commit. (default = None)
* confirm:
Provide time in minutes for commit confirmation. If this option is specified, the commit will be rollbacked in the given time unless the commit is confirmed.
* sync:
On dual control plane systems, requests that the candidate configuration on one control plane be copied to the other control plane,checked for correct syntax, and committed on both Routing Engines. (default = False)
* force_sync:
On dual control plane systems, force the candidate configuration
on one control plane to be copied to the other control plane.
* full:
When set to True requires all the daemons to check and evaluate the new configuration.
* detail:
When true return commit detail.
u nameu changesu resultu u commentu junos.commit( R
R ( R
R R ( ( s5 /usr/lib/python2.7/site-packages/salt/states/junos.pyt commitx s '"c K@ s= i | d 6i d 6t d 6d d 6} t d | | � | d <| S( u�
Rollbacks the committed changes.
.. code-block:: yaml
rollback the changes:
junos:
- rollback
- id: 5
Parameters:
Optional
* id:
The rollback id value [0-49]. (default = 0)
* kwargs: Keyworded arguments which can be provided like-
* timeout:
Set NETCONF RPC timeout. Can be used for commands which
take a while to execute. (default = 30 seconds)
* comment:
Provide a comment to the commit. (default = None)
* confirm:
Provide time in minutes for commit confirmation. If this option is specified, the commit will be rollbacked in the given time unless the commit is confirmed.
* diffs_file:
Path to the file where any diffs will be written. (default = None)
u nameu changesu resultu u commentu junos.rollback( R
R ( R
t idR R ( ( s5 /usr/lib/python2.7/site-packages/salt/states/junos.pyt rollback� s "c C@ s: i | d 6i d 6t d 6d d 6} t d | � | d <| S( u0
Gets the difference between the candidate and the current configuration.
.. code-block:: yaml
get the diff:
junos:
- diff
- id: 10
Parameters:
Optional
* id:
The rollback id value [0-49]. (default = 0)
u nameu changesu resultu u commentu
junos.diff( R
R ( R
t d_idR ( ( s5 /usr/lib/python2.7/site-packages/salt/states/junos.pyt diff� s "c K@ s= i | d 6i d 6t d 6d d 6} t d | | � | d <| S( u!
Executes the CLI commands and reuturns the text output.
.. code-block:: yaml
show version:
junos:
- cli
- format: xml
Parameters:
Required
* command:
The command that need to be executed on Junos CLI. (default = None)
Optional
* kwargs: Keyworded arguments which can be provided like-
* format:
Format in which to get the CLI output. (text or xml, default = 'text')
* timeout:
Set NETCONF RPC timeout. Can be used for commands which
take a while to execute. (default = 30 seconds)
* dest:
The destination file where the CLI output can be stored. (default = None)
u nameu changesu resultu u commentu junos.cli( R
R ( R
R R ( ( s5 /usr/lib/python2.7/site-packages/salt/states/junos.pyt cli� s "c K@ s: i | d 6i d 6t d 6d d 6} t d | � | d <| S( u�
Shuts down the device.
.. code-block:: yaml
shut the device:
junos:
- shutdown
- in_min: 10
Parameters:
Optional
* kwargs:
* reboot:
Whether to reboot instead of shutdown. (default=False)
* at:
Specify time for reboot. (To be used only if reboot=yes)
* in_min:
Specify delay in minutes for shutdown
u nameu changesu resultu u commentu junos.shutdown( R
R ( R
R R ( ( s5 /usr/lib/python2.7/site-packages/salt/states/junos.pyt shutdown� s "c K@ s= i | d 6i d 6t d 6d d 6} t d | | � | d <| S( u$
Loads and commits the configuration provided.
.. code-block:: yaml
Install the mentioned config:
junos:
- install_config
- path: salt//configs/interface.set
- timeout: 100
- diffs_file: 'var/log/diff'
.. code-block:: yaml
Install the mentioned config:
junos:
- install_config
- template_path: salt//configs/interface.set
- timeout: 100
- template_vars:
interface_name: lo0
description: Creating interface via SaltStack.
name
Path where the configuration/template file is present. If the file has
a ``*.conf`` extension, the content is treated as text format. If the
file has a ``*.xml`` extension, the content is treated as XML format. If
the file has a ``*.set`` extension, the content is treated as Junos OS
``set`` commands
template_vars
The dictionary of data for the jinja variables present in the jinja
template
timeout : 30
Set NETCONF RPC timeout. Can be used for commands which take a while to
execute.
overwrite : False
Set to ``True`` if you want this file is to completely replace the
configuration file.
replace : False
Specify whether the configuration file uses "replace:" statements. Only
those statements under the 'replace' tag will be changed.
comment
Provide a comment to the commit. (default = None)
confirm
Provide time in minutes for commit confirmation. If this option is
specified, the commit will be rolled back in the given time unless the
commit is confirmed.
diffs_file
Path to the file where the diff (difference in old configuration and the
committed configuration) will be stored.
.. note::
The file will be stored on the proxy minion. To push the files to the
master use :py:func:`cp.push <salt.modules.cp.push>`.
u nameu changesu resultu u commentu junos.install_config( R
R ( R
R R ( ( s5 /usr/lib/python2.7/site-packages/salt/states/junos.pyt install_config s C"c C@ s7 i | d 6i d 6t d 6d d 6} t d � | d <| S( u�
Resets the device to default factory settings.
.. code-block:: yaml
reset my device:
junos.zeroize
name: can be anything
u nameu changesu resultu u commentu
junos.zeroize( R
R ( R
R ( ( s5 /usr/lib/python2.7/site-packages/salt/states/junos.pyt zeroizea s "c K@ s= i | d 6i d 6t d 6d d 6} t d | | � | d <| S( u�
Installs the given image on the device. After the installation is complete
the device is rebooted, if reboot=True is given as a keyworded argument.
.. code-block:: yaml
salt://images/junos_image.tgz:
junos:
- install_os
- timeout: 100
- reboot: True
Parameters:
Required
* path:
Path where the image file is present on the pro xy minion.
Optional
* kwargs: keyworded arguments to be given such as timeout, reboot etc
* timeout:
Set NETCONF RPC timeout. Can be used to RPCs which
take a while to execute. (default = 30 seconds)
* reboot:
Whether to reboot after installation (default = False)
* no_copy:
When True the software package will not be SCP’d to the device. (default = False)
u nameu changesu resultu u commentu junos.install_os( R
R ( R
R R ( ( s5 /usr/lib/python2.7/site-packages/salt/states/junos.pyt
install_osr s "c K@ s@ i | d 6i d 6t d 6d d 6} t d | | | � | d <| S( u�
Copies the file from the local device to the junos device.
.. code-block:: yaml
/home/m2/info.txt:
junos:
- file_copy
- dest: info_copy.txt
Parameters:
Required
* src:
The sorce path where the file is kept.
* dest:
The destination path where the file will be copied.
u nameu changesu resultu u commentu junos.file_copy( R
R ( R
R R R ( ( s5 /usr/lib/python2.7/site-packages/salt/states/junos.pyt file_copy� s "c C@ s7 i | d 6i d 6t d 6d d 6} t d � | d <| S( u�
Attempts an exclusive lock on the candidate configuration. This
is a non-blocking call.
.. note::
Any user who wishes to use lock, must necessarily unlock the
configuration too. Ensure :py:func:`unlock <salt.states.junos.unlock>`
is called in the same orchestration run in which the lock is called.
.. code-block:: yaml
lock the config:
junos.lock
u nameu changesu resultu u commentu
junos.lock( R
R ( R
R ( ( s5 /usr/lib/python2.7/site-packages/salt/states/junos.pyt lock� s "c C@ s7 i | d 6i d 6t d 6d d 6} t d � | d <| S( u�
Unlocks the candidate configuration.
.. code-block:: yaml
unlock the config:
junos.unlock
u nameu changesu resultu u commentu junos.unlock( R
R ( R
R ( ( s5 /usr/lib/python2.7/site-packages/salt/states/junos.pyt unlock� s "c K@ s= i | d 6i d 6t d 6d d 6} t d | | � | d <| S( u
Loads the configuration provided onto the junos device.
.. code-block:: yaml
Install the mentioned config:
junos:
- load
- path: salt//configs/interface.set
.. code-block:: yaml
Install the mentioned config:
junos:
- load
- template_path: salt//configs/interface.set
- template_vars:
interface_name: lo0
description: Creating interface via SaltStack.
name
Path where the configuration/template file is present. If the file has
a ``*.conf`` extension, the content is treated as text format. If the
file has a ``*.xml`` extension, the content is treated as XML format. If
the file has a ``*.set`` extension, the content is treated as Junos OS
``set`` commands.
overwrite : False
Set to ``True`` if you want this file is to completely replace the
configuration file.
replace : False
Specify whether the configuration file uses "replace:" statements.
Only those statements under the 'replace' tag will be changed.
format:
Determines the format of the contents.
update : False
Compare a complete loaded configuration against the candidate
configuration. For each hierarchy level or configuration object that is
different in the two configurations, the version in the loaded
configuration replaces the version in the candidate configuration. When
the configuration is later committed, only system processes that are
affected by the changed configuration elements parse the new
configuration. This action is supported from PyEZ 2.1 (default = False)
template_vars
Variables to be passed into the template processing engine in addition
to those present in __pillar__, __opts__, __grains__, etc.
You may reference these variables in your template like so:
{{ template_vars["var_name"] }}
u nameu changesu resultu u commentu
junos.load( R
R ( R
R R ( ( s5 /usr/lib/python2.7/site-packages/salt/states/junos.pyt load� s 9"c C@ s7 i | d 6i d 6t d 6d d 6} t d � | d <| S( u�
Perform a commit check on the configuration.
.. code-block:: yaml
perform commit check:
junos.commit_check
u nameu changesu resultu u commentu junos.commit_check( R
R ( R
R ( ( s5 /usr/lib/python2.7/site-packages/salt/states/junos.pyt commit_check s "( t __doc__t
__future__R R R t loggingt functoolsR t getLoggert logR R R R R R R R R R R R R R R R R ( ( ( s5 /usr/lib/python2.7/site-packages/salt/states/junos.pyt <module> s,
3",#!H$>
Mini Shell