Xử lý sự cố: cài đặt và hệ thống

Quay lại Xử lý sự cố.

Windows chặn bộ cài (SmartScreen)

Bộ cài 9BizClaw cho Windows hiện chưa có chữ ký số. Vì vậy, khi bạn mở tệp 9BizClaw-v3-Setup-<phiên bản>.exe, Windows có thể hiện màn hình xanh Windows đã bảo vệ PC của bạn (Windows protected your PC) với dòng nhà phát hành Không xác định (Unknown publisher).

1. Chỉ dùng bộ cài tải từ v3.9bizclaw.com. Nếu tệp đến từ nguồn khác, đừng chạy, hãy liên hệ hỗ trợ.
2. Trên màn hình xanh, bấm Thông tin thêm (More info).
3. Kiểm tra tên ứng dụng là 9BizClaw-v3-Setup-<phiên bản>.exe, rồi bấm Vẫn chạy (Run anyway).
4. Bộ cài chạy tiếp như bình thường. Bạn chỉ cần làm việc này một lần cho mỗi bản cài.

Nếu trình duyệt báo tệp không thường được tải xuống:

• Edge: bấm dấu … cạnh tệp, chọn Giữ lại (Keep), rồi Hiện thêm (Show more) và Vẫn giữ lại (Keep anyway).
• Chrome: bấm Giữ lại (Keep) trong danh sách tệp tải xuống.

Nếu màn hình chặn không có nút Vẫn chạy, có thể máy đang bật Smart App Control hoặc bị công ty quản lý. Đừng tự tắt tính năng bảo mật này. Hãy chụp màn hình và liên hệ hỗ trợ.

Cài lần đầu không xong

1. Kiểm tra mạng, dung lượng ổ đĩa và quyền ghi vào thư mục cài đặt.
2. Bấm Thử lại bước này. App dùng lại những gì đã tải, nên bạn không cần xóa thư mục.
3. Nếu công ty dùng proxy, bấm Cấu hình mạng rồi thử lại.
4. Nếu lỗi ở Hệ thống trên máy, bấm Thử lại bước này. Vẫn lỗi thì đóng hẳn app rồi mở lại.
5. Trên Windows, nếu thấy dòng EPERM: operation not permitted, rename, hãy thoát app từ khay hệ thống, chờ khoảng một phút rồi mở lại. Nếu lỗi lặp lại, ghi lại tên phần mềm diệt virus và bấm Gửi cho hỗ trợ.

Màn hình lỗi cho biết nguyên nhân và việc cần làm tiếp. Một số thông báo hay gặp:

Thông báo bắt đầu bằng	Cách xử lý
Ổ đĩa không đủ chỗ trống	Giải phóng ít nhất 1 GB rồi bấm Thử lại bước này.
Windows đang khóa tệp cài đặt	Thoát 9BizClaw ở khay hệ thống, chờ 1 phút rồi mở lại app.
Node.js vừa tải không chạy được	Xem mục cách ly (quarantine) của phần mềm diệt virus, khôi phục tệp rồi thử lại.
Windows chưa cho 9BizClaw ghi vào thư mục cài đặt	Thư mục thường được tạo lúc chạy bằng quyền quản trị. Bấm Cho phép rồi chọn Có khi Windows hỏi. App tự cấp quyền ghi cho tài khoản của bạn rồi chạy tiếp bước đang dở, dữ liệu được giữ nguyên. Nếu vẫn lỗi, bấm Tạo file log gửi hỗ trợ.
Thư mục cài đặt đang chứa dữ liệu của chương trình khác	Đóng app, mở lại và chọn một thư mục trống, ví dụ D:\9biz.
Một bước cài đặt chạy quá lâu nên bị dừng	Đóng bớt ứng dụng nặng rồi bấm Thử lại bước này. App tự dọn phần còn dở của lần trước, bạn không cần xóa thư mục.
Mạng quá chậm nên tải bị ngắt giữa chừng	Mạng chậm mà vẫn đang tải thì app chờ tiếp, chỉ dừng khi quá 10 phút không tải được gì. Bấm Thử lại bước này: app xóa phần tải dở rồi cài lại từ đầu, các gói đã tải được dùng lại nên lần này nhanh hơn. Vẫn chậm thì thử mạng khác như 4G điện thoại.
Lõi trợ lý tải về chưa đầy đủ	Bấm Thử lại bước này. App cài lại thư viện của lõi trợ lý từ đầu, bạn không cần xóa thư mục.
Kết nối tới máy chủ tải bị chặn	Bấm Cấu hình mạng để nhập proxy, hoặc thử mạng khác như 4G điện thoại.
Cài đặt gặp lỗi chưa rõ nguyên nhân	Thử lại một lần, sau đó bấm Tạo file log gửi hỗ trợ.

