Running a Node on Gravity Protocol's Testnet Using a Cloud Server [Tutorial]

Before proceeding

<blockquote> You should have some familiarity with command line. Not much is needed, but basics are a plus. Also note, using a cloud server does cost money. Be prepared to spend ~$20 USD a month. <hr /> <h2>Table of Contents <ol> <li>Setting up a cloud server <li>Using SSH to log into the server <li>Building Gravity <li>Connect to the Testnet <li>Installing and Using Docker <li>Common Troubleshooting <li>Helpful Links <hr /> <h1>1. Setting up a cloud server Starting out, you are going to need a way to run the <a href="/@gravity-protocol">@gravity-protocol node 24/7. I recommend using a cloud server for this purpose. There are a couple of different options to do this (an easy google search for cloud servers), but the one that I like using is Digital Ocean. Set up an account on Digital Ocean using either of the links below (one is a referral and one is not). (referral link) <a href="https://m.do.co/c/721f8e9043d1" target="_blank" rel="nofollow noreferrer noopener" title="This link will take you away from hive.blog" class="external_link">Digital Ocean $10 credit (non-referral link) <a href="https://www.digitalocean.com" target="_blank" rel="nofollow noreferrer noopener" title="This link will take you away from hive.blog" class="external_link">Digital Ocean <hr /> Once you've made an account, you need to create a droplet. The button for creating a droplet is in the upper right corner of the dashboard. Now, there are many different options here for your droplet. These are the absolute basics to get it up and running. For the operating system, choose Ubuntu 16.04. <img src="https://images.hive.blog/768x0/https://cdn.steemitimages.com/DQmfZcV8fdmzMGDfX72saEYmQ4G1uMMDXB2wtYfoMaekCSr/Screen%20Shot%202018-06-10%20at%2010.43.54%20AM.png" alt="Creating a droplet @iamredbar" srcset="https://images.hive.blog/768x0/https://cdn.steemitimages.com/DQmfZcV8fdmzMGDfX72saEYmQ4G1uMMDXB2wtYfoMaekCSr/Screen%20Shot%202018-06-10%20at%2010.43.54%20AM.png 1x, https://images.hive.blog/1536x0/https://cdn.steemitimages.com/DQmfZcV8fdmzMGDfX72saEYmQ4G1uMMDXB2wtYfoMaekCSr/Screen%20Shot%202018-06-10%20at%2010.43.54%20AM.png 2x" /> Next you have to choose how much memory you want. The developers' recommended minimum amount of memory for a node is 4GB. Do not choose any memory option lower than 4GB. <img src="https://images.hive.blog/768x0/https://cdn.steemitimages.com/DQmdMbk21G51cKQhFkG7uVHkMr6Pns1Qtn24xXgHSiHV9GU/Screen%20Shot%202018-06-10%20at%2010.44.40%20AM%20(1).png" alt="Droplet size @iamredbar" srcset="https://images.hive.blog/768x0/https://cdn.steemitimages.com/DQmdMbk21G51cKQhFkG7uVHkMr6Pns1Qtn24xXgHSiHV9GU/Screen%20Shot%202018-06-10%20at%2010.44.40%20AM%20(1).png 1x, https://images.hive.blog/1536x0/https://cdn.steemitimages.com/DQmdMbk21G51cKQhFkG7uVHkMr6Pns1Qtn24xXgHSiHV9GU/Screen%20Shot%202018-06-10%20at%2010.44.40%20AM%20(1).png 2x" /> Towards the bottom, there will be a section with the header Finalize and Create. Here is where you'll name your cloud server something relevant and useful. In this example, the server name is GravityProtocolTestnetTutorial. Next, click create. <img src="https://images.hive.blog/768x0/https://cdn.steemitimages.com/DQmb6gfY1B2m6QynKuwbLq37iicYb2kFw5CtTN6FFtdJobR/Screen%20Shot%202018-06-10%20at%2010.48.43%20AM%20(1).png" alt="Finalize and create droplet @iamredbar" srcset="https://images.hive.blog/768x0/https://cdn.steemitimages.com/DQmb6gfY1B2m6QynKuwbLq37iicYb2kFw5CtTN6FFtdJobR/Screen%20Shot%202018-06-10%20at%2010.48.43%20AM%20(1).png 1x, https://images.hive.blog/1536x0/https://cdn.steemitimages.com/DQmb6gfY1B2m6QynKuwbLq37iicYb2kFw5CtTN6FFtdJobR/Screen%20Shot%202018-06-10%20at%2010.48.43%20AM%20(1).png 2x" /> The page should redirect you to the dashboard where you can see your cloud server being created. This is usually a pretty quick process since a server this size requires less to set up. Allow up to five minutes. Once the loading bar is done, you should see something like the image below (with your server name). The blacked out portion covers the IP address. That is where your IP address for your server will be. Take note of this IP address. <img src="https://images.hive.blog/768x0/https://cdn.steemitimages.com/DQmeQz7caWfaNEupSfwADqG7uG2CpufFoFQJLvddB3CKvA7/Screen%20Shot%202018-06-10%20at%2010.49.53%20AM%20(1).png" alt="Droplet created @iamredbar" srcset="https://images.hive.blog/768x0/https://cdn.steemitimages.com/DQmeQz7caWfaNEupSfwADqG7uG2CpufFoFQJLvddB3CKvA7/Screen%20Shot%202018-06-10%20at%2010.49.53%20AM%20(1).png 1x, https://images.hive.blog/1536x0/https://cdn.steemitimages.com/DQmeQz7caWfaNEupSfwADqG7uG2CpufFoFQJLvddB3CKvA7/Screen%20Shot%202018-06-10%20at%2010.49.53%20AM%20(1).png 2x" /> Since the SSH keys were not used in setting up the cloud server, Digital Ocean will email you the <code>root user password. As mentioned before, this tutorial covers the absolute basics of getting a server running. Adding SSH keys will not be covered in this tutorial. However, adding SSH keys are vital to maintaining a secure server, so establishing some familiarity with them will be necessary in the future. <hr /> <h1>2. Using SSH to log into the server You should now check your email to see if Digital Ocean has contacted you. This is an important step because you need the <code>root user password to log into your cloud server. You CANNOT proceed past this point if you do not have the <code>root user password. This goes for any cloud server service. Take note of the password and the IP address if you haven't already. Up until this point it hasn't mattered what operating system you are using. But now, it kind of does. If you are on a Mac, you can use terminal with the <code>ssh command. If you are on Windows, you can download <a href="https://www.putty.org" target="_blank" rel="nofollow noreferrer noopener" title="This link will take you away from hive.blog" class="external_link">PuTTY. In Terminal on Mac by typing: <code>ssh yourServerIPAddress -l root You are using SSH to log into your server, based on its IP address, and logging in as the <code>root user. It will now ask for the password. You will not be able to see what you are typing, so copy/paste are going to come in handy. The server will realize that you are logging in for the first time as <code>root and require you to change the password. Again, you will not be able to see what you are typing. Create a new, secure password and take note of it. Type <code>clear and enter to clear the screen of those extra distractions. Should look something like this: <img src="https://images.hive.blog/768x0/https://cdn.steemitimages.com/DQmfZ7FHmgw7RBVzY7qXNQt1DkmRQwHzH7xyP8md2D22voL/Screen%20Shot%202018-06-10%20at%2012.47.56%20PM%20(1).png" alt="Root user logged in @iamredbar" srcset="https://images.hive.blog/768x0/https://cdn.steemitimages.com/DQmfZ7FHmgw7RBVzY7qXNQt1DkmRQwHzH7xyP8md2D22voL/Screen%20Shot%202018-06-10%20at%2012.47.56%20PM%20(1).png 1x, https://images.hive.blog/1536x0/https://cdn.steemitimages.com/DQmfZ7FHmgw7RBVzY7qXNQt1DkmRQwHzH7xyP8md2D22voL/Screen%20Shot%202018-06-10%20at%2012.47.56%20PM%20(1).png 2x" /> Congratulations, you are now logged into your cloud server that will soon be a node! <hr /> <h1>3. Building Gravity To start out on your server, let's get things up to date and install the required packages: <code>sudo apt-get update <code>sudo apt-get install git cmake openssl libssl-dev autoconf automake libtool libcurl4-openssl-dev libboost-all-dev build-essential Next, navigate to the home directory using: <code>cd ~ <blockquote> You can verify if you are in the home directory by using <code>pwd command (present working directory). Should print out as <code>/root Now copy, or clone the Gravity-Core code from github and all of its subfolders: <code>git clone https://github.com/GravityProtocol/gravity-core <code>cd gravity-core <code>git submodule update --init --recursive <blockquote> These three lines above shouldn't take more than 2 minutes to finish downloading what they need Prepare package for libtool: <code>libtoolize Delete, or remove, the CMakeCache.txt file and the folder named build: <code>rm -f CMakeCache.txt <code>rm -f -r build Use cmake and give it the path to ssl libraries on your server: <code>cmake -DOPENSSL_ROOT_DIR=/usr/lib/ssl/openssl -DOPENSSL_LIBRARIES=/usr/lib/ssl If everything worked correctly, you should see: <code>-- Build files have been written to: /root/gravity-core Now, build Gravity: <code>make <blockquote> This can take upwards of 30 - 60 minutes, depending on your server configuration. While writing this tutorial with the configuration above, it timed at about 100 minutes. Keep in mind, these are the minimum requirements for a node. <blockquote> Another time I have built Gravity after writing this, it only took 40 minutes with the same configuration. <hr /> <img src="https://images.hive.blog/768x0/https://cdn.steemitimages.com/DQmQh9aK3LGS1zzyHsXUGnCeMZxHAoEk7SBCfbvK5JfzY5B/Screen%20Shot%202018-06-10%20at%208.24.50%20PM%20(1).png" alt="Building Gravity @iamredbar" srcset="https://images.hive.blog/768x0/https://cdn.steemitimages.com/DQmQh9aK3LGS1zzyHsXUGnCeMZxHAoEk7SBCfbvK5JfzY5B/Screen%20Shot%202018-06-10%20at%208.24.50%20PM%20(1).png 1x, https://images.hive.blog/1536x0/https://cdn.steemitimages.com/DQmQh9aK3LGS1zzyHsXUGnCeMZxHAoEk7SBCfbvK5JfzY5B/Screen%20Shot%202018-06-10%20at%208.24.50%20PM%20(1).png 2x" /> Once the process above finishes, you have built Gravity! <hr /> <h1>4. Connecting to the Testnet Create a folder, or make a directory, to run your testnet node and copy the witness_node: <code>mkdir ~/gravity_testnet <code>cd ~/gravity_testnet <code>cp -r ~/gravity-core/programs/witness_node . <code>cd witness_node Start the node so the correct files are generated: <code>./witness_node --data-dir=data --resync-blockchain Stop the node by pressing <code>ctrl + c Use a text editor of your choice (in this case <code>nano) and edit <code>config.ini: <code>nano data/config.ini Add the seed nodes to the P2P connections section of <code>config.ini: <code># P2P nodes to connect to on startup (may specify multiple times) <code>seed-node = testnet-seed-0.gravityprotocol.org:10111 <code>seed-node = testnet-seed-1.gravityprotocol.org:4623 <code>seed-node = testnet-seed-2.gravityprotocol.org:4623 <code>seed-node = testnet-seed-3.gravityprotocol.org:4623 <code>seed-node = testnet-seed-4.gravityprotocol.org:4623 <code>seed-node = testnet-seed-5.gravityprotocol.org:4623 <code>seed-node = testnet-seed-6.gravityprotocol.org:4623 <code>seed-node = testnet-seed-7.gravityprotocol.org:4623 <code>seed-node = testnet-seed-8.gravityprotocol.org:4623 <blockquote> Make sure there are no "#" in front of the seed node addresses. Save the file with <code>ctrl + O Exit nano <code>ctrl + X This is all that needs to be done here, the rest will be done using <code>Docker. <hr /> <h1>5. Installing and Using Docker The instructions to install <code>Docker are here: <a href="https://www.digitalocean.com/community/tutorials/how-to-install-and-use-docker-on-ubuntu-16-04" target="_blank" rel="nofollow noreferrer noopener" title="This link will take you away from hive.blog" class="external_link">How to install Docker. MAKE SURE YOU FOLLOW STEP 2: DOCKER WITHOUT SUDO. If the second step is skipped, this will cause major problems. The instructions to install <code>Docker Compose are here: <a href="https://docs.docker.com/compose/install/" target="_blank" rel="nofollow noreferrer noopener" title="This link will take you away from hive.blog" class="external_link">How to install Docker Compose Make sure both are installed correctly before going beyond this point. To have the correct docker-compose.yml file, copy the code from github: <code>git clone https://github.com/GravityProtocol/gravity-testnet-docker <code>cd gravity-testnet-docker Get the latest <code>Docker image: <code>docker-compose pull Start your new Gravity Protocol Node: <code>docker-compose up -d This will start the node in detached mode. This allows us to do other things while it's running. One way to see what your server is doing is this command (while in the 'gravity-testnet-docker' folder): <code>docker logs --tail 3 --follow gravity-testnet-docker_gravity_node_1 This follows the logs of your node! If you want to get out of following the logs, simply press <code>ctrl + c. The picture below is what the console will look like while it is catching up: <img src="https://images.hive.blog/768x0/https://cdn.steemitimages.com/DQmfDxBNRQ35fPLQcsTeHcDKorvP1EEq94jt5MTV9Gj4hmj/Screen%20Shot%202018-06-10%20at%2010.13.55%20PM%20(1).png" alt="Node syncing @iamredbar" srcset="https://images.hive.blog/768x0/https://cdn.steemitimages.com/DQmfDxBNRQ35fPLQcsTeHcDKorvP1EEq94jt5MTV9Gj4hmj/Screen%20Shot%202018-06-10%20at%2010.13.55%20PM%20(1).png 1x, https://images.hive.blog/1536x0/https://cdn.steemitimages.com/DQmfDxBNRQ35fPLQcsTeHcDKorvP1EEq94jt5MTV9Gj4hmj/Screen%20Shot%202018-06-10%20at%2010.13.55%20PM%20(1).png 2x" /> Picture below is what a node looks like when it is fully synced and receiving blocks in real-time: <img src="https://images.hive.blog/768x0/https://cdn.steemitimages.com/DQmVeSVSsvsYaz2MTrF9F2FeJ3iwKukVgpzbjcuCfhaBQd2/Screen%20Shot%202018-06-10%20at%2010.21.34%20PM%20(1).png" alt="Synced node @iamredbar" srcset="https://images.hive.blog/768x0/https://cdn.steemitimages.com/DQmVeSVSsvsYaz2MTrF9F2FeJ3iwKukVgpzbjcuCfhaBQd2/Screen%20Shot%202018-06-10%20at%2010.21.34%20PM%20(1).png 1x, https://images.hive.blog/1536x0/https://cdn.steemitimages.com/DQmVeSVSsvsYaz2MTrF9F2FeJ3iwKukVgpzbjcuCfhaBQd2/Screen%20Shot%202018-06-10%20at%2010.21.34%20PM%20(1).png 2x" /> <h3>Congratulations! You now have a cloud server that is a node for Gravity Protocol's testnet! <hr /> <h1>6. Common Troubleshooting <ul> <li>SSH will not connect for an unknown reason. <blockquote> If you are outside the US and it will not connect to your cloud server, try using a proxy for your SSH. There have been reports of users outside of the US having trouble using SSH with DigitalOcean. <ul> <li>The user isn't correct when using ssh <code>wrongUserName@yourCloudServer password: <blockquote> When logging into your cloud server, you need to use the <code>-l option with <code>root. If <code>root is not specified, it will use your current username of the machine you are on. <ul> <li><code>There were unauthenticated packages and -y was used without --allow-unauthenticated <blockquote> Run the command again, except use the <code>--allow-unauthenticated option. This is caused if you did not import the GPG key for <code>Docker and tried to install it. <hr /> <h1>7. Helpful Links <ul> <li><a href="https://steemit.com/@gravity-protocol" target="_blank" rel="nofollow noreferrer noopener" title="This link will take you away from hive.blog" class="external_link">Gravity Protocol Steemit <li><a href="https://t.me/gravity_protocol" target="_blank" rel="nofollow noreferrer noopener" title="This link will take you away from hive.blog" class="external_link">Gravity Protocol Telegram <li><a href="https://www.gravityprotocol.org/" target="_blank" rel="nofollow noreferrer noopener" title="This link will take you away from hive.blog" class="external_link">Gravity Protocol Website <li><a href="https://twitter.com/protocolgravity" target="_blank" rel="nofollow noreferrer noopener" title="This link will take you away from hive.blog" class="external_link">Gravity Protocol Twitter <li><a href="https://steemit.com/blockchain/@gravity-protocol/gravity-testnet-instructions-set" target="_blank" rel="nofollow noreferrer noopener" title="This link will take you away from hive.blog" class="external_link">Gravity Protocol Testnet Instructions <li><a href="https://wallet.gravityprotocol.org" target="_blank" rel="nofollow noreferrer noopener" title="This link will take you away from hive.blog" class="external_link">Gravity Wallet <li><a href="https://github.com/GravityProtocol" target="_blank" rel="nofollow noreferrer noopener" title="This link will take you away from hive.blog" class="external_link">Gravity GitHub <li><a href="https://github.com/GravityProtocol/gravity-docs" target="_blank" rel="nofollow noreferrer noopener" title="This link will take you away from hive.blog" class="external_link">Gravity Testnet Docs <li><a href="https://www.digitalocean.com/community/tutorials/how-to-install-and-use-docker-on-ubuntu-16-04" target="_blank" rel="nofollow noreferrer noopener" title="This link will take you away from hive.blog" class="external_link">How to install Docker <li><a href="https://docs.docker.com/compose/install/" target="_blank" rel="nofollow noreferrer noopener" title="This link will take you away from hive.blog" class="external_link">How to install Docker Compose <hr /> If you benefited from the tutorial, consider giving me a follow on Steemit. You can also vote for my witness in the Gravity Testnet wallet, witness address is <code>g2270k0890d2290e2410 <h3><a href="/@iamredbar">@iamredbar <hr /> <h6>this will be updated as needed over the next 6 or so days while it is editable