mirror of
https://github.com/valitydev/salt.git
synced 2024-11-07 17:09:03 +00:00
155 lines
4.3 KiB
ReStructuredText
155 lines
4.3 KiB
ReStructuredText
=========================================
|
|
Arista EOS Salt minion installation guide
|
|
=========================================
|
|
|
|
The Salt minion for Arista EOS is distributed as a SWIX extension and can be installed directly on the switch. The EOS network operating system is based on old Fedora distributions and the installation of the ``salt-minion`` requires backports. This SWIX extension contains the necessary backports, together with the Salt basecode.
|
|
|
|
.. note::
|
|
|
|
This SWIX extension has been tested on Arista DCS-7280SE-68-R, running EOS 4.17.5M and vEOS 4.18.3F.
|
|
|
|
Important Notes
|
|
===============
|
|
|
|
This package is in beta, make sure to test it carefully before running it in production.
|
|
|
|
If confirmed working correctly, please report and add a note on this page with the platform model and EOS version.
|
|
|
|
If you want to uninstall this package, please refer to the uninstalling_ section.
|
|
|
|
Installation from the Official SaltStack Repository
|
|
===================================================
|
|
|
|
Download the swix package and save it to flash.
|
|
|
|
.. code-block:: bash
|
|
|
|
veos#copy https://salt-eos.netops.life/salt-eos-latest.swix flash:
|
|
veos#copy https://salt-eos.netops.life/startup.sh flash:
|
|
|
|
Install the Extension
|
|
=====================
|
|
|
|
Copy the Salt package to extension
|
|
|
|
.. code-block:: bash
|
|
|
|
veos#copy flash:salt-eos-latest.swix extension:
|
|
|
|
Install the SWIX
|
|
|
|
.. code-block:: bash
|
|
|
|
veos#extension salt-eos-latest.swix force
|
|
|
|
Verify the installation
|
|
|
|
.. code-block:: bash
|
|
|
|
veos#show extensions | include salt-eos
|
|
salt-eos-2017-07-19.swix 1.0.11/1.fc25 A, F 27
|
|
|
|
Change the Salt master IP address or FQDN, by edit the variable (SALT_MASTER)
|
|
|
|
.. code-block:: bash
|
|
|
|
veos#bash vi /mnt/flash/startup.sh
|
|
|
|
Make sure you enable the eAPI with unix-socket
|
|
|
|
.. code-block:: bash
|
|
|
|
veos(config)#management api http-commands
|
|
protocol unix-socket
|
|
no shutdown
|
|
|
|
Post-installation tasks
|
|
=======================
|
|
|
|
Generate Keys and host record and start Salt minion
|
|
|
|
.. code-block:: bash
|
|
|
|
veos#bash
|
|
#sudo /mnt/flash/startup.sh
|
|
|
|
``salt-minion`` should be running
|
|
|
|
Copy the installed extensions to boot-extensions
|
|
|
|
.. code-block:: bash
|
|
|
|
veos#copy installed-extensions boot-extensions
|
|
|
|
Apply event-handler to let EOS start salt-minion during boot-up
|
|
|
|
.. code-block:: bash
|
|
|
|
veos(config)#event-handler boot-up-script
|
|
trigger on-boot
|
|
action bash sudo /mnt/flash/startup.sh
|
|
|
|
For more specific installation details of the ``salt-minion``, please refer to :ref:`Configuring Salt<configuring-salt>`.
|
|
|
|
.. _uninstalling:
|
|
|
|
Uninstalling
|
|
============
|
|
|
|
If you decide to uninstall this package, the following steps are recommended for safety:
|
|
|
|
1. Remove the extension from boot-extensions
|
|
|
|
.. code-block:: bash
|
|
|
|
veos#bash rm /mnt/flash/boot-extensions
|
|
|
|
2. Remove the extension from extensions folder
|
|
|
|
.. code-block:: bash
|
|
|
|
veos#bash rm /mnt/flash/.extensions/salt-eos-latest.swix
|
|
|
|
2. Remove boot-up script
|
|
|
|
.. code-block:: bash
|
|
|
|
veos(config)#no event-handler boot-up-script
|
|
|
|
Additional Information
|
|
======================
|
|
|
|
This SWIX extension contains the following RPM packages:
|
|
|
|
.. code-block:: text
|
|
|
|
libsodium-1.0.11-1.fc25.i686.rpm
|
|
libstdc++-6.2.1-2.fc25.i686.rpm
|
|
openpgm-5.2.122-6.fc24.i686.rpm
|
|
python-Jinja2-2.8-0.i686.rpm
|
|
python-PyYAML-3.12-0.i686.rpm
|
|
python-babel-0.9.6-5.fc18.noarch.rpm
|
|
python-backports-1.0-3.fc18.i686.rpm
|
|
python-backports-ssl_match_hostname-3.4.0.2-1.fc18.noarch.rpm
|
|
python-backports_abc-0.5-0.i686.rpm
|
|
python-certifi-2016.9.26-0.i686.rpm
|
|
python-chardet-2.0.1-5.fc18.noarch.rpm
|
|
python-crypto-1.4.1-1.noarch.rpm
|
|
python-crypto-2.6.1-1.fc18.i686.rpm
|
|
python-futures-3.1.1-1.noarch.rpm
|
|
python-jtextfsm-0.3.1-0.noarch.rpm
|
|
python-kitchen-1.1.1-2.fc18.noarch.rpm
|
|
python-markupsafe-0.18-1.fc18.i686.rpm
|
|
python-msgpack-python-0.4.8-0.i686.rpm
|
|
python-napalm-base-0.24.3-1.noarch.rpm
|
|
python-napalm-eos-0.6.0-1.noarch.rpm
|
|
python-netaddr-0.7.18-0.noarch.rpm
|
|
python-pyeapi-0.7.0-0.noarch.rpm
|
|
python-salt-2017.7.0_1414_g2fb986f-1.noarch.rpm
|
|
python-singledispatch-3.4.0.3-0.i686.rpm
|
|
python-six-1.10.0-0.i686.rpm
|
|
python-tornado-4.4.2-0.i686.rpm
|
|
python-urllib3-1.5-7.fc18.noarch.rpm
|
|
python2-zmq-15.3.0-2.fc25.i686.rpm
|
|
zeromq-4.1.4-5.fc25.i686.rpm
|