https://thingsboard.io/docs/user-guide/install/ubuntu/, cài ubutu

 

Điều kiện tiên quyết

Hướng dẫn này mô tả cách cài đặt ThingsBoard trên Ubuntu 22.04 LTS / 24.04 LTS. Yêu cầu phần cứng phụ thuộc vào cơ sở dữ liệu được chọn và số lượng thiết bị được kết nối với hệ thống. Để chạy ThingsBoard và PostgreSQL trên một máy tính duy nhất, bạn cần ít nhất 4GB RAM. Để chạy ThingsBoard và Cassandra trên một máy tính duy nhất, bạn cần ít nhất 8GB RAM.

Kiểm tra xem các thư viện phông chữ cần thiết đã được cài đặt chưa:

dpkg -l libharfbuzz0b fontconfig fonts-dejavu-core

Kết quả mong đợi: các gói đã cài đặt sẽ xuất hiện trong kết quả với trạng thái ii .
Nếu thiếu một số thư viện hoặc có trạng thái khác, hãy cài đặt chúng bằng lệnh:

sudo apt update && sudo apt install -y libharfbuzz0b fontconfig fonts-dejavu-core

Bước 1. Cài đặt Java 17 (OpenJDK)

Dịch vụ ThingsBoard đang chạy trên Java 17. Để cài đặt OpenJDK 17, hãy làm theo hướng dẫn sau.

sudo apt update && sudo apt install openjdk-17-jdk-headless

Hãy cấu hình hệ điều hành của bạn để sử dụng OpenJDK 17 theo mặc định . Bạn có thể cấu hình phiên bản mặc định bằng cách chạy lệnh sau:

sudo update-alternatives --config java

Để kiểm tra phiên bản Java đã cài đặt trên hệ thống của bạn, hãy sử dụng lệnh sau:

java -version

Kết quả mong đợi là:

1
2
3
openjdk version "17.x.xx" 
OpenJDK Runtime Environment (...)
OpenJDK 64-Bit Server VM (...)

Bước 2. Cài đặt dịch vụ ThingsBoard

Tải xuống gói cài đặt.

wget https://github.com/thingsboard/thingsboard/releases/download/v4.3.0.1/thingsboard-4.3.0.1.deb

Cài đặt ThingsBoard như một dịch vụ

sudo dpkg -i thingsboard-4.3.0.1.deb

Bước 3. Cấu hình cơ sở dữ liệu ThingsBoard

ThingsBoard có thể sử dụng SQL hoặc phương pháp cơ sở dữ liệu lai. Xem trang kiến ​​trúc tương ứng để biết thêm chi tiết.

PostgreSQL(Khuyến nghị sử dụng cho tốc độ gửi tin nhắn dưới 5.000 tin nhắn/giây)

Kết hợp
PostgreSQL và Cassandra
(Khuyến nghị sử dụng cho tốc độ > 5K tin nhắn/giây)

Nhóm ThingsBoard khuyến nghị sử dụng PostgreSQL cho môi trường phát triển và sản xuất với tải trọng hợp lý (< 5000 tin nhắn/giây). Nhiều nhà cung cấp dịch vụ đám mây hỗ trợ máy chủ PostgreSQL được quản lý, đây là giải pháp tiết kiệm chi phí cho hầu hết các trường hợp sử dụng ThingsBoard. Cài đặt PostgreSQL Để cài đặt cơ sở dữ liệu PostgreSQL , hãy chạy các lệnh sau: 1 2 3 4 5 6 7 8 # Automated repository configuration: sudo apt install -y postgresql-common sudo /usr/share/postgresql-common/pgdg/apt.postgresql.org.sh # install and launch the postgresql service: sudo apt update sudo apt -y install postgresql-16 sudo service postgresql start Sau khi cài đặt PostgreSQL , bạn nên đặt mật khẩu cho người dùng chính của PostgreSQL . Lệnh sau sẽ chuyển đổi người dùng hiện tại sang người dùng PostgreSQL và thiết lập mật khẩu trực tiếp trong PostgreSQL. sudo -u postgres psql -c "\password" Sau đó, nhập và xác nhận mật khẩu. Tiếp theo, kết nối với cơ sở dữ liệu “postgres” với tư cách người dùng “postgres”: psql -U postgres -d postgres -h 127.0.0.1 -W Tạo cơ sở dữ liệu ThingsBoard có tên là “thingsboard”: CREATE DATABASE thingsboard; Nhấn tổ hợp phím “Ctrl+D” hai lần để thoát khỏi PostgreSQL. Cấu hình ThingsBoard Chỉnh sửa tệp cấu hình ThingsBoard sudo nano /etc/thingsboard/conf/thingsboard.conf Thêm các dòng sau vào tệp cấu hình. Đừng quên thay thế “PUT_YOUR_POSTGRESQL_PASSWORD_HERE” bằng mật khẩu người dùng postgres thực của bạn : 1 2 3 4 5 6 7 # DB Configuration export DATABASE_TS_TYPE=sql export SPRING_DATASOURCE_URL=jdbc:postgresql://localhost:5432/thingsboard export SPRING_DATASOURCE_USERNAME=postgres export SPRING_DATASOURCE_PASSWORD=PUT_YOUR_POSTGRESQL_PASSWORD_HERE # Specify partitioning size for timestamp key-value storage. Allowed values: DAYS, MONTHS, YEARS, INDEFINITE. export SQL_POSTGRES_TS_KV_PARTITIONING=MONTHS

Bước 4. Chọn dịch vụ xếp hàng của ThingsBoard