Nếu bấm Chọn thư mục mà app báo Không dùng được thư mục này, hãy chọn thư mục khác. App không cài vào C:\Windows, Program Files hoặc ProgramData.

Nếu vẫn kẹt ở cùng một bước sau khi đã thử lại và mở lại app, hãy liên hệ hỗ trợ.

Nơi app ghi log

Trên Windows, app ghi log vào %APPDATA%\9BizClaw-v3\logs. Mỗi dòng có thời điểm theo giờ UTC.

• gateway.log: lý do chi tiết khi một bước cài đặt thất bại (dòng installer.<bước>, có mã lỗi như ENOSPC hoặc NPM_FAILED), khi chọn thư mục bị từ chối (installer.folder) và khi hệ thống trên máy không khởi động (gateway.error, gateway.start_failed).
• main.log: các mốc khởi động của app.

Nút Tạo file log gửi hỗ trợ trên màn hình cài đặt và mục Báo lỗi đều tự gom các tệp này, nên bạn không cần tìm thủ công.

Bộ cài .exe báo lỗi hoặc tắt ngay

Bộ cài 9BizClaw-v3-Setup-<phiên bản>.exe chạy trước khi app có thư mục log, nên nó không ghi log. Tham số /LOG của NSIS cũng không dùng được, vì bộ cài không được build với chế độ ghi log. Hãy làm như sau:

1. Chụp lại hộp thoại lỗi. Hộp thoại của bộ cài hiện bằng tiếng Anh:

   • 9BizClaw v3 cannot be closed: thoát 9BizClaw ở khay hệ thống rồi bấm Retry.
   • Failed to decompress files: tải lại bộ cài, kiểm tra ổ đĩa còn trống, rồi chạy lại.

2. Lấy mã thoát của bộ cài. Mở Command Prompt ở thư mục chứa bộ cài, rồi chạy:

   start /wait "" "9BizClaw-v3-Setup-<phiên bản>.exe"
   echo %ERRORLEVEL%

   Mã 0 là cài xong, 1 là đã bấm hủy, 2 là bộ cài tự dừng vì lỗi.

3. Gửi ảnh chụp và mã thoát cho hỗ trợ. Nếu bộ cài chạy xong nhưng app không mở, xem mục App mở rồi nhưng chưa dùng được.

App mở rồi nhưng chưa dùng được

Nếu ứng dụng hiện Chưa thể mở không gian làm việc, chọn Thử lại một lần. Thao tác này tải lại giao diện, không xóa dữ liệu hoặc tự cài lại thành phần. Nếu vẫn gặp lỗi, chọn Lấy log và gửi tệp vừa được mở trong thư mục cho đội hỗ trợ. Tệp chỉ được tạo trên máy. Ứng dụng không tự gửi tệp đi.

