Skip to end of metadata
Go to start of metadata

Requirements: 

  • FileWave Server 13.1.5+
  • Existing mount the external drive or network share
  • Root access to Terminal

Summary

Many customers have asked us if there's a way to store their Server's data on a non-startup volume or on network shares.

Here you will find instructions for linking the Server's Data Folder to another location on macOS/Linux. You may follow these same steps for the Booster, accounting for small differences in folder names.



Before making any changes, please ensure you have a backup. If you're using a VM, please stop services and take a snapshot of the VM. If you're not able to take a snapshot, use the Backup script. You can find more information, and the script, here: Automated Backup

macOS/Linux

Step One: Stop the FileWave Server


Whenever doing any manipulation of the Server's Data Folder, you will need to stop FileWave's services first. You can do this by using the 'fwcontrol' command-line tool.

Command:
sudo fwcontrol server stop


Step Two: Move your Data Folder to another Volume


Move the Data Folder to your destination/mount point:

Command
sudo mv /usr/local/filewave/fwxserver/Data\ Folder /Path/to/Destination/


For those doing this with a Booster, the Booster data folder is in /var/FileWave/FWBooster.

Step Three: Create a link to your new data folder

Here we're creating a symlink to the recently moved Data Folder back to the original location. The FileWave processes will still look at the original location for the Data Folder and the symlink will redirect it to the new location.


Command
sudo ln -s /Path/To/Destination/Data\ Folder /usr/local/filewave/fwxserver/


Step Four: Check the Link 

Now that the link is established, we can check that it was made correctly. First, navigate to the original Data Folder location

Command
cd /usr/local/filewave/fwxserver

Then view details about that destination

Command
ls -lha

You should see the Data Folder symlink, which is the Data Folder directory with an arrow pointing to the 'real' location

For example:

Step Five: Start the Server

Restart FileWave Services

Command
sudo fwcontrol server start


Now you're all set!