Difference between revisions of "TFTP"

From ArchWiki
Jump to: navigation, search
(tftpd setup)
 
(Configuration: Merge info from Network Installation Guide.)
(27 intermediate revisions by 21 users not shown)
Line 1: Line 1:
[[Category:howtos]]
+
[[Category:File Transfer Protocol]]
Okay i want to describe here how to set up a tftpd server under archlinux.
+
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.
  
At first thing is to install all neccesary stuff:
+
This article describes how to set up a tftpd server under Arch Linux using the {{Pkg|tftp-hpa}} package.
  
pacman -S mkpxelinux tftpd-hpa dhcpd
+
== Installation ==
 +
[[pacman|Install]] the package {{Pkg|tftp-hpa}} which can be found in the [[Official Repositories|official repositories]].
  
Now we need to do some configure stuff at first we will create our dhcpd.conf file.
+
== Configuration ==
 +
The configuration for tftpd is in {{ic|/etc/conf.d/tftpd}}
  
The config is located in /etc/
+
The default configuration is:
 +
#
 +
# Parameters to be passed to TFTPD
 +
#
 +
TFTPD_ARGS="-l -s /srv/tftp/"
  
and have to look like this (basic dhcpd config)
+
{{ic|-s /srv/tftp/}} set ftpd root directory to {{ic|/srv/tftp/}}. The directory {{ic|/srv/tftp}} is created automatically when {{Pkg|tftp-hpa}} is installed.
  
 +
For systemd configuration, {{ic|/usr/lib/systemd/system/tftpd.service}} is used:
  
  ddns-update-style interim;
+
  [Unit]
 +
Description=hpa's original TFTP daemon
 
   
 
   
  subnet *your subnet here* netmask *here your netmask* {
+
  [Service]
        option routers                  *here ip of your router*;
+
  ExecStart=/usr/sbin/in.tftpd -s /srv/tftp/
        option subnet-mask              *your subnet here again ;)*;
+
  StandardInput=socket
   
+
  StandardOutput=inherit
        option domain-name              "here you can put your domain name if you dont have one take example.com";
+
  StandardError=journal
+
        option time-offset              -18000;    # Eastern Standard Time
+
        next-server *here ip of your maschine where dhcpd is running*;
+
        filename "pxelinux.0";
+
   
+
        allow booting;
+
        allow bootp;
+
   
+
   
+
        range *here the range of ip adresses your dhcpd is allow to take example: 10.0.0.10 10.0.0.200;
+
}
+
  
remove the ** form the config ;).
+
Copy the tftp unit files in {{ic|/usr/lib/systemd/system}} to {{ic|/etc/systemd/system}}; the former gets overwritten when systemd is updated. The [[systemd]] article talks in more detail about customizing unit files.
  
after this you have to run
+
For a complete list of parameters:
 +
$ man in.tftpd
  
mkpxeboot -a
+
== Run ==
  
this will create all images and stuff to boot.
+
=== Systemd ===
Now we replace the kernel and the initrd.img with the newes from the install iso.
+
To start the daemon at boot, run:
 +
# systemctl enable tftpd.socket
  
wget ftp://ftp.archlinux.org/other/0.8/i686/ftp-0.8-beta2-20070222-i686.iso
 
  
when download is finished we nearly finished.
+
To start the daemon manually (You must respect this order):
 +
# systemctl start tftpd.socket
 +
# systemctl start tftpd.service
  
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 fireup all the stuff
+
To stop the daemon manually (You must respect this order):
 +
# systemctl stop tftpd.socket
 +
# systemctl stop tftpd.service
  
nano/vi/joe... /etc/hosts.allow
+
=== Sysvinit ===
+
To start the daemon at boot, add {{ic|tftpd}} to the {{ic|DAEMONS}} array in {{ic|/etc/[[rc.conf]]}}.
and add this line:
+
tftpd: ALL
+
in.tftpd: ALL
+
  
now do
+
To start the daemon manually:
 +
# /etc/rc.d/tftpd start
  
  /etc/rc.d/tftpd start
+
To start the daemon without a configuration file:
and in a terminal
+
  # /usr/sbin/in.tftpd -l -s path/to/folder/to/export
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>
espo
+
TFTPD_ARGS="-l -4 -s /srv/tftp/"
 +
</nowiki>}}

Revision as of 13:26, 14 December 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/"

-s /srv/tftp/ set ftpd root directory to /srv/tftp/. The directory /srv/tftp is created automatically when tftp-hpa is installed.

For systemd configuration, /usr/lib/systemd/system/tftpd.service is used:

[Unit]
Description=hpa's original TFTP daemon

[Service]
ExecStart=/usr/sbin/in.tftpd -s /srv/tftp/
StandardInput=socket
StandardOutput=inherit
StandardError=journal

Copy the tftp unit files in /usr/lib/systemd/system to /etc/systemd/system; the former gets overwritten when systemd is updated. The systemd article talks in more detail about customizing unit files.

For a complete list of parameters:

$ man in.tftpd

Run

Systemd

To start the daemon at boot, run:

# systemctl enable tftpd.socket


To start the daemon manually (You must respect this order):

# systemctl start tftpd.socket
# systemctl start tftpd.service


To stop the daemon manually (You must respect this order):

# systemctl stop tftpd.socket
# systemctl stop tftpd.service

Sysvinit

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/"