Peerplays QA environment
This set of docker images contains a self-contained, Peerplays QA environment. It features 16 Peerplays nodes(running 27 witnesses), 16 Bitcoin SONs, 16 Hive SONs, 1 Redis and 1 faucet node.

Hardware Requirements

Here's a guideline for the hardware requirements for building the QA environment:
Memory
Storage
OS
32GB
~300GB
Ubuntu 18.04
Of course, the requirements will be highly dependent on what you're using the environment for. Intensive development of an enterprise-level application will need much more resources than simply exploring your own private environment.

Software Requirements

Following are the software requirements:
OS
Docker
git
Ubuntu 18.04
20.10.8 or higher
2.33.0 or higher
* If any of the software mentioned above is not installed, please use the following pages to install them:
  1. 1.
    ubuntu: https://ubuntu.com/server/docs/installation
  2. 2.
    docker: https://docs.docker.com/engine/install/ubuntu/
  3. 3.
    git: https://git-scm.com/book/en/v2/Getting-Started-Installing-Git

Getting the Code

Clone the peerplays-utils project in gitlab to get the latest setup scripts for Peerplays QA environment:
1
git clone https://gitlab.com/PBSA/tools-libs/peerplays-utils.git
2
cd peerplays-utils/peerplays-qa-environment/
Copied!

Setting up the QA Environment

The environment setup needs to be run in the following order:
  1. 1.
    BITCOIN
  2. 2.
    HIVE
  3. 3.
    PEERPLAYS
  4. 4.
    REDIS
  5. 5.
    FAUCET
Note: After running the Peerplays initialization script, wait for the next maintenance block before start using the environment for testing.

Before starting initialization, make sure that all nodes are down.

1
sudo docker-compose down
Copied!

BITCOIN

The first step is to build the bitcoin container. Open a new terminal and run the following command:
1
sudo docker-compose up bitcoin-for-peerplays
Copied!
This will take some time to complete. Once you see the logs on the terminal have stopped, open a new terminal and login to the newly built Bitcoin container with the following command:
1
sudo docker exec -it peerplaysqaenvironment_bitcoin-for-peerplays_1 /bin/bash
Copied!
Once inside the container run init-network.sh script to setup the Bitcoin environment:
1
./init-network.sh
Copied!

HIVE

