Exscudo - Setting up an EON Server Node

in #cryptocurrency • 7 years ago

Exscudo

Exscudo are setting themselves up to be the gateway between the traditional economy and the cryptocurrency market. They are striving to create a blockchain platform which unites the world of traditional finance and the cryptocurrency market. Their main goal is to create an easy-to-use, fast, legal, and secure way to access the cryptocurrency market for every person with access to the Internet and credit card.

EON is the Blockchain they are creating and October 4th 2017 saw Exscudo reach their first milestone with the release of the testnet. This testnet is open for public testing now, instruction on how to be a part of the tetnet can be found here.

*https://blog.exscudo.com/exscudo/how-to-connect-to-the-eon-blockchain-testnet-comprehensive-instruction/

While testing transactions on the blockchain is interesting I want to focus on the fact that Exscudo have also released the code required to setup a server-node, once the mainnet goes live, users who setup a masternode are rewarded with part of the transaction fees and as such can generate a passive income. (Please note at time of writing that 25,000 EON will be required to setup a masternode). This tutorial will go over the steps required to setup a node on the testnet in preparation for release of the mainnet in Q1 2018. I will go through the setup required for installations on Linux, Windows and MacOSX.

Linux install and Configuration

The basic workflow to setup a node goes like this.

  1. Install Ubuntu (you’ve done this already haven’t you)
  2. Configure repositories for downloading required software packages
  3. Download and install latest Version of Java SDK (Version 8)
  4. Setup the Java Path
  5. Use git to clone the required files from the EonTechnology Github
  6. Download and extract the Maven Packages
  7. Build the Maven packages
  8. Run the Tomcat Server
  9. Bask in the glory

Lets Get this party started

Configure Repositories

First thing we want to do is ensure that when we build and run Maven that we do not run into any dependency issues, so our first step is to setup the server to locate and download the required software packages. To do this we are going to use apt
Please enter each of the following commands one by one waiting for the server to finish processing before moving on to the next command.
Lets Make sure OS Package list and OS Packages are up to date

sudo apt-get update && sudo apt-get -y upgrade

Now lets add the PPA repository in preparation to install Java SDK via PPA.

sudo apt-get install software-properties-common
sudo apt-add-repository ppa:webupd8team/java
sudo apt-get update

Install Java

Now that we have everything setup we can use apt to download and install Java

sudo apt install oracle-java8-installer

Install Maven

Apache Maven is a software project management and comprehension tool. Maven can manage the build of the Exscudo node from a central piece of information that is downloaded along with all the required server files.
First step is to download the Maven binaries, we will do this using wget but first its best to place the download into a directory of your choosing. My preference is to create the directories in /opt but its really up to you as long as you remember where you created the directory structure. For reference the directory structure referenced in this document is

  • /opt/ (we will use wget to download apache maven from this directory)
  • /opt/apache-maven-3.5.0/ (created when the apache zip file is extracted)
  • /opt/exscudo-node/ (manually created to store the server node files)
  • /opt/exscudo-node/server (directory created when the repository is cloned using git)
    First lets navigate to opt.

cd /opt

Now lets download Apache Maven using wget (I am using my closest repository)

wget http://apache.mirror.serversaustralia.com.au/maven/maven-3/3.5.0/binaries/apache-maven-3.5.0-bin.zip

Once download is complete we need to extract the files using zip, if zip is not installed on your system then simply run the following command to install.

sudo apt install zip

Then run

unzip apache-maven-3.5.0-bin.zip

In order for maven to run you need to add the maven bin directory to $PATH this done by running the following command.

export PATH=/opt/apache-maven-3.5.0/bin:$PATH

(The section in green after PATH= is relevant to where you unzipped the maven directory)
Now that Maven is downloaded and Java knows where to locate the bin directory we need download the exscudo server files from github. We will do this using git to clone the entire directory.

First lets install git.

sudo apt-get install git-core

Now lets make the directory for the files

cd /opt
mkdir exscudo-node
cd exscudo-node

Now we can clone the directory from github

git clone git://github.com/EonTechnology/server.git

Now we can build the maven package but we need to ensure we are in the directory that we cloned as the command needs to find the files required for the build.

cd server
mvn package

You will now see a lot of information fill the screen as the package is built. This may take some time dependant on the specifications of your build. Once this has completed you are ready to run your server-node… yaaay
So to run the node just simply enter the following from within the server directory.

mvn tomcat7:run

You are now up and running.

Notes:

If you shutdown your computer for any reason then you may need to add the path again( This can be stopped by adding the path in .bash_profile).
There is no need to build the package again but ensure you run tomcat from within the server directory.

Windows Installation and Configuration

