salt/doc/topics/installation/osx.rst
2013-08-25 00:10:24 -07:00

71 lines
1.7 KiB
ReStructuredText

====
OS X
====
Dependency Installation
-----------------------
ZeroMQ and swig need to be installed first.
For installs using `python installed via homebrew`_, sudo should be unnecessary:
.. _`python installed via homebrew`: https://github.com/mxcl/homebrew/wiki/Homebrew-and-Python
Using homebrew with
`XCode Command Line Tool (XCode: Preferences: Downloads: Command Line Tools: Install)`_ pre-installed:
.. _`XCode Command Line Tool (XCode: Preferences: Downloads: Command Line Tools: Install)`: https://developer.apple.com/xcode/
.. code-block:: bash
brew install python
brew install swig
brew install zmq
pip install salt
This should pip install salt and its dependencies, such as:
Jinja2 M2Crypto msgpack-python pycrypto PyYAML pyzmq markupsafe
Whereas when using macports, zmq, swig, and pip may need to be installed this way:
.. code-block:: bash
sudo port install py-zmq
sudo port install py27-m2crypto
sudo port install py27-crypto
sudo port install py27-msgpack
sudo port install swig-python
sudo port install py-pip
For installs using the OS X system python, pip install needs to use 'sudo':
.. code-block:: bash
sudo pip install salt
Salt-Master Customizations
--------------------------
To run salt-master on OS X, the root user maxfiles limit must be increased:
.. code-block:: bash
sudo launchctl limit maxfiles 4096 8192
And sudo add this configuration option to the /etc/salt/master file:
.. code-block:: bash
max_open_files: 8192
Now the salt-master should run without errors:
.. code-block:: bash
sudo /usr/local/share/python/salt-master --log-level=all
Post-installation tasks
=======================
Now go to the :doc:`Configuring Salt</topics/configuration>` page.