Cài đặt Endpoint Server

​

Yêu cầu hệ thống

​

Trường hợp quản lý ít hơn 100 thiết bị

​

Trường hợp quản lý từ 100 - 1000 thiết bị

​

Hướng dẫn cài đặt

1

Tải công cụ cài đặt

mkdir -p ~/endpoint && cd ~/endpoint
wget https://d.cystack.net/endpointctl/endpointctl
ls -l

2

Cấp quyền thực thi

chmod +x endpointctl

3

Cài đặt

./endpointctl start

Khi được yêu cầu, nhập mật khẩu root. Quá trình cài đặt mất khoảng 1–3 phút.

4

Lựa chọn hình thức cài đặt

Tùy chọn 1: Sử dụng cấu hình mặc định

• Hệ thống tự tạo cơ sở dữ liệu, người dùng không cần can thiệp.
• Nhập 1 và nhấn Enter.

Tùy chọn 2: Dùng MySQL có sẵn của doanh nghiệp

• Nhập 2 và nhấn Enter.
• Chuẩn bị sẵn thông tin sau:

Trường	Ví dụ
MySQL Host	localhost
MySQL Port	3306
Database/User/Password cho các dịch vụ	ces_fleet / ces_api / ces_data_labeling

5

Nhập thông tin Workspace

Sau khi MySQL cấu hình xong, hệ thống yêu cầu nhập:

Work Space ID
Work Space Secret

(CyStack sẽ cung cấp 2 giá trị này)Thời gian cài đặt: 3–10 phút (tùy cấu hình server). Khi hoàn tất, chương trình sẽ hiển thị danh sách dịch vụ đang chạy.

6

Sau khi cài đặt

✅ Kiểm tra file agentSau khi hoàn tất, file agent được tạo tự động:

cystack-endpoint_<phiên bản>_amd64.deb

✅ Tự động cập nhật định kỳChạy:

nohup ./endpointctl update > endpoint_updater.log 2>&1 &

​

Hướng dẫn sử dụng endpointctl

​

Danh sách các tham số và cờ

​

Một số trường hợp lỗi

​

❌ Container báo “Unhealthy”

• Nguyên nhân: server yếu hoặc lỗi cấu hình database.
• Cách xử lý:
  • Kiểm tra log container:
    docker logs -f ces_fleet_container
    
  • Nếu migrate xong chạy lại:
    ./endpointctl start --re-config
    
  • Nếu lỗi database xóa config và cài lại từ đầu.

​

⚠️ Lỗi thiếu config

​

⚙️ Backup lâu

​

🔑 Lỗi khi lấy Token

​

🌐 Lỗi domain (Caddy)

• Kiểm tra log:
  docker logs -f caddy_container
  
• Nếu:
  • Domain chưa trỏ đúng IP cập nhật DNS.
  • Domain bị giới hạn SSL đổi domain khác.