Skip to content

QUICKSTART.md

Latest commit

 

History

History
134 lines (89 loc) · 2.75 KB

QUICKSTART.md

File metadata and controls

134 lines (89 loc) · 2.75 KB
layout default
title NFS on RHEL/Rocky/AlmaLinux - Quick Start Guide

NFS on RHEL/Rocky/AlmaLinux - Quick Start Guide

This guide provides a streamlined path to configure NFS storage on RHEL-based systems.

📘 For detailed explanations, alternative configurations, and troubleshooting: See NFS Best Practices

{% include quickstart/disclaimer.md %}

Prerequisites

  • RHEL 8.x/9.x, Rocky Linux 8/9, AlmaLinux 8/9
  • Everpure FlashArray with:
    • NFS file interface configured
    • NFS export policy created with NFSv4.1 enabled (recommended)
    • Export path created (e.g., /data/rhel)
    • No root squash enabled for client IPs
  • Dedicated storage network interfaces (recommended)
  • Root or sudo access

Step 1: Install NFS Client

# Install NFS utilities
sudo dnf install -y nfs-utils

# Enable and start required services
sudo systemctl enable --now nfs-client.target
sudo systemctl enable --now rpcbind

Step 2: Verify Network Connectivity

{% include quickstart/nfs-verify-connectivity.md %}

Step 3: Configure Firewall

# Allow NFS client traffic (outbound typically allowed by default)
# If using strict firewall rules:
sudo firewall-cmd --permanent --add-service=nfs
sudo firewall-cmd --permanent --add-service=rpc-bind
sudo firewall-cmd --reload

Step 4: Create Mount Point and Mount NFS

# Create mount point
sudo mkdir -p /mnt/pure-nfs

# Mount with recommended options
sudo mount -t nfs4 -o vers=4.1,nconnect=4,noatime,nodiratime \
    <NFS_SERVER_IP>:/data/rhel /mnt/pure-nfs

# Verify mount
mount | grep nfs
df -h /mnt/pure-nfs

Step 5: Configure Persistent Mount

Add to /etc/fstab for automatic mounting at boot:

# Add fstab entry
echo '<NFS_SERVER_IP>:/data/rhel /mnt/pure-nfs nfs4 vers=4.1,hard,timeo=300,retrans=2,nconnect=4,noatime,nodiratime,_netdev 0 0' | sudo tee -a /etc/fstab

# Test fstab entry
sudo umount /mnt/pure-nfs
sudo mount -a

# Verify
mount | grep nfs

{% include quickstart/nfs-mount-options.md %}

Step 6: Verify NFS Mount

{% include quickstart/nfs-verify-mount.md %}

Quick Reference

{% include quickstart/nfs-quick-reference.md %}

Troubleshooting

{% include quickstart/nfs-troubleshooting.md %}

SELinux-specific:

# Check SELinux (if enabled)
sudo setsebool -P use_nfs_home_dirs 1

Next Steps

For production deployments, see NFS Best Practices for:

  • Network bonding and redundancy
  • Performance tuning with nconnect
  • SELinux configuration
  • Monitoring and troubleshooting

Related Guides: