Cellular modem APNs

The IX15 device uses a preconfigured list of Access Point Names (APNs) when attempting to connect to a cellular carrier for the first time. You can find the serviceproviders-local.txt and serviceproviders.txt files in the filesystem of the IX15. The order of the APNs for a specific carrier in these text files corresponds to the order in which the IX15 will try those APNs until it makes a successful connection. After the device has successfully connected, it will remember the correct APN. As a result, it is not necessary to configure APNs. However, you can configure the system to use a specified APN if you choose to do so.

Configure cellular modem APNs

To configure the APN:

Choose the management interface you want to use to access your device. Click a dropdown for instructions.
Digi Remote Manager
1. Log in to Digi Remote Manager.
1. Navigate to the device's dashboard.
Web UI
1. Log in to your device's Web UI.
Admin CLI

Log in to your device's Admin CLI via an SSH client, Telnet client, or terminal emulator.
Click to open the device's configuration menu.
- In Digi Remote Manager, on the device dashboard, click Settings.
- In the Web UI, click Device Configuration.
Configure the settings.
Menu instructions
1. For your single-cellular IX15, click Network > Interfaces > Modem > modem > APN Selection.
2. For APN Selection, choose the list you want your IX15 to use when connecting to a cellular carrier for the first time:
  - Digi controlled built-in list
  - Full built-in list
  - Custom APN list only
  - Both custom list and built-in list
  1. If you selected either the Custom APN list only or the Both custom list and built-in list, click  to add an APN.
    (Optional) For APN, add a name.
    (Optional) For IP version, select one of the following settings:
    Automatic: Requests both IPv4 and IPv6 address.
    IPv4: Requests only an IPv4 address.
    IPv6: Requests only an IPv6 address.
    The default is Automatic.
    (Optional) For Authentication method, select one of the following settings:
    None: No authentication is required.
    Automatic: The device will attempt to connect using CHAP first, and then PAP.
    CHAP: Uses the Challenge Handshake Authentication Profile (CHAP) to authenticate.
    PAP: Uses the Password Authentication Profile (PAP) to authenticate.
    If Automatic, CHAP, or PAP is selected, enter the Username and Password required to authenticate.
    The default is None.
    (Optional)For PDP context index, type the number for the index of the SIM card that the APN is programmed into. The default is 0 so the index is set automatically.
    Lightweight M2M support is enabled by default. Disable if you are using an AT&T SIM that does not support AT&T lightweight M2M.
    For Match SIM provider, select the carrier you want this APN to be used with to ensure that the proper APN is used with the desired carrier.
    Repeat these steps to add additional APNs, if needed.
3. Click Apply to save the configuration and apply the change.
CLI instructions
1. At the CLI prompt, type config and then press Enter.
2. At the config prompt, type:
```
(config)> network interface modem modem apn 0 apn value
(config)>
```
  where value is the APN for the SIM card.
3. (Optional) For APN Selection, choose the list you want your IX15 to use when connecting to a cellular carrier for the first time.
```
(config)> network interface modem modem apn_selection value
(config)>
```
  Where value is one of the following:
  - apn list only
  - both lists
  - built in list only
  - digi list only
  If you choose either the Custom APN list only or Both custom list and built-in list parameter, add APNs:
  1. Use the add command to add a new APN entry. For example:
    (config)> add network interface modem modem apn end (config network interface modem modem apn 1)>
  2. Set the value of the APN:
    (config network interface modem modem apn 1)> apn value (config network interface modem modem apn 1)>
    where value is the APN for the SIM card.
  3. (Optional) Set the IP version:
    (config)> network interface modem modem apn 0 ip_version version (config)>
    
    where version is one of the following:
    auto: Requests both IPv4 and IPv6 address.
    ipv4: Requests only an IPv4 address.
    ipv6: Requests only an IPv6 address.
    
    The default is auto.
  4. (Optional) Set the authentication method:
    (config)> network interface modem modem apn 0 auth method (config)>
    
    where method is one of the following:
    none: No authentication is required.
    auto: The device will attempt to connect using CHAP first, and then PAP.
    chap: Uses the Challenge Handshake Authentication Profile (CHAP) to authenticate.
    pap: Uses the Password Authentication Profile (PAP) to authenticate.
    If auto, chap, or pap is selected, enter the Username and Password required to authenticate:
    (config)> network interface modem modem apn 0 username name (config)> network interface modem modem apn 0 password pwd (config)>
    
    The default is none.
  5. (Optional) Set the PDP context index:
    (config network interface wwan1 modem apn 0) > cid value (config network interface wwan1 modem apn 0) >
    
    where value is the index number of the SIM that the APN is programmed into. 0 means the index will be automatically set.
  6. For Lightweight M2M support, disable if you are using an AT&T SIM that does not support AT&T lightweight M2M:
    (config)> network interface modem modem apn 0 attm2mglobal false (config)>
  7. For Match SIM provider, set the carrier you want this APN to be used with to ensure that the proper APN is used with the desired carrier.
    (config)> network interface wwan1 modem apn 0 match_carrier [value] (config)>
    
    where [value] is the carrier used for the APN you are creating (for example: AT&T, AT&T Firstnet, T-Mobile, Telestra).
4. Save the configuration and apply the change.
```
(config)> save
Configuration saved.
>
```
5. Type exit to exit the Admin CLI.
  Depending on your device configuration, you may be presented with an Access selection menu. Type quit to disconnect from the device.