Ethernity NODE

This repository provides requirements and setup instructions to enable Ethernity NODE capabilities on a computing system.

Hardware requirements:

CPU

Lists with SGX feature enabled are maintained by Intel at:

SGX with Intel® ME SGX with Intel® SPS and Intel® ME

BIOS

SGX must be set to ENABLED by the system owner via BIOS.

Compatible Systems

List of compatible systems:

A list of SGX compatible systems that support Intel SGX is maintained here: https://github.com/ayeks/SGX-hardware

Tested systems

We have tested successfully the following hardware: DELL Optiplex 5040

Software requirements:

Currently the following operating systems are suported:

Ubuntu 20.04
Ubuntu 22.04
Ubuntu 24.04
Slackware 15-current
Debian 12.0

We are planning support for the following operating systems:

Fedora
Rocky
AlmaLinux

Automated Installation

This installer provides an easy way to automate the installation process of an Ethernity Node as much as possible.

Features:

• Automates the system update, kernel update (5.0.0-050000-generic for ubuntu 18.04 and 5.13.0-41-generic for ubuntu 20.04) and runs the ansible-playbook installation process
• Asks the user to generate (using the “ethkey” tool) or to input wallet details from console (node and result)
• Checks wallet balance for Bergs (continues only if Bergs > 0)
• Validates wallet for wrong input
• Prevents the user to continue if the node wallet is the same as the result wallet
• Restarts the system automatically after the system and kernel is updated

1. Clone the repository to the home folder and run it

$ cd && git clone https://github.com/ethernity-cloud/mvp-pox-node.git
$ cd mvp-pox-node
$ ./etny-node-installer.sh

2. Run the script again after system restart

$ cd mvp-pox-node
$ ./etny-node-installer.sh

Maual Installation

1. Install ansible

$ sudo apt update
$ sudo apt -y install software-properties-common
$ sudo apt-add-repository --yes --update ppa:ansible/ansible
$ sudo apt -y install ansible

2. Clone the repository

$ git clone https://github.com/ethernity-cloud/mvp-pox-node.git

3. Install the kernel with SGX support

$ cd mvp-pox-node
$ sudo ansible-playbook -i localhost, playbook.yml \
  -e "ansible_python_interpreter=/usr/bin/python3"

After the first run of the script, the new kernel(with SGX support) is installed and the following message will be displayed:

ok: [localhost] => {
    "msg": "The kernel has been updated, a reboot is required"
}

Reboot the system as requested.

4. Create config file (please use your own wallets):

$ cd mvp-pox-node
$ cat << EOF > config
ADDRESS=0xf17f52151EbEF6C7334FAD080c5704D77216b732
PRIVATE_KEY=AE6AE8E5CCBFB04590405997EE2D52D2B330726137B875053C36D94E974D162F
RESULT_ADDRESS=0xC5fdf4076b8F3A5357c5E395ab970B5B54098Fef
RESULT_PRIVATE_KEY=0DBBE8E4AE425A6D2687F1A7E3BA17BC98C673636790F1B8AD91193C05875EF1
EOF
$

5. Start the node

$ cd mvp-pox-node
$ sudo ansible-playbook -i localhost, playbook.yml \
  -e "ansible_python_interpreter=/usr/bin/python3"

After the second run of the script the node should be successfully installed and the following message will be seen on the screen:

ok: [localhost] => {
    "msg": "Ethernity NODE installation successful"
}

6. Check if the service is running correctly.

Service status can be seen by running the below command.

systemctl status etny-vagrant.service

Ugrading

To upgrade to the latest version, please use the automated installer by running the following commands:

$ cd && cd mvp-pox-node
$ git pull 
$ ./etny-node-installer.sh

Troubleshooting

Failed installation

Backup the ~/mvp-pox-node/config file

$ cd && cd mvp-pox-node
$ git pull
$ rm -rf config
$ ./etny-node-installer.sh

Follow through the prompts and use the same keys and addresses from your backup