.. title: SaltStack Quickstart Guide on Mac OS X
.. slug: saltstack-quickstart-guide-on-mac-os-x
.. date: 2014-08-03 21:32:20
.. tags: mac os x,python
.. category:
.. link:
.. description:
.. type: text
As always, refer to the official `SaltStack documentation `_ **first**.
To
get up and running with SaltStack on Mac OS X can be a daunting task.
I have found it much easier to use `MacPorts `_ to accomplish any such
tasks.
.. TEASER_END: Read more
Step 1: Install MacPorts on your Mac OS X. I find this to be an
essential step for any developer using Mac OS X. Of course, there's
`Homebrew `_ as an alternative. I haven't used it but you may check it
out as well.
Once you have setup MacPorts successfully you are ready
to begin. Of course, since MacPorts provides a variety of GCC versions
I prefer it over the default gcc provided on my Mac. Install a newer
GCC and link your system to it.
::
[user@host ~] $ sudo port installgcc48
[user@host ~] $ sudo mv /usr/bin/gcc /usr/bin/gcc.orig
[user@host ~] $ sudo ln -s /opt/local/bin/gcc-mp-4.8 /usr/bin/gcc
Install Python 2.7.
::
[user@host ~] $ sudo port install python27
Install Virtualenv.
::
[user@host ~] $ sudo port install py27-virtualenv
M2Crypto is a requirement for SaltStack and you need
to install SWIG. Otherwise you may get errors[1].
::
[user@host ~] $ sudo port install swig
[user@host ~] $ sudo port install swig-python
Create your virtualenv.
::
[user@host ~] $ /opt/local/bin/virtualenv-2.7 ~/dev/virt-env/salt-virt
Activate the virtualenv.
::
[user@host ~] $ source ~/dev/virt-env/salt-virt/bin/activate
Install SaltStack pre-requisites.
::
(salt-virt)[user@host ~] $ pip install pyzmq PyYAML pycrypto msgpack-python jinja2 psutil
Install SaltStack.
::
(salt-virt)[user@host ~] $ pip install salt
Make sure things are working well.
::
(salt-virt)[user@host~] $ python
Python 2.7.8 (default, Jul 13 2014, 17:11:32)
[GCC 4.2.1 Compatible Apple LLVM 5.1 (clang-503.0.40)] on darwin
Type "help", "copyright", "credits" or "license" for more information.
>>> import salt
>>> ^D
To deactivate the virtualenv,
::
(salt-virt)[user@host~] $ deactivate
Note: this post was created using Mac OS X 10.9 (Mavericks) with SaltStack 2014.1.7.
[1] Possible SWIG error
::
unable to execute 'swig': No such file or directory
error: command 'swig' failed with exit status 1
Note: I published this post originally at `SaltStack Quickstart Guide on Mac OS X `_. Migrated to Nikola in February 2015.