LiquidFiles Documentation
LiquidFiles Documentation

Using an external NFS server

To use an external NFS server with LiquidFiles, please follow the following steps.

First, to enable running NFS, please run the following command:

ft nfs_enable

All LiquidFiles file data is stored in /data. You need to move this data to the NFS server. Please stop the LiquidFiles appliance web application and web server:

systemctl stop puma
systemctl stop nginx

Continue to move the existing data and create a new NFS mount point and mount the NFS server:

mv /data /data.old
mkdir /data
chown _sfta:_sfta /data
mount server:/mount/point /data

(Replacing server:/mount/point with your NFS server details)

All files in the /data folder needs to be owned by the _sfta user which has the user id (uid) and group id (gid) of 900. If you configure any form of user or group restrictions on the NFS server, make sure that they match these requirements (when you're done, please run `ls -l /data` and everything should show up as _sfta owner and _sfta group or the application won't run properly).

You are now ready to copy all the data across to the NFS server:

cp -rp /data.old/* /data
chown -R _sfta:_sfta /data

This is likely going to take a while, depending on how much data you have stored.

When this has completed, you can start the server again with:

systemctl start puma
systemctl start nginx

If everything is working as expected, make sure that the NFS server gets mounted on each reboot by running the command:

echo "server:/mount/point /data nfs rw,nodev,nosuid 0 0" >> /etc/fstab

(Replacing server:/mount/point with your NFS server details)

That completes the setup of the NFS storage for the LiquidFiles appliance. When you're comfortable that everything is working, including after a reboot, you can delete the previous data folder with `rm -r /data.old`.