Mac (macOS) Devices Inventory & Actions

Scalefusion's Devices section gives you a complete view of your device inventory across operating system including macOS. As and when a new device successfully enrolls in Scalefusion, the device will start appearing in Scalefusion Dashboard.This guide focusses on familiarizing you with the Scalefusion Device inventory view and the various features available with regards to macOS devices.

Before you Begin

1. Make sure you have enrolled at-least one device using our enrollment guide.
2. Logged into Scalefusion Dashboard.

Scalefusion Devices View

1. Once you login to Dashboard, navigate to the Devices view. In this page you would see all the devices that have enrolled till now.
   You can switch between List view or Grid view using  icon   at the top of the page
2. By default, Scalefusion displays some critical information about the enrolled macOS device in the devices view,
   1. Device Status: Indicates the current management status of the device. The possible states are,
   2. Device Name: Indicates the device name. By default it is the auto-generated name as per the enrollment configuration.
   3. Device Group: Indicates the Device Group that the device is currently assigned to.
   4. Last Seen: Shows the last time Scalefusion backend was able to ping the device. Currently Scalefusion backend makes an automatic ping every 30 minutes.
   5. OS Version: Shows the macOS version that was retrieved from the device.
3. Clicking on the Device name of a particular device takes you to the Device Details Page. This page has been divided into 3 sections,
   1. Device Information Card: Gives a quick snapshot of the device information.
      
      1. Model Identifier: Shows the model identifier of the Mac device being managed.
      2. OS Version: Shows the OS version of the Mac device being managed.
      3. Build Version: Shows the OS Build version of the Mac device being managed.
      4. Bluetooth & WiFi Mac Address: Shows the Mac addresses received from the device being managed.
      5. Managed User: Shows the current user that is being managed. To understand more about User management, please refer to this document.
      6. Host Name: Displays the host name of the device being managed.
      7. Mac Pin: The PIN number that is required to Unlock the device if the device was Locked in the event of theft.
   2. Device State View: This displays the current application policy applied on the device in a device frame and provides you information about the Device Profile and the Device Group that this device belongs to.
   3. Location View: Give a quick view of the last reported IP based location. Also you can quickly see the complete location history of the device or to turn ON/OFF the location collection for this device.
      This is the IP Based Location and hence may not be accurate.
4. Clicking on the Settings/Gear icon as shown below, lets you access additional device-related information and perform device-level actions.
   
   1. Change Device Name: This allows you to change the device name that is used to identify the device in the Scalefusion Dashboard.
      1. Set this as Device Name on Mac/iOS Device: Having this flag checked, admins also have the option to change the device name on the device itself in addition to changing it from Dashboard. The flag is visible in Change Device name dialog box.
   2. Full Device Information: Displays additional granular device information retrieved from the device
   3. Relax Policies: This lets you temporarily relax the device level restrictions. The device is still managed but the policies are not applied.
   4. Apply Policies: If the policies have been previously relaxed, this option can be used to apply the policies back.
   5. Refresh Device: Force attempt a Sync with the device and push latest policies. Note that this option works only if the device is connected to internet.
   6. Add Notes: Allows you to add custom notes/additional information to this device.
   7. Logs: Allows IT Admins to collect Device Console logs from managed devices and share them with developers. These logs can be helpful in identifying the root cause if you are experiencing any issues like crashes, slow speed etc. and also in monitoring system performance. A few prerequisites to fetch system logs:
      1. You should be subscribed to Enterprise 2023 plan
      2. You should have Scalefusion MDM client (agent app for macOS) v3.2.6 or higher
      3. Your account should have access to System Logs
         
         To pull system logs,
         1. Click on Logs from the gear icon menu. Click on the button Get System Logs on the right side panel
            
         2. In the Fetch System Logs window, select a Predicate Type from the following options
            1. All Log Messages: This will fetch all the log messages and will not apply any filter/predicate.
            2. Simple: You can configure predicate to filter the logs. For example, Type IS= logEvent. Add more predicates by adding AND or OR in the Add More drop-down.
            3. Custom: From here, you can define a custom predicate using which the logs will be filtered. For example, process=="Kernel"
      4. Click Next. 
      5. Configure the maximum size of log File. The max size can be up to 50MB. Select the time period for which log collection should be performed. You can either specify timeframe (in minutes from 1 to 1000) or start time and end time during which logs should be collected.
         
      6. Click on Fetch Logs
      7. Logs will be fetched as per configurations, and displayed on Dashboard with current Status.
         
         Once logs are fetched successfully, you should see Download under Status with which the logs can also be downloaded. 
         
         Points to Remember:
         1. Maximum of 12 System log files can be fetched in a Day
         2. The logs are retained for 5 days on the Dashboard
   8. Add/Remove To Device Group: Add or Remove the device from a Device Group.
   9. Assign User: Assign a user to macOS devices using this option. This enables IT Admins to pre-enroll and distribute devices to users/employees, and assign a user for internal tracking. It also makes it easier to identify the device ownership in cases where a large number of devices are distributed among employees. A few pre-requisites to assign a user:
      1. User(s) should be added/imported in User Enrollment section.
      2. The macOS device should be enrolled in user agnostic method (Userless Enrollment).
      3. The user should belong to a user group with a iOS Device Profile applied to the User Group.
          
         To assign a user,
      4. If all pre-requisites are fulfilled, clicking on Assign User will bring up Assign User to device dialog box listing all the users of the user group which the device is part of.
      5. Select a user and click on Save
         
         
         
      6. Note that in Device Details, the Enrollment Email will reflect the user's email id whom you have assigned the device.
      7. The Add to Group option will not be shown under gear icon once device is assigned to a user.
   10. Set Custom Properties: Set the values for the custom properties that you may have defined. Refer to our custom properties guide to understand how to use them.
   11. Reboot Device: Sends a reboot command to the device and the device is rebooted if it is online.
   12. Turn Off Device: Sends a shutdown command to the device and the device is shutdown if it is online.
   13. Lock Device: Use this option in the event of device theft or lost device. This sends a command to lock down the device with a PIN number. The PIN number is displayed in the Device Information card shown above and is configurable. Please refer to this Help document on how to configure Mac PIN.
   14. Factory Reset: Use this option to initiate the factory reset on the device. This action will put the device in System Lock state and ask the end user to enter a PIN. The PIN is displayed to you when you factory reset the device and emailed to you as well. Entering the PIN will complete the factory reset. Please refer to our Help document on this process.
   15. Delete Device: Use this option to un-enroll/un-manage the device and delete it from Scalefusion Dashboard. Note that this action is irreversible.

Frequently Asked Questions

Question: Is it possible to reboot multiple devices at once?

Answer: Yes. Please use Device Groups to group the devices. You can send a reboot command to all the devices in a group.