Kỹ thuật viên
Đăng ký máy chủ LAN, Chuẩn bị Ca thi, theo dõi đồng bộ, Đặt lại thiết bị.
| Hạng mục | Thông tin |
|---|---|
| Là ai | Quản trị viên hệ thống hoặc Cán bộ điều hành khảo thí có Phân quyền cho Đơn vị của Địa điểm thi |
| Nhiệm vụ | Đăng ký máy chủ LAN (một lần), Chuẩn bị Ca thi (mỗi ngày thi), theo dõi đồng bộ |
| Dùng | Web máy chủ LAN https://<máy-chủ-LAN>:18443/server/, trên máy chủ hoặc từ máy khác trong LAN |
| Mạng | Chỉ mở cổng 18443 ra LAN, cho Máy thi và web máy chủ LAN; không mở cổng nào khác |
Cài Máy chủ thi (một lần)
Cài bằng gói Windows hoặc Linux (cách được hỗ trợ), gói Docker hoặc gói Bun, rồi cài chứng chỉ của máy chủ trên từng Máy thi. Các bước cho từng nền tảng, lệnh amg-runtime và cách xử lý sự cố: Cài đặt Máy chủ thi.
Đăng ký máy chủ LAN (một lần)
Chờ duyệt
Đọc Mã ghép đôi cho người duyệt. Họ duyệt trên Web-Admin khi mã khớp (cách duyệt). Trạng thái chuyển “Đã đăng ký”.


Chuẩn bị Ca thi
Điều kiện: máy chủ có Internet; người bấm là Quản trị viên hệ thống, Cán bộ điều hành khảo thí hoặc Giám thị được phân công.
Bấm “Chuẩn bị”
“Tổng quan máy chủ” → “Ca thi sắp tới” → “Chuẩn bị”. Hệ thống tự: kiểm tra điều kiện → xin Khóa kích hoạt → tải Gói đề, Gói danh tính → Kiểm tra trước ca.

