AD5.1E-private-channel-ansible

Private Channels - Using Ansible

Recommended hardware features for Tessera node:

Recommended Hardware	On Pro-Testnet	On Mainnet-Omega
CPU	2 vCPUs	4 vCPUs compute optimized
RAM Memory	8 GB	16 GB
Hard Disk	50 GB SSD	50 GB SSD

Operating System: Ubuntu 16.04, Ubuntu 18.04, Ubuntu 20.04, Centos7, always 64 bits.

Port 4040: TCP – To communicate with other Tessera nodes.

Port 4444: TCP – Tor communication between Besu and Tessera.

Clone Repository

To configure and install a Tessera node, you must clone this git repository in your local machine:

				
					$ git clone https://github.com/LACNet-Networks/besu-networks
$ cd besu-networks/

Obtain SSH access to your remote machine

Make sure you have SSH access to the remote server where you are setting up the Tessera node. This step will vary depending on your context (physical machine, cloud provider, etc.). This guide assumes that you are able to log into your remote machine using the following command:

				
					$ ssh remote_user@remote_host

Node Installation

Preparing installation of a new node

After cloning the repository on the local machine, enter it and create a copy of the inventory.example file as inventory. Edit that file to add a line for the remote server where you are creating the new node. You can do it with a graphical tool or inside the shell.

				
					
$ cd besu-networks/
$ cp inventory.example inventory
$ vi inventory
[tessera]
127.0.0.1 ---> Change for your IP Tessera instance
   
[all:vars]
password=default_password
node_email=default@email
...
tessera=false ---> Set to true to install Tessera

Consider the following:

In your inventory file add a line below [tessera] role. This new line is the IP or hostname where you can reach your remote machine from your local machine. In this Ip or hostname will be installed Tessera node.

Additionally, change tessera variable located under the [all: vars] tag in same inventory file to true.
The value of password is the password that will be used to set up Tessera, for private transactions.

Deploying the new node

To deploy a Tessera node, execute one of the following command in your local machine. If needed, do not forget to set the private key with option --private-key and the remote user with option -u to SSH connection:

				
					 *Tessera*
 $ ansible-playbook -i inventory --private-key=~/.ssh/id_rsa -u remote_user site-lacchain-tessera.yml

If everything worked, a Tessera service managed by Systemctl will be created with started status.

Start the service

To initiate your Tessera service, execute:

				
					<remote_machine>$ service tessera start

Restart the service

If you need to restart Tessera, you can execute the following command:

				
					<remote_machine>$ service tessera restart

Check our terms and conditions, privacy policies, and cookies policy.