Line 391: |
Line 391: |
| | string || || the password for authentication to the rsync daemon (only applicable with rsyncdMode=yes) | | | string || || the password for authentication to the rsync daemon (only applicable with rsyncdMode=yes) |
| |- | | |- |
− | | remoteOS
| |
− | | cygwin || || with remoteOS=cygwin the options --send-key and --revoke-key uses the account 'Administrator' and the correct path for the public key on a Windows/Cygwin remote host.
| |
− | |-
| |
| | chunkFiles | | | chunkFiles |
| | string || || Filenames that Affa should chunk and compress. Multiple file names are to be separated by the slash (/) character, e.g. 'mysql.dump/pgsql.dump' chunks the two files mysql.dump and pgsql.dump. With ESXi=yes it is implicitly set to '*.vmdk'. See also command line options --chunk-archive and --unchunk-archive | | | string || || Filenames that Affa should chunk and compress. Multiple file names are to be separated by the slash (/) character, e.g. 'mysql.dump/pgsql.dump' chunks the two files mysql.dump and pgsql.dump. With ESXi=yes it is implicitly set to '*.vmdk'. See also command line options --chunk-archive and --unchunk-archive |
Line 428: |
Line 425: |
| | | |
| '''affa --make-cronjobs''' | | '''affa --make-cronjobs''' |
− | Configures the cronjobs as scheduled in the jobs records. | + | Configures the cronjobs as scheduled in the jobs records. By default this command will by executed by 'cronjobs' every 15 minutes. So you don't need to run this command manually, you can also just wait max. 15 minutes before your updates job configurations become effective. |
| | | |
| | | |
| '''affa --send-key JOB''' | | '''affa --send-key JOB''' |
− | '''affa --send-key --host=TARGETHOST [--port=PORT] [--remoteOS=cygwin]''' | + | '''affa --send-key --host=TARGETHOST [--port=PORT]''' |
| This first generates the DSA key for the Affa Server, if not already done. Then it sends the public key to the host 'remoteHostName' as configured in the record of job JOB and generates the job specific ssh known host entry. | | This first generates the DSA key for the Affa Server, if not already done. Then it sends the public key to the host 'remoteHostName' as configured in the record of job JOB and generates the job specific ssh known host entry. |
| {{Note box|When initially doing this step, you will need to temporarily enable "Allow secure shell access using standard passwords" on the production server.}} | | {{Note box|When initially doing this step, you will need to temporarily enable "Allow secure shell access using standard passwords" on the production server.}} |
− | {{Note box|<nowiki>By default, the --send-key option works for a SME Server as a remote server and for systems where the keys are stored in /root/.ssh/authorized_keys2 and the commands /bin/cat, /bin/touch, /bin/grep and /bin/mv are available. With remoteOS=cygwin it works for a Cygwin/Windows remote server.</nowiki>}} | + | {{Note box|<nowiki>By default, the --send-key option works for a SME Server as a remote server and for systems where the keys are stored in /root/.ssh/authorized_keys2 and the commands /bin/cat, /bin/touch, /bin/grep and /bin/mv are available.</nowiki>}} |
| | | |
| | | |
Line 443: |
Line 440: |
| | | |
| '''affa --rise [--all] JOB [ARCHIVE]''' | | '''affa --rise [--all] JOB [ARCHIVE]''' |
− | Runs a full restore on the Affa server <b>(!)</b> of all standard files and directories from the backup ARCHIVE of job JOB. In other words: After completion, the Affa box reboots as a clone of the source server. Ensure, that the source server has been powered off before you reboot the Affa box, otherwise the network interface will not come up. This is important, when you run --rise remotely. The --rise feature only works with SME 7 servers und should only be used on dedicated backup servers. | + | Runs a full restore on the Affa server <b>(!)</b> of all standard files and directories from the backup ARCHIVE of job JOB. In other words: After completion, the Affa box reboots as a clone of the source server. Ensure, that the source server has been powered off before you reboot the Affa box, otherwise the network interface will not come up. This is important, when you run --rise remotely. The --rise feature only works with SME servers und should only be used on dedicated backup servers. |
| | | |
| With option --all, all files and directories of the archive as defined by the include[] properties are restored. Files or directories with the same name on the Affa server will be overwritten and cannot be restored by a undorise. This should not be an issue on a dedicated Affa server which does not hold any other data. After a possible undorise those additional restored dada must be removed manually. | | With option --all, all files and directories of the archive as defined by the include[] properties are restored. Files or directories with the same name on the Affa server will be overwritten and cannot be restored by a undorise. This should not be an issue on a dedicated Affa server which does not hold any other data. After a possible undorise those additional restored dada must be removed manually. |
Line 663: |
Line 660: |
| | | |
| Please pay attention, that you do not backup the archives back to the other site. Set the RootDir property to a path which is not included in the SME default backup list. When leaving the RootDir property to its default '/var/affa', this is guaranteed. | | Please pay attention, that you do not backup the archives back to the other site. Set the RootDir property to a path which is not included in the SME default backup list. When leaving the RootDir property to its default '/var/affa', this is guaranteed. |
− |
| |
− | ==== Backing up a Windows computer ====
| |
− | Backing up data from a Windows system requires the Cygwin Rsyncd daemon installed and configured on Windows. The standard procedure ''rsync over ssh'' does not work, as the Cygwin rsync process always hangs after some files were transferred.
| |
− |
| |
− | ===== Rsyncd setup on the Windows computer =====
| |
− | Install the Cygwin base, the rsync package and configure the Rsyncd service as described in this document: [[Rsyncd setup on a windows computer for use with Affa backup]]'.
| |
− | The installation of the sshd service is optional and not needed for the backup itself, but having a ssh login can be very helpful for administration or executing scripts on the Windows system. Affa supports sending the public key to a Windows Cygwin for password-less login.
| |
− |
| |
− | Note: Affa does not backup the Windows Access Control List (ACL) information. You may need to correct the ACLs manually after a restore.
| |
− |
| |
− | ===== Affa Rsyncd mode setup (Quick start example) =====
| |
− | You want to backup the ''My Documents'' folders of the users ''ssorglos'' and ''bsimpson'' from the Windows computer 'ws001' with IP 192.168.1.65 to your Affa server 'affabox' with IP 192.168.1.3.
| |
− | * log into the 'affabox' and copy the Cygwin config helper script sample
| |
− | cp /usr/lib/affa/jobconfig-cygwin-sample.pl /root/ws001-mydocs-job.pl
| |
− | * edit /root/ws001-mydocs-job.pl and set
| |
− | my $jobname='ws001-mydocs';
| |
− | and
| |
− | 'remoteHostName‘=>'192.168.1.65',
| |
− | 'rsyncdPassword'=>'<i>secretword</i>',
| |
− | 'Include[0]'=>'/c/Documents and Settings/ssorglos/My Documents/', ''# don't use backslashes in pathnames!''
| |
− | 'Include[1]'=>'/c/Documents and Settings/bsimpson/My Documents/',
| |
− | where ''secretword'' must be replaced by the password you have chosen in the rsyncd.secretsfile on the Windows box.
| |
− | * write the configuration (this makes the database entries and sets up the cronjobs)
| |
− | /root/ws001-mydocs-job.pl
| |
− | * run the job manually. After completion check the archive /var/affa/ws001-mydocs/scheduled.0 and the logfile /var/log/affa/ws001-mydocs.log
| |
− | affa --run ws001-mydocs
| |
− |
| |
− | ===== Affa Rsyncd mode manual setup =====
| |
− | In case you want to do the setup manually using the db command, these are the mandatory settings for Cygwin Rsyncd mode
| |
− | db affa setprop JOB rsyncdMode yes
| |
− | db affa setprop JOB rsyncdModule AFFA
| |
− | db affa setprop JOB rsyncdUser affa
| |
− | db affa setprop JOB rsyncdPassword ''secretword''
| |
− | db affa setprop JOB SMEServer no
| |
− | db affa setprop JOB RPMCheck no
| |
− | db affa setprop JOB Watchdog no
| |
− | Optional for ssh login
| |
− | db affa setprop JOB remoteOS cygwin
| |
− |
| |
| | | |
| ==== Use Affa to backup to a NFS-mounted NAS or a local attached USB drive ==== | | ==== Use Affa to backup to a NFS-mounted NAS or a local attached USB drive ==== |
| | | |
− | You want to backup your SME 7 production server with hostname 'prodbox‘ and IP 10.200.48.1 on a mounted filesystem instead of setting up a dedicated Affa box. | + | You want to backup your SME production server with hostname 'prodbox‘ and IP 10.200.48.1 on a mounted filesystem instead of setting up a dedicated Affa box. |
| | | |
| ===== Setup NAS ===== | | ===== Setup NAS ===== |