安装
本节主要介绍了如何在 X86 / ARM Linux 系统上首次安装 Neuron 软件包。
下载
Neuron 软件包可从 Neuron 官网 https://neugates.io/zh/downloads 上下载。
下载文件 | 架构 |
---|---|
neuron-x.y.z-linux-amd64.deb | X86_64 |
neuron-x.y.z-linux-armhf.deb | ARM_32 |
neuron-x.y.z-linux-arm64.deb | ARM_64 |
版本号 x.y.z 说明:
- x 为主要版本号,如果整个系统结构得到增强,则可能会更改。
- y 是次要版本号,如果存在某些附加功能,则可能会更改。
- z 是Neuron软件中错误修复的补丁号。
安装条件
Linux 发行版或设备 | 所需包 |
---|---|
Debian package system Ubuntu 20.xx Ubuntu 18.xx | deb/tar.gz |
Redhat package system Contos 8 Centos 9 | rpm/tar.gz |
rpm/deb package中使用了 systemd 管理 neuron 进程,建议优先使用 rpm/deb package。
使用 deb 包安装
安装
根据不同版本及架构安装,例如:
bash
$ sudo dpkg -i neuron-2.1.0-linux-armhf.deb
为避免 ubuntu 系统自动更新时替换 neuron 包,还需要执行以下命令使 neuron 软件包在 apt 升级中保留。
bash
$ sudo apt-mark hold neuron
TIP
成功安装 deb 包后,自动启动 Neuron
卸载
bash
$ sudo dpkg -r neuron
使用 rpm 安装包
安装
根据不同版本及架构安装,例如:
bash
$ sudo rpm -i neuron-2.1.0-linux-armhf.rpm
TIP
成功安装 rpm 包后,自启动 Neuron。
卸载
bash
$ sudo rpm -e neuron
使用 .tar.gz 安装包
下载安装包
根据不同的版本及架构下载,例如:
bash
$ wget https://www.emqx.com/en/downloads/neuron/2.1.0/neuron-2.1.0-linux-armhf.tar.gz
解压
bash
$ sudo tar -zxvf neuron-2.1.0-linux-armhf.tar.gz
$ cd neuron-2.1.0-linux-armhf
启动
执行如下命令启动 Neuron:
bash
$ ./neuron-helper.sh start
停止
执行如下命令停止 Neuron:
bash
$ ./neuron-helper.sh stop
使用 Docker 运行
获取镜像
docker 镜像请从 docker hub 网站下载。
bash
$ docker pull emqx/neuron
启动
bash
$ docker run -d --name neuron -p 7000:7000 -p 7001:7001 -p 9081:9081 --privileged=true --restart=always emqx/neuron
- tcp 7000: 用于访问 web。
- tcp 7001: http api 端口。(api 端口为 web 端口+1,例如,当 web 端口映射为 8000 时,api 端口应映射为8001)
- tcp 9081: eKuiper api 端口.
- --restart=always: docker 进程重启时,自动重启 neuron 容器。
- --privileged=true: 可选参数,便于排查问题。
- -v /host/dir:/opt/neuron/persistence: 用于将 docker 中 Neuron 配置信息存放在本地目录(例如,/host/dir)。
- --device /dev/ttyUSB0:/dev/ttyS0: 用于映射串口到 docker。
Neuron 操作
用 rpm 和 deb 方式安装的都可以通过以下指令查看/起停 Neuron:
查看 Neuron 状态
bash
$ sudo systemctl status neuron
停止 Neuron
bash
$ sudo systemctl stop neuron
重启 Neuron
bash
$ sudo systemctl restart neuron