[Top][Contents][Prev][Next][Last]Search


Reference to RADIUS Attributes


This chapter discusses RADIUS attributes found in user profiles. Each listing provides information in this format:

Attribute Name

Description: The Description text explains the attribute.

Usage: The Usage text explains the values you can specify for the attribute.

Example: The Example text presents an example of how to use the attribute.

Dependencies: The Dependencies text tells you what other information you need in order to specify the proper value for the attribute.

See Also: The See Also text points you to related information.

Acct-Authentic (45)

Description: The Acct-Authentic attribute specifies the method the MAX used to authenticate a call, or indicates whether the MAX accepted the call without authentication.

The MAX sends Acct-Authentic in an Accounting-Request packet under these conditions:

Usage: Acct-Authentic does not appear in a user profile It can have either of the following values:

Acct-Delay-Time (41)

Description: The Acct-Delay-Time attribute specifies how many seconds the MAX has been trying to send this Accounting packet.

The MAX sends Acct-Delay-Time in an Accounting-Request packet under these conditions:

Usage: Acct-Delay-Time does not appear in a user profile. Its default value is 0 (zero).

Acct-Input-Octets (42)

Description: The Acct-Input-Octets attribute specifies how many octets the MAX has received during the session.

Usage: The MAX sends Acct-Input-Octets in an Accounting-Request packet at the end of a session (Acct-Status-Type=Stop) when both of these conditions are true:

Usage: Acct-Input-Octets does not appear in a user profile. Its default value is 0 (zero).

Acct-Input-packets (47)

Description: The Acct-Input-packets attribute specifies how many packets the MAX has received during the session. The MAX sends Acct-Input-packets in an Accounting-Request packet at the end of a session (Acct-Status-Type=Stop) when all of these conditions are true:

Usage: Acct-Input-packets does not appear in a user profile. Its default value is (zero).

Acct-Output-Octets (43)

Description: The Acct-Output-Octets attribute specifies how many octets the MAX has sent during the session.

The MAX sends Acct-Output-Octets in an Accounting-Request packet at the end of a session
(Acct-Status-Type=Stop) when both of these conditions are true:

Usage: Acct-Output-Octets does not appear in a user profile. Its default value is (zero).

Acct-Output-packets (48)

Description: The Acct-Output-packets attribute specifies how many packets the MAX has sent during the session. The MAX sends Acct-Output-packets in an Accounting-Request packet at the end of a session (Acct-Status-Type=Stop) when all of these conditions are true:

Usage: Acct-Output-packets does not appear in a user profile. Its default value is (zero).

Acct-Session-Id (44)

Description: The Acct-Session-Id attribute specifies a unique numeric string for the bridging, routing, or terminal server session specified in the Accounting-Request packet. The string is a random number containing up to seven digits. RADIUS correlates the Accounting Start packet and Accounting Stop packet using Acct-Session-Id.

The MAX sends Acct-Session-Id under these conditions:

Usage: Acct-Session-Id does not appear in a user profile. Its value can range from 1 to 2,137,383,647. For every session, RADIUS generates a unique session ID, thereby preventing the same session ID from applying to more than one session.

Dependencies: Keep this additional information in mind:

Acct-Session-Time (46)

Description: The Acct-Session-Time attribute specifies how many seconds the session has been online.

The MAX sends Acct-Session-Time in an Accounting-Request packet at the end of a session (Acct-Status-Type=Stop) when both of these conditions are true:

Usage: Acct-Session-Time does not appear in a user profile. Its default value is 0 (zero).

Acct-Status-Type (40)

Description: The Acct-Status-Type attribute specifies whether the Accounting packet the MAX sends to the RADIUS server is the beginning (Start) or end (Stop) of a bridging, routing, or terminal server session, or to indicate whether and when RADIUS accounting is enabled or disabled. The Accounting-Request packet contains these attributes and values:

The attribute has four possible values:

The MAX sends Acct-Status-Type under these conditions:

Usage: Acct-Status-Type does not appear in a user profile.

Ascend-Add-Seconds (240)

Description: The Ascend-Add-Seconds attribute specifies the number of seconds that average line utilization (ALU) for transmitted data must exceed the threshold indicated by the Ascend- Target-Util attribute before the MAX begins adding bandwidth to a session. The MAX determines the ALU for a session by using the algorithm specified by the Ascend-History- Weigh-Type attribute.

When utilization exceeds the threshold for a period of time greater than the value of the Ascend-Add-Seconds attribute, the MAX attempts to add the number of channels specified by the Ascend-Inc-Channel-Count attribute. Using the Ascend-Add-Seconds attribute prevents the system from continually adding bandwidth, and can slow down the process of allocating bandwidth.

Usage: Specify a number between 1 and 300. The default value is 5.

Dependencies: Keep this additional information in mind:

See Also: Ascend-Base-Channel-Count (172)
Ascend-DBA-Monitor (171)
Ascend-Dec-Channel-Count (237)
Ascend-History-Weigh-Type (239)
Ascend-Inc-Channel-Count (236)
Ascend-Maximum-Channels (235)
Ascend-Minimum-Channels (173)
Ascend-Remove-Seconds (241)
Ascend-Seconds-Of-History (238)
Ascend-Target-Util (234)

Ascend-Appletalk-Peer-Mode (117)

Description: Specifies whether the connection is for a single dial-in station or for a router.

Usage: Specify one of the following values:

Dependencies: Ascend-Route-Appletalk must be set to Ascend-Route-Appletalk-Yes.

Example: The following example shows a RADIUS user profile for a routed connection:

pipe50  Password="pipe50"
User-Service = Framed-User,
Framed-Protocol = PPP,
Ascend-Appletalk-Peer-Mode = Appletalk-Peer-Router,
Ascend-Route-Appletalk = Route-Appletalk-Yes,
Ascend-Idle-Limit = 0
The following is an example of a RADIUS user profile for a dial-in connection:

mac1    Password = "mac1"
User-Service = Framed-User,
Framed-Protocol = PPP,
Ascend-Appletalk-Peer-Mode = Appletalk-Peer-Dialin,
Ascend-Route-Appletalk = Route-Appletalk-Yes,
Ascend-Idle-Limit = 0
Dependencies: Ascend-Route-Appletalk must be set to Yes.

See Also: Ascend-Appletalk-Peer-Mode (117), Ascend-Appletalk-Route (116)

Ascend-Appletalk-Route (116)

Description: Defines a static AppleTalk route. in a RADIUS pseudo-user profile.

Usage: Create a pseudo-user profile with the first line in the following format:

appleroute-num Password="ascend', user-service=Dialout-Framed-
User
where num is a number in a series starting at 1. Then enter one or more static AppleTalk route specifications in the following format:

Ascend-Appletalk-Route="net_start net_end zone_name 
profile_name"

Argument

Description

net_start

The lower limit of the network range for this network. A network range is a range of network numbers set into the port descriptor of the router port and then transmitted through RTMP to the other nodes of the network. Each of the numbers within a network range can represent up to 253 devices.

The default is blank.

net_end

The upper limit of the network range for this network. This range defines the networks available for packets routed using the static route. Specify a number between 1 and 65199. If there are other AppleTalk routers on the network, you must configure the network ranges to be identical to the ranges specified on the other routers.

zone_name

The name of the AppleTalk zone associated with this network. A zone is a multicast address containing a subset of the AppleTalk nodes on an internet. Each node belongs to only one zone, but a particular extended network can contain nodes belonging to any number of zones. Zones provide departmental or other groupings of network entities that a user can easily understand. In the Ascend AppleTalk router, zone names are case-insensitive. However, because some routers regard zone names as case-sensitive, the spelling of zone names should be consistent when you configure multiple connections or routers.

You can use up to 33 alphanumeric characters. The default is blank.

profile_name

The outgoing RADIUS user profile that the route uses. The default is blank.

Each static route must appear in a user profile. User profile entries for Appletalk static routes are identified by the special name appleroute-# and have the following format:

appleroute-# Password = "ascend" User-Service = Dialout-Framed-User
Address 1
Address 2
...
Address n
Address n is the actual route associated with this entry.

An example of a static route with the associated connection profiles is:

appleroute-1    Password = "ascend" User-Service = Dialout-
Framed-User Ascend-Appletalk-Route = "20 25 testzone1 pipe50"

pipe50 Password = "ascend" User-Service = Dialout-Framed-User,
User-Service = Framed-User,
Framed-Protocol = MPP,
Ascend-Appletalk-Peer-Mode = Appletalk-Peer-Router,
Ascend-Route-Appletalk = Route-Appletalk-Yes,
Ascend-Dialout-Allowed = Dialout-Allowed,
Ascend-Dial-Number = "83272",
Ascend-Send-Auth = Send-Auth-PAP,
Ascend-Send-Passwd = "MAX"
Dependencies: Ascend-Route-Appletalk must be set to Yes.

See Also: Ascend-Appletalk-Peer-Mode (117)

Ascend-Ara-PW (181)

Description: The Ascend-Ara-PW attribute specifies the password of the incoming caller over an AppleTalk Remote Access (ARA) connection. The ARA software in the MAX uses DES to encrypt and decrypt the password.

Usage: Specify an alphanumeric text string containing up to 20 characters. The default value is null. The password you enter for this attribute must be identical to the password you enter in the first line of the user profile. The MAX requires both entries.

Example: This example sets up a TCP connection through ARA with a dynamic IP address assignment:

Emma Password="pwd"
          Framed-Protocol=ARA,
          Ascend-Ara-PW="pwd",
          Ascend-Route-IP=Route-IP-Yes,
          Ascend-Assign-IP-Pool=1
See Also: Password (2)

Ascend-Assign-IP-Client (144)

Description: In the Radipa-Hosts pseudo-user profile, the Ascend-Assign-IP-Client attribute specifies the IP address of an Ascend unit that can use global IP address pools.

Usage: Specify an IP address in dotted-decimal notation. The default value is 0.0.0.0. You can specify multiple instances of this attribute. At present, the MAX does not use the list of radipad client units.

Dependencies: If no Ascend-Assign-IP-Client attribute is present, the list of client units defaults to those present in the RADIUS clients file.

See Also: Ascend-Assign-IP-Global-Pool (146)
Ascend-Assign-IP-Server (145)

Ascend-Assign-IP-Global-Pool (146)

Description: In a RADIUS user profile requiring dynamic addressing for dial-in users, the Ascend-Assign-IP-Global-Pool attribute specifies the global address pool from which RADIUS should assign each user an address.

Usage: Specify the name of the pseudo-user profile containing global IP pool definitions. The Ascend unit tries to allocate an address from the pools in order, and chooses an address from the pool with the first available IP address.

Dependencies: Do not set the Framed-Address attribute in the user profile. If you do, the MAX will require the caller to use the static IP address the attribute specifies.

See Also: Ascend-Assign-IP-Client (144)
Ascend-Assign-IP-Server (145)
Framed-Address (8)

Ascend-Assign-IP-Pool (218)

Description: In a user profile, the Ascend-Assign-IP-Pool attribute specifies the MAX- specific address pool from which RADIUS assigns the user an IP address.

A dynamic address comes from the pool of addresses set by the Pool #n Start and Pool #n Count parameters, by the Ascend-IP-Pool-Definition attribute, or both. An IP address pool you set up in RADIUS overrides an IP address pool you set up in the MAX configuration interface only if you designate the two pools by the same number.

If you need to define more than ten pools of addresses, you must use the RADIUS attribute Ascend-IP-Pool-Definition to configure the IP address pools.

Usage: Specify an integer corresponding to an address pool. The default value is 1. If you set Ascend-Assign-IP-Pool=0, RADIUS chooses an address from any pool that has one available.

Example: In this example, the user requests an address from pool #2:

Emma Password="m2dan", User-Service=Framed-User

Framed-Protocol=PPP,

Ascend-Route-IP=Route-IP-Yes,

Ascend-Metric=2,

Framed-Routing=None,

     Ascend-Assign-IP-Pool=2
See Also: Ascend-IP-Pool-Definition (217)

Ascend-Assign-IP-Server (145)

Description: In the Radipa-Hosts pseudo-user profile, the Ascend-Assign-IP-Server attribute specifies the IP address of the host running radipad.

Usage: Specify an IP address in dotted decimal notation. The default value is 0.0.0.0. Only one instance of this attribute can appear in the profile. The default value is a placeholder only. You must specify a valid IP address for radipad to work.

See Also: Ascend-Assign-IP-Client (144)
Ascend-Assign-IP-Global-Pool (146)

Ascend-Authen-Alias (203)

Description: The Ascend-Authen-Alias attribute sets the MAX unit's login name during PPP authentication.

When the MAX places an outgoing call, it identifies itself by a login name and password. The login name is either its system name (as specified by the Name parameter in the System profile) or the value you specify for the Ascend-Authen-Alias attribute.

Usage: Specify a text string containing up to 16 characters. The default is the value of the Name parameter in the System profile.

Example: This example uses the Ascend-Authen-Alias attribute in an outgoing profile:

Homer-Out Password="Ascend", User-Service=Dialout-Framed-User
        User-Name="Homer",
        Ascend-Authen-Alias="myMAXcallingU",
        Ascend-Send-Auth=Send-Auth-PAP,
        Ascend-Send-Secret="passwrd1",
        Ascend-Dial-Number="31",
        Framed-Protocol=PPP,
        Framed-Address=10.0.100.1,
        Framed-Netmask=255.255.255.0,
        Ascend-Metric=2,
        Framed-Routing=None,
        Framed-Route="10.5.0.0/24 10.0.100.1 1",
        Ascend-Idle-Limit=30

Ascend-backup (176)

Description: The Ascend-backup attribute specifies the name of a backup profile for a nailed- up link when the physical connection fails on loss of a T1 line or WAN Serial port. The MAX automatically diverts traffic to the backup connection. When the primary connection comes back online, traffic again uses the primary connection.

When you use the backup connection, the MAX does not move routes to the backup profile. Therefore, the IP routes that appear in the terminal server display may be incorrect, although statistical counts reflect the change.

Usage: Specify the name of the profile that you want to act as the backup. The backup connection can be switched or nailed up. The default value is null.

Dependencies: Keep this additional information in mind:

Ascend-BACP-Enable (134)

Description: The Ascend-BACP-Enable attribute specifies whether Bandwidth Allocation Control Protocol (BACP) is enabled for the link.

BACP is the Internet standard protocol equivalent to the Ascend MP+ bandwidth allocation protocol. BACP functions similarly to MP+ and uses the same attributes as MP+.

Usage: You can specify one of these settings:

Ascend-Base-Channel-Count (172)

Description: The Ascend-Base-Channel-Count attribute specifies the initial number of channels the MAX sets up when originating calls for a PPP, MP+, MP, or Combinet multichannel link.

Usage: The maximum number of channels you can specify depends upon the nature of the link:

The default value is 1.

Dependencies: The Ascend-Base-Channel-Count attribute does not apply when all channels of the link are nailed up (Ascend-Call-Type=Nailed).

For optimum MP+ performance, both sides of a connection must set these values to the same number:

See Also: Ascend-Add-Seconds (240)
Ascend-DBA-Monitor (171)
Ascend-Dec-Channel-Count (237)
Ascend-History-Weigh-Type (239)
Ascend-Inc-Channel-Count (236)
Ascend-Maximum-Channels (235)
Ascend-Minimum-Channels (173)
Ascend-Remove-Seconds (241)
Ascend-Seconds-Of-History (238)
Ascend-Target-Util (234)

Ascend-Billing-Number (249)

Description: The Ascend-Billing-Number attribute specifies a billing number for charges you incur on the line. If you do not enter a billing number, the telephone company assigns charges to the telephone number associated with the line.

Your carrier determines the billing number, and uses it to sort your bill. If you have several departments, and each department has its own Ascend-Billing-Number, your carrier can separate and tally each department's usage.

Usage: Specify a telephone number. You can indicate up to ten characters, and you must limit those characters to the following:

1234567890()[]!z-*# |
Dependencies: The MAX uses the Ascend-Billing-Number attribute differently depending on the type of line you use:

See Also: Caller-Id (31)

Ascend-Bridge (230)

Description: The Ascend-Bridge attribute enables or disables protocol-independent bridging for the user profile.

Usage: You can specify one of these values:

Example: This user profile specifies an IPX bridging link:

MAX1 Password="m2dan", User-Service=Framed-User

Framed-Protocol=PPP,

Ascend-Route-IPX=Route-IPX-No,

Ascend-Bridge=Bridge-Yes,

     Ascend-Handle-IPX=Handle-IPX-Client,
Ascend-Netware-timeout=30

See Also: Ascend-Bridge-Address (168)

Ascend-Bridge-Address (168)

Description: The Ascend-Bridge-Address attribute specifies the IP address and associated MAC address of a device on a remote LAN to which the MAX can form a bridging connection.

Usage: The Ascend-Bridge-Address attribute has this format:

Ascend-Bridge-Address="MAC_address profile_name IP_address"
Table 9-1 describes Ascend-Bridge-Address arguments.

Table 9-1. Ascend-Bridge-Address arguments

Argument

Description

MAC_address

Specifies a MAC address in standard 12-digit hexadecimal format (yyyyyyyyyyyy) or in colon-separated format (yy:yy:yy:yy:yy:yy). If the leading digit of a colon-separated pair is 0 (zero), you do not need to enter it. That is, :y is the same as :0y.

The default value is 000000000000.

profile_name

Specifies the name of the dialout profile the MAX uses to bring up the connection. You can specify either a Connection profile or a RADIUS user profile. The MAX looks for a local profile first.

IP_address

Specifies an IP address in dotted decimal notation. The default value is 0.0.0.0.

When your MAX receives an ARP request for one of the IP addresses you specify, the MAX replies with the corresponding MAC address and uses the specified profile to bring up a connection to that address. Because the MAX replies to these ARP requests as if the IP devices were local, you must have user profiles that bridge IP packets to each device.

Dependencies: Each bridge entry must appear in a pseudo-user profile. You create a pseudo- user to store information that the MAX can query-in this case, in order to store bridging information. For a unit-specific bridge entry, specify the first line of a pseudo-user profile in this format:

Bridge-unit_name-num Password="Ascend", User-Service=
Dialout-Framed-User
unit_name is the system name of the MAX-that is, the name specified by the Name parameter in the System profile. num is a number in a sequential series, starting at 1.

In each pseudo-user profile, you specify one or more Ascend-Bridge-Address attributes. Whenever you power on or reset the MAX, or when you select the Upd Rem Cfg command from the Sys Diag menu, RADIUS adds bridging entries to the bridge table in this way:

  1. RADIUS looks for profiles having the format Bridge-unit_name-num, where unit_name is the system name and num is a number in a sequential series, starting with 1.

  2. RADIUS loads the data to create the bridging tables.

Example: This example creates two bridging table entries.

Bridge-Ascend-1 Password="Ascend", User-Service=Dialout-Framed-User
       Ascend-Bridge-Address="2:2:3:10:11:12 Prof1 1.2.3.4 1",
       Ascend-Bridge-Address="2:2:3:13:14:15 Prof2 5.6.7.8 2"
See Also: Ascend-Bridge (230)

Ascend-Callback (246)

Description: The Ascend-Callback attribute enables or disables callback. Callback occurs when the MAX answers a call and verifies a name and password against a user profile. If
Ascend-Callback=Yes, the MAX hangs up and dials back to the caller using these values:


Note: If you set up a RADIUS user profile for callback and CLID-only authentication, the MAX never answers the call. The caller can therefore avoid billing charges.

Usage: You can specify one of these values:

Dependencies: The Ascend-Callback attribute applies only to incoming calls and should not appear in dial-out user profiles (when User-Service=Dialout-Framed-User).

Ascend-Call-By-Call (250)

Description: The Ascend-Call-By-Call attribute specifies the T1 PRI service that the MAX uses when placing a PPP call.

Usage: Specify a number corresponding to the type of service the MAX uses. The default value is 6. Table 9-2 lists the services available for each service provider.

Table 9-2. Ascend-Call-By-Call setting

Number

AT&T

Sprint

MCI

0

Disable call-by-call service.

Reserved

N/A

1

SDN (including GSDN)

Private

VNET/Vision

2

Megacom 800

Inwatts

800

3

Megacom

Outwatts

PRISM1, PRISM II, WATS

4

N/A

FX

900

5

N/A

Tie Trunk

DAL

6

ACCUNET Switched Digital Services

N/A

N/A

7

Long Distance Service (including AT&T World
Connect)

