GNTE(Global Network Topology Emulator) is a docker-based all-in-one unstable global network emulator. It emulates functionality such as random delay and packet loss.

Install docker

Clone this repo and run build.sh. There should be an image named ns in your docker environment.

Edit example.yaml to fit your requirements. The rules of this file are described in the bottom section.

Run the following command:

./generate.sh 

Once all CovenantSQL testnet dockers are running, you can use docker ps -a to see all container nodes:

You can also find a graph of the network in graph.png under your root folder:

Run the following command:

./generate.sh stopone filter 

will stop randon one node. If filter is not empty, it will stop node name contains filter.

And there is also a command to stop all:

./generate.sh stopall filter 

Also a command for restart all stopped nodes:

./generate.sh startall 

Containers are referenced by group_name+ip. For example, given containers 10.250.1.2 and 10.250.8.2, you can run docker exec -it china10.250.1.2 ping 10.250.8.2 to test the connection between these two networks.

You can replace the cmd in the group section of yaml to run your own command. The scripts dir will be "volumed" to containers. docker run --rm -it -v $DIR/scripts:/scripts you can put your own binaries or scripts here and put your self defined scripts/my.yaml:

group: - name: china nodes: - ip: 10.250.1.2 cmd: "cd /scripts && ./YourBin args" - ip: 10.250.1.3 cmd: "cd /scripts && ./YourBin args" delay: "100ms 10ms 30%" loss: "1% 10%" - name: us nodes: - ip: 10.250.2.2 cmd: "cd /scripts && ./YourBin args" - ip: 10.250.2.3 cmd: "cd /scripts && ./YourBin args" delay: "1000ms 10ms 30%" loss: "1% 10%" network: - groups: - china - us delay: "200ms 10ms 1%" corrupt: "0.2%" rate: "10mbit" 

and run

./generate.sh scripts/my.yaml

Run ./scripts/clean.sh

A sample network description is provided in example.yaml, which you can edit directly.

# Only support 10.250.0.2 ~ 10.250.254.254 group: - name: china nodes: - ip: 10.250.1.2/32 cmd: "ping -c3 g.cn" - ip: 10.250.2.2/32 cmd: "ping -c3 g.cn" - ip: 10.250.3.2/32 cmd: "ping -c3 g.cn" - ip: 10.250.4.2/32 cmd: "ping -c3 g.cn" delay: "100ms 10ms 30%" loss: "1% 10%" - name: eu nodes: - ip: 10.250.5.2/32 cmd: "ping -c3 g.cn" - ip: 10.250.6.2/32 cmd: "ping -c3 g.cn" - ip: 10.250.7.2/32 cmd: "ping -c3 g.cn" delay: "10ms 5ms 30%" loss: "1% 10%" - name: jpn nodes: - ip: 10.250.8.2/32 cmd: "ping -c3 g.cn" - ip: 10.250.9.2/32 cmd: "ping -c3 g.cn" delay: "100ms 10ms 30%" duplicate: "1%" rate: "100mbit" network: - groups: - china - eu delay: "200ms 10ms 1%" corrupt: "0.2%" rate: "10mbit" - groups: - china - jpn delay: "100ms 10ms 1%" rate: "10mbit" - groups: - jpn - eu delay: "30ms 5ms 1%" rate: "100mbit" 

The network definition contains two sections: group and network. Group defines ips and describes network info between them. Network describes network info between groups.

• name: unique name of the group

• nodes: list of node in the network.

• ip: Node IP must be between "10.250.0.2 ~ 10.250.254.254" and written in CIDR format, eg. 10.250.1.2/32.

• cmd: Node command to run. Blocking or Non-blocking are both ok.

• network params: The following 6 tc network limit parameters are supported:

  delay loss duplicate corrupt reorder rate 

The values of these parameters are exactly like those of the tc command.

• delay: "100ms 10ms 30%" means 100ms delay in network and 30% packets +-10ms.
• duplicate: "1%" means 1% packets is duplicated.
• rate: "100mbit" means network transmit rate is 100mbit.
• corrupt: "0.2%" means 0.2% packets are randomly modified.

• groups: list of group names

• network params: same as group