03-1.PLATFORM-SPECIFIC-INSTALLATION-INSTRUCTIONS-特定系统平台的Salt安装说明.md

03-1.PLATFORM-SPECIFIC INSTALLATION INSTRUCTIONS - 特定系统平台的Salt安装说明

这些指南将详细介绍如何在给定的系统平台上成功安装Salt。

• Arch Linux
• Debian GNU/Linux/Raspbian
• Arista EOS Salt minion 安装指南
• Fedora
• FreeBSD
• Gentoo
• OpenBSD
• macOS
• RHEL/CentOS/Scientific Linux/Amazon Linux/Oracle Linux
• Solaris
• Ubuntu
• Windows
• SUSE

ARCH-LINUX

安装

Salt（稳定版）目前通过Arch Linux官方软件库提供。 目前在Arch用户存储库（AUR）中也有可用的git软件包。

稳定发行版

按如下方法从Arch Linux官方软件仓库安装Salt稳定版本：

pacman -S salt

跟踪开发版

要安装最新版本的Salt（可能包含错误！），请使用-git软件包。 安装-git软件包的方法如下：

wget https://aur.archlinux.org/packages/sa/salt-git/salt-git.tar.gz
tar xf salt-git.tar.gz
cd salt-git/
makepkg -is

注：yaourt 如果使用 Yaourt 这样的工具，依赖关系将被自动收集和构建。 使用yaourt工具安装Salt的命令是：

yaourt salt-git

安装后的任务

systemd

通过systemctl激活Salt Master和/或Minion，如下所示：

systemctl enable salt-master.service
systemctl enable salt-minion.service

启动Master

完成所有这些步骤之后，您就可以开始使用Salt Master了。 你应该可以使用下面的命令启动你的Salt Master：

systemctl start salt-master

Debian-GNU-Linux-Raspbian

Debian GNU/Linux发行版和Raspbian等一些衍生产品已经在它们的版本库中包含了Salt软件包。 然而，目前的稳定版本代号“Jessie”中包含的是过期的Salt旧版本。

下面提供了从SaltStack官方存储库和Debian官方存储库安装salt的两种方法，建议使用SaltStack官方为Debian准备的存储库。

从SaltStack官方的Debian和Raspbian存储库进行安装

Debian 9（Stretch）和Debian 8（Jessie）的软件包可在SaltStack官方的仓库中找到。安装说明参见https://repo.saltstack.com/#debian。

注意：对Debian 7的定期安全支持已于2016年4月25日结束。因此，2016.3.1和2015.8.10将是最后一个为其创建Debian 7软件包的Salt版本。

从Debian/Raspbian官方的存储库进行安装

Stretch（Testing）和Sid（Unstable）发行版已经包含了由Debian Salt团队建立的大部分最新的Salt软件包。 您可以直接从Debian安装Salt组件。

在Jessie（Stable）上，可以选择从Stretch安装Salt minion，并从jessiebackports存储库中安装python-tornado依赖项。

在Jessie上安装Salt minion的新版本

1. 添加jessie-backports和stretch存储库

Debian:

echo 'deb http://httpredir.debian.org/debian jessie-backports main' >> /etc/apt/sources.list
echo 'deb http://httpredir.debian.org/debian stretch main' >> /etc/apt/sources.list

Raspbian:

echo 'deb http://archive.raspbian.org/raspbian/ stretch main' >> /etc/apt/sources.list

2. 设置Jessie成为默认版本

echo 'APT::Default-Release "jessie";' > /etc/apt/apt.conf.d/10apt

3. 安装salt的依赖关系

Debian:

apt-get update
apt-get install python-zmq python-systemd/jessie-backports python-tornado/jessie-backports salt-common/stretch

Raspbian:

apt-get update
apt-get install python-zmq python-tornado/stretch salt-common/stretch

4. 从Stretch安装Salt minion

apt-get install salt-minion/stretch

安装软件包

使用apt-get命令从存储库安装Salt master，minion或其他软件包。 这些示例每个都安装一个Salt组件，但是也可以选择一次安装多个包。

• apt-get install salt-api
• apt-get install salt-cloud
• apt-get install salt-master
• apt-get install salt-minion
• apt-get install salt-ssh
• apt-get install salt-syndic

