Citrix SD-WAN

Configure LTE functionality on 210 SE LTE appliance

You can connect a Citrix SD-WAN 210-SE LTE appliance to your network using an LTE connection. This topic provides details on configuring mobile broadband settings, configuring the data center and branch appliances for LTE and so on. For more information on the Citrix SD-WAN 210-SE LTE hardware platform, see Citrix SD-WAN 210 Standard Edition Appliances.

Note

The LTE connectivity depends on the SIM carrier or service provider network.

Getting started with Citrix SD-WAN 210-SE LTE

  1. Insert the SIM card into the SIM card slot of the Citrix SD-WAN 210-SE LTE.

    Note: Only a standard or 2FF SIM card (15x25 mm) is supported.

  2. Fix the antennas to the Citrix SD-WAN 210-SE LTE appliance. For more information, see Installing the LTE antennas.
  3. Power on the appliance.

    Note

    If you have inserted the SIM into an appliance that is already powered ON and booted up, navigate to Configuration > Appliance Settings > Network Adapters > Mobile Broadband > SIM Card and click Refresh SIM Card.

    SIM card

  4. Configure the APN settings. In the SD-WAN GUI navigate to Configuration > Appliance Settings > Network Adapters > Mobile Broadband > APN settings.

    Note: Obtain the APN information from the carrier.

    APN settings

  5. Enter the APN, Username, Password and Authentication provided by the carrier. You can choose from PAP, CHAP, PAPCHAP authentication protocols. If the carrier has not provided any authentication type, set it to None.
  6. Click Change APN Settings.

  7. In the SD-WAN appliance GUI, navigate to Configuration > Appliance Settings > Network Adapters > Mobile Broadband.

    You can view the Mobile broadband settings status information.

    Status information

The following are some useful status information:

  • Operating Mode: Displays the modem state.
  • Active SIM: At any given time, only one SIM can be active. Displayed the SIM that is currently active.
  • Card State: Present indicates that SIM is properly inserted.
  • Signal strength: Quality of signal strength - excellent, good, fair, poor, or no signal.
  • Home network: Carrier of the inserted SIM.
  • APN name: The access point name used by the LTE modem.
  • Session state: Connected indicates that the device has joined the network. If the session state is disconnected, check with the carrier whether the account has been activated of if the data plan is enabled.

Useful status information

SIM PIN

If you have inserted a SIM card that is locked with a PIN, the SIM status is Enabled and Not Verified** state. You cannot use the SIM card until it is verified using the SIM PIN. You can obtain the SIM PIN from the carrier.

To perform SIM PIN operations, navigate to Configuration > Appliance Settings > Network Adapters > Mobile Broadband > SIM PIN.

SIM PIN

Click Verify PIN. Enter the SIM PIN provided by the carrier and click Verify PIN.

Verify PIN

The status changes to Enabled and Verified.

Enable and verify PIN

Disable SIM PIN

You can choose to disable SIM PIN functionality for a SIM for which SIM PIN is enabled and verified.

Disable PIN

Disable SIM PIN

Click Disable PIN. Enter the SIM PIN and click Disable.

Enable SIM PIN

SIM PIN can be enabled for the SIM for which it is disabled.

Enable PIN

Click Enable PIN. Enter the SIM PIN provided by the carrier and click Enable.

PIN enabled

If the SIM PIN state changes to Enabled and Not Verified, it means that the PIN is not verified and you cannot perform any LTE related operations until the PIN is verified.

SIM PIN status

Click Verify PIN. Enter the SIM PIN provided by the carrier and click Verify PIN.

Verify PIN

Modify SIM PIN

Once the PIN is in Enabled and Verified state you can choose to change the PIN.

Modify SIM PIN

Click Modify PIN. Enter the SIM PIN provided by the carrier. Enter the new SIM PIN and confirm it. Click Modify PIN.

Modified PIN

Unblock SIM

If you forget the SIM PIN, you can reset the SIM PIN using the SIM PUK obtained from the carrier.

SIM card blocked

To unblock a SIM, click Unblock. Enter the SIM PIN and SIM PUK obtained from the carrier and click Unblock.

SIM card unblocked

Note: The SIM card gets permanently blocked with 10 unsuccessful attempts of PUK, while unblocking the SIM. Contact the carrier service provider for a new SIM card.

SIM card permanently blocked

Manage Firmware

Every appliance that has LTE enabled will have a set of available firmware. You can select from the existing list of firmware or upload a firmware and apply it.

If you are unsure of which firmware to use, select the AUTO-SIM option to allow the LTE modem to choose the most matching firmware based on the inserted SIM card.

Manage firmware

Network Settings

You can select the mobile network on Citrix SD-WAN appliances that support internal LTE modems. The supported networks are 3G, 4G, or both.

Network settings

Roaming

The roaming option is enabled by default on your LTE appliances, you can choose to disable it.

Roaming

Enable/Disable modem

Enable/disable the modem depending on your intent to use the LTE functionality. By default, the LTE modem is enabled.

Reboot modem

Reboots the modem. It can take up to 3-5 minutes for the reboot operation to complete.

Refresh SIM

Use this option when you hot swap the SIM card to detect the new SIM card by the 210-SE LTE modem.

Refresh SIM