N/A

N/A

8

International 800 (I800)

N/A

N/A

16

AT&T MultiQuest

N/A

N/A

Ascend-Call-Filter (243)

Description: The Ascend-Call-Filter attribute defines a call filter.

Unlike the Filter profiles in the MAX configuration interface, RADIUS filters are part of the outgoing or incoming RADIUS user profile. The MAX uses a RADIUS filter only when the MAX places or answers a call with a RADIUS profile that includes the filter specification.

Usage: Filter entries apply on a first-match basis. Therefore, the order in you specify filter entries is significant. If you make changes to a filter in a RADIUS user profile, the changes do not take effect until a call uses that profile.

IP call filter entries

Use the following format for an IP call filter entry:

Ascend-Call-Filter="ip dir action
[dstip dest_ipaddr\subnet_mask][srcip src_ipaddr\subnet_mask]
[
proto [dstport cmp value] [srcport cmp value] [est]]"

Note: A filter definition cannot contain newlines. The syntax appears on multiple lines for printing purposes only.

Table 9-3 describes each element of the syntax.

Table 9-3. IP call filter syntax elements

Keyword or argument

Description

ip

Indicates an IP filter.

dir

Indicates filter direction. You can specify in (to filter packets coming into the MAX) or out (to filter packets going out of the MAX).

action

Indicates what action the MAX should take with a packet that matches the filter. You can specify either
forward or drop.

dstip dest_ipaddr

dstip is a keyword indicating destination IP address.

The filter applies to packets whose destination address matches the value of dest_ipaddr. If a subnet mask portion of the address is present, the MAX compares only the masked bits. If you set dest_ipaddr to 0.0.0.0, or if this keyword and its IP address specification are not present, the filter matches all IP packets.

srcip src_ipaddr

srcip is a keyword indicating source IP address.

The filter applies to packets whose source address matches the value of src_ipaddr. If a subnet mask portion of the address is present, the MAX compares only the masked bits. If you set src_ipaddr to 0.0.0.0, or if this keyword and its IP address specification are not present, the filter matches all IP packets.

proto

Indicates a protocol that you can specify as a name or a number.

The filter applies to packets whose protocol field matches this value.The supported names and numbers are icmp (1), tcp (6), udp (17), and ospf (89). If you set proto to 0 (zero), the filter matches any protocol.

dstport cmp value

dstport is a keyword indicating destination port. This argument is valid only when the protocol is tcp (6) or udp (17). If you do not specify a destination port, the filter matches any port.

cmp is an argument indicating how to compare the specified value to the actual destination port. It can have the value <, =, >, or !=.

value can be a number or a name. Supported names and numbers are ftp-data (20), ftp (21), telnet (23), smtp (25), nameserver (42), domain (53), tftp (69), gopher (70), finger (79), www (80), kerberos (88), hostname (101), nntp (119), ntp (123), exec (512), login (513), cmd (514), and talk (517).

srcport cmp value

srcport is a keyword indicating source port. It is valid only when the protocol is tcp (6) or udp (17). If you do not specify a source port, the filter matches any port.

cmp is an argument indicating how to compare the specified value to the actual source port. It can have the value <, =, >, or !=.

value can be a number or a name. Supported names and numbers are ftp-data (20), ftp (21), telnet (23), smtp (25), nameserver (42), domain (53), tftp (69), gopher (70), finger (79), www (80), kerberos (88), hostname (101), nntp (119), ntp (123), exec (512), login (513), cmd (514), and talk (517).

est

If you set this argument to 1, the filter matches a packet only if a TCP session is already established. It is valid only when the proto specification is tcp (6).

None of the keywords are case sensitive.

IPX call filter entries

Use the following format for an IPX call filter entry:

Ascend-Call-Filter="ipx <dir> <action>
   [srcipxnet <srcipxnet> srcipxnode <srcipxnode>
   [srcipxsoc <cmp> <value> ]]
   [dstipxnet <dstipxnet> dstipxnode <dstipxnode>
   [dstipxsoc <cmp> <value> ]]

Note: A filter definition cannot contain newlines. The syntax is shown on multiple lines for documentation purposes only.

Table 9-8 lists each keyword and argument.

Table 9-4. IPX filter syntax elements

Syntax element

Description

ipx

Designates an IPX filter.

<dir>

Indicates filter direction. You can specify "in" (to filter packets coming into the MAX) or "out" (to filter packets going out of the MAX).

<action>

Indicates the action the MAX should take with a packet that matches the filter. You can specify either "forward" or "drop".

srcipxnet

Designates that a source IPX network number appears after this keyword.

<srcipxnet>

Specifies the source IPX network number-the unique internal network number assigned to the NetWare server. You must specify the network number in hexadecimal format. Specifying 0x or 0X is optional.

srcipxnode

Designates that a source IPX node number appears after this keyword.

<srcipxnode>

Specifies the source IPX node number-the node number of the NetWare server. A valid IPX node number must accompany the IPX network number. You must specify the node number in hexadecimal format. Specifying 0x or 0X is optional. The IPX node number 0xffffffffffff is allowed and matches all IPX packets with the same node number.

srcipxsoc

Designates that a source IPX socket number specification appears after this keyword.

<cmp>

Indicates how to compare the socket number specified by <value> to the actual socket number in the packet. The <cmp> argument can have the value <, =, >, or !=.

<value>

Specifies the socket number of the NetWare server. Following the srcipxsoc keyword, the <value> argument specifies the source socket number; following the dstipxsoc keyword, the <value> argument specifies the destination socket number.

You must specify the socket number in hexadecimal format. Specifying 0x or 0X is optional.

dstipxnet

Designates that a destination IPX network number appears after this keyword.

<dstipxnet>

Specifies the destination IPX network number-the unique internal network number assigned to the NetWare server. You must specify the network number in hexadecimal format. Specifying 0x or 0X is optional.

dstipxnode

Designates that a destination IPX node number appears after this keyword.

<dstipxnode>

Specifies the destination IPX node number-the node number of the NetWare server. A valid IPX node number must accompany the IPX network number.

You must specify the node number in hexadecimal format. Specifying 0x or 0X is optional. The IPX node number 0xffffffffffff is allowed and matches all IPX packets with the same node number.

dstipxsoc

Designates that a source IPX socket number specification appears after this keyword.

Generic call filter entries

Use the following format for a generic call filter entry:

Ascend-Call-Filter="generic dir action offset mask value 
compare [more]"

Note: A filter definition cannot contain newlines. The syntax appears on multiple lines for printing purposes only.

Table 9-5 describes each element of the syntax. None of the keywords are case sensitive.

Table 9-5. Generic call filter syntax elements

Keyword or argument

Description

generic

Indicates a generic filter.

dir

Indicates filter direction. You can specify in (to filter packets coming into the MAX) or out (to filter packets going out of the MAX).

action

Indicates what action the MAX should take with a packet that matches the filter. You can specify either forward or drop.

offset

Indicates the number of bytes masked from the start of the packet. The byte position specified by offset is called the byte-offset.

Starting at the position specified by offset, the MAX applies the value of the mask argument. A mask hides the part of a number that appears behind the binary zeroes in the mask. For example, if you set mask to ffff0000 in hexadecimal format, the filter uses only the first 16 binary digits in the comparison, since f=1111 in binary format. The unit then compares the unmasked portion of the packet with the value specified by the value argument.

mask

Indicates which bits to compare in a segment of the packet. The mask cannot exceed 6 bytes (12 hexadecimal digits). A one-bit in the mask indicates a bit to compare. A zero-bit indicates a bit to ignore. The length of the mask specifies the length of the comparison.

value

Indicates the value to compare to the packet contents at the specified offset in the packet. The length of the value must be the same as the length of the mask. Otherwise, the MAX ignores the filter.

compare

Indicates how the MAX compares a packet's contents to the value specified by value. You can specify == (for Equal) or != (for NotEqual). The default value is Equal.

more

If present, specifies whether the MAX applies the next filter definition in the profile to the current packet before deciding whether to forward or drop the packet.

The dir and action values for the next entry must be the same as the dir and action values for the current entry. Otherwise, the MAX ignores the more flag.

Example: These are examples of IP call filter entries:

Ascend-Call-Filter="ip in drop"
Ascend-Call-Filter="ip out forward tcp"
Ascend-Call-Filter="ip out forward tcp dstip 10.0.200.3/16 srcip 
10.0.200.25/16 dstport!=telnet"
Ascend-Call-Filter="ip out forward tcp dstip 10.0.200.3/16 srcip 
10.0.200.25/16 icmp"
These are examples of generic call filter entries:

Ascend-Call-Filter="generic in drop 0 ffff 0080"
Ascend-Call-Filter="generic in drop 0 ffff != 0080 more"
Ascend-Call-Filter="generic in drop 16 ff aa"
See Also: Ascend-Data-Filter (242)

Ascend-Call-Type (177)

Description: The Ascend-Call-Type attribute specifies the type of nailed-up connection in use.

Usage: You can specify one of these values:

Dependencies: The MAX adds or subtracts switched channels on a Nailed/Mpp connection as the settings on either side of the connection require. Each side makes its calculations based on the traffic it receives at that side. If the two sides of the connection disagree on the number of channels needed, the side requesting the greater number prevails.

The DO Hangup command works only from the caller side of the connection when you choose Nailed/Mpp.

Ascend-CBCP-Enable (112)

Description: Specifies how the MAX responds to requests by callers to support CBCP.


Note: Make sure you set CBCP Enable=Yes in the Ethernet > Answer > PPP Options menu.

Usage: Specify one of the following settings:

See Also: Ascend-CBCP-Mode, Ascend-CBCP-Trunk-Group

Ascend-CBCP-Mode (113)

Description: Specifies what method of callback the MAX offers the incoming caller.


Note: Make sure you set CBCP Enable=Yes in the Ethernet > Answer > PPP Options menu.

Usage: Specify one of the following values:

Dependencies: Ascend-CBCP-Mode applies only if CBCP is successfully negotiated for a connection.

See Also: Ascend-CBCP-Enable, Ascend-CBCP-Trunk-Group

Ascend-CBCP-Trunk-Group (115)

Description: Assigns the callback to a MAX trunk group. This attribute is used only when the caller is specifying the phone number the MAX uses for the callback. The value in Ascend- CBCP-Trunk-Group is prepended to the caller-supplied number when the MAX calls back.


Note: Make sure you set CBCP Enable=Yes in the Ethernet > Answer > PPP Options menu.

Usage: You can specify a number between 4 and 9, inclusive. The default is 9.

Dependencies: Ascend-CBCP-Trunk-Group applies only if CBCP is negotiated for a connection.

See Also: Ascend-CBCP-Enable, Ascend-CBCP-Mode

Ascend-Client-Gateway (132)

Description: The Ascend-Client-Gateway attribute specifies the default route for IP packets coming from the user on this connection.

Usage: Specify the IP address of the next hop router in dotted decimal notation. The default value is 0.0.0.0. If you accept this value, the Ascend unit routes packets as specified in the routing table, using the system-wide default route if it cannot find a more specific route.

The Ascend unit must have a direct route to the address you specify. The direct route can take place via a profile or an Ethernet connection. If the Ascend unit does not have a direct route, it drops the packets on the connection. When you diagnose routing problems with a profile using this feature, an error in a per-user gateway address is not apparent from inspection of the global routing table.

Example: If you specify Ascend-Client-Gateway=10.0.0.3 in the RADIUS user profile
Berkeley, IP packets from the user with destinations through the default route goes through the router at 10.0.0.3.

Ascend-Connect-Progress (196)

Description: The Ascend-Connect-Progress attribute specifies the state of the connection before it disconnects.

The MAX includes Ascend-Connect-Progress in an Accounting-Request packet when both of these conditions are true:

Usage: Ascend-Connect-Progress can have any one of values specified in Table 9-6

Table 9-6. Ascend-Connect-Progress codes

Code

Explanation

0

No progress.

1

Not applicable.

2

The progress of the call is unknown.

10

The call is up.

30

The modem is up.

31

The modem is waiting for DCD.

32

The modem is waiting for result codes.

40

The terminal server session has started up.

41

The MAX is establishing the TCP connection.

42

The MAX is establishing the immediate Telnet connection.

43

The MAX has established a raw TCP session with the host. This code does not imply that the user has logged into the host.

44

The MAX has established an immediate Telnet connection with the host. This code does not imply that the user has logged into the host.

45

The MAX is establishing an Rlogin session.

46

The MAX has established an Rlogin session with the host. This code does not imply that the user has logged into the host.

60

The LAN session is up.

61

LCP negotiations are allowed.

62

CCP negotiations are allowed.

63

IPNCP negotiations are allowed.

64

Bridging NCP negotiations are allowed.

65

LCP is in the Open state.

66

CCP is in the Open state.

67

IPNCP is in the Open state.

68

Bridging NCP is in the Open state.

69

LCP is in the Initial state.

70

LCP is in the Starting state.

71

LCP is in the Closed state.

72

LCP is in the Stopped state.

73

LCP is in the Closing state.

74

LCP is in the Stopping state.

75

LCP is in the Request Sent state.

76

LCP is in the ACK Received state.

77

LCP is in the ACK Sent state.

80

IPXNCP is in the Open state.

90

V.110 is up.

91

V.110 is in the Open state.

92

V.110 is in the Carrier state.

93

V.110 is in the Reset state.

94

V.110 is in the Closed state.

.

Ascend-Data-Filter (242)

Description: The Ascend-Data-Filter attribute defines a data filter.

Unlike the Filter profiles in the MAX configuration interface, RADIUS filters are part of the outgoing or incoming RADIUS user profile. The MAX uses a RADIUS filter only when the MAX places or answers a call with a RADIUS profile that includes the filter specification.

Usage: Filter entries apply on a first-match basis. Therefore, the order in you specify filter entries is significant. If you make changes to a filter in a RADIUS user profile, the changes do not take effect until a call uses that profile.

IP data filter entries

Use the following format for an IP data filter entry:

Ascend-Data-Filter="ip dir action 
[dstip
dest_ipaddr\subnet_mask][srcip src_ipaddr\subnet_mask]
[
proto [dstport cmp value] [srcport cmp value] [est]]"

Note: A filter definition cannot contain newlines. The syntax appears on multiple lines for printing purposes only.

Table 9-7 describes each element of the syntax.

Table 9-7. IP data filter syntax elements

Keyword or argument

Description

ip

Indicates an IP filter.

dir

Indicates filter direction. You can specify in (to filter packets coming into the MAX) or out (to filter packets going out of the MAX).

action

Indicates what action the MAX should take with a packet that matches the filter. You can specify either
forward or drop.

dstip dest_ipaddr

dstip is a keyword indicating destination IP address.

The filter applies to packets whose destination address matches the value of dest_ipaddr. If a subnet mask portion of the address is present, the MAX compares only the masked bits. If you set dest_ipaddr to 0.0.0.0, or if this keyword and its IP address specification are not present, the filter matches all IP packets.

srcip src_ipaddr

srcip is a keyword indicating source IP address.

The filter applies to packets whose source address matches the value of src_ipaddr. If a subnet mask portion of the address is present, the MAX compares only the masked bits. If you set src_ipaddr to 0.0.0.0, or if this keyword and its IP address specification are not present, the filter matches all IP packets.

proto

Indicates a protocol that you can specify as a name or a number.

The filter applies to packets whose protocol field matches this value.The supported names and numbers are icmp (1), tcp (6), udp (17), and ospf (89). If you set proto to 0 (zero), the filter matches any protocol.

dstport cmp value

dstport is a keyword indicating destination port. This argument is valid only when the protocol is tcp (6) or udp (17). If you do not specify a destination port, the filter matches any port.

cmp is an argument indicating how to compare the specified value to the actual destination port. It can have the value <, =, >, or !=.

value can be a number or a name. Supported names and numbers are ftp-data (20), ftp (21), telnet (23), smtp (25), nameserver (42), domain (53), tftp (69), gopher (70), finger (79), www (80), kerberos (88), hostname (101), nntp (119), ntp (123), exec (512), login (513), cmd (514), and talk (517).

srcport cmp value

srcport is a keyword indicating source port. It is valid only when the protocol is tcp (6) or udp (17). If you do not specify a source port, the filter matches any port.

cmp is an argument indicating how to compare the specified value to the actual source port. It can have the value <, =, >, or !=.

value can be a number or a name. Supported names and numbers are ftp-data (20), ftp (21), telnet (23), smtp (25), nameserver (42), domain (53), tftp (69), gopher (70), finger (79), www (80), kerberos (88), hostname (101), nntp (119), ntp (123), exec (512), login (513), cmd (514), and talk (517).

est

If you set this argument to 1, the filter matches a packet only if a TCP session is already established. It is valid only when the proto specification is tcp (6).

None of the keywords are case sensitive.

IPX data filter entries

Use the following format for an IPX data filter entry:

Ascend-Data-Filter="ipx <dir> <action>
   [srcipxnet <srcipxnet> srcipxnode <srcipxnode>
   [srcipxsoc <cmp> <value> ]]
   [dstipxnet <dstipxnet> dstipxnode <dstipxnode>
   [dstipxsoc <cmp> <value> ]]

Note: A filter definition cannot contain newlines. The syntax is shown on multiple lines for documentation purposes only.

Table 9-8 lists each keyword and argument.

Table 9-8. IPX filter syntax elements

Syntax element

Description

ipx

Designates an IPX filter.

<dir>

Indicates filter direction. You can specify "in" (to filter packets coming into the MAX) or "out" (to filter packets going out of the MAX).

<action>

Indicates the action the MAX should take with a packet that matches the filter. You can specify either "forward" or "drop".

srcipxnet

Designates that a source IPX network number appears after this keyword.

<srcipxnet>

Specifies the source IPX network number-the unique internal network number assigned to the NetWare server. You must specify the network number in hexadecimal format. Specifying 0x or 0X is optional.

srcipxnode

Designates that a source IPX node number appears after this keyword.

<srcipxnode>

Specifies the source IPX node number-the node number of the NetWare server. A valid IPX node number must accompany the IPX network number. You must specify the node number in hexadecimal format. Specifying 0x or 0X is optional. The IPX node number 0xffffffffffff is allowed and matches all IPX packets with the same node number.

srcipxsoc

Designates that a source IPX socket number specification appears after this keyword.

<cmp>

Indicates how to compare the socket number specified by <value> to the actual socket number in the packet. The <cmp> argument can have the value <, =, >, or !=.

<value>

Specifies the socket number of the NetWare server. Following the srcipxsoc keyword, the <value> argument specifies the source socket number; following the dstipxsoc keyword, the <value> argument specifies the destination socket number.

You must specify the socket number in hexadecimal format. Specifying 0x or 0X is optional.

dstipxnet

Designates that a destination IPX network number appears after this keyword.

<dstipxnet>

Specifies the destination IPX network number-the unique internal network number assigned to the NetWare server. You must specify the network number in hexadecimal format. Specifying 0x or 0X is optional.

dstipxnode

Designates that a destination IPX node number appears after this keyword.

<dstipxnode>

Specifies the destination IPX node number-the node number of the NetWare server. A valid IPX node number must accompany the IPX network number.

You must specify the node number in hexadecimal format. Specifying 0x or 0X is optional. The IPX node number 0xffffffffffff is allowed and matches all IPX packets with the same node number.

dstipxsoc

Designates that a source IPX socket number specification appears after this keyword.

Generic data filter entries

Use the following format for a generic data filter entry:

Ascend-Data-Filter="generic dir action offset mask value 
compare [more]"

Note: A filter definition cannot contain newlines. The syntax appears on multiple lines for printing purposes only.

Table 9-9 describes each element of the syntax. None of the keywords are case sensitive.

Table 9-9. Generic data filter syntax elements

Keyword or argument

Description

generic

Indicates a generic filter.

dir

Indicates filter direction. You can specify in (to filter packets coming into the MAX) or out (to filter packets going out of the MAX).

action

Indicates what action the MAX should take with a packet that matches the filter. You can specify either forward or drop.

offset

Indicates the number of bytes masked from the start of the packet. The byte position specified by offset is called the byte-offset.

Starting at the position specified by offset, the MAX applies the value of the mask argument. A mask hides the part of a number that appears behind the binary zeroes in the mask. For example, if you set mask to ffff0000 in hexadecimal format, the filter uses only the first 16 binary digits in the comparison, since f=1111 in binary format. The unit then compares the unmasked portion of the packet with the value specified by the value argument.

mask

