Configure the device to accept location messages from external sources

You can configure the TX54-PR device to accept NMEA and TAIP messages from external sources. For example, location-enabled devices connected to the TX54-PR device can forward their location information to the device, and then the TX54-PR device can serve as a central repository for this location information and forward it to a remote host. See Forward location information to a remote host for information about configuring the TX54-PR device to forward location messages.

This procedure configures a UDP port on the TX54-PR device that will be used to listen for incoming messages.

Required configuration items

To configure the device to accept location messages from external sources:

  1. Log into Digi Remote Manager, or log into the local Web UI as a user with full Admin access rights.
  2. Access the device configuration:

    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.

    1. On the menu, click System. Under Configuration, click Device Configuration.

      The Configuration window is displayed.

  3. Click Services > Location > Location sources.
  4. Click to add a location source.
  5. (Optional) Type a Label for this location source.
  6. For Type of location source, select Server.
  7. For Location server port, type the number of the UDP port that will receive incoming location messages.
    • To limit access to specified IPv4 addresses and networks:
      1. Click IPv4 Addresses.
      2. For Add Address, click .
      3. For Address, enter the IPv4 address or network that can access the device's location server UDP port. Allowed values are:
        • A single IP address or host name.
        • A network designation in CIDR notation, for example, 192.168.1.0/24.
        • any: No limit to IPv4 addresses that can access the location server UDP port.
      4. Click again to list additional IP addresses or networks.
    • To limit access to specified IPv6 addresses and networks:
      1. Click IPv6 Addresses.
      2. For Add Address, click .
      3. For Address, enter the IPv6 address or network that can access the device's location server UDP port. Allowed values are:
        • A single IP address or host name.
        • A network designation in CIDR notation, for example, 2001:db8::/48.
        • any: No limit to IPv6 addresses that can access the location server UDP port.
      4. Click again to list additional IP addresses or networks.
    • To limit access to hosts connected through a specified interface on the TX54-PR device:
      1. Click Interfaces.
      2. For Add Interface, click .
      3. For Interface, select the appropriate interface from the dropdown.
      4. Click again to allow access through additional interfaces.
    • To limit access based on firewall zones:
      1. Click Zones.
      2. For Add Zone, click .
      3. For Zone, select the appropriate firewall zone from the dropdown.

        See Firewall configuration for information about firewall zones.

      4. Click again to allow access through additional firewall zones.
  9. Click Apply to save the configuration and apply the change.
  1. Select the device in Remote Manager and click Actions > Open Console, or log into the TX54-PR 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.

  2. At the command line, type config to enter configuration mode:
    > config
(config)>
  3. Add a location source:
    4. (config)> add service location source end
(config service location source 2)>

  4. (Optional) Set a label for this location source:

    (config service location source 2)> label "label"
(config service location source 2)>

  5. Set the type of location source to server:

    (config service location source 2)> type server 
(config service location source 2)>

  6. Set the UDP port that will receive incoming location messages. 
    7. (config service location source 2)> server port port
(config service location source 2)>
    • To limit access to specified IPv4 addresses and networks:
      (config)> add service location source 2 acl address end value
(config)>

      Where value can be:

      • A single IP address or host name.
      • A network designation in CIDR notation, for example, 192.168.1.0/24.
      • any: No limit to IPv4 addresses that can access the location server UDP port.

      Repeat this step to list additional IP addresses or networks.

    • To limit access to specified IPv6 addresses and networks:
      (config)> add service location source 2 acl address6 end value
(config)>

      Where value can be:

      • A single IP address or host name.
      • A network designation in CIDR notation, for example, 2001:db8::/48.
      • any: No limit to IPv6 addresses that can access the location server UDP port.

      Repeat this step to list additional IP addresses or networks.

    • To limit access to hosts connected through a specified interface on the TX54-PR device:
      (config)> add service location source 2 acl interface end value
(config)>

      Where value is an interface defined on your device.

      Use ... network interface ? to display interface information:

      (config)> ... network interface ?

Interfaces

Additional Configuration
-------------------------------------------
 defaultip              Default IP  
 defaultlinklocal       Default Link-local IP
 lan1                   LAN1
 loopback               Loopback 
 wan1                   WAN1 
 wwan1                  WWAN1
 wwan2                  WWAN2

(config)>

      Repeat this step to list additional interfaces.

    • To limit access based on firewall zones:
      (config)> add service location source 2 acl zone end value
(config)>

      Where value is a firewall zone defined on your device, or the any keyword.

      Type ... firewall zone ? at the config prompt:

      (config)> ... firewall zone ?

Zones: A list of groups of network interfaces that can be referred to by packet
filtering rules and access control lists.

 Additional Configuration
 -------------------------------------------------------------------------------
  any
  dynamic_routes
  edge
  external
  hotspot
  internal
  ipsec
  loopback
  setup

(config)>

      Repeat this step to include additional firewall zones.

  9. Save the configuration and apply the change
    (config)> save
Configuration saved.
>
  10. 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.