MacCheck will be completed in a series of 5 steps (The USB Cloner process is only done once per external USB Drive)
USB Cloner Process - Performing Diagnostics will require a formatted external USB Drive to be connected to the Mac you wish to diagnose.
Boot Mac from External Drive - Once the external USB drive is connected, the user must boot into the computer using the external drive.
MacCheck Diagnostic and Restore - Once the computer is booted using an external drive, This will present the user with the MacCheck Diagnostic application
Mac Diagnostic Portal - This portal allows you to view up to 50 ports/connections at once
MacCheck Cloud Database View - Once the user completes Diagnostic and Restore, results will be saved onto your Dashboard -> Mac Portal.
API Documentation
GET mac-all-device-info from Mac Device Info: https://phonecheck.atlassian.net/wiki/spaces/KB/pages/3116040194 | GET mac-device-info from Mac Device Info: |
System Specs
Hardware Requirement |
macOS-Silicon (M-series) Ventura, Sonoma, and Big Sur can technically be installed on a 64 GB USB drive, it is not recommended for long-term use due to potential performance issues.
|
Supported Devices | Intel-based MacBooks
Intel-based iMacs
Apple Silicon Chip MacBooks
|
Support macOS | Intel-based MacBooks/iMacs/Mac mini
Apple Silicon Chip MacBooks/iMacs/Mac mini
|
Remote Portal for Viewing | |
Device Information DB | |
Printer Support |
|
Label Support |
|
Non-Supported Devices |
|
Getting Started
1 | Peripherals and Hardware needed to get started with Mac Diagnostics |
|
2 | Login with a Station User for the Bootable USB OS |
|
3 | Create Bootable OS with Mac Diagnostics Application using the Phonecheck USB Cloner |
|
4 | Connect the MacBook to an Internet Connection |
Note - If you don’t have ethernet and have to connect using WiFi than you need to do the following:
|
5 | Boot the MacBook from the Bootable OS created from the USB Cloner |
|
6 | Perform Testing with the Mac Diagnostics Application |
|
7 | View Connected MacBooks on the Mac Portal |
|
8 | Sync Data to the Cloud Dashboard |
|
USB Cloner Process
Prerequisites
Before using the Phoncheck USB Cloner, ensure the following: |
|
USB Format Requirements |
|
Download Cloner |
Erasing the USB Drive to Prepare for the Phonecheck USB Cloner
Instructions:
Erase the USB Drive via DiskUtil
1 | Open Disk Utility on your macOS computer. |
2 | Select the USB drive from the left sidebar. |
3 | Go to the "Erase" tab |
4 | Choose "APFS" from the "Format" dropdown menu. |
5 | Click the "Erase" button to format the USB drive in APFS |
Note - Contact Support if you encounter any issues erasing in APFS format.
MacCheck USB Cloner Process
Instructions:
1 | Connect the external USB drive to your computer. |
2 | Launch PhoneCheck USB Cloner. If already launched before the drive erasure, re-launch the Phonecheck USB Cloner. |
3 | Provide the required username and password. (Station User Name and Password - Contact Support if needed) |
4 | Select the OS |
5 | Select the Destination Drive. |
6 | Provide the port number on which you want to see the data for that Mac on the Mac Diagnostic Portal. |
7 | Press the "Start" button to initiate the OS cloning process. |
8 | Once completed, you will see "Done, installation successful." |
9 | External Drive can now be ejected and is ready to be used. |
Boot Mac from the External Drive
Instructions:
1 | Connect the External Hard Drive: |
|
2 | Restart Your Mac: |
|
3 | Access Boot Menu or Startup Manager: |
|
4 | Select the External Hard Drive: |
|
Mac T2 Chip Process
Operating T2 Chip Intel Mac | T2-locked Intel Macs will not allow you to boot from the external drive; to do so, follow the T2 Unlock instructions: |
MacBook Diagnostics Application
Note - Before opening the MacBook Diagnostics Application, ensure the device is connected to the Internet.
Here’s what will happen if the Internet disconnects while using the app:
If the MacCheck app is running and loses its Internet connection, a popup message will appear saying, "No Internet Connection for MacDiag app."
This popup will appear anytime the app tries to:
Sync data to the cloud, or
Fetch data from the cloud but can’t because there’s no Internet.
The MacCheck app will keep checking for an Internet connection in the background.
As soon as the Internet is restored, the popup will automatically disappear, and the app will continue working as normal.
Features & Tests
1 | Begin Testing
A loading screen will appear.
|
|
2 | Group Selecting
Flow from the Cloud:
MacDiag App Flow:
|
|
2 | Information Collection
|
|
3 | Automated Tests
|
|
4 | Semi-Automated Tests
|
|
5 | Manual Tests
|
|
6 | Grading
|
|
Phonecheck Diagnostics Test Flow and macOS Restore
Note - The Mac Diagnostics Desktop Application will automatically restore the OS once the user is logged into the Phonecheck Mac Diagnostics app.
Diagnostics and Restore for Mac Diagnostics Application
Test Result Status
|
|
Restore Status
|
|
Erasing in Progress
|
|
Restore Success
|
|
Post-Testing Steps
|
|
Mac Diagnostic Portal
The Mac Diagnostic Portal is a dynamic cloud-based platform that provides real-time insights into MacBook processing details. The users can effortlessly track essential information, such as the connected port, specific MacBook details, print labels, and comprehensive test results, including the number of tests passed, failed, and pending.
1 | Getting Started
|
|
2 | Login
|
|
3 | Bootup MacBooks with Diagnostics
|
|
4 | Portal Details This portal offers testers an immediate and live overview of the MacBook's status, ensuring efficient monitoring and management of testing processes like
|
|
5 | Port Number
|
|
6 | Device information Device Information will be shown on the left side of the Device Detail Model below the Port Number and will consist of the following in the same order.
|
|
7 | Test Results and Statuses This section will be identical to the Device information section in the device detail model. It will consist of the test name with a symbol showing the test status.
|
|
8 | Eraser Information
|
|
9 | Settings
|
|
10 | General Tab
|
|
11 | Printers Tab
|
|
Action Buttons
1 | Available Options Every attached device with ports will show the action button when the mouse hovers on the port; the action buttons are:
|
|
2 | Print Button
|
|
3 | Info Button
|
|
Printing and Labeling
1 | Supported Printer & Label Size
|
|
2 | Installation of Dymo Printer driver
|
|
3 | Installation of Zebra printer driver Drivers needed to be installed
After installing these SDKs and connecting the Zebra printer, we have to manually add the connected Zebra printer to the Zebra browser SDK settings.
|
|
4 | The following elements are available on the label:
|
|
MacCheck Cloud DB View
The Mac Devices is a view where processed MacBook records are stored for the user to view.
1 | Getting Started
|
|
2 | Login
|
|
3 | Mac Devices
|
|
4 | Data View & Column Search
|
|
5 | Date Filter
|
|
6 | Using Date Range
|
|
7 | Search Devices filter
|
|
8 | Saved View Filters
|
|
9 | Save Filter Button
|
|
10 | Filter Setting Button
|
|
11 | Reorder Columns
|
|
12 | Visible or Hide Columns
|
|
Troubleshooting or Reporting a Bug
1 | Getting Started |
|
2 | Collecting logs from Phonecheck USB Cloner |
|
3 | Collecting logs from Mac Diagnostics |
|