Indicates which bits to compare in a segment of the packet. The mask cannot exceed 6 bytes (12 hexadecimal digits). A one-bit in the mask indicates a bit to compare. A zero-bit indicates a bit to ignore. The length of the mask specifies the length of the comparison.

value

Indicates the value to compare to the packet contents at the specified offset in the packet. The length of the value must be the same as the length of the mask. Otherwise, the MAX ignores the filter.

compare

Indicates how the MAX compares a packet's contents to the value specified by value. You can specify == (for Equal) or != (for NotEqual). The default value is Equal.

more

If present, specifies whether the MAX applies the next filter definition in the profile to the current packet before deciding whether to forward or drop the packet.

The dir and action values for the next entry must be the same as the dir and action values for the current entry. Otherwise, the MAX ignores the more flag.

Example: These are examples of IP data filter entries:

Ascend-Data-Filter="ip in drop"
Ascend-Data-Filter="ip out forward tcp"
Ascend-Data-Filter="ip out forward tcp dstip 10.0.200.3/16 srcip 
10.0.200.25/16 dstport!=telnet"
Ascend-Data-Filter="ip out forward tcp dstip 10.0.200.3/16 srcip 
10.0.200.25/16 icmp"
These are examples of generic data filter entries:

Ascend-Data-Filter="generic in drop 0 ffff 0080"
Ascend-Data-Filter="generic in drop 0 ffff != 0080 more"
Ascend-Data-Filter="generic in drop 16 ff aa"
See Also: Ascend-Call-Filter (243)

Ascend-Data-Rate (197)

Description: The Ascend-Data-Rate attribute specifies the receive baud rate of the connection in bits per second.

The MAX includes Ascend-Data-Rate in an Accounting-Request packet when both of these conditions are true:

Usage: Ascend-Data-Rate does not appear in a user profile. Its default value is 0 (zero).

Ascend-Data-Svc (247)

Description: The Ascend-Data-Svc attribute specifies the type of data service the link uses for outgoing calls.

Usage: The data service you specify must be available end-to-end. You can set the Ascend- Data-Svc attribute to one of the values listed in

Table 9-10. Ascend-Data-Svc settings

Setting

Description

Switched-Voice-Bearer (0)

This value applies only to calls made over an ISDN BRI or T1 PRI line. When you specify this setting, the MAX enables the network to place an end-to-end digital voice call for transporting data when a switched data service is not available.

Switched-56KR (1)

The call contains restricted data, guaranteeing that the data the MAX transmits meets the density restrictions of D4-framed T1 lines. D4 specifies the D4 format, also known as the Superframe format, for framing data at the physical layer. This format consists of 12 consecutive frames, separated by framing bits.

The call connects to the Switched-56 data service. The only services available to lines using inband signaling (T1 access lines containing one or more switched channels, and Switched-56 lines) are Switched-56K and Switched-56KR.

Switched-64K (2)

The call contains any type of data and connects to the Switched-64 data service.

Switched-64KR (3)

The call contains restricted data and connects to the Switched-64 data service.

Switched-56K (4)

The call contains any type of data and connects to the Switched-56 data service. The only services available to lines using inband signaling (T1 access lines containing one or more switched channels, and Switched-56 lines) are Switched-56K and Switched- 56KR. For most T1 PRI lines, select Switched-56K.

Nailed-56KR (1)

The call contains restricted data and connects to the Nailed-56 data service.

Nailed-64K (2)

The call contains any type of data and connects to the Nailed-64 data service.

Switched-384KR
The call contains restricted data, and connects to MultiRate or GloBanD data services at 384 kbps.

Switched-384K
The call contains any type of data and connects to the Switched-384 data service. This AT&T data service does not require MultiRate or GloBanD.

Switched-1536K
The call contains any type of data and connects to the Switched-1536 data service at 1536 kbps.

This setting is valid only for a MAX that supports ISDN D-channel signaling, and that connects to two or more T1 PRI lines using Non-Facility Associated Signaling (NFAS).

Switched-1536KR
The call contains restricted data, and connects to the Switched-1536 data service at 1536 kbps.

This setting is valid only for a MAX that supports ISDN D-channel signaling, and that connects to two or more T1 PRI lines using Non-Facility Associated Signaling (NFAS).

Switched-128K
This value is available on a T1 PRI line with MultiRate or GloBanD data services.

Switched-192K
This value is available on a T1 PRI line with MultiRate or GloBanD data services.

Switched-256K
This value is available on a T1 PRI line with MultiRate or GloBanD data services.

Switched-320K
This value is available on a T1 PRI line with MultiRate or GloBanD data services.

Switched-384K-MR
This value is available on a T1 PRI line with the MultiRate data service.

Switched-448K
This value is available on a T1 PRI line with MultiRate or GloBanD data services.

Switched-512K
This value is available on a T1 PRI line with MultiRate or GloBanD data services.

Switched-576K
This value is available on a T1 PRI line with MultiRate or GloBanD data services.

Switched-640K
This value is available on a T1 PRI line with MultiRate or GloBanD data services.

Switched-704K
This value is available on a T1 PRI line with MultiRate or GloBanD data services.

Switched-768K
This value is available on a T1 PRI line with MultiRate or GloBanD data services.

Switched-832K
This value is available on a T1 PRI line with MultiRate or GloBanD data
Switched-896K
This value is available on a T1 PRI line with MultiRate or GloBanD data
Switched-960K
This value is available on a T1 PRI line with MultiRate or GloBanD data
Switched-1024K
This value is available on a T1 PRI line with MultiRate or GloBanD data
Switched-1088K
This value is available on a T1 PRI line with MultiRate or GloBanD data
Switched-1152K
This value is available on a T1 PRI line with MultiRate or GloBanD data
Switched-1216K
This value is available on a T1 PRI line with MultiRate or GloBanD data
Switched-1280K
This value is available on a T1 PRI line with MultiRate or GloBanD data
Switched-1344K
This value is available on a T1 PRI line with MultiRate or GloBanD data
Switched-1408K
This value is available on a T1 PRI line with MultiRate or GloBanD data
Switched-1472K
This value is available on a T1 PRI line with MultiRate or GloBanD data
Switched-1600K
This value is available on a T1 PRI line with MultiRate or GloBanD data
Switched-1664K
This value is available on a T1 PRI line with MultiRate or GloBanD data
Switched-1728K
This value is available on a T1 PRI line with MultiRate or GloBanD data
Switched-1792K
This value is available on a T1 PRI line with MultiRate or GloBanD data
Switched-1856K
This value is available on a T1 PRI line with MultiRate or GloBanD data
Switched-1920K
This value is available on a T1 PRI line with MultiRate or GloBanD data
Switched-inherited
This setting applies to calls placed by a device connected to a local ISDN BRI line supplied by a Host/BRI module. The call connects with the data service as requested by the caller on the local ISDN BRI line.

Switched-restricted-bearer-x30
This setting specifies the 56-kbps X.30 switched data service available from DPNSS and DASS 2 switches.

Switched-clear-bearer-v110
This setting specifies the 64-kbps V.110 switched data service available from DPNSS and DASS 2 switches.

Switched-restricted-64-x30
This setting specifies the 64-kbps X.30 switched data service available from DPNSS and DASS 2 switches.

For most DASS 2 and DPNSS installations, select Switched-restricted-64-x30.

Switched-clear-56-v110
This setting specifies the 56-kbps V.110 switched data service available from DPNSS and DASS 2 switches.

Switched-modem
This setting places an outgoing call on any available digital modem. If no digital modems are available, the MAX does not place the call. The data rate depends upon the quality of the connections between modems and the types of modems in use.

The Switched-modem setting requires that your MAX have digital modems. Modem applies only for PPP, MP+, and X.25/PAD calls. Currently, the MAX does not support multichannel modem calls.

When you need to set up a dial-out profile in RADIUS for the MAX 4000, MAX 2000, MAX 1800, or Pipeline 400, set Ascend-Data-Svc=Switched-modem.

Switched-atmodem
This setting applies only to the MAX 200 and is equivalent to
Table 9-10.

Dependencies: Keep this additional information in mind:

Ascend-DBA-Monitor (171)

Description: The Ascend-DBA-Monitor attribute specifies how the Ascend calling unit monitors the traffic on an MP+ call. The Ascend unit can use this information to add or subtract bandwidth as necessary.

Usage: You can specify one of these values:

Dependencies: Keep this additional information in mind:

See Also: Ascend-Add-Seconds (240)
Ascend-Base-Channel-Count (172)
Ascend-Dec-Channel-Count (237)
Ascend-History-Weigh-Type (239)
Ascend-Inc-Channel-Count (236)
Ascend-Maximum-Channels (235)
Ascend-Minimum-Channels (173)
Ascend-Remove-Seconds (241)
Ascend-Seconds-Of-History (238)
Ascend-Target-Util (234)

Ascend-Dec-Channel-Count (237)

Description: The Ascend-Dec-Channel-Count attribute specifies the number of channels the MAX removes when bandwidth changes either manually or automatically during a call.

Usage: Specify a number between 1 and 32. The default value is 1.

Dependencies: Keep this additional information in mind:

See Also: Ascend-Add-Seconds (240)
Ascend-Base-Channel-Count (172)
Ascend-DBA-Monitor (171)
Ascend-History-Weigh-Type (239)
Ascend-Inc-Channel-Count (236)
Ascend-Maximum-Channels (235)
Ascend-Minimum-Channels (173)
Ascend-Remove-Seconds (241)
Ascend-Seconds-Of-History (238)
Ascend-Target-Util (234)

Ascend-DHCP-Maximum-Leases

Description: The Ascend-DHCP-Maximum-Leases attribute specifies the maximum number of dynamic addresses the MAX can assign to Network Address Translation (NAT) for LAN clients using this connection.

Usage: Specify a value between 1 and 254. The default is 4.

See Also: Ascend-DHCP-Pool-Number (148)
Ascend-DHCP-Reply (147)

Ascend-DHCP-Pool-Number (148)

Description: The Ascend-DHCP-Pool-Number attribute indicates the address pool from which the MAX assigns a dynamic IP address to the Dynamic Host Configuration Protocol (DHCP) client.

Usage: Specify an integer between 1 and the number of address pools defined on the MAX. The default value is 0 (zero), which specifies that the MAX uses the first defined IP address pool.

Dependencies: When the DHCP client requests an address, the MAX allocates an IP address from one of its IP address pools and assigns it to the client for 30 minutes. The client must renew the IP address assignment after the 30-minute period expires.

In its local memory, the MAX keeps track of all the IP addresses it has assigned. Therefore, it loses the entries for current, unexpired IP address assignments when you reset it. If a client holds an unexpired IP address assignment when you reset the MAX, the MAX may assign the same address to a new client. These duplicate IP addresses cause network problems until the first assignment expires or one of the clients reboots.

See Also: Ascend-DHCP-Maximum-Leases
Ascend-DHCP-Reply (147)

Ascend-DHCP-Reply (147)

Description: The Ascend-DHCP-Reply attribute specifies whether the MAX processes DHCP packets and acts as a DHCP server on this connection.

Usage: You can specify one of these settings:

See Also: Ascend-DHCP-Maximum-Leases
Ascend-DHCP-Pool-Number (148)

Ascend-Dialout-Allowed (131)

Description: The Ascend-Dialout-Allowed attribute specifies whether the user associated with an outgoing RADIUS user profile can dial out using one of the MAX unit's digital modems.

Usage: You can specify one of these settings:

Ascend-Dial-Number (227)

Description: The Ascend-Dial-Number attribute specifies the phone number the MAX dials to reach the bridge, router, or node at the remote end of the link.

Usage: Specify a telephone number. You can enter up to 21 characters, and you must limit those characters to the following:

1234567890()[]!z-*#|
The MAX sends only the numeric characters to place a call. The default value is null.

If Use Trunk Grps=Yes in the System\>Sys Config menu, the first digits in the Ascend-Dial-Number attribute have the meanings listed in Table 9-11.

Table 9-11. Ascend-Dial-Number digits

Digit

Explanation

First digit is between 4 and 9.

The MAX places the call over the corresponding trunk group listed in the Ch n Trnk Grp, B1 Trnk Grp, or B2 Trnk Grp parameters in the Line profile.

If Dial Plan=Trunk Grp, the digits following the first digit constitute an ordinary phone number.

If Dial Plan=Extended, the next two digits specify the Dial Plan profile containing the parameters the MAX uses when making the call. These parameters constitute the extended dial plan. An ordinary phone number follows these two digits.

First digit is 3.

The MAX places the call to a destination listed in a Destination profile. In this case, the second and third digits indicate the number of the Destination profile.

First digit is 2.

The MAX places the call between host ports on the same MAX, or between Terminal Equipment (TEs) on a local ISDN BRI line on the same MAX. The first type of call is a port-to-port call. The latter type of call is a TE-to-TE call. In a port-to-port call, the second digit indicates the slot of an AIM/6 module. In a TE-to-TE call, the second digit indicates the slot of a Host/BRI module.

If you enter 0 (zero) for the second digit, the call connects to any available AIM port and ignores the third digit. If you enter a nonzero value for the second digit, the third digit selects the AIM port (for a port-to-port call) or a local ISDN BRI port (for a TE-to-TE call).

If you enter 0 (zero) for the third digit, the call connects to any available AIM port or local ISDN BRI line in the module selected by the second digit.

Ascend-Disconnect-Cause (195)

Description: The Ascend-Disconnect-Cause attribute specifies the reason a connection was taken offline.

The MAX includes Ascend-Disconnect-Cause in an Accounting-Request packet when both of these conditions are true:

Usage: Ascend-Disconnect-Cause can return any of the values listed in Table 9-12.

Table 9-12. Ascend-Disconnect-Cause codes

Code

Description

0

No reason.

1

The event was not a disconnect.

2

The reason for the disconnect is unknown. This code can appear when the remote connection goes down.

3

The call has disconnected.

4

CLID authentication has failed.

These codes can appear if a disconnect occurs during the initial modem connection.

10

The modem never detected DCD.

11

The modem detected DCD, but became inactive.

12

The result codes could not be parsed.

These codes are related to immediate Telnet and raw TCP disconnects during a terminal server session.

20

The user exited normally from the terminal server.

21

The user exited from the terminal server because the idle timer expired.

22

The user exited normally from a Telnet session.

23

The user could not switch to SLIP or PPP because the remote host had no IP address or because the dynamic pool could not assign one.

24

The user exited normally from a raw TCP session.

25

The login process ended because the user failed to enter a correct password after three attempts.

26

The raw TCP option is not enabled.

27

The login process ended because the user typed Ctrl-C.

28

The terminal server session has ended.

29

The user closed the virtual connection

30

The virtual connection has ended.

31

The user exited normally from an Rlogin session

32

The user selected an invalid Rlogin option.

33

The MAX has insufficient resources for the terminal server session.

These codes concern PPP connections.

40

PPP LCP negotiation timed out while waiting for a response from a peer.

41

There was a failure to converge on PPP LCP negotiations.

42

PPP PAP authentication failed.

43

PPP CHAP authentication failed.

44

Authentication failed from the remote server.

45

The peer sent a PPP Terminate Request.

46

LCP got a close request from the upper layer while LCP was in an open state.

47

LCP closed because no NCPs were open.

48

LCP closed because it could not determine to which MP bundle it should add the user.

49

LCP closed because the MAX could not add any more channels to an MP session.

These codes are related to immediate Telnet and raw TCP disconnects, and contain more specific information than the Telnet and TCP codes listed earlier in this table.

50

The Raw TCP or Telnet internal session tables are full.

51

Internal resources are full.

52

The IP address for the Telnet host is invalid.

53

The MAX could not resolve the hostname.

54

The MAX detected a bad or missing port number.

The TCP stack can return these disconnect codes during an immediate Telnet or raw TCP session.

60

The host reset the TCP connection.

61

The host refused the TCP connection.

62

The TCP connection timed out.

63

A foreign host closed the TCP connection.

64

The TCP network was unreachable.

65

The TCP host was unreachable.

66

The TCP network was administratively unreachable.

67

The TCP host was administratively unreachable.

68

The TCP port was unreachable.

These are additional disconnect codes.

100

The session timed out because there was no activity on a PPP link.

101

The session failed for security reasons.

102

The session ended for callback.

120

One end refused the call because the protocol was disabled or
unsupported.

150

RADIUS requested the disconnect.

160

The allowed retries for V.110 synchronization have been exceeded.

170

PPP authentication has timed out.

180

The call disconnected as the result of a local hangup.

185

The call disconnected because the remote end hung up.

190

The call disconnected because the T1 line that carried it was quiesced.

195

The call disconnected because the call duration exceeded the maximum amount of time allowed by the Max Call Mins or Max DS0 Mins parameter on the MAX.

Ascend-Event-Type (150)

Description: The Ascend-Event-Type attribute indicates a coldstart notification, informing the accounting server that the MAX has started up, or a session event, informing the authentication server that a session has begun.

In a coldstart notification, the MAX sends values for NAS-Identifier, Ascend-Event-Type, and Ascend-Number-Sessions in an Ascend-Event-Request packet (code 33). The RADIUS accounting server must send back an Ascend-Event-Response packet (code 34) with the correct identifier to the MAX.

In a session event, the MAX sends values for Password, NAS-Identifier, Ascend-Event-Type, and Ascend-Number-Sessions in an Ascend-Event-Request packet (code 33) when Auth=RADIUS/LOGOUT in Ethernet>Mod Config>Auth. The authentication server must send back an Ascend-Event-Response packet (code 34) with the correct identifier to the MAX.

Usage: For a coldstart notification, Ascend-Event-Type=Ascend-Coldstart (1). For a session event, Ascend-Event-Type=Ascend-Session-Event (2)

See Also: Ascend-Number-Sessions (202)
NAS-Identifier (4)

Ascend-Expect-Callback (149)

Description: The Ascend-Expect-Callback attribute specifies whether a user dialing out should expect the remote end to call back.

When the remote device is set to call back (Ascend-Callback=Callback-Yes or Callback=Yes) and CLID authentication is not required, the remote device answers the call, verifies a name and password against a user profile, hangs up, and dials back to the caller using these values:

If the remote RADIUS user profile is set up for callback, and the remote unit requires CLID-only authentication (Id Auth=Require), the remote device never answers the call. The caller can therefore avoid billing charges. However, a problem can also occur. To the caller, it appears as though the call never got through at all. This is a special problem for Ping and Telnet, because these processes continuously try to open a connection and reject any callback.

When you set Ascend-Expect-Callback=Expect-Callback-Yes, calls that dial out and do not connect (for any reason) appear on a list that disallows any further calls to that destination for 90 seconds. This delay gives the remote device an opportunity to complete the callback.

Usage: You can specify one of these values:

See Also: Ascend-Callback (246)

Ascend-First-Dest (189)

Description: The Ascend-First-Dest attribute records the destination IP address of the first packet the MAX receives on a link after RADIUS authenticates the connection.

The MAX includes Ascend-First-Dest in an Accounting-Request packet when all of these conditions are true:

Usage: Ascend-First-Dest does not appear in a user profile and has no default value.

Dependencies: This attribute only applies if the session routes IP.

Ascend-Force-56 (248)

Description: The Ascend-Force-56 attribute specifies whether the MAX uses only the 56-kbps portion of a channel, even when all 64 kbps appear to be available:

Usage: You can specify one of these values:

Ascend-FR-Circuit-Name (156)

Description: The Ascend-FR-Circuit-Name attribute specifies the Permanent Virtual Connection (PVC) for which the user profile is an endpoint. A circuit specification defines two DLCI endpoints of a PVC, with one endpoint specified in each RADIUS user profile or Connection profile.

Usage: Specify a text string containing up to 15 characters. The default value is null.

Dependencies: Keep this additional information in mind:

See Also: Ascend-FR-Direct (219)

Ascend-FR-DCE-N392 (162)

Description: The Ascend-FR-DCE-N392 attribute specifies the number of errors during Ascend-FR-DCE-N393-monitored events that cause the network side to declare the user side's procedures inactive.

Usage: Specify an integer between 1 and 10. The default value is 3.

Dependencies: Keep this additional information in mind:

See Also: Ascend-FR-DCE-N393 (164)
Ascend-FR-Type (159)

Ascend-FR-DCE-N393 (164)

Description: The Ascend-FR-DCE-N393 attribute indicates the DCE-monitored event count. The MAX always considers a link active if the value of Ascend-FR-DCE-N393 is not reached.

