Important:
This is retired content. This content is outdated and is no longer being maintained. It is provided as a courtesy for individuals who are still using these technologies. This content may contain URLs that were valid when originally published, but now link to sites or pages that no longer exist.
4/8/2010

To create a provisioning XML file that will provision the device with the root certificate you must complete the following steps:

Note:
Your provisioning XML must not contain Byte Order Markers (BOM). Use a text editor that does not insert BOMs when saving files in UTF-8 format.

To create a provisioning XML document

  1. Add the following XML code to a document:

    Copy Code 
    <wap-provisioningdoc> 
   <characteristic type="CertificateStore"> 
	 <characteristic type="
STORELOCATION"> 
	 <characteristic type="
CERTHASH"> 
		<parm name="EncodedCertificate" value="
BASE64ENCODEDCERT"/> 
	 </characteristic> 
	 </characteristic> 
   </characteristic> 
</wap-provisioningdoc>

  2. Replace STORELOCATIONwith ROOT.

  3. In Windows Explorer, double-click the exported root certificate.

  4. Choose the Detailstab.

  5. Choose Thumbprintin the list box, select the text, and then press CTRL+C.

  6. In the XML code, to add the root certificate thumbprint to the provisioning XML, replace CERTHASHwith the copied text.

  7. Delete the spaces in the thumbprint text.

  8. Open the exported root certificate using a text editor.

  9. Delete BEGIN CERTIFICATEand END CERTIFICATE, and then remove line breaks from the remaining text. This text is the encoded contents of the root certificate.

  10. Select the text, and then press CTRL+C.

  11. In the XML code, to add the root certificate to the provisioning XML, replace BASE64ENCODEDCERTwith the copied text. The completed provisioning XML document will appear as shown in the following example.

    Copy Code 
    <wap-provisioningdoc>
   <characteristic type="CertificateStore">
	<characteristic type="ROOT">
		 <characteristic type="{hash of certificate}"> 
			<parm name="EncodedCertificate" value="{encoded hash
of certificate}"/>
		 </characteristic>
	</characteristic> 
   </characteristic>
</wap-provisioningdoc>

    For information about the provisioning file syntax for different OMA Client Provisioning versions, see OMA Client Provisioning Files.

  12. Save the XML document as an ASCII file named _setup.xml.

See Also