Migrating from v4 to v5 is possible using the backup and restore functionality of eFa.

The process involves doing the following:

1. Initial preparation (fact gathering)
2. Preparing v3 appliance
3. Preparing the v4 appliance
4. Shutting down the v3 appliance
5. Configuring the v4 appliance and running a restore

If successful, all databases will be transferred to v5 with upgraded schema and compatible settings will be transferred.

Before migrating, please document the following on your v4 appliance:

• Username used to log into console
• IP address, netmask, and default gateway
• hostname
• domain name
• admin email

(hint: look in /etc/eFa-Config for these facts )

1. Log into v4 console
2. Enter Maintenance Mode
3. Drop to shell
4. sudo systemctl stop postfix (to halt mail flow)
5. sudo eFa-Backup -backup
6. sudo chmod -R o+r /var/spool/MailScanner/quarantine (to loosen permissions for copy)
7. sudo chmod -R o+r /var/EFA/backup/* (to loosen permissions for copy)
8. sudo sa-learn –backup > /root/backup.txt

1. Build a v5 using any means with sufficient storage
2. Do not set it up yet (if no DHCP, set a temporary static IP using NetworkManager, nmtui or nmcli)
3. Start eFa first-time configure (Y/n) → n
4. dnf install sshfs
5. sshfs <nameofv4user>@<ipaddress>:/ /mnt
6. cp /mnt/var/EFA/backup/<nameofbackup> /var/eFa/backup (where <nameofbackup> is the name of the backup you generated during v4 preparation)
7. chmod 600 /var/eFa/backup/<nameofbackup> (secure the backup file)
8. chown root:root /var/eFa/backup/<nameofbackup> (secure the backup file)
9. cp /mnt/root/backup.txt /root/backup.txt

The following steps apply if you want to keep your quarantine

1. cp -ra /mnt/var/spool/MailScanner/quarantine/* /var/spool/MailScanner/quarantine (transfers entire quarantine to new appliance, if prompted for overwrite, answer no)
2. chmod -R o-rwx /var/spool/MailScanner/quarantine/*
3. chown -R postfix:mtagroup /var/spool/MailScanner/quarantine/*

• Grab any other custom configs or files you might need
• Shut it down
• sudo shutdown -h now

• Run through initial setup via GUI or command line (log out and log back in, use same settings as the v4)
• Let system reboot
• Log into console
• 12) System Restore (Answer yes, 1, yes)
• Let system reboot
• Log into console and drop to shell

If your bayes database is blank in the MailWatch GUI after migration, run this:

• sudo sa-learn –clear
• sudo sa-learn –restore /root/backup.txt

If you use 3rd party virus scanners, those will need to be installed on the new appliance.