Setting up an Exscudo Server-Node

What is Exscudo (EON)

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 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/

This tutorial however focuses on the fact that Exscudo have also released the code required to setup a server-node on the testnet, however at this point in time the instructions are very basic and hard to follow for the less tech savvy amongst us.

We will go through the setup required for installations on Linux , Windows and MacOSX.

Linux Installation and configuration

Some experience with installing and running Linux commands will be helpful to follow this tutorial but not essential. If you follow the steps outlined below carefully you will be up and running in no time.

I am assuming you have a newly installed version of Ubuntu Server 16_04 LTS fired up and ready to be configured, this can be either a workstation, a Virtual Machine (VM) or a cloud based instance such as those offered by Amazon Web Services (AWS). If not just follow the instructions below to setup your server before moving on.

�� �!���T

How to Install Ubuntu Linux

Setting up an Exscudo Server-Node

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)

Firrst 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 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. 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 below process to be followed carefully as there are some dependencies that need to be accounted for. The steps are:

· Setup your directory structure

· Download and install the Java SDK

· Set your path and Java_Home environment variables

· Download and extract Apache Maven binaries

· Download and install Git for Windows

· Use Git Bash to clone the exscudo server repository

· Build the Maven package

· 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.

example 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 the 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 located. You do this by setting up environment variables. There are many ways to access the dialog box to enter the variables depending on your version of windows,

Windows 10 environment variables window

the two variables you need to add are:

PATH
C:\exscudo\apache-maven-3.5.0\bin

JAVA_HOME
C:\Program Files\Java\jdk-9

Just add new or edit existing as per below for your operating system.

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 above. Click OK. Close all remaining windows by clicking OK.

5. Click Environment Variables. In the section System Variables, find the JAVA_HOME environment variable and select it. Click Edit. If the JAVA_HOME environment variable does not exist, click New.

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 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. Click Environment Variables. In the section System Variables, find the JAVA_HOME environment variable and select it. Click Edit. If the JAVA_HOME environment variable does not exist, click New.

7. In the Edit System Variable (or New System Variable) window, specify the JAVA_HOME value above. Click OK.

8. 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. Click Environment Variables. In the section System Variables, find the JAVA_HOME environment variable and select it. Click Edit. If the JAVA_HOME environment variable does not exist, click New.

7. In the Edit System Variable (or New System Variable) window, specify the JAVA_HOME value above. Click OK.

8. 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. Click Environment Variables. In the section System Variables, find the JAVA_HOME environment variable and select it. Click Edit. If the JAVA_HOME environment variable does not exist, click New.

5. In the Edit System Variable (or New System Variable) window, specify the JAVA_HOME value above. Click OK.

6. 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. (alternatively click the icon on the desktop or search for app using explorer).

Git Bash Window

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

This will download the files into the exscudo directory.

Now we can build the Apasche 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 Github and run the package build by entering the following commands.

cd server (if currently in the exscudo folder)

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.

Preparing to run

EON Node up and running

To invoke server at any time after configuration is complete just browse to the server directory from a command prompt and enter mvn tomcat7:run again.

Happy blockchaining with Exscudo..

Windows Download Links

Java SDK:

Java SE Development Kit 9 - Downloads

GIT

Git - Downloading Package

Github repository for eon server

EonTechnology/server

Apache Maven files

Maven - Download Apache Maven

Happy exscudo noding.

— — — — — — — — — — — — — — — — — — — — — — — — — — — — — — —

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:

· Setup your directory structure

· Download and install the Java SDK

. Download and extract Apache Maven binaries

· Set your path and Java_Home environment variables

· Download and install Git

· Use Git to clone the exscudo server repository

· Build the Maven package

· 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

http://www.oracle.com/technetwork/java/javase/downloads/jdk8-downloads-2133151.html

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

2. 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

2. 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.

3. Open up a terminal session.

a. Click the Finder icon in your dock.
b. Click Go.
c. Click Utilities.
d. Double-click Terminal.

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

4. 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.

Git - Downloading Package

2. 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

3. 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

4. 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

�֐&��