GCBSv3 用户手册

通用计算性能基准测试套件（General Computing Benchmark Suite, GCBS）是一款基于Linux系统的通用计算机综合性能测评工具。其测试结果主要受到计算机硬件、操作系统、开发库和编译器等因素影响。测试内容涵盖CPU、GPU、内存、存储、网络、操作系统、运行时，以及典型应用等。

GCBS由运行框架和 benchmark 测试程序组成，运行框架集成用户输入配置（通过配置文件或命令行参数）编译、构建、运行、生成测试报告等功能。以组件形式管理 benchmark 程序，具备扩展性强、轻量化、灵活配置的特点。

1 准备

1.1 工具兼容性

• 硬件兼容x86_64 、aarch64等CPU架构

• 软件兼容KylinOS、UOS等操作系统

1.2 安装 GCBS

GCBS 采用免安装模式，下载 GCBS 软件压缩包到被测系统上，解压即可。

tar -jxvf GCBS.tar.bz2

1.3 准备运行环境

运行前确保已安装依赖软件及工具

1.3.1 GCBS-Server 准备

• 手动安装依赖包：
  • 进入 docs/utils/beforeRun 目录，
  • 服务器使用yum install命令，依赖清单为rpm-server.dep；
• 自动安装依赖包：进入 docs/utils/beforeRun 目录，执行 ./before-run.sh <PASSWORD> server

1.3.2 GCBS-Desktop 准备

运行前预安装和预检查步骤，参考GCBS-Desktop 说明。

2 运行

2.1 修改配置文件

根据被测环境系统信息及测试目的，修改 config/server.ini或config/desktop.ini 文件里面的配置项

• 配置文件语法

  • 大小写敏感，注释以 # 或 ; 开头
  • 空格或缩进表示本行内容为前一个配置项的参数
  • 详情参考 配置文件使用指南

• 默认配置文件为 config/config_sample.ini，服务器配置文件为server.ini，台式机配置文件为desktop.ini

• 指定要运行的测试项，既可以通过配置文件设置，也可以通过命令行指定

• cpubenchplus.ini 文件是 CPUSuite 的配置文件

2.2 执行gcbs.sh

切换到GCBS的安装目录，直接执行gcbs.sh

• 用户指定配置文件运行，比如 config/server.ini或config/desktop.ini

  台式机：必须使用普通用户权限
  ./gcbs.sh -p 用户密码 -d 1 -c 副本数 -f desktop
  
  服务器：使用root权限或普通权限
  ./gcbs.sh -p 用户密码 -d 1 -c 副本数 -f server

• 用户也可以指定单个用例或套件进行测试

  ./gcbs.sh -f server -i 1 -s 1 -d 1 -t redis -p 用户密码
  ./gcbs.sh -f server -i 1 -c 128 -t ComplexSuite -p 用户密码
  ./gcbs.sh -f desktop -c 8 -t compression -p 用户密码
  ./gcbs.sh -f desktop -t GraphIOSuite -p 用户密码

• 更多参数请参考 ./gcbs.sh -h ，并参阅 配置文件使用指南。

  -h : 查看帮助信息
  -f : 指定配置文件
  -i : 指定测试次数
  -c : 指定副本数
  -a : 指定测试动作，如 standard,build,run,clean
  -t : 指定测试用例或测试套件
  -d : 指定调试模式，1表示打开调试模式，0表示关闭调试模式
  -p : 配置普通用户的密码
  -W : 显示测试用例清单
  -S : 显示测试套件清单
  ......

3 查看结果

GCBS运行结束后：

• 会在工作目录（默认是results）生成 machine_info.txt、log 等文件。
• 根据用户配置（配置文件或命令行 report 字段）生成 pdf、txt、csv 、json 格式测试报告。
• 每次运行都会创建单独的报告子目录，以日期时间后缀命名，例如 GCBS_single_2023-03-06-14-56-15 。

4 其它

4.1 版本号说明

版本号格式：x.y.z，即主版本号.次版本号.修订号，版本号递增规则如下：

1. 主版本号：当做了不兼容的 API 修改；例如 v2.5.1 和 v3.0.1 即不兼容；
2. 次版本号：当做了向下兼容的功能性新增；例如基线更新、 用例增删等，版本间分数不具备可比性；
3. 修订号：当做了向下兼容的问题修正；例如问题修复等，版本间分数具备可比性；

先行版本号及版本编译信息可以加到 主版本号.次版本号.修订号 的后面，以作为延伸。详细信息请参考语义化版本 2.0.0。