Skip to main content

通过 Docker 快速体验 AIRIOT

本软件适用于包括 CentOSUbuntu 在内的各种 Linux 发行版及 macOS 操作系统。请按照下面的说明完成安装前的准备并按步骤执行安装和卸载过程。

准备工作

在安装之前,请确保您的系统满足以下条件:

  • 对于 CentOSUbuntu 用户,本安装包预计应直接可用。
  • 对于 macOS 用户及其他未明确列出的 Linux 发行版,如遇到任何安装问题,请手动安装 DockerDocker Compose 。安装教程可参考官方文档(链接至 Docker 官方安装文档)。
  • 您需要有足够的权限来执行安装和卸载脚本,通常是指具有 sudoroot 访问权限。
  • 推荐使用 CentOS 7.9Ubuntu 20.04
  • 建议的 docker-compose 版本是 2.2.2。
  • 普通版本默认安装案例,如取消需要在安装过程中输入 y
  • macOS 注意 docker 有目录访问权限,优先考虑安装在用户目录下。

对于使用 CentOS 8 以上开启端口转发功能:

  1. 修改防火墙配置以允许地址转发。运行以下命令开启 IP 地址转发功能,并设置为永久(在防火墙重启后依然生效)
firewall-cmd --add-masquerade --permanent
  1. 重载防火墙规则。这样做使得刚才的变更立即生效
firewall-cmd --reload

如果您安装了 Docker,您需要重新启动 Docker 服务以使网络配置更改生效。

  1. 重启 Docker 服务。
systemctl restart docker
info

注意:如果平台未安装,请直接跳过此后步骤。

  1. 卸载平台
./uninstall.sh
  1. 启动平台
./runOperation.sh
./run.sh

对于使用 Ubuntu 21.04 或更高版本的用户,请注意,这些版本默认使用 cgroup v2,但 Docker 容器目前需要 cgroup v1。要解决这个问题,请按照以下步骤将您的系统更改为 cgroup v1:

  1. 编辑 GRUB 配置文件。
sudo vim /etc/default/grub
  1. 在该文件中找到 GRUB_CMDLINE_LINUX 这一行,并修改它,以包含以下参数:
GRUB_CMDLINE_LINUX="cgroup_enable=memory swapaccount=0 systemd.unified_cgroup_hierarchy=0"
  1. 更新 GRUB 并重启你的系统,以应用这些更改。
sudo update-grub
sudo reboot

请按照这些指示准备您的系统,以确保一个顺畅的安装过程。

安装

  1. 解压安装包

请使用下面的命令来解压您下载的安装包:

tar zxvf airiot_xxx.tar.gz

请将 airiot_xxx.tar.gz 替换成实际下载的文件名。

  1. 安装

首先,切换到解压后的 app 目录:

cd app

然后,运行安装脚本:

./install.sh

在开始安装之前,请确保该安装脚本具有执行权限。如果脚本无法运行,请先运行 chmod +x install.sh 命令。

卸载

  1. 卸载

切换到安装目录下的 app 文件夹:

cd app

接着,执行卸载脚本:

./uninstall.sh

同样,确保卸载脚本有执行权限。如果脚本无法运行,请先执行 chmod +x uninstall.sh 命令。