Some experience with creating directories and using the command line is required. You will also be required to use a BASH shell for working with GIT but this is explained in detail in the relevant section
Installing and setting up a node on Windows requires the process below to be followed carefully as there are some dependencies that need to be accounted for.

  1. Setup your directory structure
  2. Download and install the Java SDK
  3. Set your path and Java_Home environment variables
  4. Download and extract Apache Maven binaries
  5. Download and install Git for Windows
  6. Use Git Bash to clone the exscudo server repository
  7. Build the Maven package
  8. Run the server

When setting up the server node it is best practice to build your directory structure first, which in this case involves creating a folder to house the server and Apache Maven files.
For this tutorial you just need to create a folder called exscudo at the top level of the C: Drive ( you can create this folder anywhere if you prefer just remember the path and adjust the following steps to point to your path accordingly) You can do this through explorer or a command prompt, it’s your choice.
From a command prompt

*cd C:*
mkdir exscudo

Java SDK

You will need the latest version of the Java SDK which can be downloaded from the links at the bottom of this article. Just

  • download the file and double click to run the installer.
  • Accept all the defaults then move on to the next step

Apache Maven

Download the Apache Maven binaries from web page of the link below (apache-maven-3.5.0-bin.zip) and extract the files into the exscudo folder using your favourite unzip program. Remember or write down the full path as you will need it in the next step.

Set environment variables

You need to let Java know where the Maven bin directory is located and let Apache Maven know where the Java SDK is. You do this by setting up environment variables. There are many ways to access the dialog box to enter the variables, the two variables you need to add are:

Edit PATH to add C:\exscudo\apache-maven-3.5.0\bin (leave any current settings)
Add Java_Home with a setting of C:\Program Files\Java\jdk-9

here are the main ways to locate the environment variables dialog box for each version of windows.

Windows 10 and Windows 8

  1. In Search, search for and then select: System (Control Panel)
  2. Click the Advanced system settings link.
  3. Click Environment Variables. In the section System Variables, find the PATH environment variable and select it. Click Edit. If the PATH environment variable does not exist, click New.
  4. In the Edit System Variable (or New System Variable) window, specify the value of the PATH environment variable. Click OK. Close all remaining windows by clicking OK.

Windows 7

  1. From the desktop, right click the Computer icon.
  2. Choose Properties from the context menu.
  3. Click the Advanced system settings link.
  4. Click Environment Variables. In the section System Variables, find the PATH environment variable and select it. Click Edit. If the PATH environment variable does not exist, click New.
  5. In the Edit System Variable (or New System Variable) window, specify the PATH value above. Click OK.
  6. In the Edit System Variable (or New System Variable) window, specify the JAVA_HOME value above. Click OK.
  7. Close all remaining windows by clicking OK.

Windows Vista

  1. From the desktop, right click the My Computer icon.
  2. Choose Properties from the context menu.
  3. Click the Advanced tab (Advanced system settings link in Vista).
  4. Click Environment Variables. In the section System Variables, find the PATH environment variable and select it. Click Edit. If the PATH environment variable does not exist, click New.
  5. In the Edit System Variable (or New System Variable) window, specify the PATH value above. Click OK.
  6. In the Edit System Variable (or New System Variable) window, specify the JAVA_HOME value above. Click OK
  7. Close all remaining windows by clicking OK.

Windows XP

  1. Select Start, select Control Panel. double click System, and select the Advanced tab.
  2. Click Environment Variables. In the section System Variables, find the PATH environment variable and select it. Click Edit. If the PATH environment variable does not exist, click New.
  3. In the Edit System Variable (or New System Variable) window, specify the PATH value above. Click OK.
  4. In the Edit System Variable (or New System Variable) window, specify the JAVA_HOME value above. Click OK
  5. Close all remaining windows by clicking OK.

Git

Once you have the installation and configuration of Java done you need to download and install GIT. This will allow you to create repository for the server files that van be upgraded using simple commands from the GIT Bash shell
Download git from the link below and install accepting all defaults. On completion of the install check the box marked run git bash and wait for the bash shell to open.
Use the following commands to setup your git repository from the GIT bash shell

*cd /c/exscudo
*git init
*git clone git://github.com/EonTechnology/server.git

Now we can build the maven package but we need to ensure we are in the directory that we cloned as the command needs to find the files required for the build.
Close bash and go to your command prompt to change to the server directory created when you cloned the files from githuib and run the package build.

*cd server
*mvn package

You will now see a lot of information fill the screen as the package is built. This may take some time dependant on the specifications of your build. Once this has completed you are ready to run your server-node… yaaay
So to run the node just simply enter the following from within the server directory.

