This is an NS-3 simulator for HPCC: High Precision Congestion Control (SIGCOMM' 2019). It also includes the implementation of DCQCN, TIMELY, DCTCP, PFC, ECN and Broadcom shared buffer switch.
We have update this simulator to support HPCC-PINT, which reduces the INT header overhead to just 1 byte. This improves the long flow completion time. See PINT: Probabilistic In-band Network Telemetry (SIGCOMM' 2020).
It is based on NS-3 version 3.17.
./waf configure
Please note if gcc version > 5, compilation will fail due to some ns3 code style. If this what you encounter, please use:
CC='gcc-5' CXX='g++-5' ./waf configure
Please see mix/config.txt for example.
mix/config_doc.txt is a explanation of the example (texts in {..} are explanations).
mix/fat.txt is the topology used in HPCC paper's evaluation, and also in PINT paper's HPCC-PINT evaluation.
The direct command to run is:
./waf --run 'scratch/third mix/config.txt'
We provide a run.py for automatically generating config and running experiment. Please python run.py -h for usage.
Example usage:
python run.py --cc hp --trace flow --bw 100 --topo topology --hpai 50
To run HPCC-PINT, try:
python run.py --cc hpccPint --trace flow --bw 100 --topo topology --hpai 50 --pint_log_base 1.05 --pint_prob 1
The major ones are listed here. There could be some files not listed here that are not important or not related to core logic.
point-to-point/model/qbb-net-device.cc/h: the net-device RDMA
point-to-point/model/pause-header.cc/h: the header of PFC packet
point-to-point/model/cn-header.cc/h: the header of CNP
point-to-point/model/pint.cc/h: the PINT encoding/decoding algorithms
point-to-point/model/qbb-header.cc/h: the header of ACK
point-to-point/model/qbb-channel.cc/h: the channel of qbb-net-device
point-to-point/model/qbb-remote-channel.cc/h
point-to-point/model/rdma-driver.cc/h: layer of assigning qp and manage multiple NICs
point-to-point/model/rdma-queue-pair.cc/h: queue pair
point-to-point/model/rdma-hw.cc/h: the core logic of congestion control
point-to-point/model/switch-node.cc/h: the node class for switch
point-to-point/model/switch-mmu.cc/h: the mmu module of switch
network/utils/broadcom-egress-queue.cc/h: the multi-queue implementation of a switch port
network/utils/custom-header.cc/h: a customized header class for speeding up header parsing
network/utils/int-header.cc/h: the header of INT
applications/model/rdma-client.cc/h: the application of generating RDMA traffic
The DCQCN implementation is based on Mellanox's implementation on CX4 and newer version, which is slightly different from the DCQCN paper version.
The TIMELY implementation is based on our own understanding of the TIMELY paper. We believe we correctly implemented it. We use the parameters in the TIMELY paper. For parameters whose settings are absent in the TIMELY paper, we get from this paper (footnote 4).
The DCTCP implementation is a version that we envision DCTCP will be implemented in hardware. It starts at line rate (not slow start) which we believe is necessary in future high-speed network. It also does not delay ACK, because delayed ACk is for saving software overhead. These settings are consistent with other schemes.