User Tools

Site Tools


migration_guide_from_v3_to_v4

This is an old revision of the document!


Migration Guide from eFa v3 to eFa v4 (Live Migration)

Preparation

Before migrating, please document the following on your v3 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 8-) )

v3 Appliance Preparation

  1. Log into v3 console
  2. Enter Maintenance Mode
  3. Drop to shell
  4. sudo service postfix stop (to halt mail flow)
  5. (backup and/or snapshot the v3 appliance now)
  6. sudo chmod +x /usr/local/sbin/EFA-Backup
  7. sudo /usr/local/sbin/EFA-Backup -backup
  8. sudo chmod -R 775 /var/spool/MailScanner/quarantine (to loosen permissions for copy)

If you are using opendkim, do the following

  1. sudo chmod -R 775 /etc/opendkim/* (only if you are using opendkim)

v4 Appliance Preparation

  1. Build a v4 testing using any means with sufficient storage
  2. Do not set it up yet (if no DHCP, set a temporary static IP in /etc/sysconfig/network-scripts)
  3. Start eFa first-time configure (Y/n) → n
  4. yum install sshfs
  5. sshfs <nameofv3user>@<ipaddress>:/ /mnt
  6. cp -ra /mnt/var/spool/MailScanner/quarantine/* /var/spool/MailScanner/quarantine (transfers entire quarantine to new appliance, if prompted for overwrite, answer no)
  7. chmod -R 750 /var/spool/MailScanner/quarantine/*
  8. chown -R postfix:mtagroup /var/spool/MailScanner/quarantine/*
  9. cp /mnt/var/EFA/backup/<nameofbackup> /var/eFa/backup (where <nameofbackup> is the name of the backup you generated during v3 preparation)

The following steps apply if you are using opendkim

  1. yum -y install opendkim
  2. mkdir -p /etc/opendkim
  3. cp -ra /mnt/etc/opendkim/* /etc/opendkim (answer yes to overwrite)
  4. chown -R opendkim:opendkim /etc/opendkim/*
  5. chmod -R 750 /etc/opendkim/*
  6. cp /mnt/etc/opendkim.conf /etc/opendkim.conf (answer yes to overwrite)

v3 Appliance Decommission

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

v4 Commission

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

The following steps apply if you are using opendkim

  • /etc/postfix/main.cf:
    • smtpd_milters = inet:127.0.0.1:8891 inet:127.0.0.1:33333
    • non_smtpd_milters: inet:127.0.0.1:8891
  • sudo systemctl enable opendkim
  • sudo systemctl start opendkim
  • sudo systemctl reload postfix
migration_guide_from_v3_to_v4.1549125243.txt.gz · Last modified: 2019/02/02 16:34 by spammy