Nền tảng ThingsBoard hiện hỗ trợ hai loại broker nhắn tin để lưu trữ tin nhắn và liên lạc giữa các dịch vụ ThingsBoard: broker trong bộ nhớ và broker dựa trên Kafka.

• Việc triển khai hàng đợi trong bộ nhớ được tích hợp sẵn và là mặc định. Nó hữu ích cho môi trường phát triển (PoC) và không phù hợp cho việc triển khai sản phẩm hoặc bất kỳ loại triển khai cụm nào.

• Kafka được khuyến nghị sử dụng cho các triển khai sản xuất. Hàng đợi này hiện đang được sử dụng trên hầu hết các môi trường sản xuất của ThingsBoard. Nó hữu ích cho cả triển khai tại chỗ và trên đám mây riêng. Nó cũng hữu ích nếu bạn muốn độc lập với nhà cung cấp dịch vụ đám mây của mình. Tuy nhiên, một số nhà cung cấp cũng có các dịch vụ quản lý cho Kafka. Ví dụ như AWS MSK .

• Confluent Cloud là một nền tảng truyền dữ liệu trực tuyến được quản lý hoàn toàn dựa trên Kafka. Rất hữu ích cho các triển khai không phụ thuộc vào nhà cung cấp đám mây.

Xem trang kiến ​​trúc tương ứng và trang công cụ xử lý quy tắc để biết thêm chi tiết.

Tưởng nhớ(được tích hợp sẵn và mặc định)

Kafka(Khuyến nghị sử dụng cho các hệ thống sản xuất tại chỗ)

Đám mây Confluent(Nền tảng truyền phát sự kiện dựa trên Kafka)

Hàng đợi trong bộ nhớ được tích hợp sẵn và bật mặc định. Không cần cấu hình thêm.

Bước 5. [Tùy chọn] Nâng cấp bộ nhớ cho máy tính cấu hình thấp (4GB RAM)

Chỉnh sửa tệp cấu hình ThingsBoard

sudo nano /etc/thingsboard/conf/thingsboard.conf

Thêm các dòng sau vào tệp cấu hình.

1
2
# Update ThingsBoard memory usage and restrict it to 2G in /etc/thingsboard/conf/thingsboard.conf
export JAVA_OPTS="$JAVA_OPTS -Xms2G -Xmx2G"

Chúng tôi khuyên bạn nên điều chỉnh các tham số này tùy thuộc vào tài nguyên máy chủ của bạn. Nên đặt tối thiểu là 2G (gigabyte), và tăng lên nếu có thêm dung lượng RAM. Thông thường, bạn cần đặt nó bằng 1/2 tổng dung lượng RAM nếu không chạy bất kỳ tiến trình nào khác tiêu tốn nhiều bộ nhớ (ví dụ: Cassandra), hoặc bằng 1/3 nếu ngược lại.

Bước 6. Chạy tập lệnh cài đặt

Sau khi cài đặt dịch vụ ThingsBoard và cập nhật cấu hình cơ sở dữ liệu, bạn có thể thực thi đoạn mã sau:

1
2
# --loadDemo option will load demo data: users, devices, assets, rules, widgets.
sudo /usr/share/thingsboard/bin/install/install.sh --loadDemo

Bước 7. Khởi động dịch vụ ThingsBoard

Thực hiện lệnh sau để khởi động ThingsBoard:

sudo service thingsboard start

Sau khi khởi động, bạn có thể mở giao diện người dùng web bằng liên kết sau:

http://localhost:8080/

Thông tin đăng nhập mặc định sau đây sẽ khả dụng nếu bạn đã chỉ định tham số –loadDemo trong quá trình thực thi tập lệnh cài đặt:

• Quản trị viên hệ thống : sysadmin@thingsboard.org / sysadmin
• Quản trị viên người thuê : tenant@thingsboard.org/tenant
• Người dùng khách hàng : customer@thingsboard.org/customer

Bạn luôn có thể thay đổi mật khẩu cho từng tài khoản trong trang hồ sơ tài khoản.

Vui lòng chờ tối đa 90 giây để giao diện web khởi động.

Các bước sau khi cài đặt

Cấu hình HAProxy để bật HTTPS

Bạn có thể muốn cấu hình truy cập HTTPS bằng HAProxy. Điều này khả thi nếu bạn đang lưu trữ ThingsBoard trên đám mây và có tên miền DNS hợp lệ được gán cho phiên bản của mình. Vui lòng làm theo hướng dẫn này để cài đặt HAProxy và tạo chứng chỉ SSL hợp lệ bằng Let's Encrypt.

Nâng cấp lên phiên bản ThingsBoard mới

Đảm bảo nền tảng của bạn luôn an toàn và được cập nhật.

Khi có phiên bản ThingsBoard mới, chúng tôi cung cấp quy trình cập nhật đơn giản để đảm bảo hệ thống của bạn được hưởng lợi từ các tính năng và bản vá bảo mật mới nhất mà không gây rủi ro cho dữ liệu của bạn.

Để duy trì tính toàn vẹn của cơ sở dữ liệu và sự ổn định của hệ thống, vui lòng thực hiện nâng cấp theo trình tự (ví dụ: v4.0.2 → v4.1.0 → v4.2.0).

Vui lòng tham khảo Hướng dẫn Nâng cấp chính thức của chúng tôi để biết các bước chi tiết phù hợp với môi trường triển khai hiện tại của bạn.

Khắc phục sự cố

Nhật ký của ThingsBoard được lưu trữ trong thư mục sau:

/var/log/thingsboard

Bạn có thể sử dụng lệnh sau để kiểm tra xem có lỗi nào ở phía máy chủ hay không:

cat /var/log/thingsboard/thingsboard.log | grep ERROR

Nội dung chính