Zmanda Windows Client
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.ContentsFeaturesDownloadsSupported versionsIssues and LimitationsInstallationAdding your new Windows client to the Amanda serverAdding dumptype definitions on the Amanda server for Windows clientsTell the Amanda server what to back up on the Windows clientRun amcheck on the Amanda serverRestoring files to the Windows clientRunning ZWC as some other userLog FilesFeaturesBackup of open files (Volume Shadow Services must be enabled)Backs up NTFS filesystemUses open format for backup images (ZIP64)Client backup compression usingdeflate algorithmClient configuration tool - ZWCconfig. Allows configuration of ports that are used and amanda server name.Support for exclude patterns (wildcard * is supported, full path must be specified)Install shield based installer.DownloadsAmanda windows client is available for download fromZmanda downloadspage for Windows 32bit platforms and 64bit x86 platforms.How to find the Amanda client version on Windows machine?Check the file version.txt in the windows client installation directory (usually under C:\Program Files\Zmanda\....) under the misc sub-folder. The file contains version, build date and build revision.Supported versionsZmanda Windows Client works with corresponding version of Amanda server packages (from Zmanda Downloads page).Amanda Windows client has been tested with (all running on x86 and x86_64 platforms)Windows XP Pro (SP 2)Windows 2003 server (SP2)Windows Vista (SP1)Windows 2008 server R2Windows 7Windows 2012 serverWindows 10Issues and LimitationsZmanda 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.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. Seethis threadfor one possible solutionZmanda Windows Client only supports 'estimate server' and 'estimate client', not 'estimate calcsize'. Do not use 'estimate calcsize' with a ZWC DLE.The amanda user on the Amanda server should be "amandabackup". If you want to use a different account, seethis tip.You need to register the server on the windows client (by editing the registry or using the ZWC configuration GUI tool). It currently appears that name resolution does not work (amcheck says something like: Server validation failed). Workaround: use IP address instead of the server's name.InstallationZmanda Windows Client (ZWC) uses Installshield installerDownload ZWC zip archive from the downloads page.Extract the zip archive.Double-click on the setup.exe to install the Windows client.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.If the ZWC is being installed on a Windows machine that uses non "US English" locale, please provide local equivalents.Amanda server information. Please provide hostname of the server that will back up this windows machine. This can be changed later using ZWCConfig tool. On Windows 7, you will have run the ZWCconfig tool as Administrator, add the Amanda server information and restart the ZWC service.Adding your new Windows client to the Amanda serverAdding dumptype definitions on the Amanda server for Windows clientsAdd 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 backupdefine dumptype zwc-normal {globalauth "bsdtcp"maxdumps 1program "DUMP"}Dumptype definition for compressed backupdefine dumptype zwc-compress {globalauth "bsdtcp"maxdumps 1compress client fastprogram "DUMP"}To exclude files:Please use \\ (two back slashes) in the exclude pattern. For example:exclude "D:\\Documents\\Images"To exclude files by extension type, do it like this (Notice: *No* slashes.):exclude "*.foo" "*.bar"Tell the Amanda server what to back up on the Windows clientOn 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-compressDailySet1 - the Amanda configuration name\ - back slash escapes special characters such as white space in file nameszwc-compress - selects a dumptype that will compress backups of the filesystemNote: Ignore the WARNING messages from "amaddclient" about failing to copy files to the Windows Client.Run amcheck on the Amanda serverFix all configuration problems found by the amcheck(8) command. Run amcheck as the amandabackup user on the Amanda server.For example:$ amcheck -c DailySet1If there are no amcheck errors, you are ready to do backup of Windows client. In case of amcheck errors, take a look atamcheck troubleshootingsection.Note: Zmanda Windows Client only supports "bsdtcp" authentication (auth bsdtcp indumptype configuration) protocol.Restoring files to the Windows clientTo 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.Start by determining which dumps you need in order to obtain the most current version of the client's data. You can do this by using amrecover and doing a history of the dumps performed on the client.Example:$ amrecover DailySet1AMRECOVER Version 2.6.1p1. Contacting server on localhost ...220 backups AMANDA index server (2.6.1p1) ready.Setting restore date to today (2010-07-29)200 Working date set to 2010-07-29.200 Config set to DailySet1.200 Dump host set to backups.foobar.com.Use the setdisk command to choose dump disk to recoveramrecover> sethost client1.foobar.com200 Dump host set to client1.foobar.comamrecover> history200- Dump history for config "DailySet1" host "client1.foobar.com" disk "C:/"201- 2010-07-28-23-00-04 1 DailySet1-03:6201- 2010-07-27-23-00-05 0 DailySet1-02:3201- 2010-07-26-23-00-05 1 DailySet1-01:6200 Dump history for config "DailySet1" host "client1.foobar.com" disk "C:/"amrecover>From this you will need to follow the procedure described under the termLevelto determine which dumps to retrieve. NOTE: The dump level is the third column in on the history list. After determining which dumps you need, the tape names can be seen in the last column and the date/time stamp can be obtained for use with amfetchdump by removing the hyphens from the number in the second column in the history list.Next load up the earliest tape in the list of tapes containing the needed dumps.Then use amadmin and amfetchdump to extract the backup image on the Amanda server. You will have to repeat these last two steps in order to extract dumps of multiple backup levels. This has to be performed as "amandabackup" user (or whatever user Amanda runs under on your system).Example:$ amfetchdump DailySet1 client1.foobar.com C:/ 20100727230005Hint:To avoid very long and convoluted filenames, use the -p switch and redirect the output to a filename of your choice.Example:$ amfetchdump -p DailySet1 client1.foobar.com C:/ 20100727230005 > client1_full.zip$ amfetchdump -p DailySet1 client1.foobar.com C:/ 20100728230004 > client1_incr_1.zip
Copy the zipped backup images to the Windows client. They will appear as Microsoft compressed folders. You can also use WinZIP or PKZIP to extract the ZIP archive.
You will need to unzip them inside the directory set in your DLE diskdevice parameter. ie. In the case of the above example, the zip file would need to be extracted in the root directory of the C Drive. This will insure proper recursion.
Running ZWC as some other user
Zmanda Windows Client is installed to run with the user "amandabackup" (all packages from Zmanda downloads page use "amandabackup" as the Amanda user.)As it uses BSD authentication, ZWC requires that the Amanda server is also running with the user "amandabackup".It may not be feasible to change the Amanda user that is being used by the server, in that case, you need to modify the user being used by ZWC.If you have to change the user to "amanda", 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 amanda.
Start regedit and change the following two values to operator:
HKEY_LOCAL_MACHINE\SOFTWARE\Zmanda\ZWC\1.0\Install\BackupUserHKEY_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 .\amanda. Here you have to give the original password.
Restart the ZWC Service.
Log Files
Amanda logsC:\Program Files\Zmanda\Zmanda Client for Windows\Debug\LogFile*.txt
Last updated