Difference between revisions of "Sds-hd nfs"

From bwHPC Wiki
Jump to: navigation, search
m
(Redirected page to SDS@hd)
(Tag: New redirect)
 
(27 intermediate revisions by one other user not shown)
Line 1: Line 1:
  +
#REDIRECT [[SDS@hd]]
<H1>Using NFSv4 for UNIX client</H1>
 
'''Attention:''' To access data served by SDS@hd, you need a '''''Service Password'''''. Please set your '' '''Service Password''' '' under following site: https://bwservices.uni-heidelberg.de
 
<br>
 
 
<H2>Prequisites</H2>
 
NFS access to the SDS@hd service is machine-based. This means that each nfs client has to be enabled individually for the service (and thus access to one or more storage projects).
 
 
*In order for the Kerberos authentication to work, a properly synchronized time must be set on each nfs client, i.e. by:
 
<pre>ntpdate ntp01.urz.uni-heidelberg.de</pre>
 
* The local hostname of the client must match the valid DNS hostname, as the credentials for Kerberos are only valid for this
 
* Valid access data for the nfs-client (keytab). These can be obtained directly from the [mailto:sds-hd-support@urz.uni-heidelberg.de SDS@hd support team ] after '''registration of the machine'''
 
* (optional) A CA certificate for ''bwservices.uni-heidelberg.de'' to connect to the LDAP. This can be downloaded directly [https://sds-hd.urz.uni-heidelberg.de/management/html/GSchain_bwservices.pem *here* ].
 
<br />
 
 
Authentication for data access via NFSv4 is performed using Kerberostickets. This requires a functioning Kerberos environment on the client.
 
 
<H2>NFS & Kerberos Configuration:</H2>
 
 
You have to install the following packages on your client machine and update some configuration files, to enable nfs with kerberos authentication.
 
 
''RedHat/CentOS:''
 
<pre>
 
> yum install krb5-workstation nfs-utils nfs4-acl-tools
 
 
edit the file: '/etc/sysconfig/nfs' and change:
 
NEED_IDMAPD=yes
 
NEED_GSSD=yes
 
close and save the file
 
</pre>
 
 
''Debian/Ubuntu:''
 
<pre>
 
> apt-get install krb5-user nfs-common nfs4-acl-tools nfs-server
 
 
edit the file: '/etc/default/nfs-common' and change:
 
NEED_IDMAPD=yes
 
NEED_GSSD=yes
 
close and save the file
 
</pre>
 
 
''/etc/krb5.conf:''
 
<pre>
 
[libdefaults]
 
default_realm = BWSERVICES.UNI-HEIDELBERG.DE
 
 
[realms]
 
BWSERVICES.UNI-HEIDELBERG.DE= {
 
kdc = bwservices.uni-heidelberg.de
 
admin_server = bwservices.uni-heidelberg.de
 
}
 
[domain_realm]
 
.uni-heidelberg.de = BWSERVICES.UNI-HEIDELBERG.DE
 
uni-heidelberg.de = BWSERVICES.UNI-HEIDELBERG.DE
 
</pre>
 
 
The keytab belonging to the machine must then be stored as ''/etc/krb5.keytab''. You get this keytab from [mailto:sds-hd-support@urz.uni-heidelberg.de SDS@hd support team ].
 
 
<H2>mount a nfs share</H2>
 
The usual restrictions for mounting drives under Linux are valid. Usually this can only be done by the superuser "root". For detailed information, please contact the system administrator of your system.
 
 
After successfull configuration you can mount your SDS@hd share with the following commands:
 
<pre>
 
> mkdir mountpoint
 
> mount -t nfs4 -o sec=krb5 lsdf02export.urz.uni-heidelberg.de:/gpfs/lsdf02/ mountpoint
 
</pre>
 
 
<H2>access your data</H2>
 
'''Attention!''' The access can not be done as root user, because root uses the Kerberosticket of the machine, which does not have data access!
 
 
To access your data on SDS@hd you need an valid kerberos ticket:
 
<pre>
 
> kinit hd_xy123
 
Password for hd_xy123@BWSERVICES.UNI-HEIDELBERG.DE:
 
> klist
 
Ticket cache: FILE:/tmp/krb5cc_1000
 
Default principal: hd_xy123@BWSERVICES.UNI-HEIDELBERG.DE
 
 
Valid starting Expires Service principal
 
20.09.2017 04:00:01 21.09.2017 04:00:01 krbtgt/BWSERVICES.UNI-HEIDELBERG.DE@BWSERVICES.UNI-HEIDELBERG.DE
 
renew until 29.09.2017 13:38:49
 
 
> ls mountpoint
 
sd16j007 sd17c010 sd17d005
 
</pre>
 
 
<H3>renew a kerberos ticket</H3>
 
Because a kerberos ticket has a limited lifetime (default: 10 hours, maximum 24 hours) for security reasons, you have renew your ticket before it expires to prevent access lost.
 
<pre>
 
> kinit -R
 
</pre>
 
 
<H3>ID Mapping</H3>
 
~ to be continued ~
 
<hr>
 
<br>
 
<br>
 
<br>
 
<br>
 
[[Category:Sds-hd|NFS|Kerberos]]
 

Latest revision as of 16:49, 19 August 2022

Redirect to: