Changes

Jump to navigation Jump to search
6,386 bytes added ,  05:05, 20 August 2022
Line 1: Line 1: −
== smeserver-dar2 contribution ==
+
{{Languages}}
 
+
{{Level|Easy}}
== An smeserver contribution to schedule and run the DAR2 (Disk ARchive) utility ==
+
=== Maintainer ===
 +
[http://myezserver.com/ Darrel May] (Contrib)
   −
=== Maintainer ===
+
=== Version ===
[http://www.myezserver.com/ Selintra]
+
{{#smeversion:smeserver-dar2}}
[dmay@myezserver.com Darrel May]
+
[[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 to network shares or attached USB disk. Based on and supercedes smeserver-backup2.
+
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 ===
This contrib source files can be found at the  
+
<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 download the rpms from the site and install with
+
yum install smeserver-dar2 --enablerepo=smecontribs,smedev,smetest,epel
  yum localinstall *.rpm
+
</tab><tab name="For SME 9">
 +
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>
 +
 
 +
=== Usage ===
 +
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.
    
=== Additional information ===
 
=== Additional information ===
None.
+
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.
 +
 
 +
==== 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
 +
 
 +
Connecting /mnt/dar2/911 to //station1/dar2
 +
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
 +
 
 +
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 ====
 +
With the installation of DAR2 comes an extension for viewing .dar files from within Midnight Commander but it is not installed by default. You can find the files extracted in the /opt/dar2-mc directory. For installation of this extension run the install.sh shell script with:
 +
cd /opt/dar2-mc
 +
./install.sh
 +
 
 +
==== DAR2 command line scripts ====
 +
Located in /etc/e-smith/events/actions/
 +
 
 +
dar2-backup = script that performs backup<br>
 +
dar2-dr-restore = script that performs a complete disaster recovery restore<br>
 +
dar2-mc = script that launches Midnight Commander and provides access to your archives<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 ===
 +
yum info installed smeserver-dar2
 +
 
 
----
 
----
 
[[Category: Contrib]]
 
[[Category: Contrib]]
 +
[[Category: Backup]]
Super Admin, Wiki & Docs Team, Bureaucrats, Interface administrators, Administrators
3,250

edits

Navigation menu