Arista-EOS-salt-minion安装指南

用于Arista EOS的Salt minion作为SWIX扩展分发，可以直接安装在交换机上。 EOS网络操作系统是基于旧的Fedora发行版本，并且需要安装salt-minion backports。 这个SWIX扩展包含必要的backports以及Salt基本代码。

注：Backports是从testing版本 （大部分）和 unstable版本 (可能性极小,例如：安全更新等)重新编译的软件包,因此他们在稳定的debian发行版中不需要新的库就可以运行（无论如何，这是可能的）。推荐你挑选一个能够满足你需求的单个的backports软件源，不要使用所有可用的backports源。

注：SWIX扩展已经在运行EOS 4.17.5M和vEOS 4.18.3F的Arista DCS-7280SE-68-R上进行了测试。

重要事项

这个软件包处于测试阶段，请确保在生产环境中运行之前仔细测试它。

如果确认工作正常，请将使用的平台型号和EOS版本在本页面添加备注。如果您要卸载此软件包，请参阅卸载部分。

从官方SaltStack存储库安装

下载swix安装包并将其保存到flash中。

veos#copy https://salt-eos.netops.life/salt-eos-latest.swix flash:
veos#copy https://salt-eos.netops.life/startup.sh flash:

安装扩展

将Salt包复制到扩展中。

veos#copy flash:salt-eos-latest.swix extension:

安装SWIX

veos#extension salt-eos-latest.swix force

检查安装结果

veos#show extensions | include salt-eos
     salt-eos-2017-07-19.swix      1.0.11/1.fc25        A, F                27

通过编辑变量来更改Salt master IP地址或FQDN(SALT_MASTER)

veos#bash vi /mnt/flash/startup.sh

确保启用了支持unix-socket的eAPI功能

veos(config)#management api http-commands
         protocol unix-socket
         no shutdown

安装后执行的任务

生成密钥和主机映射记录，并启动salt minion .

veos#bash
#sudo /mnt/flash/startup.sh

将安装的扩展复制到boot-extensions

veos#copy installed-extensions boot-extensions

配置event-handler让EOS在启动时启动salt-minion

veos(config)#event-handler boot-up-script
   trigger on-boot
   action bash sudo /mnt/flash/startup.sh

卸载

如果您决定卸载此软件包，建议采取以下步骤以确保安全：

1. 从引导扩展中删除扩展

veos#bash rm /mnt/flash/boot-extensions

2. 从扩展文件夹中删除扩展名

veos#bash rm /mnt/flash/.extensions/salt-eos-latest.swix

3. 删除启动脚本

veos(config)#no event-handler boot-up-script

附加信息

该SWIX扩展包含以下RPM包：

libsodium-1.0.11-1.fc25.i686.rpm
libstdc++-6.2.1-2.fc25.i686.rpm
openpgm-5.2.122-6.fc24.i686.rpm
python-Jinja2-2.8-0.i686.rpm
python-PyYAML-3.12-0.i686.rpm
python-babel-0.9.6-5.fc18.noarch.rpm
python-backports-1.0-3.fc18.i686.rpm
python-backports-ssl_match_hostname-3.4.0.2-1.fc18.noarch.rpm
python-backports_abc-0.5-0.i686.rpm
python-certifi-2016.9.26-0.i686.rpm
python-chardet-2.0.1-5.fc18.noarch.rpm
python-crypto-1.4.1-1.noarch.rpm
python-crypto-2.6.1-1.fc18.i686.rpm
python-futures-3.1.1-1.noarch.rpm
python-jtextfsm-0.3.1-0.noarch.rpm
python-kitchen-1.1.1-2.fc18.noarch.rpm
python-markupsafe-0.18-1.fc18.i686.rpm
python-msgpack-python-0.4.8-0.i686.rpm
python-napalm-base-0.24.3-1.noarch.rpm
python-napalm-eos-0.6.0-1.noarch.rpm
python-netaddr-0.7.18-0.noarch.rpm
python-pyeapi-0.7.0-0.noarch.rpm
python-salt-2017.7.0_1414_g2fb986f-1.noarch.rpm
python-singledispatch-3.4.0.3-0.i686.rpm
python-six-1.10.0-0.i686.rpm
python-tornado-4.4.2-0.i686.rpm
python-urllib3-1.5-7.fc18.noarch.rpm
python2-zmq-15.3.0-2.fc25.i686.rpm
zeromq-4.1.4-5.fc25.i686.rpm

