Prerequisites
A Java Virtual Machine with version 1.8.x.
A Java Virtual Machine (JVM) is required to run the client. The version must be 1.8.x. The client has not been tested with JVM 1.9.
To check the JVM version use java -version
. For example on a recently created EC2 small instance the response is ...
java version "1.8.0_131"
Java(TM) SE Runtime Environment (build 1.8.0_131-b11)
Java HotSpot(TM) 64-Bit Server VM (build 25.131-b11, mixed mode)
Disk Space
The database for the Ethereum Classic chain take approximately 15G of disk space. Appropriate overhead will be needed for the chain to grow into the future. An SSD of at least 25G is recommended.
Memory (RAM)
The mantis client has been tested extensively on EC small instances with 2G of RAM. This is sufficient to run the client and the miner (however it is not sufficient to build the miner)
Downloads
The Client Binary
This client is distributed as a zip
archive and can be downloaded from the releases section of the github repository.
The Bootstrap Database (Optional)
A bootstrap database has been created to support the client.
This file is available for download from S3.
mantis-cli-beta1-bootstrap-db.zip
Or from a command line use ...
wget https://s3.eu-central-1.amazonaws.com/iohk.etc-client.snapshots/mantis-cli-beta1-bootstrap-db.zip
Checksum the Bootstrap Database Archive
When the file is fully downloaded (on linux) run the following command
md5sum mantis-cli-beta1-bootstrap-db.zip
This should result in a line identical to the following ...
3a7bceeb1816de2e481d6a280c73e4e1 mantis-cli-beta1-bootstrap-db.zip
Compare the results of the line on your terminal to the above line, the checksum should be identical.
The default folder for data is ~/.mantis
. In order to use the downloaded database create this folder and cd
into it. Then unzip the file using...
unzip <path to zip file>/mantis-cli-beta1-bootstrap-db.zip
Install the Client
unzip the client archive file downloaded from the previous section. This will create a folder structure as follows -
mantis-0.3-cli-beta
│
└───bin
│
└───conf
│
└───lib
The lib
folder contains all the jars required to run the client, the conf
folder contains the configuration files needed to alter the user settings of the client and the bin
folder contains the scripts to start the client.
Run the Client
From the mantis-0.3-cli-beta
folder use
./bin/mantis
This command will run the client in the foreground with settings as dictated in the conf
folder files.
Note that for long running processes on remote machines it is recommended to use tmux or equivalent in order to prevent the client stopping when the terminal is shut down.
Changing the Default Settings
Following the instructions outlined above including using the bootstrap database should result in a startup similar to the following
The first block should be around 4.1 million as this is where the snapshot was taken.
The default datadir is ~/.mantis
. To change this edit the storage.conf
file in the conf
folder.
Un-comment the datadir
configuration and replace the value with the preferred value.
datadir = ${user.home}"/.mantis"