跳到主要内容

安装指引

Linux

以 Ubuntu/Debian 为例,当前仅支持AMD64架构。

1. 安装Python 3.11

首先,确保你的系统已更新至最新版本。打开终端并运行以下命令:

sudo apt-get update
sudo apt-get upgrade

然后,你需要添加 ppa(Personal Package Archive)来获取Python 3.11的源。运行以下命令:

sudo add-apt-repository ppa:deadsnakes/ppa
sudo apt-get update
sudo apt-get install python3.11
sudo apt-get install python3.11-venv

确认安装完成后,你可以通过 python3.11 --version 检查Python 3.11是否已经成功安装。

接下来安装pip3.11:

# 1. 先下载
curl https://bootstrap.pypa.io/get-pip.py -o get-pip.py
# 2. 安装隶属于 python3.11 的pip
python3.11 get-pip.py

2. 解压NGraphX安装包

将下载的 .zip 文件解压到你想要的目录,例如 /opt

cd /opt
unzip ngraphx-*.zip

3. 设置启动脚本执行权限

找到解压后目录下的 startup.sh 文件,通常位于 /opt/your-nggraphx-directory/startup.sh。确保它有可执行权限,使用 chmod 命令:

cd /opt/your-nggraphx-directory
chmod +x startup.sh

4. 非root用户运行

为了安全起见,我们建议使用普通用户而非root账号来运行 startup.sh 脚本。切换到你想要的用户(如 your_username ),然后运行:

su your_username
nohup ./startup.sh > nohup.log 2>&1 &
提示

nohup command arg1 arg2 是你想要运行的命令和参数。

  • > 用于将标准输出(stdout)重定向到nohup.log文件。
  • 2>&1 用于将标准错误输出(stderr)也重定向到nohup.log文件。
  • & 用于将命令放入后台运行。

如果需要以root权限运行部分命令,可以使用 sudo ,但请谨慎操作,只在必要时使用。

小提示与总结

  • 在整个安装过程中,请确保遵循最佳实践,如使用 sudo 仅在必要时,并且始终备份重要数据。
  • 完成安装后,检查NGraphX是否正常工作,可以通过打开浏览器输入: http://localhost:9090 进行访问。如果能看到软件界面则表示已经安装成功。
  • 所有数据、配置和日志都保存在 lib/python3.11/site-packages/torchdb/data 目录下。
  • 如果您在安装过程中遇到任何问题,请确保您的Python 3.11和pip 3.11已经正确安装(pip版本与python版本要一致)。如果出现故障,请尝试删除之前的安装目录,解压新的安装包,然后按照安装说明再次进行安装。

MAC

MAC安装步骤与Linux类似,使用相同的安装脚本,只是要注意安装Python 3.11有些差异。

从 Python 官网下载适用于 macOS 的 Python 3.11 安装包。

  1. 打开浏览器,访问 Python 官方网站:https://www.python.org/downloads/macos/
  2. 下载适用于 macOS 的 Python 3.11 安装包。
  3. 打开下载的 .pkg 文件,并按照提示完成安装。

Windows

Windows 安装步骤也与Linux类似,只是安装脚本与路径有些差异。安装Python3.11方式与MAC相同。

  1. 下载适用于 Windows 的 Python 3.11 安装包进行安装。
  2. 首次安装使用 startup.bat,也可以先执行 install.bat 进行安装,然后手动运行 startup.bat
  3. 安装完成后,打开浏览器输入: http://localhost:9090 进行访问。如果能看到软件界面则表示已经安装成功。
  4. 所有数据、配置和日志都保存在 Lib/site-packages/torchdb/data 目录下。