Skip to end of metadata
Go to start of metadata

FileWave Server Backup

Summary

Backing up your FileWave server is always a good idea. Back in '97 a friend of mine spilled a pot of coffee on our server rack; you never know when bad things can happen to your hardware. Now, it's bad enough to lose the hardware, but think of all the hours represented by those perfected, irreplaceable FileWave Filesets! In order to prevent this disastrous loss, we have created a script to automatically back up your FileWave Server's database and data files, you can also run these scripts manually if you want. 

Current Version

macOS / Linux: backup_server_osx_linux.sh.zip

Windows: backupScriptv2.zip

Due to the nature of the FileWave databases, using active backup solutions, such as Time Machine or CrashPlan, can corrupt the FW DB.

Updating the backup script 

If you already have a backup scheduled on macOS or Linux, all you need to do is to replace the script you are already using with the new version as shown.
First, let's find out where your existing backup script is located: 

sudo crontab -l|awk {'print $6'}

Will show you a line like : 

/root/scripts/backup_server_osx_linux.sh

This will show you where to place the file on your server. Please replace '/root/scripts/backup_server_osx_linux.sh'  in the last two lines of the instructions below with what was returned to you by the last command before running the following:   

curl -O https://kb.filewave.com/download/attachments/920198/backup_server_osx_linux.sh.zip
unzip backup_server_osx_linux.sh.zip
mv backup_server_osx_linux.sh /root/scripts/backup_server_osx_linux.sh
chmod a+x /root/scripts/backup_server_osx_linux.sh


Legacy Versions

FileWave Server Backup Script for version 3.x

FileWave Server Backup Script for version 4.x

FileWave Server Backup Script for version 5.6.x or older


FileWave Server Backup Script for version 5.7 through 10.1.1

(compatible with Mac and Linux)

FileWave Server Backup Script for version 5.7 through 10.1.1

( Windows )


Note: If you move the Data Folder to another network share please make sure to update the path as well in the Backup Script.

On Mac OS X and Linux

Before you start, please ensure that the script has the execution permission (chmod 755).
The script is used to schedule backups or to run a backup manually. The first parameter passed to the script (required parameter) is "setup" or "run"

Automatic Backup

Use "setup" parameter to schedule a backup task to run either weekly or daily. The second parameter options are [weekly | daily] and the third is the path to the back folder.

Examples: (Please use the full path to the script)

/path_to_script/backup_server.sh setup daily "/Volumes/backupFolder" 
/path_to_script/backup_server.sh setup weekly "/Volumes/backupFolder"

Manual Backup

Use "run" parameter to run the backup manually right now. The second parameter is the backup folder and the third parameter is the task mode "manual". The script has to know that it is running manually and not from a cron job.

Examples:

/path_to_script/backup_server.sh run "/Volumes/backupFolder" manual

On Windows

The Windows script takes two parameters, the path to the backup folder and then the frequency which can one of these three options [ daily | weekly | now ]

Automatic Backup

Here is an example that shows how you can schedule a daily backup task. (Please use the full path to the script)

C:\_path_to_backup_\backup.bat "D:\MyFolder\FileWave Backups" daily

Manual Backup

You can run the backup manually by providing the "now" parameter. This can be useful before you upgrade your FileWave server to a newer version.

Example: (Please use the full path to the script)

C:\_path_to_backup_\backup.bat "D:\MyFolder\FileWave Backups" now

Backup log file

The log is saved by default to "C:\ProgramData\FileWave\FWServer\fwxserver_backup.log"
If you want to change the path, edit the script and change the variable "logFile".

Note: If you change the path to the server log file which "fwxserver.log", your backup will not work because the script will complain that the file is already in use by another process.

Checking Automatic Backups

Please make sure to check your Automated backups periodically to make sure they are still running successfully. The main thing to check is to unzip your most recent zip folder created by the backup and check that inside you see a “certs” folder, “DB” folder, httpd.conf, httpd_custom.conf, mdm_auth.conf, and a passwords file. You would also want to make sure that inside the DB folder that is created you see a “mdm-dump.sql” file and the size of the file is not showing as 0 bytes.