Setting up NFS: Difference between revisions

From Maemo Wiki
Jump to navigationJump to search
imported>qwerty12
m Fixing mistake, if directory is made in /media/, then it should be mounted in that directory in /media/
imported>amigadave
wikify slightly
 
(13 intermediate revisions by 6 users not shown)
Line 1: Line 1:
{{Midgard article}}
== In Diablo==
== In Diablo==
This chapter shows an example of how to set up your N800/N810 as an NFS client.
This chapter shows an example of how to set up your [[Nokia N800|N800]]/[[Nokia N810|N810]] as an NFS client.


Prerequisites are:
=== Pre-requisites ===
You must be able to [[root access|access the device as root]].


#You must be able to access the device as root.
=== Installing ===
#repository.maemo.org must be in your tablet's apt sources list.
 
The first requirement can be fulfilled in a number of ways ([[Root_access#R.26D_Mode|R&D mode]], [[Root access#rootsh|rootsh]], becomeroot, or [[Root access#OpenSSH|OpenSSH server]]).
 
The second is achieved by adding repository.maemo.org / diablo/tools / free non-free to the Application manager catalogue or by editing /etc/apt/sources.list accordingly.


During this process we're going to need to install a few extra packages and load some kernel modules. Once we're done, your device will be ready to do NFS mounts.
During this process we're going to need to install a few extra packages and load some kernel modules. Once we're done, your device will be ready to do NFS mounts.
Line 19: Line 12:


*kernel-diablo-modules-extra contains the necessary kernel modules  
*kernel-diablo-modules-extra contains the necessary kernel modules  
*nfs-common contains other tools  
*nfs-common contains other tools. It contains files that are both common to NFS servers & clients.
*portmap contains the protocol port number conversion server that is needed for NFS.  
*portmap contains the protocol port number conversion server that is needed for NFS.  


# Get access to a shell (either a remote shell or an X Terminal session on the tablet itself)
<ol>
## Become root via your preferred method.
<li>\
# Making sure you have added the repository mentioned in the prerequisite, run <code>apt-get install kernel-diablo-modules-extra portmap nfs-common</code>
Get access to a shell (either a remote shell or an X Terminal session on the tablet itself)
# For the tablet to recognize a filesystem that is not compiled in the kernel, you need to load modules for tablet to recognize NFS servers. The modules must be loaded in this order.
</li>
## <code>cd /lib/modules/2.6.21-omap1/extra/</code>
<li>
### <code>insmod sunrpc.ko</code>
Become root via your preferred method.
#### <code>insmod lockd.ko</code>
</li>
##### <code>insmod nfs.ko</code>
<li>
# Now the NFS share needs to be mounted. We need to make a directory for the share to be mounted in.
Add the required repository to <code>/etc/apt/sources.list</code>
## <code>mkdir -p /media/<any name></code>
<pre>
### <code>mount -t nfs ip.of.the.server:/share/on/the/server /media/mountpoint</code>
echo "deb http://repository.maemo.org/ diablo/tools free" >> /etc/apt/sources.list
apt-get update
</pre>
(the "<code>>></code>" is important!)
</li>
<li>
Run:
<pre>
apt-get install kernel-diablo-modules-extra portmap nfs-common
</pre>
</li>
<li>
For the tablet to recognize a filesystem that is not compiled in the kernel, you need to load modules for tablet to recognize NFS servers. The modules must be loaded in this order. Run the next two commands exactly as they are written:
<pre>
cd /lib/modules/2.6.21-omap1/extra/
insmod sunrpc.ko ; insmod lockd.ko ; insmod nfs.ko
</pre>
</li>
<li>
Now the NFS share needs to be mounted. We need to make a directory for the share to be mounted in.
<pre>
mkdir -p /media/<any name>'
mount -t nfs <ip.of.the.server>:</share/on/the/server> /media/<name of directory created>
</pre>
</li>
</ol>
 
Of course, substitute anything in the <> as needed. And don't include the < and the > when running commands with them in it.


That should do it! For the mount to work, your NFS host needs to be configured correctly and that's out of the scope of this wiki page. Just be wary of the user id mappings etc. if you want to use the mountpoint as a non-root user.
That should do it! For the mount to work, your NFS host needs to be configured correctly and that's out of the scope of this wiki page. Just be wary of the user id mappings etc. if you want to use the mountpoint as a non-root user.
Line 39: Line 59:
This chapter shows an example of how to set up your N800/N810 as an NFS client.
This chapter shows an example of how to set up your N800/N810 as an NFS client.


These instructions are valid for IT OS2008, which was released in November 2007.
These instructions are valid for [[:Category:OS2008|IT OS2008]], which was released in November 2007. It is also known as ''chinook'' or 2.2007.51-3.
 
Prerequisites are:
 
#You must be able to access the device as root.  
#repository.maemo.org must be in your tablet's apt sources list.  


The first requirement can be fulfilled in a number of ways ([[Root access#The R&amp;D way (Nokia 770 only) (Linux or Mac OS X needed)|R&amp;D mode]], [[Root access#easyroot|easyroot]], becomeroot, or [[Root access#OpenSSH|OpenSSH server]]). My favorite is the SSH approach, since then I can utilize my PC's keyboard for entering all the commands.
=== Pre-requisites ===
You must be able to [[root access|access the device as root]].


The second is achieved by adding repository.maemo.org / chinook / free non-free to the Application manager catalogue or by editing /etc/apt/sources.list accordingly.
=== Installing ===


During this process we're going to need to install a few extra packages and load some kernel modules. Once we're done, your device will be ready to do NFS mounts.
During this process we're going to need to install a few extra packages and load some kernel modules. Once we're done, your device will be ready to do NFS mounts.
Line 55: Line 71:


*rx-34-kernel-modules-extra contains the necessary kernel modules  
*rx-34-kernel-modules-extra contains the necessary kernel modules  
*nfs-common contains other tools  
*nfs-common contains other tools. It contains files that are both common to NFS servers & clients.
*portmap contains the protocol port number conversion server that is needed for NFS.  
*portmap contains the protocol port number conversion server that is needed for NFS.  


This is a log of how I performed the install:
<ol>
<li>
Get access to a shell (either a remote shell or an X Terminal session on the tablet itself)
</li>
<li>
Become root via your preferred method.
</li>
<li>
Add the required repository to the apt sources (<code>/etc/apt/sources.list</code>).
<pre>
echo "deb http://repository.maemo.org/ chinook free" > /etc/apt/sources.list.d/sdk-repo.list
apt-get update
</pre>
</li>
<li>
Run:
<pre>
<pre>
$ ssh <device_ip> -l root
apt-get install rx-34-kernel-modules-extra portmap nfs-common
root@<device_ip>'s password:
</pre>
 
</li>
BusyBox v1.6.1 (2007-09-27 18:08:59 EEST) Built-in shell (ash)
<li>
Enter 'help' for a list of built-in commands.
For the tablet to recognize a filesystem that is not compiled in the kernel, you need to load modules for tablet to recognize NFS servers. The modules must be loaded in this order. Run the next two commands exactly as they are written.
 
<pre>
Nokia-N810:~# apt-get install rx-34-kernel-modules-extra
cd /lib/modules/2.6.21-omap1/extra/
Nokia-N810:~# apt-get install portmap
insmod sunrpc.ko ; insmod lockd.ko ; insmod nfs.ko
Nokia-N810:~# apt-get install nfs-common   
</pre>
</li>
<li>
Now the NFS share needs to be mounted. We need to make a directory for the share to be mounted in.
<pre>
mkdir -p /media/<any name>
mount -t nfs <ip.of.the.server>:</share/on/the/server> /media/<name of directory created>
</pre>
</li>
</ol>


# Now it's time to load the kernel modules. The order is important:
Of course, substitute anything in the <> as needed. And don't include the < and the > when running commands with them in it.
Nokia-N810:/lib/modules/2.6.21-omap1/extra# insmod sunrpc.ko
Nokia-N810:/lib/modules/2.6.21-omap1/extra# insmod lockd.ko
Nokia-N810:/lib/modules/2.6.21-omap1/extra# insmod nfs.ko
 
# The device is ready, now just mount your NFS partition:
Nokia-N810:~# mkdir /mnt/mountpoint
Nokia-N810:~# mount -t nfs <nfs_server_ip>:/some/directory /mnt/mountpoint
</pre>


That should do it! For the mount to work, your NFS host needs to be configured correctly and that's out of the scope of this wiki page. Just be wary of the user id mappings etc. if you want to use the mountpoint as a non-root user.
That should do it! For the mount to work, your NFS host needs to be configured correctly and that's out of the scope of this wiki page. Just be wary of the user id mappings etc. if you want to use the mountpoint as a non-root user.


Download this kernel image that have NFS support build in kernel
[[Category:Connectivity]]
http://maemo.org/maemowiki/ApplicationCatalog2006#head-dee0bccd8ad8d16e82f29bfa051ecc468fb009e5
[[Category:N8x0]]
 
[[Category:OS2008]]
open xterm and type this command as root for install portmap:  
[[Category:Power users]]
apt-get install nfs-common
[[Category:Diablo]]
 
then NFS is ready to use.
 
For see it in File Manager create a dir in MyDocs:  
mkdir /home/user/MyDocs/.nfs
 
# portmap
 
# mount -t nfs x.y.v.z:/foo /home/user/MyDocs/.nfs
 
 
[[Category:Users]]
[[Category:Midgard wiki]]

Latest revision as of 11:34, 10 February 2011

In Diablo

This chapter shows an example of how to set up your N800/N810 as an NFS client.

Pre-requisites

You must be able to access the device as root.

Installing

During this process we're going to need to install a few extra packages and load some kernel modules. Once we're done, your device will be ready to do NFS mounts.

The following packages will be needed; kernel-diablo-modules-extra, nfs-common and portmap.

  • kernel-diablo-modules-extra contains the necessary kernel modules
  • nfs-common contains other tools. It contains files that are both common to NFS servers & clients.
  • portmap contains the protocol port number conversion server that is needed for NFS.
  1. \ Get access to a shell (either a remote shell or an X Terminal session on the tablet itself)
  2. Become root via your preferred method.
  3. Add the required repository to /etc/apt/sources.list
    echo "deb http://repository.maemo.org/ diablo/tools free" >> /etc/apt/sources.list
    apt-get update
    

    (the ">>" is important!)

  4. Run:
    apt-get install kernel-diablo-modules-extra portmap nfs-common
    
  5. For the tablet to recognize a filesystem that is not compiled in the kernel, you need to load modules for tablet to recognize NFS servers. The modules must be loaded in this order. Run the next two commands exactly as they are written:
    cd /lib/modules/2.6.21-omap1/extra/
    insmod sunrpc.ko ; insmod lockd.ko ; insmod nfs.ko
    
  6. Now the NFS share needs to be mounted. We need to make a directory for the share to be mounted in.
    mkdir -p /media/<any name>'
    mount -t nfs <ip.of.the.server>:</share/on/the/server> /media/<name of directory created>
    

Of course, substitute anything in the <> as needed. And don't include the < and the > when running commands with them in it.

That should do it! For the mount to work, your NFS host needs to be configured correctly and that's out of the scope of this wiki page. Just be wary of the user id mappings etc. if you want to use the mountpoint as a non-root user.

In OS2008

This chapter shows an example of how to set up your N800/N810 as an NFS client.

These instructions are valid for IT OS2008, which was released in November 2007. It is also known as chinook or 2.2007.51-3.

Pre-requisites

You must be able to access the device as root.

Installing

During this process we're going to need to install a few extra packages and load some kernel modules. Once we're done, your device will be ready to do NFS mounts.

The following packages will be needed; rx-34-kernel-modules-extra, nfs-common and portmap.

  • rx-34-kernel-modules-extra contains the necessary kernel modules
  • nfs-common contains other tools. It contains files that are both common to NFS servers & clients.
  • portmap contains the protocol port number conversion server that is needed for NFS.
  1. Get access to a shell (either a remote shell or an X Terminal session on the tablet itself)
  2. Become root via your preferred method.
  3. Add the required repository to the apt sources (/etc/apt/sources.list).
    echo "deb http://repository.maemo.org/ chinook free" > /etc/apt/sources.list.d/sdk-repo.list
    apt-get update
    
  4. Run:
    apt-get install rx-34-kernel-modules-extra portmap nfs-common
    
  5. For the tablet to recognize a filesystem that is not compiled in the kernel, you need to load modules for tablet to recognize NFS servers. The modules must be loaded in this order. Run the next two commands exactly as they are written.
    cd /lib/modules/2.6.21-omap1/extra/
    insmod sunrpc.ko ; insmod lockd.ko ; insmod nfs.ko
    
  6. Now the NFS share needs to be mounted. We need to make a directory for the share to be mounted in.
    mkdir -p /media/<any name>
    mount -t nfs <ip.of.the.server>:</share/on/the/server> /media/<name of directory created>
    

Of course, substitute anything in the <> as needed. And don't include the < and the > when running commands with them in it.

That should do it! For the mount to work, your NFS host needs to be configured correctly and that's out of the scope of this wiki page. Just be wary of the user id mappings etc. if you want to use the mountpoint as a non-root user.