Management for datajar.mobi

Management for macOS

The Management app is a macOS app that runs on macOS. It allows your administrators access to the inventory of your enrolled Apple devices, as well as access to some commonly used management commands.

Requirements

The following are the requirements to be able to use the Management app:

• You must be a datajar.mobi customer
• Your Mac must be running macOS 10.12+
• You will need a web API key which will be provided by the support team at dataJAR.

Installing the App

The easiest way to deploy the app is via the Volume Purchase Program (VPP). The app is free of charge, so purchase enough copies for your requirements.

Once you have purchased the Management app, let our support team at dataJAR know and they can deploy it for you, along with your unique web API key.

Using the App

When you first launch the app, you will be asked to set a password for security purposes.

After setting this, and on subsequent launches, you will be asked to enter the password to authenticate. This is used to prevent unauthorised access to the app.

Once you have authenticated, the app comprises four main screens, plus a settings pane.

Settings

Settings for the app can be accessed via the menu bar item "Management" followed by "Preferences..." or with the ⌘+, keys.

Here you can enter the URL for your management server and API key. If the app was deployed via dataJAR, then these will be completed for you. Closing the window will save changes to this area

The second option is to change the password you set when you first launched the app. Enter the new password twice and click "Change Passcode" to set the new password.

Computer Inventory List

The first option is your computer inventory. Here you can see the complete list of computers enrolled into your management server.

The search bar at the top will allow you to search for known devices. 

Refresh Inventory List

To refresh the list, click the refresh icon (the circular arrow). While the app is fetching the list of computers, the inventory list will clear before becoming re-populated. This is normal.

View Group Members 

To view groups of computer devices, click the group icon and select a desired group. The chosen group will be highlighted with a green circle.

This will automatically refresh the list of devices shown in the Inventory window. 

To return to the "All Computer Devices" view, click the group icon and select the default group again.

Perform Actions on Computers

To perform an action on a computer, select the desired computer/s in the Inventory window, and click the cog icon. (Note: You can select multiple computers by holding down the ⌃ (shift) or ⌘ (command) keys whilst clicking).

Available actions include:

• Blank Push - Send a blank push to test Apple Push Notifications
• Flush Failed Commands - Flush out any failed management commands
• Update Inventory - Request the device to collect and send a report of its configuration to datajar.mobi
• Change Role - This will allow you to change the role the computer has been assigned to. You will be presented with a list of all the roles available, you can then simply select the new role and the computers will be immediately re-assigned.
• Export Summary - Produces a csv file of the selected computers containing the below items. This will be saved to your desktop:
  • Computer Name
  • Serial Number
  • MAC Address
  • Model
  • The User Assigned
  • Last Inventory Date  

Computer Detail View

If you select any computer under the Inventory window, you will be presented with a more detailed view for that computer under the "Computer Summary" window.

Here you get a bit more detail for that specific computer including:

• Name of computer
• Serial number
• Model
• When the computer last checked in
• When the inventory was last updated
• Its current assigned role

At the top of the Computer Summary window, you'll find the same 'Action' items as mentioned above, as well as a refresh option. These will only apply to the selected computer.

Submit a Support Request and Export Details

Within the detailed computer view is a share button. This will allow you to log a support request with the support team, directly from within the app. Once clicked, you'll be asked for a contact name, contact email address and a brief summary of you issue or request. Once filled in, click "Submit" to log a support request and the team will be in touch.

There is also an option to export the details as described above.

Additional Options

Further down, you'll find options to change the Role, Asset Number and to un-manage the device.

Please Note: If you un-manage a device it will no longer have any restrictions, configurations or patching applied. To re-manage a device, please contact our support team.

Mobile Inventory List

The next option is your Mobile inventory. Here you can see the complete list of mobile devices enrolled into your management server. 

Like the Computer inventory list, you can search via the search bar, as well as refresh the view with the refresh button.

Perform Actions on Mobile devices

As with computers, select the desired mobile device/s in the Inventory window, and click the cog icon to perform actions. (Note: You can select multiple devices by holding down the ⌃ (shift) or ⌘ (command) keys whilst clicking).

Available actions include:

• Blank Push - Send a blank push to test Apple Push Notifications
• Clear Passcode - Removes any set passcode on the device
• Enable / Disable Bluetooth - Enables / Disables Bluetooth on the device
• Enable / Disable Lost Mode - You can put a batch of devices into Lost Mode. The app will ask you for the message you wish to display on the lock screen. To revoke Lost Mode, or to find the device’s location, tap on a single device to go to its detailed screen. There you will have options to disable Lost Mode as well as update any location information.
• Flush Failed Commands - Flush out any failed management commands
• Lock Devices - Locks the device, requiring the passcode (if set) to be used to unlock it
• Update Inventory - Here you can force the devices to refresh their inventory. After the inventory update, anything not installed or missing will auto-install on those devices.
• Update Role - This will allow you to change the role the device has been assigned to. You will be presented with a list of all the roles available, you can then simply select the new role and the devices will be immediately re-assigned.
• Export Summary - Produces a csv file of the selected mobile devices containing the below items. This will be saved to your desktop:
  • Mobile device Name
  • Serial Number
  • Model
  • The User Assigned
  • Supervision state

Mobile Detail View

If you select any Mobile device under the Inventory window, you will be presented with a more detailed view for that device under the "Device Summary" window.

Here you get a bit more detail for that specific computer including:

• Name of the device
• Serial number
• Model
• Last enrolment date
• Its current assigned role

At the top of the device Summary window, you'll find the same 'Action' items as mentioned above, as well as a refresh option. This will give you the same options as the previous screen plus a few additional items:

