28
edits
Changes
From SME Server
Jump to navigationJump to searchFirst updates for Affa 3 installation
{{Languages|Affa}}
{{Languages|Affa}}
{{Level|Advanced}}
{{Level|Advanced}}
{{Warning box| This code is deprecated and unmaintained. smeserver-affa has a waiting list of 32 open bugs -see link below. And a lot of unpredictable bugs are associated or related with the use of Affa after restoration or rise, such as missing groups, service crash, CGI errors}}
{{Warning box| Affa version 2.x code is deprecated and unmaintained. smeserver-affa has a waiting list of 32 open bugs -see link below. And a lot of unpredictable bugs are associated or related with the use of Affa after restoration or rise, such as missing groups, service crash, CGI errors}}
{{usefulnote}}
{{usefulnote}}
October 2014 - Some work has recently been carried out on smeserver-affa v2 to fix some of the bugs, see [http://bugs.contribs.org/buglist.cgi?action=wrap&bug_status=UNCONFIRMED&bug_status=CONFIRMED&bug_status=NEEDINFO&bug_status=IN_PROGRESS&bug_status=RESOLVED&bug_status=VERIFIED&classification=Contribs&component=smeserver-affa%20%28unmaintained%29&list_id=22153&product=SME%20Contribs&resolution=---&resolution=FIXED&resolution=NOTABUG&resolution=WONTFIX&resolution=UPSTREAM&resolution=DUPLICATE&resolution=WORKSFORME&saved_report_id=1 smeserver-affa Bugs]. A new Affa version 3 is available on [http://affa.sourceforge.net/ Sourceforge]. Additional features helpful for SME have been ported by [http://www.guedel.eu/index.php/info-matique/sme-server/affa-v3 Arnaud]. Keep in mind that Affa 3 is not fully tested up to now. Please also check [http://bugs.contribs.org/show_bug.cgi?id=7633 SME server Affa v3 development] .
[http://bugs.contribs.org/buglist.cgi?action=wrap&bug_status=UNCONFIRMED&bug_status=CONFIRMED&bug_status=NEEDINFO&bug_status=IN_PROGRESS&bug_status=RESOLVED&bug_status=VERIFIED&classification=Contribs&component=smeserver-affa%20%28unmaintained%29&list_id=22153&product=SME%20Contribs&resolution=---&resolution=FIXED&resolution=NOTABUG&resolution=WONTFIX&resolution=UPSTREAM&resolution=DUPLICATE&resolution=WORKSFORME&saved_report_id=1 smeserver-affa Bugs]
=== Maintainer ===
=== Maintainer ===
Development and maintenance of Affa for SME Server by the original maintainer has been discontinued. A new Affa Version 3.x for CentOS is available on [http://affa.sourceforge.net/ Sourceforge].
Development and maintenance of Affa for SME Server (Affa version 2.x) by the original maintainer has been discontinued.
=== Description ===
=== Description ===
The main purpose of this affa package is to make a SME 7 Server a dedicated backup box in a few minutes. Affa backs up as many SME servers as you like or any other servers which have sshd running and rsync installed. Once it is configured, Affa runs reliably unattended and sends warning messages in case of any errors.
The main purpose of this affa package is to make a SME Server a dedicated backup box in a few minutes. Affa backs up as many SME servers as you like or any other servers which have sshd running and rsync installed. Once it is configured, Affa runs reliably unattended and sends warning messages in case of any errors.
All backup archives are full backups, as Affa make use of the hardlink technique. Therefore a new full backup only needs disk space for the differences plus the filesystem overhead for the hardlinks and directories (which is typically 2-3%).
All backup archives are full backups, as Affa makes use of the hardlink technique. Therefore a new full backup only needs disk space for the differences plus the filesystem overhead for the hardlinks and directories (which is typically 2-3%).
Affa is based on the rsync program and supports the rsync --compress option. This allows you to run backups over the internet or VPN. A typical setup is one or more Affa backup servers placed in different locations, which backup the production server(s) over the VPN.
Affa is based on the rsync program and supports the rsync --compress option. This allows you to run backups over the internet or VPN. A typical setup is one or more Affa backup servers placed in different locations, which backup the production server(s) over the VPN.
Affa is a command line tool for system administrators and is intentionally designed without a GUI. Therefore it can be efficiently managed on the console and over slow internet connections.
Affa is a command line tool for system administrators and is intentionally designed without a GUI. Therefore it can be efficiently managed on the console and over slow internet connections.
'''Note:''' This documents refers to the Affa Version 2 Release Candidate. Latest stable version 1 documentation can be found [http://wiki.contribs.org/index.php?title=Affa&oldid=11974 here].
'''Note:''' This documents refers to the Affa Version 2 which is not maintained anymore. Information on Affa 3 will be gradually added here once it has been more tested.
==== Affa features at a glance ====
==== Affa features at a glance ====
=== Installation or Update ===
=== Installation or Update ===
====Smecontribs for sme8====
==== Affa 2 ====
=====Smecontribs for sme8=====
yum install --enablerepo=smecontribs smeserver-affa
yum install --enablerepo=smecontribs smeserver-affa
affa --make-cronjobs
affa --make-cronjobs
and logout and re-login to the console to take the bash auto-completion (TAB key) in effect.
and logout and re-login to the console to take the bash auto-completion (TAB key) in effect.
====Obsolete way to install====
=====Obsolete way to install=====
{{Note box|SME7 is now EOL and has been moved to the obsolete tree}}
{{Note box|SME7 is now EOL and has been moved to the obsolete tree}}
SME7 version: '''smeserver-affa-2.0.0-rc4.noarch.rpm'''
SME7 version: '''smeserver-affa-2.0.0-rc4.noarch.rpm'''
affa --make-cronjobs
affa --make-cronjobs
and logout and re-login to the console to take the bash auto-completion (TAB key) in effect.
and logout and re-login to the console to take the bash auto-completion (TAB key) in effect.
==== Affa 3 ====
The following instructions assume that a fresh Affa 3 installation is made with no jobs migrated from Affa 2.
=====Installation on SME 8.1 32 Bit=====
Login as root on local or remote SSH console. Then create dedicated directory for Affa 3 files and go to there:
mkdir /root/affa3
cd /root/affa3
Then retrieve additionally required RPM packages:
wget http://pkgs.repoforge.org/perl-Proc-ProcessTable/perl-Proc-ProcessTable-0.45-1.el5.rf.i386.rpm
wget http://pkgs.repoforge.org/perl-Config-IniFiles/perl-Config-IniFiles-2.56-1.el5.rf.noarch.rpm
wget http://pkgs.repoforge.org/perl-Filesys-DiskFree/perl-Filesys-DiskFree-0.06-1.2.el5.rf.noarch.rpm
wget http://www.guedel.eu/phocadownload/uploads_AG/smeserver-affa-3.2.2.1-0.noarch.rpm
Install packages
yum localinstall --enablerepo=smecontribs perl-Proc-ProcessTable-0.45-1.el5.rf.i386.rpm perl-Config-IniFiles-2.56-1.el5.rf.noarch.rpm perl-Filesys-DiskFree-0.06-1.2.el5.rf.noarch.rpm smeserver-affa-3.2.2.1-0.noarch.rpm
=====Installation on SME 8.1 64 Bit=====
Login as root on local or remote SSH console. Then create dedicated directory for Affa 3 files and go to there:
mkdir /root/affa3
cd /root/affa3
Then retrieve additionally required RPM packages:
wget http://pkgs.repoforge.org/perl-Proc-ProcessTable/perl-Proc-ProcessTable-0.45-1.el5.rf.x86_64.rpm
wget http://pkgs.repoforge.org/perl-Config-IniFiles/perl-Config-IniFiles-2.56-1.el5.rf.noarch.rpm
wget http://pkgs.repoforge.org/perl-Filesys-DiskFree/perl-Filesys-DiskFree-0.06-1.2.el5.rf.noarch.rpm
wget http://www.guedel.eu/phocadownload/uploads_AG/smeserver-affa-3.2.2.1-0.noarch.rpm
Install packages
yum localinstall --enablerepo=smecontribs perl-Proc-ProcessTable-0.45-1.el5.rf.x86_64.rpm perl-Config-IniFiles-2.56-1.el5.rf.noarch.rpm perl-Filesys-DiskFree-0.06-1.2.el5.rf.noarch.rpm smeserver-affa-3.2.2.1-0.noarch.rpm
=====Installation on SME 9.0 32 Bit=====
Login as root on local or remote SSH console. Then create dedicated directory for Affa 3 files and go to there:
mkdir /root/affa3
cd /root/affa3
Then retrieve additionally required RPM packages:
wget http://pkgs.repoforge.org/perl-Proc-ProcessTable/perl-Proc-ProcessTable-0.45-1.el6.rf.i686.rpm
wget http://pkgs.repoforge.org/perl-Config-IniFiles/perl-Config-IniFiles-2.56-1.el6.rf.noarch.rpm
wget http://pkgs.repoforge.org/perl-Filesys-DiskFree/perl-Filesys-DiskFree-0.06-1.2.el6.rf.noarch.rpm
wget http://www.guedel.eu/phocadownload/uploads_AG/smeserver-affa-3.2.2.1-0.noarch.rpm
Install packages
yum localinstall --enablerepo=smecontribs perl-Proc-ProcessTable-0.45-1.el6.rf.i686.rpm perl-Config-IniFiles-2.56-1.el6.rf.noarch.rpm perl-Filesys-DiskFree-0.06-1.2.el6.rf.noarch.rpm smeserver-affa-3.2.2.1-0.noarch.rpm
=====Installation on SME 9.0 64 Bit=====
Login as root on local or remote SSH console. Then create dedicated directory for Affa 3 files and go to there:
mkdir /root/affa3
cd /root/affa3
Then retrieve additionally required RPM packages:
wget http://pkgs.repoforge.org/perl-Proc-ProcessTable/perl-Proc-ProcessTable-0.45-1.el6.rf.x86_64.rpm
wget http://pkgs.repoforge.org/perl-Config-IniFiles/perl-Config-IniFiles-2.56-1.el5.rf.noarch.rpm
wget http://pkgs.repoforge.org/perl-Filesys-DiskFree/perl-Filesys-DiskFree-0.06-1.2.el6.rf.noarch.rpm
wget http://www.guedel.eu/phocadownload/uploads_AG/smeserver-affa-3.2.2.1-0.noarch.rpm
Install packages
yum localinstall --enablerepo=smecontribs perl-Proc-ProcessTable-0.45-1.el6.rf.x86_64.rpm perl-Config-IniFiles-2.56-1.el5.rf.noarch.rpm perl-Filesys-DiskFree-0.06-1.2.el6.rf.noarch.rpm smeserver-affa-3.2.2.1-0.noarch.rpm
=====Create backup jobs=====
Job configurations of Affa 3 are no longer stored in an e-smith style database. They are stored in configuration files located in ''/etc/affa'' .Create your config file
touch /etc/affa/sme-backup.conf
and add content as described below.
=== Quick start example ===
=== Quick start example ===
