3Com 3C421600A Reference Manual

Manual is about: SuperStack II Remote Access System

Summary of 3C421600A

  • Page 1

    ® http://www.3com.Com/ superstack ® ii remote access system 1500 reference guide release 2.0 part no. 1.024.2053 rev 2.00 december, 1999.

  • Page 2

    3com corporation 5400 bayfront plaza santa clara, california 95052-8145 copyright © 1999, 3com corporation. All rights reserved. No part of this documentation may be reproduced in any form or by any means or used to make any derivative work (such as translation, transformation, or adaptation) withou...

  • Page 3: Ontents

    C ontents a bout t his g uide conventions 19 related documentation 20 year 2000 compliance 21 1 r outer c onfiguration o verview configuration command overview 23 configurable table overview 24 interface tables 24 user table 25 local and login hosts tables 25 initialization script and global host ta...

  • Page 4

    Address translation table 28 cip port parameter table 28 user manager active sessions table 28 modem tables 28 ppp tables 29 2 a dministrative t ools customizing cli parameters 31 software downloads 33 dial, connect and hangup commands 33 exiting the cli 34 network services 35 troubleshooting comman...

  • Page 5

    Command language structure 52 4 r outer c ommand r eference command language structure 56 add commands 57 add address_pool user 57 add appletalk 58 add bridge access_ mac_address 58 add bridge network 58 add datalink frame_relay 59 add datalink ppp 59 add dns server 60 add filter 60 add frame_relay ...

  • Page 6

    Add syslog 75 add tftp client address> 76 add user 76 arp command 77 arp _address> 77 assign command 78 assign interfaces 78 bye command 79 bye 79 copy command 79 copy file 79 delete commands 79 delete address_pool user 79 delete appletalk network 79 delete appletalk zone 79 delete bridge access_mac...

  • Page 7

    Delete ip pool 81 delete ip route mask> 81 delete ip udp_bcast_ forwarding_port 81 delete ipx network 82 delete ipx route address> 82 delete ipx service 82 delete login_host preference number> 82 delete modem_group 82 delete nat dynamic user 83 delete nat static user 83 delete network service 83 del...

  • Page 8

    Disable ip rip 86 disable ip routing 86 disable ip static_remote_routes 86 disable ip udp_broadcast_ forwarding 86 disable ipx network 87 disable ipx rip network 87 disable ipx sap network 87 disable modem_group 87 disable network service 87 disable security_option remote_user_ administration [diali...

  • Page 9

    Enable datalink ppp 89 enable dns host_rotation 90 enable dns host_rotation 90 enable icmp router_advertise 90 enable interface 90 enable ip address_pool_ filtering 91 enable ip forwarding 91 enable ip network 91 enable ip rip 91 enable ip routing 91 enable ip security_option commands 91 enable ip s...

  • Page 10

    Hangup modem_group 95 help command 95 help 95 hide command 95 hide events 95 history command 95 history 95 kill command 96 kill 96 leave command 96 leave 96 list commands 97 list active interfaces 97 list appletalk forwarding 97 list appletalk networks 97 list appletalk routes 98 list appletalk zone...

  • Page 11

    List ip pools 106 list ip routes 107 list ip udp_bcast_ forwarding_port 107 list ipx networks 108 list ipx routes 108 list ipx services 108 list ipx static routes 109 list lan interfaces 109 list login_hosts 109 list modem_groups 110 list nat user 110 list network services 110 list networks 110 list...

  • Page 12

    Quit command 120 quit 120 reboot command 120 reboot 120 reconfigure command 120 reconfigure ip network 120 rename command 121 rename file 121 reset commands 121 resolve command 122 resolve name 122 rlogin command 122 rlogin 122 save commands 122 save all 122 set commands 123 set accounting 123 set a...

  • Page 13

    Set interface 138 set ip address_assign_ mode 139 set ip defaultroute gateway 139 set ip multicast proxy interface 139 set ip network 140 set ip pool 143 set ip route 143 set ip routing 144 set ipx network 145 set ipx system 147 set login_host preference number> 147 set modem_group 148 set network s...

  • Page 14

    Show accounting counters 172 show appletalk counters 172 show appletalk or show appletalk settings 173 show authentication or show authentication settings 174 show authentication counters 174 show bridge or show bridge network settings 175 show cleartcp or show cleartcp settings 175 show command or ...

  • Page 15

    Show ip counters 191 show ip network or show ip network settings 192 show ip routing or show ip routing settings 193 show ip security or show ip security settings 194 show ip udp_broadcast_ forwarding 194 show ipx or show ipx settings 194 show ipx counters 195 show ipx network or show ipx network se...

  • Page 16

    Show tcp, or show tcp settings 211 show tcp counters 212 show telnet or show telnet settings 212 show time or show timezone 213 show udp, or show udp counters 213 show user 213 telnet commands 214 telnet 214 telnet tcp_port 215 unassign command 215 unassign interface 215 verify command 215 verify fi...

  • Page 17

    Command line edit 218 command retrieval 218 positional help 218 command completion 219 output pause 219 command kill 219 a m odem c ommand r eference modem command overview 221 basic at commands 222 ampersand commands 223 percent commands 225 asterisk commands 226 tilde commands 228 octothorp comman...

  • Page 18

    Local flash file event logging 252 telnet session 252 event logging levels 253 event logging counters 253 using syslog 254 configuring syslog hosts on ras 1500 254 setting the event log level 254 event message examples 255 ip messages 255 call initiation process messages 258 user manager messages 25...

  • Page 19: Bout

    A bout t his g uide this guide describes how to configure the software for the superstack ® ii remote access system (ras) 1500. This guide is intended for administrators with knowledge of networking, telephony, and remote-access applications. While the initial configuration can be accomplished with ...

  • Page 20

    20 a bout t his g uide related documentation the ras 1500 documentation set includes the following documents. All 3com documentation is available on the 3com web site: http://www.3com.Com ■ base unit memory upgrade superstack ii remote access system 1500 table 2 text conventions convention descripti...

  • Page 21

    Year 2000 compliance 21 this document describes how to perform the memory upgrade for the remote access system 1500. ■ firmware upgrade superstack ® ii remote access system 1500 this document describes how to perform the upgrade procedures for the superstack ii remote access (ras) 1500 base unit and...

  • Page 23: Outer

    1 r outer c onfiguration o verview the superstack ® ii remote access system (ras) 1500 and related components are simple network management protocol (snmp) manageable by a ras 1500 via a telnet connection. The parameters you set through these interfaces are stored in a number of tables that reside i...

  • Page 25

    Configurable table overview 25 user table this table contains authentication and configuration information for five types of users: login, network, callback, dial-out,andmanage. User table entries override settings for the interface to which the user is connected. Local and login hosts tables the lo...

  • Page 26

    26 c hapter 1: r outer c onfiguration o verview facility level table this table is used to configure the log level of all facilities (software systems) on the ras 1500. It contains each event facility and its associated log level. Each facility generates unique event messages during processing that ...

  • Page 27

    Configurable table overview 27 snmp configuration tables the ras 1500 provides support for snmp version 1 and industry standard mib-ii variables. These variables are fully described in your mib-ii documentation. The snmp community table stores information about which snmp servers (if any) are permit...

  • Page 28

    28 c hapter 1: r outer c onfiguration o verview dial-out port table this table lists virtual ports available for ncsi dial-out service. Use the list dial_out command to display this table. Udp listeners table this table details user datagram protocol (udp) ports being used by the ras 1500. These por...

  • Page 29

    Configurable table overview 29 ppp tables several point-to-point protocol (ppp) tables contain entries regarding ppp connections on the ras 1500. These include the following tables: ■ ppp link table ■ ppp authentication table.

  • Page 31: Dministrative

    2 a dministrative t ools this chapter covers administrative commands used for the following: ■ reconfiguring your system ■ troubleshooting commands ■ displaying system information reconfiguring your system the commands detailed in this section control configurable aspects of your system. Customizing...

  • Page 32

    32 c hapter 2: a dministrative t ools idle timeout if you want to ensure that a console login user is employing the link constructively and not leaving the system vulnerable to a security breach, set an idle timeout using the following command: set command idle_timeout example: set command idle_time...

  • Page 33

    Reconfiguring your system 33 example: set system name “big house” location dc contact “staff, ext 555” transmit_system_na “fob running script files the do command is a powerful tool to configure multiple users, protocols, or other functionality by running a script file containing command line interf...

  • Page 34

    34 c hapter 2: a dministrative t ools hangup command to close an interface (hangup and leave the interface(s) in an enabled state), use the following command: hangup interface to make a modem group unavailable for dial-in users, use the following command. It has the same effect as hanging up the pho...

  • Page 35

    Reconfiguring your system 35 network services to use cleartcp, snmp, or dial-out and to set values associated with them, add each network service and related parameter. Telnet and tftp are already enabled at startup although you can add additional services whenever necessary. For more information ab...

  • Page 36

    36 c hapter 2: a dministrative t ools data ancillary data. Format one or more values with the following syntax. Using the list network services command after typing the example above displays the following: auth=on/off on indicates that login/ password authentication should be performed on incoming ...

  • Page 37

    Reconfiguring your system 37 enabled when you add a network service, it is enabled by default. When changing any parameter, you must first disable the service (see section below for more information), make your changes, then re-enable the service. For example, for a network service named telnet user...

  • Page 38

    38 c hapter 2: a dministrative t ools next, from a machine that has access to the same network, use the following tftp commands to transfer the filter file to flash memory. Tftp put use list files to verify the file was sent to the ras 1500. Important: do not transfer binary files. Transferring bina...

  • Page 39

    Troubleshooting commands 39 troubleshooting commands viewing facility errors the set facility command allows you to set and view log levels for the system processes, ensuring that error messages reaching the threshold for that facility are output to the console port. Although messages are sent to th...

  • Page 40

    40 c hapter 2: a dministrative t ools resolving host names before you can resolve a host, you must have added a domain name service (dns) local host and server entry for resolution. To do so, use the add dns host address and add dns server commands. Example: add dns server 133.114.121.45 preference ...

  • Page 41

    Troubleshooting commands 41 example: ping 199.55.55.55 count 3 verbose yes the command would display the following: a ping of a single count produces the following, for example: ping destination: camel status: alive setting ping row ceiling the set ping maximum_rows command sets the maximum number o...

  • Page 42

    42 c hapter 2: a dministrative t ools well as other system information that may be useful when consulting 3com technical support. Viewing interface status, settings several commands are useful to display the active/inactive status and settings of specific interfaces (ports). They include the followi...

  • Page 43

    Displaying system information 43 show commands you can use show commands to view the current configuration and its routing activity. A few of the show commands used for troubleshooting are covered in this section, including the following: ■ show memory ■ show connection settings ■ show connection co...

  • Page 44

    44 c hapter 2: a dministrative t ools ■ global username — the default is default. ■ command prompt — displayed when user dials in. ■ service prompt — prompt after dial-in user logs in (login or network service types available). ■ message prompt — prompt following service prompt for login/network ser...

  • Page 45

    Displaying system information 45 ■ start date — start date of a connection established on the specified interface. ■ start time — start time of a connection established on the specified interface. An example is shown below. Connections ifname user name type dll start date start time rm0/slot:1/ mod:...

  • Page 47: Outer

    3 r outer c ommand o verview this chapter contains the following information: ■ command format ■ entering commands ■ command language structure command format many commands are position-independent and multitiered and use keywords. Multitiered commands let you type the base command (for example, set...

  • Page 48

    48 c hapter 3: r outer c ommand o verview parameters ■ { … } parameters enclosed by curly braces are optional and are provided with default values. You do not need to specify these parameters unless you wish to override the default. ■ … > values enclosed by arrows are used by a command or parameter ...

  • Page 49

    Entering commands 49 b) takes you back one word; (esc f) takes you forward one word; (ctrl a) takes you to the beginning of a command; (ctrl e) takes you to the end of a command, and (ctrl d) or (ctrl k) deletes a selected character. Abbreviation and command completion ■ commands can be abbreviated ...

  • Page 50

    50 c hapter 3: r outer c ommand o verview ■ configuration changes are impermanent: they occur immediately but are lost on reboot unless you save them because the save all command places configuration changes in flash memory. These changes are lost by the superstack ii remote access system (ras) 1500...

  • Page 51

    Entering commands 51 interface ranges interfaces can be expressed as variants of the x/slot:y/mod:z format, where x is the unit type (either rm0 for the ras 1500 base unit, pau0 for the primary rate access unit (pau), or pem0 or pem1 for the ras 1500 expansion unit), y is the slot number (the pau al...

  • Page 52

    52 c hapter 3: r outer c ommand o verview users a user entity is a table of parameters that are used when establishing a network connection. The add user and set user commands define the parameters of a user. The user commands are employed when making wide area network (wan) (dial-in) connections an...

  • Page 53

    ■ login host — made available for user connections. ■ route — describes a path through the network to another system/network. Table entries are created with an add command and removed with a delete command. The add command specifies the most important parameters of the entry. Additional parameters a...

  • Page 55: Outer

    4 r outer c ommand r eference this chapter contains the following information: ■ overview ■ add commands ■ assign command ■ bye command ■ copy command ■ delete commands ■ dial/dialout commands ■ disable commands ■ disconnect command ■ do command ■ enable commands ■ exit command ■ hangup commands ■ h...

  • Page 56

    56 c hapter 4: r outer c ommand r eference ■ reboot command ■ reconfigure command ■ rename command ■ reset commands ■ resolve command ■ rlogin command ■ save commands ■ set commands ■ set user commands ■ show commands ■ telnet commands ■ unassign command ■ verify command ■ dial-in user commands ■ te...

  • Page 57

    Add commands 57 ■ interface — describes physical devices, for example, ports. ■ syslog host — receives system messages. ■ dns server — translates ip addresses to and from host names. ■ login host — made available for user connections. ■ route — describes a path through the network to another system/...

  • Page 58

    58 c hapter 4: r outer c ommand r eference add appletalk network zone defines an appletalk network and the zone(s) that are part of that network. Add bridge access_ mac_address adds to the list of devices which are allowed to access bridge network(s). A bridge must have been previously defined, usin...

  • Page 60

    60 c hapter 4: r outer c ommand r eference add dns server preference name adds the ip address of a remote dns server to the domain name server table. The preference number specifies the order dns servers in this table are accessed, with 1 as the highest preference and 10 as the lowest. The first spe...

  • Page 61

    Add commands 61 verify filter command to check the filter syntax. You can view the filters using the show filter command and verify that the filter is correct by using the show file command. Filter files are stored as ascii files in flash memory. Add frame_relay pvc dlci interface user configures a ...

  • Page 62

    62 c hapter 4: r outer c ommand r eference initialization script to a switched interface, that string is sent to the serial line driver whenever a connection terminates, to ready the modem for the next connection. You need not assign init scripts to modems. The maximum is 32 initialization scripts. ...

  • Page 64

    64 c hapter 4: r outer c ommand r eference the ras 1500 automatically derives subnet masks for aggregate users but a mask can be configured for no_aggregate users. Users assigned to more than one pool receive an address from the last assigned pool in round robin fashion. Also, if the administrator r...

  • Page 65

    Add commands 65 static routes are installed but not visible via the list ip routes command until the interface to the gateway is active (entered in the forwarding table). Add ip udp_bcast_ forwarding_port add ip udp_bcast_forwarding_port identifies the source port number from which user datagram pro...

  • Page 66

    66 c hapter 4: r outer c ommand r eference add ipx route address> gateway [ipx_host_address] metric [1-15] ticks [tick_number] adds an ipx static route to the system ipx route table, which defines static routes to remote ipx networks. The command list ipx routes displays currently defined static rou...

  • Page 67

    Add commands 67 indicate the next router hop. To remove this service, use the delete ipx service command. See the show ipx settings command for more information. The following is a list of ipx services available: parameter description designation of ipx service. Limit: 32 ascii characters. Address i...

  • Page 68

    68 c hapter 4: r outer c ommand r eference add login_host address [ip_address] preference [number] rlogin_port [tcp_port_number] telnet_port [tcp_port_number] cleartcp_port [tcp_port_number] adds up to ten login hosts to the login host table. You add login hosts so users of type login connecting to ...

  • Page 69

    Add commands 69 the default modem group, “all,” cannot be modified. Example: add modem_group dialout interfaces rm0/slot:1/mod:[1-4],pem0/slot:1/mod:1 add nat dynamic user count public_pool_start configures, and associates a name with, a specific number of isp-assigned addresses for dynamic network ...

  • Page 70

    70 c hapter 4: r outer c ommand r eference addresses that you configured by using this command. The ras 1500 maintains a table of active ip addresses on the public network mapped to user ip addresses on the private network for the connection. Once the connection to the public network is closed, the ...

  • Page 71

    Add commands 71 each time the ip address on the private network, “1.1.1.1” connects to the public network, static nat translates the ip address and connects it to the static assigned addresses, “2.2.2.2”. The ras 1500 maintains a table of active mappings between ip addresses on the private network m...

  • Page 72

    72 c hapter 4: r outer c ommand r eference the next table shows configurable parameters for network service, which are specified with the data value. Parameter description name of this type of service. Limit: 64 ascii characters. Close_active_ connections indicates whether to close any active connec...

  • Page 73

    Add commands 73 . Add network service examples: to configure a cleartcp service (not authenticating upon connect) to offer modem sharing on tcp port 6000 using the first modem in the second slot in the ras 1500, enter the following: add modem_group “hi boston” interface rm0/slot:2/mod:1 add network ...

  • Page 74

    74 c hapter 4: r outer c ommand r eference do not create more than one dialout service with the same name on a network. To configure a telnet service to offer cli access on port 6666, doing authentication upon connect (default) and dropping the connection on hangup, enter the following: add network ...

  • Page 76

    76 c hapter 4: r outer c ommand r eference adds an ip host to the list of ip hosts that receive syslog entries. You can see the current log levels for the system using list facilities. You can modify the current loglevel for each facility using set facility loglevel . All syslog messages generated b...

  • Page 77

    Arp command 77 administrators creating remote authentication dial-in user service (radius) users should consult appendix e: radius authentication for more information. Arp command arp _address> learns the ip address (and media access control address — ethernet address — if on a locally connected net...

  • Page 78

    78 c hapter 4: r outer c ommand r eference for example, at the prompt, enter the following: ras1500>> arp houston the ras 1500 generates the following output: ras1500>> arp: 156.155.132.145 -> 08:00:20:80:43:85 assign command assign interfaces modem_group adds interfaces to an existing modem group o...

  • Page 79

    Bye command 79 bye command bye exit the cli, but keep this connection open. This command returns you to the dial-in user or telnet commands. Copy command copy file copies a file within the flash file system. This is a flat file system. Delete commands delete commands remove anything you previously a...

  • Page 80

    80 c hapter 4: r outer c ommand r eference delete configuration removes all your configuration files, reboots the system, and restores system configuration to default values. For your protection, you are prompted to confirm the request. Delete datalink frame_relay deletes the configuration of the se...

  • Page 81

    Delete commands 81 deletes the framed route user you created with the add frame_route user command. Delete init_script removes a modem initialization string from the init_script table. Use list init_scripts to see which modem initialization scripts you have added. Delete ip defaultroute deletes the ...

  • Page 82

    82 c hapter 4: r outer c ommand r eference udp_bcast_forwarding_port command to add the port number on the private network from which udp packets are forwarded. Delete ipx network deletes an ipx network on the interface you specified with the add ipx network command. You can list ipx networks to see...

  • Page 83

    Delete commands 83 delete nat dynamic user deletes the configuration you established for dynamic nat through the add nat dynamic user command. Delete nat static user deletes the configuration you established for static nat through the add nat static user command. Delete network service deletes the s...

  • Page 84

    84 c hapter 4: r outer c ommand r eference delete syslog address> removes the specified ip host name or address from the list of addresses that are authorized to receive syslog information. Use list syslog to see the currently allowed addresses. Delete tftp client removes the specified ip host name ...

  • Page 85

    Disable commands 85 ■ remote — authentication based on a password stored in a radius or tacacs+ server. Issue the show authentication command to display settings. Use the show critical_event settings command to view logging configuration and event sinks. Disable dns host_rotation disables the ras 15...

  • Page 86

    86 c hapter 4: r outer c ommand r eference example: rm0/slot:1/mod:[1-4],pem0/slot:1/mod:[1-4] example: disable interface rm0/slot:1/mod:[1-4],pem0/slot:1/mod:1 disable ip address_pool_ filtering disables packet filtering on all internet protocol (ip) address pools (drops packets for ip addresses wi...

  • Page 87

    Disable commands 87 disable ipx network disables the specified ipx network. Use list ipx networks to see which ipx networks are defined and their current status. Disable ipx rip network disables the rip routing protocol on the specified ipx network. This saves system space by barring a large rip dat...

  • Page 88

    88 c hapter 4: r outer c ommand r eference disable user disables the specified user from being used. This affects dial-in users and wan connections that depend on that user for parameters. It also causes all active sessions established using that particular user to terminate and does not allow any n...

  • Page 89

    Enable commands 89 issue the show authentication command to display current settings. Enable bridge access_mac_address enables the specified mac address to use the bridged network connection. You must have previously run add bridge access_mac_address before using this command. If a mac address is no...

  • Page 90

    90 c hapter 4: r outer c ommand r eference enable dns host_rotation enables the ras 1500 process of randomly choosing a primary ip address and up to eight alternates from the dns cache. Use the show dns command to view the current setting. Enable dns host_rotation enables the ras 1500 process of ran...

  • Page 91

    Enable commands 91 enable ip address_pool_ filtering permits packet filtering on all ip address pools. Use the show ip command to view the current setting. Enable ip forwarding allows all ip networks to forward (route) packets. You should use this command only if you previously used the disable ip f...

  • Page 92

    92 c hapter 4: r outer c ommand r eference discarded. Of the two drop commands, this is the highest level of security. Default: enabled. ■ partial tcp headers (offset=1) — protocol field in the ip packet header (in this case, tcp). Packets of this type can be discarded. Lower level of security than ...

  • Page 93

    Enable commands 93 enable ipx rip network enables the rip protocol for the specified ipx network. Rip is normally enabled when you add an ipx network. You can see if rip is currently enabled (on) using the show ipx rip or show ipx network commands. Enable ipx sap network enables the sap on the speci...

  • Page 94

    94 c hapter 4: r outer c ommand r eference enabled is the default. You can use list users to see which users are currently disabled. Exit command exit leave the cli, but keep this connection open. This command returns you to dial-in user or telnet commands. Hangup commands cuts interface or modem gr...

  • Page 95

    Help command 95 hangup modem_group makes the modem group unavailable for dial-in users. This command has the same effect as hanging up the phone. See add modem_group , list modem_groups and show modem_group commands for more information. Help command help provides information about possible commands...

  • Page 96

    96 c hapter 4: r outer c ommand r eference example: kill command kill stops an active process. Use the list processes command to view active processes. You can only kill a process that you started, for example, a ping command. You must type uppercase letters and type the full process name when issui...

  • Page 97

    List commands 97 list commands displays information saved as entries in the ras 1500 tables. List active interfaces displays the operational status, administration status, and name of all active interfaces. The output is the same as that from the list interfaces command, except nonactive interfaces ...

  • Page 98

    98 c hapter 4: r outer c ommand r eference ■ initializing ■ configuring ■ enabling ■ enabled ■ disabling ■ disabled ■ invalid ■ terminating ■ type — static or dynamic. ■ network address — address range of this entry. List appletalk routes displays the entries in the appletalk routing table. The tabl...

  • Page 99

    List commands 99 list bridge access_mac_address displays the mac addresses of the systems that have access to the bridge network. Use add bridge access_mac_address to add addresses and delete bridge access_mac_address to remove them. The mac address access list is not used unless you run the enable ...

  • Page 100

    100 c hapter 4: r outer c ommand r eference list available servers displays the available network servers and supported network services. The choices are dial-out service, snmp service, telnet service, tftp service, or cleartcp. The services listed by this command are used in the server_type field o...

  • Page 101

    List commands 101 ■ dial-in — user connection established for dial-in purposes. Led lights amber when modem is unhooked, green when call is connected. ■ bond — user connection utilizing bandwidth allocation. ■ dedicated — user connection established for a particular user. ■ dll — data link layer tha...

  • Page 102

    102 c hapter 4: r outer c ommand r eference ■ lease — a defined period of time that an ip address is assigned by the dhcp server for temporary use by the local user. The minimum is 1 second; maximum, 12 hours; default, 4 hours. ■ fsm state — defined as “finite state machine.” it defines the current ...

  • Page 103

    List commands 103 ■ address — ethernet address of the remote station: ip address for ip, mac address for ipx. If an ip, ipx, or no client is attached to the ras 1500 port, this value is all zeros. List dns cache displays the following entries in the dns cache table: ■ number — row number in dns cach...

  • Page 104

    104 c hapter 4: r outer c ommand r eference ■ type — dns type of the resource record in the cache that is identified in this row of the table. ■ dns servers. List dns servers displays dns name servers, which you configured using the add dns server command. It lists the following: ■ preference — serv...

  • Page 105

    List commands 105 individual modems using the set switched interface command. The default initialization script usr_int carries the at command ats0=0. You can modify existing initialization scripts using the set init_script command.List init_scripts list interfaces displays the installed interfaces,...

  • Page 106

    106 c hapter 4: r outer c ommand r eference ■ type — ethernet interface type: dynamic. ■ ifname — lan interface name: rm0/eth:1. List ip interface_block displays the ip addresses associated with each system interface. If the interface has a point-to-point connection, the neighbor field contains the ...

  • Page 107

    List commands 107 ■ route — indicates whether pool is being broadcast as a single network (aggregate) or separate networks (no_aggregate).Default: no_aggregate. ■ status — indicates current condition of pool. The following are the choices: ■ active — pool is available to assign user ip addresses fro...

  • Page 108

    108 c hapter 4: r outer c ommand r eference list ipx networks displays the ipx networks that you previously defined using the add ipx network command. It lists the following: ■ name — designation you assigned this network. ■ prot — protocol; always ipx. ■ int — interface on which each ipx network. ■...

  • Page 109

    List commands 109 list ipx static routes displays all ipx static routes previously defined using the add ipx route command. It lists the following: ■ network address(es) — network address requiring this route. ■ nexthopnic — network address of the next router in the routing path. ■ gateway — address...

  • Page 110

    110 c hapter 4: r outer c ommand r eference list modem_groups displays modem groups that you previously defined using the add modem_group command and the number of ports in each group. This command also lists the default modem group, all, for example: list nat user displays settings of actively mapp...

  • Page 111

    List commands 111 ■ int — ethernet interface the network is running on: rm0/eth:1, loopback, internal, x/slot:y/mod:z (where x is the type of unit (rm0 for the ras 1500 unit; pem0 or pem1 for the ras 1500 expansion unit), y is the slot number, and z is the modem number, for example, rm0/slot:1/mod:1...

  • Page 112

    112 c hapter 4: r outer c ommand r eference ■ size — size of data to be transmitted, in bytes. Default: 64 bytes. ■ ttl — ping message time-to-live (ttl) period. Default: 20 seconds. List ppp displays ppp bundles and links. When multiple physical links are combined to run multilink ppp (mlppp) (rfc1...

  • Page 113

    List commands 113 ■ conn(ection) type — active session link type. Lan, wan, or unknown. ■ prot(ocol) type — active session protocol. Ppp, slip, telnet, rlogin, cleartcp, or unknown. List snmp communities displays the snmp communities defined using the add snmp community command. It lists the followi...

  • Page 114

    114 c hapter 4: r outer c ommand r eference ■ oper(ating) status — current operating state of the interface: upor down. Oper status is up only if modem is connected. ■ admin(istrative) status — state of the interface configured by the administrator: upordown. List syslogs displays ip addresses that ...

  • Page 115

    List commands 115 list tftp clients displays ip addresses of all users allowed to use the tftp to connect to the system. Use the add network service command to add tftp support to the system and the add tftp client command to authorize users to connect. Example: list udp listeners displays udp ports...

  • Page 116

    116 c hapter 4: r outer c ommand r eference ■ type — type of configured user. See the add user command for more information. Logout command logout leave the cli and close this connection. This ends the dial-in user or telnet session. Monitor commands monitor ppp allows monitoring of real-time ppp ac...

  • Page 117

    Monitor commands 117 to monitor ppp events using this command, first issue a show events command as a managed user dialing in. Monitor ppp is limited to checking ppp data streams. The command performs the following types of monitoring: ■ monitoring ppp call events — displays internal ppp states as t...

  • Page 118

    118 c hapter 4: r outer c ommand r eference idle timer while monitoring is active and no data is displayed, the program displays an idle message to verify it is active. Example: decode and hexadecimal display interface, user, and next session monitoring display two types of data: decode and hexadeci...

  • Page 119

    Paused commands 119 data string value specifying data to be sent. Note: if data length is bigger than ping size, only the first ping size octets are used. If data length is zero, the server uses random data. If data length is smaller than ping size, the data pattern is repeated as many times as nece...

  • Page 120

    120 c hapter 4: r outer c ommand r eference a ping with the verbose parameter selected displays the following: quit command quit leave the cli, but keep this connection open. This command returns you to the dial-in user or telnet commands. Reboot command reboot reboots the system. If you have made a...

  • Page 121

    Rename command 121 administrator having to remove the router from service by manually disabling the network, modifying its parameters, and re-enabling it. This command modifies static ip lan networks only (cannot change interface and frame values for an internal address). Network and interface names...

  • Page 122

    122 c hapter 4: r outer c ommand r eference resolve command resolve name returns an ip address for the specified host name by sending it to dns for resolution. If the domain name is specified using the set dns command, it is also resolved, otherwise you must specify it as part of the name. This comm...

  • Page 123

    Set commands 123 set commands changes any parameter you specified with an add command, with the exception of certain accounting and authentication commands that are not preconfigured by add commands. Set accounting this field is a keyword. The possible values are the following: primary_port primary_...

  • Page 125

    Set commands 125 sets parameters for all appletalk networks, including the following: set authentication primary_port primary_secret primary_server retransmissions secondary_port secondary_secret secondary_server timeout type configures remote (radius) authentication for up to three servers. Use sho...

  • Page 126

    126 c hapter 4: r outer c ommand r eference set bridge aging_time forward_delay spanning_tree_priority sets parameters for all bridge networks. Set cleartcp connect_message configures the string that is sent to cleartcp clients, when the tcp connection is established. The message string must be encl...

  • Page 127

    Set commands 127 characters b, f, n, r, t, or v, the ras 1500 places special characters in the string, as follows: ■ \b = backspace ■ \f = formfeed ■ = newline ■ \r = carriage return ■ \t = tab ■ \v = vertical tab if the string is followed by an x, the next two characters are interpreted as a hex...

  • Page 130

    130 c hapter 4: r outer c ommand r eference sets the ras 1500 to implement dhcp as a relay. Dhcp relay forwards dhcp requests to the dhcp server. The dhcp server processes the request and sends the ip information back to the dial-in user via the ras 1500 . Set dhcp server dns1 dns2 domain end_addres...

  • Page 131

    Set commands 131 sets the ras 1500 to implement dhcp server. As a server, the ras 1500 provides the information specified by the above parameters in response to a dhcp request. Parameter description dns1 primary dns that processes and responds to request for ip information. Dns2 secondary dns that p...

  • Page 133

    Set commands 133 set dns server preference name address [ip_address] this command redefines the name of a domain name server, which you previously defined using the add dns server command. Use the list dns servers command to see the currently defined dns servers. Parameter description cache enables ...

  • Page 134

    134 c hapter 4: r outer c ommand r eference set dst off amount_to_correct day_of_week [friday monday saturday sunday thursday tuesday wednesday] month [april august december february january july june march may november october september] time_to_correct week_of_month sets time to adjust for the end...

  • Page 135

    Set commands 135 sets daylight savings time to on. Set facility loglevel [level] sets the severity reporting level of a facility to display messages on the console (your hard-wired connection to the ras 1500) or on a pc telnetted to the ras 1500. Use the list facilities command to view the current l...

  • Page 137

    Set commands 137 parameter description the type of module you want to configure: router unit, pem, or pau for isdn access. At_command configures modem to dial and answer. Call_type identifies that type of connection from the incoming call. The possible call types are auto, clear, internet, modemfax,...

  • Page 139

    Set commands 139 set ip address_assign_ mode dhcp_proxy ip_pool configures the ras 1500 to assign ip addresses either through using the dhcp feature or through the ip pool feature. The ras 1500 automatically attempts to request the ip address from the ip pool first. If an address cannot be assigned ...

  • Page 141

    Set commands 141 ■ accept default — disabled by default. Determines whether router accepts default route advertisements. ■ split horizon — enabled by default. Records the interface over which it received a particular route and does not propagate its information about that route back over the same in...

  • Page 142

    142 c hapter 4: r outer c ommand r eference parameter description designation of the ip network for which you want to set parameters. Limit: 64 ascii characters. Broadcast_algorithm algorithm determines which address is used in broadcasts to represent the entire network. Choices: ■ 0 - the bsd stand...

  • Page 144

    144 c hapter 4: r outer c ommand r eference set ip routing autonomous_system_number [number] metric_maximum_entries [number] rip_flags [metrics, send_request] router_id [ip_address] sets global parameters for ip routing on the specified ip router address that serves as the gateway to an autonomous s...

  • Page 146

    146 c hapter 4: r outer c ommand r eference sets configuration of the specified ipx network created with the add ipx network command. Parameter description designation of the ipx network. Maximum size: 64 characters. Delay_ticks interval in number of ticks it takes to reach this ipx network. Default...

  • Page 147

    Set commands 147 set ipx system default_gateway [ipx_host_address] initial_pool_address [ipx_network_address] max_hops [number] name [string] number [internal network number] pool_members [number] sets parameters for dynamic ipx networks. The maximum number of hops allowed in 15. Set login_host pref...

  • Page 149

    Set commands 149 note: parameters set with this command are associated with the specified interface, not the modem group. Be aware that when you change parameters of interfaces assigned to multiple modem groups, the last change you make to a group containing any associated interface reflects the lat...

  • Page 150

    150 c hapter 4: r outer c ommand r eference host_type identifies how dial in connection is set up. The options are the following: ■ prompt — prompted to enter host name or address. Default. ■ select — a host is chosen from a login host list you specify, configured by the set connection command. ■ sp...

  • Page 154

    154 c hapter 4: r outer c ommand r eference modifies parameters for an snmp community (authorized user or host to which notifications are sent) configured with the add snmp community command. The community name and ip address of snmp requests from managers on the network must match the list, which y...

  • Page 155

    Set commands 155 configures port parameters for the specified switched (modem) interface (for example, rm0/slot:2/mod:1). To display the switched interfaces you have configured, use the list switched interfaces command. To view settings for a particular interface, use the show interface settings com...

  • Page 156

    156 c hapter 4: r outer c ommand r eference connection_type sets connection type for switched interface. Options: ■ direct_net — uses the protocol parameter setting to create a network (virtual node) connection. Employs username and password specified in this command. Authentication is done by the n...

  • Page 157

    Set commands 157 message string to display to a dial-in user when connection is set. Limit: 64 ascii characters. You can use $value to stipulate more parameters in the message line for identification purposes. ■ $date — current date according to system uptime. ■ $callid — user call identification ac...

  • Page 159

    Set commands 159 set system name [name] location [location] contact [contact information] transmit_authentication_name [keyword] specifies system information, displayed using show system. The transmit authentication keyword (limit: 64 ascii characters) is used when the ras 1500 receives a challenge....

  • Page 161

    Set user commands 161 parameter description input_filter designation of the filter file in flash memory to be applied to the input datastream. Message string to display to a dial-in user when connection is set. Limit: 64 ascii characters. You can use $value to stipulate more parameters in the messag...

  • Page 162

    162 c hapter 4: r outer c ommand r eference set dialout user local_ip_address [ip_network_address] reply1_script [“string”] reply2_script [“string”] reply3_script [“string”] reply4_script [“string”] reply5_script [“string”] reply6_script [“string”] send1_script [“string”] send2_script [“string”] sen...

  • Page 164

    164 c hapter 4: r outer c ommand r eference set framed_route user gateway [ip_address] ip_route [ip_address] metric [number] specifies a framed (static) network to the user profile for dial-up connections. See also add framed_route user and add ip route commands. Bridging indicates whether the conne...

  • Page 167

    Set user commands 167 default_route_option enables or disables the default route option. If enabled, the system sets the ip address of a remote default router by negotiation. This parameter takes precedence over a default route set by the add framed_route user or add ip defaultroute command. Default...

  • Page 170

    170 c hapter 4: r outer c ommand r eference parameter description name user, previously defined using add user with network as the type. Limit: 32 ascii characters. Channel_decrement when line usage on the second channel drops below this percentage, ppp drops the second or more channel. Default: 0.R...

  • Page 171

    Show commands 171 show commands display detailed information about a specific table entry or a set of scalars (nontable items). Show accounting or show accounting settings displays radius accounting settings. You can modify these using the set accounting command. ■ use servers — specifies how accoun...

  • Page 172

    172 c hapter 4: r outer c ommand r eference show accounting counters displays statistics stored by radius accounting servers. ■ number of local users — number of lan users radius is tracking. ■ number of active users — sum of users radius is tracking. ■ udp packets received — number of packets recei...

  • Page 173

    Show commands 173 show appletalk or show appletalk settings displays current settings for appletalk, which you can modify using the set appletalk command. Example: look up replies received: 0 broadcast requests received: 0 forward requests received: 0 look up replies sent out: 0 registration failure...

  • Page 174

    174 c hapter 4: r outer c ommand r eference show authentication or show authentication settings displays the radius and local user authentication settings, which you can modify using the set authentication command. It lists the following: ■ local authentication is — enabled (default)/disabled. ■ rem...

  • Page 175

    Show commands 175 ■ remote no responses — number of times radius failed to answer an authentication request (with an error message) on this server. Show bridge or show bridge network settings displays information about the specified bridge network. You use add bridge network to define bridge network...

  • Page 176

    176 c hapter 4: r outer c ommand r eference ■ current idle timeout — show configuration or show configuration settings displays a variety of system information including system, network, protocol, interface, forwarding, routing, dns, host, and data link parameters. Show connection or show connection...

  • Page 177

    Show commands 177 ■ critical event backup — where critical events are logged, if the first destination fails. Default: @file:/./old-log-file.Local show date displays the system date, time, and uptime. The time is expressed in gmt. Example: show dhcp mode displays the configured mode type: disabled, ...

  • Page 178

    178 c hapter 4: r outer c ommand r eference renew request tx: 0 rebind request tx: 0 decline tx: 0 release tx: 0 inform tx: 0 offer rx: 0 ack rx: 0 nak rx: 0 show dhcp proxy settings displays the current statistics of the dhcp proxy mode in the following format: dhcp proxy configuration setting serv...

  • Page 179

    Show commands 179 show dhcp server counters displays the current statistics of the dhcp relay mode in the following format: lease requests received:0 lease accepts received:0 lease renewals received: 0 lease refusals received: 0 lease releases received: 0 unrecognized packets received: 0 lease offer...

  • Page 180

    180 c hapter 4: r outer c ommand r eference ■ number retries per server — number of times the resolve name request is sent to each name server, if the server fails to respond to a request before the timeout period. ■ timeout period in seconds — number of seconds to wait before deciding a request to ...

  • Page 181

    Show commands 181 ■ data — rdata portion of a cached rr. The value is in the format defined for the particular dns class and type of the resource record. See rfc-1035, section 3.2.1 for more information. ■ (error) status — status column for the resolver cache table. Since only the agent (dns resolve...

  • Page 182

    182 c hapter 4: r outer c ommand r eference ■ server does not implement request — server was able to accept a request. ■ corrupted responses — response did not decrypt. ■ timeouts — number of time outs waiting for the server to respond. ■ response could not be sent — the requester had terminated. ■ ...

  • Page 183

    Show commands 183 ■ type — dns type of the resource record at this row in the table. ■ ttl — time-to-live period in seconds of the resource record. ■ elapsed ttl — period in seconds since resource record was received ■ dns server — ip address of the fully qualified name. ■ error code — type of autho...

  • Page 184

    184 c hapter 4: r outer c ommand r eference show file hex displays the contents of a hexadecimal file. For example (log-file.Local): show filter displays the filter rules for all protocols specified in this file. The file name specified must be a filter file (filter.Fil). See the show filter protoco...

  • Page 185

    Show commands 185 for example (easyfilter.Fil): show filter protocol [atalk, atalk-arap, atalk-call, atalk-rtmp, atalk-zip, br-eth, br-eth-call, ip, ip-call,ip-rip, ipx, ipx-call, ipx-rip, ipx-sap, login-access] displays filter rules based on protocol options specified. The filter name must be a fil...

  • Page 186

    186 c hapter 4: r outer c ommand r eference show icmp counters displays input and output counters for icmp messages. Traceroute-generated packets received by the ras 1500 do not increment the icmp error counts time exceeded and destination unreachable. Also, a number of icmp error messages are sent ...

  • Page 187

    Show commands 187 ■ address masks — sum of icmp address mask reply messages. Error messages sent to syslog host. ■ address mask replies — sum of icmp request messages concerning the ability of a host to gather network information. Error messages sent to syslog host. ■ advertise — sum of router adver...

  • Page 188

    188 c hapter 4: r outer c ommand r eference pem0 or pem1 for the ras 1500 expansion unit), y is the slot number, and z is the modem number. Example: rm0/slot:1/mod:1 ). This command displays the following: ■ description — name of the interface driver. Ethernet or modem drivers. ■ type — kind of phys...

  • Page 189

    Show commands 189 ■ output filter — name of the output enabled filter for the specified interface. ■ host type — type of host this dial-in user is currently connected to. Choices: prompt, select, and specified. Default: select. ■ connection type — kind of connection this interface is configured for....

  • Page 190

    190 c hapter 4: r outer c ommand r eference example: rm0/slot:1/mod:1 ). This command displays the following: input counters ■ octets — number of bytes received. ■ ucast — number of unicast packets received. ■ multicast — number of multicast packets received. ■ broadcast — number of broadcast packet...

  • Page 191

    Show commands 191 show ip or show ip settings displays system-wide ip information: ■ ip system host address — ip address of the ras 1500. ■ ip forwarding — status of forwarding of ip packets. ■ ip address pool filtering — status of pool filtering. ■ udp broadcast forwarding — status of udp broadcast...

  • Page 192

    192 c hapter 4: r outer c ommand r eference ■ datagrams successfully fragmented — datagrams successfully fragmented before transmission. ■ fragmentation failures — failed datagram fragmentations before transmission. ■ total fragments — sum of fragments transmitted. Show ip network or show ip network...

  • Page 193

    Show commands 193 show ip routing or show ip routing settings displays parameter settings for the specified ip network. Statistics are gathered from parameters configured by the set ip routing command. It lists the following: ■ ip router administrative status — whether status is enabled or not. Defa...

  • Page 194

    194 c hapter 4: r outer c ommand r eference ■ ip rip flags — type of ip rip flags enabled. Show ip security or show ip security settings displays state (enabled or disabled) of ip security settings. The settings shown below are defaults. See the enable ip security_options commands for more informati...

  • Page 195

    Show commands 195 ■ dynamic address pool begin — starting ipx address. ■ number of dynamic pool members - number of addresses to reserve for dynamic ipx address assignments. Show ipx counters displays counters for all ipx network activity. It lists the following: input counters ■ total packets recei...

  • Page 196

    196 c hapter 4: r outer c ommand r eference ■ decompression errors — sum of incoming packets discarded due to compression errors. Output counters ■ total packets transmitted — sum of ipx packets transmitted. ■ forwarded packets — sum of ipx packets forwarded. ■ local transmits — sum of ipx packets t...

  • Page 197

    Show commands 197 ■ netbios cache timer (sec) — interval a netbios system is kept in the cache. Default: 60. ■ netbios maximum hops — greatest number of hops this network makes to locate a netbios system. Default: 8. ■ rip state — status: on, off, auto on, or auto off. Default: on. ■ rip pace — fast...

  • Page 198

    198 c hapter 4: r outer c ommand r eference show ipx rip or show ipx rip settings displays information about rip for ipx. It lists the following: ■ state — on or off. ■ incorrect rip packets — number of rip packets that do not make sense. Show ipx rip counters displays the sum of incorrect rip packe...

  • Page 199

    Show commands 199 show modem_group displays the switched interfaces that belong to the specified modem group and their status. Example: show network or show network settings displays the configured settings for the specified network. For an example, see the output from the show ip network command ab...

  • Page 200

    200 c hapter 4: r outer c ommand r eference show packet_logging or show packet_logging settings displays settings for packet size and logging. See the set packet_logging command for more information. Example: show ping or show ping settings displays general ping settings you specified using the ping...

  • Page 201

    Show commands 201 ■ replies received — number of pings received when this row became active. ■ timeouts occurred — number of requests timed-out since this row became active. ■ last round trip — round trip time in milliseconds experienced by the last request-reply iteration. A round trip value of -1 ...

  • Page 202

    202 c hapter 4: r outer c ommand r eference average time is expressed in milliseconds. Also, a value of -1 indicates the ping system failed. See show ping server settings below for more information. Show ping server ip_address> or show ping server settings displays ping server settings you specified...

  • Page 203

    Show commands 203 show ppp on interface , or show ppp on interface name> settings displays ppp settings on the specified wan interface when interface is active. The interface name can be either rm0/eth:1 (the lan interface), loopback, internal, or x/slot:y/mod:z (where x is the type of unit (rm0 for...

  • Page 204

    204 c hapter 4: r outer c ommand r eference settings for ppp link ■ operational status — opened or not opened. ■ interface index — index number of the interface used. ■ local mru — mru the remote entity uses when sending packets to local ppp entity. Default: 1514. ■ remote mru - mru the local entity...

  • Page 205

    Show commands 205 ■ remote to local compression protocol — protocol used by the remote ppp entity when it compressed the local ppp entity. Settings for ppp bundle 20 operational status: opened number active links: 1 user profile: n1 local mmru 1514 remote mmru: 1514 local endpoint class: ieee mac ad...

  • Page 206

    206 c hapter 4: r outer c ommand r eference show ppp on interface name> counters displays statistics for ppp running on the specified interface when interface is active. The interface name can be either rm0/eth:1 (the lan interface), loopback, internal, or x/slot:y/mod:z (where x is the type of unit...

  • Page 207

    Show commands 207 ■ received packets — sum of packets received from a lower layer application over this bundle. ■ bytes to upper layer — sum of bytes to be handed up to an upper layer application over this bundle. ■ bytes from lower layer — sum of bytes received from a lower layer application over t...

  • Page 208

    208 c hapter 4: r outer c ommand r eference ■ primary nbns server address — ip address for the primary netbios name server (nbns) server. In the absence of a user-specific nbns address, this is sent in ipcp negotiation. ■ seconday nbms server address — ip address for the secondary nbns server. In th...

  • Page 209

    Show commands 209 see the add slip session_start_message command for information on writing the message. Example: show snmp counters displays many snmp statistics. It lists the following: input counters ■ packets — number of snmp packets received. ■ bad versions — snmp messages for an unsupported sn...

  • Page 210

    210 c hapter 4: r outer c ommand r eference ■ set request pdus — sum of snmp get-next pdus accepted and processed. ■ get response pdus — sum of snmp get-response pdus accepted and processed. ■ trap pdus — sum of snmp trap pdus accepted and processed. Output counters ■ packets — sum of snmp packets t...

  • Page 211

    Show commands 211 ■ system services — for example, internet endtoend applications. ■ system transmit authentication name — system-wide keyword for ppp on the wan, modified using set system command. ■ system version — loaded release version of the system software. Show tcp, or show tcp settings displ...

  • Page 212

    212 c hapter 4: r outer c ommand r eference show tcp counters displays system-wide tcp statistics. Tcp counters ■ active opens — number of times tcp connections have made a direct transition to syn-sent state from closed state. ■ passive opens — number of times tcp connections have made a direct tra...

  • Page 213

    Show commands 213 show time or show timezone displays the system date, time, and uptime. The present time is expressed in gmt. Example: show udp, or show udp counters displays statistics for udp datagrams. It lists the following: input counters ■ total input datagrams — sum of udp datagrams received...

  • Page 214

    214 c hapter 4: r outer c ommand r eference telnet commands telnet commands are available to users who dial in and whose type is network (type parameter in add user command), whose host_type is prompt (host_type parameter in set login user command), and whose login_service is telnet (login_service p...

  • Page 215

    Unassign command 215 telnet address> tcp_port establishes a telnet client session with the specified ip host name or address using the specified tcp port number. It works just like the telnet command, except you also specify the tcp port number to be used. Default tcp port number: 23. Maximum: 65535...

  • Page 216

    216 c hapter 4: r outer c ommand r eference manage this is only shown if your user type is defined as manage. It puts you into the cli, so you can execute full cli commands and configure the system. Use the exit command to exit the cli. Rlogin address> establishes an rlogin client session with the s...

  • Page 217

    Cli exit commands 217 send transmits a telnet control character. The available commands are the following: set escape allows changing the telnet escape character from ctrl ] (right bracket] to something else. Control characters are specified using the carat character followed by the character. For e...

  • Page 218

    218 c hapter 4: r outer c ommand r eference command features the command language has several built-in features that make it easier to use. When abbreviating commands, it is sometimes difficult to remember commands and their syntax. Using command completion and positional helps to remind you of the ...

  • Page 219

    Command features 219 command completion the tab key provides command completion. If you press the tab key before you finish typing a command or parameter, the rest of the command or parameter is displayed (completed), and you can continue entering the command. If the command or parameter is ambiguou...

  • Page 221: Odem

    A m odem c ommand r eference this appendix includes: ■ modem command overview ■ basic at commands ■ ampersand commands ■ percent commands ■ asterisk commands ■ tilde commands ■ octothorp commands ■ s-register commands ■ using s-register commands modem command overview this appendix lists the modem (...

  • Page 222

    A-222 a ppendix a: m odem c ommand r eference basic at commands the following table lists the basic at commands supported by the ras 1500. Table a-1 basic at commands command description &$ help, ampersand commands %$ help, percent commands ~$ help, tilde commands *$ help, asterisk commands #$ help,...

  • Page 223

    Ampersand commands a-223 ampersand commands the following table lists the ampersand (&) commands supported by the ras 1500. T tone dial v v0 numeric responses x x0 basic result codes x1 extended result codes x2-x7 advanced result codes z software reset z! Modem reset $ help, command summary table a-...

  • Page 224

    A-224 a ppendix a: m odem c ommand r eference &n &n0 highest link speed &n1 300 bps &n2 1200 bps &n3 2400 bps &n4 4800 bps &n5 7200 bps &n6 9600 bps &n7 12000 bps &n8 14400 bps &n9 16800 bps &n10 19200 bps &n11 21600 bps &n12 24000 bps &n13 26400 bps &n14 28800 bps &n15 31200 bps &n16 33600 bps &n17...

  • Page 225

    Percent commands a-225 percent commands the following table lists the percent (%) commands supported by the ras 1500. &t &t0 end test &t1 analog loopback (alb) &t4 grant remote dlb &t5 deny remote dlb &u minimum link speed (see &n) &w store configuration &y &y0 destructive &y1 destructive/expedited ...

  • Page 226

    A-226 a ppendix a: m odem c ommand r eference asterisk commands the following table lists the asterisk (*) commands supported by the ras 1500. Table a-4 asterisk commands command description *b1= *b1=0 disable keypad element *b1=1 enable keypad element *b1=2 auto keypad element *b2= *b2=0 disable se...

  • Page 227

    Asterisk commands a-227 *l *l0 end test *l1 dchannel local loopback *l2 bchannel 1 local loopback *l3 bchannel 2 local loopback *l4 dchannel remote loopback *l5 bchannel 1 remote loopback *l6 bchannel 2 remote loopback *m= *m=0 auto mode (depends on isdn switch) *m=1 point to multi point mode *m=2 p...

  • Page 228

    A-228 a ppendix a: m odem c ommand r eference tilde commands the following table lists the tilde (~) commands supported by the ras 1500. Octothorp commands the following table lists the octothorp (#) commands supported by the ras 1500. *w= isdn switch protocol type *w=0 at&t 5ess custom *w=1 nt dms1...

  • Page 229

    S-register commands a-229 s-register commands the following table lists the s-register commands supported by the ras 1500. Table a-7 s-register commands register function s0 ring to answer on s1 counts # of rings s2 escape code char s3 carriage return char s4 line feed char s5 backspace char s6 wait...

  • Page 230

    A-230 a ppendix a: m odem c ommand r eference s16 test modes 1 = analog loopback 2 = dial test 4 = test pattern 8 = remote digital loopback 16 = reserved 32 = reserved 64 = reserved 128 = reserved s17 reserved s18 &tn test timeout (sec) s19 inactivity timeout (min) s20 reserved s21 reserved s22 rese...

  • Page 231

    S-register commands a-231 s53 reserved s54 bitmapped. 1 = disable 2400 symbol rate 2 = disable 2743 symbol rate 4 = disable 2800 symbol rate 8 = disable 3000 symbol rate 16 = disable 3200 symbol rate 32 = disable 3429 symbol rate 64 = disable v.8 call indicate 128 = disable v.8 mode s55 bitmapped. 1...

  • Page 232

    A-232 a ppendix a: m odem c ommand r eference using s-register commands s-registers are addresses of places in memory where various timing parameters, redefinitions of selected ascii characters, and other configuration settings are stored. Initially, the s-register settings for each of the templates...

  • Page 233

    Using s-register commands a-233 bit-mapped s-registers understanding bit-mapped s-registers certain s-registers are bit-mapped. Bit-mapped registers appear in ras 1500 documentation as the following: ats56.1=1 and ats68.4=0. A bit-mapped s-registers uses one number to describe a collection of settin...

  • Page 234

    A-234 a ppendix a: m odem c ommand r eference.

  • Page 235: Odem

    B m odem d isconnect and r esult c odes ■ result codes ■ disconnect codes result codes the following result codes are supported by the superstack ii remote access system (ras) 1500: table 3 result codes message # message # no dial tone 006 14400/arq 026 busy 007 4800/hst 028 no answer 008 9600/arq/v...

  • Page 236

    236 a ppendix b: m odem d isconnect and r esult c odes 16800/arq/hst 057 26400 103 command denied 058 26400/arq 104 waiting 061 26400/vfc 105 dialing diabled 062 26400/arq/vfc 106 data 063 28800 107 +fco 065 28800/arq 108 16800/v32 083 28800/vfc 109 16800/arq/v32 084 28800/arq/vfc 110 19200 085 2160...

  • Page 237

    Result codes 237 12000/vfc 135 channel in use 171 12000/v34 136 channel in use 172 12000/arq/vfc 137 channel in use 173 12000/arq/v34 138 channel in use 174 14400/vfc 139 channel in use 175 14400/v34 140 channel in use 176 14400/arq/vfc 141 channel in use 177 14400/arq/v34 142 channel in use 178 168...

  • Page 238

    238 a ppendix b: m odem d isconnect and r esult c odes disconnect codes to view disconnect codes, view the ati6 screen. Listed below are all disconnect codes and the numeric equivalent. 33333/arq 205 41333/arq 229 33333/x2 206 41333/x2 230 33333/arq/x2 207 41333/arq/x2 231 34666 208 42666 232 34666/...

  • Page 239

    Disconnect codes 239 unable to retrain 013 no dial tone 015 key abort 016 busy 017 no answer 018 voice 019 no answer tone 020 no carrier 021 reason not determined 022 v42 sabme timeout 023 v42 break timeout 024 v42 disconnect cmd 025 v42 id exchange failed 026 v42 stepup no good 027 v42 invalid code...

  • Page 240

    240 a ppendix b: m odem d isconnect and r esult c odes pkt bus link err - ( tx tal) 050 pkt bus link err - ( rx tal) 051 pkt bus - transmit master timeout 052 pkt bus - clock missing 053 pkt bus - received ls while link up 054 pkt bus - out of sequence frame 055 pkt bus - bad frame 056 pkt bus - ack...

  • Page 241: Dressing

    C a dressing s chemes tthis chapter contains the following information: ■ ip addressing basics ■ supernetting ■ ip subnet mask address table ip addressing basics administrators generally use three address classes in ip, with address ranges as follows: class a - 0-127; class b - 128 - 191; and class ...

  • Page 242

    242 a ppendix c: a dressing s chemes in the figure below, notice that the position of this line is determined by the position of the first zero bit in the address. Figure 1 address class map subnetting a large ip network can be subdivided into smaller subnetworks. This is done using a subnet mask (i...

  • Page 243

    Ip addressing basics 243 subnets of class c networks the following table is a listing of all possible values for the last octet (byte) in a class c subnet mask. Figure 2 class c subnet masks two important points about the address divisions created by a subnet mask: ■ rfc 950 requires that the first ...

  • Page 245: 255.255.252.0

    Supernetting 245 networks. So, their netmasks are actually splitting up the third octet in their ip addresses. See figure 3. Figure 3 sample cidr netmask notice that the number of zero bits in the third octet actually dictates the number of class c networks in the supernet. Each zero bit makes the s...

  • Page 246: 255.255.252.0

    246 a ppendix c: a dressing s chemes step 2 - select a range of addresses for each supernet the range of addresses in a supernet must fit exactly into a space that can be described by its netmask. This means that the zero bits in the netmask must also appear in the first address of the supernet bloc...

  • Page 247

    Supernetting 247 figure 5 supernet example ■ supernets 1 and 2 each require four class c networks, so they require a netmask with 2 zero bits (4 = 2 2 ) in the third octet. This yields a netmask of 255.255.252.0. ■ supernet 3 requires 7 class c address spaces. Since 7 isn’t a power of 2, we have to ...

  • Page 249

    Ip subnet mask address table 249 ip subnet mask address table subnet masking is used to expand the number of networks due to the 32-bit limitation of the ip address field. When assigned an address by the nic, the address can be further broken down to expand the single net number to many more by usin...

  • Page 250

    250 a ppendix c: a dressing s chemes 6 110nnnnn.Nnnnnnnn.Nnnnnnnn.Sssssshh 255.255.255.25 2 ff-ff-ff-fc 62 2 class d 1110xxxx.Xxxxxxxx.Xxxxxxxx.Xxxxxxxx future 11110xxx.Xxxxxxxx.Xxxxxxxx.Xxxxxxxx all 1s 11111111.11111111.11111111.1111111 1 all 0s 00000000.00000000.00000000.0000000 0 0 = binary 0 1 =...

  • Page 251: Vent

    D e vent m essages this appendix contains the following information: ■ event logging ■ event logging levels ■ event logging counters ■ using syslog ■ event message examples event logging the ras 1500 event logging system logs important information about ras 1500 processes to a number of logging sink...

  • Page 252

    252 a ppendix d: e vent m essages ■ sent parameter problem ■ rcvd parameter problem ■ rcvd source quench icmp ■ rcvd timestamp req icmp ■ rcvd address mask req icmp ■ rcvd address mask reply icmp ■ rcvd router solicitation icmp ■ sent router advertisement icmp ■ sent icmp redirect (recv'd icmp redir...

  • Page 254

    254 a ppendix d: e vent m essages using syslog this section describes how to configure ras 1500 to send event messages to the syslog host you define. The first step (below) involves setting up your syslog server to receive data from ras 1500. Configuring syslog hosts on ras 1500 you can define separ...

  • Page 255

    Event message examples 255 to set the log level of a facility, use the following command: set facility loglevel for example, to set the loglevel of the ip facility to unusual (only messages that are unusual and critical are sent to the console port) type: set facility ip loglevel unusual enter to di...

  • Page 256

    256 a ppendix d: e vent m essages "ip_addr_pool_init: attempting to initialize the ip address pool with an illegal value (x), current ip address pool starting address y. " meaning: the administrator tried to specify a starting address for the ip address pool which is illegal. The address is either...

  • Page 257

    Event message examples 257 "proxy_arp_insert: no common network address found for remote ip address x" meaning: a network user is connecting to the system using an ip address that is not on the same ip subnetwork as the network defined for the system's lan interface. Therefore, no proxy arping will ...

  • Page 259

    Event message examples 259 "cip: the modem group %s already exists /n" meaning: the administrator tried to configure a modem group, but the modem group already exists action: choose another modem group name user manager messages "auth: unable to authenticate if both authentication ip's are set to 0"...

  • Page 260

    260 a ppendix d: e vent m essages "fm: in filter file , previously defined section section name>" meaning: there are two protocol sections that use the same name, for example, you defined two ip protocol sections in the filter file action: delete one of the duplicate protocol sections "fm: in filter...

  • Page 261

    Event message examples 261 "the configuration file is corrupt. Status status>." meaning: the configuration file has been corrupted. It will be renamed to .Bad action: keep a copy of the .Bad file. If the file was uploaded to using tftp, upload the file again making sure the tftp transfer mode is set...

  • Page 262

    262 a ppendix d: e vent m essages ip dial-out process messages "init: could not allocate a private data area. Status: status>." meaning: the dial-out process could not allocate enough memory for its data. The dial-out process will not be started action: free some memory, for example, delete some use...

  • Page 263

    Event message examples 263 "could not set the ip acs timer. Status: ( value>). The ip dial-out service will be automatically disabled." meaning: the dial-out process could not start its service timer. This timer is required for normal operation. The dial-out network service will not be enabled actio...

  • Page 265: Ndex

    I ndex 265 i ndex a add command 49 addressing schemes, ip subnet mask address table 249 administrative tools adding network services 35 command values 31 communicating with remote, local sites 33 connect commands 33 deleting network services 37 dial commands 33 disabling network services 37 discardi...

  • Page 266

    266 i ndex console event logging 252 examples 255 filter manager message examples 259 how to configure syslog hosts 254 how to display logging levels 253 how to set the event log level 254 ip dial-out message examples 262 ip message examples 255 local flash file logging 252 logging 251 logging level...

  • Page 267

    I ndex 267 delete ipx route 82 disable ipx rip network 87 enable ipx rip network 93 list ipx routes 108 list ipx static routes 109 sap disable ipx sap network 87 enable ipx sap network 93 list ipx services 108 statistics list ipx networks 108 show ipx counters 195 show ipx network counters 197 l lis...

  • Page 268

    268 i ndex disable ipx rip network 87 enable ip rip 91 enable ipx rip network 93 show ipx rip settings 198 rlogin 38 s scripts cli do (run cli script) 88 modem initialization add init_script 61 delete init_script 81 list init_scripts 104 security cli access disable security_option remote_user admini...

  • Page 269

    I ndex 269 user manager active sessions table 28 user table 25 tcp managing add network service 71 enable ip security_option_drop_tcp_fragoffset1 91 list available servers 100 list services 110 list tcp connections 114 set cleartcp connect_message 126 set tcp maximum_connections 159 show tcp counter...