Installing the agentless Windows module

Products

• VMware Aria Suite

Issue/Introduction

This article explains how to install the agentless Windows module for use with SaltStack Enterprise.

 

Downloads

To download the Agentless Windows module:

1. Go to the SaltStack Enterprise Installation Guide - Downloads page.
2. Download all files listed in the Agentless Windows section.

Requirements

• English version of Windows
•  Windows versions:
  • Windows 7
  • Windows 8.1
  • Windows 10
  • Windows Server 2008 R2
  • Windows Server 2012 R2
  • Windows Server 2016
• Powershell 3.0 or later
• WinRM must be configured and running
• The /etc/salt/roster file must have a configuration section for every Windows machine you want to connect to. The configuration must have a local admin user and password for each machine, as in the following example.

win2012dev: # Minion ID   host: <IP address>   user: <local Windows admin username>   passwd: <password for the admin user>   winrm: True

NOTE: Domain credentials are not supported.

• Python 2 must be installed on the Salt Master. The `salt-ssh` module for
  Windows is supported only on Python 2, not later versions.
• pip 2 must be installed.

To install pip 2 on CentOS:

$ yum install epel-release -y $ yum install python-pip $ pip install -U setuptools

To install pip 2 on Ubuntu:

apt-get install python-pip

 

Installing the agentless Windows module

1. Use pip to install the .whl file.

$ pip install -U ./saltwinshell-2017.7-cp27-cp27mu-linux_x86_64.whl

2. Edit /etc/salt/roster with your minion information.

testwin: # Minion ID host: <IP address> user: <local Windows admin username> passwd: <password for the admin user> winrm: True

You can now run any Salt SSH command on the Windows server, such as the
following:

$ salt-ssh testwin disk.usage

 

Environment

VMware Aria Automation Config 8.12.x