Difference between revisions of "Cool Solution - NFS with UCS"

From Univention Wiki

Jump to: navigation, search
Line 1: Line 1:
{{Cool Solutions Disclaimer|Repository={yes,no}|UCS=3.2|UCC=1.0}}
+
{{Review-Status}}{{Cool Solutions Disclaimer|Repository={yes,no}|UCS=3.2|UCC=1.0}}
  
 
= Introduction =
 
= Introduction =
This article will describe how to configure the Network File System (NFS) in Version 4 for Univention Corporate Clients (UCC) and Univention Corporate Servers (UCS).
+
This article describes how to configure the Network File System (NFS) in Version 4 for Univention Corporate Clients (UCC) and Univention Corporate Servers (UCS).
 
Since UCS 3.2 NFSv4 is activated by default<sup>1.</sup>. UCS Versions < 3.2 use NFSv3 for shares so please have a look on [[NFSv4_with_UCS|NFSv4 for Univention Corporate Server < 3.2]].
 
Since UCS 3.2 NFSv4 is activated by default<sup>1.</sup>. UCS Versions < 3.2 use NFSv3 for shares so please have a look on [[NFSv4_with_UCS|NFSv4 for Univention Corporate Server < 3.2]].
 +
 +
= NFS on UCS =
 +
== Shares on UCS ==
 +
