Giải quyết sự cố với Trình quản lý cấu hình trong macOS Server

Tìm hiểu cách tìm và khắc phục sự cố nếu Trình quản lý cấu hình không hoạt động như mong đợi.

Nếu bạn không thể truy cập vào trang quản trị

Thiết lập cơ bản của Trình quản lý cấu hình nằm trong ứng dụng Server. Bạn phải sử dụng Safari để truy cập trang web /mydevices của Trình quản lý cấu hình và trang web quản trị.

Chỉ quản trị viên máy chủ mới có thể truy cập trang quản trị của bạn. Định dạng URL cho trang quản trị của bạn là:

  • https://your_server's_fully_qualified_domain_name/profilemanager

    • Ví dụ: https://www.example.com/profilemanager

Để đăng ký iPhone, iPad, iPod touch hoặc máy Mac, hãy truy cập:

  • https://your_server's_fully_qualified_domain_name/mydevices

    • Ví dụ: https://www.example.com/mydevices

Nếu bạn không thể truy cập trang quản trị bằng trình duyệt web khác ngoài Safari, hãy thử truy cập bằng Safari. Nếu bạn không thể truy cập trang quản trị bằng Safari, hãy kiểm tra máy chủ DNS. Cài đặt DNS rất quan trọng khi bạn đang quản lý việc triển khai Trình quản lý cấu hình. Nếu Trình quản lý cấu hình không mở, hãy đảm bảo máy chủ hướng dẫn bạn đến máy chủ DNS đáng tin cậy.

Nếu bạn không thể chuyển cấu hình hoặc ứng dụng đến máy khách

Nếu bạn gặp sự cố khi chuyển cấu hình hoặc ứng dụng đến hệ thống máy khách, hãy kiểm tra tệp bản ghi hệ thống trong Bảng điều khiển. Nếu tệp bản ghi cho thấy máy chủ của bạn không thể truy cập máy chủ APN của Apple, hãy kiểm tra cấu hình của mạng bạn đang dùng. Đảm bảo rằng tất cả các cổng cần thiết đều đang mở.

Để biết thêm thông tin, hãy bật bản ghi sửa lỗi APNS bằng các lệnh Terminal sau:

sudo defaults write /Library/Preferences/com.apple.apsd APSWriteLogs -bool TRUE

sudo defaults write /Library/Preferences/com.apple.apsd APSLogLevel -int 7

sudo killall apsd

Bạn có thể xem bản ghi trong ứng dụng Bảng điều khiển bằng cách lọc trên hệ thống phụ com.apple.apsd và com.apple.apspd.

Sau khi giao dịch APNS của bạn được ghi nhật ký, hãy sử dụng các lệnh Terminal sau để tắt bản ghi sửa lỗi:

sudo defaults write /Library/Preferences/com.apple.apsd APSWriteLogs -bool FALSE

sudo defaults delete /Library/Preferences/com.apple.apsd APSLogLevel

sudo killall apsd

Nếu bạn gặp các sự cố khác với Trình quản lý cấu hình

Bản ghi Trình quản lý cấu hình có thể giúp bạn khắc phục sự cố với Trình quản lý cấu hình. Bạn có thể tìm thấy một liên kết biểu tượng có tên "devicemgr" tại /var/log. Tệp này hướng dẫn đến /Library/Logs/ProfileManager, nơi bạn có thể tìm thấy các bản ghi sau:

AuditLogs

  • Các tệp trong thư mục này cung cấp tính năng ghi nhật ký ở định dạng CSV về các yêu cầu và phản hồi từ các bản ghi dịch vụ tương ứng, chẳng hạn như tất cả các lệnh được gửi đến thiết bị hoặc tất cả các hành động do một người dùng cụ thể thực hiện. Mỗi tệp đều có một tiêu đề để mô tả dữ liệu được ghi trong mỗi cột.

devicemgrd.log

  • Cung cấp trạng thái truy vấn và đồng bộ hóa người dùng cùng với nhóm Open Directory và Active Directory.

  • Báo cáo lỗi xảy ra từ các truy vấn được thực thi bởi devicemgrd.

  • Hiển thị các mục nhập liên quan đến việc gửi thông báo đẩy.

  • Hiển thị các mục nhập liên quan đến giao dịch DEP và VPP.

dmAuthService.log

  • Ghi nhật ký trạng thái của các lần xác thực người dùng trên nền tảng web.

dmDeviceService.log

  • Ghi nhật ký các tương tác giữa Trình quản lý cấu hình và các thiết bị được quản lý bằng Trình quản lý cấu hình.