You can remotely view and manage all the LTE sites in your network using Citrix SD-WAN Center. For more information see, Remote LTE site management.

Configure the LTE functionality using CLI

To configure the 210-SE LTE modem using the CLI.

  1. Log into the Citrix SD-WAN appliance console.
  2. At the prompt, type the user name and password to gain CLI interface access.
  3. At the prompt, type the command lte. Type >help. This displays the list of LTE commands available for configuration.

210 SE LTE CLI

The following table lists the LTE command descriptions.

Command Description
Help {lte>help} Lists the available LTE commands and parameters
Status {lte>status} Displays LTE connectivity status
Show {lte>show} Displays LTE settings
Disable {lte>disable} Disables LTE modem
Enable {lte>enable} Enables LTE modem
Apn {lte>apn} Configures APN settings information
Sim-power off, on, reset>{lte>sim-power off,on,reset} Powers off SIM card, Power on SIM card, Refresh SIM card
SIM PIN {lte>sim-pin} Powers off SIM card, Power on SIM card, Refresh SIM card
Reboot {lte>reboot} Restarts LTE modem
Ping {lte>ping} Pings LTE modem
List-fw {lte>list-fw} Lists firmware available on the R1 or R2 LTE modems
Apply-fw {lte>apply-fw} Applies firmware specific to a carrier

Configure MCN for LTE

You cannot configure a 210-LTE appliance as an MCN. However, for an MCN to work with an LTE branch appliance perform the following configurations on the MCN appliance.

To configure an MCN:

  1. Log in to the SD-WAN appliance GUI. Go to Configuration Editor. Complete configuration for the MCN site, see Configure MCN.

  2. Ensure that you provide a routable public IP address as part of the WAN link configuration. You do not have to configure a public IP address for client appliances.

    Configure MCN for LTE

Configure branch for LTE

To configure the 210-SE LTE appliance as a branch site:

  1. In the SD-WAN appliance GUI, go to the configuration editor. See Configure Branch.
    • Create Interface Groups.
    • Create up to one Virtual Interface and one Interface Group for the LTE adapter to configure the WAN link by selecting the following:
      • Ethernet Interface – LTE 1
      • Security – untrusted (default)
      • DHCP Client – Enabled (default)

    Virtual interface

  2. Enable AutoDetect Public IP for WAN link configuration when configuring WAN link using the virtual interface created for the LTE interface.

    Auto detect public IP

  3. By default, when you try to configure the WAN link using the LTE interface, the WAN link is marked as Metered link and Last Resort Standby mode. You can change these default settings, if necessary.

    Metered link standby mode

    The IP address and gateway address for the Access Interface of the WAN link need not be configured because it receives that information from the carrier through DHCP.

    Access interface

  4. Complete the rest of the required Branch configuration for the 210-SE LTE appliance. See configure Branch.

  5. Perform Change Management by uploading the SD-WAN software. See the Change Management procedure.

  6. Activate configuration through the Local Change Management process. When you perform Change Management, the configuration is activated and the required configuration is applied.

Zero-touch deployment over LTE

Pre-requisites for enabling zero-touch deployment service over LTE

  1. Install the antenna and the SIM card for the 210-SE LTE appliance.
  2. Ensure that the SIM card has an activated data plan.
  3. Ensure that the management port is not connected.
    • If the management port is connected, disconnect the management port and then restart the appliance.
    • If a static IP address on the Management Interface is configured, you need to configure the Management Interface with DHCP, apply the configuration, and then disconnect the Management port, and restart the appliance.
  4. Ensure that the 210-SE appliance configuration has the internet service defined for the LTE interface.

When the appliance is powered on, the zero-touch deployment service uses the LTE port to obtain the latest SD-WAN software and SD-WAN configuration only when the management port has not been connected.

You can use the SD-WAN Center GUI to deploy and configure the 210-SE LTE appliance for the zero-touch deployment service.

See the zero-touch deployment procedure for more information about deploying and configuring the 210-SE LTE appliance using SD-WAN Center.

Zero-touch deployment Service over management interface for 210-SE LTE appliance

Connect the Management Port and use the standard zero-touch deployment procedure that is supported on all other non-LTE platforms.

LTE REST API

For information about the LTE REST API, navigate to the SD-WAN GUI and go to Configuration > Appliance Settings >NITRO API. Click Download Nitro API Doc. The REST API for SIM PIN functionality is introduced in Citrix SD-WAN 11.0.

Download NITRO API

AT commands

AT commands help in monitoring and troubleshooting LTE modem configuration and status. AT is the abbreviation for ATtension. As every command line starts with at, they are called AT commands. Citrix SD-WAN platform models that support LTE support running AT commands. AT commands are modem specific and therefore the list of AT commands varies across the platforms.

To run AT commands, perform the following steps:

  1. Log into the Citrix SD-WAN appliance console.
  2. At the prompt, type the user name and password to gain CLI interface access.
  3. At the prompt, type lte.
  4. Enter at and then enter the AT command.

The following is an example:

  • at at+cpin – Provides SIM status information.

    LTE AT SIM status command

  • at at!gstatus - Provides LTE modem status information.

    LTE AT status command

  • at at!impref? - Provides modem firmware and network carrier information.

    LTE AT firmware information command

Configure LTE functionality on 210 SE LTE appliance