puppetlabs-tftp


Keywords
debian, ubuntu, tftp, rhel, centos
License
Apache-2.0
Install
puppet module install puppetlabs-tftp --version 1.0.0

Documentation

puppet tftp module

Overview

Install tftp-hpa package and configuration files

This module will install TFTP as a xinetd service by default. It can be overridden to run as a standalone daemon by setting the inetd parameter to false.

Usage

class tftp

Parameters:

  • username: tftp daemon user, default tftp(debian) or nobody(redhat).
  • directory: service directory, deafult see params class.
  • address: bind address, default 0.0.0.0.
  • port: bind port, default 69.
  • options: service option, default --secure.
  • inetd: run service via xinetd, default true.

Example:

class tftp {
  directory => '/opt/tftp',
  address   => $::ipaddress,
  options   => '--ipv6 --timeout 60',
}

tftp::file

Parameters:

  • ensure: file type, default file.
  • owner: file owner, default tftp.
  • group: file group. default tftp.
  • mode: file mode, default 0644 (puppet will change to 0755 for directories).
  • content: file content.
  • source: file source, defaults to puppet:///module/${caller_module_name}/${name} for files without content.
  • recurse: directory recurse, default false.
  • purge: directory recurse and purge.
  • replace: replace directory with file or symlink, default undef.
  • recurselimit: directory recurse limit, default undef.

Example:

tftp::file { 'pxelinux.0':
  source => 'puppet:///modules/acme/pxelinux.0',
}

tftp::file { 'pxelinux.cfg':
  ensure => directory,
}

tftp::file { 'pxelinux.cfg/default':
  ensure => file,
  source => 'puppet:///modules/acme/pxelinux.cfg/default',
}

The last example can be abbreviated to the following if it's in the acme module:

tftp::file { 'pxelinux.cfg/default': }

Example

  1. tftp directories not in the OS package defaults should be managed as file resources.
  2. customization for the class tftp must be declared before using tftp::file resources.

Example:

file { '/opt/tftp':
  ensure => directory,
}

class { 'tftp':
  directory => '/opt/tftp',
  address   => $::ipaddress,
}

tftp::file { 'pxelinux.0':
  source => 'puppet:///modules/acme/pxelinux.0',
}

The examples use a module acme and the tftp files should be placed relative to the files directory of the calling module, i.e. ($modulepath/acme/files/).

Supported Platforms

The module has been tested on the following platforms. Testing and patches for other platforms are welcomed.

  • Debian 7 (Wheezy)
  • EL 5
  • EL 6
  • Ubuntu 12.04
  • Ubuntu 14.04
  • Ubuntu 16.04