Part 3 - Package Installation and Initial Configuration

Logged in as the non-root user, the next step is to install the required packages.

  • Install packages
  • Validate hardware
  • Configure the zend daemon and run a test challenge (this will establish whether the system is capable of passing challenges)



DescriptionCommand
1Set an environment variable to match the Fully-Qualified Domain Name of the node - you will need to type this command and change 'FQDN' (the value between the quotes ' ') to the value used in the domain registration for your node

DO NOT USE CAPITAL LETTERS IN PLACE OF 'FQDN' REPLACE ONLY WITH LOWER CASE!

use only lower case letters like the example

2Add the FQDN variable to the .bashrc file, for the non-root user, this will ensure it is persistent across sessions
3

Update the package cache

4

Install the universe repository and the initial packages (build-essential, software-properites-common, apt-transport-https, lsb-release, dirmngr, pwgen, git, jq ufw, curl, aria2)

For Debian 9, go to the following link after entering the commands to the right


Skip adding the universe repository on Debian systems, DO NOT SKIP THE OTHER ENTRIES IN THIS STEP

Be sure to copy the entire command, especially for long command strings

If using Debian, follow the link in the left column after entering the above command, if not using Debian, continue below

5

Add the Horizen repository to the 'sources.list' file

6Pull the gpg key used to sign Horizen packages

Pulling the gpg key may take some time, if it times out, run it again until it has been imported

Alternate key server if the one above fails to respond

7Export the gpg key and add to apt, this enables package verification
8

Add the repository for certbot

For Debian 9, add the stretch-backports repository in place of the command to the right

DO NOT RUN THIS COMMAND ON DEBIAN NODES!
THIS STEP IS NOT NECESSARY ON UBUNTU >= 20.04 AS CERTBOT HAS BEEN ADDED TO THE UNIVERSE REPOSITORY FROM STEP 4!

9
Update the package cache again with the Horizen and certbot repositories added as sources
10Install the zend daemon and certbot
11Download the required parameters for zend
12

Run zend after installation, read the message, it will then stop

NOTE: Do not restart zend as you will see in the last two lines of the warning message, proceed to step 13 below

13Create a configuration file for zend, copy and paste the entire block of text on the right and paste on the command line

Optional Step - Bootstrap Blocks and Chainstate Folders and Files From an Existing Node - DO NOT PERFORM IF THIS IS YOUR FIRST NODE!
14

These are procedures for individuals with existing nodes with a complete copy of the blockchain to get new nodes synchronized quickly (5 to 10 minutes)



CONTINUE BELOW IF THIS IS YOUR FIRST NODE
15Run zend with the configuration file in place, it should automatically run in the background as a daemon
16

Check that the blocks are increasing, run this command a couple of times with a few seconds in between and verify that the row shown in the example (blocks) shows an increasing number


NOTE: While the zend daemon is starting up, the 'zen-cli getinfo' command will initially return what looks like an error. When the daemon has loaded you will see the output as shown under the command on the right. Therefore do not be alarmed if you see the error shown below prior to the example output.


error code: -28
error message:
Loading block index...














17
Configure a swap file and benchmark a jointsplit operation on your node

Part 3 of 11 - Package Installation and Initial Configuration