Ascend Tunnel Management Protocol
This chapter contains the following sections:
Introduction to ATMP
The MAX TNT supports Ascend Tunnel Management Protocol (ATMP) for Virtual Private Network (VPN) connectivity. A VPN provides low-cost remote access to private LANs across the Internet.
Figure 7-1. ATMP tunnel from an ISP to a corporate Home Network
Network settings for ATMP
This section describes settings related to the IP connection between Ascend units, settings related to the UDP communication required to establish tunnels, and settings related to packet fragmentation and reassembly. System reset requirement
When you change the setting of the UDP-Port parameter in the ATMP profile of a Home Agent, a system reset is required for the ATMP subsystem to recognize the new UDP port number. System IP address recommendation
Ascend recommends that you set the System-IP-Addr parameter in a MAX TNT that is operating as an ATMP agent, particularly if the unit has multiple interfaces into the IP cloud that separates it from other ATMP agents. There are two aspects to this recommendation:
Figure 7-2. System IP addresses and routes between ATMP agents
IP-GLOBAL
system-ip-addr = 10.100.100.100
IP-INTERFACE { {shelf-1 slot-1 1} 0 }
ip-address = 2.2.2.1/24
rip = both-v2
IP-INTERFACE { {shelf-1 slot-1 2} 0 }The Home Agent has the following system IP address and interface IP configuration for an Ethernet card installed in shelf-1, slot-7:
ip-address = 3.3.3.1/24
rip = both-v2
IP-GLOBAL
system-ip-addr = 10.100.100.101
IP-INTERFACE { {shelf-1 slot-7 1} 0 }
ip-address = 2.2.2.2/24
rip = both-v2
IP-INTERFACE { {shelf-1 slot-7 2} 0 }With this configuration, the Foreign Agent advertises a route on both of its Ethernet ports to its own system address, 10.100.100.100. Similarly, the Home Agent advertises a route on both of its Ethernet ports to its own system address, 10.100.100.101.
ip-address = 3.3.3.2/24
rip = both-v2
When the Home Agent receives the advertisements for 10.100.100.100, it selects one of the ports advertising the route and adds that route to its routing table. The next time the Home Agent establishes a connection with the Foreign Agent, it uses the port indicated in the routing table. If that port becomes unavailable (for example, if the cable is disconnected), the Home Agent soon updates its routing table to use the other port to connect to the Foreign Agent.
Specifying tunnel retry limits
The Retry-Timeout and Retry-Limit parameters in the ATMP profile work together to limit how many tunnel RegisterRequest messages (to open a tunnel) and DeregisterRequest messages (to close a tunnel) are sent and the number of seconds between each message. If a tunnel request fails, the Foreign Agent times out, logs a message, and disconnects the Mobile Client. If a tunnel request succeeds, the Home Agent assigns a tunnel ID and then the UDP port is no longer used for that tunnel. Data is transferred across the IP connection, using the GRE protocol. Setting an MTU limit
The Maximum Transmission Unit (MTU) of a link between a Foreign Agent and Home Agent is determined by the type of connection. The link may be a dial-up connection, a Frame Relay connection, or an Ethernet link, and it may be a local network or routed through multiple hops. If the link between devices is multi-hop (if it traverses more than one network segment), the path MTU is the minimum of the intervening segments.
Figure 7-3. Path MTU on an Ethernet segment
How link compression affects the MTU
Compression affects which packets must be fragmented, because compressed packets are shorter than their original counterparts. If any kind of compression is on (such as VJ header or link compression), the connection can transfer larger packets due to link Maximum Receive Unit (MRU) requirements. If compressing a packet makes it smaller than the MRU, it may be sent across the connection whereas the same packet without compression would not. How ATMP tunneling causes fragmentation
To transmit packets through an ATMP tunnel, the MAX TNT adds an 8-byte GRE header and a 20-byte IP header to the frames it receives. This can make the packet size larger than the MTU of the tunneled link, in which case the MAX TNT must either fragment the packet after encapsulating it, or reject the packet. Pushing the fragmentation task to connection end-points
To avoid having ATMP agents fragment packets, you can either set up a link between the two units that has an MTU greater than 1528 (which means it cannot include Ethernet segments), or you can set the MTU-Limit parameter in the ATMP profile to a value that is 28 bytes less than the path MTU.
admin> read atmp
ATMP read
admin> set mtu-limit = 1472
admin> writeWith this setting, the connection end-point sends packets with a maximum size of 1472 bytes. When the MAX TNT encapsulates them, adding 28 bytes to the size, the packets still do not violate the 1500-byte Ethernet MTU.
ATMP written
However, some outdated client software does not handle this process correctly and continues to send packets that are larger than the specified MTU-Limit. To enable the MAX TNT to interoperate with these clients, you can set the Force-Fragmentation parameter in the ATMP profile to Yes. The MTU-Limit parameter must also be set to a non-zero value for Force-Fragmentation to work.
When the MTU-Limit parameter is set to a non-zero value, you can set the Force-Fragmentation parameter to Yes to enable the MAX TNT to prefragment packets it receives that are larger than the negotiated MRU with the DF bit set. That is, when these two parameters are set, the MAX TNT ignores the DF bit and performs the fragmentation that normally should be performed by the client. It prefragments those packets, and then adds the GRE and IP headers.
Configuring ATMP Foreign Agents
To configure an ATMP Foreign Agent, you must set parameters in the ATMP profile, verify that the Foreign Agent can communicate across an IP link with the Home Agent, and configure Mobile-Client Connection profiles. Configuring the Foreign Agent ATMP profile
The ATMP profile contains the following parameters related to a Foreign Agent configuration, which are shown with sample values:
ATMP
agent-mode = foreign-agent
retry-timeout = 3
retry-limit = 10
mtu-limit = 0
force-fragmentation = no
admin> read atmp
ATMP read
admin> set agent-mode = foreign-agent
admin> write
ATMP written
If you see the following message when you read the ATMP profile:
admin> read ATMPcreate the profile by using this command:
error: specified profile not found
admin> new ATMP
ATMP read
CONNECTION station
tunnel-options
profile-type = mobile-client
primary-home-agent = 10.11.22.33:8877
secondary-home-agent = 10.100.100.101:1555
udp-port = 5150
home-agent-password = ha-password
home-network-name = ""
The Primary-Home-Agent and Secondary-Home-Agent parameters should specify the Home Agents' System-IP-Addr rather than the address of the interface on which the Home Agents receive tunneled data (see System IP address recommendation). If you specify a hostname instead, the Foreign Agent uses DNS to obtain the IP address before locating the Connection profile.
admin> set primary-home-agent = 10.11.22.33:8877
admin> set secondary-home-agent = 11.56.12.128:4000In this case, the Foreign Agent brings up the connection to the Primary-Home-Agent and requests a tunnel on port 8877. If that attempt fails, it brings up the connection to the Secondary-Home-Agent and requests a tunnel on port 4000.
If the Primary-Home-Agent or Secondary-Home-Agent settings do not include a port number, the Foreign Agent uses the value of the UDP-Port parameter in the Mobile-Client Connection profile. For example, with the following settings:
admin> set primary-home-agent = 10.11.22.33
admin> set secondary-home-agent = ha2.company.com:6789
admin> set udp-port = 8877In this case, the Foreign Agent brings up the connection to the Primary-Home-Agent and requests a tunnel on port 8877. If that attempt fails, it brings up the connection to the Secondary-Home-Agent and requests a tunnel on port 6789.
admin> set home-network-name = atlanta
Example of a Foreign Agent with multiple Mobile Clients
Figure 7-4 shows a Foreign Agent that connects to two Home Agents across IP WAN connections. One is a Gateway Home Agent and the other is a Router Home Agent. The illustration also shows two Mobile-Client connections, one to each of the Home Agents.
In this example, the WAN connections are multi-channel PPP connections, which typically negotiate a path MTU of 1500 bytes. The agents set the MTU-Limit to 1472, to enable the connection end-points to fragment packets at that size. For background information, see Setting an MTU limit.
Figure 7-4. Foreign Agent tunneling to two Home Agents
Configuring the ATMP profile
The following set of commands configures a minimal ATMP profile:
admin> read atmp
ATMP read
admin> set agent-mode = foreign-agent
admin> set mtu-limit = 1472
admin> write
ATMP written
IP-GLOBALThe next set of commands configures a Connection profile to the Gateway Home Agent:
system-ip-addr = 10.1.2.3
admin> read conn hagateway
CONNECTION/hagateway read
admin> set active = yes
admin> set dial-number = 9-1-333-555-1212
admin> set ppp send-auth = chap-ppp-auth
admin> set ppp send-password = remotepw
admin> set ppp recv-password = localpw
admin> set ip-options remote = 10.1.2.3
admin> writeThe Router Home Agent has the following System-IP-Addr setting:
CONNECTION/hagateway written
IP-GLOBALThe following set of commands configures a Connection profile to the Router Home Agent:
system-ip-addr = 10.2.3.4
admin> read connection harouter
CONNECTION/harouter read
admin> set active = yes
admin> set dial-number = 9-1-888-555-1234
admin> set ppp send-auth = chap-ppp-auth
admin> set ppp send-password = remotepw
admin> set ppp recv-password = localpw
admin> set ip-options remote = 10.2.3.4
admin> write
CONNECTION/harouter written
ATMPThe next commands configure a Mobile-Client connection on the Foreign Agent to the Gateway Home Agent:
agent-mode = home-agent
agent-type = gateway-home-agent
udp-port = 1555
home-agent-password = ha-password
admin> read connection mobile-client-1
CONNECTION/mobile-client-1 read
admin> set tunnel profile-type = mobile-client
admin> set tunnel primary-home-agent = 10.1.2.3:1555
admin> set tunnel home-agent-password = ha-password
admin> set tunnel home-network-name = home-router
admin> write
CONNECTION/mobile-client-1 written
ATMPThe next commands configure a Mobile-Client connection on the Foreign Agent to the Router Home Agent:
agent-mode = home-agent
agent-type = router-home-agent
udp-port = 8877
home-agent-password = rtr-password
admin> read connection mobile-client-2
CONNECTION/mobile-client-2 read
admin> set tunnel profile-type = mobile-client
admin> set tunnel primary-home-agent = 10.2.3.4:8877
admin> set home-agent-password = rtr-password
admin> write
CONNECTION/HA-router written
Figure 7-5 shows a Foreign Agent tunneling to a GRF Home Agent across a 100-BaseT Ethernet segment:
Figure 7-5. Foreign Agent tunneling to a GRF switch
admin> read atmp
ATMP read
admin> set agent-mode = foreign-agent
admin> set mtu-limit = 1472
admin> write
ATMP written
Configuring ATMP Home Agents
To configure an ATMP Home Agent, you must set parameters in the ATMP profile, verify that the Home Agent can communicate across an IP link with the Foreign Agent, and configure the connection to the Home Network. Configuring the Home Agent ATMP profile
The ATMP profile contains the following parameters related to a Home Agent, which are shown with sample values:
ATMP
agent-mode = home-agent
agent-type = gateway-home-agent
udp-port = 5150
home-agent-password = my-password
retry-timeout = 3
retry-limit = 10
idle-timer = 30
mtu-limit = 0
force-fragmentation = no
Figure 7-6. How a Gateway Home Agent works
admin> read atmp
ATMP read
admin> set agent-mode = home-agent
admin> set agent-type = gateway-home-agent
admin> writeA Router Home Agent relies on packet routing to reach the Home Network.
ATMP written
Figure 7-7. How a Router Home Agent works
admin> read atmp
ATMP read
admin> set agent-mode = home-agent
admin> set agent-type = router-home-agent
admin> write
ATMP written
If you see the following message when you read the ATMP profile:
admin> read ATMPcreate the profile by using this command:
error: specified profile not found
admin> new ATMP
ATMP read
If the password sent by the Foreign Agent matches this value, the Home Agent returns a RegisterReply with a number that identifies the tunnel, and the Mobile Client's tunnel is established. If it does not match, the Home Agent rejects the tunnel, and the Foreign Agent logs a message and disconnects the Mobile Client.
ATMPThe inactivity timer runs only on the Home Agent side. Its value specifies the number of minutes-from 0 to 65535- that the Home Agent maintains an idle tunnel before disconnecting it. A value of 0 disables the timer, which means that idle tunnels remain connected forever. The setting affects only tunnels created after the timer was set. Tunnels that existed before setting the timer are not affected by it.
idle-timer = 0
The gateway connection to the Home Router can be a nailed connection, or a regular dial-in switched connection. Using an incoming connection from the Home Router enables the administrator of the Home Network to regulate when Mobile-Clients can access that network. For example, the administrator of the Home Network could configure an access router to dial the Home Agent every weekday at 8:00 AM and disconnect at 5:00 PM, limiting Mobile-Client access to those hours. In that case, the gateway connection must be up before Mobile Clients dial in, or their tunnel requests will fail.
To configure a Gateway-Profile, you set up a regular nailed or dial-in connection to the Home Network and specify the following parameters (which are shown with sample settings) in the Tunnel-Options subprofile of the Connection profile:
CONNECTION station
tunnel-options
profile-type = gateway-profile
max-tunnels = 0
For example, if you know that the traffic generated by each Mobile-Client connection will be low, a gateway connection may handle more tunnels than if each Mobile Client will generate a lot of traffic.
Figure 7-8. Gateway Home Agent with leased line to Home Network
Home Router requirements
If the MAX TNT is configured as a Gateway Home Agent, the router at the far end of the Gateway-Profile must be configured with static routes to the Mobile Clients. This is required.
IP-ROUTE mobile-clientOr, if the Mobile Clients have addresses allocated from the same address block (including router Mobile Client addresses with subnet masks less than 32) and no addresses from that block are assigned to other hosts, the Home Network administrator can specify a single static route that encompass all Mobile Clients that use the same Home Agent. For example, in the following route all Mobile Clients are allocated addresses from the 10.4.n.n block (and no other hosts are allocated addresses from that block), and the Home Agent address is 10.1.2.3:
destination = 10.4.5.27/22
gateway = 10.1.2.3
IP-ROUTE mobile-clients
destination = 10.4.0.0/16
gateway = 10.1.2.3
Setting the system IP address
The following set of commands sets the Home Agent's system IP address:
admin> read ip-global
IP-GLOBAL read
admin> set system-ip-addr = 10.1.2.3
admin> write
IP-GLOBAL written
admin> read atmp
ATMP read
admin> set agent-mode = home-agent
admin> set udp-port = 1234
admin> set home-agent-password = my-password
admin> set idle-timer = 30
admin> set mtu-limit = 1472
admin> writeThe Foreign Agent has an ATMP profile such as this:
ATMP written
ATMP
agent-mode = foreign-agent
agent-type = gateway-home-agent
udp-port = 5150
home-agent-password = ""
retry-timeout = 3
retry-limit = 10
idle-timer = 0
mtu-limit = 1472
force-fragmentation = no
admin> new connection home-router
CONNECTION/home-router read
admin> set active = yes
admin> set tunnel profile-type = gateway-profile
admin> set tunnel max-tunnels = 120
admin> set telco call-type = ft1
admin> set telco nailed-groups = 7
admin> write
CONNECTION/home-router written
CONNECTION mobile-client
tunnel-options
profile-type = mobile-client
primary-home-agent = 10.1.2.3:1234
home-agent-password = my-password
home-network-name = home-router
Figure 7-9. Router Home Agent with multichannel PPP link to Home Network
Setting the system IP address
The following set of commands sets the Router Home Agent's system IP address:
admin> read ip-global
IP-GLOBAL read
admin> set system-ip-addr = 10.1.2.3
admin> write
IP-GLOBAL written
If you enable RIP on the IP interface that leads to the Home Network, other hosts and networks can route to the Mobile Client. Enabling RIP is particularly useful if the Home Network is one or more hops away. If RIP is turned off, intervening routers require static routes that specify the Home Agent as the route to Mobile Clients.
You can also allow hosts on a local interface to ARP for the Mobile Client by turning on proxy ARP. In the following example, the Home Network is an Ethernet segment connected to the Router Home Agent via an Ethernet card in shelf-1, slot-10, port-1:
admin> read ip-interface {{1 10 1}0}
IP-INTERFACE/{ { 1 10 1 } 0 } read
admin> set ip-address = 10.56.1.1/24
admin> set proxy-mode = always
admin> set rip-mode = routing-send-and-recv-v2
admin> write
IP-INTERFACE/{ { 1 10 1 } 0 }written
admin> read atmp
ATMP read
admin> set agent-mode = home-agent
admin> set agent-type = router
admin> set home-agent-password = my-password
admin> set idle-timer = 30
admin> set mtu-limit = 1472
admin> writeThe Foreign Agent has an ATMP profile such as this:
ATMP written
ATMP
agent-mode = foreign-agent
agent-type = gateway-home-agent
udp-port = 5150
home-agent-password = ""
retry-timeout = 3
retry-limit = 10
idle-timer = 0
mtu-limit = 1472
force-fragmentation = no
CONNECTION/mobile-client
tunnel-options
profile-type = mobile-client
primary-home-agent = 10.1.2.3
home-agent-password = my-password
admin> new connection atmpfa
CONNECTION/atmpfa read
admin> set active = yes
admin> set ppp send-auth = chap-ppp-auth
admin> set ppp send-password = remotepw
admin> set ppp recv-password = localpw
admin> set ip-options remote-address = 10.4.5.6
admin> write
CONNECTION/atmpfa written
Configuring an ATMP Home-and-Foreign-Agent
In some configurations, the MAX TNT acts as a Home Agent for some Mobile-Clients and as a Foreign Agent for others. The two configurations operate side-by-side without any conflict, provided that all requirements are met for each type of configuration. Configuring the ATMP profile
The ATMP profile contains the following parameters related to the Home-and-Foreign-Agent configuration, which are shown with sample values:
ATMPThe Agent-Mode parameter must specify Home-and-Foreign-Agent. For details about all of the other settings, see Configuring ATMP Home Agents or Configuring ATMP Foreign Agents.
agent-mode = home-and-foreign-agent
agent-type = gateway-home-agent
udp-port = 5150
home-agent-password = my-password
retry-timeout = 3
retry-limit = 10
idle-timer = 0
mtu-limit = 1472
force-fragmentation = no
Example of a Home-and-Foreign-Agent configuration
Figure 7-10 shows a MAX TNT operating as Home Agent for Home Network B and as Foreign Agent for Mobile Clients tunneling into Home Network A:
Figure 7-10. MAX TNT acting as both Home Agent and Foreign Agent
Setting the system IP address
The following set of commands sets the unit's system IP address:
admin> read ip-global
IP-GLOBAL read
admin> set system-ip-addr = 10.100.100.100
admin> write
IP-GLOBAL written
admin> read atmp
ATMP read
admin> set agent-mode = home-and-foreign-agent
admin> set agent-type = gateway-home-agent
admin> set home-agent-password = my-password
admin> set udp-port = 1567
admin> set idle-timer = 30
admin> set mtu-limit = 1472
admin> writeThe Foreign Agent for Network B has an ATMP profile such as this:
ATMP written
ATMPThe Home Agent for Network A has an ATMP profile such as this:
agent-mode = foreign-agent
agent-type = gateway-home-agent
udp-port = 5150
home-agent-password = ""
retry-timeout = 3
retry-limit = 10
idle-timer = 0
mtu-limit = 1472
force-fragmentation = no
ATMP
agent-mode = home-agent
agent-type = router-home-agent
udp-port = 8877
home-agent-password = rtr-password
retry-timeout = 3
retry-limit = 10
idle-timer = 0
mtu-limit = 1472
force-fragmentation = no
admin> read connection mobile-client-A
CONNECTION/mobile-client-A read
admin> set tunnel profile-type = mobile-client
admin> set tunnel primary-home-agent = 10.22.33.44:8877
admin> set tunnel home-agent-password = rtr-password
admin> write
CONNECTION/mobile-client-A written
Figure 7-11. Enabling a Mobile-Client to bypass the Foreign Agent connection
Setting the system IP address
The following set of commands sets the unit's system IP address:
admin> read ip-global
IP-GLOBAL read
admin> set system-ip-addr = 10.100.100.100
admin> write
IP-GLOBAL written
admin> read atmp
ATMP read
admin> set agent-mode = home-and-foreign-agent
admin> set agent-type = gateway-home-agent
admin> set home-agent-password = hn-password
admin> set udp-port = 6789
admin> set idle-timer = 30
admin> set mtu-limit = 1472
admin> writeTNT-1 has an ATMP profile such as this:
ATMP written
ATMP
agent-mode = foreign-agent
agent-type = gateway-home-agent
udp-port = 5150
home-agent-password = ""
retry-timeout = 3
retry-limit = 10
idle-timer = 0
mtu-limit = 1472
force-fragmentation = no
admin> read connection mobile-client-3
CONNECTION/mobile-client-3 read
admin> set tunnel profile-type = mobile-client
admin> set tunnel primary-home-agent = 10.100.100.100:6789
admin> set tunnel home-agent-password = hn-password
admin> write
CONNECTION/mobile-client-3 written
Copyright © 1998, Ascend Communications, Inc. All rights reserved.