Skip to main content
Delphix

How to Test NFS Mounting from Target Hosts (KBA5873)

  1. Last updated
  2. Save as PDF
 

 

KBA

KBA# 5873

Applicable Delphix Versions

Click here to view the versions of the Delphix engine to which this article applies
Major Release All Sub Releases
6.0 6.0.0.0, 6.0.1.0, 6.0.1.1, 6.0.2.0, 6.0.3.0, 6.0.3.1, 6.0.4.0, 6.0.4.1, 6.0.4.2, 6.0.5.0, 6.0.6.0, 6.0.7.0, 6.0.8.0, 6.0.8.1, 6.0.9.0, 6.0.10.0, 6.0.10.1, 6.0.11.0, 6.0.12.0, 6.0.12.1, 6.0.13.0, 6.0.13.1, 6.0.14.0, 6.0.15.0, 6.0.16.0

5.3

 5.3.0.0, 5.3.0.1, 5.3.0.2, 5.3.0.3, 5.3.1.0, 5.3.1.1, 5.3.1.2, 5.3.2.0, 5.3.3.0, 5.3.3.1, 5.3.4.0, 5.3.5.0 5.3.6.0, 5.3.7.0, 5.3.7.1, 5.3.8.0, 5.3.8.1, 5.3.9.0

5.2

5.2.2.0, 5.2.2.1, 5.2.3.0, 5.2.4.0, 5.2.5.0, 5.2.5.1, 5.2.6.0, 5.2.6.1

5.1

5.1.0.0, 5.1.1.0, 5.1.2.0, 5.1.3.0, 5.1.4.0, 5.1.5.0, 5.1.5.1, 5.1.6.0, 5.1.7.0, 5.1.8.0, 5.1.8.1, 5.1.9.0, 5.1.10.0

How to Test NFS Mounting

Delphix virtualization exposes the datasets to unix hosts using NFS. For this reason a functional NFS client is essential for any target host.

Each Delphix Engine provides a method to test the NFS services without performing a provision. In versions prior to 6.0.16.0, this is done manually by mounting a static filesystem "public" exported from the Delphix Engine. In Delphix 6.0.16.0, a nfsChecks operation has been added to the Delphix CLI.

In the event of mount failures during VDB operations, these test NFS shares can also be used as part of manual troubleshooting to confirm that NFS mounting is working correctly for the Delphix OS user on that host.  Details of how to manually mount this NFS share on a target host are provided in this document.

Prerequisites

The NFS share is used to test NFS mounting on target hosts running Linux or UNIX.  Delphix does not use NFS with Windows target hosts.

This document assumes that 'sudo' is being used to provide a privilege elevation capability on the target host.  If instead another privilege elevation tool is being used, substitute the appropriate command into the examples below in place of 'sudo'.

The Delphix OS user on the target host must be configured with the appropriate privilege elevation permissions to be able to run the 'mount' command with the required options.  Sample sudo configuration entries are available in the Delphix documentation, for example Sudo File Configuration Examples for Oracle Environments.

A suitable mountpoint directory must be created for the test mount.  The examples below use /mnt/delphix/test but this should be changed as appropriate for your environment.  The Delphix OS user must have sudo privileges to be able to mount filesystems to the chosen mountpoint directory.

To Test NFS Mounting before 6.0.16.0

The following commands can be run as the Delphix OS user to mount the public test share on the target host.  Provide the IP address or fully qualified domain name of the Delphix engine in place of delphix_engine_ipaddr.

Linux:

sudo /bin/mount -o nosuid,tcp,vers=3 delphix_engine_ipaddr:/public /mnt/delphix/test

Solaris / AIX:

sudo /usr/sbin/mount -o nosuid,proto=tcp,vers=3 delphix_engine_ipaddr:/public /mnt/delphix/test

HP-UX:

sudo /sbin/mount -o nosuid,proto=tcp,vers=3 delphix_engine_ipaddr:/public /mnt/delphix/test


To unmount the NFS filesystem after testing:

Linux:

sudo /bin/umount /mnt/delphix/test

Solaris / AIX / HP-UX:

sudo /usr/sbin/umount /mnt/delphix/test

 

To Test NFS Mounting after 6.0.16.0

