ethoFS Gateway NODE CENTOS/FEDORA/REDHAT SETUP TUTORIAL



See The Ether-1 Project Documentation Site for more detailed setup instructions


STEP 1 -- Setup VPS and New User For Gateway Node Install/Deployment

**If you are simple upgrading an existing Masternode to a Gateway Node then you can skip to step 2

It is not recommended to run the the node as root so we will walk you through setting up a new username to run the Gateway Node.

Some setup/house-cleaning while logged in as root:

adduser ether1node && passwd ether1node
usermod -aG wheel ether1node

You can now disconnect and re-login to your VPS with the newly created login and finish up with some additional house-cleaning:

sudo yum update
sudo yum install wget systemd -y

STEP 2 -- Download and Install ethoFS Gateway Node Binaries/System Services

We will now download the ethoFS Gateway Node setup script to install the required binaries and create the system services to run the node:

**Make sure you have logged in as the user you created to run the node

wget -N https://ether1.org/scripts/rpm/setupETHOFS.sh

Now update file permissions and run script

chmod +x setup.sh
./setupETHOFS.sh -gatewaynode
*You may need to verify credentials by typing in your login password when script finishes setting up new system service

See The Ether-1 Project Documentation Site for more detailed firewall and server setup information

**Firewall configurations may vary but you will need to allow all traffic on ports 22 (SSH access), 30305 (Ether-1 Node traffic), 4001 (ethoFS/IPFS), 5001 (ethoFS/IPFS) & 80 (ethoFS/IPFS Gateway)

Your node should now be installed/connected.

You can now view the status of your Gateway Node:
sudo systemctl status ethoFS

Or

journalctl --unit=ethoFS -f

The install will force an Ether-1 Blockchain sync/re-sync so you will see a message "Waiting For Ether-1 Node To Finish Sync" until the chain is fully synced (may take a few minutes). You can check on sync status by viewing the Ether-1 node logs/status or just wait patiently.



Once the Ether-1 chain is synced you will see ethoFS attempt to sync it’s own peers and start syncing/downloading any content needed to be spread to your node.



After a few minutes your node health will show as 100% as other nodes on the ethoFS network are now recognizing you as a newcomer to the consensus system.



Your ethoFS Node is live!


You can test to make sure your Gateway Node is now able to serve content by navigating to the below address in your browser

(replace IP ADDRESS with your node ip address).
IP ADDRESS/ipfs/QmX8E3MEhCwmKQ5k1SBfMvnCDQdummkNPhJ7FMKXeS3bJK

If the test hash (ethoFS Website) won’t load, you may need to make sure port 80 is open to TCP traffic and restart your firewall/vps.



To view the status of the Ether-1 node:
sudo systemctl status ether1node

Or

journalctl --unit=ether1node -f


After syncing is complete, you will see a similar note to the Ether-1 Node connection note below





You will need to wait a few minutes for your node information to propagate across the network before registering/verifying it on the node dashboard.


STEP 3 -- Login and Add New Node to Dashboard

**If you are upgrading an existing node to a Gateway Node this section can be skipped - you can simply edit your existing node in your node dashboard and select "Gateway Node". As long as your collateral meets the Gateway Node requirements and your node is active, all verifications will be done automatically.

Access Ether-1 Node Gateway   (nodes.ether1.org)

Click on "Node Dashboard" button




Login With Your Email and Password

Click on "Add Node" button




Enter Required Information:


ETHO Address -> This is the address where you hold your required ETHO node stake (5000 for Service Node or 15000 ETHO for Masternode or 30000 ETHO for ethoFS Gateway Node)
                     *Please note that you will need slightly more than required stake to send verification transaction (0.01 ETHO)
IP Address -> This is the static/public ip address of the VPS running the Ether-1 Masternode/Service Node binary
Node Type -> Select Your Node Type

Click "Add Node" button




STEP 3 -- Verify Ownership/Stake/Active Node

Click on "Details" of the newly added node



Make verification transaction to verify ETHO address ownership

Send a small amount of ETHO (0.01 ETHO) from ETHO address used when node was added to the randomly generated "Verification Address" shown in node details
                     *Please note that this small amount of ETHO will remain in the verification account and will not be recoverable until a future update

DO NOT SEND YOUR ETHO STAKE TO THIS VERIFICATION ADDRESS!



Copy TX hash from verification transaction and add to "Verification TX Hash" in node details



Your node is verified when "Address Verified", "Stake Verified" and "Node Active" all show "Yes" for verified



If "Stake Verified" or "Node Active" verifications fail, you can manually click "Verify"



If "Address Verified" fails, you will need to delete node and start over