Usage: Specify a number between 1 and 10. The default value is 4.

Dependencies: This attribute does not apply if Ascend-FR-Type=Ascend-FR-DTE.

See Also: Ascend-FR-Type (159)

Ascend-FR-Direct (219)

Description: The Ascend-FR-Direct attribute specifies whether the MAX uses a redirect connection for Frame Relay packets.

When the MAX receives IP packets from a caller that has a redirect specified in its local Connection profile or RADIUS user profile, it simply forwards the data stream out to the Frame Relay switch using the specified DLCI, effectively passing on the responsibility of routing those packets to a later hop on the Frame Relay network. The MAX never examines the destination address of redirect packets. This feature enables you to accept traffic from one link and send all traffic to a predetermined destination, eliminating any user concerns over security.

Usage: You can specify one of these values:

See Also: Ascend-FR-Direct-DLCI (221)
Ascend-FR-DLCI (179)

Ascend-FR-Direct-DLCI (221)

Description: The Ascend-FR-Direct-DLCI attribute specifies the Data Link Connection Indicator (DLCI) for the user profile in a Frame Relay redirect connection. The DLCI identifies the user profile to the Frame Relay switch as a logical link on a physical circuit.

Usage: Specify an integer between 16 and 991. The default value is 16. Many redirect connections can use the same DLCI.

Dependencies: Ascend-FR-Direct-DLCI applies only if Ascend-FR-Direct=FR-Direct-Yes.

Example: This portion of a user profile shows a redirect connection that uses DLCI 21 and the Frame Relay profile called Montgomery.

Permconn-MAX-1 Password="Ascend", User-Service=Dialout-Framed-User
        User-Name="Matt",
        Ascend-FR-Direct=FR-Direct-Yes,
        Ascend-FR-Direct-Profile="Montgomery",
        Ascend-FR-Direct-DLCI=21,
        Metric=2,
        ...
See Also: Ascend-FR-Direct (219)
Ascend-FR-Direct-Profile (220)

Ascend-FR-Direct-Profile (220)

Description: The Ascend-FR-Direct-Profile attribute specifies the name of the Frame Relay profile that carries the redirect connection.

Usage: Indicate the name of a Frame Relay profile that connects to the Frame Relay switch handling the Data Link Connection Indicator (DLCI) specified by Ascend-FR-Direct-DLCI. You can specify up to 15 alphanumeric characters. The default value is null. Make sure that you enter the name exactly as it appears in the Name parameter of the Frame Relay profile.

Dependencies: Ascend-FR-Direct-Profile applies only if Ascend-FR-Direct=FR-Direct-Yes.

Example: This portion of a user profile shows a redirect connection that uses DLCI 21 and the Frame Relay profile called Montgomery.

Permconn-MAX-1 Password="Ascend", User-Service=Dialout-Framed-User
        User-Name="Matt",
        Ascend-FR-Direct=FR-Direct-Yes,
        Ascend-FR-Direct-Profile="Montgomery",
        Ascend-FR-Direct-DLCI=21,
        Metric=2,
        ...
See Also: Ascend-FR-Direct (219)
Ascend-FR-Direct-DLCI (221)

Ascend-FR-DLCI (179)

Description: The Ascend-FR-DLCI attribute specifies the Data Link Connection Indicator (DLCI) for the user profile in a Frame Relay gateway connection. The DLCI identifies the user profile to the Frame Relay switch as a logical link on a physical circuit.

Usage: Specify an integer between 16 and 991. The default value is 16. You must assign each gateway connection its own DLCI.

Dependencies: Ascend-FR-DLCI applies only if Ascend-FR-Direct=FR-Direct-No.

Example: This portion of a user profile shows a gateway connection that uses DLCI 21 and the Frame Relay profile called Florence.

Permconn-MAX-1 Password="Ascend", User-Service=Dialout-Framed-User
        User-Name="Matt",
Ascend-FR-Direct=FR-Direct-No,
Ascend-FR-Profile-Name="Florence",
Ascend-FR-DLCI=21,
Metric=2,
...
See Also: Ascend-FR-Direct (219)
Ascend-FR-Profile-Name (180)

Ascend-FR-DTE-N392 (163)

Description: The Ascend-FR-DTE-N392 attribute specifies the number of errors during Ascend-FR-DTE-N393-monitored events that cause the user side to declare the network side's procedures inactive.

Usage: Specify an integer between 1 and 10. The default value is 3.

Dependencies: Keep this additional information in mind:

See Also: Ascend-FR-DTE-N393 (165)
Ascend-FR-Type (159)

Ascend-FR-DTE-N393 (165)

Description: The Ascend-FR-DTE-N393 attribute indicates the DTE-monitored event count. The MAX always considers a link active if the value of Ascend-FR-DTE-N393 is not reached.

Usage: Specify a number between 1 and 10. The default value is 4.

Dependencies: This attribute does not apply if Ascend-FR-Type=Ascend-FR-DCE.

See Also: Ascend-FR-Type (159)

Ascend-FR-Link-Mgt (160)

Description: In a Frame Relay profile, the Ascend-FR-Link Mgt attribute specifies the link management protocol in use between the MAX and the Frame Relay switch.

Usage: You can specify one of these values:

Ascend-FR-LinkUp (157)

Description: In a Frame Relay profile, the Ascend-FR-LinkUp attribute specifies whether the Frame Relay link comes up automatically.

Usage: You can specify one of these values:

Dependencies: You can start and drop Frame Relay connections by using the DO DIAL and DO HANGUP commands. DO DIAL brings up a connection. DO HANGUP closes the link and any DLCIs on it. If Ascend-FR-LinkUp=Ascend-LinkUp-AlwaysUp, DO HANGUP brings the link down, but the link automatically restarts. A restart also occurs if a DLCI brings up the datalink.

Ascend-FR-N391 (161)

Description: In a Frame Relay profile, the Ascend-FR-N391 attribute specifies the interval in seconds at which the MAX requests a Full Status Report.

If you configure the Frame Relay link for link management, it regularly request updates on the status of the link. The Frame Relay unit at the other end of the link must respond to these requests. Otherwise, the MAX considers the link inactive. Furthermore, if the response to these requests indicates a DLCI failure, the MAX considers the link inactive.

Usage: Specify an integer between 1 and 255. The default value is 6.

Dependencies: This attribute does not apply if Ascend-FR-Type=Ascend-FR-DCE.

See Also: Ascend-FR-Type (159)

Ascend-FR-Nailed-Grp (158)

Description: The Ascend-FR-Nailed-Grp attribute associates a group of nailed-up channels with the Frame Relay profile.

Usage: Specify a number between 1 and the maximum number of nailed-up channels that your MAX allows. The default value is 1.

Dependencies: Do not associate a group with more than one active Frame Relay profile.

Ascend-FR-Profile-Name (180)

Description: The Ascend-FR-Profile-Name attribute specifies the name of the Frame Relay profile that carries the gateway connection.

Usage: Indicate the name of a Frame Relay profile that connects to the Frame Relay switch handling the Data Link Connection Indicator (DLCI) specified by Ascend-FR-DLCI. You can specify up to 15 alphanumeric characters. The default value is null. Make sure that you enter the name exactly as it appears in the Name parameter of the Frame Relay profile.

Dependencies: Ascend-FR-Profile-Name applies only if Ascend-FR-Direct=FR-Direct-No.

Example: This portion of a user profile shows a gateway connection that uses DLCI 21 and the Frame Relay profile called Florence.

Permconn-MAX-1 Password="Ascend", User-Service=Dialout-Framed-User
        User-Name="Matt",
        Ascend-FR-Direct=FR-Direct-No,
        Ascend-FR-Profile-Name="Florence",
        Ascend-FR-DLCI=21,
        Metric=2,
        ...
See Also: Ascend-FR-Direct (219)
Ascend-FR-DLCI (179)

Ascend-FR-T391 (166)

Description: The Ascend-FR-T391 attribute indicates the Link Integrity Verification polling timer.

Usage: You can specify a number of seconds between 5 and 30. The default value is 10.

Dependencies: This attribute does not apply if Ascend-FR-Type=Ascend-FR-DCE.

See Also: Ascend-FR-Type (159)

Ascend-FR-T392 (167)

Description: The Ascend-FR-T392 attribute indicates the timer for the verification of the polling cycle- the length of time the unit should wait between Status Enquiry messages. The MAX records an error if it does not receive a Status Enquiry within the number seconds this attribute specifies.

Usage: Specify a number of seconds between 5 and 30. The default value is 10.

Dependencies: This attribute does not apply if Ascend-FR-Type=Ascend-FR-DTE.

See Also: Ascend-FR-Type (159)

Ascend-FR-Type (159)

Description: The Ascend-FR-Type attribute specifies the type of Frame Relay connection the Frame Relay profile uses.

Usage: You can specify one of these values:

Ascend-FT1-Caller (175)

Description: The Ascend-FT1-Caller attribute specifies whether the MAX initiates an FT1- AIM or an FT1-B&O call, or whether it waits for the remote end to initiate these types of calls.

Usage: You can specify one of these values:

Dependencies: Keep this additional information in mind:

Ascend-Group (178)

Description: The Ascend-Group attribute points to the nailed-up channels the profile's WAN link uses.

If you set the Ascend-Group attribute to a value that matches the settings of a Ch n Prt/Grp, B1 Prt/Grp, or B2 Prt/Grp parameter in a Line profile, the MAX uses the specified channels for this profile's link across the WAN. Similarly, if Ascend-Group has the same value as Nailed Grp in the Serial WAN profile, the MAX uses the serial WAN circuit for this profile's link.

Usage: Your usage depends upon the value you specify for the Ascend-Call-Type attribute:

Dependencies: Keep this additional information in mind:

Example: If Ascend-Call-Type=Nailed/Mpp, setting the Ascend-Group attribute to "1,3,5,7" assigns four nailed-up groups to the profile.

Ascend-Handle-IPX (222)

Description: The Ascend-Handle-IPX attribute specifies how the MAX handles NCP watchdog requests on behalf of IPX clients during IPX bridging.

Usage: You can specify one of these values:

Dependencies: Keep this additional information in mind:

Example: This user profile specifies an IPX bridging link in which the local Ethernet supports NetWare clients, and the remote network supports both NetWare servers and clients:

MAX1 Password="m2dan", User-Service=Framed-User

Framed-Protocol=PPP,

Ascend-Route-IPX=Route-IPX-No,

Ascend-Bridge=Bridge-Yes,

     Ascend-Handle-IPX=Handle-IPX-Client,
Ascend-Netware-timeout=30

See Also: Ascend-Bridge (230)
Ascend-Netware-timeout (223)

Ascend-History-Weigh-Type (239)

Description: The Ascend-History-Weigh-Type attribute specifies which Dynamic Bandwidth Allocation (DBA) algorithm to use for calculating average line utilization (ALU) of transmitted data. DBA enables you to specify that the MAX uses ALU as the basis for automatically adding or subtracting bandwidth from a switched connection without terminating the link.

Usage: Figure 9-1 illustrates the differences among the algorithms you can choose.

Figure 9-1. Bandwidth algorithms for MP+ calls

See Also: Ascend-Add-Seconds (240)
Ascend-Base-Channel-Count (172)
Ascend-DBA-Monitor (171)
Ascend-Dec-Channel-Count (237)
Ascend-Inc-Channel-Count (236)
Ascend-Maximum-Channels (235)
Ascend-Minimum-Channels (173)
Ascend-Remove-Seconds (241)
Ascend-Seconds-Of-History (238)
Ascend-Target-Util (234)

Ascend-Home-Agent-IP-Addr

Description: Indicates the IP address of the home agent used for this mobile ATMP client in a RADIUS Stop record.

Example: The following is an example of a RADIUS accounting STOP record that includes the Ascend-Home-Agent-IP-Addr attribute:

Mon Apr 21 02:41:38 1997
User-Name = "JacobP75"
NAS-Identifier = 1.1.1.1
NAS-Port = 10105
Acct-Status-Type = Stop
Acct-Delay-Time = 0
Acct-Session-Id = "111111111"
Acct-Authentic = RADIUS
Acct-Session-Time = 0
Acct-Input-Octets = 215
Acct-Output-Octets = 208
Acct-Input-Packets = 10
Acct-Output-Packets = 10
Ascend-Disconnect-Cause = 1
Ascend-Connect-Progress = 60
Ascend-Data-Rate = 56000
Ascend-PreSession-Time = 1
Ascend-Pre-Input-Octets = 215
Ascend-Pre-Output-Octets = 208
Ascend-Pre-Input-Packets = 10
Ascend-Pre-Output-Packets = 10
Framed-Protocol = PPP
Framed-Address = 2.2.2.2
Tunneling-Protocol = ATMP
Ascend-Home-Agent-IP-Addr = 3.3.3.3
Ascend-Home-Agent-UDP-Port = 5150
Ascend-Home-Network-Name = homenet
Dependencies: Accounting-Request packets, generated by the foreign agent, send the Ascend-Home-Agent-IP-Addr attribute at the end of a session, under the following conditions:

Ascend-Home-Agent-Password (184)

Description: In a mobile node's RADIUS user profile, the Ascend-Home-Agent-Password attribute specifies the password that the foreign agent sends to the home agent in order to authenticate itself during Ascend Tunnel Management Protocol (ATMP) operation. This password must match the value of the Password parameter in Ethernet>Mod Config>ATMP Options menu for the home agent. All mobile nodes accessing a single home agent must specify the same password.

The RADIUS server passes the attributes in the mobile node's RADIUS user profile to the foreign agent. The foreign agent sends these attributes when connecting with the home agent.

A mobile node can also connect directly to the home agent. An ATMP-based RADIUS profile that is local to the home agent enables the mobile node to bypass a foreign agent connection, but does not preclude a foreign agent. If both the home agent and the foreign agent have local RADIUS profiles for the mobile node, the node can choose between a direct connection or a tunneled connection through the foreign agent.

Usage: Specify a text string containing up to 20 characters. The default value is null.

Example: The following RADIUS profile authenticates a mobile NetWare client that connects directly to the home agent. In this example, the home agent is in gateway mode. It forwards packets from the mobile node across a nailed-up WAN link to the home IPX network.

Mobile-IPX Password="unit"
     User-Service=Framed-User,
     Ascend-Route-IPX=Route-IPX-Yes,
     Framed-Protocol=PPP,
     Ascend-IPX-Peer-Mode=IPX-Peer-Dialin,
     Framed-IPX-Network=40000000,
     Ascend-IPX-Node-Addr=12345678,
     Ascend-Primary-Home-Agent="max1.home.com:6001",
     Ascend-Secondary-Home-Agent="max2.home.com:6001",
     Ascend-Home-Network-Name="Dave's MAX",
     Ascend-Home-Agent-Password="Pipeline"
See Also: Ascend-Home-Agent-UDP-Port (186)
Ascend-Home-Network-Name (185)
Ascend-Primary-Home-Agent (129)
Ascend-Secondary-Home-Agent (130)

Ascend-Home-Agent-UDP-Port (186)

Description: In a mobile node's RADIUS user profile, the Ascend-Home-Agent-UDP-Port attribute specifies the UDP port number on the home agent to which the foreign agent directs Ascend Tunnel Management Protocol (ATMP) messages.

Usage: Specify a UDP port number between 0 and 65535. The default value is 5150.

Dependencies: If you specify a value for the udp_port argument of Ascend-Primary-Home- Agent or Ascend-Secondary-Home-Agent, or if you accept the default of 5150 for udp_port, you need not specify the Ascend-Home-Agent-UDP-Port attribute.

See Also: Ascend-Home-Agent-Password (184)
Ascend-Home-Network-Name (185)
Ascend-Primary-Home-Agent (129)
Ascend-Secondary-Home-Agent (130)

Ascend-Home-Network-Name (185)

Description: In a mobile node's RADIUS user profile, the Ascend-Home-Network-Name attribute specifies the name of the Connection profile on which the home agent sends all packets it receives from the mobile node during Ascend Tunnel Management Protocol (ATMP) operation.

The RADIUS server passes the attributes in the mobile node's RADIUS user profile to the foreign agent. The foreign agent sends these attributes when connecting with the home agent.

A mobile node can also connect directly to the home agent. An ATMP-based RADIUS profile that is local to the home agent enables the mobile node to bypass a foreign agent connection, but does not preclude a foreign agent. If both the home agent and the foreign agent have local RADIUS profiles for the mobile node, the node can choose between a direct connection or a tunneled connection through the foreign agent.

Usage: Specify the name of the home agent's Connection profile. The default value is null.

Dependencies: You must specify a value for this attribute only if the home agent is a gateway (that is, only if Type=Gateway in the Ethernet>Mod Config>ATMP Options menu).

Example: The following RADIUS profile authenticates a mobile NetWare client that connects directly to the home agent. In this example, the home agent is in gateway mode. It forwards packets from the mobile node across a nailed-up WAN link to the home IPX network.

Mobile-IPX Password="unit"
     User-Service=Framed-User,
     Ascend-Route-IPX=Route-IPX-Yes,
     Framed-Protocol=PPP,
     Ascend-IPX-Peer-Mode=IPX-Peer-Dialin,
     Framed-IPX-Network=40000000,
     Ascend-IPX-Node-Addr=12345678,
     Ascend-Primary-Home-Agent="max1.home.com:6001",
     Ascend-Secondary-Home-Agent="max2.home.com:6001",
     Ascend-Home-Network-Name="Dave's MAX",
     Ascend-Home-Agent-Password="Pipeline"
See Also: Ascend-Home-Agent-Password (184)
Ascend-Home-Agent-UDP-Port (186)
Ascend-Primary-Home-Agent (129)
Ascend-Secondary-Home-Agent (130)

Ascend-Host-Info (252)

Description: The Ascend-Host-Info attribute specifies a list of hosts to which a user can establish a Telnet session.

Usage: You can specify up to 10 Ascend-Host-Info entries in a user profile. Enter your attribute settings in this format:

Ascend-Host-Info="IP_address text"
Dependencies: If you specify a value for the Ascend-Host-Info attribute, you must also make these settings in the Ethernet>Mod Config>TServ Options menu:

Example: Here is an example for a MAX named Cal:

Initial-Banner-Cal Password="Ascend", User-Service=Dialout-Framed-User

     Reply-Message="Up to 16 lines of up to 80 characters each",
     Reply-Message="will be accepted. Long lines will be 
truncated",
     Reply-Message="Additional lines will be ignored.",
     Reply-Message="",
Ascend-Host-Info="1.2.3.4 Berkeley",

Ascend-Host-Info="1.2.3.5 Alameda",

Ascend-Host-Info="1.2.36 San Francisco",

...

See Also: Reply-Message (18)

Ascend-Idle-Limit (244)

Description: The Ascend-Idle-Limit attribute specifies the number of seconds the MAX waits before clearing a call when a session is inactive.

Usage: Specify a number between 0 and 65535. If you specify 0 (zero), the MAX always clears a call when a session is inactive. The default value is 120 seconds. If you accept the default and an existing Answer profile specifies a value for the analogous Idle parameter, the MAX ignores the Idle value and uses the Ascend-Idle-Limit default.

Dependencies: Keep this additional information in mind:

See Also: Ascend-MPP-Idle-Percent (254)
Ascend-Preempt-Limit (245)

Ascend-IF-Netmask (154)

Description: The Ascend-IF-Netmask attribute specifies the subnet mask in use for the local numbered interface.

Usage: Specify a subnet mask consisting of four numbers between 0 and 255, separated by periods. The default value is 0.0.0.0.

Ascend-Inc-Channel-Count (236)

Description: The Ascend-Inc-Channel-Count attribute specifies the number of channels the MAX adds when bandwidth changes either manually or automatically during a call.

Usage: Specify a number between 1 and 32. The default value is 1.

Dependencies: Keep this additional information in mind:

See Also: Ascend-Add-Seconds (240)
Ascend-Base-Channel-Count (172)
Ascend-DBA-Monitor (171)
Ascend-Dec-Channel-Count (237)
Ascend-History-Weigh-Type (239)
Ascend-Maximum-Channels (235)
Ascend-Minimum-Channels (173)
Ascend-Remove-Seconds (241)
Ascend-Seconds-Of-History (238)
Ascend-Target-Util (234)

Ascend-IP-Direct (209)

Description: The Ascend-IP-Direct attribute specifies the IP address to which the MAX redirects packets from the user. When you include this attribute in a user profile, the MAX bypasses all internal routing and bridging tables, and simply sends all packets it receives on this connection's WAN interface to the specified IP address. Ascend-IP-Direct does not affect packets users send to this connection.

