---
title: Debian/Ubuntu 源码编译安装 Slurm 集群实践
description: 面向企业 IT 运维，介绍在 Debian/Ubuntu 上通过源码编译安装 Slurm 的完整流程，涵盖依赖准备、编译安装、配置文件放置、服务脚本注册、验证方法与常见故障排查，并给出备份与回退建议。
url: "https://www.lanever.com/docs/debian-ubuntu-%e6%ba%90%e7%a0%81%e7%bc%96%e8%af%91%e5%ae%89%e8%a3%85-slurm-%e9%9b%86%e7%be%a4%e5%ae%9e%e8%b7%b5/"
updated: "2026-10-12"
category: Slurm集群
---

# Debian/Ubuntu 源码编译安装 Slurm 集群实践

> **参考来源与致谢**
>
>
>
> - **引用来源：**[HPC 系列文章(7):Debian/Ubuntu安装Slurm](http://blog.zxh.site/2018/09/02/HPC-%E7%B3%BB%E5%88%97%E6%96%87%E7%AB%A0-7-Debian-Ubuntu%E5%AE%89%E8%A3%85Slurm/)
> - **原作者：**原页面署名作者或发布机构（剪藏记录未保存可核验的个人署名）
> - **感谢词：**感谢原作者及发布机构对技术知识的公开分享。本文已结合企业运维场景完成脱敏、核验与原创重写，并非原文转载；如权利人需要更正署名或来源信息，请联系本站。

## 适用场景

需要在 Debian 或 Ubuntu 系统上部署 Slurm 集群，且希望使用较新版本、而非发行版仓库中较旧版本时，可采用源码编译方式安装。本文以单节点部署为例，该节点同时承担管理节点与计算节点角色，适用于测试环境搭建或小规模集群验证。多节点生产环境需在此基础上调整 `slurm.conf` 中的节点与分区定义。

若仅需快速验证功能、对版本无要求，可优先考虑发行版包管理器安装，具体包名与可用版本请查阅对应发行版官方文档。

## 准备与风险

- 确认系统已安装编译工具链（`gcc`、`make` 等），并具备 root 或等效权限。
- 源码编译安装的默认路径与包管理器安装不同：配置文件通常位于 `/usr/local/etc`，库文件位于 `/usr/local/lib/slurm/`，后续维护需注意路径一致性。
- 安装前建议对现有系统配置、数据库和关键目录做完整备份，并在测试环境先行验证。
- 涉及修改 GRUB 引导参数、重启系统等操作具有破坏性风险，务必先确认可回退方案。
- 本文不承诺特定版本支持范围，具体版本兼容性请查阅对应版本官方文档。

## 处理步骤

### 1. 安装依赖

以下依赖缺失会导致对应功能异常：缺少 MySQL 客户端开发库时，`slurmdbd` 可能找不到 `accounting_storage_mysql.so`；缺少 hwloc 开发库时，cgroup 插件可能无法使用。

```
apt-get install hwloc libhwloc-dev libmunge-dev libmunge2 munge mariadb-server libmysqlclient-dev
```

### 2. 获取并编译源码

从官方渠道获取所需版本的源码包，解压后进入目录执行编译安装。以下命令为通用形式，实际文件名以获取到的源码包为准。

```
tar --bzip -x -f [源码包文件名]
cd [源码目录]
./configure
make
make install
```

### 3. 注册服务脚本

将源码目录 `etc` 子目录中的服务启动脚本复制到 `/etc/systemd/system/`，随后执行 `systemctl daemon-reload` 使配置生效。

### 4. 放置并修改配置文件

源码 `etc` 目录中包含多个配置范例，将其复制到 `/usr/local/etc` 后按实际环境修改。常见文件包括：

- `slurm.conf`：集群、节点、分区与调度参数。
- `slurmdbd.conf`：数据库连接与记账相关参数。
- `cgroup.conf`：cgroup 资源限制参数。
- `cgroup_allowed_devices_file.conf`：允许访问的设备列表。

配置中涉及服务器地址、数据库账号等敏感信息时，请使用占位符替换，例如 `[服务器地址]`、`[管理员账号]`，避免明文写入真实凭据。

## 验证方法

在任意节点执行以下命令，若能看到分区、节点状态与节点列表输出，说明服务基本正常：

```
sinfo
```

若输出异常，检查 `/var/log/slurm/slurmctld.log` 与 `/var/log/slurm/slurmd.log` 日志定位问题。

## 回退建议

- 保留安装前的系统配置与数据库备份，必要时可恢复。
- 记录本次修改的配置文件与 GRUB 参数，便于逐项还原。
- 若编译安装失败，可先卸载已安装文件（依据 `make install` 的安装清单），再回到包管理器方案。
- 修改 GRUB 参数后若系统异常，可通过引导菜单进入恢复模式还原参数。

## 常见问题

### ConstrainRAMSpace=yes 无效

提示该参数无效时，通常需要启用内存 cgroup 支持。编辑 `/etc/default/grub`，在 `GRUB_CMDLINE_LINUX_DEFAULT` 中追加 `cgroup_enable=memory swapaccount=1`，保存后执行 `update-grub` 并重启系统。修改引导参数前请确认已备份并了解回退方式。

### slurmdbd 无法启动

日志提示找不到 `accounting_storage_mysql.so`，多因编译前未安装 MySQL 客户端开发库。安装对应开发库后，重新执行编译安装步骤即可。

> 提示：不同发行版与 Slurm 版本在依赖名称、默认路径和配置项上可能存在差异，请以对应版本官方文档为准。
