mirror of
https://github.com/valitydev/salt.git
synced 2024-11-07 08:58:59 +00:00
110 lines
2.2 KiB
ReStructuredText
110 lines
2.2 KiB
ReStructuredText
=======
|
|
FreeBSD
|
|
=======
|
|
|
|
Salt was added to the FreeBSD ports tree Dec 26th, 2011 by Christer Edwards
|
|
<christer.edwards@gmail.com>. It has been tested on FreeBSD 7.4, 8.2, 9.0,
|
|
9.1, 10.0 and later releases.
|
|
|
|
Installation
|
|
============
|
|
|
|
Salt is available in binary package form from both the FreeBSD pkgng repository
|
|
or directly from SaltStack. The instructions below outline installation via
|
|
both methods:
|
|
|
|
FreeBSD repo
|
|
============
|
|
|
|
The FreeBSD pkgng repository is preconfigured on systems 10.x and above. No
|
|
configuration is needed to pull from these repositories.
|
|
|
|
.. code-block:: shell
|
|
|
|
pkg install py27-salt
|
|
|
|
These packages are usually available within a few days of upstream release.
|
|
|
|
.. _freebsd-upstream:
|
|
|
|
SaltStack repo
|
|
==============
|
|
|
|
SaltStack also hosts internal binary builds of the Salt package, available from
|
|
http://repo.saltstack.org/freebsd/. To make use of this repository, add the
|
|
following file to your system:
|
|
|
|
**/usr/local/etc/pkg/repos/saltstack.conf:**
|
|
|
|
.. code-block:: json
|
|
|
|
saltstack: {
|
|
url: "http://repo.saltstack.com/freebsd/${ABI}/",
|
|
mirror_type: "http",
|
|
enabled: yes
|
|
priority: 10
|
|
}
|
|
|
|
You should now be able to install Salt from this new repository:
|
|
|
|
.. code-block:: shell
|
|
|
|
pkg install py27-salt
|
|
|
|
These packages are usually available earlier than upstream FreeBSD. Also
|
|
available are release candidates and development releases. Use these pre-release
|
|
packages with caution.
|
|
|
|
Post-installation tasks
|
|
=======================
|
|
|
|
**Master**
|
|
|
|
Copy the sample configuration file:
|
|
|
|
.. code-block:: shell
|
|
|
|
cp /usr/local/etc/salt/master.sample /usr/local/etc/salt/master
|
|
|
|
**rc.conf**
|
|
|
|
Activate the Salt Master in ``/etc/rc.conf``:
|
|
|
|
.. code-block:: shell
|
|
|
|
sysrc salt_master_enable="YES"
|
|
|
|
**Start the Master**
|
|
|
|
Start the Salt Master as follows:
|
|
|
|
.. code-block:: shell
|
|
|
|
service salt_master start
|
|
|
|
**Minion**
|
|
|
|
Copy the sample configuration file:
|
|
|
|
.. code-block:: shell
|
|
|
|
cp /usr/local/etc/salt/minion.sample /usr/local/etc/salt/minion
|
|
|
|
**rc.conf**
|
|
|
|
Activate the Salt Minion in ``/etc/rc.conf``:
|
|
|
|
.. code-block:: shell
|
|
|
|
sysrc salt_minion_enable="YES"
|
|
|
|
**Start the Minion**
|
|
|
|
Start the Salt Minion as follows:
|
|
|
|
.. code-block:: shell
|
|
|
|
service salt_minion start
|
|
|
|
Now go to the :doc:`Configuring Salt</ref/configuration/index>` page.
|