Usage: Specify an IP address in dotted decimal notation. An IP address consists of four numbers between 0 and 255, separated by periods. The default value is 0.0.0.0. If you accept the default, the MAX does not redirect IP traffic.

Dependencies: Keep this additional information in mind:

Example: This user profile specifies that the MAX redirects incoming packets to the host at IP address 10.2.3.11:

Emma Password="m2dan", User-Service=Framed-User
          Framed-Protocol=PPP,
          Framed-Address=10.8.9.10,
Framed-Netmask=255.255.252.0,

          Ascend-Route-IP=Route-IP-Yes,
          Ascend-Bridge=Bridge-No,
          Ascend-IP-Direct=10.2.3.11,
          Ascend-Metric=2,
          Framed-Routing=None,
          ...
See Also: Framed-Routing (10)

Ascend-IP-Pool-Definition (217)

Description: The Ascend-IP-Pool-Definition attribute specifies the first IP address in a MAX- specific IP address pool, and indicates the number of addresses in the pool.

Usage: The Ascend-IP-Pool-Definition attribute has this format:

Ascend-IP-Pool-Definition="num first_ipaddr max_entries"
Table 9-13 describes each Ascend-IP-Pool-Definition argument.

Table 9-13. Ascend-IP-Pool-Definition arguments

Argument

Description

num

Indicates the number of the pool. The default value is 1.

Specify pool numbers starting with 1, unless you have defined pools in the MAX interface using the Pool #n Start and Pool #n Count parameters and do not wish to override these settings. In this case, for the num argument, specify the highest number of an address pool on the MAX + 1.

For example, if you have set up address pools 1 through 5 on the MAX, specify pool numbers starting with 6 in RADIUS.

first_ipaddr

Specifies the first IP address in the address pool. The address you indicate should not accept a subnet mask, because it always becomes a host route. The default value is 0.0.0.0.

max_entries

Specifies the maximum number of IP addresses in the pool. The MAX assigns addresses sequentially, from first_ipaddr on, up to the limit of addresses specified by max_entries. The default value is 0 (zero).

Dependencies: You specify one or more Ascend-IP-Pool-Definition attributes in a pseudo- user profile. You create a pseudo-user to store information that the MAX can query-in this case, in order to store IP address pool information. Specify the first line of a pseudo-user profile in this format:

Pools-unit_name Password="Ascend", User-Service=Dialout-Framed-User
unit_name is the system name of the MAX-that is, the name specified by the Name parameter in the System profile. On the next lines of the profile, specify one or more Ascend-IP-Pool-Definition attributes.

Example: In this example, the pseudo-user profile creates two IP address pools for the MAX to use. Address pool #1 contains a block of 7 IP addresses from 10.1.0.1 to 10.1.0.7. Address pool #2 contains a block of 48 IP addresses from 10.2.0.1 to 10.2.0.48.

Pools-MAX Password="Ascend", User-Service=Dialout-Framed-User
    Ascend-IP-Pool-Definition="1 10.1.0.1 7",
    Ascend-IP-Pool-Definition="2 10.2.0.1 48"
See Also: Ascend-Assign-IP-Pool (218)

Ascend-IPX-Alias (224)

Description: The Ascend-IPX-Alias attribute specifies an IPX network number to use when connecting to IPX routers that require numbered interfaces.

Usage: Specify an IPX network number. The default value is 0 (zero). RADIUS requires that this attribute have a decimal value (base 10), but IPX network numbers generally have hexadecimal values (base 16). In order to give this attribute a value, you must convert the hexadecimal IPX network number to a decimal value for use in the user profile.

See Also: Ascend-IPX-Peer-Mode (216)
Ascend-IPX-Route (174)
Ascend-Route-IPX (229)

Ascend-IPX-Node-Addr (182)

Description: The Ascend-IPX-Node-Addr attribute specifies a unique IPX node address on the network specified by Framed-IPX-Network. This value completes the IPX address of a mobile node.

Usage: Specify a 12-digit ASCII string enclosed in double-quotes. The RADIUS server passes the attributes in the mobile node's profile to the foreign agent. The foreign agent sends these attributes when connecting with the home agent.

See Also: Framed-IPX-Network (23)

Ascend-IPX-Peer-Mode (216)

Description: The Ascend-IPX-Peer-Mode attribute specifies whether the caller is a dial-in PPP client or an Ethernet client with its own IPX network address.

Dial-in clients do not belong to an IPX network, so you must assign them an IPX network number. When you do so, a dial-in client can establish a routing connection with the MAX. To provide an IPX network number, you must define a virtual IPX network using the IPX Pool# parameter in the MAX configuration interface. The MAX advertises the route to this virtual network and assigns it as the network address for dial-in clients.

Usage: For the Ascend-IPX-Peer-Mode attribute, you can specify one of these values:

See Also: Ascend-IPX-Route (174)
Ascend-Route-IPX (229)

Ascend-IPX-Route (174)

Description: The Ascend-IPX-Route attribute enables you to configure a static IPX route.

Usage: To configure a static IPX route to an internal network, use the following format:

Ascend-IPX-Route="profile_name network# [node#] [socket#] 
[server_type] [hop_count] [tick_count] [server_name]"
Table 9-14 describes each Ascend-IPX-Route argument.

Table 9-14. Ascend-IPX-Route arguments

Argument

Description

profile_name

Specifies the RADIUS user profile used to reach the network. The default value is null.

network#

Indicates the unique internal network number of the NetWare server. The default value is 00000000.

node#

Specifies the node number of the NetWare server. The default value is 0000000000001-the typical node number for a NetWare file server.

socket#

Indicates the socket number of the NetWare server. Typically, NetWare file servers use socket 0451. The default value is 0000.

The number you specify must be a well-known socket number. Services that use dynamic socket numbers may use a different socket each time they load. To bring up a connection to a remote service that uses a dynamic socket number, specify a master server that uses a well-known socket number.

server_type

Specifies the SAP service type of the NetWare server. NetWare file servers have SAP service type 0004. The default value is 0000.

hop_count

Indicates the distance to the destination network in hops. The default value is 1.

tick_count

Specifies the distance to the destination network in IBM PC clock ticks (one-eighteenth of a second). This value is for round-trip timer calculation and for determining the nearest server of a given type.The default value is 12.

server_name

Indicates the name of an IPX server. The default value is null.

When you define a static route to an external network, the Ascend-IPX-Route attribute has the following format:

Ascend-IPX-Route="route-only [network #] [transit_network #]"

Table 9-15 describes each Ascend-IPX-Route argument.

Table 9-15. Ascend-IPX-Route arguments

Argument

Description

network #

Indicates the unique external network number. The default value is 00000000.

transit_network #

Indicates an intermediate network:

  • Between the MAX and the destination network.

  • To which the MAX knows how to route.

Dependencies: Each static route must appear in a pseudo-user profile. You create a pseudo- user to store information that the MAX can query-in this case, in order to store IPX routing information. You can configure pseudo-users for both global and MAX-specific configuration control of IPX dialout routes. The MAX loads the unit-specific dialout routes in addition to the global dialout routes.

For a unit-specific IPX dialout route, specify the first line of a pseudo-user profile in this format:

IPXRoute-unit_name-num Password="Ascend", User-Service=Dialout-Framed-
User
For a global IPX dialout route, specify the first line of a pseudo-user profile in this format:

IPXRoute-num Password="Ascend", User-Service=Dialout-Framed-User
unit_name is the system name of the MAX-that is, the name specified by the Name parameter in the System profile. num is a number in a sequential series, starting at 1.

In each pseudo-user profile, you can specify one or more routes using the Ascend-IPX-Route attribute. Limit each pseudo-user profile to about 25 routes. The MAX fetches information from each pseudo-user profile in order to gather routing information. Whenever you power on or reset the MAX, or when you select the Upd Rem Cfg command from the Sys Diag menu, RADIUS adds IPX dialout routes to the routing table in this way:

  1. RADIUS looks for profiles having the format IPXRoute-unit_name-1, where
    unit_name is the system name.

  2. If at least one profile exists, RADIUS loads all existing profiles having the format
    IPXRoute-unit_name-num to initialize the IPX routing table.

    The variable num is a number in a sequential series, starting with 1.

  3. The MAX queries IPXRoute-unit_name-1, then IPXRoute-unit_name-2, and so on, until it receives an authentication reject from RADIUS.

  4. RADIUS loads the global configuration profiles.

    These configurations have the form IPXRoute-num.

  5. The MAX queries IPXRoute-1, then IPXRoute-2, and so on, until it receives an authentication reject from RADIUS.

Example: This example defines a unit-specific IPX route:

IPXRoute-CA-1 Password="Ascend", User-Service=Dialout-Framed-User
        Ascend-IPX-Route="def 6 7 8 9 10"
This example defines a global IPX route:

IPXRoute-1 Password="Ascend", User-Service=Dialout-Framed-User
        Ascend-IPX-Route="abc 1 2 3 4 5 "
See Also: Ascend-IPX-Alias (224)
Ascend-IPX-Peer-Mode (216)
Ascend-Route-IPX (229)

Ascend-Link-Compression (233)

Description: The Ascend-Link-Compression attribute turns data compression on or off for a PPP link.

Usage: You can specify one of these values:

Dependencies: Both sides of the link must set either the Ascend-Link-Compression attribute or the Link Comp parameter to turn on data compression.

See Also: Framed-Compression (13)

Ascend-Maximum-Call-Duration (125)

Description: The Ascend-Maximum-Call-Duration attribute specifies the maximum number of minutes an incoming call can remain connected.

Usage: You can specify an integer between 0 and 1440. The MAX checks the connection once per minute, so the actual time the call is connected is slightly longer than the actual time you set.

The default value is 0 (zero). If you accept the default, the MAX does not set a limit on the duration of an incoming call.

Ascend-Maximum-Channels (235)

Description: The Ascend-Maximum-Channels attribute specifies the maximum number of channels the MAX allows on an MP+ call.

Usage: Specify an integer between 1 and the maximum number of channels your system supports. The default value is 1.

Dependencies: This attribute applies only to MP+ calls.

For optimum MP+ performance, both sides of a connection must set these values to the same number:

See Also: Ascend-Add-Seconds (240)
Ascend-Base-Channel-Count (172)
Ascend-DBA-Monitor (171)
Ascend-Dec-Channel-Count (237)
Ascend-History-Weigh-Type (239)
Ascend-Inc-Channel-Count (236)
Ascend-Minimum-Channels (173)
Ascend-Remove-Seconds (241)
Ascend-Seconds-Of-History (238)
Ascend-Target-Util (234)

Ascend-Maximum-Time (194)

Description: The Ascend-Maximum-Time attribute specifies the maximum length of time in seconds that any session is allowed. Once a session reaches the time limit, its connection is taken offline.

Usage: Specify an integer between 0 and 4,294,967,295. The default value is 0 (zero). When you accept the default, the MAX does not enforce a time limit.

Ascend-Menu-Item (206)

Description: The Ascend-Menu-Item attribute defines a single terminal server menu item for a user profile. You can specify up to 20 Ascend-Menu-Item attributes per profile. The menu items display in the order in which they appear in the RADIUS profile.

Using this attribute, you can configure a profile to give the terminal server user a custom menu of items from which to choose. The server uses the custom menu to present the user with a subset of terminal server commands. The user does not have access to the regular menu or to the terminal server command line.

Usage: Enter your specifications using this format:

Ascend-Menu Item=command;text;match
By default, the MAX uses the standard terminal server menu.

Example: Suppose you set these attributes:

Emma Password="m2dan", User-Service=Login-User
      Ascend-Menu-Item="show ip stats;Display IP Stats",
      Ascend-Menu-Item="ping 1.2.3.4;Ping server",
      Ascend-Menu-Item="telnet 10.2.4.5;Telnet to Ken's machine",
      Ascend-Menu-Item="show arp;Display ARP Table",
      Ascend-Menu-Selector="                              Option:",
      ...
The terminal server displays this text:

1. Display IP Stats     3. Telnet to Ken's machine
2. Ping server          4. Display ARP Table.
                              Option:
Now, suppose you also enter specifications for the match option, as in this profile:

Emma Password="m2dan", User-Service=Login-User

Ascend-Menu-Item="show ip stats;ip=Display ip stats;ip",

Ascend-Menu-Item="ping 1.2.3.4;p=Ping server. Ctrl-C stops ping;p",

Ascend-Menu-Item="telnet 10.2.4.5;t=Telnet to Ken's machine;t",

Ascend-Menu-Item="show arp;dsp=Display arp table;dsp ",

      Ascend-Menu-Selector="                              Option:",
      ...
The terminal server displays this text:

ip=Display ip stats p=Ping server. Ctrl-C stops ping

t=Telnet to Ken's machine dsp=Display arp table

                              Option:
Note that you cannot combine numeric menu selections with pattern matching. This example shows what you should not do:

Emma Password="m2dan", User-Service=Login-User

Ascend-Menu-Item="show ip stats;ip=Display ip stats",

Ascend-Menu-Item="ping 1.2.3.4;p=Ping server. Ctrl-C stops ping;p",

Ascend-Menu-Item="telnet 10.2.4.5;t=Telnet to Ken's machine;t",

Ascend-Menu-Item="show arp;dsp=Display arp table;dsp ",

Ascend-Menu-Selector=" Option:",

...

If you mix numbered selections and pattern matching, as in this example, the terminal server screen displays the following text:

1. ip=Display ip stats 3. t=Telnet to Ken's machine

2. p=Ping server. Ctrl-C stops ping 4. dsp=Display arp table

Option:

See Also: Ascend-Menu-Selector (205)

Ascend-Menu-Selector (205)

Description: The Ascend-Menu-Selector attribute specifies a string as a prompt for user input in the terminal server menu interface.

By default, when you create a custom menu with the Ascend-Menu-Item attribute, the terminal server displays this string when prompting the user to make a selection:

Enter Selection (1-num, q) 
The num argument represents the last number in the list. The terminal server code automatically determines the value of num by determining the number of items in the menu. The only valid user input is in the range 1 through num, and q to quit.

However, you can specify a different string for prompting the user to make a selection. The Ascend-Menu-Selector attribute enables you to specify a string that the terminal server displays when prompting a user for a menu selection. If you define this attribute, its value overrides the default of Enter Selection (1-num, q).

Usage: Specify a text string containing up to 31 characters. The terminal server displays this string when prompting the user for a menu selection.

Example: Suppose you set these attributes:

Emma Password="m2dan", User-Service=Login-User
      Ascend-Menu-Item="show ip stats;Display IP Stats",
      Ascend-Menu-Item="ping 1.2.3.4;Ping server",
      Ascend-Menu-Item="telnet 10.2.4.5; Telnet to Ken's machine",
      Ascend-Menu-Item="show arp;Display ARP Table"
      Ascend-Menu-Selector="                              Option:"
The terminal server displays this text:

1. Display IP Stats     3. Telnet to Ken's machine
2. Ping server          4. Display ARP Table.
                              Option:
Note that the valid user input in this example is still 1 through 4, or q to quit.

See Also: Ascend-Menu-Item (206)

Ascend-Metric (225)

Description: The Ascend-Metric attribute enables you to specify the virtual hop count of an IP route.

If there are two routes available to a single destination network, you can ensure that the MAX uses any available nailed-up channel before using a switched channel. Simply set the Ascend-Metric attribute to a value higher than the metric of any nailed-up route. The higher the value you enter, the less likely that the MAX will bring the link online. The MAX uses the lowest metric.

Usage: You can specify a number between 1 and 15. This value is the virtual hop count. The default value is 7.

Dependencies: Keep this additional information in mind:

Example: If a route to a station takes three hops over nailed-up lines, and Ascend-Metric=4 in a user profile that reaches the same station, the MAX does not bring the user's link online. However, if the link is already online, the MAX does not use the nailed-up line.

See Also: Ascend-Route-IP (228)
Framed-Route (22)

Ascend-Minimum-Channels (173)

Description: The Ascend-Minimum-Channels attribute specifies the minimum number of channels an MP+ call maintains.

Usage: You can specify a number between 1 and 32. The default value is 1.

Dependencies: This attribute applies only to MP+ calls.

For optimum MP+ performance, both sides of a connection must set these values to the same number:

See Also: Ascend-Add-Seconds (240)
Ascend-Base-Channel-Count (172)
Ascend-DBA-Monitor (171)
Ascend-Dec-Channel-Count (237)
Ascend-History-Weigh-Type (239)
Ascend-Inc-Channel-Count (236)
Ascend-Maximum-Channels (235)
Ascend-Remove-Seconds (241)
Ascend-Seconds-Of-History (238)
Ascend-Target-Util (234)

Ascend-Modem-PortNo (120)

Description: Specifies, for inclusion in an accounting Stop record, the modem used for the call.

Usage: The MAX sends Ascend-Modem-PortNo as part of an accounting Stop record. The attribute does no appear in a user profile.

Dependencies: Because the MAX designates a modem by slot card and port, you must consider the value of Ascend-Modem-SlotNo.

See Also: Ascend-Modem-SlotNo

Ascend-Modem-SlotNo (Attribute 121)

Description: Specifies, for inclusion in an accouting Stop record, the slot containing the modem used for the call.

Usage: The MAX sends Ascend-Modem-SlotNo as part of an accounting Stip record. The attribute does not appear in a user profile.

Dependencies: Because the MAX designates a modem by slot card and port, you must consider the value of Ascend-Modem-PortNo

See Also: Ascend-Modem-PortNo

Ascend-MPP-Idle-Percent (254)

Description: The Ascend-MPP-Idle-Percent attribute specifies a percentage of bandwidth utilization below which the MAX clears a single-channel MP+ call.

Usage: Specify an integer between 0 and 99. The default value is 0 (zero). This setting causes the MAX to ignore bandwidth utilization when determining whether to clear a call.

Dependencies: Keep this additional information in mind:

See Also: Ascend-Idle-Limit (244)
Ascend-Preempt-Limit (245)

Ascend-Multicast-Client (152)

Description: The Ascend-Multicast-Client attribute specifies when the user is a multicast client of the MAX.

Usage: You can specify one of these values:

Dependencies: This attribute applies solely to the IP-only release of the MAX 4000.

See Also: Ascend-Multicast-Rate-Limit (153)

Ascend-Multicast-Rate-Limit (153)

Description: The Ascend-Multicast-Rate-Limit attribute specifies how many seconds the MAX waits before accepting another packet from a multicast client. To prevent multicast clients from creating response storms to multicast transmissions, you configure the user profile to limit the rate at which the MAX accepts packets from clients.

Usage: Specify an integer. If you set the attribute to 0 (zero), the MAX does not apply rate limiting. The default value is 100. The MAX discards any subsequent packets it receives in the window you specify.

Dependencies: This attribute applies solely to the IP-only release of the MAX 4000.

See Also: Ascend-Multicast-Client (152)

Ascend-Multilink-ID (187)

Description: The Ascend-Multilink-ID attribute specifies the ID number of the Multilink bundle when the session closes. A Multilink bundle is a multichannel MP or MP+ call. Each online channel of the MP or MP+ call is a session.

The MAX sends Ascend-Multilink-ID in an Accounting-Request packet when all of these conditions are true:

Usage: Ascend-Multilink-ID does not appear in a user profile and has no default value.

See Also: Ascend-Num-In-Multilink (188)

Ascend-Netware-timeout (223)

Description: The Ascend-Netware-Timeout attribute specifies how long in minutes the MAX responds to NCP watchdog requests on behalf of IPX clients on the other side of an offline IPX bridging connection. Responding to watchdog requests on behalf of clients is commonly called watchdog spoofing.

Usage: Specify an integer between 0 and 65535. The default value is 0 (zero). This default allows the MAX to respond to watchdog requests without a time limit.

The timer begins counting down as soon as the WAN bridging link goes offline. At the end of the selected time, the MAX releases the client-server connections. If there is a reconnection of the WAN session, the MAX cancels the timeout.

Dependencies: Ascend-Netware-timeout applies to IPX bridging connections when the MAX is on the server LAN and not on the client LAN-that is, when Ascend-Handle-IPX=
Handle-IPX-Server.

See Also: Ascend-Handle-IPX (222)

Ascend-Number-Sessions (202)

Description: The Ascend-Number-Sessions attribute specifies the number of active user sessions of a given class (as specified by the Class attribute). In the case of multichannel calls, such as MP+ calls, each separate connection counts as a session.

