mirror of
https://github.com/valitydev/salt.git
synced 2024-11-07 00:55:19 +00:00
104 lines
2.0 KiB
ReStructuredText
104 lines
2.0 KiB
ReStructuredText
=======
|
|
FreeBSD
|
|
=======
|
|
|
|
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
|
|
https://repo.saltstack.com/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: "https://repo.saltstack.com/freebsd/${ABI}/",
|
|
enabled: yes
|
|
}
|
|
|
|
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 :ref:`Configuring Salt<configuring-salt>` page.
|