2012-09-06 04:12:17 +00:00
=======
Solaris
=======
2012-10-02 02:49:32 +00:00
Salt was added to the OpenCSW package repository in September of 2012 by Romeo Theriault <romeot@hawaii.edu> at version 0.10.2 of Salt. It has mainly been tested on Solaris 10 (sparc), though it is built for and has been tested minimally on Solaris 10 (x86), Solaris 9 (sparc/x86) and 11 (sparc/x86). (Please let me know if you're using it on these platforms!) Most of the testing has also just focused on the minion, though it has verified that the master starts up successfully on Solaris 10.
2012-09-06 04:12:17 +00:00
2012-10-02 02:49:32 +00:00
Comments and patches for better support on these platforms is very welcome. Currently at version 0.10.3 of salt, remote execution works good, grain detection is good and service control with SMF is supported. Work is underway to fill in the remaining gaps by adding support for the following:
2012-10-02 02:58:40 +00:00
1. 'pkg' states with pkgadd and pkgutil modules
2. support for solaris cron
3. support for user and group management
2012-10-02 02:49:32 +00:00
We hope to have all of the above included in v0.10.4 of Salt.
2012-09-06 04:12:17 +00:00
Salt is dependent on the following additional packages. These will automatically be installed as
dependencies of the `` py_salt `` package. ::
py_yaml
py_pyzmq
py_jinja2
py_msgpack_python
py_m2crypto
py_crypto
python
Installation
============
To install Salt from the OpenCSW package repository you first need to install `pkgutil`_ assuming you don't already have it installed:
On Solaris 10:
.. code-block :: bash
pkgadd -d http://get.opencsw.org/now
On Solaris 9:
.. code-block :: bash
wget http://mirror.opencsw.org/opencsw/pkgutil.pkg
pkgadd -d pkgutil.pkg all
Once pkgutil is installed you'll need to edit it's config file `` /etc/opt/csw/pkgutil.conf `` to point it at the unstable catalog:
.. code-block :: diff
- #mirror=http://mirror.opencsw.org/opencsw/testing
+ mirror=http://mirror.opencsw.org/opencsw/unstable
Ok, time to install salt.
.. code-block :: bash
# Update the catalog
root> /opt/csw/bin/pkgutil -U
# Install salt
root> /opt/csw/bin/pkgutil -i -y py_salt
Minion Configuration
2012-10-04 21:00:26 +00:00
====================
2012-09-06 04:12:17 +00:00
Now that salt is installed you can find it's configuration files in:
`` /etc/opt/csw/salt/ ``
You'll want to edit the minion config file to set the name of your salt master server:
.. code-block :: diff
- #master: salt
+ master: your-salt-server
You can now start the salt minion like so:
On Solaris 10:
.. code-block :: bash
svcadm enable salt-minion
On Solaris 9:
.. code-block :: bash
/etc/init.d/salt-minion start
You should now be able to log onto the salt master and check to see if the salt-minion key is awaiting acceptance:
.. code-block :: bash
salt-key -l un
Accept the key:
.. code-block :: bash
salt-key -a <your-salt-minion>
Run a simple test against the minion:
.. code-block :: bash
salt '<your-salt-minion>' test.ping
Troubleshooting
2012-10-04 21:00:26 +00:00
===============
2012-09-06 04:12:17 +00:00
Logs are in `` /var/log/salt ``
.. _pkgutil: http://www.opencsw.org/manual/for-administrators/getting-started.html
