Versions Compared

Old Version 13

changes.mady.by.user Bala Harish A(AC)

Saved on

compared with

New Version Current

changes.mady.by.user Bala Harish A(AC)

Saved on

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.
Table of Contents
minLevel1
maxLevel2
outlinefalse
typelist
printablefalse

...

Info

Important

  • VMs - Where write performance is critical, install the SwarmFS server on physical hardware (not as a VM). 

  • Paging - Paging negatively impacts performance. If paging out does occur, increase RAM rather than increasing disk space for paging. 

  • Debug - When mounting exports directly on the SwarmFS server, do not enable verbose (DEBUG) logging.

  • Shared Writes - Linux UMASK (User file creation MASK) defaults to 0022, so directories are created with the permissions 755. The owner may write to the file. To share file writes among multiple users of the same group, change the permissions on the folder, or set the UMASK to 0002 so it applies to all newly created folders. Add it to /etc/.bashrc or /etc/profile to persist changes across reboots.

...

  1. Download the SwarmFS package from the Downloads section on the DataCore Support Portal.

  2. Install the EPEL release, which has the needed packages for NFS:

    Code Block
    languagebash
    yum -y install epel-release

  3. Some later EPEL releases are missing the needed Ganesha and Ganesha utility packages, so install those:

    1. Navigate to the NFS community build service.

    2. Scroll down to the RPMs list and download both packages:

      • nfs-ganesha-<version>.rpm

      • nfs-ganesha-utils-<version>.rpm

    3. Install both packages:

      Code Block
      languagebash
      yum -y install nfs-ganesha-<version>.rpm
yum -y install nfs-ganesha-utils-<version>.rpm

  4. Install the Swarm RPMs:

    Code Block
    languagebash
    yum install caringo-nfs-libs-<version>.rpm
yum install caringo-nfs-<version>.rpm

  5. Run the SwarmFS configuration shell script that generates the local SwarmFS service configuration, validates the environment, enables the SwarmFS services, and then starts the SwarmFS services.

    1. Login to Swarm UI, and navigate to Settings → NFS.

    2. Click Add Server Group to create a new NFS Exports Group.

    3. Provide the name of the group (e.g., SwarmFS) and click Add Group.

    4. Click the link of the newly created NFS Export Group, to open a new window or tab.

    5. The opened window or tab shows export configure (in JSON format), copy the URL.

    6. Run the script.
      SwarmNFS-Config

    7. Open the SwarmNFS-Config wizard.
      [root@swarmfs32-01 ~]# SwarmNFS-config

    8. Paste the URL “http://{gateway_ip}:91/api/nfs/configurations/_plain/1?sptid=244ee2c5072d9f0888a13d31d007c6cf37121369ca35636a4b4486c82e1e1e3a”.

    9. Update the URL of nfs-ganesha configuration (/etc/ganesha/ganesha.caringo.conf) with credentials followed by @.
      Configuration="http://dcadmin:datacore@{gateway_ip}:91/api/nfs/configurations/_plain/1?sptid=244ee2c5072d9f0888a13d31d007c6cf37121369ca35636a4b4486c82e1e1e3a "
      Here the credentials are:

      1. username - dcadmin

      2. password - datacore

    10. Restart nfs-ganesha service.
      systemctl restart nfs-ganesha

  6. Enable the service to allow SwarmFS to start automatically on boot:

    Code Block
    languagebash
    systemctl enable /usr/lib/systemd/system/nfs-ganesha.service

  7. Run this command to verify the status of the services:

    Code Block
    languagebash
    systemctl status nfs-ganesha

    This status report is comprehensive and includes which processes are running.

...