At least for medium environments it is recommended to set up a seperate file server (e.g. DC Slave). On this server shares can created as described in the [http://docs.univention.de/manual-3.2.html#shares::management UCS documentation].
 +
 +
 +
== Configuration in the Univention Management Console ==
 +
Beside several different Options in the TAB 'NFS' which are described in the [http://docs.univention.de/manual-3.2.html#idp13512080 UCS documentation] it is possible to set following Univention Configuration Registry variables:
 +
* nfs/autostart - This variable configures the start mode of the NFS service. If set to 'no' or 'disabled', the service cannot be started. If the variable is set to 'manually', the service isn't started during system boot, but can be enabled manually at a later point.
 +
* nfs/common/gssd - This variable defines if the gssd daemon should be started. Evaluated values are 'yes', 'no' or <undefined> (default=yes).
 +
* nfs/common/idmapd - This variable defines if the idmap daemon should be started. Evaluated values are 'yes', 'no' or <undefined> (default=yes).
 +
* nfs/create/homesharepath - If this option is activated, the home directory configured for a user in the attributes 'Home share' and 'Home share path' is automatically created through a Univention Directory Listener module.
 +
* nfs/nfsd/nfs4 - This option activates the NFSv4 support of the NFS server. In addition the IDMAPD process must be configured usually.
 +
* nfs/ports - If this variable is set to 'static', fixed ports are used for the NFS services: 32767 for RPC mounts, 32765/32766 for statd and 32769 for the quota service. Otherwise the ports are assigned dynamically.
 +
* ucc/pxe/nfsroot - Sets the PXE-Rollout-Server in the domain.
 +
 +
 +
= NFS for UCC =
 +
Prerequisite:<br>
 +
Install following packages:
 +
apt-get install nfs-common
 +
Create mount directory.
 +
 +
== Temporary mount ==
 +
Verifie following setting in /etc/default/nfs-kernel-server:
 +
NEED_SVCGSSD=no
 +
To mount a NFSv4 share temporary use following command:
 +
mount -t nfs4 nfs-server.domain:/path-to-share /path-to-local-mnt-dir
 +
 +
== Static mount ==
 +
To add the share permanently it is possible to mount the share statically during system startup. Therefor the /etc/fstab has to be edited with the following line (USE TABS BETWEEN THE VALUES):
 +
nfs-server.domain:/path-to-share /path-to-local-mnt-dir nfs4 auto 0 0
 +
 +
== Auto mount ==
 +
Unlike the static mount option it is possible to automatically mount the share when accessed. Therefor it is necessary to install autofs:
 +
apt-get install autofs
 +
Afterwards add following line to /etc/auto.master (USE TABS BETWEEN THE VALUES):
 +
/path-to-local-mnt-dir /etc/auto.name-of-share
 +
Create /etc/auto.name-of-share and insert following (USE TABS BETWEEN THE VALUES):
 +
* subdirectory-under-path-to-local-mnt-dir -fstype=nfs4 nfs-server.domain:/path-to-share
 +
Verifie following settings in /etc/default/nfs-common:
 +
NEED_IMAPD=yes
 +
NEED_GSSD=no
 +
Reload /etc/init.d/autofs
 +
/etc/init.d/autofs restart
 +
Make sure it works
 +
ls path-to-local-mnt-dir/subdirectory/
 +
 +
 +
= References =
 +
1. Release Notes Univention Corporate Server 3.2: http://docs.univention.de/release-notes-3.2-en.html#idp3973216 <br>
 +
2. https://help.ubuntu.com/community/SettingUpNFSHowTo <br>
 +
3. https://help.ubuntu.com/community/Autofs

Revision as of 08:28, 7 July 2014

Note: This article is not yet reviewed.
Produktlogo UCS Version 3.2
Produktlogo UCC Version 1.0

Note: Cool Solutions are articles documenting additional functionality based on Univention products. Not all of the shown steps in the article are covered by Univention Support. For questions about your support coverage contact your contact person at Univention before you want to implement one of the shown steps.

Also regard the legal notes at Terms of Service.


Introduction

This article describes how to configure the Network File System (NFS) in Version 4 for Univention Corporate Clients (UCC) and Univention Corporate Servers (UCS). Since UCS 3.2 NFSv4 is activated by default1.. UCS Versions < 3.2 use NFSv3 for shares so please have a look on NFSv4 for Univention Corporate Server < 3.2.

NFS on UCS

Shares on UCS

At least for medium environments it is recommended to set up a seperate file server (e.g. DC Slave). On this server shares can created as described in the UCS documentation.


Configuration in the Univention Management Console

Beside several different Options in the TAB 'NFS' which are described in the UCS documentation it is possible to set following Univention Configuration Registry variables:

  • nfs/autostart - This variable configures the start mode of the NFS service. If set to 'no' or 'disabled', the service cannot be started. If the variable is set to 'manually', the service isn't started during system boot, but can be enabled manually at a later point.
  • nfs/common/gssd - This variable defines if the gssd daemon should be started. Evaluated values are 'yes', 'no' or <undefined> (default=yes).
  • nfs/common/idmapd - This variable defines if the idmap daemon should be started. Evaluated values are 'yes', 'no' or <undefined> (default=yes).
  • nfs/create/homesharepath - If this option is activated, the home directory configured for a user in the attributes 'Home share' and 'Home share path' is automatically created through a Univention Directory Listener module.
  • nfs/nfsd/nfs4 - This option activates the NFSv4 support of the NFS server. In addition the IDMAPD process must be configured usually.
  • nfs/ports - If this variable is set to 'static', fixed ports are used for the NFS services: 32767 for RPC mounts, 32765/32766 for statd and 32769 for the quota service. Otherwise the ports are assigned dynamically.
  • ucc/pxe/nfsroot - Sets the PXE-Rollout-Server in the domain.


NFS for UCC

Prerequisite:
Install following packages:

apt-get install nfs-common

Create mount directory.

Temporary mount

Verifie following setting in /etc/default/nfs-kernel-server:

NEED_SVCGSSD=no

To mount a NFSv4 share temporary use following command:

mount -t nfs4 nfs-server.domain:/path-to-share /path-to-local-mnt-dir

Static mount

To add the share permanently it is possible to mount the share statically during system startup. Therefor the /etc/fstab has to be edited with the following line (USE TABS BETWEEN THE VALUES):

nfs-server.domain:/path-to-share /path-to-local-mnt-dir nfs4 auto 0 0

Auto mount

Unlike the static mount option it is possible to automatically mount the share when accessed. Therefor it is necessary to install autofs:

apt-get install autofs

Afterwards add following line to /etc/auto.master (USE TABS BETWEEN THE VALUES):

/path-to-local-mnt-dir /etc/auto.name-of-share

Create /etc/auto.name-of-share and insert following (USE TABS BETWEEN THE VALUES):

* subdirectory-under-path-to-local-mnt-dir -fstype=nfs4 nfs-server.domain:/path-to-share

Verifie following settings in /etc/default/nfs-common:

NEED_IMAPD=yes 
NEED_GSSD=no

Reload /etc/init.d/autofs

/etc/init.d/autofs restart

Make sure it works

ls path-to-local-mnt-dir/subdirectory/


References

1. Release Notes Univention Corporate Server 3.2: http://docs.univention.de/release-notes-3.2-en.html#idp3973216
2. https://help.ubuntu.com/community/SettingUpNFSHowTo
3. https://help.ubuntu.com/community/Autofs

Personal tools