valitydev/salt
14
0
Fork 0
mirror of https://github.com/valitydev/salt.git synced 2024-11-07 08:58:59 +00:00
Code Issues Actions Packages Projects Releases Wiki Activity

Minor rST indentatation fixes to the Windows install docs

Browse Source
This commit is contained in:
Seth House 2014-05-22 11:53:15 -06:00
parent eb4bb2943b
commit a4abb798db
1 changed files with 63 additions and 53 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

116
doc/topics/installation/windows.rst
View File

@ -131,101 +131,106 @@ installer:
Setting up a Windows build environment
======================================
1. Install the Microsoft Visual C++ 2008 SP1 Redistributable, `vcredist_x86`_ or `vcredist_x64`_.
1. Install the Microsoft Visual C++ 2008 SP1 Redistributable, `vcredist_x86`_
or `vcredist_x64`_.
2. Install `msysgit`_
3. Clone the Salt git repository from GitHub
3. Clone the Salt git repository from GitHub
.. code-block:: bash
.. code-block:: bash
git clone git://github.com/saltstack/salt.git
git clone git://github.com/saltstack/salt.git
4. Install the latest point release of `Python 2.7`_ for the architecture you wish to target
4. Install the latest point release of `Python 2.7`_ for the architecture you
wish to target
5. Add C:\\Python27 and C:\\Python27\\Scripts to your system path
6. Download and run the Setuptools bootstrap - `ez_setup.py`_
.. code-block:: bash
.. code-block:: bash
python ez_setup.py
python ez_setup.py
7. Install Pip
.. code-block:: bash
easy_install pip
.. code-block:: bash
easy_install pip
8. Install the latest point release of `OpenSSL for Windows`_
#. During setup, choose first option to install in Windows system directory
#. During setup, choose first option to install in Windows system
directory
9. Install the latest point release of `M2Crypto`_
#. In general, be sure to download installers targeted at py2.7 for your chosen architecture
#. In general, be sure to download installers targeted at py2.7 for your
chosen architecture
10. Install the latest point release of `pycrypto`_
10. Install the latest point release of `pycrypto`_
11. Install the latest point release of `pywin32`_
11. Install the latest point release of `pywin32`_
12. Install the latest point release of `Cython`_
12. Install the latest point release of `Cython`_
13. Install the latest point release of `jinja2`_
13. Install the latest point release of `jinja2`_
14. Install the latest point release of `msgpack`_
14. Install the latest point release of `msgpack`_
15. Install psutil
15. Install psutil
.. code-block:: bash
.. code-block:: bash
easy_install psutil
16. Install pyzmq
16. Install pyzmq
.. code-block:: bash
.. code-block:: bash
easy_install pyzmq
17. Install PyYAML
17. Install PyYAML
.. code-block:: bash
.. code-block:: bash
easy_install pyyaml
18. Install bbfreeze
18. Install bbfreeze
.. code-block:: bash
.. code-block:: bash
easy_install bbfreeze
19. Install wmi
19. Install wmi
.. code-block:: bash
.. code-block:: bash
pip install wmi
20. Install esky
20. Install esky
.. code-block:: bash
.. code-block:: bash
pip install esky
21. Install Salt
21. Install Salt
.. code-block:: bash
.. code-block:: bash
cd salt
python setup.py install
22. Build a frozen binary distribution of Salt
22. Build a frozen binary distribution of Salt
.. code-block:: bash
.. code-block:: bash
python setup.py bdist_esky
python setup.py bdist_esky
A zip file has been created in the ``dist/`` folder, containing a frozen copy of Python and the
dependency libraries, along with Windows executables for each of the Salt scripts.
A zip file has been created in the ``dist/`` folder, containing a frozen copy
of Python and the dependency libraries, along with Windows executables for each
of the Salt scripts.
Building the installer
@ -233,9 +238,9 @@ Building the installer
The Salt Windows installer is built with the open-source NSIS compiler. The
source for the installer is found in the pkg directory of the Salt repo here:
https://github.com/saltstack/salt/tree/develop/pkg/windows/installer/Salt-Minion-Setup.nsi.
To create the installer, extract the frozen archive from ``dist/`` into ``pkg/windows/buildenv/``
and run NSIS.
:blob:`pkg/windows/installer/Salt-Minion-Setup.nsi`. To create the installer,
extract the frozen archive from ``dist/`` into ``pkg/windows/buildenv/`` and
run NSIS.
The NSIS installer can be found here: http://nsis.sourceforge.net/Main_Page
@ -245,61 +250,64 @@ Testing the Salt minion
1. Create the directory C:\\salt (if it doesn't exist already)
2. Copy the example ``conf`` and ``var`` directories from ``pkg/windows/buildenv/`` into C:\\salt
2. Copy the example ``conf`` and ``var`` directories from
``pkg/windows/buildenv/`` into C:\\salt
3. Edit C:\\salt\\conf\\minion
.. code-block:: bash
.. code-block:: bash
master: ipaddress or hostname of your salt-master
4. Start the salt-minion
.. code-block:: bash
.. code-block:: bash
cd C:\Python27\Scripts
python salt-minion
5. On the salt-master accept the new minion's key
.. code-block:: bash
.. code-block:: bash
sudo salt-key -A
(This accepts all unaccepted keys. If you're concerned about security just accept the key for this specific minion)
This accepts all unaccepted keys. If you're concerned about security just
accept the key for this specific minion.
6. Test that your minion is responding
a. On the salt-master run:
On the salt-master run:
.. code-block:: bash
.. code-block:: bash
sudo salt '*' test.ping
You should get the following response: {'your minion hostname': True}
You should get the following response: ``{'your minion hostname': True}``
Single command bootstrap script
===============================
On a 64 bit Windows host the following script makes an unattended install of salt, including all dependencies:
On a 64 bit Windows host the following script makes an unattended install of
salt, including all dependencies:
.. admonition:: Not up to date.
This script is not up to date. Please use the installer found above
This script is not up to date. Please use the installer found above
.. code-block:: bash
"PowerShell (New-Object System.Net.WebClient).DownloadFile('http://csa-net.dk/salt/bootstrap64.bat','C:\bootstrap.bat');(New-Object -com Shell.Application).ShellExecute('C:\bootstrap.bat');"
# (All in one line.)
(All in one line.)
"PowerShell (New-Object System.Net.WebClient).DownloadFile('http://csa-net.dk/salt/bootstrap64.bat','C:\bootstrap.bat');(New-Object -com Shell.Application).ShellExecute('C:\bootstrap.bat');"
You can execute the above command remotely from a Linux host using winexe:
.. code-block:: bash
winexe -U "administrator" //fqdn "PowerShell (New-Object ......);"
winexe -U "administrator" //fqdn "PowerShell (New-Object ......);"
For more info check `http://csa-net.dk/salt`_
@ -307,7 +315,9 @@ For more info check `http://csa-net.dk/salt`_
Packages management under Windows 2003
======================================
On windows Server 2003, you need to install optional component "wmi windows installer provider" to have full list of installed packages. If you don't have this, salt-minion can't report some installed softwares.
On windows Server 2003, you need to install optional component "wmi windows
installer provider" to have full list of installed packages. If you don't have
this, salt-minion can't report some installed softwares.
.. _http://csa-net.dk/salt: http://csa-net.dk/salt