Difference between revisions of "Zmanda Windows Client"

From The Open Source Backup Wiki (Amanda, MySQL Backup, BackupPC)
Jump to navigationJump to search
Line 2: Line 2:
  
 
== Features ==
 
== Features ==
* Backup of open files
+
* Backup of open files (Volume Shadow Services must be enabled)
 
* Backs up NTFS filesystem
 
* Backs up NTFS filesystem
 
* Backup of extended attributes (ACLs)
 
* Backup of extended attributes (ACLs)

Revision as of 19:13, 19 October 2009

Zmanda Windows Client Community Edition is an Amanda client for Windows platform that uses native Win32 API and uses Volume Shadow Services (VSS) for backup.

Features

  • Backup of open files (Volume Shadow Services must be enabled)
  • Backs up NTFS filesystem
  • Backup of extended attributes (ACLs)
  • Uses open format for backup images (ZIP64)
  • Client backup compression using deflate algorithm

Downloads

  • Amanda client (ZWCInstaller-Community-26.zip) is available for download from Zmanda downloads page for 32bit platforms.

Supported versions

  • Zmanda Windows Client 2.6.0 works with Amanda server packages (from Zmanda Downloads page) version 2.6.0 and later releases.
  • Amanda Windows client has been tested with (all running on x86 32bit platforms)
    • Windows XP Pro (Server pack 2)
    • Windows 2003 server
    • Windows Vista
    • Windows 2008 server

Potential issues

  • Zmanda Windows Client only supports bsdtcp authentication. So, the dumptype for ZWC should have "auth bsdtcp".
  • Zmanda Windows Client does not support maxdumps parameter. It does not do backups in parallel. Configuring maxdumps parameter might ZWC service to crash.
  • Zmanda Windows Client uses port 10080 and 10081. No other service on the client should use these ports. ZWC service will fail to start if these ports are used.
  • The amanda user on the Amanda server should be "amandabackup".

Installation

Zmanda Windows Client (ZWC) uses Microsoft installer.

  • Download ZWC zip archive from the downloads page.
  • Extract the zip archive.
  • Double-click on the setup.exe to install the Windows client.

ZWC installer steps

  • Welcome Screen
Welcome01.jpg
  • License agreement
License Agmt 02.jpg
  • Select the installation folder for ZWC
Select Install 03.jpg
  • Choose password for "amandabackup" user. All backups will be performed as this user. The user account is created on the local machine. If the software is being installed on domain controller, the user created in the domain.
User Settings 04.jpg
  • If the ZWC is being installed on a Windows machine using non "US English" locale, please provide local equivalents.
Group Settings 05.jpg
  • Amanda server information. Please provide hostname of the server that will back up this windows machine.
Amanda Server Info 06.jpg
  • Installation notes: Please read before continuing.
Install Notes 07.jpg
  • Rest of the installation steps are self-explanatory.

Adding your new Windows client to the Amanda server

Adding dumptype definitions on the Amanda server for Windows clients

Add dumptype definitions to the Amanda server's configuration file amanda.conf. If you want to share the definitions across all Amanda configurations, please add it to /etc/amanda/template.d/dumptypes file.

  • Dumptype definition for normal backup
define dumptype zwc-normal {
   global
   auth "bsdtcp"
   program "DUMP"
}
  • Dumptype definition for compressed backup
define dumptype zwc-compress {
   global
   auth "bsdtcp"
   compress client fast
   program "DUMP"
}

Tell the Amanda server what to back up on the Windows client

On the Amanda server, run amaddclient to add Windows client filesystems to be backed up

$ amaddclient --config <configuration name> --client <Windows host name> \
  --diskdev <filesystem> --dumptype <dumptype definition>

Example:

$ amaddclient --config DailySet1 --client windowsdesktop.company.com \
  --diskdev \"C:/Documents\ and\ Settings/Sunil/My\ Documents\"  --dumptype zwc-compress
  • DailySet1 - the Amanda configuration name
  • \ - back slash escapes special characters such as white space in file names
  • zwc-compress - selects a dumptype that will compress backups of the filesystem

Note: Ignore the WARNING messages from "amaddclient" about failing to copy files to the Windows Client.

Run amcheck on the Amanda server

Fix all configuration problems found by the amcheck(8) command. Run amcheck as the amandabackup user on the Amanda server.

For example:

$ amcheck -c DailySet1

If there are no amcheck errors, you are ready to do backup of Windows client. In case of amcheck errors, take a look at amcheck troubleshooting section.

Note: Zmanda Windows Client only supports "bsdtcp" authentication (auth bsdtcp in 
dumptype configuration) protocol.

Restoring files to the Windows client

To restore files to the Windows client, the backup image will have to be recovered on the Amanda server and copied to the Windows client. Windows machine to which files being restored to, does not require Amanda software.

  • On the Amanda server, use amadmin and amfetchdump to extract the backup image on the Amanda server. You will have to use amfetchdump repeatedly to extract images of multiple backup levels. It has to be performed as "amandabackup" user.

Example:

$ amfetchdump DailySet1 windowsdesktop.company.com C:/ 20080818143408
  • Copy the backup images to the Windows client. It will appear as Microsoft compressed folder. You can also use WinZIP or PKZIP to extract the ZIP archive.

Running ZWC as some other user

Zmanda Windows Client requires the backup user to be "amandabackup". All packages from Zmanda downloads page use "amandabackup" as the Amanda user.

If you have to change the user to "operator", you can try the following procedure:

  • Follow the standard install, remembering to keep the password around for the modification steps.
  • Start the user administration tool and rename amandabackup to operator.
  • Start regedit and change the following two values to operator:
HKEY_LOCAL_MACHINE\SOFTWARE\Zmanda\ZWC\1.0\Install\BackupUser
HKEY_LOCAL_MACHINE\SOFTWARE\Zmanda\ZWC\1.0\Install\RecoveryUser
  • Start the service administration tool and open properties on ZWC Service, switch to the Log On tab and change the account to .\operator. Here you have to give the original password.
  • Restart the ZWC Service.

Log Files

Installation logs
C:\ZWC_install.log
Amanda logs
C:\Program Files\Zmanda\Zmanda Client for Windows\Debug\LogFile.txt