Usage: The Ascend-Number-Sessions attribute has a compound value. The first part specifies a user-session class. The second part reports the number of active sessions in that class.

In the MAX, you can set the Sess Timer parameter in the Ethernet>Mod Config>Accounting menu to send accounting requests at regular intervals. At the specified interval, the MAX reports the number of open sessions by sending an Ascend-Event-Request packet (code 33). This packet contains an NAS-Identifier attribute, an Ascend-Event-Type attribute, and one or more Ascend-Number-Sessions attributes. The authentication server must send back an Ascend-Event-Response packet (code 34) with the correct identifier to the MAX.

In addition, you can set the Sess Timer parameter in the Ethernet>Mod Config>Auth menu to send requests to the authentication server at regular intervals. In a session event when Auth=RADIUS/LOGOUT, the MAX sends values for Password, NAS-Identifier, Ascend-Event-Type, and Ascend-Number-Sessions in an Ascend-Event-Request packet (code 33). The authentication server must send back an Ascend-Event-Response packet (code 34) with the correct identifier to the MAX.

Dependencies: The MAX sends the Ascend-Number-Sessions attribute in Ascend-Event- Request packets. Only RADIUS daemons you customize to recognize this packet code respond these request packets from the MAX. Other daemons ignore it. Therefore, both the standard Livingston RADIUS daemon and the Ascend daemon ignore this attribute.

When modifying the daemon, make sure that it recognizes an Ascend-Event-Request packet in this format:

Code (8-bit)=33
Identifier (8-bit) 
Length (16-bit)
Authenticator (48-bit for an accounting server, 64-bit for an 
authentication server)
List of attributes
Example: Suppose that the MAX has three classes of clients: Class-1, Class-2, and Class-3. At the time of the sessions report, there are eight active sessions: three Class-1 sessions, four Class-2 sessions, and one Class-3 session. The accounting packet the MAX sends back to the RADIUS accounting server has three Ascend-Number-Session attributes, one for each of these
class/session pairs.

See Also: Ascend-Event-Type (150)
Class (25)

Ascend-Num-In-Multilink (188)

Description: The Ascend-Num-In-Multilink attribute specifies the number of sessions remaining in a Multilink bundle when the session closes. A Multilink bundle is a multichannel MP or MP+ call. Each online channel of the MP or MP+ call is a session.

The MAX sends Ascend-Num-In-Multilink in an Accounting-Request packet when all of these conditions are true:

Usage: Ascend-Num-In-Multilink does not appear in a user profile and has no default value.

See Also: Ascend-Multilink-ID (187)

Ascend-PPP-Address (253)

Description: The Ascend-PPP-Address attribute specifies the MAX unit's IP address reported to the calling unit during PPP IPCP negotiations.

Usage: Specify an IP address in dotted decimal notation. An IP address consists of four numbers between 0 and 255, separated by periods. The default value is 0.0.0.0. If you accept the default, IPCP negotiates with the value of the IP Adrs parameter in the Ethernet\>Mod Config\>Ether Options menu.

If you specify a valid IP address, IPCP negotiates with that IP address. If you specify 255.255.255.255, IPCP negotiates with the address 0.0.0.0.

Dependencies: You can assign Ascend-PPP-Address a value different from the MAX unit's true IP address, as long as the user requesting access understands that limitation.

Ascend-PPP-Async-Map (212)

Description: The Ascend-PPP-Async-Map attribute gives the Ascend PPP code the async control character map for the PPP session. The control characters pass through the PPP link as data. Only applications running over the link use this data.

Usage: Specify a 4-byte bitmap to one or more control characters. The async control character map is defined in RFC 1548 and specifies that each bit position represents its ASCII equivalent. The bits are ordered with the lowest bit of the lowest byte being 0. For example, bit 19 corresponds to Control-S (DC3) or ASCII 19.

Example: Your specification might look like this one:

Emma Password="m2dan", User-Service=Login-User
          Ascend-PPP-Async-Map=19,
          ...
The number 19 translates to 13 hex or 10011 binary. Therefore, NUL (00), SOH (01), and EOT (04) are mapped.

Ascend-PPP-VJ-1172 (211)

Description: The Ascend-PPP-VJ-1172 attribute instructs the Ascend PPP code to use the 0x0037 value for the VJ compression type. The MAX uses this value only during IPNCP negotiation. The MAX accepts incoming 1172 type options without your setting this option.

RFC 1172 section 5.2 contains an erroneous statement that the VJ compression type value is 0x0037. It should be 0x002d. However, many older PPP implementations use the 0x0037 value when negotiating VJ compression. If you do not specify a value for Ascend-PPP-VJ-1172, the VJ compression type is 0x002d.

Usage: Enter your specification using this format:

Ascend-PPP-VJ-1172=PPP-VJ-1172

Ascend-PPP-VJ-Slot-Comp (210)

Description: The Ascend-PPP-VJ-Slot-Comp attribute instructs the Ascend PPP code not to use slot compression when sending VJ-compressed packets.

When you turn on VJ compression, the MAX removes the TCP/IP header, and associates a TCP/IP packet with a connection by giving it a slot ID. The first packet coming into a connection must have a slot ID, but succeeding packets need not have one. If the packet does not have a slot ID, the MAX assumes that it uses the last slot ID. This scenario uses slot ID compression, because the slot ID does not appear in any packet but the first in a stream.

However, there may be times when you want each VJ-compressed packet to have a slot ID. The Ascend-PPP-VJ-Slot-Comp attribute exists for this purpose.

Usage: To specify that no slot compression occurs, set the Ascend-PPP-VJ-Slot-Comp attribute to VJ-Slot-Comp-No (1). If you do not specify a value for Ascend-PPP-VJ-Slot- Comp, and Framed-Compression=Van-Jacobson-TCP-IP, slot compression occurs.

See Also: Framed-Compression (13)

Ascend-Pre-Input-Octets (190)

Description: The Ascend-Pre-Input-Octets attribute indicates the number of input octets before authentication.

The MAX includes Ascend-Pre-Input-Octets in an Accounting-Request packet when all of these conditions are true:

Usage: Ascend-Pre-Input-Octets does not appear in a user profile. Its default value is 0 (zero).

Ascend-Pre-Input-packets (192)

Description: The Ascend-Pre-Input-packets attribute indicates the number of input packets before authentication.

The MAX includes Ascend-Pre-Input-packets in an Accounting-Request packet when all of these conditions are true:

Usage: Ascend-Pre-Input-packets does not appear in a user profile. Its default value is 0 (zero).

Ascend-Pre-Output-Octets (191)

Description: The Ascend-Pre-Output-Octets attribute indicates the number of output octets before authentication.

The MAX includes Ascend-Pre-Output-Octets in an Accounting-Request packet when all of these conditions are true:

Usage: Ascend-Pre-Output-Octets does not appear in a user profile. Its default value is 0 (zero).

Ascend-Pre-Output-packets (193)

Description: The Ascend-Pre-Output-packets attribute indicates the number of output packets before authentication.

The MAX includes Ascend-Pre-Output-packets in an Accounting-Request packet when all of these conditions are true:

Usage: Ascend-Pre-Output-packets does not appear in a user profile. Its default value is 0 (zero).

Ascend-Preempt-Limit (245)

Description: The Ascend-Preempt-Limit attribute specifies the number of idle seconds the MAX waits before using one of the channels of an idle link for a new call.

Usage: Specify an integer between 0 and 65535. The MAX never preempts a call if you enter 0 (zero). The default value is 60.

Dependencies: The Ascend-Preempt-Limit attribute does not apply to nailed-up links.

See Also: Ascend-Idle-Limit (244)
Ascend-MPP-Idle-Percent (254)

Ascend-Preference (126)

Description: This attribute specifies the preference for a route defined by the Framed-Address attribute in a dial-in or dial-out user profile. Every RADIUS user profile that specifies an explicit IP address using the Framed-Address attribute indicates a static route.

Usage: Specify an integer. The default value is 60. We recommend that you accept this default for dial-in and dial-out user profiles.

Dependencies: Make sure that more desirable routes have a lower preference number. In particular, make sure that routes for connections that are down have a higher preference number than routes for connections that are up. The following table lists the factory default values for route preferences.

Route type

Default value

Interface

0

ICMP

30

RIP

100

OSPF ASE

150

OSPF Internal

10

Static

60

Down-WAN

120

Infinite

225

Ascend-PreSession-Time (198)

Description: The Ascend-PreSession-Time attribute reports the length of time in seconds from when a call connected to when it completes authentication.

The MAX includes Ascend-PreSession-Time in an Accounting-Request packet when both of these conditions are true:

Usage: Ascend-PreSession-Time does not appear in a user profile. Its default value is 0 (zero).

Ascend-Primary-Home-Agent (129)

Description: The Ascend-Primary-Home-Agent attribute specifies the first home agent the foreign agent tries to reach when setting up an ATMP tunnel, and indicates the UDP port the foreign agent uses for the link.

The RADIUS server passes the attributes in the mobile node's RADIUS user profile to the foreign agent. The foreign agent sends these attributes when connecting with the home agent.

A mobile node can also connect directly to the home agent. An ATMP-based RADIUS profile that is local to the home agent enables the mobile node to bypass a foreign agent connection, but does not preclude a foreign agent. If both the home agent and the foreign agent have local RADIUS profiles for the mobile node, the node can choose between a direct connection or a tunneled connection through the foreign agent.

Usage: Specify the primary home agent using this syntax:

Ascend-Primary-Home-Agent="hostname | ip_address [:udp_port]"
Example: To specify the home agent max1.home.com at IP address 10.0.0.1, and indicate that the foreign agent should use UDP port 6001, specify one of these lines in the RADIUS user profile:

Ascend-Primary-Home-Agent="max1.home.com:6001"
Ascend-Primary-Home-Agent="10.0.0.1:6001"
The following RADIUS profile authenticates a mobile NetWare client that connects directly to the home agent. In this example, the home agent is in gateway mode. It forwards packets from the mobile node across a nailed-up WAN link to the home IPX network.

Mobile-IPX Password="unit"
     User-Service=Framed-User,
     Ascend-Route-IPX=Route-IPX-Yes,
     Framed-Protocol=PPP,
     Ascend-IPX-Peer-Mode=IPX-Peer-Dialin,
     Framed-IPX-Network=40000000,
     Ascend-IPX-Node-Addr=12345678,
     Ascend-Primary-Home-Agent="max1.home.com:6001",
     Ascend-Secondary-Home-Agent="max2.home.com:6001",
     Ascend-Home-Network-Name="Dave's MAX",
     Ascend-Home-Agent-Password="Pipeline"
Dependencies: Keep this additional information in mind:


Note: The RADIUS accounting Stop record will include Ascend-Home-Agent-IP-Addr when Ascend-Primary-Home-Agent is present in the user profile.

See Also: Ascend-Home-Agent-Password (184)
Ascend-Home-Agent-UDP-Port (186)
Ascend-Home-Network-Name (185)
Ascend-Secondary-Home-Agent (130)

Ascend-PRI-Number-Type (226)

Description: The Ascend-PRI-Number-Type attribute specifies the type of phone number the MAX dials.

Usage: You can specify one of these values:

Ascend-PW-Expiration (21)

Description: The Ascend-PW-Expiration attribute specifies an expiration date for a user's password in a user profile.

When the MAX makes an authentication request, the RADIUS server checks the current date against the value of Ascend-PW-Expiration. If the date of the authentication request is the same date or a later date than the value of Ascend-PW-Expiration, the user receives a message saying that the password has expired.

You must specify Ascend-PW-Expiration when you first create a user.

Usage: Specify a month, day, and year.

The default value is 00/00/00.

Dependencies: Keep this additional information in mind:

Example: Your specification might look like this one:

Emma Password="m2dan", User-Service=Login-User, Ascend-PW-
Expiration="January 1, 1997"
...
See Also: Ascend-PW-Lifetime (208)

Ascend-PW-Lifetime (208)

Description: The Ascend-PW-Lifetime attribute specifies the number of days that a password is valid.

Usage: Specify an integer to indicate the number of days for which the user's password is valid. You can set the Ascend-PW-Lifetime attribute on any line other than the first line of the user profile.

Dependencies: Keep this additional information in mind:

Example: You might make this specification:

Emma Password="m2dan", User-Service=Login-User, Ascend-PW-
Expiration="Jan 1, 1997"
          Ascend-PW-Lifetime=30
See Also: Ascend-PW-Expiration (21)

Ascend-Receive-Secret (215)

Description: The Ascend-Receive-Secret attribute specifies a value that must match the password that the RADIUS server sends it to your MAX from the calling unit.

Usage: You can use the Ascend-Receive-Secret attribute for CACHE-TOKEN or PAP- TOKEN-CHAP authentication. In either case, you can specify up to 20 characters. The default value is null.

Example: This example shows the settings necessary for a user called John to use an Enigma Logic server. The MAX sends the password to the security server for authentication.

John    Password="SAFEWORD", Ascend-Token-Expiry=90, Ascend-
Token-Idle=80, Ascend-Token-Immediate=Tok-Imm-Yes
            Ascend-Receive-Secret="shared-secret",
            User-Service=Framed-User,
            Framed-Protocol=MPP, 
            Framed-Address=200.0.5.1,
            Framed-Netmask=255.255.255.0
This example shows the settings necessary for a user called Emma to use an Enigma Logic server. Because this profile includes the attribute Ascend-Receive-Secret, the MAX can authenticate additional channels through CHAP without having to go to the SAFEWORD server for authentication.

Emma    Password="SAFEWORD"
            User-Service=Framed-User,
            Framed-Protocol=MPP, 
            Framed-Address=200.0.5.1,
            Framed-Netmask=255.255.255.0,
            Ascend-Receive-Secret="b5XSAM"
See Also: Ascend-Token-Expiry (204)
Ascend-Token-Idle (199)
Ascend-Token-Immediate (200)

Ascend-Remote-Addr (155)

Description: The Ascend-Remote-Addr attribute specifies the IP address of the numbered interface at the remote end of a link.

Usage: Specify the IP address of the numbered interface. An IP address consists of four numbers between 0 and 255, separated by periods. The default value is 0.0.0.0.

Dependencies: For Ascend-Remote-Addr to apply, you must enable IP for the user profile (Ascend-Route-IP=Route-IP-Yes).

See Also: Ascend-Route-IP (228)

Ascend-Remove-Seconds (241)

Description: The Ascend-Remove-Seconds attribute specifies the number of seconds that average line utilization (ALU) for transmitted data must fall below the threshold indicated by the Ascend-Target-Util attribute before the MAX begins removing bandwidth from a session. The MAX determines the ALU for a session by using the algorithm specified by the Ascend- History-Weigh-Type attribute.

When utilization falls below the threshold for a period of time greater than the value of the Ascend-Remove-Seconds attribute, the MAX attempts to remove the number of channels specified by the Ascend-Dec-Channel-Count attribute. Using the Ascend-Remove-Seconds attribute prevents the system from continually subtracting bandwidth, and can slow down the process of removing bandwidth.

Usage: Specify a number between 1 and 300. The default value is 10.

Dependencies: Keep this additional information in mind:

See Also: Ascend-Add-Seconds (240)
Ascend-Base-Channel-Count (172)
Ascend-DBA-Monitor (171)
Ascend-Dec-Channel-Count (237)
Ascend-History-Weigh-Type (239)
Ascend-Inc-Channel-Count (236)
Ascend-Maximum-Channels (235)
Ascend-Minimum-Channels (173)
Ascend-Seconds-Of-History (238)
Ascend-Target-Util (234)

Ascend-Require-Auth (201)

Description: The Ascend-Require-Auth attribute specifies whether the MAX requires additional authentication after Calling Line ID (CLID) or called-number authentication. Called-number authentication is also known as Dialed Number Information Service (DNIS) authentication.

Usage: You can specify one of these values:

phonenum Password="Ascend-CLID"
                      Ascend-Require-Auth=Require-Auth
For additional authentication after called-number authentication, the first-tier dial-in user profile has the following two-line format:

phonenum Password="Ascend-DNIS"
                      Ascend-Require-Auth=Require-Auth
Example: This example shows a two-tiered approach. The first user profile specifies CLID authentication, and indicates that additional authentication will follow. Because Recv Auth=CHAP in the Answer profile, CHAP authentication will follow CLID authentication. The second user profile sets up other attributes for the call.

5551212      Password="Ascend-CLID"
                   Ascend-Require-Auth=Require-Auth
Emma      Password="pwd" Caller-Id="5551212"
              User-Service=Framed-User,
              Framed-Protocol=PPP,
              Framed-Address=200.11.12.10,
              Framed-Netmask=255.255.255.248,
       Ascend-Send-Secret="pwd",
              ...

Ascend-Route-Appletalk (118)

Description: Specifies whether AppleTalk routing is enabled for the connection. When AppleTalk routing is enabled, the connection can forward AppleTalk packets.

Usage: Specify one of the following values:

Dependencies: If you specify Route-Appletalk-Yes, you must set the Ascend- Appletalk- Peer-Mode attribute.

Ascend-Route-IP (228)

Description: The Ascend-Route-IP attribute specifies whether the MAX enables IP routing for the user profile.

Usage: You can specify one of these values:

See Also: Framed-Route (22)

Ascend-Route-IPX (229)

Description: The Ascend-Route-IPX attribute indicates whether the MAX enables IPX routing for the user profile. For PPP and MP+ calls, both ends of the connection must have matching settings to route IPX.

Usage: You can specify one of these values:

See Also: Ascend-IPX-Alias (224)
Ascend-IPX-Peer-Mode (216)
Ascend-IPX-Route (174)

Ascend-Secondary-Home-Agent (130)

Description: The Ascend-Secondary-Home-Agent attribute specifies the secondary home agent the foreign agent tries to reach when the primary home agent (specified by Ascend- Primary-Home-Agent) is unavailable. The attribute also indicates the UDP port the foreign agent uses for the link.

Usage: Specify the secondary home agent using this syntax:

Ascend-Secondary-Home-Agent="hostname | ip_address [:udp_port]"
Example: To specify max2.home.com at IP address 10.0.0.2 as the secondary home agent, and indicate that the foreign agent should use UDP port 6002, specify one of these lines in the RADIUS user profile:

Ascend-Secondary-Home-Agent="max2.home.com:6002"
Ascend-Secondary-Home-Agent="10.0.0.2:6002"
To specify a primary home agent and a secondary home agent, enter these lines in the RADIUS user profile:

Ascend-Primary-Home-Agent="max1.home.com:6001"
Ascend-Secondary-Home-Agent="max2.home.com:6002"
The foreign agent first tries max1.home.com on UDP port 6001. If the name cannot be resolved, or if max1.home.com does not respond, the foreign agent then tries max2.home.com on UDP port 6002.

The RADIUS accounting Stop record will include Ascend-Home-Agent-IP-Addr when Ascend-Secondary-Home-Agent is present in the user profile.

Dependencies: If you specify the Ascend-Home-Agent-UDP-Port attribute on the line immediately following the Ascend-Secondary-Home-Agent attribute, you need not specify a value for udp_port. By the same token, if you specify a value for the udp_port argument of Ascend-Secondary-Home-Agent, or if you accept the default of 5150, you need not specify the Ascend-Home-Agent-UDP-Port attribute.

See Also: Ascend-Home-Agent-Password (184)
Ascend-Home-Agent-UDP-Port (186)
Ascend-Home-Network-Name (185)
Ascend-Primary-Home-Agent (129)

Ascend-Seconds-Of-History (238)

Description: The Ascend-Seconds-Of-History attribute specifies the number of seconds the MAX uses as a sample for calculating average line utilization (ALU) of transmitted data. The MAX arrives at this average using the algorithm specified by the Ascend-History-Weigh-Type attribute.

The number of seconds you choose for the Ascend-Seconds-Of-History attribute depends on your device's traffic patterns. For example, if you want to average spikes with normal traffic flow, you may want the MAX to establish a longer historical time period. If, on the other hand, traffic patterns consist of many spikes that are short in duration, you may want to specify a shorter period of time. Doing so assigns less weight to the short spikes.

Usage: Specify a number between 1 and 300. The default value is 15 seconds.

Dependencies: Keep this additional information in mind:

