BackupPC Windows Client Files

BackupPC Windows client
  Version 1.01, released 2017-05-22
  See http://backuppc-windows-client.sourceforge.net/

This contains a script file to install a working BackupPC client on
Windows and all files needed to run backup from BackupPC. It uses Cygwin, SSHD, WGET and RsyncD.

Tested on Windows Server 2008R2, 2012R2 and 2016. Running BackupPC on about 30 Windows servers daily.

********************************************************************************
**** Does not work on Windows 7 - Diskshadow are not included in Windows 7. ****
********************************************************************************

Installation - the simple way
1. Download installation file, Install_BackupPC_Windows.cmd. You can do it simple with Powershell:
   powershell.exe -Command (new-object System.Net.WebClient).DownloadFile('https://sourceforge.net/projects/backuppc-windows-client/files/Install_BackupPC_Windows.cmd/download','C:\temp\Install_BackupPC_Windows.cmd')
   
2. Run the file Install_BackupPC_Windows.cmd

3. Set a password for Rsyncd user backuppc in the file rsyncd.secrets
   when it is opened in Notepad.
   This password will you use in the BackupPC config to connect via 
   Rsync to the client.
   
4. Last in the installation you will se some command you have to do 
   on the BackupPC server.
   These commands will put a ssh key on the client to allow user 
   backuppc to connect via SSH without password.
     On BackupPC server logged in as root:
        1. su backuppc
           # Just to create /home/backuppc folder to store keys
	    2. ssh SERVERNAME -p 2022
			  exit
	    3. # Copy key to server
	       ssh-copy-id -p 2022 backuppc@SERVERNAME
	    4. # Now you can login via ssh without password
	       ssh SERVERNAME -p 2022
			  exit
	    
5. Add the client as host in BackupPC web interface

6. Xfer settings
	- XferMethod: rsyncd
	- RsyncShareName: backuppc
	- RsyncShareName: add as many RsyncShareName's you need. You have to add them in rsyncd.conf to, see point 8.
	- RsyncdUserName: backuppc
	- RsyncdPasswd: YOUR PASSWORD from point 3.
	
7. Backup Settings
	- DumpPreUserCmd: $sshPath -q -x -l backuppc -p 2022 $host "/backuppc/pre-cmd.cmd"
	- DumpPostUserCmd: $sshPath -q -x -l backuppc -p 2022 $host "/backuppc/post-cmd.cmd"
	
8. To add more folders to backup edit the file rsyncd.conf
   Downloaded from server and then located in c:\cygwin\backuppc\rsyncd.conf
   
Installation - more choices
1. Set up a folder on a http or ftp server, 
	ex http://myserver.net/files/backuppc/
2 Copy all the code from the project, 
	https://sourceforge.net/p/backuppc-windows-client/code/ci/master/tree/
   to your server/folder, point 1.
3. Edit the file Install_BackupPC_Windows.cmd,
	- line 44: "WebbServer" to your server
4. Edit the file update.sh,
	- line 47: "SCRIPT_DOWNLOAD_SERVER" to your server
	- line 48: "CONFIG_DOWNLOAD_SERVER" to your servder
5. Add folder on the http/ftp server, configs/$HOSTNAME, 
	ex ttp://myserver.net/files/backuppc/configs/SERVER01
6. Put specific rsyncd.conf files in the folder in point 5 for all your
   server. This will let them to update their rsyncd.conf file before 
   backup starts.
7. If you ad something extra in the rsyncd.conf file you have to add
   this in the webb interface under "RsyncShareName"
8. Download installations file from your server, 
	Install_BackupPC_Windows.cmd
9. Do the above "Installation - the simple way" point 2 - 7.


Information

- File pre-cmd.cmd creates an avent in Windows event log and this initiates a task.
- File pre-create_shadow.cmd starts and runs as system account. This is because backupshadow needs rights to all files on server.
  The file pre-create_shadow.cmd also creates pre-DiskShadowScript.txt each time it is running. That's because all the disks will come with even if changes happen.
  The file also starts pre-special.cmd if it exists. There you can put server specific commands.
- Backup starts, rsyncd.
- File post-cmd.cmd creates an avent in Windows event log and this initiates a task.
- File post-remove_shadow.cmd drops all Windows shadow copies. 
  The file also starts post-special.cmd if it exists. There you can put server specific commands.

End