how to make your life easier 

installing software on a windows machine

Justin James

• Multiple clicks to get to anywhere
• Deja Vu - sense of installing same software on multiple machines
• aargh! I should have downloaded the 32 bit version.
• Don't install it on a directory with space in the name
• etc
• etc
• etc

Essentially apt-get for windows

Uses nuget to package up the installs

Uses powershell to do the install

Lots of built in helpers 

But at the end of the day it is powershell,  so you can do nearly anything during the install

Nuget started out as a package manager for the Visual Studio dev environment.

It is an easy way to package up code, dll's, configs, etc and distribute them. 

Instead of re-inventing the wheel, Chocolatey uses nuget to do: 

- packaging 

- dependency management

- versioning

- hosting feeds/gallery

 

clist (chocolatey list) [Search Term]

Chocolatey.org

Nuget.org

Web Platform Installer (WebPI)

Ruby Gems

Cygwin

Python

Windows Features

Windows Update (using BoxStarter)

File Share

any other place you can have a nuget source

Run the command below 

or 

Go to chocolatey.org and copy the command from the home page

@powershell -NoProfile -ExecutionPolicy unrestricted -Command "iex ((new-object net.webclient).DownloadString('https://chocolatey.org/install.ps1'))" && SET PATH=%PATH%;%systemdrive%\chocolatey\bin

from the command line:

cinst [package name]

example: 

cinst notepadplusplus

this will download the installer and run it silently

Runs the chocolatelyInstall.ps1 script 

Easiest way to review script is to install Nuget Package Explorer

cinst NugetPackageExplorer

Then you can open the package in Nuget Package Explorer 

 You should review the chocolateyInstall.ps1 before installing any packages.

You can also view all of the chocolately code in c:\chocolatey

There are 2 ways to do update an install to the latest

1:  Update one package at a time

cup [package name]

2:  Update all installed packages

cup all

The package needs to provide a chocolateyUninstall.ps1 

Unfortunately, in many cases this is not provided

chocolatey uninstall [package name]

or 

cuninst [package name]

Every package includes 3 main components:

NuSpec

chocolateyInstall.ps1

any application files to include

Basic Steps:

1. Create your directory structure and ps1 files
2. cinst nuget.commandline
3. run nuget spec against directory 
4. fill out details in the nuspec file
5. run nuget pack [nuspec file] to create package

Install-ChocolateyPackage	Install-ChocolateyVsixPackage
Install-ChocolateyZipPackage	Install-ChocolateyPowershellCommand
Get-ChocolateyWebFile	Get-ChocolateyUnzip
Install-ChocolateyPinnedTaskBarItem	Install-ChocolateyDesktopLink
Start-ChocolateyProcessAsAdmin	Install-ChocolateyInstallPackage
Install-ChocolateyPath	Install-ChocolateyEnvironmentVariable
Install-ChocolateyExplorerMenuItem	Install-ChocolateyFileAssociation
Update-SessionEnvironment

https://github.com/chocolatey/chocolatey/wiki/HelpersReference

Installs Windows Features via the Deployment Image Servicing and Management tool on the local machine. 

Install products from the Web Platform Installer (webpi)

cinst [product name] -source webpi

command to get list of available installs:

clist -source webpi

PreRequisite: 

cinst webpicommandline

http://boxstarter.org

built on top of chocolatey

provides reboot resiliency & remote  installations

integrates with Hyper-V and Azure VMs

allow install of Windows Updates

Set options for taskbar, remote desktop, & explorer

better way to install multiple packages that require reboot

Accomplished with package chocopkgup

Free for publicly available packages (i.e. chocolatey gallery)

Have to pay $$ if used for private packages

Details:

 https://github.com/chocolatey/chocolatey/wiki/AutomaticPackages

Very easy to add/remove/disable sources

Get Sources -> choco sources list

Add Source -> choco add -name "" -source ""

Update Source -> remove and re-add with new details

Disable -> choco sources disable  "name" 

Enable -> choco sources enable  "name" 

Local Feed: point at a folder on your system

Remote Feeds:  You can host a remote feed on a server that runs IIS.

- use Nuget.Server package

Can also host nuget gallery locally

• Setting up a Local Gallery
• Branding the Nuget Gallery

Install Chocolatey 

Install  Notepad++

Chocolatey  Gallery:   http://www.chocolatey.org/

Boxstarter: Setup Dev Machine  

Create Package

Can host packages offline

Needs internet if the packages try fetch meta-data while installation

Increasing no. of packages available through gallery

Not as polished as UNIX

Unaware of applications installed outside of chocolatey

Definitely a good start

Chocolatey got a HUGE validation push this week from Microsoft.

At BUILD, Microsoft announced OneGet 

as part of the Windows Management Framework 5.0 Preview

OneGet is basically a software package manager for windows.

1st version will interact with Chocolatey repositories

Usage details @ 

http://learn-powershell.net/2014/04/03/checking-out-oneget-in-powershell-v5/

Main Web Site and Package Repository

http://chocolatey.org/

Documentation

https://github.com/chocolatey/chocolatey/wiki

Command Reference

https://github.com/chocolatey/chocolatey/wiki/CommandsReference

Google Group

https://groups.google.com/forum/#!forum/chocolatey

Twitter

https://twitter.com/chocolateynuget

BoxStarter

Brackets

1. cinst warmup 
   
2. warmup addTextReplacement [Token] "Token Value" 
   

• __CHOCO_PKG_OWNER_NAME__ 
  
• __CHOCO_PKG_OWNER_REPO__ 
  
• __CHOCO_AUTO_PKG_OWNER_REPO__ 
  

git clone  https://github.com/chocolatey/chocolateytemplates.git  

cd chocolateytemplates\_templates

warmup addTemplateFolder chocolatey "%cd%\chocolatey" 

• chocolatey3 -> regular, install, & portable
• chocolate3auto -> auto updating package
• chocolateyauto3 -> same as 3 but auto updating

Create basic nuspec and chocolateyInstall.ps1

 

1. New-BoxstarterPackage -Name MyPackage -Description ""
   
2. Edit nuspec
3. Edit ChocolateyInstall.ps1
4. Invoke-BoxstarterBuild MyPackage

http://boxstarter.org/CreatingPackages