User Tools

Site Tools

vmware.png nfs.png tftp.png subversion.png eclipse.png logo.png tutorial.png

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


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>)

For example

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:


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 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.


en/general_information/nfs.txt · Last modified: 2018/03/22 17:57 by liedmann


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.

Except where otherwise noted, content on this wiki is licensed under the following license: CC Attribution-Share Alike 4.0 International
Recent changes RSS feed Valid XHTML 1.0 Valid CSS Driven by DokuWiki