Line 1: |
Line 1: |
| {{Languages|Affa}} | | {{Languages|Affa}} |
| + | |
| + | {{Warning box| 1st Sept 2022 A recent fix to rsync rsync-3.1.2-11.el7_9.x86_64 causes Affa to silently fail. See below.}} |
| + | |
| {{Level|Advanced}} | | {{Level|Advanced}} |
| + | |
| + | ===Warning=== |
| + | |
| + | {{Warning box| rsync-3.1.2-11.el7_9.x86_64 causes Affa to silently fail.}} |
| + | |
| + | You can see the failure in your logs but nothing beyond that. No files will be backed up after you have installed this update to rsync. |
| + | |
| + | See the link to Bug 12165 below. |
| + | |
| + | The only current fix is to downgrade rsync on the Affa server. It does not matter on the Target server. |
| + | |
| + | We are working on a solution and have test code running and will push a fix as soon as we can. |
| + | |
| + | Do please contact us on the bug if you want to help test. A fix will be available faster if you do. |
| + | |
| {{usefulnote}} | | {{usefulnote}} |
| | | |
Line 99: |
Line 117: |
| =For SME10= | | =For SME10= |
| | | |
− | There is a new development version 3.3.1 | + | There is a new version 3.3.1 |
| | | |
− | {{Warning box|This will almost certainly break both your old backups and your new server. ONLY use this in a test scenario until it is fully released}}
| + | However. Affa is a very complicated piece of work with a huge number of options and many have probably not been sufficiently tested depite requests for testing and feedback. Most of the major components should work but there may well be a plethora of edge cases that fail. |
| | | |
− | {{Warning box|Do not use the ANY Koozali SME v9 affa versions with v10. It will probably break both your backups and your new server}} | + | {{Warning box|Do not rely on this as your sole backup. Make sure you have another type of backup as well}} |
| | | |
− | Note that we KNOW that this is Alpha code and almost certainly will not work correctly and needs a lot of testing and fixes. See the Bugs below.
| + | {{Warning box|Do not use ANY Koozali SME v9 affa versions with v10. It will probably break both your backups and your new server}} |
| | | |
− | We have done NO testing on migration from v9 to v10. | + | We have done very minimal testing on migration from v9 to v10. |
| | | |
| See https://bugs.contribs.org/show_bug.cgi?id=11024 | | See https://bugs.contribs.org/show_bug.cgi?id=11024 |
| + | |
| | | |
| Under normal circumstances you would execute this to install : | | Under normal circumstances you would execute this to install : |
Line 118: |
Line 137: |
| | | |
| yum install --enablerepo=smecontribs,epel,openfusion smeserver-affa | | yum install --enablerepo=smecontribs,epel,openfusion smeserver-affa |
| + | |
| + | During development install can be executed with: |
| + | yum install --enablerepo=smedev,epel,openfusion smeserver-affa |
| + | |
| + | |
| | | |
| Please post bug reports in the [http://bugs.contribs.org bug tracker] | | Please post bug reports in the [http://bugs.contribs.org bug tracker] |
Line 123: |
Line 147: |
| <headertabs /> | | <headertabs /> |
| | | |
− | The server again need to be updated. | + | The server again needs to be updated. |
| signal-event post-upgrade | | signal-event post-upgrade |
| signal-event reboot | | signal-event reboot |
| The server will reboot. Afterwards Affa 3 is ready for use. | | The server will reboot. Afterwards Affa 3 is ready for use. |
| | | |
− | Now manually create directory for archive files (to be fixed):
| + | {{Warning box| Note that on SME10, a SSH [https://wiki.contribs.org/AutoBlock AutoBlock] feature interferes with the Affa requirement for regular SSH logins! You might have to disable this feature, aor increase the MaxAuthtries to allow Affa to operate correctly.}} |
− | mkdir /var/affa
| |
− | | |
− | {{Warning box| Note that on SME9, a new SSH [https://wiki.contribs.org/AutoBlock AutoBlock] feature interferes with the Affa requirement for regular SSH logins! You might have to disable this feature to allow Affa to operate correctly. }} | |
| | | |
| ===Creation of backup jobs=== | | ===Creation of backup jobs=== |
Line 801: |
Line 822: |
| ===SME Specific usage and command line options=== | | ===SME Specific usage and command line options=== |
| | | |
− | These commands are implemented in a fork of Affa 3 project for use with SME. They are not part of the Affa 3 for CentOS project. | + | These commands are implemented in a fork of Affa 3 project for use with SME. '''They are not part of the Affa 3 for CentOS project.''' |
| | | |
| ====SME server 'rise' function==== | | ====SME server 'rise' function==== |
Line 941: |
Line 962: |
| | | |
| =====Setup Affa===== | | =====Setup Affa===== |
− | You want to run backups on 11:30 h, 15:30 h and 19:30 h and you want to keep the last 3 scheduled backups, 7 daily, 5 weekly, 12 monthly and 1 yearly backups. | + | You want to run backups at 11:30 h, 15:30 h and 19:30 h and you want to keep the last 3 scheduled backups, 7 daily, 5 weekly, 12 monthly and 1 yearly backups. |
| | | |
| *log into the 'prodbox' and install the Affa packages as described above. | | *log into the 'prodbox' and install the Affa packages as described above. |
Line 1,015: |
Line 1,036: |
| | | |
| export RDIR=/home/e-smith/files/users/briedlin/Maildir/.orders/ ''# this variable is used to shorten the next command line'' | | export RDIR=/home/e-smith/files/users/briedlin/Maildir/.orders/ ''# this variable is used to shorten the next command line'' |
− | rsync -av -e 'ssh -p 2222' /var/affa/primmail/daily.0/$RDIR 10.204.48.1:$RDIR | + | rsync -av -e 'ssh -i /root/.ssh/id_rsa_affa -p 2222' /var/affa/primmail/daily.0/$RDIR 10.204.48.1:$RDIR |
| | | |
| | | |
Line 1,030: |
Line 1,051: |
| | | |
| export RFILE=/home/e-smith/files/ibays/docs/files/orderform.pdf ''# this variable is used to shorten the next command line'' | | export RFILE=/home/e-smith/files/ibays/docs/files/orderform.pdf ''# this variable is used to shorten the next command line'' |
− | rsync -av -e 'ssh -p 2222' /var/affa/prodserv/weekly.1/$RFILE 10.204.48.1:$RFILE | + | rsync -av -e 'ssh -i /root/.ssh/id_rsa_affa -p 2222' /var/affa/prodserv/weekly.1/$RFILE 10.204.48.1:$RFILE |
| | | |
| | | |
Line 1,042: |
Line 1,063: |
| If the servers are configured to use a different ssh port eg 2222, then instead do: | | If the servers are configured to use a different ssh port eg 2222, then instead do: |
| | | |
− | rsync -av -e 'ssh -p 2222' "/var/affa/fileshare/daily.4/home/e-smith/files/ibays/mechfiles/files/Valve Control (Design Gr)/VALVE LIST FOR ISSUED.xls" "192.168.1.7:/home/e-smith/files/ibays/mechfiles/files/Valve\\ Control\\ \(Design\\ Gr\)/VALVE\\ LIST\\ FOR\\ ISSUED.xls" | + | rsync -av -e 'ssh -i /root/.ssh/id_rsa_affa -p 2222' "/var/affa/fileshare/daily.4/home/e-smith/files/ibays/mechfiles/files/Valve Control (Design Gr)/VALVE LIST FOR ISSUED.xls" "192.168.1.7:/home/e-smith/files/ibays/mechfiles/files/Valve\\ Control\\ \(Design\\ Gr\)/VALVE\\ LIST\\ FOR\\ ISSUED.xls" |
| | | |
| ====Full restore==== | | ====Full restore==== |