TopStack 文档

主题

在 Linux 环境下安装 ​

TopStack 支持在 Ubuntu 18 及以上版本、CentOS 7 及以上版本、Rokcy Linux 8 及以上版本、银河麒麟 10 以上版本、UOS 20 以上版本进行安装。下面介绍操作步骤。

安装准备 ​

TopStack 一体化平台需要先安装 Redis（5.x 以上版本） 和 InfluxDB（1.8 版本，暂不提供 2.x 版本支持）, 然后安装 TopStack。

CentOS 离线安装 InfluxDB ​

下载离线安装包：https://www.iotopo.com/download/influxdb-1.8.10.x86_64.rpm

shell
# 安装 influxdb
rpm -ivh influxdb-1.8.10.x86_64.rpm
chown -R influxdb:influxdb /var/lib/influxdb

# 设置存储目录
mkdir /home/influxdb
chown -R influxdb:influxdb /home/influxdb
#将文件 /etc/influxdb/influxdb.conf 中的 /var/lib/influxdb 改为 /home/influxdb
vi /etc/influxdb/influxdb.conf

# 启动服务
systemctl start influxdb

如果 influxdb 启动失败，或按如下文档排查问题：

https://influxdb-v1-docs-cn.cnosdb.com/influxdb/v1.8/troubleshooting/systemd/

离线安装 Redis ​

请先下载相应版本的离线安装包：https://pkgs.org/search/?q=redis

NOTE

UOS 请选择 RokcyLinux8

shell
# 安装 redis
rpm -ivh redis-xxxx.rpm
# 启动服务
systemctl start redis

修改 Redis 配置：vi /etc/redis.conf

安装 TopStack ​

AMD64架构服务器：下载安装包。

ARM64架构服务器：下载安装包。

安装步骤：

  1. 将程序包上传到服务器任意目录
  2. 用管理员身份执行 sudo tar zxvf topstack-xxxxx.tar.gz -C /
  3. 修改执行权限 sudo chmod 777 /iotopo/install.sh
  4. 执行安装脚本 sudo /iotopo/install.sh

注：解压后，会自动在根目录下生成/iotopo目录

启动程序 ​

安装完成后，TopStack 会以系统服务方式自动启动。

执行以下命令启动服务：

shell
#启动服务
sudo systemctl start topstack

如果需要重启服务或停止服务，可以执行以下命令：

shell
#重启服务
sudo systemctl restart topstack
#停止服务
sudo systemctl stop topstack

查看日志 ​

shell
# 查看最近的 100 条日志记录, 并实时显示新的日志
journalctl -u topstack -n 100 -f
# 查看指定时间范围内的日志
journalctl -u topstack --since "2021-01-01" --until "2021-09-16 13:40"
journalctl -u topstack --since "30 min ago"

验证程序 ​

在浏览器中访问 http://<服务器 IP>:8000，默认用户名 admin 密码 admin，如果可以正常打开网页表示安装成功。

激活软件 ​

在浏览器打开软件的控制台管理界面，选择【平台管理】->【平台设置】，切换到“授权”选项卡，点击“激活”按钮，弹出激活对话框。

image.png

方式一：软授权 ​

软授权是通过产品序列号、授权码进行授权，授权码需要绑定服务器机器码，不支持更换服务器、重装操作系统。具体操作步骤如下：

  1. 用户购买产品后会拿到一个产品序列号
  2. 浏览器打开软件的控制台管理界面，选择【平台管理】->【平台设置】，切换到“授权”选项卡，点击“激活”按钮，弹出激活对话框。
  3. 在激活对话框中输入“产品序列号”，点击查看机器码，在新打开的页面中复现机器码，并将该机器码发给我们。
  4. 我们基于您提供的机器码为您生成“授权码”，并将生成的“授权码”发送给您。
  5. 在激活对话框中输入我们提供的“授权码”，点击确定完成激活

image.png

方式二：授权服务器授权 ​

请参考《通过授权服务器进行软件授权》。

软件升级 ​

升级步骤如下：

  1. 替换程序运行目录下的 topstack 文件。
  2. 执行 update.sh 脚本进行升级。

v5.6.2 及以前的版本请按以下步骤进行升级：

**步骤1 **

停止 TopStack 服务

shell
#停止服务
sudo systemctl stop topstack

步骤2

替换程序运行目录（/iotopo）下的 topstack 文件

步骤3

启动 TopStack 服务

shell
#启用服务
sudo systemctl start topstack