*mvn tomcat7:run

You are now up and running.
Happy blockchaining with Exscudo.

Windows Download Links

Java SDK

http://www.oracle.com/technetwork/java/javase/downloads/jdk9-downloads-3848520.html

GIT

https://git-scm.com/download/win

Github repository for eon server

https://github.com/EonTechnology/server

Apache Maven files

*https://maven.apache.org/download.cgi

MACOSX Installation and Configuration

This tutorial was tested on Mac OSX 10.9 High Sierra. Some experience with creating directories and using the bash terminal is required. Installing and setting up a node on a Mac requires the below process to be followed carefully as there are some dependencies that need to be accounted for. The steps are:

  1. Setup your directory structure
  2. Download and install the Java SDK
  3. Download and extract Apache Maven binaries
  4. Set your path and Java_Home environment variables
  5. Download and install Git
  6. Use Git to clone the exscudo server repository
  7. Build the Maven package
  8. Run the server

To make this tutorial simple we will create a folder on the Mac Desktop to download our files into. We will also clone the server repository into this directory. If you are more comfortable with navigating through the Mac directory structure you can create your folder anywhere as long as you remember the path

  • Right Click on your Mac desktop and select New Folder
  • Name your folder Exscudo

Install and configure Java

  1. Download Java from the following link

Make sure you download jdk-8u144-macosx-x64.dmg from the list

  1. Double click the dmg file and run the package installer as per normal mac install procedures

Install and configure Maven

  1. Download Apache Maven for Mac (only needed for Mac versions 10.6.8 and above as older versions have Maven built in). You can check if maven is installed already by running the command mvn -version from within a terminal session.

http://apache.melbourneitmirror.net/maven/maven-3/3.5.0/binaries/apache-maven-3.5.0-bin.zip

  1. Move the file to your Exscudo folder and double click it, this will extract the folder and its contents. You can delete the zip file when done.
  2. Open up a terminal session
  3. Click the Finder icon in your dock
    1. Click Go
    2. Click Utilities
    3. Double-click Terminal

The Terminal session will open in your home directory by default which is what we want.

  1. Type the following command in your terminal
  • vi .bash_profile

this will start a vi editor session. press a on your keyboard to put vi into edit mode and enter or paste the following 2 lines (replace xx with your username this is what is displayed in front of the $ in the terminal window)

  • export M2_HOME=/Users/xx/Desktop/Exscudo/apache-maven-3.5.0
  • export PATH=$PATH:$M2_HOME/bin

press esc to exit edit mode then type :wq to save and exit back to the terminal
test by typing mvn -version you should see the following

Maven home: /Users/xx/Desktop/Exscudo/apache-maven-3.5.0
Java version: 1.8.0_144, vendor: Oracle Corporation
Java home: /Library/Java/JavaVirtualMachines/jdk1.8.0_144.jdk/Contents/Home/jre
Default locale: en_AU, platform encoding: UTF-8
OS name: “mac os x”, version: “10.13”, arch: “x86_64”, family: “mac”

Install and configure git

1.Download git from the below link.

  1. locate and double click the dmg file, run the package installer as per normal mac procedure. git will now be a valid command in your terminal
  2. In your terminal make sure you are in the desktop folder by typing pwd if not then use cd command to navigate to it (possibly cd Desktop/Exscudo if you are using same terminal session as before
  3. Type the following command from within the Exscudo folder.

git clone git://github.com/EonTechnology/server.git

this will download the server repository ready for the package configuration.
When this finishes type cd server in the terminal to navigate to the server directory then run the following command.

  • mvn package

You will now see a lot of information fill the screen as the package is built. This may take some time dependant on the specifications of your build. Once this has completed you are ready to run your server-node… yaaay
So to run the node just simply enter the following from a command prompt within the server directory.

  • mvn tomcat7:run

You are now up and running.
Happy Exscudo noding

I hope you have enjoyed this tutorial, dont forget to upvote if you like it.

#exscudo #blockchain #tutorial
7 years ago in #cryptocurrency by
$0.00
    4 votes
    Reply 2
    Sort:  
  • Trending
    • [-]
     7 years ago  

    That's great we need to spread this great news for the great of the project.

    $0.00
      Reply
      [-]
       5 years ago  

      Congratulations @ramakunga! You received a personal award!

      Happy Birthday! - You are on the Steem blockchain for 2 years!

      You can view your badges on your Steem Board and compare to others on the Steem Ranking

      Do not miss the last post from @steemitboard:

      The new SteemFest⁴ badge is ready
      Vote for @Steemitboard as a witness to get one more award and increased upvotes!
      $0.00
        Reply