Cellular modem APNs

The IX20 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 IX20. The order of the APNs for a specific carrier in these text files corresponds to the order in which the IX20 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:

 Web

Log into Digi Remote Manager, or log into the local Web UI as a user with full Admin access rights.
Access the device configuration:
Remote Manager:
1. Locate your device as described in Use Digi Remote Manager to view and manage your device.
2. Click the Device ID.
3. Click Settings.
4. Click to expand Config.
Local Web UI:
1. On the menu, click System. Under Configuration, click Device Configuration.
  The Configuration window is displayed.
Click Network > Interfaces > Modem > APN list > APN.
For APN, type the Access Point Name (APN) to be used when connecting to the cellular carrier.
(Optional) IP version:
For IP version, select one of the following:
- 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 PDP context index, type the number for the index of the SIM card that the APN is programmed into or type 0 to have the index set automatically.
(Optional) For Authentication method, select one of the following:
- 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.
Lightweight M2M support is enabled by default. Disable if you are using an AT&T SIM that does not support AT&T lightweight M2M.
(Optional) For APN selection, select whether you want to configure the device to use the preconfigured APNs, custom APNs, or both.
To add additional APNs, for Add APN, click  and repeat the preceding instructions.
Click Apply to save the configuration and apply the change.

 Command line

Select the device in Remote Manager and click Actions > Open Console, or log into the IX20 local command line as a user with full Admin access rights.
Depending on your device configuration, you may be presented with an Access selection menu. Type admin to access the Admin CLI.
At the command line, type config to enter configuration mode:
```
> config
(config)>
```

At the config prompt, type:

(config)> network interface modem modem apn 0 apn value
(config)>

where value is the APN for the SIM card.

(Optional) To add additional APNs:

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)>

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.

(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.
(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.
(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.
Disable Lightweight M2M support 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)>
```
(Optional) To configure the device to use either the preconfigured APNs, custom APNs, or both:
```
(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
Save the configuration and apply the change.
```
(config)> save
Configuration saved.
>
```
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.