Table of Contents
zSync
- A http/https web-server of any kind. To be able to use zSync transfers, it must support the HTTP-Range command.
- Tested webservers: Apache2 and Nginx.
- APACHE 2.2.20 and newer have issues, please use 2.2.19 for the time being. E.g: http://apache.xl-mirror.nl/httpd/binaries/win32/httpd-2.2.19-win32-x86-openssl-0.9.8r.msi
- NGINX for Windows: http://nginx.org/en/docs/windows.html
- note: All versions of Microsoft Windows IIS are currently not supported. Apache is available for Windows too.
- The server can run on any port (doesn't have to be port 80)
- optional; http basic authentication is supported (username+password protection)
- .yml / .yaml mime type needs to be active (Should be configurable in .htaccess file)
- Dotted files need to be allowed (files starting with a dot, like .repository.yml) , specifically, to be allowed to serve: .repository.yml and it's .zsync counter part.
- config.yml hosts url format; http://hostname.domain.net/six
- Tested webservers: Apache2 and Nginx.
rSync
Requires rSync daemon.
Due to issues found in serving rsync repositories by using Cygwin on Windows, we have switched to an alternative method (Virtual Machine based), that is even easier to setup for the mirror hoster.
Ideas welcome though!
VM Details
- VirtualBox (Other VM's might be considered on request)
- 1 CPU and 768 MB memory (Feel free to make these values bigger :D)
- Host-only/NAT networking
- 3 Virtual Disks (These values are just defaults, and can be adjusted to your situation):
- Used / Total Available
- 1.2 / 12 GB - System
- 0 / 4 GB - Swap
- 0 / 16 GB - Rsync Data
- Ubuntu Linux 9.10 server, 32-bit, ssh and rsync
- Rsync limits: 25 max clients. No speed limits set, but can be adjusted.
- Default Ports: 22/TCP, 873/TCP, 873/UDP
Installation
- Download the Virtual Machine (400 MB, on request), Unpack it after download.
- Download and Install VirtualBox
- During installation unselect "Bridged Networking"
- Startup VirtualBox, in the File menu, select "Import Appliance", browse to where you unpacked the virtual machine and select to import it.
- You can select alternative locations to store the virtual harddisks
- When the import is finished, Close VirtualBox
- Run the following commands from a dos command prompt (with admin rights), from the VirtualBox installation folder (default: C:\Program Files\Sun\VirtualBox): Please adjust HostPort 22 and 873 if it applies to your configuration. Don't forget to let us know which ports :D
VBoxManage setextradata "six-rsync-mirror-x86" "VBoxInternal/Devices/e1000/0/LUN#0/Config/ssh/Protocol" TCP VBoxManage setextradata "six-rsync-mirror-x86" "VBoxInternal/Devices/e1000/0/LUN#0/Config/ssh/GuestPort" 22 VBoxManage setextradata "six-rsync-mirror-x86" "VBoxInternal/Devices/e1000/0/LUN#0/Config/ssh/HostPort" 22 VBoxManage setextradata "six-rsync-mirror-x86" "VBoxInternal/Devices/e1000/0/LUN#0/Config/rsynctcp/Protocol" TCP VBoxManage setextradata "six-rsync-mirror-x86" "VBoxInternal/Devices/e1000/0/LUN#0/Config/rsynctcp/GuestPort" 873 VBoxManage setextradata "six-rsync-mirror-x86" "VBoxInternal/Devices/e1000/0/LUN#0/Config/rsynctcp/HostPort" 873 VBoxManage setextradata "six-rsync-mirror-x86" "VBoxInternal/Devices/e1000/0/LUN#0/Config/rsyncudp/Protocol" UDP VBoxManage setextradata "six-rsync-mirror-x86" "VBoxInternal/Devices/e1000/0/LUN#0/Config/rsyncudp/GuestPort" 873 VBoxManage setextradata "six-rsync-mirror-x86" "VBoxInternal/Devices/e1000/0/LUN#0/Config/rsyncudp/HostPort" 873
- Start Virtualbox
- Start the "six-rsync-mirror-x86" Virtual Machine
- Notify us with your ip/hostname/ssh port, and we will start pushing the rsync repositories to the mirror, and test downloading
Automatic startup of the virtual machine
After installation / running the VM, it will not autostart on system restart.
The following details were found that can accomplish autostart:
References
Example "C:\Program Files\Sun\VirtualBox\VBoxHeadless.exe" -s "six-rsync-mirror-x86"
1st, as long as your host has a password then this will work fine and you won't have to login. copy and paste the VBoxVRDP.exe file to a differnt place.
Next right click it and edit the properties. mine looks like this( "C:\Program Files\innotek VirtualBox\VBoxVRDP.exe" -startvm "Mail Server") don't edit the start in location.
Next, add a new scheduled task in windows make sure it starts when windows starts and let it start before you login.
Add you host user name and password and save. reboot and it should be running in the back ground. I don like to see the dos box so I have a ghost exe that runs mine. that way you don't see it running.
2nd way I have added a command in the REG so every time I login it starts. \HKEY_LOCALMACHINE\SOFTWARE\Microsoft\Windows\CurrentVersion\run
Now right click and add a new string. name it then edit it and add the location were to find the batch file or exe file that you want to start. Done. If you use a ghosted exe to run you will have to Kill the VboxVRDP process or rdp into and shut it down.
If you would like more information email me and I will sent you back my notes. Later.