FEDORA

从版本0.9.4开始，Salt已经在主Fedora版本库和EPEL中可用。 它可以使用yum或dnf来安装，具体取决于你的Fedora版本。

注意：从2015.5.2到2016.3.2开始的Salt发布版本没有基于EPEL安装源的Fedora包。 如果要安装此发行版的Salt版本，请使用SaltStack的Bootstrap脚本，并指定版本的关联版本标签，使用git方法安装Salt。

自版本2016.3.3及以后版本将通过EPEL提供打包版本。

警告：Fedora 19自带的是systemd 204. Systemd已知的在以后的修订版本中修复了一些错误，以防止salt-master不能可靠地启动或打开它所需要的网络连接。 在任何使用systemd 204或更低版本的发行版中，salt master都不可能启动或可靠运行。 不过运行salt-minions应该是可以的。

安装

可以使用yum安装Salt，并且可以在标准的Fedora存储库中使用。

稳定发行版

Salt是分开打包的master和minion。 只需要给机器安装其适合扮演角色的软件包。 通常情况下，将会有一个master和多个minion。

yum install salt-master
yum install salt-minion

从updates-testing进行安装

当一个新的Salt版本被打包时，它首先被提交到updates-testing版本库中，然后才会被移到稳定的repo。 使用yum的enablerepo参数来安装来自updates-testing库中的软件包：

yum --enablerepo=updates-testing install salt-master
yum --enablerepo=updates-testing install salt-minion

使用pip安装salt

由于Salt在PyPI上，可以使用pip进行安装，尽管大多数用户更喜欢使用软件包管理器进行安装。

从pip安装有一些额外的要求：

