Interface Testing

This section describes how to use kzip to test interface functions and performance.

1. Go to the KAELz4/test/kzip directory of kzip.

   cd KAELz4/test/kzip

2. Compile and package kzip.

   sh build.sh 

3. View the tool parameter description.

   export LD_LIBRARY_PATH=/usr/local/kaelz4/lib/:$LD_LIBRARY_PATH
   ./kzip -h 

4. Test basic functions.
   Test the compression and decompression performance across various algorithms, shard sizes, and datasets.

   sh runFunc.sh 

5. Perform a performance test.
   1. Test single I/O latency through a serial process. The results reflect the compression latency of a single I/O.

      export KAE_LZ4_ASYNC_THREAD_NUM=1
      sh runPerf.sh -A kaelz4async_frame -m 1 -n 20000 -s [4/8/16/32/64] -r 1 -k 1 -i 1 -p 0 -f [path to calgary.tar]

   2. Test single-core compression capability by increasing thread load. The results reflect the compression bandwidth and latency achieved by a single thread.

      export KAE_LZ4_ASYNC_THREAD_NUM=1
      sh runPerf.sh -A kaelz4async_frame -m 1 -n 20000 -s [4/8/16/32/64] -r 1 -k 1 -i 4 -p 0 -f [path to calgary.tar]

   3. Test single-KAE capability by increasing thread load. The results reflect the latency when compression bandwidth satisfies the 5G@4K requirement.

      export KAE_LZ4_ASYNC_THREAD_NUM=5 # The value can be 5 or 6.
      sh runPerf.sh -A kaelz4async_frame -m 1 -n 20000 -s [4/8/16/32/64] -r 1 -k 1 -i 16 -p 0 -f [path to calgary.tar]

   4. Test maximum single-KAE capability by increasing thread load to its limit. The results reflect the peak compression bandwidth achieved by a single KAE.

      export KAE_LZ4_ASYNC_THREAD_NUM=8
      sh runPerf.sh -A kaelz4async_frame -m 1 -n 20000 -s [4/8/16/32/64] -r 1 -k 1 -i 64 -p 0 -f [path to calgary.tar]