See Also: Ascend-Add-Seconds (240)
Ascend-Base-Channel-Count (172)
Ascend-DBA-Monitor (171)
Ascend-Dec-Channel-Count (237)
Ascend-History-Weigh-Type (239)
Ascend-Inc-Channel-Count (236)
Ascend-Maximum-Channels (235)
Ascend-Minimum-Channels (173)
Ascend-Remove-Seconds (241)
Ascend-Target-Util (234)

Ascend-Send-Auth (231)

Description: The Ascend-Send-Auth attribute specifies the authentication protocol that the MAX requests when initiating a connection using PPP or MP+ encapsulation. The answering side of the connection determines which authentication protocol, if any, the connection uses.

Usage: You can specify one of these values:

Dependencies: Keep this additional information in mind:

See Also: Ascend-Send-Passwd (232)
Ascend-Send-Secret (214)

Ascend-Send-Passwd (232)

Description: The Ascend-Send-Passwd attribute specifies the password that the RADIUS server sends to the remote end of a connection on an outgoing call.

Usage: Specify a text string containing up to 20 characters. The default value is null.

Dependencies: In a user profile, you can specify either Ascend-Send-Passwd or Ascend- Send-Secret, but not both. Use Ascend-Send-Passwd only if your version of the MAX does not
support Ascend-Send-Secret.

See Also: Ascend-Send-Auth (231)
Ascend-Send-Secret (214)

Ascend-Send-Secret (214)

Description: The Ascend-Send-Secret attribute specifies the password that the RADIUS server sends to the remote end of a connection on an outgoing call. It is encrypted when passed between the RADIUS server and the MAX.

Usage: Specify a text string containing up to 20 characters. The default value is null.

Dependencies: In a user profile, you can specify either Ascend-Send-Passwd or Ascend- Send-Secret, but not both. Use Ascend-Send-Passwd only if your version of the MAX does not support Ascend-Send-Secret.

See Also: Ascend-Send-Auth (231)
Ascend-Send-Passwd (232)

Ascend-Session-Svr-Key (151)

Description: The Ascend-Session-Svr-Key attribute enables the MAX to match a user session with a client request to perform certain operations, such as disconnecting a session or changing a session's filters.

The client sends Ascend-Session-Svr-Key to the RADIUS server in a Disconnect-Request or Change-Filter-Request packet when it initiates an operation. In addition, Ascend-Session-Svr-Key appears in a RADIUS Accounting-Start packet when a session starts.

Usage: Specify up to 16 characters. The default value is null.

Dependencies: The client sends the Ascend-Session-Svr-Key attribute only if Session Key=Yes in the Ethernet>Mod Config>RADIUS Server menu.

Ascend-Shared-Profile-Enable (128)

Description: Enables or disables sharing of a RADIUS user file for multiple incoming users.


Note: To apply Shared Profiles on a per RADIUS user profile basis, you have to disable profile sharing on a system-wide basis by setting Ethernet > Mod Config > Shared Prof = No on the MAX

Usage: You can specify one of the following settings:

Dependencies: For the Ascend-Shared-Profile-Enable attribute to apply, you must disable shared profiles for the MAX as a whole with Ethernet > Mod Config > Shared Prof = No.

Ascend-Target-Util (234)

Description: The Ascend-Target-Util attribute specifies the percentage of bandwidth use at which the MAX adds or subtracts bandwidth.

Usage: Specify an integer between 0 and 100. The default value is 70.When the value is 70%, the device adds bandwidth when it exceeds a 70 percent utilization rate, and subtracts bandwidth when it falls below that number.

Dependencies: Keep this additional information in mind:

See Also: Ascend-Add-Seconds (240)
Ascend-Base-Channel-Count (172)
Ascend-DBA-Monitor (171)
Ascend-Dec-Channel-Count (237)
Ascend-History-Weigh-Type (239)
Ascend-Inc-Channel-Count (236)
Ascend-Maximum-Channels (235)
Ascend-Minimum-Channels (173)
Ascend-Remove-Seconds (241)
Ascend-Seconds-Of-History (238)

Ascend-Third-Prompt (213)

Description: In the MAX configuration interface, the 3rd Prompt parameter enables you to specify an additional prompt for user input in the terminal server interface after the login and password prompts. The MAX passes the information the user enters to the RADIUS server as the Ascend-Third-Prompt attribute.

Usage: The Ascend-Third-Prompt attribute can contain up to 80 characters and does not appear in a user profile. If the user enters more than 80 characters, the MAX truncates the input to 80. If the user does enter any characters, the MAX sets the attribute to null.

Ascend-Token-Expiry (204)

Description: The Ascend-Token-Expiry attribute specifies the lifetime in minutes of a cached token.

CACHE-TOKEN authentication uses a shared secret, and simplifies the authentication process by caching the user's token for the fixed length of time specified by the Ascend-Token-Expiry attribute.When the cached token is still alive, CHAP authenticates subsequent CACHE-TOKEN access requests from the same user without the use of a hand-held security card. When the cached token has expired, the ACE or SAFEWORD server authenticates CACHE-TOKEN access requests.

Usage: On the first line of the user profile, specify an integer representing the lifetime of the cached token in minutes. The default value is 0 (zero). If you accept the default, the MAX rejects subsequent CACHE-TOKEN requests from the same user.

Example: The following two-line example sets up CACHE-TOKEN authentication with a 90-minute token cache. Notice that the Ascend-Token-Expiry attribute must appear on the first line of the profile, along with the user name and ACE or SAFEWORD password:

Connor Password="ACE", Ascend-Token-Expiry=90

Ascend-Receive-Secret="shared-secret",

...

See Also: Ascend-Token-Idle (199)
Ascend-Token-Immediate (200)

Ascend-Token-Idle (199)

Description: The Ascend-Token-Idle attribute specifies the maximum length of time in minutes a cached token can remain alive between authentications.

Usage: On the first line of the user profile, specify an integer representing the maximum length of time in minutes that a cached token can remain alive. The default value is o (zero). If you accept this default, the cached token remains alive until the value of the Ascend-Token- Expiry attribute causes it to expire.

Dependencies: Typically, the value of Ascend-Token-Idle is lower than the value of
Ascend-Token-Expiry.

Example: The following two-line example sets up CACHE-TOKEN authentication with a 90-minute token cache and an 80-minute idle limit. Notice that the Ascend-Token-Idle attribute must appear on the first line of the profile:

Jim Password="ACE", Ascend-Token-Expiry=90, Ascend-Token-Idle=80

Ascend-Receive-Secret="shared secret"

See Also: Ascend-Token-Expiry (204)
Ascend-Token-Immediate (200)

Ascend-Token-Immediate (200)

Description: The Ascend-Token-Immediate attribute specifies how RADIUS treats the password it receives from a login user when the user profile specifies a hand-held security card server. Use this attribute in an ACE or SAFEWORD user profile that contains the setting User- Service=Login-User.

Usage: You can specify one of these values:

Dependencies: The Ascend-Token-Immediate attribute does not work with CHAP authentication.

Example: This example shows a portion of a user profile that requires the MAX to send the password to the ACE server. The login-user derives the password from a hand-held security card:

Connor    Password="ACE", Ascend-Token-Immediate=Tok-Imm-Yes
                Ascend-Receive-Secret="shared-secret",
                User-Service=Login-User,
                ...
See Also: Ascend-Token-Expiry (204)
Ascend-Token-Idle (199)

Ascend-Transit-Number (251)

Description: The Ascend-Transit-Number attribute specifies the U.S Interexchange Carrier (IEC) you use for long distance calls over a T1 PRI line.

Usage: Specify the same digits you use to prefix a phone number you dial over an ISDN BRI line, T1 access line, or voice interface:

The default value is null. If you accept the default, the MAX uses any available IEC for long-distance calls.

Ascend-TS-Idle-Limit (169)

Description: The Ascend-TS-Idle-Limit attribute specifies the number of seconds that a terminal server connection must be idle before the MAX disconnects the session.

Usage: You can specify a value between 0 and 65535.The default value is 120. A setting of 0 (zero) means that the line can be idle indefinitely.

Dependencies: Ascend-TS-Idle-Limit does not apply if you are using a Frame Relay or raw TCP connection, or if Ascend-TS-Idle-Mode=TS-Idle-None.

See Also: Ascend-TS-Idle-Mode (170)

Ascend-TS-Idle-Mode (170)

Description: The Ascend-TS-Idle-Mode attribute specifies whether the MAX uses a terminal server idle timer and, if so, whether both the user and host must be idle before the MAX disconnects the session.

Usage: You can specify one of these settings:

Example: This profile specifies that the user must be idle for 90 seconds before the MAX disconnects the session.

Default Password="UNIX"
        User-Service=Login-User,
        Ascend-TS-Idle-Limit=90,
        Ascend-TS-Idle-Mode=TS-Idle-Input
Dependencies: Ascend-TS-Idle-Mode does not apply if you are using a Frame Relay or raw TCP connection.

See Also: Ascend-TS-Idle-Limit (169)

Ascend-User-Acct-Base (142)

Description: The Ascend-User-Acct-Base attribute specifies whether the numeric base of the RADIUS Acct-Session-ID attribute is 10 or 16.

Usage: Specify one of these settings:

For example, when you set Ascend-User-Acct-Base=Ascend-User-Acct-Base-10, the MAX presents a typical session ID to the accounting server in this way:

"1234567890"

When you set Ascend-User-Acct-Base=Ascend-User-Acct-Base-16, the MAX presents the same session ID in this way:

"499602D2"

Dependencies: Changing the value of Ascend-User-Acct-Base while sessions are active results in inconsistent reporting between the Start and Stop records.

See Also: Ascend-User-Acct-Host (139)
Ascend-User-Acct-Key (141)
Ascend-User-Acct-Port (140)
Ascend-User-Acct-Time (143)
Ascend-User-Acct-Type (138)

Ascend-User-Acct-Host (139)

Description: The Ascend-User-Acct-Host attribute specifies the IP address of the RADIUS accounting server to use for this connection.

Usage: Specify an IP address in dotted decimal notation n.n.n.n, where n is an integer between 0 and 255. The default value is 0.0.0.0.

See Also: Ascend-User-Acct-Base (142)
Ascend-User-Acct-Key (141)
Ascend-User-Acct-Port (140)
Ascend-User-Acct-Time (143)
Ascend-User-Acct-Type (138)

Ascend-User-Acct-Key (141)

Description: The Ascend-User-Acct-Key attribute specifies the RADIUS client password as it appears in the clients file.

Usage: Specify a text string. The default value is null.

See Also: Ascend-User-Acct-Base (142)
Ascend-User-Acct-Host (139)
Ascend-User-Acct-Port (140)
Ascend-User-Acct-Time (143)
Ascend-User-Acct-Type (138)

Ascend-User-Acct-Port (140)

Description: The Ascend-User-Acct-Port attribute specifies a UDP port number for the connection between the user and the RADIUS accounting server.

Usage: Specify the UDP port number you indicated for the authentication process of the daemon in /etc/services. Or, if you used the incr keyword to the -A option when starting the daemon, specify the number of the UDP port for authentication services +1. You can specify a number between 1 and 32767.

See Also: Ascend-User-Acct-Base (142)
Ascend-User-Acct-Host (139)
Ascend-User-Acct-Key (141)
Ascend-User-Acct-Time (143)
Ascend-User-Acct-Type (138)

Ascend-User-Acct-Time (143)

Description: The Ascend-User-Acct-Time attribute specifies the number of seconds the MAX waits for a response to a RADIUS accounting request from the RADIUS accounting server for this connection.

Usage: Specify an integer between 1 and 10. The default value is 0 (zero).

See Also: Ascend-User-Acct-Base (142)
Ascend-User-Acct-Host (139)
Ascend-User-Acct-Key (141)
Ascend-User-Acct-Port (140)
Ascend-User-Acct-Type (138)

Ascend-User-Acct-Type (138)

Description: The Ascend-User-Acct-Type attribute specifies the RADIUS accounting server(s) to use for this connection.

Usage: You can specify one of these settings:

See Also: Ascend-User-Acct-Base (142)
Ascend-User-Acct-Host (139)
Ascend-User-Acct-Key (141)
Ascend-User-Acct-Port (140)
Ascend-User-Acct-Time (143)

Ascend-Xmit-Rate (255)

Description: Specifies the transmit baud rate for the connection.

Dependencies: The Ascend-Xmit-Rate attribute is sent in Accounting-Request packets at the end of a session under these conditions:

The attribute is still sent with the Accounting-Request packet whether the connection is authenticated or not.

Caller-Id (31)

Description: The Caller-Id attribute specifies the calling party number for Calling Line ID (CLID) authentication, indicating the phone number of the user that wants to connect to the MAX.

Usage: Specify a telephone number. You can indicate up to 37 characters, limited to the following: 1234567890()[]!z-*#|

The default value is null.

Example: This user profile specifies CLID authentication using name, password, and caller ID:

Emma  Password="test", Caller-Id="123456789"
            User-Service=Framed-User,
            Framed-Protocol=PPP,
            Framed-Address=255.255.255.254,
            Framed-Netmask=255.255.255.255,
            Ascend-Assign-IP-Pool=1,
            Ascend-Route-IP=Route-IP-Yes,
            Ascend-Idle-Limit=30

Challenge-Response (3)

Description: The Challenge-Response attribute specifies the value that a Challenge Handshake Authentication Protocol (CHAP) user provides in response to the password challenge.

Usage: The MAX sets the Challenge-Response value and sends it in Access-Request packets. The default value is null.

Change-Password (17)

Description: The MAX and the RADIUS server use the Change-Password attribute to change an expired password.

When a user specifies an expired password, RADIUS prompts the user for a new password. When the user enters the new password, the MAX sends an Access-Password-Request packet that contains both the old password (as the value of the Change-Password attribute), and the new password (as the value of the Password attribute).

If the RADIUS server accepts the new password, it tries to edit the users file and replace the expired password with the new one. Note that the RADIUS server can make this change only in the flat file. It cannot make this change in the database version of the users file.

Usage: Change-Password does not appear in a user profile and has no default value.

Class (25)

Description: The Class attribute enables access providers to classify user sessions, such as for the purpose of billing users depending on the service option they choose.

If you include the Class attribute in the RADIUS user profile, the RADIUS server sends it to the MAX in the Access-Accept packet when the session begins. The MAX then includes Class in Accounting-Request packets sent to the RADIUS accounting server under these conditions:

Keep in mind that the accounting entries give the class on a per-user and per-session basis. The Ascend-Number-Sessions attribute reports information on all user sessions-that is, on the number of current sessions of each class.

In addition, suppose the MAX starts CLID authentication by sending an Access-Request packet and receives the Class attribute in an Access-Accept packet. If the MAX requires further authentication, it includes Class in the Access-Request packet.

Usage: Specify an alphanumeric text string containing up to 253 characters. The default value is null.

See Also: Ascend-Number-Sessions (202)

Client-Port-DNIS (30)

Description: The Client-Port-DNIS attribute specifies the called-party number, indicating the phone number the user dialed to connect to the MAX. DNIS stands for Dialed Number Information Service. You use this attribute to set up called-number authentication, also known as DNIS authentication.

Usage: Specify the number the remote end dials to reach the MAX, limiting your specification to these characters:

1234567890()[]!z-*#|

You can specify up to 18 characters. The default value is null.

Typically, the phone numbers different callers can use to reach the MAX share a group of digits. For example, a local caller may dial 555-1234, while a long distance caller may dial 1-415-555-1234. In cases such as this, you need only specify the rightmost digits the calls have in common. In this case, you would need to specify only 1234.

Example: This user profile sets up called-number authentication in addition to name and password authentication:

Clara-p50 Password="Ascend", Client-Port-DNIS=1234

User-Service=Framed-User,

Framed-Protocol=MPP,

Framed-Address=200.10.11.12,

Framed-Netmask=255.255.255.248

Filter-Id (11)

Description: This attribute specifies a local data filter or local data firewall profile applied in the current RADIUS user profile. The MAX uses the filter only when it places a call or receives a call using the profile that includes the filter definition. The filters and firewalls specified in the RADIUS user profile are applied for that user the next time the RADIUS user profile is loaded to the MAX.

Usage: You can specify any number of data filters and firewalls. Filter entries apply on a first- match basis, so the order in which you enter the filter entries is significant. If you make changes to a filter in a RADIUS user profile, the changes do not take effect until a call uses that profile.

Example: The following are examples of how a RADIUS user profile can be set up to refer to a filter profile defined on the MAX, and to refer to a firewall defined usingSAM.

Assume the following two filter profiles are already set up on the MAX are:

Filter-id=6
Name=DisAllowPing
Out filter 01...Valid=Yes
Out filter 01...Type=IP
Out filter 01...Ip...Forward=No
Out filter 01...Ip...Protoco1=6
Filter-id=9
Name=DisAllowTelnet
Out filter 01...Valid=Yes
Out filter 01...Type=IP
Out filter 01...Ip...Forward=No
Out filter 01...Ip...Protocol=6
Out filter 01...Ip...Src Port Cmp-Eql
Out filter 01...Ip...Src Port #=23
The RADIUS user profile is:

someuser      Password="ascend"
User-Service=Framed-User,
Filter-Id="6",
Filter-Id="9",
Ascend-Data-Filter="ip out forward",
Framed-Protocol=PPP,
Framed-Address=10.11.1.1,
Framed-Netmask=255.255.255.0,
State="p"
The first filter is applied, disallowing pings. The second filter disallows Telnet packets. The 
Ascend-Data-Filter entry allows all IP packets to be forwarded. All pings and Telnet packets 
will be blocked, but other IP data packets are allowed.
The following is an example of a RADIUS user profile that specifies a firewall set up in SAM:

Example: someuser Password="ascend"
User-Service=Framed-User,
Filter-Id="101",
Framed-Protocol=PPP,
Framed-Address=10.11.1.1,
Framed-Netmask=255.255.255.0,
State="p"

See Also: Ascend-Data-Filter, Ascend-Call-Filter

Framed-Address (8)

Description: The Framed-Address attribute specifies the IP address of the caller in a user profile.

RADIUS can authenticate an incoming call by matching its IP address to one you specify in the RADIUS user profile. In addition, if the remote end requires an IP address on an outgoing call, and does not assign one dynamically, you must specify it in the user profile.

Usage: Specify an IP address in dotted decimal notation n.n.n.n, where n is an integer between 0 and 255. The default value is 0.0.0.0. An answering user profile with this setting matches all IP addresses.

Dependencies: Every Connection profile and RADIUS user profile that specifies an explicit IP address is a static route.

See Also: Framed-Netmask (9)

Framed-Compression (13)

Description: The Framed-Compression attribute turns TCP/IP header compression on or off.

Usage: To turn on TCP/IP header compression, specify Van-Jacobson-TCP-IP. This setting applies only to packets in TCP applications, such as Telnet, and turns on header compression for both sides of the link. By default, this attribute does not turn on header compression.

Dependencies: Turning on header compression is most effective in reducing overhead when the data portion of the packet is small.

See Also: Ascend-Link-Compression (233)

Framed-IPX-Network (23)

Description: The Framed-IPX-Network attribute specifies a virtual IPX network required for the Ascend Tunnel Management Protocol (ATMP) home agent to route IPX packets to the mobile node. When specified in a user profile, the Framed-IPX-Network attribute instructs the answering unit to advertise an additional IPX route.

Usage: Specify the IPX network number of the IPX router at the remote end of the connection. The default value is null.

RADIUS requires that Framed-IPX-Network have a decimal value (base 10), but IPX network numbers generally appear as hexadecimal values (base 16). In order to give this attribute a value, you must convert the hexadecimal IPX network number to decimal format for use in the user profile. For example, if the IPX network number is 13870000, you must convert it to the decimal 49990000. This requirement does not apply for the IPX node address, which appears as a 12-digit string enclosed in double-quotes.

See Also: Ascend-IPX-Node-Addr (182)

Framed-MTU (12)

Description: The Framed-MTU attribute specifies the maximum number of bytes the MAX can receive in a single packet on a PPP, Frame Relay, EU-UI, or EU-RAW link.

Usage: The default value is 1524. You should accept this default unless the device at the remote end of the link cannot support it. If the administrator of the remote network specifies that you must change this value, specify a number between 1 and 1524 (for a PPP, EU-UI, or EU-RAW link) or between 128 and 1600 (for a Frame Relay link).

Framed-Netmask (9)

Description: The Framed-Netmask attribute specifies a subnet mask for the caller at Framed- Address.

Usage: Specify an IP address in dotted decimal notation n.n.n.n, where n is an integer between 0 and 255. The default value is 0.0.0.0. If you accept this default, the MAX assumes a default subnet mask based on the class of the address

