Sending the Provisioning XML to a Device in a Cab File

Article
06/03/2010

6/2/2010

A cabinet file is a single file, usually with a .cab extension, that stores compressed files in a file library.

To send a provisioning XML file to a device in a .cab file, you will use the Makecab.exe tool to create a .cab file, and then use SignTool to sign the .cab file for delivery to the device. The following table shows where these tools are located.

Tool	Download Location
Makecab	Makecab.exe is included with the Microsoft Windows Operating System, and is available from the Command line.
SignTool	SignTool is included in the Windows Mobile 5.0 SDKs. There are two Windows Mobile 5.0 SDKs available: One for Windows Mobile 5.0 based Pocket PC devices One for Windows Mobile 5.0 based Smartphone devices. You can download these versions of the SDK from this Microsoft Web site. Use search to Locate "Install the Tools."

Makecab

Makecab.exe is included with the Microsoft Windows Operating System, and is available from the Command line.

SignTool

SignTool is included in the Windows Mobile 5.0 SDKs.

There are two Windows Mobile 5.0 SDKs available:

One for Windows Mobile 5.0 based Pocket PC devices
One for Windows Mobile 5.0 based Smartphone devices.

You can download these versions of the SDK from this Microsoft Web site. Use search to Locate "Install the Tools."

The following steps show how you will send the XML to the device in a cab file:

You will create an XML file to send in a .cab file, and name it <name>_setup.xml.
Package the _setup.xml file in a .cab file so that it can be installed on the device.
Sign the .cab file with a certificate that is in the Mobile Operator SPC certificate store on the device. You need to use a certificate in this store because it is the store that the loader checks.
Put the .cab file on the device.

Assumptions

The XML file must be UTF-8 encoded.

Step 1: Create an XML File to Send in a .cab File

To create an XML file to send in a .cab file

Copy the following information into a text editor:

<wap-provisioningdoc>
  <characteristic type="Sync">
    <characteristic type="Settings">
      <parm name="HeartbeatDefault " value="480"/>
      <parm name="HeartbeatIncrement" value="300"/>
      <parm name="HeartbeatMax" value="1680"/>
      <parm name="HeartbeatMin " value="480"/>
    </characteristic>
  </characteristic>
</wap-provisioningdoc>

Change the values to the appropriate setting. For more information, see Parameters Used for Dynamically Adjusting the Heartbeat Interval in Heartbeat Interval Adjustment.
Save the XML document as an ASCII file named <filename>_setup.xml, to a location on your desktop computer, such as c:\directpush.

Note

You must name the file _setup.xml, because that is the name that the loader will recognize.

As an example, you would name it directpush\_setup.xml.

You are now ready to package the XML in a cabinet (.cab) file.

Step 2: Package the XML in a .cab File

To Create a .cab File

Run the Makecab.exe utility, using the following syntax.
```
makecab _setup.xml <filename>.cab
```
For example, you would type the following:
```
makecab.exe directpush_setup.xml directpush.cab
```

Step 3: Sign the .cab File.

To Sign the .cab File

Sign your .cab file with the correct certificate. For example:

Signtool sign /f <your SPC store certificate>.pfx <cab name>.cab

For example, you would type the following:

Signtool sign /f <your SPC store certificate>.pfx directpush.cab

You are now ready to put the .cab file onto the device.

Step 4: Put the .cab File on the Device

The .cab file that contains the provisioning XML can be distributed to a Windows Mobile-based device that is cradled to a desktop PC, or to a variety of storage cards that can be inserted into the Windows Mobile-based device, such as a Multimedia Card (MMC), a Secure Digital I/O (SDIO) card, and a CompactFlash card. Typically, the XML file is installed upon delivery.

Note

If the ActiveSync wizard appears when you connect the device to a desktop computer, click Cancel. It is recommended that you use Windows Explorer and File Explorer to transfer the .cab file to the device.

To copy the .cab file from the desktop to the device by using File Explorer

Copy the .cab file to the device.
On the device, locate the .cab file by using File Explorer.
Click the .cab file icon to initiate the installation.
Notification of successful installation will appear. If you get a prompt, you must say yes to let the installation process execute.
Check the Root certificate store of the Windows Mobile-based device to verify successful installation.