Difference between revisions of "TFTP"

From ArchWiki
Jump to: navigation, search
(Installation)
(update default path)
(16 intermediate revisions by 15 users not shown)
Line 1: Line 1:
[[Category:HOWTOs (English)]]
+
[[Category:File Transfer Protocol]]
{{stub}}
+
The [[Wikipedia:Trivial File Transfer Protocol|Trivial File Transfer Protocol]] (TFTP) provides a minimalistic means for transferring files.  It is generally used as a part of [[PXE]] booting or for updating configuration and firmware on devices which have limited memory such as routers and printers.
  
== Introduction ==
+
This article describes how to set up a tftpd server under Arch Linux using the {{Pkg|tftp-hpa}} package.
This HOWTO describes how to set up a tftpd server under Arch Linux.
+
  
 
== Installation ==
 
== Installation ==
The first thing is to install all necessary stuff:
+
[[pacman|Install]] the package {{Pkg|tftp-hpa}} which can be found in the [[Official Repositories|official repositories]].
# pacman -S mkpxelinux  tftp-hpa dhcpcd
+
  
 
== Configuration ==
 
== Configuration ==
At first we will create a /etc/dhcpd.conf file. It has to look like this (basic dhcpd config):
+
The configuration for tftpd is in {{ic|/etc/conf.d/tftpd}}
  
  ddns-update-style interim;
+
The default configuration is:
   
+
  #
  subnet *'''your subnet'''* netmask *'''your netmask'''* {
+
  # Parameters to be passed to TFTPD
        option routers                  *'''IP of your router'''*;
+
  #
        option subnet-mask              *'''your subnet again'''*;
+
  TFTPD_ARGS="-l -s /srv/tftp/"
   
+
        option domain-name              "'''here you can put your domain name if you dont have one take example.com'''";
+
+
        option time-offset              -18000;    # Eastern Standard Time
+
        next-server *'''IP of your machine where dhcpd is running'''*;
+
        filename "pxelinux.0";
+
+
        allow booting;
+
        allow bootp;
+
+
        range *'''the range of ip addresses your dhcpd is allow to take, example: 10.0.0.10 10.0.0.200'''*;
+
}
+
  
Remove the ** from the config.
+
The directory {{ic|/srv/tftp}} is created automatically when {{Pkg|tftp-hpa}} is installed.
  
After this you have to run:
+
For a complete list of parameters:
  # mkpxeboot -a
+
  $ man in.tftpd
  
This will create all images and stuff to boot.
+
== Run ==
 +
To start the daemon at boot, add {{ic|tftpd}} to the {{ic|DAEMONS}} array in {{ic|/etc/[[rc.conf]]}}.
  
Now we replace the kernel and the initrd.img with the newest from the install iso.
+
To start the daemon manually:
$ wget ftp://ftp.archlinux.org/other/0.8/i686/ftp-0.8-beta2-20070222-i686.iso
+
  # /etc/rc.d/tftpd start
When the download is finished, we nearly finished.
+
  # mount -o loop /where/the/iso/is/located /path/to/mount/
+
# cp /path/to/mount/isolinux/initd.img /var/tftpboot/
+
# cp /path/to/mount/isolinux/vmlinuz /var/tftpboot/
+
  
Now last config and then we can load all the stuff:
+
To start the daemon without a configuration file:
  # nano /etc/hosts.allow
+
  # /usr/sbin/in.tftpd -l -s path/to/folder/to/export
Add these lines:
+
tftpd: ALL
+
in.tftpd: ALL
+
 
+
Now do:
+
# /etc/rc.d/tftpd start
+
And in a terminal:
+
# dhcpd
+
  
Now you can start the PC you want to install.
+
== Troubleshooting ==
 +
=== tftpd startup fails if ipv6 is disabled ===
 +
If tftpd startup fails without leaving error messages, it might be because ipv6 is disabled and you are not explicitly telling tftpd not to use ipv6. You can make tftpd start by enabling ipv6 or by telling tftpd to only use ipv4, adding the '-4' switch to /etc/conf.d/tftpd
  
Good Luck!
+
{{hc|/etc/conf.d/tftpd|<nowiki>
 +
TFTPD_ARGS="-l -4 -s /srv/tftp/"
 +
</nowiki>}}

Revision as of 16:29, 11 October 2012

The Trivial File Transfer Protocol (TFTP) provides a minimalistic means for transferring files. It is generally used as a part of PXE booting or for updating configuration and firmware on devices which have limited memory such as routers and printers.

This article describes how to set up a tftpd server under Arch Linux using the tftp-hpa package.

Installation

Install the package tftp-hpa which can be found in the official repositories.

Configuration

The configuration for tftpd is in /etc/conf.d/tftpd

The default configuration is:

#
# Parameters to be passed to TFTPD
#
TFTPD_ARGS="-l -s /srv/tftp/"

The directory /srv/tftp is created automatically when tftp-hpa is installed.

For a complete list of parameters:

$ man in.tftpd

Run

To start the daemon at boot, add tftpd to the DAEMONS array in /etc/rc.conf.

To start the daemon manually:

# /etc/rc.d/tftpd start

To start the daemon without a configuration file:

# /usr/sbin/in.tftpd -l -s path/to/folder/to/export

Troubleshooting

tftpd startup fails if ipv6 is disabled

If tftpd startup fails without leaving error messages, it might be because ipv6 is disabled and you are not explicitly telling tftpd not to use ipv6. You can make tftpd start by enabling ipv6 or by telling tftpd to only use ipv4, adding the '-4' switch to /etc/conf.d/tftpd

/etc/conf.d/tftpd
TFTPD_ARGS="-l -4 -s /srv/tftp/"