• 需要安装“Development Tools” `dnf groupinstall 'Development Tools'``
• 如果连接失败，则安装'zeromq-devel'软件包。

pip安装不会生成init脚本或/etc/salt目录，您将需要提供自己的systemd服务unit。

pip install salt

警告：如果从pip安装（或者使用setup.py install从源代码安装），请注意Salt需要yum-utils软件包来管理软件包。 另外，如果Python依赖项尚未安装，那么您将需要安装额外的库/工具来构建其中的一些库。

安装后执行的任务

MASTER

设置为随机自启动：

systemctl enable salt-master.service

启动salt master服务

systemctl start salt-master.service

MINION

设置为随机自启动：

systemctl enable salt-minion.service

启动salt minion服务

systemctl start salt-minion.service

FREEBSD

安装

Salt可以从FreeBSD pkgng仓库或直接从SaltStack以二进制包的形式获得。 以下为两种安装方法的概述：

FreeBSD repo

FreeBSD pkgng存储库已在系统10.x及更高版本上预配置。不需要做额外配置即可使用。

pkg install py27-salt

这些软件包通常在上游发布后的几天内就可用了。

##SaltStack repo SaltStack也提供了salt包的二进制版本，可从 https://repo.saltstack.com/freebsd/ 获取。 要使用此存储库，请将以下文件添加到您的系统中：

/usr/local/etc/pkg/repos/saltsta.conf:

saltstack: {
  url: "https://repo.saltstack.com/freebsd/${ABI}/",
  enabled: yes
}

然后执行：

pkg install py27-salt

这些软件包通常比上游的FreeBSD发布时间早。 还提供了发布候选版本和开发版本。 请谨慎使用寻些预发布软件包。

在安装后执行的任务

Master

需要拷贝一份配置文件样例：

cp /usr/local/etc/salt/master.sample /usr/local/etc/salt/master

Rc.conf

配置/etc/rc.conf，设置为自启动：

sysrc salt_master_enable="YES"

启动salt master：

service salt_master start

Minion

拷贝一份配置文件样例：

cp /usr/local/etc/salt/minion.sample /usr/local/etc/salt/minion

Rc.conf

配置/etc/rc.conf，设置为自启动：

sysrc salt_minion_enable="YES"

启动salt minion：

service salt_minion start

Gentoo

Gentoo是一个基于Linux的自由操作系统，它能为几乎任何应用程序或需求自动地作出优化和定制。追求极限的配置、性能，以及顶尖的用户和开发者社区，都是Gentoo体验的标志特点。

Gentoo的哲学是自由和选择。得益于一种称为Portage的技术，Gentoo能成为理想的安全服务器、开发工作站、专业桌面、游戏系统、嵌入式解决方案或者别的东西——你想让它成为什么，它就可以成为什么。

安装

Salt可以通过Portage轻松安装在Gentoo上：

emerge app-admin/salt

OpenBSD

OpenBSD是一个多平台的，基于4.4BSD的类UNIX操作系统，是BSD衍生出的三种免费操作系统（另外两种是NetBSD和FreeBSD）之一，被称为世界上最安全的操作系统。

Salt于2013年8月10日添加到OpenBSD ports树中。它已经通过了OpenBSD 5.5及以上版本的测试。

Salt依赖于以下额外的ports。 这些将作为sysutils/salt port的依赖项安装：

devel/py-futures
devel/py-progressbar
net/py-msgpack
net/py-zmq
security/py-crypto
security/py-M2Crypto
textproc/py-MarkupSafe
textproc/py-yaml
www/py-jinja2
www/py-requests
www/py-tornado

安装

要从OpenBSD pkg repo安装Salt，请使用以下命令：

pkg_add salt

在安装后执行的任务

Master

配置为自启动：

rcctl enable salt_master

启动salt master：

rcctl start salt_master

Minion

配置为自启动：

rcctl enable salt_minion

启动salt minion：

rcctl start salt_minion

macOS

从官方SaltStack存储库安装

所选分支的最新稳定版本：

• x86_64: salt-2019.2.0-py2-x86_64.pkg
• x86_64: salt-2019.2.0-py3-x86_64.pkg

md5 的输出应该与相应的md5文件的内容匹配。

• Earlier builds from supported branches
• Archived builds from unsupported branches

使用Homebrew安装Salt

brew install saltstack

应该指出的是，Homebrew明确不鼓励使用sudo：

Homebrew被设计为不使用sudo而工作。 您可以决定使用它，但我们强烈建议不要这样做。 如果你使用sudo并遇到bug，那很可能是这个原因。 请勿提交错误报告，除非您可以在不使用sudo的情况下从头重新安装Homebrew后重新生成这个错误。

使用MacPorts安装

Macports将其依赖项与操作系统隔离开来，默认情况下在/opt/local中安装salt，配置文件位于/opt/local/etc/salt下。 为获得最佳效果，请将/opt/local/bin添加到PATH。

sudo port install salt

在这里还允许选择用于运行salt的python版本，默认为python27，但也支持python34，python35和python36。 要使用Python 3.6安装salt，请使用python36的安装方法，例如：

sudo port install salt @python36

启动项（分别用于master，minion和rest-cherrypy API网关）由子端口目标安装。 例如，这些将启动Launchdaemons注册为org.macports.salt-minion，以通过launchd触发salt-minion的自动启动。 可以使用macprots load和unload命令启动和停止Salt的LaunchDaemons而无需重新启动。

sudo port install salt-master salt-minion salt-api
sudo port load salt-master salt-minion salt-api

使用Pip安装

sudo pip install salt

Salt-Master定制

注：SaltStack并未测试或支持macOS上的Salt master。

要在macOS上运行salt-master，使用sudo将此配置选项添加到/etc/salt/master文件中：

max_open_files: 8192

在macOS 10.10（Yosemite）之前的版本中，还需要增加root用户maxfiles限制：

sudo launchctl limit maxfiles 4096 8192

注：在macOS 10.10（Yosemite）及更高版本中，不应调整maxfiles。除了最极端的情况外，默认限制都足够使用了。 用以上设置覆盖这些值会导致系统不稳定！

现在，应该可以正常地运行salt-master了：

sudo salt-master --log-level=all

RHEL-CentOS-ScientificLinux-AmazonLinux-OracleLinux

Salt应该可以与Red Hat Enterprise Linux的所有主流衍生产品正常工作，包括CentOS，Scientific Linux，Oracle Linux和Amazon Linux。

使用SaltStack官方存储库安装

SaltStack存储库中提供了Redhat，CentOS和Amazon Linux适用的软件包。请打开以下链接页面，按提示进行安装操作。

• Red Hat/CentOS
• Amazon Linux

注：以上链接页面中同时提供了安装最新稳定版本、指定Major版本以及指定Minor版本的方法。截至2015.8.0及以后，在RHEL系统上安装salt,已经不再需要EPEL存储库。 SaltStack存储库提供了所有需要的依赖关系.

警告：如果在禁用（未订购）`RHEL Server Releases'或'RHEL Server Optional Channel'存储库的Red Hat Enterprise Linux 7上进行安装，则请将CentOS 7 GPG密钥URL附加到SaltStack yum存储库配置以安装所需的基本软件包：

