Differences

This shows you the differences between two versions of the page.

--- efa_v4_to_v5_migration_guide [2024/05/04 12:49] – created spammy
+++ efa_v4_to_v5_migration_guide [2024/07/20 12:45] (current) – [v5 Appliance Preparation] spammy
@@ Line 8: / Line 8: @@
   - Initial preparation (fact gathering)
-  - Preparing v3 appliance
+  - Preparing v4 appliance
-  - Preparing the v4 appliance
+  - Preparing the v5 appliance
-  - Shutting down the v3 appliance
+  - Shutting down the v4 appliance
-  - Configuring the v4 appliance and running a restore
+  - Configuring the v5 appliance and running a restore
 If successful, all databases will be transferred to v5 with upgraded schema and compatible settings will be transferred.
@@ Line 24: / Line 24: @@
   * domain name
   * admin email
-  (hint:  look in /etc/eFa-Config for these facts 8-) )
+  (hint:  look in /etc/eFa/eFa-Config for these facts 8-) )
 ===== v4 Appliance Preparation =====
   - Log into v4 console
+  - Make sure you are up to date, install any missing updates
   - Enter Maintenance Mode
   - Drop to shell
   - sudo systemctl stop postfix (to halt mail flow)
-  - sudo eFa-Backup -backup
+  - sudo eFa-Backup-cron -backup
   - sudo chmod -R o+r /var/spool/MailScanner/quarantine (to loosen permissions for copy)
-  - sudo chmod -R o+r /var/EFA/backup/* (to loosen permissions for copy)
+  - sudo chmod -R o+r /var/eFa/backup/* (to loosen permissions for copy)
   - sudo sa-learn --backup > /root/backup.txt
+  - sudo ls /var/eFa/backup (get the name of the backup file for the next steps)
-===== v4 Appliance Preparation =====
+===== v5 Appliance Preparation =====
   - Build a v5 using any means with sufficient storage
   - Do not set it up yet (if no DHCP, set a temporary static IP using NetworkManager, nmtui or nmcli)
   - Start eFa first-time configure (Y/n) -> n
-  - dnf install sshfs
+  - rsync -av <v4user>@<v4ipaddress>:/var/eFa/backup/<nameofbackup> /var/eFa/backup (where <nameofbackup> is the name of the backup you generated during v4 preparation)
-  - sshfs <nameofv4user>@<ipaddress>:/ /mnt
-  - cp /mnt/var/EFA/backup/<nameofbackup> /var/eFa/backup (where <nameofbackup> is the name of the backup you generated during v4 preparation)
   - chmod 600 /var/eFa/backup/<nameofbackup>     (secure the backup file)
   - chown root:root /var/eFa/backup/<nameofbackup>  (secure the backup file)
-  - cp /mnt/root/backup.txt /root/backup.txt
+  - rsync -av <v4user>@<v4ipaddress>:/root/backup.txt /root
 The following steps apply if you want to keep your quarantine
-  - cp -ra /mnt/var/spool/MailScanner/quarantine/* /var/spool/MailScanner/quarantine (transfers entire quarantine to new appliance, if prompted for overwrite, answer no)
+  - rsync -rav <v4user>@<v4ipaddress>:/var/spool/MailScanner/quarantine/* /var/spool/MailScanner/quarantine
   - chmod -R o-rwx /var/spool/MailScanner/quarantine/*
   - chown -R postfix:mtagroup /var/spool/MailScanner/quarantine/*