Xử lý sự cố

Hãy bắt đầu từ nhật ký: phần lớn câu trả lời dưới đây được tìm thấy ở đó.

Danh sách đầy đủ: Nơi HiTechCloud lưu nhật ký.

Đăng nhập xong lại bị đưa về trang đăng nhập​

Biểu hiện: tên người dùng và mật khẩu được chấp nhận tại https://<máy-chủ>:2083, rồi trình duyệt quay lại trang đăng nhập mà không báo lỗi. Điều tương tự xảy ra ở các cổng khách hàng và với liên kết đăng nhập một lần từ HiTechAdmin.

Nguyên nhân: panel lưu phiên trong bộ nhớ đệm tương thích Redis của máy chủ (Valkey hoặc Redis). Khi panel không ghi được phiên vào đó, đăng nhập thành công nhưng phiên mất ở trang kế tiếp. panel.log ghi rõ:

LOGIN - Failed to write to Redis: no connection

hoặc ghi câu trả lời của bộ nhớ đệm, ví dụ WRONGPASS. Từ 4.1.2 biểu mẫu đăng nhập cũng báo điều này, thay vì lặng lẽ đưa bạn quay lại:

Your session could not be saved: the panel cannot reach its session store.

Cách sửa thường là hitechcloudcli objectcache panel-login (bên dưới).

Cần kiểm tra:

grep 'LOGIN - Failed to write to Redis' /var/log/hitechcloud/user/panel.log | tail -5
hitechcloudcli objectcache status
systemctl status valkey-server valkey redis-server redis --no-pager

Unit có tên valkey hoặc valkey-server, redis hoặc redis-server, tuỳ bản phân phối.

• Nếu dịch vụ bộ nhớ đệm đang dừng, hãy khởi động nó rồi đăng nhập lại.

• Nếu bộ nhớ đệm trả lời WRONGPASS hoặc NOAUTH, thông tin đăng nhập bộ nhớ đệm của panel và của instance không khớp. Từ 4.1.2:

  hitechcloudcli objectcache panel-login
  

  ghi thông tin đăng nhập đầu tiên trong hồ sơ mà bộ nhớ đệm chấp nhận và khởi động lại panel một lần. Khi lệnh báo rằng không có thông tin đăng nhập nào mở được instance, hãy đặt mật khẩu quản trị mới cho instance (thông tin đăng nhập của các tài khoản được giữ, panel tự cập nhật theo):

  hitechcloudcli objectcache reset-admin valkey --yes   # hoặc: redis
  

  Mỗi lần cập nhật 4.1.2 cũng chạy panel-login, nên cập nhật máy chủ đang gặp lỗi này sẽ sửa được nó.

ClamAV không khởi động: "No supported database files found"​

Biểu hiện: clamd@scan (hoặc clamav-daemon) dừng ngay sau khi khởi động, journal ghi No supported database files found. freshclam thoát với The PrivateMirror config option may not include servers under *.clamav.net.

Nguyên nhân: các trình cài đặt trước 4.1.2 ghi máy chủ của ClamAV thành PrivateMirror trong freshclam.conf, điều mà freshclam từ chối, nên chưa bao giờ tải được chữ ký virus.

Cách sửa: cập nhật lên 4.1.2 trở lên. Bản cập nhật sửa freshclam.conf (máy chủ của ClamAV thành DatabaseMirror), chạy freshclam tới khi xong rồi mới khởi động clamd. Để chạy riêng bước đó:

hitechcloudcli install --extras-only --with clamav

Tường lửa đang tắt​

Máy chủ mới có ConfigServer Firewall (CSF) được cài nhưng đang tắt, để một quy tắc không thể khoá bạn ra ngoài trong lúc dựng máy chủ. HiTechAdmin và hitechcloudcli module list hiển thị nó là tắt có chủ đích, không phải lỗi.

Bật nó khi bạn đã truy cập được máy chủ:

hitechcloudcli firewall on

Lệnh này dựng lại danh sách cổng mở, cho phép địa chỉ của phiên SSH bạn đang dùng (thêm địa chỉ khác bằng --allow <ip>), rồi bật CSF. Xem hitechcloudcli firewall.

Microsoft SQL Server trên AlmaLinux và RHEL 10​

Biểu hiện: mssql-server không khởi động, journal ghi error while loading shared libraries: liblber-2.4.so.2.

Nguyên nhân: AlmaLinux và RHEL 10 không còn đi kèm thư viện đó. Nó nằm trong gói openldap-compat.

Cách sửa: từ 4.1.2, hitechcloudcli sqlserver install cài openldap-compat trước, chấp nhận giấy phép không cần tương tác, và báo lỗi kèm journal của dịch vụ thay vì báo thành công khi máy chủ không chạy. Với bản cài trước đó:

dnf install -y openldap-compat
hitechcloudcli sqlserver restart
hitechcloudcli sqlserver status

Microsoft không phát hành kho SQL Server cho Ubuntu 26.04, nên ở đó không có SQL Server.

Tác vụ nền không chạy lại được​

Biểu hiện: cài một thứ gì đó từ HiTechAdmin (App Store, một phiên bản PHP, một thành phần mail) không có tác dụng, hoặc báo Unit hitechcloud-install-<name>.service was already loaded or has a fragment file.

Nguyên nhân: tác vụ của panel chạy dưới dạng unit systemd tạm thời tên hitechcloud-install-<tác-vụ>. Unit đã lỗi vẫn được nạp cho tới khi systemd được bảo quên nó. Từ 4.1.2, panel tự dọn unit đã dừng hoặc lỗi và báo already running khi nó vẫn đang chạy.

Cách sửa: xem có gì, đọc vì sao lỗi, rồi dọn:

systemctl list-units --all 'hitechcloud-install-*'
journalctl -u hitechcloud-install-<name> -n 50 --no-pager
systemctl reset-failed 'hitechcloud-install-*'

Sau đó chạy lại tác vụ từ panel.

Máy khách WireGuard kết nối được nhưng không ra được internet​

Quy tắc NAT của VPN cần module masquerade của netfilter thuộc kernel đang chạy. Khi một bản cập nhật đã cài kernel mới hơn, kernel đang chạy có thể không nạp được module đó. hitechcloudcli vpn status nêu lý do, kể cả a newer kernel is installed ... reboot to load it. Hãy khởi động lại máy chủ, rồi:

hitechcloudcli vpn repair

Tìm kiếm (OpenSearch) không được cài trên AlmaLinux 10​

Khoá mà OpenSearch dùng để ký kho gói bị chính sách mật mã của AlmaLinux và RHEL 10 từ chối. Từ 4.1.2, trình cài đặt khi đó cài Elasticsearch, cung cấp cùng tính năng tìm kiếm, và gỡ kho bị từ chối để các lệnh dnf sau vẫn chạy. Khi không cài được cả hai, module được báo là đang chờ kèm lý do, không phải lỗi. Xem Yêu cầu hệ thống.

Vẫn chưa giải quyết được​

Thu thập đầu ra của hitechcloudcli report và các dòng nhật ký ở trên, rồi xem Báo lỗi.