Skip to content

Latest commit

 

History

History

scripts

README.md

Scripts Shell

Esta pasta contém os scripts shell usados para correr benchmarks com fio e guardar resultados em formato CSV.

Visão Geral

O fluxo normal é este:

  1. Compilar o dedup_fs ou o passthrough.
  2. Montar o file system correspondente.
  3. Usar os scripts de benchmark em scripts/ para medir o desempenho.
  4. Guardar os resultados em scripts/results/.
  5. Gerar gráficos com os scripts Python em scripts/python/.

Scripts Principais

dedup_test_terminal.sh

Executa um benchmark no terminal e mostra o resumo final no stdout.

O que faz:

  • valida os argumentos recebidos;
  • cria o ficheiro temporário bench.dat na pasta alvo;
  • escolhe o cenário de duplicação a aplicar no fio;
  • corre o fio com saída JSON;
  • extrai as métricas principais do JSON;
  • imprime no terminal o débito, IOPS, latência média e latência P95.

Uso:

sudo bash scripts/dedup_test_terminal.sh <pasta_alvo> <cenario_duplicacao> [diretoria_store_fuse] [tamanho_total_bytes]

Exemplo:

sudo bash scripts/dedup_test_terminal.sh /mnt/dedupfs 50 /backend 268435456

dedup_test_csv.sh

Executa um benchmark e grava uma linha CSV com os resultados globais do cenário.

O que faz:

  • valida os argumentos recebidos;
  • cria bench.dat na pasta alvo;
  • corre o fio com o cenário indicado;
  • extrai bw_bytes, iops, clat_mean_ns e clat_p95_ns;
  • escreve ou acrescenta uma linha no ficheiro CSV passado como argumento.

O CSV gerado contém, entre outras, as colunas:

  • dup_pct
  • total_bytes
  • workload_total_s
  • bw_bytes
  • iops
  • clat_mean_ns
  • clat_p95_ns

Uso:

sudo bash scripts/dedup_test_csv.sh <pasta_alvo> <cenario_duplicacao> <ficheiro_saida_csv> [diretoria_store_fuse] [tamanho_total_bytes]

Exemplo:

sudo bash scripts/dedup_test_csv.sh /mnt/dedupfs 50 scripts/results/dedup.csv /backend 268435456

dedup_test_csv_nTimes.sh

Executa o dedup_test_csv.sh várias vezes e acumula as linhas no mesmo ficheiro CSV passado como argumento.

O que faz:

  • valida os argumentos;
  • confirma que o script dedup_test_csv.sh existe;
  • repete o teste N vezes;
  • espera alguns segundos entre execuções;
  • no fim mostra quantas execuções tiveram sucesso e quantas falharam.

Uso:

sudo bash scripts/dedup_test_csv_nTimes.sh <pasta_alvo> <cenario_duplicacao> <ficheiro_saida_csv> <N> [diretoria_store_fuse] [tamanho_total_bytes]

Exemplo:

sudo bash scripts/dedup_test_csv_nTimes.sh /mnt/dedupfs 50 scripts/results/dedup.csv 20 /backend 268435456

Valores E Convenções

  • cenario_duplicacao aceita qualquer inteiro entre 0 e 100.
  • O tamanho por defeito é 268435456 bytes, ou seja, 256 MiB.
  • Os resultados finais dos benchmarks devem ser guardados em scripts/results/.

Scripts Python Relacionados

Depois de gerar os CSV, os gráficos podem ser criados com:

cd scripts/python
python3 plot_scenario.py [0-100]

Os outputs são escritos em scripts/python/outputs/scenario_<dup_pct>/.