dna-download_file

####Table of Contents

1. Overview
2. Module Description - What the module does and why it is useful
3. Setup - The basics of getting started with download_file
   • What download_file affects
   • Setup requirements
   • Beginning with download_file
4. Usage - Configuration options and additional functionality
5. Reference - An under-the-hood peek at what the module is doing and how
6. Limitations - OS compatibility, etc.
7. Development - Guide for contributing to the module

##Overview The download_file module allows you to download files on Windows

##Module Description

The download_file module introduced a small define download_file that will allow you to download a file over http(s) for usage during an installation. This was created because the package resource does not support http as a source for packages. It is only supported on Windows.

##Setup ###What download_file affects

• Downloads files onto each node

###Setup Requirements

• download_file makes use of Powershell so you will need to have at least version 2.0 installed in order to use this module.

##Begining

To download dotnet 4.0

    download_file { "Download dotnet 4.0" :
      url                   => 'http://download.microsoft.com/download/9/5/A/95A9616B-7A37-4AF6-BC36-D6EA96C8DAAE/dotNetFx40_Full_x86_x64.exe',
      destination_directory => 'c:\temp'
    }

To download dotnet 4.0 using a proxy

    download_file { "Download dotnet 4.0" :
      url                   => 'http://download.microsoft.com/download/9/5/A/95A9616B-7A37-4AF6-BC36-D6EA96C8DAAE/dotNetFx40_Full_x86_x64.exe',
      destination_directory => 'c:\temp',
      proxyAddress          => 'http://corporateproxy.net:8080'
    }

The proxy will be used as part of the download using PowerShell. This does not set a system wide proxy

##Usage

###Classes and Defined Types

####Defined Type: download_file

Parameters within download_file: #####url The http(s) destination of the file that you are looking to download

#####destination_directory The full path to the directory on the system where the file will be downloaded to

#####destination_file The optional name of the file to download onto the system.

#####proxy_address The optional http proxy address to use when downloading the file

#####proxy_user The optional http proxy user to use when downloading the file. proxy_address and proxy_password must be specified or this has no effect.

#####proxy_password The optional http proxy password to use when downloading the file. proxy_address and proxy_user must be specified or this has no effect. By default this value accepts secure strings. A secure string is (unfortunately) tied to the machine that it is ued for. To generate a secure string for a given machine, users should run the following powershell command on that machine (replacing PASSWORD with the desired password):

ConvertFrom-SecureString -securestring $(ConvertTo-SecureString "PASSWORD" -AsPlainText -Force)

It is possible to get this information then clear the command from history, but it's important to note that the -Force argument is there to suppress warnings that the plaintext password is in the history.

If this process sounds unappealing, you can send the password in plaintext (which sits in the download-.ps1 file on the machine being provisioned) by changing the is_password_secure variable to false.

#####is_password_secure The optional switch to change the way that proxy_password is interpreted from secure string to plaintext. This will send the password in plaintext to the machine being provisioned, which may be a security concern.

##Reference

###Defined Types ####Public Types

• download_file: Download a give file

##Limitations

This module is tested on the following platforms:

• Windows 2008
• Windows 2008 R2
• Windows 2012
• Windows 2012 R2
• Windows 7
• Windows 8

It is tested with the OSS version of Puppet only.

###Contributing

Please read CONTRIBUTING.md for full details on contributing to this project.

##2014-10-17 - Release 1.1.1 ###Summary

This releases fixes a bug where duplicate resources can occur

####Bugfixes

• fixes (#10) where C:\Temp and C:/Temp throws duplicate resource error

##2014-10-17 - Release 1.1.0 ###Summary

This release adds support to provide the file location

####Features

• Adds new parameter destination_file to provide the name of the file to download onto the system.

##2014-10-10 - Release 1.0.0 ###Summary

This release has some bug fixes but is mostly improving the documentation and testing to bring it up to a higher quality standard.

####Bug Fixes

• adding condition to check if C:\temp has already been defined

##2014-02-24 - Release 0.0.2 ###Summary

Minor update to include improved documentation of the proxy parameters

##2013-11-29 - Release 0.0.1 ###Summary

Initial public release of the module