• If the device is in Lost Mode, you will get the option to Disable Lost Mode.
• If the device is in Lost Mode, you will have the option to get the device’s current location and also show a map of where that location is.

Submit a Support Request and Export Details

Within the detailed mobile device view is a share button. This will allow you to log a support request with the support team, directly from within the app. Once clicked, you'll be asked for a contact name, contact email address and a brief summary of you issue or request. Once filled in, click "Submit" to log a support request and the team will be in touch.

There is also an option to export the details as described above.

Additional Options

Further down, you'll find options to change the Role, Asset Number and to un-manage the device.

Please Note: If you un-manage a device it will no longer have any restrictions, configurations or patching applied. To re-manage a device, please contact our support team.

Computer Groups

The next option is Computer Groups, providing a details of which devices are members of which computer groups. Click on a group to see its members.

Mobile Groups

The next option is Mobile Groups, providing a details of which devices are members of which mobile device groups. Click on a group to see its members.

Summary

The final section gives you a summary of how many devices and which types you have enrolled in your management server.

 

Management for iOS

The Management app is an iOS app that runs on iPhone/iPod or iPad. It allows your administrators access to the inventory of your enrolled Apple devices, as well as access to some commonly used management commands.

Requirements

The following are the requirements to be able to use the Management app:

• You must be a datajar.mobi customer
• Your iPhone/iPod or iPad must be running iOS 11+
• You will need a web API key which will be provided by the support team at dataJAR.

Installing the App

The easiest way to deploy the app is via the Volume Purchase Program (VPP). The app is free of charge, so purchase enough copies for your requirements.

The URL to the app in iTunes is: https://itunes.apple.com/gb/app/datajar-management/id1363593133?mt=8

Once you have purchased the Management app, let our support team at dataJAR know and they can deploy it for you, along with your unique web API key.

Using the App

When you first launch the app, you will be asked to set a four-digit pin code for security purposes.

After setting this, and on subsequent launches, you will be asked to enter the four-digit pin code. On devices with biometric sensors, you can use Touch-ID or Face-ID to authenticate.

Once you have authenticated, the app comprises four main screens.

Settings

The first screen is your settings screen.

Here you can enter the URL for your management server and API key. If the app was deployed via VPP, then these will be completed for you.

The second option is to change the four-digit pin code you set when you first launched the app.

The final option is for customers with large Apple estates. By default, the app tries to pre-fetch all the details it needs in one go. For customers with many hundreds of devices, this can cause a delay before you get them all listed. By turning this off, the app will fetch the data on demand.

Computer Inventory List

The next screen is your computer inventory. Here you can see the complete list of computers enrolled into your management server.

If you partially pull the list down, a search bar will be revealed to allow you to search for known devices.

To refresh the list, pull the table down as far it will go. While the app is fetching the list of computers, you will see a spinning cog.

At the top right of the screen is the 'edit' button. This allows you to perform a number of tasks on a batch of computers.

When you press edit, a toolbar will appear at the bottom of the screen. This will make the batch management tasks you can perform available. The list of computers will also now allow you to select which of them you wish to work on.

The options in the toolbar will only become available once you have selected one or more computers.

The options available are:

• Update role: This will allow you to change the role the computer has been assigned to. You will be presented with a list of all the roles available, you can then simply select the new role and the computers will be immediately re-assigned.
• Mobile Device Management (MDM): This will allow you to perform the following tasks:
• Send a blank push to test Apple Push Notifications
• Flush out any failed management commands

Just tap cancel to come out of this mode.

Computer Detail View

If you tap any computer, you will be presented with a more detailed view for that computer.

Here you get a bit more detail for that specific computer including:

• Name of computer
• Serial number
• Model
• When the computer last checked in
• When the inventory was last updated
• Its current assigned role

If you tap the role, you will be presented with an option to change the computer's role. Select the new role and tap the 'save' button.

At the top there is an MDM button which gives you the same options as before, except these are only applied to the selected computer.

Mobile Inventory List

The next screen is your mobile inventory where you can see a complete list of iOS devices enrolled in your management server. Like the computer’s inventory, you can search and pull to refresh.

Select 'edit' to get access to the bulk management commands for mobile devices. Here you have more options available than those in the computer section.

These include:

• Update Role: Here you can change the role for the selected mobile devices
• Update Inventory: Here you can force the devices to refresh their inventory. After the inventory update, anything not installed or missing will auto-install on those devices.
• Clear Passcode: You can clear the passcode set on the selected devices
• Flush Failed Commands: This will remove any failed commands
• Lost Mode: You can put a batch of devices into Lost Mode. The app will ask you for the message you wish to display on the lock screen. To revoke Lost Mode, or to find the device’s location, tap on a single device to go to its detailed screen. There you will have options to disable Lost Mode as well as update any location information.
• Black Push: Send a blank push to test Apple Push Notifications

Mobile Detail View

Like the computer section, if you tap an individual mobile device, you will be presented with its detail view.

Again, you get extra information here for the selected mobile device including:

• Name of the device
• Its serial number
• Its model
• Last inventory update
• Its current role. Again if you tap the role, you will be given the option to change it.

At the top there is an MDM button.

This will give you the same options as the previous screen plus a few additional items:

• If the device is in Lost Mode, you will get the option to Disable Lost Mode.
• If the device is in Lost Mode, you will have the option to get the device’s current location and also show a map of where that location is.

Summary

The final screen gives you a summary of how many devices and which types you have enrolled in your management server.

If you require further assistance or support, please contact our support team.