This work was done by EVERIS and was completely donated to LACCHAIN Consortium.
-
This Pantheon network uses IBFT2.0 consensus with validator and regular nodes located around Latin America and the Caribbean.
-
In this installation we will use Ubuntu 18.04 as the operating system and all the commands related to this operating system. In addition, links of the prerequisites will be placed in case it is required to install in another operating system.
-
An important consideration to note is that we will use Ansible, for which the installation is done from a local machine on a remote server. That means that the local machine and the remote server will communicate via ssh.
Characteristics of the machine for the nodes of the testnet:
-
CPU: 2 cores
-
RAM Memory: 4 GB
-
Hard Disk: 30 GB SSD
-
Operating System: Ubuntu 16.04, Ubuntu 18.04, always 64 bits
It is necessary to enable the following network ports in the machine in which we are going to deploy the node:
-
8080: TCP - Port for communication for Orion.
-
30303: TCP/UDP - Port to establish communication p2p between nodes.
-
8545: TCP - Port to establish RPC communication. (this port is used for applications that communicate with Lacchain and may be leaked to the Internet)
For this installation we will use Ansible. It is necessary to install Ansible on your local machine that will perform the installation of the node on the remote machine.
Following the instructions to install ansible in your local machine.
$ sudo apt-get update
$ sudo apt-get install software-properties-common
$ sudo apt-add-repository ppa:ansible/ansible
$ sudo apt-get update
$ sudo apt-get install ansibleTo configure and install Pantheon and Orion, you must clone this git repository in your local machine.
$ git clone https://github.com/lacchain/PantheonNetwork
$ cd PantheonNetwork/-
In order for ansible to work, it is necessary to install Python on the remote machine where the node will be installed, for this reason it is necessary to install python 2.7 and python-pip.
-
If you need to install python-pip in Redhat use https://access.redhat.com/solutions/1519803
$ sudo apt-get update
$ sudo apt-get install python2.7
$ sudo apt-get install python-pip-
There are three types of nodes (Bootnode/ Validator / Regular) that can be created in the Pantheon network.
-
After cloning the repository, enter this.
$ cd lacchain/ -
First change the IP located within the inventory file by the public IP of the remote server where you are creating the new node.
$ vi inventory [test] 192.168.10.72
-
To deploy a boot node execute the following command in your local machine, without forgetting to set the private key in the option --private-key and the ssh connection user in the -u option:
$ ansible-playbook -i inventory -e bootnode=true -e first_node=false --private-key=~/.ssh/id_rsa -u vagrant site-lacchain-bootnode.yml -
To deploy a validator node execute the following command in your local machine, without forgetting to set the private key in the option --private-key and the ssh connection user in the -u option:
$ ansible-playbook -i inventory -e validator=true -e first_node=false --private-key=~/.ssh/id_rsa -u vagrant site-lacchain-validator.yml -
To deploy a regular node execute the following command in your local machine, without forgetting to set the private key in the option --private-key and the ssh connection user in the -u option:
$ ansible-playbook -i inventory --private-key=~/.ssh/id_rsa -u vagrant site-lacchain-regular.yml -
When starting the installation, it will request that some data be entered, such as the public IP, keystore password, email and node name. The name of the node will be the one that will finally appear in the network monitoring tool.
-
At the end of the installation, if everything is correct, a PANTHEON service will be created in the case of a validator node managed by Systemctl with stop status.
-
In the case of a regular node if everything is correct, a ORION service and a PANTHEON service managed by Systemctl will be created with stop status.
-
Now, it is necessary to configure some files before starting up the node. Please, follow the next steps:
Working...
Working...
Once we have modified these files, you can start up the node with this command in remote machine:
<remote_machine>$ systemctl start orion
<remote_machine>$ systemctl start pantheonWorking ...
Working ...
- Faced with errors in the node, we can choose to perform a restart of the node, for this we must execute the following commands:
<remote_machine>$ systemctl restart orion
<remote_machine>$ systemctl restart pantheon- The next statement allows you to back up the node's state. It also makes a backup copy of the keys and the enode of your node. All backup copies are stored in the home directory as
~/lacchain-keysBackup.
$ ansible-playbook -i inventory -e validator=true -e first_node=false --private-key=~/.ssh/id_rsa -u vagrant site-lacchain-backup.yml NOTE If we want to generate the node using an enode and the keys of an existing node we must make a backup of the keys of the old node:
$ ansible-playbook -i inventory -e validator=true -e first_node=false --private-key=~/.ssh/id_rsa -u vagrant site-lacchain-backup.yml
This will generate the folder ~/lacchain-keysBackup whose contents should be moved to ~/lacchain/data/keys. The keys of this directory (which has to keep the folder structure of the generated backup) will be the ones used in the image of the node that we are going to generate.
**Disclaimer test-net **
The public-permissioned LACChain network offered by LACChain is currently at a test-net stage. The access to this network is described in this GitHub. The LACChain team is currently defining a road-map with both technology and legal requirements to release networks in production. From now on, we will refer to the LACChain test-net as ¨The Network¨.
Any natural or legal person that uses or operates The Network becomes a User. The User agrees to these terms and acknowledges that The Network is at an early stage of development. The User acknowledges and accepts that the use of The Network is entirely at the User’s sole risk and discretion.
To use The Network, The User must be authenticated, guaranteeing that every regular/access node operating The Network is associated to a physical or legal person. Every regular node must indicate the contact information of the natural person that is responsible and accountable for the operation of the regular node, including name and e-mail.
The User acknowledges and agrees that has an adequate understanding of the blockchain technology and the programming languages. The User also understands the risks associated with the use of The Network, which could present interruptions or malfunctions as it is at a est-net stage.
The user understands that all the information and materials published, distributed or, otherwise, made available on The Network are provided with no guarantee by the Allies, Members and Users of the LACChain program. Despite The Allies will struggle to offer robust technology, at this est-net stage they are not responsible nor accountable for the reliability of The Network.
All the content related to The Network is provided on an ‘as is’ and ‘as available’ basis, without any representations or warranties of any kind. All implied terms are excluded to the fullest extent permitted by law. No party involved in, or having contributed to the development of The Network, including but not limited to IDB, IDB lab, everis, ConsenSys, NTT Data, io.builders, LegalBlock and any of their affiliates, directors, employees, contractors, service providers or agents (The Parties Involved) accept any responsibility or liability to Users or any third parties in relation to any materials or information accessed or downloaded via The Network.
The User acknowledges and agrees that all the Parties Involved are not responsible for any damage to the User’s computer systems, loss of data, or any other loss or damage resulting from the use of The Network.
To the fullest extent permitted by law, in no event shall The Parties Involved have any liability whatsoever to any person for any direct or indirect loss, liability, cost, claim, expense or damage of any kind, whether in contract or in tort, including negligence, or otherwise, arising out of or related to the use of all or part of The Network.
The User understands and accepts that none of the physical and/or legal persons operating a core (validator or boot) node in The Network and, therefore, being part of the consensus protocol, is legally committed to maintain those nodes. When a percentage of these nodes are suddenly turned off, the network may cause iinterruptions of service. The User operating a regular/access node and any third party using the network through The User´s regular/access nodes understands that LACChain will not be either responsible nor accountable for any malfunction or damage caused by the disconnections of the core nodes.
The User will not run any application or solution in The Network when The Network is a necessary component for the either application or the solution.
The User will not run any application or solution nor register any information or data in The Network that incurs illegal activities or practices that can be considered against the Law.
The User must preserve the data privacy of all the physical and legal persons whose information is directly or indirectly registered in The Network through The User´s regular node.
The User is not allowed to promote the use of The Network for commercial or institutional purposes without including the following disclaimer:
All the operation and use of the LACChain test-net blockchain network by ________ (The User) is carried out under the entire responsibility and discretion of ________ (The User). Under no circumstance, any responsibility or accountability is extended to any other physical or legal person operating the network, or the community behind LACChain. The LACChain blockchain network is currently at a test-net stage and, therefore, it must not be used for applications or solutions in production, or for monetization purposes. The expected use of the network is for testing and learning purposes, as there could be occasional malfunctioning or interruption of service. Over the coming months, LACChain will develop and incorporate the legal policies, the governance frameworks and the technology upgrades for the release of the pre main-net and the main-net that will enable the operation in production.
LICENSE
This work is licensed under a license