Changes

Jump to navigation Jump to search
4,447 bytes added ,  05:05, 20 August 2022
Line 1: Line 1: −
== An smeserver contribution to schedule and run the DAR2 (Disk ARchive) utility ==
+
{{Languages}}
 
+
{{Level|Easy}}
 
=== Maintainer ===
 
=== Maintainer ===
 
[http://myezserver.com/ Darrel May] (Contrib)
 
[http://myezserver.com/ Darrel May] (Contrib)
 +
 +
=== Version ===
 +
{{#smeversion:smeserver-dar2}}
 +
[[Version::contrib9|stephdl]][[Has SME9::true| ]]
    
=== Description ===
 
=== Description ===
This contrib uses dar (http://dar.linux.free.fr) to create a feature rich backup system for smeserver 7.x. It adds a server-manager panel (Backup > Disk ARchive) to define, schedule and launch server backups and restores, to and from network shares or an attached local disk.
+
This contrib uses dar (http://dar.linux.free.fr) to create a feature rich backup system for smeserver 7.x. It adds a server-manager panel (Backup > Disk ARchive) to define, schedule and launch server backups and restores, including full disaster recovery, to and from network shares or an attached local disk. The destination network share can be any accessible network mapped drive. Another server, pc workstation or network attached hard drive. The destination local disk can be any mountable hard disk. IDE/SCSI/SATA/USB. In addition an unlimited number of custom backups may be scheduled.
    
=== Installation ===
 
=== Installation ===
The contrib source files for SME Server 7.x can be found at
+
<tabs container style="display: inline-block;"><tab name="For SME 10">
[http://mirror.contribs.org/smeserver/contribs/dmay/smeserver/7.x/ ibiblio.org]
+
{{Note box| work in porgress, for testing purpose only}}
   
+
To install this contribs issue the following command on the SME Server shell:
To install this contrib, first download the packages from the site into an empty directory:
+
yum install smeserver-dar2 --enablerepo=smecontribs,smedev,smetest,epel
  wget http://mirror.contribs.org/smeserver/releases/7/smetest/i386/RPMS/dar-2.3.6-1.el4.sme.i386.rpm
+
</tab><tab name="For SME 9">
  wget http://mirror.contribs.org/smeserver/contribs/dmay/smeserver/7.x/smeserver-dar2-0.0.1-3dmay.noarch.rpm
+
You have to enable the [[stephdl]] repository. see [[bugzilla:8508]]
 +
  yum install smeserver-dar2 --enablerepo=stephdl
 +
signal-event post-upgrade;signal-event reboot
 +
</tab><tab name="For SME 8">
 +
To install this contribs issue the following command on the SME Server shell:
 +
  yum install smeserver-dar2 --enablerepo=smecontribs
 +
  signal-event post-upgrade;signal-event reboot
 +
</tab>
 +
</tabs>
   −
Install with:
+
=== Usage ===
yum localinstall *.rpm
+
The contrib adds a server-manager panel labeled 'Backup > Disk ARchive'. All backup and restore operations may be performed using this panel. Usage instructions are detailed in the panel text.
   −
You will probably need to reboot the server before using the contrib. The ''yum'' utility, when run, will provide you with details of how to do this.
+
=== Additional information ===
 +
The dar utility is available for a number of platforms, including Windows. [http://mirror.contribs.org/smeserver/contribs/dmay/smeserver/7.x/dar64-2.3.2-i386-windows.zip The Windows Version] is command-line only, with no graphical view of files for restoring. A graphical interface ([http://kdar.sourceforge.net/ kdar]) is available for Linux platforms.
   −
Note: some earlier SME Server 7.x versions required additional packages (e.g. FormMagick) that are now included in the very latest SME Server 7.x. If using an earlier version of SME Server, the required packages can be found with the dar2 package at [http://mirror.contribs.org/smeserver/contribs/dmay/smeserver/7.x/ ibiblio.org]
+
==== Sample e-mail sent after scheduled backup job completes ====
 +
Date: 10 Jun 2008 04:30:06 -0000
 +
From: Cron Daemon <root@domain.com>
 +
Subject: Cron <root@sme> /etc/e-smith/events/actions/dar2-backup 911
 +
To: root@domain.com
   −
=== Additional information ===
+
Connecting /mnt/dar2/911 to //station1/dar2
There is no yum update server for this contribution.
+
Expanding /etc/dar2/911 template
 +
Creating /mnt/dar2/911/sme.myezserver.com/911/db.zip
 +
Expiring old backups
 +
Executing pre-backup event
 +
Verbose logging is off
 +
Performing 911 backup
 +
No terminal found for user interaction. All questions will be assumed
 +
a negative answer (less destructive choice), which most of the time will abort the program.
 +
 
 +
--------------------------------------------
 +
47707 inode(s) saved
 +
with 4 hard link(s) recorded
 +
0 inode(s) changed at the moment of the backup
 +
0 inode(s) not saved (no inode/file change)
 +
0 inode(s) failed to save (filesystem error)
 +
259 inode(s) ignored (excluded by filters)
 +
0 inode(s) recorded as deleted from reference backup
 +
  --------------------------------------------
 +
Total number of inode considered: 47966
 +
--------------------------------------------
 +
 
 +
Listing 911 archives on target:
 +
total 9331906
 +
-rwxr-xr-x  1 root root 681574400 Jun  6 23:44 2008.06.06.1.dar
 +
-rwxr-xr-x  1 root root 681574400 Jun  7 00:00 2008.06.06.2.dar
 +
-rwxr-xr-x  1 root root 681574400 Jun  7 00:16 2008.06.06.3.dar
 +
-rwxr-xr-x  1 root root 343344717 Jun  7 00:24 2008.06.06.4.dar
 +
-rwxr-xr-x  1 root root 681574400 Jun  7 23:44 2008.06.07.1.dar
 +
-rwxr-xr-x  1 root root 681574400 Jun  8 00:00 2008.06.07.2.dar
 +
-rwxr-xr-x  1 root root 681574400 Jun  8 00:16 2008.06.07.3.dar
 +
-rwxr-xr-x  1 root root 343679423 Jun  8 00:25 2008.06.07.4.dar
 +
-rwxr-xr-x  1 root root 681574400 Jun  8 23:45 2008.06.08.1.dar
 +
-rwxr-xr-x  1 root root 681574400 Jun  9 00:00 2008.06.08.2.dar
 +
-rwxr-xr-x  1 root root 681574400 Jun  9 00:18 2008.06.08.3.dar
 +
-rwxr-xr-x  1 root root 344188465 Jun  9 00:26 2008.06.08.4.dar
 +
-rwxr-xr-x  1 root root 681574400 Jun  9 23:44 2008.06.09.1.dar
 +
-rwxr-xr-x  1 root root 681574400 Jun 10 00:01 2008.06.09.2.dar
 +
-rwxr-xr-x  1 root root 681574400 Jun 10 00:16 2008.06.09.3.dar
 +
-rwxr-xr-x  1 root root 345723391 Jun 10 00:25 2008.06.09.4.dar
 +
-rwxr-xr-x  1 root root    41253 Jun  9 23:30 db.zip
 +
 
 +
Total target disk space usage:
 +
Filesystem            Size  Used Avail Use% Mounted on
 +
//station1/dar2        18G  8.6G  9.2G  49% /mnt/dar2/911
   −
The dar utility is available for a number of platforms, including Windows. [http://mirror.contribs.org/smeserver/contribs/dmay/smeserver/7.x/dar64-2.3.2-i386-windows.zip The Windows Version] is command-line only, with no graphical view of files for restoring. A graphical interface ([http://kdar.sourceforge.net/ kdar]) is available for Linux platforms.
+
Executing post-backup event
 +
Dismounting /mnt/dar2/911
    +
Mon Jun  9 23:30:02 CDT 2008 - backup started
 +
Tue Jun 10 00:25:49 CDT 2008 - backup finished
    
==== Midnight Commander (MC) dar-extension ====
 
==== Midnight Commander (MC) dar-extension ====
Line 40: Line 103:  
  dar2-mc = script that launches Midnight Commander and provides access to your archives<br>
 
  dar2-mc = script that launches Midnight Commander and provides access to your archives<br>
 
  dar2-restore = script that performs restore<br>
 
  dar2-restore = script that performs restore<br>
 +
 +
==== Manual restore of DAR2 configuration ====
 +
It is possible to selectively restore the DAR2 configuration (backup job settings etc) from a full system backup.
 +
Firstly install the DAR2 contrib on a new server, which will of course have no backup jobs configured.
 +
 +
Then look at the backup file in the backup target location and find a file called db.zip. Extract the dar2 db file and copy it to /home/e-smith/db on the new server, to restore the previous DAR2 configuration.
 +
 +
===Known issue===
 +
 +
====Cifs Error====
 +
When using the included backup functionality, or the DAR2 contrib, backing up to a windows remote share generates the following cifs errors. see [[bugzilla:7341]]
 +
Feb 12 11:51:25 sme e-smith-bg: Connecting /mnt/dar2/backup to \\192.168.10.30\bkp
 +
Feb 12 11:51:25 sme kernel:  CIFS VFS: Send error in SessSetup = -12
 +
Feb 12 11:51:25 sme kernel:  CIFS VFS: cifs_mount failed w/return code = -12
 +
Feb 12 11:51:25 sme e-smith-bg: mount error(12): Cannot allocate memory
 +
Feb 12 11:51:25 sme e-smith-bg: Refer to the mount.cifs
 +
 +
The solution could be to modify the windows registry by the file below
 +
 +
Windows Registry Editor Version 5.00
 +
[HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Control\Session Manager\Memory Management]
 +
"LargeSystemCache"=dword:00000001
 +
[HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\services\LanmanServer\Parameters]
 +
"Size"=dword:00000003
 +
 +
Save the content above in a file with the name W7-backup.reg and import it in the windows registry, restart the service or the Windows computer
    
=== Bugs ===
 
=== Bugs ===
Please raise bugs under the SME-Contribs section in {{BugzillaFileBug|product=|component=|title=dar2}}and select the smeserver-dar2 component or use {{BugzillaFileBug|product=SME%20Contribs|component=smeserver-dar2|title=this link}}.  
+
Please raise bugs under the SME-Contribs section in {{BugzillaFileBug|product=|component=|title=dar2}}and select the smeserver-dar2 component or use {{BugzillaFileBug|product=SME%20Contribs|component=smeserver-dar2|title=this link}}.
 +
 
 +
 
 +
{{#bugzilla:columns=id,product,version,status,summary |sort=id |order=desc |component=smeserver-dar2|noresultsmessage="No open bugs found."}}
    
=== Check installed version ===
 
=== Check installed version ===
Super Admin, Wiki & Docs Team, Bureaucrats, Interface administrators, Administrators
3,250

edits

Navigation menu