Difference between revisions of "ShadowCopy"

From SME Server
Jump to navigationJump to search
(added headings and section for Adding ibays and users to your server)
(updates)
Line 1: Line 1:
 
== ShadowCopy ==
 
== 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.
  
==='''Overview'''===
+
This works for Windows XP and above.
  
This Howto is based on information contained in [[bugzilla:1549]].
+
To obtain a client for Windows 2000SP3+ download from [http://technet.microsoft.com/en-gb/windowsserver/bb405951.aspx here].
  
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.
 
A client is installed by default in Windows XP.
 
To obtain a client for Windows 2000SP3+ download from [http://technet.microsoft.com/en-gb/windowsserver/bb405951.aspx here].
 
  
 +
===RPM version requirements===
 
This functionality is included in e-smith-samba since version 1.14.0-20.
 
This functionality is included in e-smith-samba since version 1.14.0-20.
 
Please report any bugs to [[bugzilla:1549]].
 
 
==='''Configuration'''===
 
 
====RPM version requirements====
 
  
 
To check the installed rpm version
 
To check the installed rpm version
Line 22: Line 15:
 
On a SME Server 7.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====
 
====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 33: Line 27:
 
  db accounts setprop ibay2 ShadowCopy disabled
 
  db accounts setprop ibay2 ShadowCopy disabled
  
{{Note box|For the script to work correctly, leave two or more users enabled. This is a bug in the current package and is being looked at in bugzilla.}}
+
{{Note box|For the script to work correctly, leave two or more users enabled. Fixed in e-smith-samba-???.}}
 
 
  
 
To re-enable any disabled ibays or users do:
 
To re-enable any disabled ibays or users do:
Line 46: Line 39:
  
 
====Adding ibays and users to your server====
 
====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.
 
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====
 
====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 59: Line 50:
 
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 to take a copy of the entire /home/e-smith/files directory plus any changes that take place.}}
+
{{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.}}
  
 
+
====Setup Cron====
A suitable cron job that runs the script every hour from 10am to 5pm on weekdays would contain the following (adjust to suit your requirements):
+
A cron job that runs the script every hour from 10am to 5pm on weekdays would contain the following. Adjust to suit your requirements, Shadow copy keeps 64 copies so you may like to save less often.
  
 
Create a file
 
Create a file
Line 85: Line 76:
 
  /etc/init.d/crond restart
 
  /etc/init.d/crond restart
  
 +
====Location of ShadowCopy files====
  
In Windows access the snapshot files via Windows Explorer file properties page, Previous Versions tab.
+
NB. Users recover files with windows explorer.
 
 
A Windows client exists in WinXP SP2
 
 
 
To obtain a client for Windows 2000SP3+ download from [http://technet.microsoft.com/en-gb/windowsserver/bb405951.aspx here].
 
 
 
  
====Location of ShadowCopy files====
+
The ShadowCopy files are located in:
 
 
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 106: Line 91:
 
Note that a new snapshot is only taken if files have changed.
 
Note that a new snapshot is only taken if files have changed.
  
Feedback to the bug tracker at
+
===Bugs===
[[bugzilla:1549]]
+
If you find a problem report it to the bug tracker at bugs.contribs.org
 +
 
  
==='''References:'''===
+
===References===
  
 
[[bugzilla:1549]]
 
[[bugzilla:1549]]

Revision as of 00:11, 28 March 2008

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. Fixed in e-smith-samba-???.


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
signal-event ibay-modify Primary


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, Shadow copy keeps 64 copies so you may like to save less often.

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.

The maximum number of snapshots is 64.

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

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