Now we need to build the HIVE container. Open a new terminal and run the following command:
1
sudo docker-compose up hive-for-peerplays
Copied!
This will take some time to complete. Wait till the HIVE blockchain starts generating blocks(Generated block #1 with timestamp ....) and then open a new terminal and login to the newly built HIVE container with the following command:
1
sudo docker exec -it peerplaysqaenvironment_hive-for-peerplays_1 /bin/bash
Copied!
Once inside the container run init-network.sh script to setup the HIVE environment:
1
./init-network.sh
Copied!

PEERPLAYS

Next, we need to build the Peerplays container. Open a new terminal and run the following command:
1
sudo docker-compose up peerplays01 peerplays02 peerplays03 peerplays04 peerplays05 peerplays06 peerplays07 peerplays08 peerplays09 peerplays10 peerplays11 peerplays12 peerplays13 peerplays14 peerplays15 peerplays16
Copied!
This will take some time to complete. Wait till the HIVE blockchain starts generating blocks(Generated block...) and then open a new terminal and login to the newly built HIVE container with the following command:
1
sudo docker exec -it peerplaysqaenvironment_peerplays01_1 /bin/bash
Copied!
Once inside the container run init-network.sh script to setup the HIVE environment:
1
./init-network.sh
Copied!
Note: Wait for the next maintenance block before start using the environment

Redis

Next, we build the Redis container. Open a new terminal and run the following command:
1
sudo docker-compose up redis-for-peerplays
Copied!
Wait for the message "Ready to accept connections"

Faucet

The final container which we need to build is faucet. Open a new terminal and run the following command:
1
sudo docker-compose up faucet-for-peerplays
Copied!
Wait for the message "Running on http://10.11.12.50:5000/ (Press CTRL+C to quit)"

Viewing logs of bitcoin/hive/peerplays nodes

In order to view the logs of the containers following commands can be used:
  1. 1.
    Bitcoin
1
sudo docker logs -f `sudo docker ps -a|grep bitcoin|awk '{print $18}'`
Copied!
2. Hive
1
sudo docker logs -f `sudo docker ps -a|grep hive|awk '{print $15}'`
Copied!
3. Peerplays
There are 16 peerplays nodes running and in this example, we are trying to see the logs of peerplays10 node.
1
sudo docker logs -f `sudo docker ps -a|grep peerplays10|awk '{print $17}'`
Copied!
Note: In case you want to see the logs of peerplays01 node replace peerplays10 with peerplays01 in the command given above.

Node properties

The IP address and the configuration of the nodes in the environment are given below:
1
Bitcoin 10.11.12.201
2
Hive 10.11.12.202
3
4
Faucet 10.11.12.50
5
Redis 10.11.12.51
6
7
Peerplays01 10.11.12.101 Witness 1.6.1, 1.6.12, SON 1.33.0, Stale production ON
8
Peerplays02 10.11.12.102 Witness 1.6.2, 1.6.13, SON 1.33.1, Stale production OFF
9
Peerplays03 10.11.12.103 Witness 1.6.3, 1.6.14, SON 1.33.2, Stale production OFF
10
Peerplays04 10.11.12.104 Witness 1.6.4, 1.6.15, SON 1.33.3, Stale production OFF
11
Peerplays05 10.11.12.105 Witness 1.6.5, 1.6.16, SON 1.33.4, Stale production OFF
12
Peerplays06 10.11.12.106 Witness 1.6.6, 1.6.17, SON 1.33.5, Stale production OFF
13
Peerplays07 10.11.12.107 Witness 1.6.7, 1.6.18, SON 1.33.6, Stale production OFF
14
Peerplays08 10.11.12.108 Witness 1.6.8, 1.6.19. SON 1.33.7, Stale production OFF
15
Peerplays09 10.11.12.109 Witness 1.6.9, 1.6.20, SON 1.33.8, Stale production OFF
16
Peerplays10 10.11.12.110 Witness 1.6.10, 1.6.21, SON 1.33.9, Stale production OFF
17
Peerplays11 10.11.12.111 Witness 1.6.11, 1.6.22, SON 1.33.10, Stale production OFF
18
Peerplays13 10.11.12.112 Witness NONE , SON 1.33.11, Stale production OFF
19
Peerplays13 10.11.12.113 Witness NONE , SON 1.33.12, Stale production OFF
20
Peerplays14 10.11.12.114 Witness NONE , SON 1.33.13, Stale production OFF
21
Peerplays15 10.11.12.115 Witness NONE , SON 1.33.14, Stale production OFF
22
Peerplays16 10.11.12.116 Witness NONE , SON 1.33.15, Stale production OFF
Copied!

Monitoring resource usage

To monitor computer resource usage by docker containers in real-time, use the following command:
1
sudo docker stats
Copied!
The output will be similar to this:
1
CONTAINER ID NAME CPU % MEM USAGE / LIMIT MEM % NET I/O BLOCK I/O PIDS
2
0e6e806bd8d7 peerplays-qa-environment_faucet-for-peerplays_1 0.01% 53.77MiB / 30.77GiB 0.17% 7.34kB / 4.73kB 0B / 2.66MB 17
3
1c793a7f4520 peerplays-qa-environment_redis-for-peerplays_1 0.18% 2.48MiB / 30.77GiB 0.01% 5.29kB / 670B 0B / 0B 5
4
61bdcacc4617 peerplays-qa-environment_peerplays01_1 2.06% 65.34MiB / 30.77GiB 0.21% 1.4MB / 743kB 0B / 0B 14
5
851c6f4c7a36 peerplays-qa-environment_peerplays02_1 1.25% 65.21MiB / 30.77GiB 0.21% 1.39MB / 724kB 0B / 0B 14
6
513fdd80faab peerplays-qa-environment_peerplays03_1 1.87% 65.27MiB / 30.77GiB 0.21% 1.4MB / 730kB 0B / 0B 14
7
14cbff0ec769 peerplays-qa-environment_peerplays05_1 1.46% 65.2MiB / 30.77GiB 0.21% 1.4MB / 728kB 0B / 0B 14
8
6f153091d3a5 peerplays-qa-environment_peerplays07_1 1.35% 65.32MiB / 30.77GiB 0.21% 1.42MB / 721kB 0B / 0B 14
9
ea56bb7d139a peerplays-qa-environment_peerplays15_1 1.26% 65.17MiB / 30.77GiB 0.21% 1.38MB / 695kB 0B / 0B 14
10
d472e4031736 peerplays-qa-environment_peerplays04_1 1.76% 65.21MiB / 30.77GiB 0.21% 1.4MB / 725kB 0B / 0B 14
11
8dec8c46b208 peerplays-qa-environment_peerplays16_1 1.26% 65.28MiB / 30.77GiB 0.21% 1.38MB / 683kB 0B / 0B 14
12
4c1a0b42551f peerplays-qa-environment_peerplays06_1 2.24% 65.22MiB / 30.77GiB 0.21% 1.39MB / 732kB 0B / 0B 14
13
407fbfcc1572 peerplays-qa-environment_peerplays10_1 0.95% 65.21MiB / 30.77GiB 0.21% 1.39MB / 730kB 0B / 0B 14
14
fb79c628adf2 peerplays-qa-environment_peerplays09_1 1.57% 65.21MiB / 30.77GiB 0.21% 1.4MB / 751kB 0B / 0B 14
15
6489809208f0 peerplays-qa-environment_peerplays13_1 1.57% 65.16MiB / 30.77GiB 0.21% 1.38MB / 704kB 0B / 0B 14
16
1b4a22127d71 peerplays-qa-environment_peerplays12_1 1.50% 65.22MiB / 30.77GiB 0.21% 1.39MB / 683kB 0B / 0B 14
17
63782a95bdcd peerplays-qa-environment_peerplays08_1 2.09% 65.23MiB / 30.77GiB 0.21% 1.4MB / 738kB 0B / 0B 14
18
cfa91a760895 peerplays-qa-environment_peerplays14_1 1.30% 65.21MiB / 30.77GiB 0.21% 1.39MB / 678kB 0B / 0B 14
19
99dc6c45e39a peerplays-qa-environment_peerplays11_1 1.18% 65.23MiB / 30.77GiB 0.21% 1.38MB / 736kB 0B / 0B 14
20
4951a2727f8a peerplays-qa-environment_peerplays-base_1 0.00% 1.441MiB / 30.77GiB 0.00% 10.3kB / 0B 0B / 4.1kB 1
21
0e0449865359 peerplays-qa-environment_hive-for-peerplays_1 7.24% 8.797MiB / 30.77GiB 0.03% 5.23MB / 15.8MB 3.6MB / 0B 46
22
ea086b2c9798 peerplays-qa-environment_bitcoin-for-peerplays_1 0.16% 40.5MiB / 30.77GiB 0.13% 54.4kB / 46.7kB 4.1kB / 49.2kB 29
23
5ebba3d28e21 peerplays-qa-environment_ubuntu-for-peerplays_1 0.00% 1.441MiB / 30.77GiB 0.00% 15kB / 0B 0B / 4.1kB 1
Copied!