# 安装

下文介绍了如何在 x86 或 ARM Linux 设备上安装 Neuron 软件包。

# 下载

Neuron 软件包可从 EMQ 网站 https://www.emqx.com (opens new window) 下载.

下载文件架构
neuron-x.y.z-linux-x86_64.tar.gzx86 64-bit
neuron-x.y.z-linix-armv7l.tar.gzARM hardware floating
neuron-x.y.z-linix-aarch64.tar.gzARM 64-bit

对于版本号x.y.z,x是主要版本号,如果整个系统结构得到增强,则可能会更改; y是次要版本号,如果存在某些附加功能,则可能会更改。 z是Neuron软件中错误修复的补丁号。

# 安装条件

已为 Neuron 测试了以下 Linux 发行版或设备。

Linux 发行版或设备所需的 Neuron 包
Debian package system for x86_64
Ubuntu 20.xx
Ubuntu 18.xx Desktop
Ubuntu 16.xx Desktop (install openssl1.1)
Ubuntu 14.xx Desktop (install openssl1.1)
neuron-x.y.z-linux-x86_64.tar.gz
Redhat package system for x86_64
Centos 8
Centos 7.x (install openssl1.1)
neuron-x.y.z-linux-x86_64.tar.gz
Raspberry Pi 2
Pi 4b+
Pi 3b+
Pi 2b+ (install openssl1.1)
neuron-x.y.z-linux-armv7l.tar.gz
armv7l Ubuntu Linux Systemneuron-x.y.z-linux-armv7l.tar.gz
aarch64 Ubuntu Linux Systemneuron-x.y.z-linux-aarch64.tar.gz

注意: 一些Linux发行版要求安装 openssl1.1.
Debian 包, wget http://archive.ubuntu.com/ubuntu/pool/main/o/openssl/libssl1.1_1.1.0g-2ubuntu4_amd64.deb (opens new window)
Redhat 包, https://linuxscriptshub.com/update-openssl-1-1-0-centos-6-9-7-0 (opens new window)
确保openssl升级到1.1版本之后,若执行rpm -ivh neuron-1.3.0-linux-amd64.rpm提示依赖缺失,执行rpm -ivh neuron-1.3.0-linux-amd64.rpm --nodeps --force

# 安装步骤

本节介绍了如何在 Linux 系统上首次安装 Neuron 软件。新的 Neuron 软件必须安装在任何用户账户的主目录下。我们推荐使用 "neuron" 账户进行安装。

  1. 解压软件包到任何目录下,(例 /home/neuron),输入命令:

    ~\$ tar -zxvf neuron-x.y.z-linux-x86_64.tar.gz
    
    1
  2. 第一次运行 Neuron 建立数据目录 ~/dat. 输入命令:

    ~\$ {PATH}/neuron start
    Directory {PATH}/dat created
    Directory {PATH}/dat/0 created
    Directory {PATH}/dat/0/adm created
    Directory {PATH}/dat/0/adm/usr created
    Directory {PATH}/dat/0/alm created
    Directory {PATH}/dat/0/cfg created
    Directory {PATH}/dat/0/log created
    Directory {PATH}/dat/0/scp created
    Directory {PATH}/dat/0/scp/subr created
    Directory {PATH}/dat/0/obj created
    Directory {PATH}/dat/0/trd created
    Neuron instance 0 is now running with PID:6312 Port:7000
    
    1
    2
    3
    4
    5
    6
    7
    8
    9
    10
    11
    12
    13

# 启动系统

Neuron 可以通过以下方式启动

~\$ {PATH}/neuron start
Neuron instance 0 is now running with PID:6037 Port:7000
1
2

# 停止系统

输入以下命令,Neuron 将停止运行

~\$ {PATH}/neuron stop
Neuron instance 0 is stopping ...
Stopped !
1
2
3

# 启动特定系统

特定 Neuron 可以通过以下方式启动

~\$ {PATH}/neuron start -i7
Neuron instance 7 is now running with PID:8097 Port:7007
1
2

# 停止特定系统

输入以下命令,特定 Neuron 将停止运行

~\$ {PATH}/neuron stop -i7
Neuron instance 7 is stopping ...
Stopped !
1
2
3

# 启动多个系统

多个 Neuron 可以通过以下方式启动

~\$ {PATH}/neuron start -a5
Neuron instance 0 is now running with PID:6066 Port:7000
Neuron instance 1 is now running with PID:6069 Port:7001
Neuron instance 2 is now running with PID:6076 Port:7002
Neuron instance 3 is now running with PID:6087 Port:7003
Neuron instance 4 is now running with PID:6090 Port:7004
1
2
3
4
5
6

# 停止多个系统

输入以下命令,多个 Neuron 将停止运行

~\$ {PATH}/neuron stop -a5
Neuron instance 0 is stopping ...
Stopped !
Neuron instance 1 is stopping ...
Stopped !
Neuron instance 2 is stopping ...
Stopped !
Neuron instance 3 is stopping ...
Stopped !
Neuron instance 4 is stopping ...
Stopped !
1
2
3
4
5
6
7
8
9
10
11

# 检查系统

输入以下命令,检查Neuron 是否运行

~\$ {PATH}/neuron status
Neuron instance 0 is running with PID:6118 Port:7000
Neuron instance 1 is running with PID:6121 Port:7001
Neuron instance 2 is running with PID:6132 Port:7002
Neuron instance 3 is running with PID:6139 Port:7003
Neuron instance 4 is running with PID:6144 Port:7004
1
2
3
4
5
6

# 命令参数

本节介绍了 "neuron" 命令的可用参数。

用法: neuron [start|stop|status] [options]

参数描述
-a 或 --allinstance <number>数量 <2-10>,同时启动a个实例
-i 或 --instance <instanceno>实例号 <0-9>,启动第i个实例
-u 或 --uuid <uuid>通用唯一ID <最大36字符>

在两者 [-a|-i] 之间,只能选择其中之一

# 在Docker运行

docker 镜像请从 docker hub 网站下载 https://hub.docker.com (opens new window).

~\$ docker pull emqx/neuron:1.0.0
1

启动 docker 容器

~\$ docker run -d --name neuron -p 7000:7000 emqx/neuron:1.0.0
1

# 申请试用软件授权

Neuron 缺省安装包提供了