Khóa kích hoạt hết hạn sau 24 giờ — chỉ Chuẩn bị trong ngày thi.
Sau Ca thi
Không có nút gửi thủ công: máy chủ tự đồng bộ khi có Internet. Mục “Đồng bộ” hiện Hàng đợi gửi và trạng thái Đủ bài (Đủ bài · Đang đối soát · Chưa nhận bài · Có xung đột).
Cài đặt máy chủ
Mục Cài đặt trên thanh bên có tab Kết nối & thiết bị cho mọi Tài khoản. Quản trị viên hệ thống có thêm các tab Trạng thái, Mạng, Nhật ký và Cấu hình. Các tab này cho xem proxy, cổng, chứng chỉ, kết nối AMG-Cloud, ổ đĩa, nhật ký và cấu hình của Máy chủ thi; khởi động, dừng hoặc khởi động lại proxy; và sửa cấu hình (cổng LAN, cổng nội bộ, địa chỉ AMG-Cloud). Phiên bản Máy chủ thi đang chạy hiện ở cuối thanh bên.
- Trước khi đăng ký: chỉ mở được trên chính máy chủ. Trên trình duyệt của máy chủ, mở
http://127.0.0.1với cổng nội bộ của Máy chủ thi (cổng runtime trong tệp cài đặtruntime.env; trên Linux,amg-runtime statusin nó ở dòngRuntime) và đường dẫn/server/, rồi bấm liên kết “Cài đặt máy chủ” trên màn Thiết lập hạ tầng. Địa chỉ này dùng được trên cả Windows và Linux. Từ máy khác trong LAN, hoặc qua địa chỉ LAN của máy chủ, thì bị từ chối. - Sau khi đăng ký: Quản trị viên hệ thống có Phân quyền cấp Đơn vị trở lên đăng nhập, mục “Cài đặt”. Thao tác cần đăng nhập trực tuyến; Phiên Offline chỉ xem.
- Khi Ca thi đang mở, Dừng hoặc Khởi động lại proxy, áp dụng cấu hình, đổi địa chỉ LAN và cấp lại chứng chỉ cần nhập Lý do, vì Máy thi sẽ mất kết nối. Mọi thao tác được ghi vào nhật ký chẩn đoán của máy chủ.
- Windows: đổi địa chỉ LAN và cấp lại chứng chỉ ở tab Mạng; máy chủ cấp chứng chỉ mới bằng CA của nó, nên Máy thi không phải cài lại chứng chỉ. Đổi cổng LAN ở tab Cấu hình cũng chuyển quy tắc tường lửa sang cổng mới.
- Linux: chứng chỉ và tường lửa thuộc quyền root, nên màn hình không đổi địa chỉ LAN, không cấp lại chứng chỉ và không đổi tường lửa; nó hiện lệnh cần chạy trên máy chủ. Đổi địa chỉ LAN bằng
sudo amg-runtime config --edit: sửa dòng địa chỉ LAN trong tệp cài đặt, lưu lại, lệnh tự áp dụng. Cấp lại chứng chỉ bằngsudo /opt/amg-runtime/current/install.sh --new-certificate. Sau khi đổi cổng LAN trên màn hình, chạysudo amg-runtime config --applyđể mở cổng mới trên tường lửa.
Khi gặp sự cố
| Tình huống | Làm gì |
|---|---|
| “Yêu cầu trước bị từ chối / đã hết hạn” | Đọc lý do, gửi yêu cầu mới |
| “Đồng hồ máy chủ lệch … giây” | Đồng bộ đồng hồ (NTP) |
| “Chuẩn bị Ca thi cần phiên đăng nhập trực tuyến” | Kiểm tra Internet, đăng nhập lại |
| “Chưa có Ca thi nào có Gói đề.” | Cán bộ điều hành chưa tạo Gói đề |
| “Thiết bị đã bị thu hồi” | Đặt lại thiết bị (bên dưới) rồi đăng ký lại |
| Sự cố chưa rõ nguyên nhân trong Ca thi | Ghi lại giờ xảy ra, gửi bộ phận hỗ trợ những gì nêu ở Báo sự cố |
Đặt lại thiết bị
Chỉ dùng khi AMG-Cloud đã thu hồi máy chủ, Hàng đợi gửi trống và không có Ca thi mở.
- “Cài đặt” → tab “Kết nối & thiết bị” → “Đặt lại thiết bị”.
- Gõ chuỗi xác nhận màn hình yêu cầu → “Đặt lại thiết bị”.
- Gửi Yêu cầu đăng ký mới.
Dữ liệu cũ được chuyển vào thư mục lưu trữ, không bị xóa. Nếu Hàng đợi gửi còn gói chưa xác nhận: liên hệ bộ phận hỗ trợ, không tự xử lý.
Báo sự cố
Máy chủ thi tự ghi nhật ký hoạt động (log) và dấu vết xử lý (trace) thành tệp trên ổ đĩa của chính nó, không cần Internet. Đây là bản chẩn đoán cho bộ phận hỗ trợ, không phải bằng chứng: Bài làm vẫn nằm trong dữ liệu Ca thi và đồng bộ như bình thường.
| Hạng mục | Thông tin |
|---|---|
| Ghi gì | Đăng nhập đúng và sai của Thí sinh, Giám thị; nộp bài; lưu bài bị từ chối; đăng ký, duyệt, từ chối, thu hồi Máy thi; đóng Ca thi; đồng bộ và heartbeat; Chuẩn bị Ca thi; Đặt lại thiết bị. Mỗi dòng gắn mã Ca thi, Bài làm, Máy thi khi biết |
| Không ghi | Mật khẩu, mã phiên đăng nhập, nội dung câu trả lời, bản ghi âm |
| Nằm ở đâu | Thư mục chẩn đoán cạnh dữ liệu máy chủ, tách khỏi danh tính thiết bị. Gói cài Windows và Linux: trong thư mục dữ liệu của máy chủ, chỉ quản trị viên máy mở được; Quản trị máy chủ → Nhật ký → “Tải báo cáo chẩn đoán” cho một báo cáo ngắn không cần mở thư mục. Gói Docker: trong volume dữ liệu của máy chủ. Còn nguyên sau Đặt lại thiết bị |
| Giữ bao lâu | Mỗi lần máy chủ khởi động, một tệp mới. Khi khởi động, tệp quá 30 ngày bị xóa, rồi tệp cũ nhất khi tổng vượt 500 MB. Tệp mới nhất luôn được giữ |
| Đọc bằng gì | Định dạng chuẩn (JSON Lines, OpenTelemetry); bộ phận hỗ trợ đọc, Kỹ thuật viên chỉ cần gửi |
Khi báo sự cố, gửi:
- Giờ xảy ra, lúc bắt đầu và lúc kết thúc, theo giờ Việt Nam. Tệp ghi giờ UTC (giờ Việt Nam trừ 7 giờ); bộ phận hỗ trợ tự đổi.
- Ca thi, Thí sinh hoặc Máy thi liên quan, nếu biết.
- Cả thư mục chẩn đoán, nén và mã hóa. Tệp có mã Thí sinh: không gửi qua kênh công khai.
- Ảnh chụp màn hình lúc gặp lỗi, nếu có.
Không gửi dữ liệu Ca thi hay danh tính thiết bị nếu bộ phận hỗ trợ không yêu cầu: chúng chứa khóa thiết bị và Bài làm.




