From 4c7b70507a30b00eaafdb89a19179344537d1bb1 Mon Sep 17 00:00:00 2001 From: sasha Date: Mon, 17 Oct 2022 12:34:47 -0700 Subject: [PATCH] Add instructions for parallel building in `README.md` --- README.md | 4 ++++ 1 file changed, 4 insertions(+) diff --git a/README.md b/README.md index ad41c20..4d08396 100644 --- a/README.md +++ b/README.md @@ -514,6 +514,8 @@ version. ## Provision a virtual machine +Edit the `Vagrantfile` so the `v.memory` and `v.cpus` values are a bit lower than the memory and CPU count in the actual physical machine. If they're set too high then you might badly wedge your machine. + From the project root directory, run: ``` @@ -598,6 +600,8 @@ Once in a shell session in the VM, we're ready to run the gitian build. vagrant@zcash-build:~$ ./gitian-build.sh ``` +If you want to run a parallel build, invoke `./gitian-parallel-build.sh` instead. + The output from `gbuild` is informative. There are some common warnings which can be ignored, e.g. if you get an intermittent privileges error related to LXC then just execute the script again. The most important thing is that one reaches the step which says `Running build script (log in var/build.log)`. If not, then something else is wrong and you should let us know. Take a look at the variables near the top of `~/gitian-build.sh` and get familiar with its functioning, as it can handle most tasks.