Testing Your APN database submission

Updated: August 27, 2013

Applies To: Windows 8, Windows 8.1

Before submitting an APN update request to Microsoft, it is important for the MNO or MVNO to validate the APN entries that they are about to submit. Microsoft does not have access to your network, so it is your responsibility to ensure the values that are being submitted are valid and work correctly.

There are two ways that you can ensure that the APN entries work before submitting them to Microsoft:

Editing APN values for the current profile

A simple way to test that an APN can connect to your network is to edit the current profile and insert the APN to test into the profile. To perform this test, follow these steps:

noteNote
This test does not simulate the full experience, which is described in the Modify the local APN database section.

  1. Insert a SIM into the PC that works with the APN value you want to test.

  2. Turn on the PC, log on to Windows, and open Windows Connection Manager. The mobile broadband connection should appear.

  3. Right-click the mobile broadband connection, and then select View connection properties.

  4. Enter the APN value to test into this dialog box.

  5. Save your changes, and then try to connect to the mobile broadband network.

Modify the local APN database

Before you submit an APN update, you should editing the local APN database or creating a new one for testing. By doing this, you closely simulate the full experience because the APN selection logic that Windows Connection Manager uses is fully tested.

Modify the local APN connectivity database

  1. Copy any existing values from the local APN database file -- View the existing entries in the local APN database on your PC and copy these entries into a new XML file. If you don’t have any APN entries in the local copy of the APN database, skip this step and start with a blank XML file.

  2. Modify values in the XML file according to the published APN schema – Ensure that your APN entries follow the APN database schema reference.

  3. Generate your hardware IDs – Hardware IDs specify one or more hardware identification strings that match the SIM characteristics to an APN entry in the database. Each string is specified by a HardwareId element. We recommend that you use mbidgenerator.exe to generate your hardware IDs. For more information, see Using mbidgenerator.exe to generate hardware IDs.

  4. Validate that the file you generated conforms to the published APN database schema -- Always perform a schema check to ensure that the file you have generated conforms to the APN database schema reference.

  5. Overwrite the APN connectivity database on the PC with your new database

    1. From an elevated command prompt, type cd %systemroot%\system32 and then press ENTER.

    2. Type takeown /f .\ApnDatabase.xml and then press ENTER.

    3. Type cacls .\ApnDatabase.xml /G %username%:F and then press ENTER.

    4. Copy your customized version of the ApnDatabase.xml file to the directory.

  6. Validate that the APN entries exist in the local APN database:

    1. Ensure that there are no existing mobile broadband profiles by running the following command: netsh mb show profiles

    2. If a mobile broadband profile exists, type netsh mb profile interface=<Interface name> name=<Profile name>

    3. Ensure that the device doesn’t have a provisioned context by running the following command: netsh mb show provisionedcontext interface=<Interface name>

      noteNote
      If the device provides a provisioned context, Windows will use the APN from that provisioned context instead of the local APN database and you will not able to test your APNs. If the device has a provisioned context, you need to acquire another device that doesn’t provide a provisioned context.

    4. Open Windows Connection Manager. It will show the Wi-Fi and mobile broadband networks that are within range.

    5. Select the Mobile Network, and then click Connect.

    6. If you have multiple APNs that match the SIM properties, Windows Connection Manager will try each of the matching APNs until a successful connection takes place. If none of the APNs connect, Windows Connection Manager will either show an error or show a custom APN entry screen, allowing the user to enter a custom APN.

      noteNote
      The auto-connect order that you specify in the APN database is used to determine the order in which APNs are tried.

    7. If you have only one APN in the APN database, Windows will automatically connect to the operator network.

      noteNote
      You can see which APN was applied to the connection profile by opening Windows Connection Manager, right-clicking the Mobile Broadband entry for your network, and then clicking Properties.

Show:
© 2014 Microsoft