mirror of
https://github.com/valitydev/salt.git
synced 2024-11-09 01:36:48 +00:00
cca8ddc886
Conflicts:
.pylintrc
.testing.pylintrc
salt/auth/pam.py
salt/modules/win_status.py
salt/utils/network.py
salt/utils/schedule.py
tests/unit/renderers/gpg_test.py
tests/unit/states/boto_secgroup.py
109 lines
2.9 KiB
ReStructuredText
109 lines
2.9 KiB
ReStructuredText
===================
|
|
Ubuntu Installation
|
|
===================
|
|
|
|
Add repository
|
|
==============
|
|
|
|
The latest packages for Ubuntu are published in the saltstack PPA. If you have
|
|
the ``add-apt-repository`` utility, you can add the repository and import the
|
|
key in one step:
|
|
|
|
.. code-block:: bash
|
|
|
|
sudo add-apt-repository ppa:saltstack/salt
|
|
|
|
In addition to the main repository, there are secondary repositories for each
|
|
individual major release. These repositories receive security and point releases
|
|
but will not upgrade to any subsequent major release. There are currently four
|
|
available repos: salt16, salt17, salt2014-1, salt2014-7. For example to follow
|
|
2014.7.x releases:
|
|
|
|
.. code-block:: bash
|
|
|
|
sudo add-apt-repository ppa:saltstack/salt2014-7
|
|
|
|
.. admonition:: add-apt-repository: command not found?
|
|
|
|
The ``add-apt-repository`` command is not always present on Ubuntu systems.
|
|
This can be fixed by installing `python-software-properties`:
|
|
|
|
.. code-block:: bash
|
|
|
|
sudo apt-get install python-software-properties
|
|
|
|
The following may be required as well:
|
|
|
|
.. code-block:: bash
|
|
|
|
sudo apt-get install software-properties-common
|
|
|
|
Note that since Ubuntu 12.10 (Raring Ringtail), ``add-apt-repository`` is
|
|
found in the `software-properties-common` package, and is part of the base
|
|
install. Thus, ``add-apt-repository`` should be able to be used
|
|
out-of-the-box to add the PPA.
|
|
|
|
Alternately, manually add the repository and import the PPA key with these
|
|
commands:
|
|
|
|
.. code-block:: bash
|
|
|
|
echo deb http://ppa.launchpad.net/saltstack/salt/ubuntu `lsb_release -sc` main | sudo tee /etc/apt/sources.list.d/saltstack.list
|
|
wget -q -O- "http://keyserver.ubuntu.com:11371/pks/lookup?op=get&search=0x4759FA960E27C0A6" | sudo apt-key add -
|
|
|
|
After adding the repository, update the package management database:
|
|
|
|
.. code-block:: bash
|
|
|
|
sudo apt-get update
|
|
|
|
|
|
Install packages
|
|
================
|
|
|
|
Install the Salt master, minion, or syndic from the repository with the apt-get
|
|
command. These examples each install one daemon, but more than one package name
|
|
may be given at a time:
|
|
|
|
.. code-block:: bash
|
|
|
|
sudo apt-get install salt-master
|
|
|
|
.. code-block:: bash
|
|
|
|
sudo apt-get install salt-minion
|
|
|
|
.. code-block:: bash
|
|
|
|
sudo apt-get install salt-syndic
|
|
|
|
Some core components are packaged separately in the Ubuntu repositories. These should be installed as well: salt-cloud, salt-ssh, salt-api
|
|
|
|
.. code-block:: bash
|
|
|
|
sudo apt-get install salt-cloud
|
|
|
|
.. code-block:: bash
|
|
|
|
sudo apt-get install salt-ssh
|
|
|
|
.. code-block:: bash
|
|
|
|
sudo apt-get install salt-api
|
|
|
|
.. _ubuntu-config:
|
|
|
|
|
|
ZeroMQ 4
|
|
========
|
|
|
|
ZeroMQ 4 is available by default for Ubuntu 14.04 and newer. However, for Ubuntu
|
|
12.04 LTS, starting with Salt version ``2014.7.5``, ZeroMQ 4 is included with the
|
|
Salt installation package and nothing additional needs to be done.
|
|
|
|
|
|
Post-installation tasks
|
|
=======================
|
|
|
|
Now go to the :doc:`Configuring Salt</ref/configuration/index>` page.
|