安装仅需 CPU 的 Milvus

安装前提

操作系统要求

硬件要求

Milvus Docker 要求

• 如果使用 Ubuntu 或 CentOS 安装 Milvus，请在您的宿主机上 安装 Docker 19.03或更高版本。
• 如果在 Windows 上安装 Milvus，请安装 Docker Desktop，并进入 Settings -> Advanced 调整相关配置。请确保‘可用内存’大于您在 server_config.yaml 文件中设置的insert_buffer_size 和 cpu_cache_capacity 之和。
• 如果在 MacOS 上安装 Milvus，请安装Docker Desktop for Mac，并进入 Preferences -> Advanced 调整相关配置。请确保‘可用内存’大于您在 server_config.yaml 文件中设置的insert_buffer_size 和 cpu_cache_capacity 之和。

在 Ubuntu/CentOS 上安装 Milvus

第一步 确认 Docker 状态

确认 Docker daemon 正在运行：

$ docker info

如果无法正常打印 Docker 相关信息，请启动 Docker daemon.

提示：在 Linux 上，Docker 命令前面需加 sudo。若要在没有 sudo 情况下运行 Docker 命令，请创建 docker 组并添加用户。更多详情，请参阅 Linux 安装后步骤。

第二步 拉取 Milvus 镜像

拉取仅需 CPU 的镜像：

$ docker pull milvusdb/milvus:0.8.0-cpu-d041520-464400

注意：如果您在拉取镜像时速度过慢或一直失败，请参考操作常见问题中提供的解决办法。

第三步 下载配置文件

# Create Milvus file
$ mkdir -p /home/$USER/milvus/conf
$ cd /home/$USER/milvus/conf
$ wget https://raw.githubusercontent.com/milvus-io/milvus/v0.8.0/core/conf/demo/server_config.yaml
$ wget https://raw.githubusercontent.com/milvus-io/milvus/v0.8.0/core/conf/demo/log_config.conf

注意：万一您遇到无法通过 wget 命令正常下载配置文件的情况，您也可以在 /home/$USER/milvus/conf 路径下创建 server_config.yaml 和 log_config.conf 文件，然后复制粘贴 server config 文件 和 log config 文件的内容。

第四步 启动 Milvus Docker 容器

# Start Milvus
$ docker run -d --name milvus_cpu \
-p 19530:19530 \
-p 19121:19121 \
-p 9091:9091 \
-v /home/$USER/milvus/db:/var/lib/milvus/db \
-v /home/$USER/milvus/conf:/var/lib/milvus/conf \
-v /home/$USER/milvus/logs:/var/lib/milvus/logs \
-v /home/$USER/milvus/wal:/var/lib/milvus/wal \
milvusdb/milvus:0.8.0-cpu-d041520-464400

上述命令中用到的 docker run 参数定义如下：

• -d: 运行 container 到后台并打印 container id。
• --name: 为 container 分配一个名字。
• -p: 暴露 container 端口到 host。
• -v: 将路径挂载至 container。

最后，确认 Milvus 运行状态：

# Confirm Milvus status
$ docker ps

如果 Milvus 服务没有正常启动，您可以执行以下命令查询错误日志。

# Get id of the container running Milvus
$ docker ps -a
# Check docker logs
$ docker logs <milvus container id>

在 Windows 上安装 Milvus

在 Windows 上安装 Milvus 的步骤和在 Ubuntu/CentOS 上几乎一样，只不过 第三步 和 第四步 略有不同。

在第三步中，不同于使用 wget 来获取配置文件，使用 Windows 安装时，建议在 C 盘，或其它合适的位置创建 milvus 文件夹，下面包含 db，conf，logs 和 wal 等文件夹，然后分别复制 server config 文件 和 log config 文件的内容到您在 C:\milvus\conf 路径下创建的server_config.yaml 和 log_config.conf 文件中。

第四步，启动 Docker 容器，将 Milvus 文件映射到您本地的文件路径。下面的命令是在命令提示符中运行的：

# Start Milvus
$ docker run -d --name milvus_cpu ^
-p 19530:19530 ^
-p 19121:19121 ^
-p 9091:9091 ^
-v C:\milvus\db:/var/lib/milvus/db ^
-v C:\milvus\conf:/var/lib/milvus/conf ^
-v C:\milvus\logs:/var/lib/milvus/logs ^
-v C:\milvus\wal:/var/lib/milvus/wal ^
milvusdb/milvus:0.8.0-cpu-d041520-464400

在 MacOS 上安装 Milvus

在 Windows 上安装 Milvus 的步骤和在 Ubuntu/CentOS 上几乎一样，只不过 第三步 和 第四步 略有不同。

第三步，安装路径有细微差别：

# Create Milvus file
$ mkdir -p /Users/$USER/milvus/conf
$ cd /Users/$USER/milvus/conf
$ wget https://raw.githubusercontent.com/milvus-io/milvus/v0.8.0/core/conf/demo/server_config.yaml
$ wget https://raw.githubusercontent.com/milvus-io/milvus/v0.8.0/core/conf/demo/log_config.conf

第四步，启动 Docker 容器，将 Milvus 文件映射到您本地的文件路径：

# Start Milvus
$ docker run -d --name milvus_cpu \
-p 19530:19530 \
-p 19121:19121 \
-p 9091:9091 \
-v /home/$USER/milvus/db:/var/lib/milvus/db \
-v /home/$USER/milvus/conf:/var/lib/milvus/conf \
-v /home/$USER/milvus/logs:/var/lib/milvus/logs \
-v /home/$USER/milvus/wal:/var/lib/milvus/wal \
milvusdb/milvus:0.8.0-cpu-d041520-464400

接下来您可以

• 如果您刚开始了解 Milvus：

  • 运行示例程序
  • 了解更多 Milvus 操作
  • 体验 Milvus 在线训练营

• 如果您已准备好在生产环境中部署 Milvus：

  • 创建 监控与报警系统 实时查看系统表现
  • 设置 Milvus 参数

• 如果您想使用针对大数据集搜索的 GPU 加速版 Milvus：

  • 安装支持 GPU 的 Milvus