产品定价 立即试用
专业版
入门 文档 指南
架构 API 常见问题
目录

ThingsBoard PE v3.0.x Docker 升级说明

Upgrading ThingsBoard PE to 3.0.1

NOTE: These upgrade steps are applicable for ThingsBoard version 3.0PE. In order to upgrade to 3.0.1PE you need to upgrade to 3.0PE first.

文档信息图标

升级至 ThingsBoard 3.0 前的重要提示

  • ThingsBoard UI 已从 AngularJS 1.5.8 重写为 Angular 9。
    • 这意味着什么?
      • 概括而言,意味着:现代化应用、更易开发前端元素、性能提升以及 UI 定制更灵活。
    • 如何升级?
      • 若您不在仪表盘中使用自定义部件或自定义操作,可安全升级。
      • 新的 JS 框架可能不完全支持您当前的代码(自定义部件和自定义操作),需稍作重构。因此建议您使用我们的云环境或开发实例测试您的定制内容。
  • 从纯 Cassandra 迁移至混合数据库方案
    • 我们仍支持 Cassandra 存储遥测数据,但不再用于存储设备、客户、租户等实体。
    • 这意味着什么?
      • 这将简化维护和未来改进,并将在 v3.1 中支持高级搜索能力。
    • 如何升级?
      • 若您使用纯 PostgreSQL 或 PostgreSQL(实体)+ Cassandra(遥测),则不受影响。
      • 若您使用纯 Cassandra,升级过程将自动执行但需一定时间。停机时间取决于设备、属性、告警和关系的数量。 若上述实体少于 1000 万,升级通常仅需数分钟,具体取决于数据库性能。

ThingsBoard PE image download

Download ThingsBoard PE Docker image:

1
docker pull thingsboard/tb-pe:3.0.1PE

ThingsBoard PE service upgrade

  • Stop ThingsBoard mytbpe container if it is running.
1
docker compose stop mytbpe
文档信息图标

If you still rely on Docker Compose as docker-compose (with a hyphen) execute next command:
docker-compose stop mytbpe

  • Update docker-compose.yml
1
2
3
4
< . . . >
  mytbpe:
    image: "thingsboard/tb-pe:3.0.1PE"
< . . . >
  • Change upgradeversion variable:
1
echo '3.0.0' | sudo tee ~/.mytbpe-data/.upgradeversion
  • Execute the following commands to upgrade ThingsBoard to the new version:
1
docker compose run mytbpe upgrade-tb.sh
文档信息图标

If you still rely on Docker Compose as docker-compose (with a hyphen) execute next command:
docker-compose run mytbpe upgrade-tb.sh

  • Start ThingsBoard:
1
docker compose up -d
文档信息图标

If you still rely on Docker Compose as docker-compose (with a hyphen) execute next command:
docker-compose up -d

Upgrading ThingsBoard PE to 3.0

ThingsBoard PE image download

Download ThingsBoard PE Docker image:

1
docker pull thingsboard/tb-pe:3.0.0PE

ThingsBoard PE service upgrade

  • Stop ThingsBoard mytbpe container if it is running.
1
docker compose stop mytbpe
文档信息图标

If you still rely on Docker Compose as docker-compose (with a hyphen) execute next command:
docker-compose stop mytbpe

  • Update docker-compose.yml
1
2
3
4
< . . . >
  mytbpe:
    image: "thingsboard/tb-pe:3.0.0PE"
< . . . >
  • Change upgradeversion variable:
1
echo '2.5.0' | sudo tee ~/.mytbpe-data/.upgradeversion
  • Execute the following commands to upgrade ThingsBoard to the new version:
1
docker compose run mytbpe upgrade-tb.sh
文档信息图标

If you still rely on Docker Compose as docker-compose (with a hyphen) execute next command:
docker-compose run mytbpe upgrade-tb.sh

  • Start ThingsBoard:
1
docker compose up -d
文档信息图标

If you still rely on Docker Compose as docker-compose (with a hyphen) execute next command:
docker-compose up -d

下一步