Once you extract the OS upgrade files from the APF file, create an OS Upgrade file/action.

If you must update the device registry, create a separate files/actions for the Registry Edit file and list that Files/Action first in the product manifest.

To create a product for OS Upgrade:

  1. Navigate to Devices > Staging & Provisioning > Components > Files/Actions and select the Add Files/Actions button.
  2. Select the Windows Rugged platform.
  3. Complete the General text boxes.
  4. Select the Files tab and select Add Files.
  5. Select Choose Files and upload the extracted OS update files.
  6. Specify the Download Path as:

    \[directory]\[full file name]
  7. Enable Relay Server Only to ensure that the files are all successfully downloaded and processed on the device. Large image files that are part of the OS Update remain on the Relay Server until needed by the OSUpdate utility.
  8. Select Add to add additional files.
  9. Upload the OS Update Utility EXE and the "package.TXT" manifest file.

    Windows Mobile devices always use a file named "osupdMagneto.exe." For Windows CE devices, the filename varies with the device.

    Windows CE devices also require a package .APD. The contents of this file are not important and can be a simple text format file containing something benign. It can even be empty.

  10. Specify the separate Download Paths for both the OS Update Utility and the package .TXT manifest file.

    The Download Path for the OS Update utility and the package.TXT manifest file must be: "\Windows\".

    The Windows CE .APD file must be placed in: "\Application\AirBeam\PKG."

    Important:

    Do not select Relay Server Only. These files need to be delivered directly to the device.

  11. (Optional) Create a files/actions to download and install the REG file to the device.

    This step is only necessary if the registry settings are not already correctly updated on the device.

    Download the REG file to the '\Temp' directory specifying the full filename. On the manifest tab, add an Install action type and specify the directory location and the filename of the REG file to be run on the device.

  12. Once all the files have been uploaded, select the Manifest tab and select Add Action to add Install Actions.
  13. Select the Run action in the Action Types text box.
  14. Copy the Install Command from the MSP Package Builder utility and paste it into the Command Line and Arguments to Run.

    For more information, see Run Command Argument Information.

    You must edit the syntax of the Install Command to match Workspace ONE ™ UEM run syntax:

    • Windows Mobile
      • You must use double quotes around "\windows\osupdMagento" and add the .exe to the end of osupdMagento.
      • -d"myserverpath" must be updated in the following format: "[path of your relay server]/PFILES/[file action name]_version/". So if the directory on the relay server that you are using for OS Update is /Motorola/OSUpdateFiles, the name of the OS Update file/action is "OSUpdate" and the "OSUpdate" file/action is on version 5, then the -d argument might look like: -d"/Motorola/OSUpdateFiles/PFILES/OSUpdate_5/".
        • The full run command syntax with all the arguments looks similar to this:

          "\windows\osupdMagneto.exe" -p"MC9190WM65" -o -y5 -z10 -q"\temp\" -d"/Motorola/OSUpdateFiles/PFILES/OSUpdate_5/"

    • Windows CE
      • You must use double quotes around "\windows\ [OS Update Utility filename]" and add the .exe to the end of the filename.
      • -d"myserverpath" must be updated in the following format: "[path of your relay server]/PFILES/[file action name]_version/". So if the directory on the relay server that you are using for OS Update is /Motorola/OSUpdateFiles, the name of the OS Update file/action is "OSUpdate" and the "OSUpdate" file/action is on version 5, then the -d argument might look like: -d"/Motorola/OSUpdateFiles/PFILES/OSUpdate_5/".
        • The full run command syntax with all the arguments looks similar to this:

          "\windows\[OS Update filename].exe" -p"WT41N0" -o -y5 -z10 -d"/Motorola/OSUpdateFiles/PFILES/OSUpdate_5/"

  15. Select Save.
  16. Add the OS Upgrade file/action to a product and assign the product to all applicable devices.

Once the device receives the product, the OS Update process initiates. A notification screen displays when the upgrade is complete.