Difference between revisions of "ShadowCopy"

From SME Server
Jump to navigationJump to search
m (added ibay & user re-enable commands)
 
(16 intermediate revisions by 6 users not shown)
Line 1: Line 1:
 
== ShadowCopy ==
 
== ShadowCopy ==
  
DRAFT HOWTO
+
ShadowCopy takes a snapshot of ibays and user home folders at scheduled intervals and allows network users to restore previous versions of files via the Windows Explorer file properties page.
  
 +
This works for Windows XP and above.
  
==='''Overview'''===
+
To obtain a client for Windows 2000SP3+ download from [http://technet.microsoft.com/en-gb/windowsserver/bb405951.aspx here].
  
This Howto is based on information contained in bug report
 
http://bugs.contribs.org/show_bug.cgi?id=1549
 
  
ShadowCopy takes a snapshot of ibays & user home folders at scheduled intervals and allows network users to restore previous versions of files via the Windows Explorer file properties page.
+
===RPM version requirements===
A client is installed by default in Windows XP.
+
This functionality is included in e-smith-samba since version 1.14.0-20.
To obtain a client for Windows 2000SP3+ download from here
 
http://technet.microsoft.com/en-gb/windowsserver/bb405951.aspx
 
 
 
This functionality is included in e-smith-samba, but requires further testing & verification
 
 
 
It requires e-smith-samba-1.14.0-20
 
 
 
sme7.3 has e-smith-samba-1.14.1-3.el4.sme
 
 
 
Please report any bugs to bugzilla, using this bug number http://bugs.contribs.org/show_bug.cgi?id=1549
 
 
 
 
==='''Configuration'''===
 
  
 
To check the installed rpm version
 
To check the installed rpm version
  rpm -qa e-smith-samba
+
  rpm -q e-smith-samba
On a sme7.3 server this gives
+
On a SME Server 7.3 server this gives
 
e-smith-samba-1.14.1-3.el4.sme
 
e-smith-samba-1.14.1-3.el4.sme
so the installed rpm is more recent than that required (e-smith-samba-1.14.0-20)
+
so the installed rpm is more recent than that required.
  
 +
===Configuration===
  
 +
====Enabling and disabling====
 
Initially disable ShadowCopy for specific ibays or users you don't wish to take snapshots for
 
Initially disable ShadowCopy for specific ibays or users you don't wish to take snapshots for
 
eg
 
eg
Line 39: Line 27:
 
  db accounts setprop ibay2 ShadowCopy disabled
 
  db accounts setprop ibay2 ShadowCopy disabled
  
Note: For the script to work correctly, leave two or more users enabled
+
{{Note box|For the script to work correctly, leave two or more users enabled.}}
  
 
To re-enable any disabled ibays or users do:
 
To re-enable any disabled ibays or users do:
Line 47: Line 35:
 
Then enable and expand templates
 
Then enable and expand templates
 
  config setprop smb ShadowCopy enabled
 
  config setprop smb ShadowCopy enabled
  signal-event ibay-modify Primary
+
config setprop smb WideLinks on
 +
  signal-event ibay-modify
  
 +
=====WideLinks=====
 +
Samba 3.5 changed the default for WideLinks to no, this tightens security to prevent symbolic links seeing outside the directory root. ShadowCopy itself will work without this setting, but will require shell access to restore files..
 +
 +
====Adding ibays and users to your server====
 +
Add ibays and users to your sme server in the normal way. If ShadowCopy is enabled, then by default the newly added ibays and users will be included in ShadowCopy behaviour, so you must specifically exclude them from ShadowCopy behaviour using the disable commands mentioned above on a per ibay and user basis.
 +
 +
 +
====Snapshots====
 
You need to schedule shadow copy to take snapshots.
 
You need to schedule shadow copy to take snapshots.
 
You can do this manually from the command prompt
 
You can do this manually from the command prompt
Line 56: Line 53:
 
At the command prompt do
 
At the command prompt do
 
  /etc/e-smith/events/actions/shadow-copy-rotate
 
  /etc/e-smith/events/actions/shadow-copy-rotate
+
{{Note box|You will need enough free disk space [and backup capacity] to take a copy of the entire /home/e-smith/files directory plus any changes that take place.}}
Note: You will need enough free disk space to take a copy of the entire /home/e-smith/files directory plus any changes that take place.
 
  
A suitable cron job that runs the script every hour from 10am to 5pm on weekdays would contain the following:
+
====Setup Cron====
 +
A cron job that runs the script every hour from 10am to 5pm on weekdays would contain the following. Adjust to suit your requirements.
  
 
Create a file
 
Create a file
Line 82: Line 79:
 
  /etc/init.d/crond restart
 
  /etc/init.d/crond restart
  
In Windows access the snapshot files via Windows Explorer file properties page, Previous Versions tab.
+
====Location of ShadowCopy files====
  
A Windows client exists in WinXP SP2
+
NB. Users recover files with windows explorer.
  
To obtain a client for Windows 2000SP3+ download from here
+
The ShadowCopy files are located in:
http://technet.microsoft.com/en-gb/windowsserver/bb405951.aspx
 
 
 
 
 
ShadowCopy files are located in:
 
 
  /home/e-smith/files/.shadow/1
 
  /home/e-smith/files/.shadow/1
 
  /home/e-smith/files/.shadow/2
 
  /home/e-smith/files/.shadow/2
Line 99: Line 92:
 
Note that a new snapshot is only taken if files have changed.
 
Note that a new snapshot is only taken if files have changed.
  
 +
===Bugs===
 +
If you find a problem report it to the bug tracker at bugs.contribs.org
  
  
Feedback to the bug tracker at
+
===References===
http://bugs.contribs.org/show_bug.cgi?id=1549
 
  
==='''References:'''===
+
[[bugzilla:1549]]
  
http://bugs.contribs.org/show_bug.cgi?id=1549
+
[[bugzilla:6858]] Wide Links
  
http://forums.contribs.org/index.php?topic=39954.0
+
[http://forums.contribs.org/index.php?topic=39954.0 Shadow Copy topic in the Contribs forums]
  
For background information re alternative Linux implementation, although this contrib is not used here
+
For background information regarding alternative Linux implementation, although this contrib is not used here
  
 
http://www.wlug.org.nz/SambaShadowCopyHowto
 
http://www.wlug.org.nz/SambaShadowCopyHowto
 
  
 
----
 
----
[[Category:Contrib]]
+
[[Category:Howto]]
[[Category: Backup]]
+
[[Category:Backup]]
 +
[[Category:Administration:File and Directory Access]]

Latest revision as of 23:17, 30 June 2013

ShadowCopy

ShadowCopy takes a snapshot of ibays and user home folders at scheduled intervals and allows network users to restore previous versions of files via the Windows Explorer file properties page.

This works for Windows XP and above.

To obtain a client for Windows 2000SP3+ download from here.


RPM version requirements

This functionality is included in e-smith-samba since version 1.14.0-20.

To check the installed rpm version

rpm -q e-smith-samba

On a SME Server 7.3 server this gives e-smith-samba-1.14.1-3.el4.sme so the installed rpm is more recent than that required.

Configuration

Enabling and disabling

Initially disable ShadowCopy for specific ibays or users you don't wish to take snapshots for eg

db accounts setprop user1 ShadowCopy disabled
db accounts setprop user2 ShadowCopy disabled
db accounts setprop ibay1 ShadowCopy disabled
db accounts setprop ibay2 ShadowCopy disabled


Important.png Note:
For the script to work correctly, leave two or more users enabled.


To re-enable any disabled ibays or users do:

db accounts delprop user1 ShadowCopy
db accounts delprop ibay2 ShadowCopy

Then enable and expand templates

config setprop smb ShadowCopy enabled
config setprop smb WideLinks on
signal-event ibay-modify
WideLinks

Samba 3.5 changed the default for WideLinks to no, this tightens security to prevent symbolic links seeing outside the directory root. ShadowCopy itself will work without this setting, but will require shell access to restore files..

Adding ibays and users to your server

Add ibays and users to your sme server in the normal way. If ShadowCopy is enabled, then by default the newly added ibays and users will be included in ShadowCopy behaviour, so you must specifically exclude them from ShadowCopy behaviour using the disable commands mentioned above on a per ibay and user basis.


Snapshots

You need to schedule shadow copy to take snapshots. You can do this manually from the command prompt or run a cron job as often as required. Snapshots are only taken if there are changes.

At the command prompt do

/etc/e-smith/events/actions/shadow-copy-rotate
Important.png Note:
You will need enough free disk space [and backup capacity] to take a copy of the entire /home/e-smith/files directory plus any changes that take place.


Setup Cron

A cron job that runs the script every hour from 10am to 5pm on weekdays would contain the following. Adjust to suit your requirements.

Create a file

pico -w /etc/cron.d/shadowcopysnapshot

which contains

# Shadow Copy snapshot Crond Entry
#+-----------------------Minute           (0-59)
#|    +-------------------Hour of Day    (0-23)
#|    |    +---------------Day of Month  (1-31)
#|    |    |    +-----------Month of Year (1-12)
#|    |    |    |    +-------Day of Week   (0=Sun,6=Sat)
#v   v   v   v   v
00    10,11,12,13,14,15,16,17   *    *   1,2,3,4,5   root /etc/e-smith/events/actions/shadow-copy-rotate

To save

Ctrl o 

To exit

Ctrl x

After saving the above script do

/etc/init.d/crond restart

Location of ShadowCopy files

NB. Users recover files with windows explorer.

The ShadowCopy files are located in:

/home/e-smith/files/.shadow/1
/home/e-smith/files/.shadow/2
/home/e-smith/files/.shadow/3
and so on...

The number of subfolders depends on how many snapshots have been taken.

Note that a new snapshot is only taken if files have changed.

Bugs

If you find a problem report it to the bug tracker at bugs.contribs.org


References

bugzilla:1549

bugzilla:6858 Wide Links

Shadow Copy topic in the Contribs forums

For background information regarding alternative Linux implementation, although this contrib is not used here

http://www.wlug.org.nz/SambaShadowCopyHowto