windows_print Cookbook

This cookbook installs Windows Print and Document Services, handles driver, port, and printer installation.

Requirements

Platform

• Windows Server 2008 R2
• Windows Server 2012
• Windows Server 2012 R2

Cookbooks

• Windows - Official windows cookbook from opscode - https://github.com/opscode-cookbooks/windows.git

Usage

windows_print::default

The windows_print::default recipe installs the required roles and features to support a windows print server.

{
  "name":"my_node",
  "run_list": [
    "recipe[windows_print]"
  ]
}

windows_print::distributed_scan_server

The windows_print::distributed_scan_server recipe installs the required role to support a windows distributed scan server.

{
  "name":"my_node",
  "run_list": [
    "recipe[windows_print::distributed_scan_server]"
  ]
}

windows_print::internet_printing

The windows_print::internet_printing recipe installs the required roles and features to support a windows print server internet printing including IIS. This action will install all require features from windows_print::default.

{
  "name":"my_node",
  "run_list": [
    "recipe[windows_print::internet_printing]"
  ]
}

windows_print::lpd_service

The windows_print::lpd_service recipe installs the required role to install a line printer daemon service.

{
  "name":"my_node",
  "run_list": [
    "recipe[windows_print::lpd_service]"
  ]
}

Resource/Provider

'driver'

Installs printer driver from inf file.

Actions

• :install: Installs a printer driver
• :delete: Removes a printer driver

Attribute Parameters

• driver_name: name attribute. Name of the print driver.
• inf_path: Full path to the inf file.
• inf_file: Name of the inf file.
• version: Default "Type 3 - User Mode" Options: "Type 3 - User Mode" or "Type 2 - Kernel Mode"
• environment: Chipset of the driver being installed. Default "x64" Options: "x86", "x64" or "Itanium".

Examples

# Install HP LaserJet 9050 PS driver
windows_print_driver "HP LaserJet 9050 PS" do
  action :install
  inf_path "c:\\9050 x64"      
  inf_file "hpc9050v.inf"
end

# Delete HP LaserJet 9050 PS driver
windows_print_driver "HP LaserJet 9050 PS" do
  action :delete
end

'port'

Allows creation of ports based on name rather than IP Address.

Actions

• :create: Installs a printer port
• :delete: Removes a printer port

Attribute Parameters

• port_name: name attribute. Name of the port.
• ipv4_address: IPv4 address of the printer port

Examples

# Install PrinterPort1 port @ 10.0.0.50
windows_print_port "PrinterPort1" do
  action :create
  ipv4_address "10.0.0.50"
end

# Deletes PrinterPort1 port
windows_print_port "PrinterPort1" do
  action :delete
end

'printer'

Allows creation of printer objects. Handles port and driver creation if not present.

Actions

• :create: Creates a printer
• :delete: Deletes a printer

Attribute Parameters

• printer_name: name attribute. Name of the printer. Required
• driver_name: Name of the print driver. Required
• port_name: Name of the port. Required
• share_name: Shared printer object name.
• location: Location field for printer object.
• comment: Comments section for printer object.
• ipv4_address: IPv4 address of the printer port
• inf_path: Full path to the inf file.
• inf_file: Name of the inf file.
• version: Default "Type 3 - User Mode" Options: "Type 3 - User Mode" or "Type 2 - Kernel Mode"
• environment: Chipset of the driver being installed. Default "x64" Options: "x86", "x64" or "Itanium".

Examples

# Create HP LaserJet
windows_print_printer "HP LaserJet" do
  action :create
  driver_name "HP LaserJet"
  port_name "HP LaserJet"
end

# Create HP LaserJet, create driver, create port
windows_print_printer "HP LaserJet" do
  action :create
  driver_name "HP LaserJet"
  port_name "HP LaserJet"
  ipv4_address "10.0.0.50"
  inf_path "C:\\chef\\cookbooks\\windows_print\\files\\default\\HP Universal Printing PCL 6 (v5.4)\\x64"
  inf_file "hpcu118u.inf"
  environment "x64"
end

# Create HP LaserJet and share as "HP Printer"
windows_print_printer "HP LaserJet" do
  action :create
  driver_name "HP LaserJet"
  port_name "HP LaserJet"
  comment ""
  ipv4_address "10.0.0.50"
  inf_path "C:\\chef\\cookbooks\\windows_print\\files\\default\\HP Universal Printing PCL 6 (v5.4)\\x64"
  inf_file "hpcu118u.inf"
  share_name "HP Printer"
  environment "x64"
end

# Deletes HP LaserJet
windows_print_port "HP LaserJet" do
  action :delete
end

Contributing

1. Fork the repository on Github
2. Create a named feature branch (like add_component_x)
3. Write you change
4. Write tests for your change (if applicable)
5. Run the tests, ensuring they all pass
6. Submit a Pull Request using Github

License and Authors

Authors:: Derek Groh (dgroh@arch.tamu.edu)