NFS server
Tested with the following operating systems
- Ubuntu 10.04 x86 in VMware Player
- Ubuntu 12.04 x86 in VMware Player
- Ubuntu 14.04 x86_64 in VMware Player
- Ubuntu 16.04 x86_64 in VMware Player
Installation
user@ubuntu:~$ sudo apt-get install nfs-kernel-server
Example Configuration for NFS boot
Create a directory on the host root filesystem.
user@ubuntu:~$ sudo mkdir /nfs user@ubuntu:~$ sudo chmod 777 /nfs
Extract the content of root.tgz to your nfs directory.
root.tgz is located in:
- BSP download archive provided by TQ-Systems e.g. (TQMxx.BSP.SW.BIN.xxxx.tgz\TQMxx.BSP.SW.BIN.xxxx.tar\root.tgz)
- After building the BSP sources with PTXdist e.g. (../TQMxx-BSP-REV.xxxx/platform-MBxx/images/root.tgz)
user@ubuntu:~$ cd /nfs user@ubuntu:~$ sudo tar -xvf ~/workspace/TQMaxx-BSP-REV.xxxx/platform-MBaxx/images/root.tgz
Next step is to configure the /etc/exports
file.
Create an entry that contains the path to your nfs folder created above.
<path/to/your/nfs/directory> <permitted IPs>/<subnet>(<comma separated options>)
This path must match the U-Boot environment variable
rootpath
on the target and defines the source for the NFS rootfs.
After the /etc/exports file was modified the NFS server need to be restarted:
user@ubuntu:~$ sudo service nfs-kernel-server restart
Test the configuration
With the command showmount
you can see the exported directories.
user@ubuntu:~$ showmount -e localhost Export list for localhost: /nfs 192.168.0.0/255.255.0.0
Related Links
Troubleshooting
If the root file system cannot be mounted via NFS the log file of the NFS server should be checked. In Ubuntu the log is written to the file /var/log/syslog
.
An example of such a log entry looks like:
Nov 14 02:30:57 ubuntu mountd[8667]: refused mount request from 172.21.10.157 for /opt/ltib_iMX35/ltib/rootfs (/opt/ltib_iMX35/ltib/rootfs): unmatched host
In this case the server rejects the connection because the host does not match the one in the file /etc/exports
.
Sources
Disclaimer
TQ-Systems GmbH provides the Board Support Packages (BSP) free of charge. The software included in the shipment has been configured individually for the starter kits. The software is only intended to evaluate the module. The use of the Board Support Packages (BSP) is only allowed within the scope of functionality described by TQ-Systems GmbH. TQ-Systems GmbH does not accept any liability for all further changes of the Board Support Package and for any damage resulting from its use.
TQ-Systems GmbH provides the Board Support Packages (BSP) free of charge. The software included in the shipment has been configured individually for the starter kits. The software is only intended to evaluate the module. The use of the Board Support Packages (BSP) is only allowed within the scope of functionality described by TQ-Systems GmbH. TQ-Systems GmbH does not accept any liability for all further changes of the Board Support Package and for any damage resulting from its use.