
Ascend Tunnel Management Protocol
The MAX TNT supports Ascend Tunnel Management Protocol (ATMP) for Virtual Private Network (VPN) connectivity. For information about using other tunneling protocols for VPN connectivity, see Chapter 7, L2TP, PPTP, and IP-in-IP Tunneling.
Introduction to ATMP
ATMP is a UDP/IP-based protocol for tunneling between two Ascend units across an IP network. Data is transported through the tunnel in Generic Routing Encapsulation (GRE), as described in RFC 1701. (For a complete description of ATMP, see RFC 2107, K. Hamzeh, Ascend Tunnel Management Protocol - ATMP.)
Figure 6-1. ATMP tunnel from an ISP to a corporate home network
Network settings for ATMP
Network settings for ATMP include 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. This recommendation has two aspects:
Figure 6-2. System IP addresses and routes between ATMP agents
[in IP-GLOBAL]
system-ip-addr = 10.100.100.100
[in IP-INTERFACE { {shelf-1 slot-1 1} 0 } ]
ip-address = 2.2.2.1/24
rip = both-v2
[in IP-INTERFACE { {shelf-1 slot-1 2} 0 } ]
ip-address = 3.3.3.1/24
rip = both-v2
and a Home Agent has the following system IP address and IP interface configuration:
[in IP-GLOBAL]
system-ip-addr = 10.100.100.101
[in IP-INTERFACE { {shelf-1 slot-7 1} 0 } ]
ip-address = 2.2.2.2/24
rip = both-v2
[in IP-INTERFACE { {shelf-1 slot-7 2} 0 } ]
ip-address = 3.3.3.2/24
rip = both-v2
With this configuration, the Foreign Agent advertises on both of its Ethernet ports a route to its own system address, 10.100.100.100. Similarly, the Home Agent advertises on both of its Ethernet ports a route to its own system address, 10.100.100.101.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. When a tunnel request succeeds, the Home Agent assigns a tunnel ID and the UDP port is no longer used for that tunnel. The actual data transfer uses the IP connection with GRE. Setting an MTU limit
The type of link that connects a Foreign Agent and Home Agent determines the Maximum Transmission Unit (MTU). The link may be a switched dial-out 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 multihop (if it traverses more than one network segment), the path MTU is the minimum MTU of the intervening segments.
Figure 6-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 without exceeding a link's Maximum Receive Unit (MRU). If compressing a packet makes it smaller than the MRU, it can be sent across the connection, whereas the same packet without compression could 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. The addition of these packet headers can make the packet 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 the extra overhead incurred when ATMP agents perform fragmentation, 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 configure the MAX TNT to ignore the DF bit and perform the fragmentation that normally should be performed by the client software. This function in the MAX TNT is sometimes referred to as prefragmentation.
When the MTU-Limit parameter is set to a nonzero 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. It prefragments those packets, and then adds the GRE and IP headers.
Network isolation and duplicate IP addresses
A Foreign Agent will accept multiple ATMP connections using the same IP address as long as they request a different Home Agent or different home network names. This feature allows the use of unregistered IP addresses on multiple independent private networks.
Table 6-1. Foreign Agent supporting duplicate IP addresses
Configuring the agent-to-agent connection
The link between a Foreign Agent and Home Agent can be any kind of connection (switched, nailed, Frame Relay, and so forth) or an Ethernet link. It may be a local network or routed through multiple hops. The only requirement is that the two units can communicate over an IP network.
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 = 1.1.1.1
admin> writeFor details about IP connections, see Chapter 4, IP Routing.
CONNECTION/atmpfa written
Configuring a Foreign Agent
To configure a Foreign Agent, you must set parameters in the ATMP profile, configure a Connection or RADIUS profile to the Home Agent, and configure mobile client Connection or RADIUS profiles.
Foreign Agent ATMP profile settings
The ATMP profile contains the following parameters (shown with sample values) related to a Foreign Agent configuration:
[in ATMP]
agent-mode = foreign-agent
retry-timeout = 3
retry-limit = 10
mtu-limit = 0
force-fragmentation = no
[in CONNECTION/mclient-1:tunnel-options]
profile-type = mobile-client
primary-tunnel-server = 2.2.2.2:8877
secondary-tunnel-server = 3.3.3.3:1555
udp-port = 5150
password = tunnel-password
home-network-name = ""
user1 Password = "pass1"
User-Service = Framed-User,
Framed-Protocol = PPP,
Framed-Address = 10.1.1.1,
Framed-Netmask = 255.255.255.255,
Tunnel-Type = ATMP,
Tunnel-Server-Endpoint = "atmp-ha1.example.com",
Tunnel-Password = "tunnel-password"
user1 Password = "pass1"
User-Service = Framed-User,
Framed-Protocol = PPP,
Framed-Address = 10.1.1.1,
Framed-Netmask = 255.255.255.255,
Tunneling-Protocol = ATMP
Ascend-Primary-Home-Agent = "atmp-ha1.example.com",
Ascend-Home-Agent-Password = "tunnel-password"
If the Foreign Agent does not receive a response to its request, it tries again. The number of retries is controlled by the Retry-Limit setting in the Foreign Agent's ATMP profile.
If the Foreign Agent still does not receive a response or if it receives a negative response (such as Home Network Unreachable), it attempts to repeat the procedure with the secondary Home Agent address. If there is no secondary Home Agent address specified or if the registration with the secondary Home Agent also fails, the mobile client is disconnected.
If the Home Agent ATMP profile specifies a UDP port number other than the default of 5150, you can specify that port number as part of the Home Agent address by appending a colon character (:) followed by the port number. The following commands specify the system IP address followed by a UDP port number for a primary and secondary Home Agent:
admin> read connection user1
CONNECTION/user1 read
admin> set ip-options remote-address = 10.1.1.1/32
admin> set tunnel profile-type = mobile-client
admin> set primary-tunnel-server = 2.2.2.2:8877
admin> set secondary-home-agent = 3.3.3.3:4000
admin> writeOr, in a RADIUS profile:
CONNECTION/user1 read
user1 Password = "pass1"In this case, the Foreign Agent dials the connection to the primary Home Agent and requests a tunnel on port 8877. If that attempt fails, it dials the connection to the secondary Home Agent and requests a tunnel on port 4000. (If the address does not specify 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:
User-Service = Framed-User,
Framed-Address = 10.1.1.1,
Framed-Netmask = 255.255.255.255,
Tunnel-Type = ATMP,
Tunnel-Server-Endpoint = "2.2.2.2:8877",
Ascend-Secondary-Home-Agent = "3.3.3.3",
Ascend-Home-Agent-UDP-Port = 4000
admin> set primary-tunnel-server = 2.2.2.2
admin> set secondary-tunnel-server = ha2.company.com:6789
admin> set udp-port = 8877the Foreign Agent dials the connection to the Primary-Tunnel-Server and requests a tunnel on port 8877. If that attempt fails, it dials the connection to the Secondary-Tunnel-Server and requests a tunnel on port 6789.
admin> new connection homenet
CONNECTION/homenet read
admin> set active = yes
admin> set tunnel profile-type = gateway-profile
admin> set telco call-type = ft1
admin> set telco nailed-groups = 7
admin> writeThe mobile client's profile would specify the following home network name:
CONNECTION/homenet written
admin> set home-network-name = homenetOr would include one of the following settings in a RADIUS profile:
Tunnel-Private-Group-ID = "homenet"
Ascend-Home-Network-Name = "homenet"
Example of a Foreign Agent configuration
Figure 6-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.
Figure 6-4. Foreign Agent tunneling to two Home Agents
Setting the Foreign Agent system address
The following commands set the Foreign Agent's system IP address:
admin> read ip-global
IP-GLOBAL read
admin> set system-ip-addr = 1.1.1.1
admin> write
IP-GLOBAL written
admin> read atmp
ATMP read
admin> set agent-mode = foreign-agent
admin> set mtu-limit = 1472
admin> write
ATMP written
admin> reset
Configuring a connection to the Gateway Home Agent
In this example, the Gateway Home Agent has the following System-IP-Addr setting:
[in IP-GLOBAL]The next commands configure a Connection profile to the Gateway Home Agent:
system-ip-addr = 2.2.2.2
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 ip-options remote = 2.2.2.2
admin> writeFollowing are comparable RADIUS profiles:
CONNECTION/hagateway written
route-tnt-1 Password = "ascend", User-Service = Dialout-Framed-User
Framed-Route = "2.0.0.0 2.2.2.2 1 n hagateway-out"
hagateway-out Password = "ascend", User-Service = Dialout-Framed-User
User-Name = "hagateway",
Framed-Protocol = MPP,
Ascend-Route-IP = Route-IP-Yes,
Framed-Address = 2.2.2.2,
Ascend-Dial-Number = "9-1-333-555-1212",
Ascend-Send-Auth = Send-Auth-CHAP,
Ascend-Send-Password = "remotepw"
[in IP-GLOBAL]The following commands configure a Connection profile to the Router Home Agent:
system-ip-addr = 3.3.3.3
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 ip-options remote = 3.3.3.3
admin> writeFollowing are comparable RADIUS profiles:
CONNECTION/harouter written
route-tnt-1 Password = "ascend", User-Service = Dialout-Framed-User
Framed-Route = "3.0.0.0 3.3.3.3 1 n harouter-out"
harouter-out Password = "ascend", User-Service = Dialout-Framed-User
User-Name = "harouter",
Framed-Protocol = MPP,
Ascend-Route-IP = Route-IP-Yes,
Framed-Address = 3.3.3.3,
Ascend-Dial-Number = "9-1-888-555-1234",
Ascend-Send-Auth = Send-Auth-CHAP,
Ascend-Send-Password = "remotepw"
[in ATMP]The 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
password = tunnel-password
admin> read connection mobile-client-1
CONNECTION/mobile-client-1 read
admin> set active = yes
admin> set ppp recv-password = my-password
admin> set ip-options remote-address= 10.1.1.1/29
admin> set tunnel profile-type = mobile-client
admin> set tunnel primary-tunnel-server = 2.2.2.2:1555
admin> set tunnel password = tunnel-password
admin> set tunnel home-network-name = home-router
admin> writeFollowing is a comparable RADIUS profile:
CONNECTION/mobile-client-1 written
mobile-client-1 Password = "my-password"
User-Service = Framed-User,
Framed-Protocol = MPP,
Ascend-IP-Route = Route-IP-Yes,
Framed-Address = 10.1.1.1,
Framed-Netmask = 255.255.255.248,
Tunnel-Type = ATMP,
Tunnel-Server-Endpoint = "2.2.2.2:1555",
Tunnel-Password = "tunnel-password"
Tunnel-Private-Group-ID = "home-router"
[in ATMP]The 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
password = tunnel-password
admin> read connection mobile-client-2
CONNECTION/mobile-client-2 read
admin> set active = yes
admin> set ppp recv-password = my-password
admin> set ip-options remote-address= 11.1.1.1/32
admin> set tunnel profile-type = mobile-client
admin> set tunnel primary-tunnel-server = 3.3.3.3:8877
admin> set tunnel password = tunnel-password
admin> writeFollowing is a comparable RADIUS profile:
CONNECTION/mobile-client-2 written
mobile-client-2 Password = "my-password", User-Service= Framed-User
Framed-Protocol = MPP,
Ascend-IP-Route = Route-IP-Yes,
Framed-Address = 11.1.1.1,
Framed-Netmask = 255.255.255.255,
Tunnel-Type = ATMP,
Tunnel-Server-Endpoint = "3.3.3.3:8877",
Tunnel-Password = "tunnel-password"
Figure 6-5 shows a Foreign Agent tunneling to a GRF Home Agent across a 100-BaseT Ethernet segment:
Figure 6-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 Home Agents
To configure an ATMP Home Agent, you must set parameters in the ATMP profile, configure an IP connection to the Foreign Agent, and configure the connection to the home network.
Home Agent ATMP profile settings
The ATMP profile contains the following parameters (shown with sample values) related to a Home Agent:
[in ATMP]
agent-mode = home-agent
agent-type = gateway-home-agent
udp-port = 5150
password = tunnel-password
retry-timeout = 3
retry-limit = 10
idle-timer = 30
mtu-limit = 0
force-fragmentation = no
Specifying a Gateway Home Agent
A Gateway Home Agent delivers tunneled data to the home network without routing. A Gateway Home Agent cannot Ping or otherwise communicate with the home router. (The same restriction applies in the other direction.)
Figure 6-6. How a Gateway Home Agent works
Following is an example of specifying a Gateway Home Agent:
admin> read atmp
ATMP read
admin> set agent-mode = home-agent
admin> set agent-type = gateway-home-agent
admin> write
ATMP written
admin> reset
Specifying a Router Home Agent
A Router Home Agent relies on packet routing to reach the home network.
Figure 6-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
admin> reset
Specifying the tunnel password
The Home Agent typically requests a password before establishing a tunnel. The Foreign Agent returns an encrypted version of the password found in the mobile client profile. For details, see Tunnel authentication.
Setting an idle timer for unused tunnels
When a mobile client disconnects normally, the Foreign Agent sends a request to the Home Agent to close down the tunnel. However, when a Foreign Agent restarts, tunnels that were established to a Home Agent are not normally cleared, because the Home Agent is not informed that the mobile clients are no longer connected. The unused tunnels continue to hold memory on the Home Agent. To enable the Home Agent to reclaim the memory held by unused tunnels, you can now set an inactivity timer on a Home Agent y changing the default value of the following parameter:
[in ATMP]The inactivity timer runs only on the Home Agent side. Its value specifies the number of minutes (1 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 the timer was set are not affected by it.
idle-timer = 0
The gateway connection to the home network 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 the 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, set up a nailed or dial-in connection and specify the following parameters (shown with sample settings) in the Connection profile:
[in CONNECTION/gwprofile]
station* = gwprofile
[in CONNECTION/gwprofile:tunnel-options]
profile-type = gateway-profile
max-tunnels = 0
atmp-ha-rip = rip-send-v2
The following commands enable ATMP-HA-RIP in the gateway profile to the home router:
admin> new connection home-router
CONNECTION/home-router read
admin> set tunnel profile-type = gateway-profile
admin> set tunnel atmp-ha-rip = rip-send-v2
admin> write
CONNECTION/home-router written
The alternative: Maintaining static routes in the home router
If the gateway profile does not set ATMP-HA-RIP to RIP-Send-v2, the administrator of the home network must configure a static route to each mobile client. A static route to a mobile client can be specific to the client, where the route's destination is the mobile client IP address and the next-hop router is the Home Agent address. For example, in the following route the mobile client is a router (this is not a host route), and the Home Agent address is 2.2.2.2:
[in IP-ROUTE/mobile-client]Or, if the mobile clients have addresses allocated from the same address block (including router mobile client addresses with subnet masks less than 32 bits) 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 2.2.2.2:
destination = 10.1.1.10/29
gateway = 2.2.2.2
[in IP-ROUTE/mobile-clients]
destination = 10.4.0.0/16
gateway = 2.2.2.2
Figure 6-8. Resilient ATMP installation
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 tunnel atmp-ha-rip = rip-send-v2
admin> write
CONNECTION/home-router written
Figure 6-9. Gateway Home Agent with leased line to home network
Setting the Home Agent's system address
The following commands set the Home Agent's system IP address:
admin> read ip-global
IP-GLOBAL read
admin> set system-ip-addr = 2.2.2.2
admin> write
IP-GLOBAL written
admin> read atmp
ATMP read
admin> set agent-mode = home-agent
admin> set udp-port = 1234
admin> set password = tunnel-password
admin> set idle-timer = 30
admin> set mtu-limit = 1472
admin> write
ATMP written
admin> reset
The Foreign Agent has an ATMP profile such as the following:
[in ATMP]
agent-mode = foreign-agent
agent-type = gateway-home-agent
udp-port = 5150
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 atmp-ha-rip = rip-send-v2
admin> set telco call-type = ft1
admin> set telco nailed-groups = 7
admin> write
CONNECTION/home-router written
[in CONNECTION/mclient:tunnel-options]Or comparable settings in a RADIUS profile:
profile-type = mobile-client
primary-tunnel-server = 2.2.2.2:1234
password = tunnel-password
home-network-name = home-router
mclient Password = "local-password"
User-Service = Framed-User,
Tunnel-Type = ATMP,
Tunnel-Server-Endpoint = "2.2.2.2:1234",
Tunnel-Password = "tunnel-password",
Tunnel-Private-Group-ID = "home-router"
Figure 6-10. Router Home Agent on the home network
Setting the Home Agent's system address
The following commands set the Router Home Agent's system IP address:
admin> read ip-global
IP-GLOBAL read
admin> set system-ip-addr = 3.3.3.3
admin> write
IP-GLOBAL written
admin> read ip-interface {{1 10 1}0}
IP-INTERFACE/{ { 1 10 1 } 0 } read
admin> set ip-address = 3.3.3.3
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 password = tunnel-password
admin> set idle-timer = 30
admin> set mtu-limit = 1472
admin> write
ATMP written
admin> reset
The Foreign Agent has an ATMP profile such as the following:
[in ATMP]
agent-mode = foreign-agent
agent-type = gateway-home-agent
udp-port = 5150
password = ""
retry-timeout = 3
retry-limit = 10
idle-timer = 0
mtu-limit = 1472
force-fragmentation = no
[in CONNECTION/mclient:tunnel-options]Or comparable tunnel settings in a RADIUS profile:
profile-type = mobile-client
primary-tunnel-server = 3.3.3.3
password = tunnel-password
mclient Password = "local-password"
User-Service = Framed-User,
Tunnel-Type = ATMP,
Tunnel-Server-Endpoint = "3.3.3.3",
Tunnel-Password = "tunnel-password"
Configuring a 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, shown with sample values:
[in ATMP]The Agent-Mode parameter must specify Home-and-Foreign-Agent. For details about all of the other settings, see Configuring Home Agents or Configuring a Foreign Agent.
agent-mode = home-and-foreign-agent
agent-type = gateway-home-agent
udp-port = 5150
password = tunnel-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 6-11 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 6-11. MAX TNT acting as both Home Agent and Foreign Agent
Setting the system address
The following commands set the Home-and-Foreign Agent'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 password = tunnel-password
admin> set udp-port = 1567
admin> set idle-timer = 30
admin> set mtu-limit = 1472
admin> write
ATMP written
admin> reset
The Foreign Agent for Network B has an ATMP profile such as the following:
[in ATMP]The Home Agent for Network A has an ATMP profile such as the following:
agent-mode = foreign-agent
agent-type = gateway-home-agent
udp-port = 5150
password = ""
retry-timeout = 3
retry-limit = 10
idle-timer = 0
mtu-limit = 1472
force-fragmentation = no
[in ATMP]
agent-mode = home-agent
agent-type = router-home-agent
udp-port = 8877
password = tunnel-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 active = yes
admin> set ip-options remote-address = 11.1.1.1/32
admin> set tunnel profile-type = mobile-client
admin> set tunnel primary-tunnel-server = 10.22.33.44:8877
admin> set tunnel password = tunnel-password
admin> writeFollowing is a comparable RADIUS profile:
CONNECTION/mobile-client-A written
mobile-client-A Password = "local-password"
User-Service = Framed-User,
Framed-Protocol = MPP,
Ascend-IP-Route = Route-IP-Yes,
Framed-Address = 11.1.1.1,
Framed-Netmask = 255.255.255.255,
Tunnel-Type = ATMP,
Tunnel-Server-Endpoint = "10.22.33.44",
Ascend-UDP-Port = 8877,
Tunnel-Password = "tunnel-password"
Figure 6-12. Enabling a mobile client to bypass the Foreign Agent connection
Setting the system IP address
The following commands set the Home-and-Foreign Agent'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 password = tunnel-password
admin> set udp-port = 6789
admin> set idle-timer = 30
admin> set mtu-limit = 1472
admin> write
ATMP written
admin> reset
TNT-1 has an ATMP profile such as the following:
[in ATMP]
agent-mode = foreign-agent
agent-type = gateway-home-agent
udp-port = 5150
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 active = yes
admin> set ip-options remote-address = 11.1.1.1/32
admin> set tunnel profile-type = mobile-client
admin> set tunnel primary-home-agent = 10.100.100.100:6789
admin> set tunnel password = tunnel-password
admin> writeFollowing is a comparable RADIUS profile:
CONNECTION/mobile-client-3 written
mobile-client-3 Password = "local-password"
User-Service = Framed-User,
Framed-Protocol = MPP,
Ascend-IP-Route = Route-IP-Yes,
Framed-Address = 11.1.1.1,
Framed-Netmask = 255.255.255.255,
Tunnel-Type = ATMP,
Tunnel-Server-Endpoint = "10.100.100.100:6789",
Tunnel-Password = "tunnel-password"
Configuring IPX over ATMP
IPX ATMP enables ATMP mobile clients to tunnel into an IPX home network. IPX packets are encapsulated (GRE) through the tunnel, so the connection between the Foreign Agent and Home Agent does not require IPX routing. However, IPX routing is required for the connection between the mobile client and the Foreign Agent, and for the connection between the Home Agent and the home network, as shown in Figure 6-13:
Figure 6-13. IPX routing connections for IPX ATMP
For information about configuring connections between Home Agents and Foreign Agents, see Configuring the agent-to-agent connection.
Configuring the agents for IPX routing
For details about configuring the MAX TNT to route IPX, see Chapter 8, IPX Routing. The next commands configure a minimal IPX configuration to enable the MAX TNT to route IPX packets:
admin> read ipx-global
IPX-GLOBAL read
admin> set ipx-routing-enabled = yes
admin> set ipx-dialin = cccc1234
admin> write
IPX-GLOBAL written
admin> read ipx-interface { { 1 c 1 } 0}
IPX-INTERFACE/{ { shelf-1 controller 0 } 0 } read
admin> set ipx-routing-enabled = yes
admin> set ipx-frame = 802.2
admin> set ipx-net-number = 23456789
admin> writeIn addition to routing IPX, the Foreign Agent should typically define a unique IPX network for use in assigning addresses to NetWare dial-in clients. For example:
IPX-INTERFACE/{ { shelf-1 controller 0 } 0 } written
admin> read ipx-global
IPX-GLOBAL read
admin> set ipx-dialin = cccc1234
admin> write
IPX-GLOBAL written
In this example, the mobile client is running Windows 98 with IPX enabled. The mobile client is assigned an address on the virtual IPX network defined in the Foreign Agent's IPX-Global profile (CCCC1234).

Figure 6-14. IPX ATMP with a Gateway Home Agent
Configuring a mobile client IPX connection
The next set commands configures a Connection profile for the mobile client in Figure 6-14:
admin> read connection mobile-client-1
CONNECTION/mobile-client-1 read
admin> set active = yes
admin> set ppp recv-password = mc-password
admin> set ipx ipx-routing-enabled = yes
admin> set ipx peer = dialin
admin> set tunnel profile-type = mobile-client
admin> set tunnel primary-tunnel-server = 2.2.2.2
admin> set tunnel password = tunnel-password
admin> set tunnel home-network-name = home-router
admin> writeFollowing is a comparable RADIUS profile:
CONNECTION/mobile-client-1 written
mobile-client-1 Password = "mc-password"
User-Service = Framed-User,
Framed-Protocol = PPP,
Ascend-Route-IPX = Route-IPX-Yes,
Ascend-IPX-Peer-Mode = IPX-Peer-Dialin,
Tunnel-Type = ATMP,
Tunnel-Server-Endpoint = "2.2.2.2",
Tunnel-Password = "tunnel-password"
Tunnel-Private-Group-ID = "home-router"
The Gateway Home Agent must be configured for IPX (see Configuring the agents for IPX routing).
admin> new connection home-router
CONNECTION/home-router read
admin> set active = yes
admin> set ppp send-auth = chap-ppp-auth
admin> set ppp send-password = atmp-hrouter
admin> set ppp recv-password = atmp-ha
admin> set ipx ipx-routing-enabled = yes
admin> set ipx peer = router
admin> set ipx rip = off
admin> set ipx sap = off
admin> set telco answer-originate = originate-only
admin> set telco ft1-caller = yes
admin> set telco call-type = ft1-mpp
admin> set telco nailed-groups = 1,2
admin> set tunnel profile-type = gateway-profile
admin> set tunnel max-tunnels = 120
admin> write
CONNECTION/home-router written
admin> get ether-info {1 c 1}
interface-address* = { shelf-1 controller 1 }
mac-address = 00:c0:7b:6b:9f:d6
link-state = unknown
media-speed-mbit = 10
In the sample static route that follows, the destination network number is CCCC1234 (the virtual network assigned to the client by the Foreign Agent), and the destination node number is the MAC-Address of the Home Agent's shelf-controller Ethernet port.The Connection # field specifies the number of the Pipeline unit's IPX-routing Connection profile to the Gateway Home Agent.
Ethernet
IPX Route
Mobile-Client-1
Server Name=
Active=Yes
Network=cccc1234
Node=0c07b6b9fd6
Socket=
Server Type=0
Hop Count=2
Tick Count=12
Connection #=1
In this example, the mobile client is running Windows 98 with IPX enabled. The mobile client is assigned an address on the virtual IPX network defined in the Foreign Agent's IPX-Global profile (CCCC1234).

Figure 6-15. IPX ATMP with a Router Home Agent
Configuring a mobile client IPX connection
The next set commands configures a Connection profile for the mobile client in Figure 6-15:
admin> read connection mobile-client-1
CONNECTION/mobile-client-1 read
admin> set active = yes
admin> set ppp recv-password = mc-password
admin> set ipx ipx-routing-enabled = yes
admin> set ipx peer = dialin
admin> set tunnel profile-type = mobile-client
admin> set tunnel primary-tunnel-server = 2.2.2.2
admin> set tunnel password = tunnel-password
admin> writeFollowing is a comparable RADIUS profile:
CONNECTION/mobile-client-1 written
mobile-client-1 Password = "mc-password"
User-Service = Framed-User,
Framed-Protocol = PPP,
Ascend-Route-IPX = Route-IPX-Yes,
Ascend-IPX-Peer-Mode = IPX-Peer-Dialin
Tunnel-Type = ATMP,
Tunnel-Server-Endpoint = "2.2.2.2",
Tunnel-Password = "tunnel-password"
admin> read ipx-global
IPX-GLOBAL read
admin> set ipx-routing-enabled = yes
admin> write
IPX-GLOBAL written
admin> read ipx-interface { { 1 c 1 } 0}
IPX-INTERFACE/{ { shelf-1 controller 0 } 0 } read
admin> set ipx-routing-enabled = yes
admin> set ipx-frame = 802.2
admin> set ipx-net-number = 12345678
admin> write
IPX-INTERFACE/{ { shelf-1 controller 0 } 0 } written
Copyright © 1999, Ascend Communications, Inc. All rights reserved.