Skip to main content
Delphix

Resolving "validation of user environment failed" errors on NFSv4-only Linux Target environments (KBA9556)

 

 

KBA

KBA# 9556

 

Issue

On Linux Target Environments where NFSv3 and RPC services have been explicitly disabled, VDB operations may fail with the following errors:

Environment validation failed for environment "My_Environment" host "myhost.mydomain". Cause: Validation of user environment failed.

or

SOURCE_START job for "MyVDB" failed due to an error during execution: Failed to mount "MyVDB" because the mount command executed as user "delphix" on host "myhost.mydomain" failed for mount point

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.2.0, 6.0.2.1, 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.6.1, 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

Background

To validate whether NFSv4 is available on Linux Target Environments, the Continuous Data Engine queries the sysfs filesystem to gather more information about the NFS configuration:

cat /sys/module/nfs/parameters/recover_lost_locks

In cases where the NFS kernel module has been completely blocked from loading at startup - for example, when following the NFS4 only steps from Red Hat's documentation, the above command will return a no such file or directory error.

Resolution

To resolve this issue, it may be necessary for a system administrator to ensure that the NFS kernel module is loaded on the affected Target Environment:

sudo modprobe nfs

This will persist until the host is next rebooted.

This can also be configured in the "modules-load" daemon, to ensure that the NFS module is loaded on each subsequent host reboot:

# cat > /etc/modules-load.d/nfs.conf
nfs

Note that, for NFSv4 to be used, all other prerequisites from the documentation NFSv4 Configuration and Target Host OS and Database Configuration Options must also be met.

 

 


Related Articles

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