[saltstack-repo]
name=SaltStack repo for Red Hat Enterprise Linux $releasever
baseurl=https://repo.saltstack.com/yum/redhat/$releasever/$basearch/latest
enabled=1
gpgcheck=1
gpgkey=https://repo.saltstack.com/yum/redhat/$releasever/$basearch/latest/SALTSTACK-GPG-KEY.pub
       https://repo.saltstack.com/yum/redhat/$releasever/$basearch/latest/base/RPM-GPG-KEY-CentOS-7

注：Salt需要systemd和systemd-python，但Red Hat7@base安装不会安装systemd和systemd-python。 这些依赖关系可能需要在Salt之前安装好。

从社区维护的存储库安装

从版本0.9.4开始，Salt在EPEL中提供相关安装包。

注：这些存储库中的软件包是由社区构建的，在可以使用到最新的稳定SaltStack版本之前可能需要等待一些时间。

RHEL/CentOS6和7，Scientific Linux等

警告：

由于依赖性不足，Salt 2015.8目前在EPEL中不可用：python-crypto 2.6.1或更高版本，以及python-tornado版本4.2.1或更高版本。 这些软件包目前在红帽企业Linux 6和7的EPEL中不可用。

Enabling EPEL

如果您的系统中未安装EPEL存储库，则可以下载RHEL/CentOS 6或RHEL/CentOS 7的RPM，并使用以下命令进行安装：

rpm -Uvh epel-release-X-Y.rpm

请将上面替换为正确的文件名。

安装稳定发行版

Salt的mater和minion分别有安装包,在安装前应该设计好机器要扮演的角色，通常是一主多从。

• yum install salt-master
• yum install salt-minion
• yum install salt-ssh
• yum install salt-syndic
• yum install salt-cloud

从epel-testing安装

当一个新的Salt版本被打包时，它首先进入epel-testing存储库，然后才被移到稳定的EPEL存储库。

yum --enablerepo=epel-testing install salt-minion

使用pip安装

由于Salt在PyPI上有维护，因此可以使用pip来安装它，尽管大多数用户更喜欢使用RPM软件包（可以从EPEL安装）进行安装。

从pip安装还有一些额外的要求：

