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.

Procedure

  1. Navigate to Devices > Provisioning > Components > Files/Actions and select the Add Files/Actions button.
  2. Select the Windows Rugged platform.
  3. Complete the General text boxes.
    1. Enter a Name.
    2. Enter a Description.
    3. View the pre-populated Version number of the file-action.
    4. View and confirm the Platform for the file-action.
    5. Enter who the files-actions are Managed By.
  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\[directory]\[full file name]
  7. Enable Store OS Update Files on Relay Server to ensure that OS Update files remain on the Relay Server until needed by the OSUpdate utility.
  8. Select Save and add the file and return to the Files tab.
  9. Select Add Files and add additional files.
  10. 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.

  11. Specify 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 must be delivered directly to the device.
  12. (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.

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

    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/". 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 like the following.
          \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/". 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 like the following.
          \windows\[OS Update filename].exe" -p"WT41N0" -o -y5 -z10 -d"/Motorola/OSUpdateFiles/PFILES/OSUpdate_5/
  16. Select Save.
  17. Add the OS Upgrade file/action to a product and assign the product to all applicable devices.

Results

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