dmhttpd.log

  • Ghi nhật ký dữ liệu HTTP cấp cao cho các yêu cầu và phản hồi của dịch vụ Trình quản lý cấu hình.

dmPortalService.log

  • Ghi nhật ký các yêu cầu và lỗi từ cổng thông tin người dùng /mydevices.

dmSCEPService.log

  • Ghi nhật ký các yêu cầu và lỗi đối với dịch vụ SCEP (được sử dụng trong quá trình đăng ký thiết bị)

dmWebAdminService.log

  • Ghi nhật ký các yêu cầu và lỗi khi sử dụng quản trị web /profilemanager.

dm_helper.log

  • Ghi nhật ký thông tin về việc xác thực người dùng liên quan đến MDM từ người dùng mạng macOS.

dmrunnerd.log

  • Hiển thị trạng thái bắt đầu và dừng các quy trình ruby được quản lý hỗ trợ trang web Trình quản lý cấu hình (/profilemanager và /mydevices). Bản ghi này đôi khi trống.

migration_tool.log

  • Hiển thị trạng thái và chi tiết của quá trình di chuyển từ phiên bản Server.app trước đó.

php-fpm.log

  • Hiển thị trạng thái bắt đầu và dừng các quy trình của trình trợ giúp php-fpm riêng lẻ.

php-fpm.devicemgr.log

  • Các vấn đề với PHP được ghi nhật ký vào tệp này.

PostgreSQL-

  • Ghi nhật ký mọi truy vấn với cơ sở dữ liệu PostgreSQL của Trình quản lý cấu hình dẫn đến lỗi.

  • Tệp này cũng ghi nhật ký các lệnh thay đổi lược đồ cơ sở dữ liệu.

servermgr_devicemgr.log

  • Ghi nhật ký việc bắt đầu và dừng dịch vụ Trình quản lý cấu hình.

Bản ghi này có thể cung cấp thông tin hữu ích liên quan đến máy chủ web:

  • /var/log/apache2/service_proxy_error.log

Lệnh terminal sau có thể cung cấp cho bạn thông tin bổ sung:

sudo log show --info --debug --predicate "(eventMessage contains[cd] 'devicemgr') or (category contains[cd] 'HTTPServer')"

Về "lỗi" giao dịch

Một số bản ghi trong số các bản ghi này có thể liệt kê các "lỗi" giao dịch hoặc những lần thử giao dịch lại. Hầu hết các mục nhập này đều như mong đợi và không cho thấy sự cố. Những sự kiện được ghi nhật ký này là các xung đột giữa những lần sửa đổi cơ sở dữ liệu PostgreSQL cơ bản cùng một lúc. Những kiểu lỗi này sẽ thử lại cho đến khi chúng thành công.

Bạn có thể xác định các xung đột giao dịch khi bạn thấy bất kỳ ghi chú nào sau đây trong tệp bản ghi của mình:

  • Bị hủy do xảy ra xung đột với trục

  • không thể ghi tuần tự quyền truy cập do cập nhật đồng thời

  • @@@ Thử lại #X

  • @@@ Thử lại X

Kiểm tra tệp apspd CFPrefs

Vào /Library/Preferences/ApplePushServiceProvider, chọn com.apple.apspd.plist, sau đó chọn Tệp > Lấy thông tin. Nếu tệp lớn hơn 5KB, hãy xóa tệp và khởi động lại quy trình apspd bằng lệnh Terminal sau:

sudo killall apspd

Sử dụng bản ghi dài để tìm thêm thông tin

Thông tin thêm về cách khắc phục sự cố đôi khi có sẵn nếu bạn tăng cấp độ bản ghi. Để thu thập thông tin bạn cần, hãy tái hiện sự cố sau khi bạn tăng cấp độ ghi nhật ký.

Khi bạn hoàn tất, hãy quay lại cấp độ ghi nhật ký ban đầu. Nếu bạn để cấp độ ghi nhật ký ở cài đặt cao hơn, thì điều này sẽ làm giảm dung lượng trống trên ổ đĩa khởi động của bạn.

Bật bản ghi dài

Để tăng cấp độ ghi nhật ký, hãy sử dụng lệnh Terminal sau:

sudo debugDeviceMgr 4

Lệnh này sẽ tự động khởi động lại Dịch vụ Trình quản lý cấu hình.

Tắt bản ghi dài

Để khôi phục cấp độ ghi nhật ký về cài đặt ban đầu, hãy sử dụng lệnh Terminal sau:

sudo debugDeviceMgr 1

Lệnh này sẽ tự động khởi động lại Dịch vụ Trình quản lý cấu hình.

Tìm hiểu thêm

Ngày đăng: