How to start the epoch test net?

aeternity-team · May 14, 2018, 10:33am

Hey @AELifer and @rebelnz,

Thank you for your question, your request has been forwarded to our dev team.

We’ll try to prepare a detailed written or video guide and share it in the FAQ section.

We’ll keep you posted.

The AE Team

AELifer · May 14, 2018, 10:17pm

@aeternity-team Thank you very much!

Am looking forward to it, and will definitely share the guide around when it is ready!!!

aeonwise · May 15, 2018, 5:57pm

Will there be a GUI for mining when the mainnet starts for people who are not very computer inclined?

aeternity-team · May 16, 2018, 2:12pm

Hi @AELifer and @rebelnz,

Here is the response of our dev team:
You should start from the release notes of the version you run, the latest ones being here:

https://github.com/aeternity/epoch/blob/master/docs/release-notes/RELEASE-NOTES-0.14.0.md

Each version release notes has important information about new features and BC breaks.
Then, there is a pretty exhaustive documentation on how to install an epoch node from binary here:

github.com

aeternity/aeternity/blob/master/docs/installation.md

# Introduction

This document describes how to install an Aeternity node using a release binary either by:

* [Quick install](#quick-install);
* [Install from a package manager](#package-install);
* [Install from a tarball](#tarball-install).

## Quick install

Run below command to install latest version of aeternity node and follow the instructions:

```bash
bash <(curl -s https://install.aeternity.io/install.sh)
```

While this method is the easiest one it is not recommended for production systems.

## Package Install

This file has been truncated. show original

How to start an epoch node from source here:

github.com

aeternity/aeternity/blob/master/docs/build.md

# Introduction

This document describes how to build an Aeternity node from source on:

- Ubuntu 18.04 LTS
- Ubuntu 20.04 LTS
- MacOS (latest)
- Archlinux 20210404
- openSUSE Leap 15.2

While the package should build on most linux distributions that's not verified (in CI) for each release on other than the below platforms:

- Ubuntu 18.04 LTS
- MacOS (latest)

The commands below assume you are logged in with `sudo` user.

The node have couple of main dependencies that have to be installed to build it from source:

- [Erlang/OTP 23.3.4.5](http://erlang.org/doc/installation_guide/INSTALL.html)

This file has been truncated. show original

And how to configure an epoch node installed using a release binary:

github.com

aeternity/aeternity/blob/master/docs/configuration.md

# Introduction

This document describes how to configure your Aeternity node installed using a release binary for joining a public network of nodes (e.g. testnet) knowing an initial network peer to join.

## User-provided configuration

The `aeternity` system supports user-provided parameters via a JSON- or YAML-formatted config file.

### File name and location
The format of the config file is determined from the file extension: `.json` for JSON, or `.yaml` for YAML.

The location of the file can be specified in a few different ways, in order of priority:

1. The OS environment variable `AETERNITY_CONFIG` contains a filename
2. The Erlang/OTP environment variable `-aecore config` contains a filename
3. A file named `aeternity.{yaml,json}` exists in `${HOME}/.aeternity/aeternity/`
4. A file named `aeternity.{yaml,json}` exists in `${AETERNITY_TOP}/`

If all above checks fail, no user configuration is applied.

This file has been truncated. show original

If there is still something unclear, don’t hesitate to reach out and ask.

Thank you,
The AE Team

AELifer · May 16, 2018, 6:38pm

Thanks SO much guys! Looks good, will get started right away…

vlad.chain · May 17, 2018, 9:39am

You are more than welcome!

AELifer · May 17, 2018, 8:42pm

Okay… Trying to get my node mining on the Testnet.

I’m running a 4GB RAM Ubuntu 16.04 on a VPS, and it seems as though I have everything installed correctly.

Some issues i’m having…

After my first attempt to start my node, I get a warning that my ulimit -n is 1024, and that I need to set it to 24576. After I do that, the node seems to start fine.
I run the “curl http://127.0.0.1:3003/v2/top” command to verify that my node is up, and my “connection is refused”.
When I check the log, I am seeing this a lot…

“exec-port with SUID bit set is not allowed to run without setting effective user!”

I’m thinking that my ports are not correct through my firewall and/or my .yaml file?

(On my firewall, i’m only allowing port 124, which is my VPS port, and also port 3003, and in my .yaml file, i’ve only changed the "sync settings to port: 124 & external_port: 124 which is my VPS port as well.)

Any ideas?

dincho.chain · May 18, 2018, 8:46am

The epoch daemon is not allowed to run as privileged user for security reasons. You have to create a non-privileged user and run the node with it.

The details can be found in our troubleshooting wiki page.

I hope that helps, let me know if you have further issues with it.

AELifer · May 18, 2018, 8:48pm

Thank you, @dincho.chain for the help!

Alright, I created the non-privileged user as instructed.

I started epoch again as the new user… (BTW… I have to set my ulimit every time I restart the node.)

When I do “curl http://31.13.249.70:3013/v2/top” to see if i’m connected to the testnet, it does return a hash, and I do see the height of the blockchain increase every time I enter this command .
As before, when I “curl http://127.0.0.1:3003/v2/top” to see the top of the blockchain as seen by my node, I fail to connect “Connection Refused”, but even when I try to go to this IP from my internet browser, I get the same response.
Now, when I check the logs… The mining log, and epoch_pow_cuckoo logs are both completely empty. The epoch and crash logs do not have any new information at all, nothing from today at all. All I see in the epoch and crash logs, are the old privileged user errors from yesterday. Shouldn’t I see something at least in the epoch log from today?

Still wondering if my port info is correct on my firewall, and in my .yaml file? They are configured as above, in my earlier reply from yesterday. Do I need to allow any additional ports and/or change the “websocket” setting in the .yaml?

If it helps, I did do “bin/epoch check_config epoch.yaml”, and it did check out “OK” by the way.

Also… Just noticed that in /tmp/node, that no “keys” dir was created.

Thanks again for the assistance!

dincho.chain · May 22, 2018, 10:08am

Hey @AELifer,

if you didn’t changed the configuration, the default port is 3013 I see you’re trying to connect to port 3003.

Please try curl http://127.0.0.1:3013/v2/top

TwenteMining · May 22, 2018, 4:12pm

you can try this guide

AELifer · May 22, 2018, 5:30pm

Thanks guys, will give it another try.

dankingori · May 27, 2018, 3:45pm

Hi People,
I am trying to set up a node on Ubuntu 16.04 server but have been hitting an error while trying to fetch the epoch from github. See attached a screenshot , below is my sys properties kindly someone tell me if this will work.

Thanks alot for the above conversation it’s been super helpful, cant wait to hit the road on this.

Thanks

AELifer · May 27, 2018, 8:40pm

It looks to me that your command is incorrect to fetch the release?

I would try all over again from scratch using the guide just above from Chris, step by step. It’s very thorough.

: )

dincho.chain · May 28, 2018, 6:35am

@dankingori Your release URL looks wrong to me, It should be https://github.com/aeternity/epoch/releases/download/v0.12.0/epoch-0.12.0-ubuntu.tar.gz

However, the latest release is 0.14.0 with slightly changed release filename, you could try: wget https://github.com/aeternity/epoch/releases/download/v0.14.0/epoch-0.14.0-ubuntu-x86_64.tar.gz

dankingori · June 7, 2018, 10:03pm

@dincho.chain Thankyou very much , your insight helped. I manged to pull the release Binary , and joined the testnet. However I think Using Docker image is pretty easy, running the node/s in the containers.

dincho.chain · June 8, 2018, 8:41am

@dankingori Not sure if you’re asking if we build docker images or just saying it’s easier to use Docker container than installing the release binary yourself

Anyway, we do build docker images, you can check it’s documentation (latest release) at: aeternity/docker.md at v0.15.0 · aeternity/aeternity · GitHub

dankingori · June 8, 2018, 8:27pm

@dincho.chain I am saying I found it easier to use Docker Container .

xiahui135 · October 3, 2018, 8:26am

Will there be a one-click way to install the node？

vlad.chain · October 3, 2018, 9:59am

Maybe for Windows 10. We are looking for a solution at the moment. Will keep you posted.