Note: you can only build on your host OS. You cannot cross compile.

Stembuild applies a binary diff to a source vhd and creates a stemcell. The binary diff creation is dependent upon rdiff (located in librsync). rdiff is dependent upon (POP3) which is not supported in windows. In order to get around this, a shim has been written in go that is not dependent upon POP3.

• ovftool https://my.vmware.com/web/vmware/details?downloadGroup=OVFTOOL400&productId=353
  1. Update the system path to include ovftool
• librsync https://github.com/charlievieth/librsync
• golang https://golang.org/dl/
  • Set your GOPATH
• stembuild https://github.com/pivotal-cf-experimental/stembuild (Use git clone)

• cmake https://cmake.org/
• MinGW https://sourceforge.net/projects/mingw-w64/
  1. Select x86_64 as the Architecture
  2. Do not use the default root directory (Program Files); use something without spaces (this will save you a lifetime of pain if you decide to compile something that uses Makefiles) for example C:\mingw\mingw-w64\x86_64-7.2.0-posix-seh-rt_v5-rev1
  3. Add gcc and friends to the path (for the above install location you would add C:\mingw\mingw-w64\x86_64-7.2.0-posix-seh-rt_v5-rev1\mingw64\bin to the system path) before the strawberry gcc path.
• git https://git-scm.com/download/win
  1. USE THE DEFAULTS (WITH ONE EXCEPTION)
     • install to C:\Git or any other path without spaces
  2. Update the system path with the git.
• Strawberry Perl http://strawberryperl.com/
  1. Verify the additions to the system path for strawberry perl are after the MinGW bin.

CMake is used to create the necessary header files so that compilation can succeed. You should only have to generate these files once since we only care about the rdiff files.

To generate the correct files:

1. check out the correct librsync branch
   • (Linux and Darwin) mingw64-fseeko64-v2.0.0
   • (Windows) mingw64-fseeko64-v2.0.0-windows
2. open CMake
3. set source folder to librsync
4. set destination folder to librsync/build
5. set CMAKE_INSTALL_PREFIX=librsync/install
6. set CMAKE_BUILD_TYPE=release
7. click configure
8. select MinGW Makefiles as the generator for the project (for Windows)
9. click generate (this generates the .h files)
10. after generating the Makefile you can CD into the build directory and run mingw32-make and mingw32-make test to make sure things are working (also, the tests will not pass - so don't sweat it)
11. copy all source and header files from librsync/src into stembuild/rdiff/
12. copy all source and header files from librsync/build/src into stembuild/rdiff/
13. remove rdiff/rdiff.c (this is because we have rewritten this in go rdiff.go)
14. go install puts the stembuild executable into $GOPATH/bin

Other environments are similar. Be certain to use the correct librsync branch depending on the OS you are targeting

• Note: The windows branch does attempt to build the rdiff executable and does not require the BZIP2 and ZLIB libraries*

librsync: ERROR: (rs_file_copy_cb) seek failed: Invalid argument
renaming stemcell to bosh-stemcell-1200.9.4-build.7-vsphere-esxi-windows2012R2-go_agent.tgz
librsync: ERROR: (rs_job_complete) patch job failed: IO error
Error: RS_IO_ERROR: IO error

This is because you did not use the correct branch when compiling. Use the Windows branch for Windows, and the default branch for the others.