Table 9-16. IP address classes and default subnet masks

Class

Address range

Network bits

Class A

0.0.0.0 --\>127.255.255.255

8

Class B

128.0.0.0 --\>191.255.255.255

16

Class C

192.0.0.0 --\>223.255.255.255

24

Class D

224.0.0.0 --\>239.255.255.255

N/A

Class E (reserved)

240.0.0.0 --\>247.255.255.255

N/A

, as shown in Table 9-16.

See Also: Framed-Address (8)

Framed-Protocol (7)

Description: The Framed-Protocol attribute specifies the type of framed protocol the link can use. When you set this attribute, the link cannot use any other type of framed protocol.

This attribute can appear in both an Access-Request and Access-Accept packet. However, it does not appear in an Access-Request packet if Auth Send Attr 6, 7=No in the Ethernet> Mod Config>Auth menu.

Usage: Table 9-17 lists the values you can specify for Framed-Protocol.

Table 9-17. Framed-Protocol settings

Setting

Incoming call

Outgoing call

PPP (1)

A user requesting access can dial in using Multilink Protocol Plus (MP+), Multilink Protocol (MP), or Point-to-Point Protocol (PPP) framing. A user requesting access can also dial in unframed, and then change to PPP framing.

If the user dials in using any other type of framing, the MAX rejects the call.

Outgoing calls use PPP framing.

SLIP (2)

A user requesting access can dial in unframed and change to SLIP framing. SLIP requires that a user dial in without using a framed protocol before changing to SLIP.

This value does not apply to outgoing calls.

MPP (256)

This value does not apply to incoming calls.

Outgoing calls request MP+ framing.

EURAW (257)

A user requesting access can dial in using EU-RAW framing. EU-RAW is a type of X.75 encapsulation in which IP packets are HDLC encapsulated with a CRC field.

If the user dials in using any other type of framing, the MAX rejects the call.

Outgoing calls use EU-RAW framing.

EUUI (258)

A user requesting access can dial in using EU-UI framing. EU-UI is a type of X.75 encapsulation in which IP packets are HDLC encapsulated with a CRC field and a small header.

If the user dials in using any other type of framing, the MAX rejects the call.

Outgoing calls use EU-UI
framing.

COMB (260)

A user requesting access can dial in using Combinet framing. If the user dials in using any other type of framing, the MAX rejects the call.

Outgoing calls use Combinet framing.

FR (261)

This value does not apply to incoming calls.

Outgoing calls use Frame Relay (RFC 1490) framing.

ARA (262)

A dial-in user can establish an AppleTalk Remote Access (ARA) connection to the Ethernet network.

This value does not apply to outgoing calls.

FR-CIR (263)

This value specifies a Frame Relay circuit.

This value specifies a Frame Relay circuit.


Note: By default, the MAX does not limit the protocols a link can access.

Dependencies: What Framed-Protocol does depends on how you set User-Service:

Example: The dial-in user in this example can use only PPP protocols (PPP, MP+, or MP), and cannot use the terminal server:

Ascend  Password="Pipeline"
              User-Service=Framed-User,
              Framed-Protocol=PPP,
              Framed-Address=10.0.200.225,
              Framed-Netmask=255.255.255.0,
              Ascend-Metric=2,
              Framed-Routing=None,
              Framed-Route="10.0.220.0 10.0.200.225 1",
              Ascend-Idle-Limit=30
The dial-in user in this example establishes an ARA connection to the Ethernet network:

Ascend  Password="Pipeline"
              User-Service=Framed-User,
              Framed-Protocol=ARA,
              Ascend-Idle-Limit=30,
              ...

Framed-Route (22)

Description: The Framed-Route attribute enables you to add static IP routes to the MAX unit's routing table.

Usage: The Framed-Route attribute has this format:

Framed-Route="host_ipaddr[/subnet_mask] gateway_ipaddr metric 
[
private] [name] [preference]"
Table 9-18 describes each Framed-Route argument.

Table 9-18. Framed-Route arguments

Syntax element

Description

host_ipaddr/subnet_mask

Indicates the IP address of the destination host or subnet reached by this route.

If the address includes a subnet mask, the remote router specified by router_ipaddr is a router to that subnet, rather than to a whole remote network. To specify the entire remote network, do not specify a subnet mask.

router_ipaddr

Specifies the IP address of the router at the remote end of the connection.

The 0.0.0.0 address is a wildcard entry that the MAX replaces with the caller's IP address.When RADIUS authenticates a caller and sends the MAX an Access-Accept message with a Framed-Route 0.0.0.0 router, the MAX updates its routing tables with the Framed-Route value, but substitutes the caller's IP address for the router. This setting is especially useful when RADIUS cannot know the IP address of the caller because the IP address comes from an address pool.

metric

Indicates the metric for this route. If the MAX has more than one possible route to a destination network, it chooses the one with the lower metric.

private

Specifies y if this route is private, or n if it is not private. If you specify that the route is private, the MAX does not disclose the existence of the route when queried by RIP or another routing protocol.

name

Indicates the name outgoing user profile that uses the route.

preference

Specifies the preference the MAX assigns to the route. Routes with lower preferences have priority over identical metrics with higher preferences.

Dependencies: Each static route must appear in a pseudo-user profile. You create a pseudo- user to store information that the MAX can query-in this case, in order to store IP routing information. You can configure pseudo-users for both global and MAX-specific configuration control of IP dialout routes. The MAX loads the unit-specific dialout routes in addition to the global dialout routes.

For a unit-specific IP dialout route, specify the first line of a pseudo-user profile in this format:

Route-unit_name-num Password="Ascend", User-Service=Dialout-Framed-
User
For a global IP dialout route, specify the first line of a pseudo-user profile in this format:

Route-num Password="Ascend", User-Service=Dialout-Framed-User
unit_name is the system name of the MAX-that is, the name specified by the Name parameter in the System profile. num is a number in a sequential series, starting at 1.

In each pseudo-user profile, you can specify one or more routes using the Framed-Route attribute. You should limit each pseudo-user profile to about 25 routes. The MAX fetches information from each profile in order to initialize its routing table. Whenever you power on or reset the MAX, or when you select the Upd Rem Cfg command from the Sys Diag menu, RADIUS adds IP dialout routes to the routing table in this way:

  1. RADIUS looks for profiles having the format Route-unit_name-1, where
    unit_name is the system name.

  2. If at least one profile exists, RADIUS loads all existing profiles having the format
    Route-unit_name-num to initialize the IP routing table.

    The variable num is a number in a sequential series, starting with 1.

  3. The MAX queries Route-unit_name-1, then Route-unit_name-2, and so on, until it receives an authentication reject from RADIUS.

  4. RADIUS loads the global configuration profiles.

    These configurations have the form Route-num.

  5. The MAX queries Route-1, then Route-2, and so on, until it receives an authentication reject from RADIUS.

The routes remain in effect until the next restart or until overwritten by dynamic updates or routes specified in Connection profiles.


Note: In some cases, you might wish to update the MAX unit's routing tables when connecting to a user whose profile specified User-Service=Framed-User. In this case, you can set the Framed-Route attribute in an incoming user profile to specify the user's IP address and subnet mask in the host_ipaddr and subnet_mask arguments, respectively. The route you specify in this manner exists only during the time the call is online. When you also enter a nonzero router address for router_ipaddr that is different from the caller's address, the static route of a dial-in framed-user persists even after the connection goes offline.

Example: This example shows two RADIUS pseudo-user profiles defining global static IP routes:

Route-1      Password="Ascend", User-Service=Dialout-Framed-User
      Framed-Route="10.0.200.33/29 10.0.200.37 1 n lala-gw-out ",
      Framed-Route="10.0.200.50/29 10.0.200.37 1 n lala-gw-out ",
      Framed-Route="10.0.200.47/29 10.0.200.49 1 n nana-gw-out "
Route-2      Password="Ascend", User-Service=Dialout-Framed-User
      Framed-Route="11.0.200.33/29 11.0.200.37 1 n zzz-gw-out ",
      Framed-Route="12.0.200.47/29 11.0.200.49 1 n kk-gw-out "
See Also: Ascend-Route-IP (228)

Framed-Routing (10)

Description: The Framed-Routing attribute specifies whether the MAX sends Routing Information Protocol (RIP) packets, receives RIP packets, or both.

If you enable RIP to both send and receive RIP updates on the WAN interface, the MAX broadcasts its routing table to the remote network and listens for RIP updates from that network. Gradually, all routers on both networks have consistent routing tables (all of which may become quite large).

Usage: You can specify one of these values:

See Also: Ascend-Route-IP (228)

Login-Host (14)

Description: The Login-Host attribute specifies the IP host to which the user automatically connects when you set User-Service=Login-User and specify a value for the Login-Service attribute. Access begins immediately after login.

Usage: Specify an IP address in dotted decimal notation n.n.n.n, where n is an integer between 0 and 255. The default value is 0.0. 0.0.This setting specifies that the Login-User does not automatically connect to a particular host.

If you do not specify a value for the Login-Host attribute, the user can access any remote host through the Telnet or raw TCP commands of the terminal server command-line interface. When the operator uses the menu-driven terminal server interface, he or she can only gain access to the hosts listed by the Ascend-Host-Info attribute.

Dependencies: When User-Service=Framed-User, RADIUS ignores the Login-Host attribute.

See Also: Login-Service (15)

Login-Service (15)

Description: The Login-Service attribute specifies the type of terminal service connection to an IP host that occurs immediately after authentication.

Usage: Specify one of these values:

When you set the Login-Service attribute, a dial-in terminal server user makes an immediate connection to an IP host on your local network and never sees the terminal server interface.

By default, the MAX does not grant immediate access to an IP host.

Dependencies: Keep this additional information in mind:

Example: In this example, an Rlogin session starts automatically for anyone using the Userx user name and xyzzy password. When the session terminates, the connection also terminates.

# This profile causes an auto-rlogin to 10.0.200.4 upon login.
Userx    Password="xyzzy"
              User-Service=Login-User,
              Login-Service=Rlogin,
              Login-Host=10.0.200.4 
Further, when you specify the following settings, a raw TCP session starts automatically for anyone using the User1 user name and Test1 password:

# This profile causes an auto-TCP to 4.2.3.1 port 9 upon login.
User1    Password="Test1"
              User-Service=Login-User,
              Login-Service=TCP-Clear,
              Login-Host=4.2.3.1, 
              Login-TCP-Port=9 
See Also: Login-Host (14)
Login-TCP-Port (16)

Login-TCP-Port (16)

Description: The Login-TCP-Port attribute specifies the port number to which a TCP session connects when Login-Service=TCP-Clear in a user profile.

Usage: Specify an integer between 1 and 65535. The default value is 23.

See Also: Login-Service (15)

NAS-Identifier (4)

Description: The NAS-Identifier attribute indicates the IP address of the MAX. When the MAX sends an Access-Request packet or Ascend-Event-Request packet, it indicates its IP address to the RADIUS server using this attribute.

Usage: In most cases, you never need to specify the NAS-Identifier attribute in a user profile.

However, you might want to specify it if multiple MAX units use a single RADIUS server, and you want to specify the MAX to which a particular user can connect. In this case, the NAS-Identifier value in the Access-Request packet and the NAS-Identifier value in the user profile must match for the RADIUS server to authenticate the connection.

Specify an IP address in dotted decimal notation n.n.n.n/nn, where n is an integer between 0 and 255, and nn is a subnet mask between 8 and 32. The default value is 0.0.0.0/0. The NAS-Identifier value must appear in the first line of the user profile.

Example: Suppose that the user Emma is allowed to dial into the MAX at IP address 200.65.212.46. The first line of the user profile might look like this one:

Emma Password="pwd", NAS-Identifier=200.65.212.46

NAS-Port (5)

Description: The NAS-Port attribute identifies the network interface and service the session is using. The MAX sends this attribute to the RADIUS server in an Access-Request packet and an Accounting-Request packet.

Usage: You can specify two formats, one restricting the dial-in user to a service, line, and channel, and one restricting the dial-in user to a slot, line, and channel.

  1. To restrict a user to a service, line, and channel,

Specify NAS-Port in the first line of the user profile using this format :

service line channel
For an analog call, the values are the same, except that the line number can be 0-63, and the channel number is always 1.

Because the value you enter is zero-based, you must add 1 to each component to ascertain the actual slot, line, and channel number. The RADIUS daemon converts the NAS-Port number to decimal on most systems.

Example: To restrict a dial-in user to analog service on line 1, set up a user profile like this one:

To restrict a dial-in user to channel 10 on line 2 for slot 1, set up a user profile like this one:

The value NAS-Port=1098 translates to the following NAS port:

NAS-Port-Type (61)

Description: The NAS-Port-Type attribute indicates the type of physical port the MAX is using to authenticate the client. The NAS-Port-Type attribute appears in RADIUS Start, Stop, and Checkpoint messages.

Some ISPs offer different levels of service based on connection type. To prevent a client from using a capability to which he or she has not subscribed, set the NAS-Port-Type attribute to an appropriate value.

Usage: You can specify one of these settings:

See Also: NAS-Port (5)

Password (2)

Description: The Password attribute specifies the password of the calling device or dial-in user in a user profile.

Usage: Specify an alphanumeric string containing up to 252 characters. The default value is null. The Password attribute must appear on the first line of the user profile. You can make any of these specifications:

See Also: Ascend-Ara-PW (181)

Reply-Message (18)

Description: The Reply-Message attribute carries message text from a RADIUS server to RADIUS clients such as the MAX under these two circumstances:

Usage: Specify a text string containing up to 80 characters. The default value is null. You can specify up to 16 Reply-Message attributes in a pseudo-user profile.

Dependencies: Keep this additional information in mind:

Example: Here is an example of a pseudo-user profile setting up message text for a MAX named Cal:

Initial-Banner-Cal Password="Ascend", User-Service=Dialout-Framed-User
          Reply-Message="Up to 16 lines of up to 80 characters each",
          Reply-Message="will be accepted. Long lines will be truncated",
          Reply-Message="Additional lines will be ignored.",
          Reply-Message="",
Ascend-Host-Info="1.2.3.4 Berkeley",

Ascend-Host-Info="1.2.3.5 Alameda",

Ascend-Host-Info="1.2.36 San Francisco",

...

See Also: Ascend-Host-Info (252)

Tunnel-Client-Endpoint (Attribute 66)

Description: A string assigned by RADIUS that specifies the name for the unit placing the call. This is used by RADIUS accounting for tracking the session.

Dependencies: Keep this additional information in mind:

See Also: Client-Port-DNIS (Attribute 30), used for Called Number authentication.

Tunnel-ID (Attribute 68)

Description: String assigned by RADIUS to each session using CLID or DNIS tunneling. This value is used for accounting when accounting is implemented.

Dependencies: Keep this additional information in mind:

See Also: Client-Port-DNIS (Attribute 30), used for Called Number authentication.

Tunneling-Protocol (127)

Description: The Tunneling-Protocol attribute indicates if a session used the ATMP tunneling protocol.

Usage: Specify ATMP if the connection uses the ATMP tunneling protocol.

Example: The following is an example of a RADIUS accounting record with the Tunneling- Protocol attribute.

Mon Apr 21 02:41:38 1997
        User-Name = "JacobP75"
NAS-Identifier = 1.1.1.1
NAS-Port = 10105
Acct-Status-Type = Stop
Acct-Delay-Time = 0
Acct-Session-Id = "111111111"
Acct-Authentic = RADIUS
Acct-Session-Time = 0
Acct-Input-Octets = 215
Acct-Output-Octets = 208
Acct-Input-Packets = 10
Acct-Output-Packets = 10
Ascend-Disconnect-Cause = 1
Ascend-Connect-Progress = 60
Ascend-Data-Rate = 56000
Ascend-PreSession-Time = 1
Ascend-Pre-Input-Octets = 215
Ascend-Pre-Output-Octets = 208
Ascend-Pre-Input-Packets = 10
Ascend-Pre-Output-Packets = 10
Framed-Protocol = PPP
Framed-Address = 2.2.2.2
Tunneling-Protocol = ATMP
Dependencies: The Tunneling-Protocol attribute is sent in Accounting-Request packets at the end of a session under the following conditions:

Tunnel-Medium-Type (Attribute 65)

Description: Specifies the transport medium over which the encapsulated traffic is carried (tunneled).

Usage: Tunnel-Medium-Type can have the following values

Dependencies: Keep this additional information in mind:

See Also: Client-Port-DNIS (Attribute 30), used for Called Number authentication.

Tunnel-Server-Endpoint (67)

Description: Specifies the fully-qualified host name or IP address of the network server to contact for building a tunnel. If you set Tunnel-Type to L2TP, Tunnel-Server-Endpoint indicates the IP address of the LNS. If you set Tunnel-Type to PPTP, Tunnel-Sever-Endpoint indicates the IP address of the PNS.

Usage: Specify the primary home agent in the following format:

Tunnel-Server-Endpoint="hostname | ip_address"
where:

You can specify a host name or IP address, but not both.

Example: To specify the network server maxSF.home.com at IP address 10.10.10.10, specify one of the following lines in the RADIUS user profile:

Tunnel-Server-Endpoint=10.10.10.10
Tunnel-Server-Endpoint=maxSF.home.com
Dependencies: For the MAX to correctly create an L2TP tunnel, you must set Tunnel-Type to L2TP and Tunnel-Medium-Type to IP, in addition to specifying the IP address of an accessible LNS.

For the MAX to correctly create an PPTP tunnel, you must set Tunnel-Type to PPTP and Tunnel-Medium-Type to IP, in addition to specifying the IP address of an accessible PPTP Network Server (PNS).

See Also: Tunnel-Type (64), Tunnel-Medium-Type (65)

Tunnel-Type (64)

Description: Specifies the type of tunneling protocol to create.

Usage: You can specify the following values for Tunnel-Type:

Example: Tunnel-Type=L2TP

Dependencies: For the MAX to correctly create an L2TP tunnel, you must set Tunnel- Medium-Type to IP and set Tunnel-Server-Endpoint to the IP address of an accessible LNS, in addition to setting Tunnel-Type to L2TP.

For the MAX to correctly create an PPTP tunnel, you must set Tunnel-Medium-Type to IP and set Tunnel-Server-Endpoint to the IP address of an accessible PNS, in addition to setting Tunnel-Type to PPTP.

See Also: Tunnel-Medium-Type (65), Tunnel-Server-Endpoint (67)

User-Name (1)

Description: The User-Name attribute can specify one of the following in a user profile:

Usage: Specify an alphanumeric string containing up to 252 characters. The default value is null. The user name must be the first word in a user profile. You need not specify the name of the attribute.

Example: For example, consider this first line in a user profile:

Emma Password="pwd", Ascend-PW-Expiration="January 30 1997"
The user name is Emma. The RADIUS server tests the user's name and password against the values the user provides when making a request for access. If the RADIUS server does not find a match, it denies the request for access.

Here is a sample user profile for CLID authentication using the incoming phone number as the User-Name:

5551212    Password="Ascend-CLID"
                  Ascend-Require-Auth=Not-Require-Auth,
                  User-Service=Framed-User,
                  Framed-Protocol=PPP,
                  Framed-Address=255.255.255.254,
                  Framed-Netmask=255.255.255.255,
                  Ascend-Assign-IP-Pool=1,
                  Ascend-Route-IP=Route-IP-Yes,
                  Ascend-Idle-Limit=30
Finally, this example shows User-Name in a pseudo-user profile for a static route:

Route-1 Password="Ascend", User-Service=Dialout-Framed-User
        Framed-Route="10.4.5.0/22 10.9.8.10 1 n inu-out"

User-Service (6)

Description: The User-Service attribute specifies the type of services the link can use.

If RADIUS authenticates an incoming call using the User-Name and Password attributes, and the type of call matches the value of the User-Service attribute, the MAX applies the attributes in the user profile to the call. If the type of call does not match the User-Service attribute, the MAX rejects the call.

This attribute can appear in both an Access-Request and Access-Accept packet. However, it does not appear in an Access-Request packet if Auth Send Attr 6, 7=No in the Ethernet> Mod Config>Auth menu.

Usage: You can specify one of these values:

By default, the MAX does not limit the services the link can access.

Dependencies: Keep this additional information in mind:



[Top][Contents][Prev][Next][Last]Search

techpubs@eng.ascend.com

Copyright © 1998, Ascend Communications, Inc. All rights reserved.