云生信学生物信息学

在兼容Linux服务器上完成安装、自检和样例运行

作者:发布于 2026-11-16更新于 2026-11-15约 5 分钟阅读
Cell Ranger安装后,保留可复查的验收材料

Cell Ranger安装后,保留可复查的验收材料:取得版本对应安装包;独立目录配置PATH;运行官方testrun;另验参考与项目输入
本文操作与检查路径示意。

Cell Ranger安装不需要把依赖逐个装进R环境:官方提供包含所需依赖的tar包,但参考数据需另行准备。安装成功只说明程序可启动;还要通过官方testrun,并另外确认项目使用的参考、FASTQ和pipeline确实匹配。以下按Linux普通用户在独立目录安装,版本号和下载文件名请替换为自己从10x官方页面取得的版本。

先准备版本、目录和存储

记录Linux发行版、CPU、可用内存、工作盘和目标Cell Ranger版本。先创建程序、参考、测试和正式项目目录;不要把大参考、临时文件和所有结果都堆在系统盘。Cell Ranger可下载为tar.gz或tar.xz,解压前先确认下载完整;若官方提供文件校验值,按该页面核对。自行计算SHA256可以用于后续识别文件是否变化,但若没有可信发布值,不能证明文件来源。

mkdir -p "$HOME/apps" "$HOME/ref" "$HOME/work/cellranger-test"
cd "$HOME/apps"
# 将官方已下载的压缩包放到此处后,按实际格式选择一条:
tar -xzvf "$HOME/Downloads/cellranger-x.y.z.tar.gz"
# 若文件是 .tar.xz:tar -xvf "$HOME/Downloads/cellranger-x.y.z.tar.xz"
export PATH="$HOME/apps/cellranger-x.y.z:$PATH"
which cellranger
cellranger --version

运行官方自检,留存完整日志

官方安装教程用cellranger testrun确认安装。自检需在有写权限、空间充足的工作目录中运行,并给它一个本次唯一的ID;若同名目录已存在,先确认里面是否有需要保留的结果,不要直接覆盖。将标准输出和错误保存下来,结束后查看是否出现成功完成提示,以及输出目录是否可读。

cd "$HOME/work/cellranger-test"
run_id="install_check_$(date +%Y%m%d_%H%M%S)"
cellranger testrun --id="$run_id" 2>&1 | tee "$run_id.log"
status=${PIPESTATUS[0]}
echo "exit_status=$status"
find "$run_id" -maxdepth 2 -type f | head

在bash中,PIPESTATUS[0]记录管道中Cell Ranger本身的退出码,避免只看到tee成功就误判整条命令成功。检查日志末尾、生成的pipestance信息和退出状态;如果SSH断开造成任务中断,可先确认该ID的运行状态及是否可恢复,再决定续跑或另建ID。不要在程序仍运行时删除输出目录。

自检通过后还要检查项目输入

testrun不等于正式数据已经可用。单独检查参考目录是否对应物种和版本、FASTQ文件名与样本前缀、输入路径权限、剩余空间以及pipeline类型。普通count、multi和VDJ入口不同;下载包解压正确也不会替你判断实验是否应走count。拿一份代表性样本做项目级dry-run或小规模试跑时,遵循对应pipeline文档,并使用研究方案要求的输入与参数。

验收证据 保存内容 通过标准
程序安装 版本输出、安装路径 版本与任务记录一致
官方自检 命令、日志、退出状态 自检完整结束且输出可读
参考和FASTQ 路径、参考版本、样本清单 文件匹配设计且权限可读
空间与任务配额 磁盘余量、CPU/内存限制 能容纳运行过程,不只够放压缩包

把环境固定下来

记录Cell Ranger版本、下载文件名及可信校验信息、操作系统、参考版本、命令、退出码和输出目录。升级时安装到新版本目录,先用独立测试ID验证,不要覆盖旧程序后再找不到原环境。若官方下载需要遵循软件许可或账户流程,应从官方入口取得软件,不要转发账户凭据或在公开脚本中暴露令牌。本文没有在真实项目FASTQ上运行;正式分析前仍需按你的文库类型和数据检查。

把版本路径写进项目脚本或环境记录,不要只依赖交互式终端里的临时PATH。新开一个SSH会话执行which cellranger和cellranger --version,可以发现登录配置没有生效的问题。多人共用服务器时,程序可以集中只读安装,测试结果和项目目录仍应按课题组权限隔离。

下载练习材料

下载教程 PDF · 下载代码与示例数据 ZIP

先核对包内SHA256清单,再在独立目录复现。

需要额外算力时

适用前提:本地兼容性或资源不足,选择经过验证的Linux环境。如需额外资源,可评估服务器租赁及按需环境部署。咨询时说明软件版本、任务规模和使用期限,配置与支持范围另行确认。

咨询本任务的服务器配置

咨询本任务的服务器配置

留下手机号,我们会结合本文任务与您沟通服务器配置和报价。

也可联系云生信企业微信客服,说明本文任务。

参考与版本核对

按文中适用环境运行,所用版本与参数以实际安装环境和对应官方文档为准。

把知识用于当前任务

先确定合适的计算资源

根据数据规模和分析任务,快速测算 CPU、内存、存储与 GPU 配置。

测算服务器配置仍有疑问,联系客服 ↗