Ejecutar un servidor TFTP para la configuración de dispositivos de red
…en Mac OS X o macOS
Por Rick Cogley
6-feb-.2017
Consejos de software Sysadmin
TOC
- PreparaciónEncuentra los comandos apropiadosInicia tftpdSirve un archivo de firmwareEnlaza con la carpeta tftpbootCopia el archivo de firmware en su posiciónObtén el archivo de firmware de tftpdColoca un archivo de un dispositivo en tftpdDetén tftpdAlternativas
Si trabajas con dispositivos de red como switches, routers o firewalls, para actualizar su firmware, la mayoría de las veces necesitas un servidor TFTP. A continuación te explicamos cómo utilizar el que viene incluido en Mac OS X o macOS.
Preparación
Mac OS X tiene un servidor tftp incluido, y sólo tienes que iniciarlo y hacer una pequeña configuración.
Yo lo encontré y lo configuré así:
Busca los comandos adecuados
Usa el comando apropos para ver si hay algún comando relacionado con tftp. From Terminal:
Bash
- apropos tftp
The command replies:
Bash
- tftp(1) – trivial file transfer program
- tftpd(8) – DARPA Internet Trivial File Transfer Protocol server
Since the commands exist, you can use man to get more info. We would want the server version of this command, so that is the one with the d suffix (d is for “daemon”).
Bash
- man tftpd
Looking at these results and Apple’s online version of the man info, we see it says:
This server should not be started manually; instead, it should be run using launchd(8) using the plist /System/Library/LaunchDaemons/tftp.plist. It may be started using the launchctl(1) load command; refer to the documentation for that utility for more information.
Start tftpd
The man file gives you the plist to use, so, you just start it with launchctl:
Bash
- sudo launchctl load -F /System/Library/LaunchDaemons/tftp.plist
… and tftpd will start. Supply your password when sudo prompts for it.
You can confirm it’s running using netstat to check what is listening on its port, traditionally port 69.
Bash
- netstat -na |grep *.69
It will show:
Bash
- udp6 0 0 *.69 *.*
- udp4 0 0 *.69 *.*
Serve a Firmware File
Now that the tftpd server is started, you need to put the firmware binary file in a specific location for the tftpd to be able to serve it to a requesting device. Namely your firmware files should be saved to /private/tftpboot. The tftp.plist file looks like this:
Xml
- <?xml version=»1.0″ encoding=»UTF-8″?>
- .0″>
- Disabled
- Label
- com.apple.tftpd
- ProgramArguments
- /usr/libexec/tftpd
- -i
- /private/tftpboot
- inetdCompatibility
- Wait
- InitGroups
- Sockets
- Listeners
- SockServiceName
- tftp
- SockType
- dgram
Symlink the tftpboot folder
You used to be able to change the tftpboot path, but OS X El Capitan and later macOSs have stronger security via their “SIP” system which makes things more difficult. Just symlink the tftpboot to a folder you have full control over. You can do it like this:
Bash
- cd /private/
- sudo rm -rf tftpboot
- mkdir /Users/myuser/tftpboot
- sudo ln -s /Users/myuser/tftpboot tftpboot
- sudo launchctl unload -F /System/Library/LaunchDaemons/tftp.plist
- sudo launchctl load -F /System/Library/LaunchDaemons/tftp.plist
That being said, please note that I tested a fresh macOS Sierra install directly on /private/tftpboot, and tftp get and put from another Mac worked fine without the symlink in place, so YMMV. I confirmed with csrutil status that SIP is indeed enabled on my fresh macOS.
Japanese Mac keyboards don’t handle reverse solidus . To enter one you can press option-¥.
Copy firmware file into position
Now let’s serve a file. Let’s say we download a firmware for an HP switch, and want to upgrade its firmware to that version. The file downloaded is F_05_80.swi and is saved to our Downloads folder. Let’s move it to the correct folder, and set its permissions.
Bash
- cd /Users/myuser/tftpboot
- cp ~/Downloads/hp/F_05_80.swi .
- ls
- chmod 766 F_05_80.swi
Get firmware file from tftpd
Screenshot: HP Switch Firmware Upgrade UI
It differs by each device you’re upgrading, but typically you would set these:
- Method of upgrade: select tftp usually.
- IP address of tftpd server. This is the IP of your mac.
- Name of firmware file. Enter the exact name, getting the case exactly right.
Then there is usually a way to “execute” the transfer by a command or menu. Una vez transferido y cargado el firmware, su dispositivo suele reiniciarse.
Haga clic en la captura de pantalla para ver cómo se ve en un switch de HP.
Colocar un archivo de un dispositivo en tftpd
A veces quiere guardar un archivo del dispositivo, en su servidor tftp. El protocolo tftp es tonto y no requiere autenticación, por lo que necesita especificar de antemano cuál será el nombre del archivo recibido. Use touchto do that.
Be sure to get the name exactly right, as mis-spellings are a common cause of errors here.
Bash
- touch ~/tftpboot/catalyst.conf
- chmod 766 ~/tftpboot/catalyst.conf
Now you have a blank file that will be overwritten, when you specify it from your remote device. Make sure you specify exactly the same filename.
Stop tftpd
Be sure to unload the service when you’re not using it:
Bash
- sudo launchctl unload -F /System/Library/LaunchDaemons/tftp.plist
- netstat -na |grep *.69
The aforementioned netstat command should return nothing.
Alternatives
There are a couple of GUI alternatives you can try, though I have not done so myself:
- PumpKIN
- TFTP Server
I hope this information helps someone.
Cheers!!