From cf58cde47b78789c0c7164dbaad70d688d9dd591 Mon Sep 17 00:00:00 2001 From: Charlie OKeefe Date: Mon, 7 May 2018 11:37:42 -0600 Subject: [PATCH 1/9] Add steps for installing dependencies using Ubuntu 18.04 --- README.md | 1 + .../Ubuntu_18.04.x.md | 94 +++++++++++++++++++ 2 files changed, 95 insertions(+) create mode 100644 dependency_install_steps_by_platform/Ubuntu_18.04.x.md diff --git a/README.md b/README.md index 1a6f3d6..220d649 100644 --- a/README.md +++ b/README.md @@ -20,6 +20,7 @@ Install Dependencies If you're using one of the following platforms, see the linked instructions for that platform: - [Debian 9.x](dependency_install_steps_by_platform/Debian_9.x.md) +- [Ubuntu 18.04.x](dependency_install_steps_by_platform/Ubuntu_18.04.x.md) - [macOS 10.13.x](dependency_install_steps_by_platform/macOS_10.13.x.md) diff --git a/dependency_install_steps_by_platform/Ubuntu_18.04.x.md b/dependency_install_steps_by_platform/Ubuntu_18.04.x.md new file mode 100644 index 0000000..00b5624 --- /dev/null +++ b/dependency_install_steps_by_platform/Ubuntu_18.04.x.md @@ -0,0 +1,94 @@ +# Dependency installation steps for Ubuntu 18.04.x LTS (Bionic Beaver) + +This document assumes you are starting from a fresh install of Ubuntu in the 18.04.x series. + +Most recently tested 2018-04-28 with the following ubuntu release: + +``` +$ lsb_release --description +Description: Ubuntu 18.04 LTS +``` + + + +## Install Git, VirtualBox, Ansible, and GnuPG + +``` +$ sudo apt-get install git virtualbox ansible gnupg2 +``` + + + +## Install Vagrant 2.0.3 or higher + +As of this writing, the vagrant version that Ubuntu 18.04 uses is 2.0.2 so we suggest a later +release in the 2.0.x series. + +``` +$ wget https://releases.hashicorp.com/vagrant/2.0.4/vagrant_2.0.4_x86_64.deb +... +$ sudo apt install ./vagrant_2.0.4_x86_64.deb +... +$ dpkg --status vagrant +Package: vagrant +Status: install ok installed +... +$ rm ./vagrant_2.0.4_x86_64.deb +``` + + + + +## Versions + +Most recently tested 2018-04-28 with the following versions: + + +### Ubuntu + +``` +$ lsb_release --description +Description: Ubuntu 18.04 LTS +``` + + +### Git + +``` +$ git --version +git version 2.17.0 +``` + + +### VirtualBox + +``` +$ virtualbox --help +Oracle VM VirtualBox Manager 5.2.10_Ubuntu +... +``` + + +### Ansible + +``` +$ ansible --version +ansible 2.5.1 +``` + + +### GnuPG + +``` +$ gpg2 --version +gpg (GnuPG) 2.2.4 +... +``` + + +### Vagrant + +``` +$ vagrant --version +Vagrant 2.0.4 +``` From dae24ab3f80c1d34563a6d9444466f619d06da00 Mon Sep 17 00:00:00 2001 From: Charlie OKeefe Date: Mon, 21 May 2018 17:57:57 -0600 Subject: [PATCH 2/9] Minor syntax/grammar cleanup --- README.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/README.md b/README.md index 220d649..958e992 100644 --- a/README.md +++ b/README.md @@ -212,7 +212,7 @@ Update the `gpg_key_id` and `gpg_key_name` entries in `gitian.yml` as follows: `3F14A629C06FA31D59C64FE93F0C2117D53A4A49`. Some versions of gpg may truncate this value, e.g. to 8 or 16 characters. You should be able to use the truncated value. -- `gpg_key_name`: the the part before the @ symbol of the associated email address. In our example +- `gpg_key_name`: the part before the @ symbol of the associated email address. In our example this is `hpotter`. From 1a24a2c54abce6d2df64b86b04899d490570d821 Mon Sep 17 00:00:00 2001 From: Charlie OKeefe Date: Mon, 21 May 2018 17:59:09 -0600 Subject: [PATCH 3/9] Can use 'apt' instead of 'apt-get' --- dependency_install_steps_by_platform/Ubuntu_18.04.x.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/dependency_install_steps_by_platform/Ubuntu_18.04.x.md b/dependency_install_steps_by_platform/Ubuntu_18.04.x.md index 00b5624..0f3dd86 100644 --- a/dependency_install_steps_by_platform/Ubuntu_18.04.x.md +++ b/dependency_install_steps_by_platform/Ubuntu_18.04.x.md @@ -14,7 +14,7 @@ Description: Ubuntu 18.04 LTS ## Install Git, VirtualBox, Ansible, and GnuPG ``` -$ sudo apt-get install git virtualbox ansible gnupg2 +$ sudo apt install git virtualbox ansible gnupg2 ``` From 9f182d481e312d23f6d49e0ff38e936cc2059218 Mon Sep 17 00:00:00 2001 From: Charlie OKeefe Date: Mon, 21 May 2018 17:59:50 -0600 Subject: [PATCH 4/9] Inline instruction on testing github ssh connection --- README.md | 12 +++++++++++- 1 file changed, 11 insertions(+), 1 deletion(-) diff --git a/README.md b/README.md index 958e992..f404696 100644 --- a/README.md +++ b/README.md @@ -143,7 +143,17 @@ Host github.com The 'User' entry should match your github username. -[Test that ssh will successfully use your new key to connect to github.](https://help.github.com/articles/testing-your-ssh-connection/) +Test that ssh will successfully use your new key to connect to github. + +``` +$ ssh -T git@github.com +The authenticity of host 'github.com (192.30.253.112)' can't be established. +RSA key fingerprint is SHA256:nThbg6kXUpJWGl7E1IGOCspRomTxdCARLviKw6E5SY8. +Are you sure you want to continue connecting (yes/no)? yes +Warning: Permanently added 'github.com,192.30.253.112' (RSA) to the list of known hosts. +Hi harrypotter! You've successfully authenticated, but GitHub does not provide shell access. +$ +``` From 5b34223880ed9787dd1ce2f58b4019fecb33ee38 Mon Sep 17 00:00:00 2001 From: Charlie OKeefe Date: Mon, 21 May 2018 18:00:21 -0600 Subject: [PATCH 5/9] Be explicit about directing user to specify tag --- README.md | 6 ++++++ 1 file changed, 6 insertions(+) diff --git a/README.md b/README.md index f404696..25fb12e 100644 --- a/README.md +++ b/README.md @@ -226,6 +226,12 @@ or 16 characters. You should be able to use the truncated value. this is `hpotter`. +## Specify the tag from the zcash repository you want to build + +Update the `zcash_version` entry in gitian.yml with the value of the tag you wish to build. + +For instance, `v1.1.1-rc1` + ## Provision a virtual machine From b62ccfde556762779a71b7a22a047c7041254f38 Mon Sep 17 00:00:00 2001 From: Charlie OKeefe Date: Mon, 21 May 2018 20:58:03 -0600 Subject: [PATCH 6/9] Add rng-tools to the list of packages to install This was seen to fix an issue where gpg2 hung waiting for entropy when generating keys https://chat.zcashcommunity.com/channel/zcash-dev?msg=AkSCfLbihcgtECiig --- dependency_install_steps_by_platform/Ubuntu_18.04.x.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/dependency_install_steps_by_platform/Ubuntu_18.04.x.md b/dependency_install_steps_by_platform/Ubuntu_18.04.x.md index 0f3dd86..c3edaa6 100644 --- a/dependency_install_steps_by_platform/Ubuntu_18.04.x.md +++ b/dependency_install_steps_by_platform/Ubuntu_18.04.x.md @@ -11,10 +11,10 @@ Description: Ubuntu 18.04 LTS -## Install Git, VirtualBox, Ansible, and GnuPG +## Install Git, VirtualBox, Ansible, GnuPG, and rng-tools ``` -$ sudo apt install git virtualbox ansible gnupg2 +$ sudo apt install git virtualbox ansible gnupg2 rng-tools ``` From c4a2fcf26c245cf068dc7c58955d943fa4071465 Mon Sep 17 00:00:00 2001 From: Charlie OKeefe Date: Mon, 21 May 2018 20:59:37 -0600 Subject: [PATCH 7/9] Remove 'optional' label from gpg_key_id entry in gitian.yml This is said to no longer be optional https://chat.zcashcommunity.com/channel/zcash-dev?msg=qG2fZcCBid2vSBcoz --- gitian.yml | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/gitian.yml b/gitian.yml index 698e056..313f9f4 100644 --- a/gitian.yml +++ b/gitian.yml @@ -8,7 +8,7 @@ gpg_key_name: '' git_name: '' git_email: '' - gpg_key_id: '' # optional + gpg_key_id: '' ssh_key_name: '' # optional roles: - role: common From e79c6b6fdb9c71a11da4a5eaed12df9d1e0d6fb4 Mon Sep 17 00:00:00 2001 From: Charlie OKeefe Date: Mon, 21 May 2018 21:02:19 -0600 Subject: [PATCH 8/9] Use 'quick-generate-key' in command instead of 'quick-gen-key' The longer form matches the command's help output. This was originally changed to support earlier versions of gpg but I later encountered other problems with earlier versions and added 2.1.18 as a recommended minimum version number. --- README.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/README.md b/README.md index 25fb12e..b3fe55d 100644 --- a/README.md +++ b/README.md @@ -184,7 +184,7 @@ You can generate a keypair specifically for zcash gitian builds with a command l ``` -$ gpg2 --quick-gen-key --batch --passphrase '' "Harry Potter (zcash gitian) " +$ gpg2 --quick-generate-key --batch --passphrase '' "Harry Potter (zcash gitian) " gpg: key 3F0C2117D53A4A49 marked as ultimately trusted gpg: directory '/home/hpotter/.gnupg/openpgp-revocs.d' created gpg: revocation certificate stored as '/home/hpotter/.gnupg/openpgp-revocs.d/3F14A629C06FA31D59C64FE93F0C2117D53A4A49.rev' From be826cd697b4032860693481e55928a64c293c50 Mon Sep 17 00:00:00 2001 From: Charlie O'Keefe Date: Mon, 3 Dec 2018 11:52:08 -0700 Subject: [PATCH 9/9] change 'last tested' date from 4/28 to 5/21 --- dependency_install_steps_by_platform/Ubuntu_18.04.x.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/dependency_install_steps_by_platform/Ubuntu_18.04.x.md b/dependency_install_steps_by_platform/Ubuntu_18.04.x.md index c3edaa6..62a135b 100644 --- a/dependency_install_steps_by_platform/Ubuntu_18.04.x.md +++ b/dependency_install_steps_by_platform/Ubuntu_18.04.x.md @@ -2,7 +2,7 @@ This document assumes you are starting from a fresh install of Ubuntu in the 18.04.x series. -Most recently tested 2018-04-28 with the following ubuntu release: +Most recently tested 2018-05-21 with the following ubuntu release: ``` $ lsb_release --description @@ -41,7 +41,7 @@ $ rm ./vagrant_2.0.4_x86_64.deb ## Versions -Most recently tested 2018-04-28 with the following versions: +Most recently tested 2018-05-21 with the following versions: ### Ubuntu