CohortDAG 环境设置故障排除
操作指南 · CohortDAG 0.2.9
当 CohortDAG 无法启动分析后端时,“Backend Environment Setup”对话框会显示下列提示之一。分析后端需要 Python 3、分析软件包(包括 pyspark),以及 Apache Spark 所需的 Java 17。找到你看到的提示,按处理办法操作。如果已关闭对话框,点击状态栏中 Backend: Failed 旁的“Fix…”即可重新打开。在终端中,cohortdag doctor(随 Linux 安装包一起安装)会运行同样的检查,并会启动一次 Spark,可能需要几分钟。
The analysis backend could not start on this computer. The checks below show what is missing. When automatic repair is available, use Repair automatically, then Retry Backend.
原因
分析后端无法启动,状态栏显示 Backend: Failed。新安装后出现这种情况是正常的:分析软件包尚未安装。红框中显示后端给出的原因。在“Environment checks”中,✗ 表示后端必需但缺少的部分;! 表示可选部分(例如 data root),不会妨碍后端启动。

处理办法
如果显示“Repair automatically”,点击它并等待完成;安装分析软件包可能需要几分钟。然后点击“Retry Backend”。在 Linux 上,安装系统软件包(例如 Java 17)的步骤会在系统窗口中要求输入密码。“Repair plan”中标有“do this yourself”的步骤需要你自己完成:步骤下方显示了命令时,复制它并在终端中运行,然后点击“Re-check”;步骤要求重新打开应用时,退出 CohortDAG 后再启动。
Repair finished. Further setup is required; review the refreshed plan.
原因
应用能执行的步骤已经完成,更新后的计划中还有其他步骤。有些步骤只能在前一步完成后才会列出:分析软件包要安装到 Python 环境中,所以要等 Python 就绪后才会出现。其他则是应用无法替你完成的步骤。
处理办法
查看更新后的“Repair plan”。如果再次显示“Repair automatically”,点击它。对每个标有“do this yourself”的步骤,按上文的方法完成。没有任何检查显示 ✗ 后,点击“Retry Backend”。
The repair did not finish — see the log below for the reason.
原因
某个修复步骤因错误而中止。常见原因是下载分析软件包时没有网络连接,或者安装系统软件包时的密码提示被关闭或拒绝。
处理办法
查看修复计划下方修复日志的末尾,找到原因。解决该问题(连接网络,或准备好输入密码)后,点击“Re-check”,再点击“Repair automatically”。显示“Manual alternative”的步骤,也可以改为在终端中运行该命令,然后点击“Re-check”。
Repair cancelled.
原因
你点击了“Cancel repair”,因此其余步骤没有运行。在 Linux 上,正在安装系统软件包的步骤会先完成,修复才停止。
处理办法
点击“Re-check”查看仍缺少什么,准备好后再点击“Repair automatically”。
The environment check could not be completed. Re-check or review the backend log.
原因
环境检查本身未能完成,因此对话框无法列出缺少什么。
处理办法
点击“Re-check”。如果提示仍然存在,在终端运行 cohortdag doctor:它会逐项打印检查结果,并为每个未通过的检查给出处理办法。