puppet-dotnet

####Table of Contents

1. Overview
2. Module Description - What is the dotnet module?
3. Setup - The basics of getting started with dotnet
   • What dotnet affects
   • Setup requirements
   • Beginning with dotnet
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

Puppet module for installing and managing Microsoft .NET framework.

##Module Description

This module installs and configures the Microsoft .NET framework on Windows systems. It support side-by-side installs where appropriate.

##Setup

###What dotnet affects

• Installs the .net framework package or the windows server role.

###Beginning with dotnet

Installing the .net 3.5 server role on windows server:

  dotnet { 'dotnet35': version => '3.5' }

Installing .net 4.5:

  dotnet { 'dotnet45':
    version => '4.5'
    deployment_root => 'Z:\packages'
  }

##Usage

###Classes and Defined Types:

####Defined Type: dotnet The dotnet module primary definition, dotnet install and configures the .net framework packages/roles

Parameters within dotnet: #####ensure Ensures the state of .net on the system. Present or Absent.

#####version The version of .net that you want to be managed by this definition.

#####package_dir If installing .NET from a directory or a mounted network location then this is that directory

##Reference

###Definitions ###Public Definitions

• dotnet: Guides the basic management of the .net framework on the system.

###Private Definitions

• dotnet::install::feature: Installs dotnet as windows feature (.net 3.5)
• dotnet::install::package: Installs dotnet from a downloaded package.

##Limitations

This module is tested on the following platforms:

• Windows 2008 R2

It is tested with the OSS version of Puppet only.

##Development

###Contributing

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

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

####Features

• updating documentation to meet standard
• refactored the tests
• added support for 4.5.1 and 4.5.2
• added param package_dir that allows you do download to a directory other than C:\Windows\Temp
• adding support for downloading from the web using opentable/download_file when not specifying the package_dir

####Bugfixes

• fixing bug in operatingsystemversion checks
• fixing error when running with strict_variables
• updating powershell dependency from joshcopper to puppetlabs

##2013-05-01 - Release 0.0.2 ###Summary

####Features

• refactored into define type to allow for side-by-side install of 3.5 and 4.x

####Bugfixes

• fixed warning about string escaping on puppet 3.x

##2013-04-25 - Release 0.0.1 ###Summary

Initial release. Intalls 3.5, 4.0 and 4.5