• 安装“Development Tools”组，`yum groupinstall 'Development Tools'``
• 安装'zeromq-devel'软件包

pip安装不会生成init脚本或/etc/salt目录，您需要提供自己的systemd服务单元配置文件。

警告：如果从pip安装（或使用setup.py install从源代码安装），请注意Salt需要yum-utils软件包来管理软件包。 另外，如果Python依赖项尚未安装，则需要安装额外的库/工具才能构建其中的一些库。

ZeroMQ 4

我们建议在可用的情况下使用ZeroMQ 4。 SaltStack在SaltStack存储库中提供了ZeroMQ 4.0.5和pyzmq 14.5.0，以及一个单独的zeromq4 COPR存储库。

如果在安装Salt之前添加了这个存储库，那么安装salt-master或salt-minion会自动提取ZeroMQ 4.0.5，并且不需要升级ZeroMQ和pyzmq的额外步骤。

警告：RHEL/CentOS 5用户在RHEL/CentOS 5上使用COPR仓库时需要安装python-hashlib软件包。 没有它将会导致校验和错误，因为YUM将无法处理COPR使用的SHA256校验和。

注：对于RHEL/CentOS 5安装，如果使用SaltStack repo或Fedora COPR安装Salt（如上所述），则不必启用zeromq4 COPR，因为这些存储库已包含ZeroMQ 4。

包管理

Salt与yum的接口大量使用yum-utils包中的repoquery实用程序。 如果通过EPEL安装salt，则此软件包将作为依赖项安装。 但是，如果已使用pip安装salt，或者正在使用salt-ssh管理主机，则自2014.7.0版起，将自动安装yum-utils以满足此需求依赖。

安装后需要执行的任务

Master

配置为服务自启动:

RHEL/CentOS 5 and 6

chkconfig salt-master on

RHEL/CentOS 7

systemctl enable salt-master.service

启动Master服务:

RHEL/CentOS 5 and 6

service salt-master start

RHEL/CentOS 7

systemctl start salt-master.service

Minion

配置为服务自启动:

RHEL/CentOS 5 and 6

chkconfig salt-minion on

RHEL/CentOS 7

systemctl enable salt-minion.service

启动Minion服务:

RHEL/CentOS 5 and 6

service salt-minion start

RHEL/CentOS 7

systemctl start salt-minion.service

SOLARIS

已知Salt可以支持在Solaris上工作，但社区版本的软件包未得到持续维护。

通过使用setuptools可以在Solaris上安装Salt。 例如，要安装salt的开发版本：

git clone /~https://github.com/saltstack/salt
cd salt
sudo python setup.py install --force

注：SaltStack公司实际上为Solaris系统提供了包括软件安装包在内的商业化支持.

UBUNTU

使用SaltStack官方源安装

用于Ubuntu 16（Xenial），Ubuntu 14（Trusty）和Ubuntu 12（Precise）的软件包可在SaltStack存储库中找到。

安装说明位于https://repo.saltstack.com/#ubuntu

安装软件包

使用apt-get命令从存储库安装Salt master，minion或其他软件包。

这些示例每个安装一个Salt组件：

• apt-get install salt-api
• apt-get install salt-cloud
• apt-get install salt-master
• apt-get install salt-minion
• apt-get install salt-ssh
• apt-get install salt-syndic

WINDOWS

Salt完全支持在Windows上运行Salt minion。 您必须将Windows Salt minion连接到支持的操作系统上的Salt Master以控制您的Salt Minions。许多标准的Salt模块已经移植到Windows上，许多Salt States目前也在Windows上工作。

使用SaltStack官方源安装

64位安装程序已在Windows 7 64位和Windows Server 2008 R2 64位上进行了测试。 32位安装程序已在Windows 2008 Server 32bit上进行了测试。 如果发现其他平台的问题，请为我们的GitHub repo提交错误报告。

• Python2 x86: Salt-Minion-2018.3.2-x86-Setup.exe
• Python2 AMD64: Salt-Minion-2018.3.2-AMD64-Setup.exe
• Python3 x86: Salt-Minion-2018.3.2-x86-Setup.exe
• Python3 AMD64: Salt-Minion-2018.3.2-AMD64-Setup.exe

其它版本的安装包参见：https://repo.saltstack.com/windows/

目前提供了可用于Python 2和Python 3的安装程序。安装程序将检测之前安装的Salt版本并询问您是否要删除它们。 单击确定将删除Salt二进制文件和相关文件，但保留任何现有配置，缓存和PKI信息。

安装Salt Minion

如果系统缺少相应版本的Visual C ++ Redistributable（vcredist），系统将提示用户安装它。 单击“确定”以安装vcredist。 单击“取消”以中止安装，而不对系统进行修改。

如果系统上已安装Salt，则系统将提示用户删除以前的安装。 单击“确定”以卸载Salt，而不删除配置，PKI信息或缓存文件。 在对系统进行任何修改之前，单击“取消”以中止安装。

在“欢迎”和“许可协议”之后，安装程序要求提供两个信息来配置salt minion，即master主机名和minion主机名。 安装程序将使用这些信息更新minion配置。 如果安装程序找到现有的minion配置文件，则这些字段将填充现有配置中的值，但它们将显示为灰色。 还会有一个复选框来使用现有配置。 如果继续，将使用现有配置。 如果未选中该复选框，则会显示默认值并可以更改。 如果继续，c:\salt\conf中的现有配置文件将与c\salt\conf\minion.d目录一起删除。 输入的值将与默认配置一起使用。

最后一页允许您启动minion服务并可选择更改其启动类型。 默认情况下，minion被设置为自动启动。 您可以通过选中“延迟启动”复选框将启动类型更改为自动（延迟启动）的类型。

注意：因为在Windows完成系统启动的引导过程之前，salt就会尝试管理highstate配置，所以需要salt highstate模块可能会在系统重新引导后失败。 这可以通过将salt minion启动类型更改为“自动（延迟启动）”来解决。 缺点是可能会增加“salt-minion”服务真正开始所需的时间。

salt-minion服务将出现在Windows服务管理器中，并可以在那里进行管理，或者像其他Windows服务一样在命令行中进行管理。

sc start salt-minion
net start salt-minion

安装前提条件

大多数Salt功能应该可以正常工作。 一些Salt模块依赖于PowerShell。 Salt所需的最低版本的PowerShell版本为3.如果您打算使用DSC，那么Powershell version 5是最低版本。

静默安装选项

可以通过在命令行中提供 /S选项来安静地运行安装程序。 安装程序还会默认接受以下选项来配置Salt Minion：

Option	描述
/master=	master的主机名或IP
/minion-name=	minion的名称
/start-minion=	0或1.设置服务自启动，默认为自启动
/start-minion-delayed	将minion启动类型设置为Automatic（延迟启动）。
/default-config	如果存在，则使用salt的默认配置覆盖现有配置。 默认是使用现有配置（如果存在）。 如果传递/master和（或）/minion-name，那么这些值将会用于更新新的默认配置。
/custom-config=	一个字符串值，指定自定义配置文件的名称，路径需要与安装程序相同的路径下。 如果传递/master和（或）/minion-name，那么这些值将用于更新新的自定义配置。
/S	以静默方式运行安装。 使用上述设置或默认值。
/?	显示命令行帮助信息

注意：/ start-service已被弃用，但将在一段时间内继续按预期运行。

/default-config和/custom-config 将备份现有配置（如果找得到）。 将添加时间戳和.bak扩展名。 这包括minion文件和minion.d目录。

以下是使用静默安装程序的一些示例：

# Install the Salt Minion
# Configure the minion and start the service

Salt-Minion-2017.7.1-Py2-AMD64-Setup.exe /S /master=yoursaltmaster /minion-name=yourminionname

# Install the Salt Minion
# Configure the minion but don't start the minion service

Salt-Minion-2017.7.1-Py3-AMD64-Setup.exe /S /master=yoursaltmaster /minion-name=yourminionname /start-minion=0

# Install the Salt Minion
# Configure the minion using a custom config and configuring multimaster

Salt-Minion-2017.7.1-Py3-AMD64-Setup.exe /S /custom-config=windows_minion /master=prod_master1,prod_master2

使用非特权用户在Windows上运行Salt Minion

注意：

• 这些命令已在Windows Server 2008 R2中进行了测试
• 它们可以推广到任何支持salt-minion的Windows版本

（1）请先在windows上为salt创建好一个非特权用户。

1. Click Start > Control Panel > User Accounts.
2. Click Add or remove user accounts.
3. Click Create new account.
4. Enter salt-user (or a name of your preference) in the New account name field.
5. Select the Standard user radio button.
6. Click the Create Account button.
7. Click on the newly created user account.
8. Click the Create a password link.
9. In the New password and Confirm new password fields, provide a password (e.g "SuperSecretMinionPassword4Me!").
10. In the Type a password hint field, provide appropriate text (e.g. "My Salt Password").
11. Click the Create password button.
12. Close the Change an Account window.

（2）编辑salt安装目录并增加对非特权用户的授权。

1. In a File Explorer window, browse to the path where Salt is installed (the default path is C:\Salt).
2. Right-click on the Salt folder and select Properties.
3. Click on the Security tab.
4. Click the Edit button.
5. Click the Add button.
6. Type the name of your designated Salt user and click the OK button.
7. Check the box to Allow the Modify permission.
8. Click the OK button.
9. Click the OK button to close the Salt Properties window.

（3）更新管理salt-minion服务的Windows用户

1. Click Start > Administrative Tools > Services.
2. In the Services list, right-click on salt-minion and select Properties.
3. Click the Log On tab.
4. Click the This account radio buon.
5. Provide the account credentials created in section A.
6. Click the OK buon.
7. Click the OK buon to the prompt confirming that the user has been granted the Log On As A Service right.
8. Click the OK buon to the prompt confirming that The new logon name will not take effect until you stop and restart the service.
9. Right-Click on salt-minion and select Stop.
10. Right-Click on salt-minion and select Start.

注意：关于在windows上安装、配置一套制作Salt安装包的编译环境的说明，详见官方文档，这里不做进一步说明。

在WINDOWS上进行SALT编译和开发的方法

有时我们会对SALT做一些必要的定制化开发，这时就需要制作适用的windows软件安装包，你可以通过下面链接了解软件编译和安装方法。

https://docs.saltstack.com/en/latest/topics/installation/windows.html#building-and-developing-on-windows

WINDOWS 2003下的包管理

Windows Server 2003和Windows XP都已达到End of Support。 虽然在EoL操作系统上没有正式支持Salt，但某些功能可能会继续有效。

在Windows Server 2003上，您需要安装可选组件“WMI Windows Installer Provider”以获取已安装软件包的完整列表。 如果您没有这个，salt-minion无法报告某些已安装的软件。

SUSE

使用SaltStack官方源安装

SaltStack Repository目前提供了适用于SUSE 12 SP1, SUSE 12, SUSE 11, openSUSE 13 and openSUSE Leap 42.1 的安装包. 详细说明参见：https://repo.saltstack.com/#suse

使用SUSE官方源安装

由于openSUSE 13.2，Salt 2014.1.11在primary存储库中可用。 随着SUSE Manager 3的发布，已创建了一个新的存储库设置。 新的repo将使用systemsmanagement:saltstack，这是新的稳定版软件包的安装来源。为了向后兼容，将为旧的devel:language:python repo创建一个链接包。 所有suse软件包的开发都将在systemsmanagement:saltstack:testing中完成。 这将确保salt在primary suse repo中提供一个稳定的发布repo和一个包含部分增强特性的测试repo。

安装

Salt可以使用zypper进行安装，并可在标准的openSUSE/SLES存储库中使用。

稳定发行版

Salt master和minion分别有独立的安装包。 需要为机器将扮演的角色安装适当的软件包。 通常情况下，会有一个Master和多个Minion。

zypper install salt-master
zypper install salt-minion

openSUSE安装后需要执行的任务

Master

配置为自启动：

systemctl enable salt-master.service

启动salt master：

systemctl start salt-master.service

Minion

配置为自启动：

systemctl enable salt-minion.service

启动salt minion：

systemctl start salt-minion.service

SLES在安装后需要执行的任务

Master

配置为自启动：

chkconfig salt-master on

启动salt master：

rcsalt-master start

Minion

配置为自启动：

chkconfig salt-minion on

启动salt minion：

rcsalt-minion start

UNSTABLE RELEASE

OPENSUSE

openSUSE Tumbleweed

zypper addrepo http://download.opensuse.org/repositories/systemsmanagement:/saltstack/openSUSE_Tumbleweed/systemsmanagement:saltstack.repo
zypper refresh
zypper install salt salt-minion salt-master

openSUSE 42.1 Leap

zypper addrepo http://download.opensuse.org/repositories/systemsmanagement:/saltstack/openSUSE_Leap_42.1/systemsmanagement:saltstack.repo
zypper refresh
zypper install salt salt-minion salt-master

openSUSE 13.2

zypper addrepo http://download.opensuse.org/repositories/systemsmanagement:/saltstack/openSUSE_13.2/systemsmanagement:saltstack.repo
zypper refresh
zypper install salt salt-minion salt-master

SUSE LINUX ENTERPRISE

SLE 12

zypper addrepo http://download.opensuse.org/repositories/systemsmanagement:/saltstack/SLE_12/systemsmanagement:saltstack.repo
zypper refresh
zypper install salt salt-minion salt-master

SLE 11 SP4

zypper addrepo http://download.opensuse.org/repositories/systemsmanagement:/saltstack/SLE_11_SP4/systemsmanagement:saltstack.repo
zypper refresh
zypper install salt salt-minion salt-master