Installing the agentless Windows module
search cancel

Installing the agentless Windows module

book

Article ID: 312982

calendar_today

Updated On:

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