.. _junos_rollback:


junos_rollback - Rollback configuration of device
+++++++++++++++++++++++++++++++++++++++++++++++++

:Author: Rick Sherman, Juniper Networks

.. contents::
   :local:
   :depth: 1

Synopsis
--------

.. versionadded:: 1.2.0

Rollback the configuration of a device running Junos

Options
-------

.. raw:: html

    <table border=1 cellpadding=4>
    <tr>
    <th class="head">parameter</th>
    <th class="head">required</th>
    <th class="head">default</th>
    <th class="head">choices</th>
    <th class="head">comments</th>
    </tr>
            <tr>
    <td>comment</td>
    <td>no</td>
    <td>None</td>
        <td><ul></ul></td>
        <td>Provide a comment to the commit of the configuration</td>
    </tr>
            <tr>
    <td>confirm</td>
    <td>no</td>
    <td>None</td>
        <td><ul></ul></td>
        <td>Provide a confirm in minutes to the commit of the configuration</td>
    </tr>
            <tr>
    <td>diffs_file</td>
    <td>no</td>
    <td>None</td>
        <td><ul></ul></td>
        <td>Path to the file where any diffs will be written</td>
    </tr>
            <tr>
    <td>host</td>
    <td>yes</td>
    <td></td>
        <td><ul></ul></td>
        <td>Set to {{ inventory_hostname }}</td>
    </tr>
            <tr>
    <td>logfile</td>
    <td>no</td>
    <td>None</td>
        <td><ul></ul></td>
        <td>Path on the local server where the progress status is logged for debugging purposes</td>
    </tr>
            <tr>
    <td>mode</td>
    <td>no</td>
    <td>None</td>
        <td><ul></ul></td>
        <td>mode of console connection (telnet/serial). If mode is not provided SSH connection is used.</td>
    </tr>
            <tr>
    <td>passwd</td>
    <td>no</td>
    <td>assumes ssh-key active</td>
        <td><ul></ul></td>
        <td>Login password</td>
    </tr>
            <tr>
    <td>port</td>
    <td>no</td>
    <td>830</td>
        <td><ul></ul></td>
        <td>port number to use when connecting to the device</td>
    </tr>
            <tr>
    <td>rollback</td>
    <td>yes</td>
    <td>None</td>
        <td><ul></ul></td>
        <td>The rollback id value [0-49]</td>
    </tr>
            <tr>
    <td>ssh_private_key_file</td>
    <td>no</td>
    <td>None</td>
        <td><ul></ul></td>
        <td>This can be used if you need to provide a private key rather than loading the key into the ssh-key-ring/environment.  if your ssh-key requires a password, then you must provide it via **passwd**</td>
    </tr>
            <tr>
    <td>timeout</td>
    <td>no</td>
    <td>0</td>
        <td><ul></ul></td>
        <td>Extend the NETCONF RPC timeout beyond the default value of 30 seconds. Set this value to accommodate rollbacks that might take longer than the default timeout interval.</td>
    </tr>
            <tr>
    <td>user</td>
    <td>no</td>
    <td>$USER</td>
        <td><ul></ul></td>
        <td>Login username</td>
    </tr>
        </table>


.. note:: Requires junos-eznc >= 1.2.2


Examples
--------

.. raw:: html

    <br/>


::

    
    - junos_rollback:
       host: "{{ inventory_hostname }}"
       logfile=rollback.log
       diffs_file=rollback.diff
       rollback=1
       comment="Rolled back by Ansible"
       confirm=5
    
    # over console server connection using PyEZ >= 2.0
    - junos_rollback:
       host: "{{ inventory_hostname }}"
       logfile=rollback.log
       diffs_file=rollback.diff
       rollback=1
       comment="Rolled back by Ansible"
       confirm=5
       mode='telnet'
       port=7015