Delphix versions after 6.0.16.0 no longer exposes the "public" nfs export, instead a temporary filesystem is created and exported to the target hosts for the duration of the test only.

To test NFS mounts after this version the nfsChecks operation should be used. 

  1. Login to the Delphix CLI.
  2. Under the "Environment" path, select the appropriate environment.
  3. The mount path must be provided. Delphix will attempt to create this if it does not already exist.
test-6.0.16.0> /environment/
test-6.0.16.0 environment> select myTargetEnvironment
test-6.0.16.0 environment 'myTargetEnvironment'> nfsChecks
test-6.0.16.0 environment 'myTargetEnvironment' nfsChecks *> set mountPath=/mnt/provision
test-6.0.16.0 environment 'myTargetEnvironment' nfsChecks *> commit
  1. Check the output for success.
    UNIX_HOST_ENVIRONMENT-1
    Dispatched job JOB-10
    ENVIRONMENT_NFS_CHECKS job started for "myTargetEnvironment".
    Running NFS checks on host "10.43.41.135" with user "oracle"
    Exporting storage containers from the Delphix Engine.
    Mounting datasets.
    Unmounting datasets.
    ENVIRONMENT_NFS_CHECKS job for "myTargetEnvironment" completed successfully.

This can also be verified by enabling rpcdebug nfs mount on the target host and monitoring the appropriate logs.

[root@mwrhel-8 log]# rpcdebug -m nfs mount
nfs        mount

[root@mwrhel-8 log]# tail -f messages
Jul 23 22:08:42 mwrhel-8 kernel: NFS: nfs mount opts='fg,hard,rsize=1048576,wsize=1048576,nointr,timeo=600,sec=sys,tcp,noacl,vers=4.2,addr=10.43.32.234,clientaddr=10.43.41.135'
Jul 23 22:08:42 mwrhel-8 kernel: NFS:   parsing nfs mount option 'fg'
Jul 23 22:08:42 mwrhel-8 kernel: NFS:   ignoring mount option 'fg'
Jul 23 22:08:42 mwrhel-8 kernel: NFS:   parsing nfs mount option 'hard'
Jul 23 22:08:42 mwrhel-8 kernel: NFS:   parsing nfs mount option 'rsize=1048576'
Jul 23 22:08:42 mwrhel-8 kernel: NFS:   parsing nfs mount option 'wsize=1048576'
Jul 23 22:08:42 mwrhel-8 kernel: NFS:   parsing nfs mount option 'nointr'
Jul 23 22:08:42 mwrhel-8 kernel: NFS:   ignoring mount option 'nointr'
Jul 23 22:08:42 mwrhel-8 kernel: NFS:   parsing nfs mount option 'timeo=600'
Jul 23 22:08:42 mwrhel-8 kernel: NFS:   parsing nfs mount option 'sec=sys'
Jul 23 22:08:42 mwrhel-8 kernel: NFS: parsing sec=sys option
Jul 23 22:08:42 mwrhel-8 kernel: NFS:   parsing nfs mount option 'tcp'
Jul 23 22:08:42 mwrhel-8 kernel: NFS:   parsing nfs mount option 'noacl'
Jul 23 22:08:42 mwrhel-8 kernel: NFS:   parsing nfs mount option 'vers=4.2'
Jul 23 22:08:42 mwrhel-8 kernel: NFS:   parsing nfs mount option 'addr=10.43.32.234'
Jul 23 22:08:42 mwrhel-8 kernel: NFS:   parsing nfs mount option 'clientaddr=10.43.41.135'
Jul 23 22:08:42 mwrhel-8 kernel: NFS: MNTPATH: '/public/UNIX_HOST_ENVIRONMENT-1'

The temporary public mount path can be observed, note that this will not be exported to the target host once the test is complete.

 

important

Important:

From Delphix version 6.0.2.0 onwards and for target host operating systems that support NFSv4 (see NFSv4 Configuration for details of NFSv4 support), mounts using this protocol version can be tested by changing 'vers=3' to 'vers=4' in the above commands.

 

Related Articles

The following articles may provide more information or related information to this article:

 

Privacy Policy Terms of Use Legal About
© 2024 Delphix Corp