Giấy phép offline
Tệp giấy phép của bản tự host - nội dung, cách gắn bằng Secret, các trạng thái và ý nghĩa, ân hạn, chế độ chỉ đọc không khóa dữ liệu, gia hạn, lệnh license-status và chỉ số dx_license_days_left.
Bản tự host dùng giấy phép offline: một tệp license.json DataxLand cấp theo hợp đồng. Bản cài kiểm chữ ký của tệp bằng khóa
công khai có sẵn trong ảnh, không gọi về DataxLand và chạy được trong mạng kín.
Nội dung tệp
Tệp JSON gồm định dạng (dataxland-license/1), mã khóa ký, phần nội dung và chữ ký số. Phần nội dung ghi:
| Trường | Ý nghĩa |
|---|---|
license_id | Mã giấy phép |
customer | Tên khách hàng |
edition, plan | Phiên bản và gói (Doanh nghiệp) |
limits.workspaces | Số workspace tối đa; null là không giới hạn |
limits.seats | Số người dùng tối đa; null là không giới hạn |
features | Danh sách tính năng theo hợp đồng, hiện ở trang quản trị |
issued_at, not_before, expires_at | Ngày cấp, ngày bắt đầu hiệu lực, ngày hết hạn |
grace_days | Số ngày ân hạn sau khi hết hạn, mặc định 30 |
deployment | selfhost |
Sửa phần nội dung làm chữ ký sai và giấy phép thành không hợp lệ. Cần đổi giới hạn hay thời hạn, liên hệ DataxLand để nhận tệp mới.
Gắn giấy phép
kubectl -n dataxland create secret generic dataxland-license --from-file=license.json=./license.jsonlicense:
existingSecret: dataxland-license
key: license.json # tên khóa trong Secret chứa tệpChart gắn tệp chỉ đọc vào /etc/dataxland/license/license.json của api, worker và mcp. Cài khi chưa có giấy phép thì
Helm in cảnh báo kèm lệnh tạo Secret và nâng cấp.
Trạng thái
Bản cài kiểm giấy phép lúc khởi động, rồi lại mỗi giờ và mỗi khi tệp đổi.
| Trạng thái | Khi nào | Bản cài |
|---|---|---|
valid | Trong thời hạn | Hoạt động đủ, áp giới hạn workspace và người dùng |
grace | Đã hết hạn, còn trong ân hạn | Như valid; trang quản trị hiện cảnh báo |
expired | Hết cả ân hạn | Chỉ đọc |
not_yet_valid | Chưa tới not_before | Chỉ đọc |
invalid | Sai định dạng, sai chữ ký, khóa ký lạ, không dành cho bản tự host | Chỉ đọc |
missing | Chưa gắn tệp | Chỉ đọc |
Chế độ chỉ đọc
Chế độ chỉ đọc không khóa dữ liệu của bạn:
- Vẫn chạy: dashboard, hỏi Si, MCP, xuất dữ liệu, đăng nhập.
- Bị chặn: tạo workspace, mời người dùng, chạy build hoặc làm mới dữ liệu. API trả lỗi 402 mã
license_inactive.
Dữ liệu dừng ở lần build cuối cùng cho tới khi có giấy phép hợp lệ.
Giới hạn
- Workspace: đếm các workspace đang hoạt động trên toàn bản cài, gồm cả workspace mẫu.
- Người dùng: đếm các tài khoản chưa bị khóa trên toàn bản cài.
Đạt giới hạn thì không tạo thêm workspace hoặc không mời thêm người (lỗi 402 mã license_limit); những gì đang có vẫn dùng bình
thường. Khóa tài khoản không còn dùng sẽ giải phóng chỗ.
Xem trạng thái
Trong ứng dụng: Quản trị → Vận hành, mục Triển khai và giấy phép hiện khách hàng, mã giấy phép, ngày hết hạn, số ngày còn lại (gồm ân hạn), mức dùng so với giới hạn và danh sách tính năng.
Từ dòng lệnh:
kubectl -n dataxland exec deploy/dataxland-worker -- python -m pipelines.cli license-statusLệnh in JSON gồm trạng thái giấy phép, mức dùng, chế độ cách ly, và trả mã thoát 1 khi giấy phép không còn hiệu lực, nên dùng được trong script kiểm tra.
Theo dõi hạn
api xuất chỉ số Prometheus dx_license_days_left: số ngày còn lại tới khi chuyển sang chỉ đọc (gồm ân hạn), nhãn state
là trạng thái hiện tại. Ví dụ luật cảnh báo:
- alert: DataxLandLicenseExpiring
expr: dx_license_days_left < 45
for: 1h
annotations:
summary: Giấy phép DataxLand còn dưới 45 ngày; liên hệ DataxLand để gia hạnGia hạn
-
Liên hệ DataxLand để nhận tệp giấy phép mới.
-
Thay nội dung Secret:
kubectl -n dataxland create secret generic dataxland-license \ --from-file=license.json=./license.json --dry-run=client -o yaml | kubectl apply -f - -
Kubernetes cập nhật tệp đã gắn vào pod sau ít phút; bản cài thấy tệp đổi và đọc lại, không cần khởi động lại. Kiểm bằng
license-statushoặc trang quản trị.
Liên quan
Nâng cấp, sao lưu và khôi phục
Nâng cấp bản tự host bằng helm upgrade (Job migrate chạy trước), lùi bản, sao lưu hằng ngày bằng worker hoặc CronJob, diễn tập khôi phục và khôi phục thật bằng lệnh backup-restore.
Câu hỏi thường gặp và xử lý sự cố
Cách xử lý lỗi thường gặp khi tải Excel, kết nối nguồn, duyệt, build, hỏi Si, nối Slack/Telegram, MCP và khi chạm hạn mức gói.