mirror of
https://github.com/valitydev/salt.git
synced 2024-11-07 17:09:03 +00:00
129 lines
3.1 KiB
ReStructuredText
129 lines
3.1 KiB
ReStructuredText
==========================================================================
|
|
RHEL / CentOS / Scientific Linux / Amazon Linux / Oracle Linux
|
|
==========================================================================
|
|
|
|
Installation Using pip
|
|
======================
|
|
|
|
Since Salt is on `PyPI`_, it can be installed using pip, though most users
|
|
prefer to install using RPMs (which can be installed from `EPEL`_).
|
|
Installation from pip is easy:
|
|
|
|
.. _`PyPI`: https://pypi.python.org/pypi/salt
|
|
|
|
.. code-block:: bash
|
|
|
|
pip install salt
|
|
|
|
.. warning::
|
|
|
|
If installing from pip (or from source using ``setup.py install``), be
|
|
advised that the ``yum-utils`` package is needed for Salt to manage
|
|
packages. Also, if the Python dependencies are not already installed, then
|
|
you will need additional libraries/tools installed to build some of them.
|
|
More information on this can be found :ref:`here
|
|
<installing-for-development>`.
|
|
|
|
Installation from EPEL
|
|
======================
|
|
|
|
Beginning with version 0.9.4, Salt has been available in `EPEL`_. It is
|
|
installable using yum. Salt should work properly with all mainstream
|
|
derivatives of RHEL, including CentOS, Scientific Linux, Oracle Linux and
|
|
Amazon Linux. Report any bugs or issues on the `issue tracker`__.
|
|
|
|
.. __: https://github.com/saltstack/salt/issues
|
|
|
|
On RHEL6, the proper Jinja package 'python-jinja2' was moved from EPEL to the
|
|
"RHEL Server Optional Channel". Verify this repository is enabled before
|
|
installing salt on RHEL6.
|
|
|
|
.. _`EPEL`: http://fedoraproject.org/wiki/EPEL
|
|
|
|
|
|
Enabling EPEL on RHEL
|
|
---------------------
|
|
|
|
If EPEL is not enabled on your system, you can use the following commands to
|
|
enable it.
|
|
|
|
For RHEL 5:
|
|
|
|
.. code-block:: bash
|
|
|
|
rpm -Uvh http://mirror.pnl.gov/epel/5/i386/epel-release-5-4.noarch.rpm
|
|
|
|
For RHEL 6:
|
|
|
|
.. code-block:: bash
|
|
|
|
rpm -Uvh http://ftp.linux.ncsu.edu/pub/epel/6/i386/epel-release-6-8.noarch.rpm
|
|
|
|
|
|
Installing Stable Release
|
|
-------------------------
|
|
|
|
Salt is packaged separately for the minion and the master. It is necessary only
|
|
to install the appropriate package for the role the machine will play.
|
|
Typically, there will be one master and multiple minions.
|
|
|
|
On the salt-master, run this:
|
|
|
|
.. code-block:: bash
|
|
|
|
yum install salt-master
|
|
|
|
On each salt-minion, run this:
|
|
|
|
.. code-block:: bash
|
|
|
|
yum install salt-minion
|
|
|
|
Installing from ``epel-testing``
|
|
--------------------------------
|
|
|
|
When a new Salt release is packaged, it is first admitted into the
|
|
``epel-testing`` repository, before being moved to the stable repo.
|
|
|
|
To install from ``epel-testing``, use the ``enablerepo`` argument for yum:
|
|
|
|
.. code-block:: bash
|
|
|
|
yum --enablerepo=epel-testing install salt-minion
|
|
|
|
|
|
Post-installation tasks
|
|
=======================
|
|
|
|
**Master**
|
|
|
|
To have the Master start automatically at boot time:
|
|
|
|
.. code-block:: bash
|
|
|
|
chkconfig salt-master on
|
|
|
|
|
|
To start the Master:
|
|
|
|
.. code-block:: bash
|
|
|
|
service salt-master start
|
|
|
|
**Minion**
|
|
|
|
To have the Minion start automatically at boot time:
|
|
|
|
.. code-block:: bash
|
|
|
|
chkconfig salt-minion on
|
|
|
|
|
|
To start the Minion:
|
|
|
|
.. code-block:: bash
|
|
|
|
service salt-minion start
|
|
|
|
Now go to the :doc:`Configuring Salt</ref/configuration/index>` page.
|