Grappa 技术文档

本文档将详细介绍 Grappa 的安装指南、使用说明以及项目 API 使用方法，帮助用户更好地使用和理解这个项目。

1. 安装指南

Grappa 是一个运行时系统，用于在通用集群上扩展不规则应用程序。它是一个 PGAS 库和运行时系统，允许你编写在分布式内存计算机上运行的全球视图 C++11 代码。

要构建 Grappa，你需要在 64 位 Linux 系统上安装以下依赖项：

• 构建系统
  • Ruby >= 1.9.3
  • CMake >= 2.8.12
• 编译器
  • GCC >= 4.7.2（我们依赖于仅在 4.7.2 及更新版本中存在的 C++11 特性）
  • 或者：Clang >= 3.4
• 外部依赖
  • MPI（必须支持 MPI-3）
    • OpenMPI >= 1.7.4
    • MVAPICH2 >= 1.9
    • MPICH >= 3.1
    • Intel MPI >= 5.0.2.044

配置脚本会自动处理一些其他依赖项。如果你需要为特定系统覆盖默认行为，请参阅 BUILD.md。

此外，我们的测试和运行脚本默认使用 Slurm 作业管理器。如果你使用其他 MPI 启动器运行作业，则需要自己设置必要的环境变量。请参阅 doc/running.md 了解更多信息。

快速开始

确保你已经安装了上述依赖项，然后检出代码：

git clone [e-mail]:uwsampa/grappa.git

如果你没有设置 GitHub 密钥并遇到认证错误，可以尝试使用 HTTP URL：

git clone http://github.com/uwsampa/grappa.git

然后下载 Grappa 的第三方依赖项：grappa-third-party-downloads.tar。

现在构建 Grappa 和 hello world：

cd grappa
./configure --third-party-tarfile=<完整路径到/grappa-third-party-downloads.tar>
cd build/Make+Release
make demo-hello_world

现在你应该有一个可以作为 MPI 作业启动的二进制文件。如果你的系统上安装了 Slurm，你可能能够这样运行作业：

srun --nodes=2 --ntasks-per-node=2 -- applications/demos/hello_world/hello_world.exe

如果这不起作用，请使用你的系统上启动 MPI 作业所需的命令。

2. 使用说明

要运行 Grappa 的所有测试（这是一个漫长的过程），在 使用 Slurm 作业管理器的系统上，执行 make check-all-pass。有关测试的更多信息，请参阅 doc/testing.md。

3. 项目 API 使用文档

关于 Grappa 的设计和使用，你可以通过以下四种方式了解更多：

1. 阅读存储库中 doc/tutorial 目录下的教程。在 doc/ 目录中了解关于运行作业、调试、跟踪以及其他底层功能的更多信息。
2. 查看托管在 grappa.io/doxygen 的自动生成 API 文档，或者按照 BUILD.md 中的说明自行构建。
3. 阅读我们的论文，可在 Grappa 网站上找到。

4. 项目安装方式

Grappa 还可以通过以下方式尝试，而无需自行安装：

• grappa-docker：Grappa 的 Docker 容器
• grappa-starcluster：Grappa 在亚马逊云中的部署

如果你有任何问题，可以通过在 GitHub 上提交问题来获得帮助：通过保持问题的集中，我们可以确保答案对所有人来说都容易找到。查看之前讨论过的问题，请访问：https://github.com/uwsampa/grappa/issues?labels=question。如果你的问题尚未得到解答，请在那里提交一个问题！

Grappa 开发者通过在 cs.washington.edu 托管的 grappa-dev 邮件列表进行交流。我们欢迎各种贡献，包括核心软件和应用。如果你考虑做出贡献，请与我们联系！