Khi giao diện không tải được, ứng dụng có thể hiện hộp thoại hệ thống với các lựa chọn tương tự. Nếu lỗi xảy ra trước khi mở cửa sổ, Thử lại khởi động lại ứng dụng. Lấy log tạo tệp rồi đóng ứng dụng để bạn gửi hỗ trợ. Nếu hộp thoại hệ thống báo Chưa lấy được tệp log, ứng dụng giữ các lựa chọn để bạn thử xuất log lại, thử mở lại ứng dụng hoặc chọn Để sau. Tệp log không được tự xuất lại khi chưa có thao tác của bạn. Nếu Lấy log không khả dụng hoặc báo thất bại, gửi ảnh thông báo, phiên bản và thời điểm xảy ra lỗi. Không tự xóa cấu hình, hội thoại hoặc thư mục cài đặt.

Việc chưa kiểm tra được trạng thái cài đặt không được coi là đã hoàn tất thiết lập. Ứng dụng sẽ yêu cầu thử lại thay vì tự bỏ qua bước cài đặt hoặc đăng nhập.

1. Chờ thêm một chút. Hệ thống có thể cần vài chục giây sau khi cửa sổ đã hiện. Trong lúc đó bạn vẫn vào được Chat.
2. Bấm dòng trạng thái Hệ thống ở góc dưới bên trái để mở Trạng thái hệ thống, rồi bấm nút làm mới trạng thái.
3. Nếu sau vài phút vẫn chưa được, thoát hẳn app từ khay hệ thống rồi mở lại.

Báo dữ liệu trợ lý đang được chương trình khác dùng

Sau khi cập nhật, app có thể cần nâng cấp dữ liệu trợ lý. Nếu màn hình báo Dữ liệu trợ lý đang được một chương trình khác dùng nên chưa cập nhật được, dữ liệu của bạn chưa bị thay đổi. Lần này cũng không bị tính là một lần nâng cấp hỏng.

1. Thoát hẳn 9BizClaw, kể cả biểu tượng ở khay hệ thống, rồi mở lại app.
2. Nếu vẫn báo như vậy, bấm Thử lại.
3. Vẫn chưa được thì bấm Báo lỗi ở góc dưới để đội hỗ trợ xem giúp. Đừng tự xóa thư mục dữ liệu.

Nếu chỉ có Tri thức báo đang chuẩn bị, bạn chỉ cần chờ. Mục này đang tải thành phần tìm kiếm tài liệu, không liên quan đến Chat.

macOS hiện hộp "cài công cụ dành cho nhà phát triển" hoặc báo lỗi Git

Trên Mac chưa có Command Line Tools, mỗi lần một chương trình gọi git, macOS sẽ hiện hộp mời cài công cụ dành cho nhà phát triển. Nếu cài không xong, hộp này cứ hiện lại. Cách xử lý, làm lần lượt:

1. Mở Terminal (tìm bằng Spotlight) và chạy lệnh dưới đây. macOS hiện hộp cài đặt, bạn bấm Cài đặt rồi chờ đến khi xong.

   xcode-select --install

2. Kiểm tra lại. Lệnh này in ra số phiên bản thì Git đã dùng được:

   git --version

3. Máy có cài cả Xcode mà vẫn báo chưa đồng ý điều khoản: chạy lệnh dưới, đọc và gõ agree khi macOS hỏi. Lệnh cần quyền quản trị nên sẽ hỏi mật khẩu máy của bạn. Máy không có Xcode thì bỏ qua bước này.

   sudo xcodebuild -license

4. Đã cài nhưng vẫn lỗi hoặc hộp vẫn hiện: gỡ bản cài hỏng rồi cài lại. Thư mục này chỉ chứa công cụ dòng lệnh của Apple, không có dữ liệu của bạn hay của 9BizClaw.

   sudo rm -rf /Library/Developer/CommandLineTools
   xcode-select --install

5. Mở lại 9BizClaw. Nếu hộp vẫn hiện hoặc lỗi vẫn còn, bấm Báo lỗi ở góc dưới và ghi rõ lỗi hiện ở bước nào.