othman.suseno/calypso
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity
Files
8a3ff6a12c720172880bee5de9808b72b0e7c145
calypso/docs/alpha/components/nfs/nfs_setup.md
Othman H. Suseno 7b91e0fd24 fix storage
2026-01-09 16:54:39 +00:00

2.3 KiB
Raw Blame History

NFS Service Setup Guide

This document outlines the steps taken to set up the NFS (Network File System) service on this machine, with a custom configuration file location.

Setup Steps

  1. Install NFS Server Package The nfs-kernel-server package was installed using apt-get:

    sudo apt-get install -y nfs-kernel-server

  2. Create Custom Configuration Directory A dedicated directory for NFS configuration files was created at /opt/calypso/conf/nfs/:

    sudo mkdir -p /opt/calypso/conf/nfs/

  3. Handle Default /etc/exports File The default /etc/exports file, which typically contains commented-out examples, was removed to prepare for the custom configuration:

    sudo rm /etc/exports

  4. Create Custom exports Configuration File A new exports file was created in the custom directory /opt/calypso/conf/nfs/exports. This file will be used to define NFS shares. Initially, it contains a placeholder comment:

    sudo echo "# NFS exports managed by Calypso

Add your NFS exports below. For example:

/path/to/share *(rw,sync,no_subtree_check)" > /opt/calypso/conf/nfs/exports

```
**Note:** You should edit this file (`/opt/calypso/conf/nfs/exports`) to define your actual NFS shares.

  1. Create Symbolic Link for /etc/exports A symbolic link was created from the standard /etc/exports path to the custom configuration file. This ensures that the NFS service looks for its configuration in the designated /opt/calypso/conf/nfs/exports location:

    sudo ln -s /opt/calypso/conf/nfs/exports /etc/exports

  2. Start NFS Kernel Server Service The NFS kernel server service was started:

    sudo systemctl start nfs-kernel-server

  3. Enable NFS Kernel Server on Boot The NFS service was enabled to start automatically every time the system boots:

    sudo systemctl enable nfs-kernel-server

How to Configure NFS Shares

To define your NFS shares, edit the file /opt/calypso/conf/nfs/exports. After making changes to this file, you must reload the NFS exports using the command:

sudo exportfs -ra

This ensures that the NFS server recognizes your new or modified shares without requiring a full service restart.