Profiles can be applied to devices using two different methods, side loading or remote. Neither of these methods will erase currently installed applications, user information or login status. The initial profile will require the use of Side Loading to install the profile. After the first profile is loaded, all subsequent profile updates can be sent via either method. When a profile is installed, it will require the device to be rebooted for the profile to take effect.
The following pages will detail the two methods and how to apply the profiles to devices.
Before you begin, you will need the following items:
- A computer with an internet connection.
- A Magic Leap One device fresh from the factory or one that has been factory reset.
Note: Do not start the out of box setup of your device, just power it on. - A USB-C to USB connector.
- Download the desired profile and key from the Device Manager.
INSTALL METHODS: Side Loading and Remote DEPLOYMENT OF profiles
Side Loading
Applying a profile by side loading, means connecting the device to the administrator's computer using the USB-C connection. Once the device is hard-wired to the administrator's computer, the use of the (MLDB) tool found within the Magic Leap app, “The Lab” or downloadable via the Developer Portal is used to communicate with the device. This MLDB provides a few simple commands to apply profiles and keys, as well as view active profiles.
First time deployment of profiles must be done by side loading. Devices that are to be managed via the Device Manager, should be in a factory reset state. This means the device has either come directly from the factory and never used or that the device has been factory reset.
Profile Installation MLDB Commands (Side Load)
Install Key and Profile [Windows]
The example below shows how to set the decryption key for profile installation. Note, this command expects the contents of the to reside in the downloads folder of the currently logged in user of the computer.
c:\...> set /p key=<%HOMEPATH%\Downloads\key
c:\...> mldb provision set-key %key%
The example below shows how to set the profile using the MLDB command. Note, this command expects the path to the file itself, not the contents. Again, this example uses the full path and assumes the browser has downloaded the file to the Downloads folder of the current logged in user.
c:\...> mldb provision install %HOMEPATH%\Downloads\profile.zip
Profile installation successful. The profile will be active after reboot.
Install Key and Profile [Mac]
Below are examples of loading the key contents and profiles on either a Mac or Linux computer. Again, we use full paths and assume the browser downloads to the users Downloads folder.
$ mldb provision set-key $(cat ~/Downloads/key)
$ mldb provision install ~/Downloads/profile.zip
Profile installation successful. The profile will be active after reboot.
*TIP* If you need to verify the profile was installed successfully, run "mldb provision show current" and verify the profile on the output matches what you are trying to install.
Remote Profile Management from the Device Manager
Users of the Device Manager can apply profiles to select devices remotely by choosing the devices within the Device Manager and pushing the profile via WiFi. This method will require the device to be connected to the internet for proper deployment of the profile.
Note: Only devices provisioned and managed via the Device Manager can apply profiles remotely from the Device Manager.