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

If you need to 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 > Product > File/Actions > Add.
  2. Select the Windows Rugged platform.
  3. Complete the General fields.
  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 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 as well as the "package.TXT" manifest file.

    Windows Mobile devices always use a file named "osupdMagneto.exe." For Windows CE devices, the file name 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 completely 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 new 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 file name. On the manifest tab, add an Install action type and specify the directory location and the file name of the .reg file to be executed 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 field.
  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 AirWatch run syntax:

    • Windows Mobile
      • You must use double quotes around "\windows\osupdMagento" as well as add the .exe to the end of osupdMagento.
      • -d"myserverpath" will need to be updated as follows 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 would look like: -d"/Motorola/OSUpdateFiles/PFILES/OSUpdate_5/".
        • The full run command syntax with all the arguments will look 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 File Name]" as well as add the .exe to the end of the file name.
      • -d"myserverpath" will need to be updated as follows 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 would look like: -d"/Motorola/OSUpdateFiles/PFILES/OSUpdate_5/".
        • The full run command syntax with all the arguments will look similar to this:

          "\windows\[OS Update File Name].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.