Setting up a Delegate for the Public Test Network (testnet.lisk.io) — Updated v0.2.0

The official public test network has been officially opened! Now you can test your nodes, either locally or on a VPS, on the public test network. If you’re interested in becoming a Delegate, this is the best way to ensure your Lisk node runs perfectly. Log in to lisk.chat if you are interested, Oliver or myself will vote you into the active delegation.

This guide is aimed for people who want to set up a Delegate node during the first week of launch. I will try to keep this guide as straightforward as possible for those who wish to test the delegation, but don’t know where to start or what to do. It will be focused on launching a Delegate on a Virtual Private Server (e.g. DigitalOcean, Vultr, Microsoft Azure, AWS) of Ubuntu 14.04.4 x64.

Creating a Virtual Private Server (VPS)

Click here for instructions on creating a VPS, you can follow the first half of the tutorial.

My home setup is a Windows 10 64-Bit computer. I use several programs to aid me in managing the Virtual Private Server. I recommend to download the following if you are running Windows:
PuTTY — PuTTY is an open source SSH and telnet client. Used for remote accessing your VPS.
PuTTYgen — An RSA and DSA key generation utility.
WinSCP — WinSCP is an open source free SFTP client, FTP client, WebDAV client and SCP client for Windows. Its main function is file transfer between a local and a remote computer. Very handy and a great user interface.

Create your Lisk Delegate Node

1. Download the current test network zip archive:

wget https://downloads.lisk.io/lisk/test/lisk-Linux-x86_64.tar.gz

2. Decompress the archive:

tar -zxvf lisk-Linux-x86_64.tar.gz

3. Change directory:

cd lisk-Linux-x86_64

4. Enable coldstart (Only need to be done once):

bash lisk.sh coldstart

To access the Lisk web client, open: http://localhost:7000/, replacing localhost with your public IP address. The Lisk web client should launch successfully.

Register as a Delegate

You need to make sure to register as a delegate beforehand or you will not be able to forge a single block. Registering as a Delegate costs 100 LISK at present time. If you are in need of LISK, you can try the faucet, it distributes 1000 LISK per IP address. If the faucet has automatically blocked your IP address, contact me (joel) on lisk.chat and I will personally send you some LISK.

1. Login to your Lisk web client.

2. Create an account (Create a new one for the purpose of testing).

3. Click “Forging” on the Left Header of the client.

4. Click “Delegate Registration” on the top right corner. It will ask for a delegate name (you may choose whatever you like).

After registering as a Delegate, you are now ready to begin forging. For you to get voted into the 101 Active Delegates, reply here with your delegate registration name and your current rank. Since this is the public testnet, we are in control of the majority of the funds, and with it, the majority of the votes.

To Enable Forging

Let’s begin forging! This will secure the network and you will receive forging rewards on top of the transaction fees from the Lisk network.

1. Stop the recently created node:

bash lisk.sh stop

2. Open the config.json file:

nano config.json

3. Arrow down until you find the following section:

"forging": {
"secret" : [""]
}

4. Set the secret parameter to your account secret phrase.

"forging": {
"secret" : ["YourDelegatePassphrase"] <- Replace with your delegate passphrase
}

5. To set 2 accounts to forge on a single node, enter both account passphrases like below.

"forging": {
"secret" : ["YourDelegatePassphrase1","YourDelegatePassphrase2"] <- Replace with your delegate passphrases
"access": {
"whiteList": ["127.0.0.1"]
}
}

After you have typed in your passphrase. Hit: Ctrl+ X Then: Y

6. Start Lisk:

bash lisk.sh start

To access the Lisk web client, open: http://localhost:7000/, replacing localhost with your public IP address. The Lisk web client should launch successfully.

Useful Additional Commands

These commands are optional and enable the user to check, monitor, start and/or stop the node.

To check the status of lisk:

bash lisk.sh status

To monitor the log file of lisk:

bash lisk.sh logs

To stop/restart/start lisk:

bash lisk.sh stop
bash lisk.sh start
bash lisk.sh restart

To replace the blockchain with a new snapshot:

bash lisk.sh rebuild

Hope this helps,

Max, Oliver and Joel