NETServer 8/16 Plus CLI Reference Guide
The material contained in this manual is for information purposes only and is subject to change without notice. No part of this document may be reproduced, transmitted, transcribed, or stored in a retrieval system in any form or by any means, mechanical, magnetic, electronic, optical, chemical, or otherwise without the written permission of U.S. Robotics. U.S. Robotics, NETServer, NETServer Plus and the U.S. Robotics logo are registered trademarks of U.S. Robotics.
Table of Contents U.S. Robotics Access Corp. Limited Warranty .............................................15 What Is NOT Covered By the Limited Warranty ........................................15 Jurisdiction Laws ..........................................................................................16 How To Access Your Warranty Services.......................................................16 Telephone Support ........................................................................................
Help .................................................................................................................. 23 Additional Conventions .................................................................................. 23 Network Address Formats.............................................................................. 24 Interfaces.......................................................................................................... 24 Names .................................................
add tftp client ...............................................................41 add user [name].............................................................................................41 ARP...................................................................................................................42 arp ................................................................................42 ASSIGN ......................................................................
DIAL................................................................................................................. 47 dial ......................................................................................... 47 DISABLE ......................................................................................................... 47 disable accounting ........................................................................................ 47 disable appletalk network ....................
enable authentication remote.........................................................................52 enable interface ...............................................................53 enable ip icmp_logging .................................................................................53 enable ip forwarding .....................................................................................53 enable ip icmp_logging .....................................................................
KILL................................................................................................................. 58 kill <“process name”> .................................................................................. 58 LEAVE ............................................................................................................. 58 leave.............................................................................................................. 58 LIST.........................................
list processes .................................................................................................68 list switched interfaces ..................................................................................68 list services....................................................................................................68 list snmp communities or list snmp trap_communities..................................69 list syslogs ......................................................................
SET ................................................................................................................... 73 set accounting ............................................................................................... 73 set appletalk .................................................................................................. 74 set appletalk network ...................................................................... 76 set authentication .....................................
SHOW.............................................................................................................111 show accounting settings.............................................................................111 show accounting counters ...........................................................................111 show appletalk counters ..............................................................................112 show appletalk settings.........................................................
show ipx rip settings ................................................................................... 131 show ipx sap counters................................................................................. 131 show ipx sap settings .................................................................................. 132 show ipx settings......................................................................................... 132 show memory................................................................
rlogin TCP_port .......................................143 telnet ..........................................................................143 telnet tcp_port ...........................................143 TELNET COMMANDS...............................................................144 close ............................................................................................................144 help ............................
Warranty and Service U.S. Robotics Access Corp. Limited Warranty Your U.S. Robotics product is covered by a Limited Warranty. U.S. Robotics warrants that the product that you have purchased from U.S. Robotics or from a U.S. Robotics authorized reseller is free from defects in materials or workmanship during the Limited Warranty period, identified in the chart below, which is effective on the date of purchase. During the Limited Warranty period, U.S.
• A product that is modified, tampered with, misused or subjected to abnormal working conditions, including, but not limited to, lightning and water damage • Damage from repair or replacement of warranteed parts by anyone other than U.S. Robotics or a U.S. Robotics authorized service provider THIS LIMITED WARRANTY DOES NOT GUARANTEE YOU UNINTERRUPTED SERVICE. REPAIR OR REPLACEMENT AS PROVIDED UNDER THIS LIMITED WARRANTY IS THE EXCLUSIVE REMEDY OF THE PURCHASER.
Area North America Europe, Middle East, Africa 353-1-205-7700 All Other Locales 1-847-797-6600 Phone No. Weekdays 1-800-231-8770 (toll free) Monday - Friday Monday - Friday Monday - Friday Time 7. a.m. - 8 p.m. 9 a.m. - 7 p.m. 7 a.m. - 8 p.m. Time Zone Central Standard Time Central European Time Central Standard Time What Information Should I Have Ready Before Calling For Support? To enable U.S.
Software/Firmware Update Options Customers who require Software/Firmware updates beyond 90 days from the purchase date will be referred to a U.S. Robotics sales representative to establish a service contract, if desired. Hardware Support Warranty During the applicable Limited Warranty period, if U.S. Robotics determines your product requires servicing, you will be given a Service Repair Order (SRO) number to help us track your Limited Warranty request.
Shipping Address North America and Locations Outside Europe, Middle East & Africa U.S. Robotics ATTN: SRO Receiving 1800 W. Central Rd. Mt. Prospect, IL 60056-2293 SRO#...................................... Europe, Middle East, Africa U.S. Robotics Services, Ltd ATTN: RMA Department 5 Richview Office Park Clonskeagh, Dublin 14 Ireland Hardware Support Options Customers who require out-of-warranty hardware support will be referred to a U.S.
Introduction This section describes some basic concepts of the CLI. It explains the syntax used throughout this document and the structure of the command language as an aid to understanding how commands are structured. Command Format Many commands are position independent, multi-tiered and use keywords. Multi-tiered commands let you type the base command (e.g.: set interface) and implement many more parameters (host_type, host_address, etc).
♦ • • • • , (comma) you can select one or more of the displayed bitmasks: [FIRST,SECOND,THIRD,...] Position independent arguments are shown in a vertical array following the command. The type of value you enter must match the type requested. Numbers are either decimal or hexadecimal. Text can be either a string that you create, or it may be a list of options you must choose from. When choosing an option, type the text of the option exactly. “Double quotation marks” set off user-defined strings.
• & & ( && U & & OO ( b (ctrl b) or (left Command line editing allows these options: arrow) brings you go back one character; b (ctrl b) or (left arrow) brings you back one character; f (ctrl f) or (right arrow) takes you forward one character; b (Esc-b) takes you back one word; f (Esc-f) takes you forward one word; a (ctrl a) takes you to the beginning of a command; e (ctrl e) takes you to the end of a command and k (ctrl k) kills the line.
• Many delete commands require that you first disable the process or function. For example, commands to delete a network user, interface, route, TCP connection, community name, network service and others must first be disabled. • Wherever an IP address value is required, you can enter a host name provided you have configured a DNS server or put the name and address into the DNS Local Host Table. • You can create a script file - a text file containing CLI commands to simplify repetitive tasks.
Names You can specify names for networks, users and other system entities. Names can be up to 32 ASCII characters, unless specified otherwise in the command description. A name can contain white space, or other non-alphanumeric characters, if you enclose the name with double quotes. Note that names are case-sensitive.
• • • • • • • • • Network - defines local and remote networks, network connections, hosts and routers User - describes connection parameters, for operation and authorization Modem Group - specifies switched interfaces to be managed as a group Filter - can be applied to interfaces, connections, and users to control access through the system Interface - describes physical devices; for example, ports Syslog Host - receives system messages DNS Server - translates IP addresses to and from host names Login Host
CLI Commands ADD Use the ADD command to define: • • • • networks you will connect to hosts you need to access SNMP communities users who will dial out, dial in, access the network, or use the CLI Note that some parameters have default values. add appletalk network address_range [appletalk_range] { interface [eth:1] } {enabled [yes | no]} Defines an AppleTalk network and the interface used to connect to it. Each AppleTalk network address allows up to 253 nodes to be attached.
add appletalk zone network [Max of 5 names] Defines the AppleTalk zones that will be a part of the AppleTalk network. A zone name describes a logical network segment on a physical network. The first zone on the list is the “default zone”. Parameters network Description Designation of AppleTalk zone(s) to be added. No more than five names can be added at once. Limit: 32 characters. Network designation you created earlier, where you are adding zones.
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. The first specified server is sent the IP Host Name to be resolved, first with, then without the default domain name (see set dns domain_name for more information about the default domain name).
add framed_route user gateway [ip_address] ip_route [ip_address] metric [number] Adds a framed (static) network to the user profile for dialup connections. This method of creating a static route does not run RIP to learn routes, so you must specify IP route and gateway addresses. See add ip route command. Parameters gateway ip_route metric Description User name specified for the framed network. IP address of the gateway used to reach this remote network.
add ip defaultroute gateway { metric [1] } Defines a default gateway IP router, which acts as the default route for IP packets destined for remote hosts. Parameters metric Description IP Address of the gateway router. An integer representing how far away the default router is, in “hops” through other routers. Values are 1 - 15.
add ip route gateway [gateway_addr] metric [hop_count] Adds an IP static route entry to the IP Routing Table. IP packets destined for networks that match this network will be routed to this address. The command list ip routes displays your currently defined routes. Parameters gateway metric Description IP address of the remote network, in the format nnn.nnn.nnn.nnn, with or without a mask specifier.
add ipx route gateway [ipx_host_address] metric [metric_number] ticks [tick_number] Adds an IPX static route to the system’s IPX Route Table, which defines static routes to remote IPX networks. The command list ipx routes displays currently defined static routes. Parameters gateway metric ticks Description IPX network address requiring a route. IPX address of the host which will act as a gateway. The format is nnnn.xx:xx:xx:xx:xx:xx (net_addr.mac_address).
Parameters service name address gateway metric node socket type Description Designation of IPX service. Internal network number for the IPX service on which this service resides. Address of the router you defined as the gateway. An integer representing how far away the default router is, in “hops” through other routers. Values are 1 through 15. The internal node number of the server on which the service resides. This is typically 00:00:00:00:00:01. The port the server listens on.
add login_host address [IP_address] preference [number] rlogin_port [TCP_port_number] telnet_port [TCP_port_number] clearTCP_port [TCP_port_number] Adds a login host to the Login Host Table. You add login hosts so users of type login connecting to an IP host can reference the host by name. The system will look up the address, using the DNS server that you define with add DNS server. Or, you can specify the IP address here.
add modem_group interfaces [interface_name,interface_name…] Creates a modem group and assigns interfaces to the modem group. See also the set modem group command, which configures all interfaces in the modem group. You can also add additional interfaces to this modem group using assign interface, and remove them with unassign interfaces. The modem group All is provided as a default modem group with all NETServer (8 or 16) modems included.
Parameters server_type socket enabled data close_active_ connections Description Name of this type of service. Limit of 32 character ASCII string. Designates the type of service being offered. Services currently available are: • ClearTCPD - enables access to a modem group • DialOut - for dial-out connections to IP or IPX hosts • SNMPD - SNMP agent • TFTPD - server for file transfers • TELNETD - TELNET server, either to the CLI or a modem group The port the server listens on.
Ancillary Data Parameters auth login_banner login_prompt service_type modem_group drop_on_hangup 38 Description On indicates that login/password authentication should be performed on incoming connections. Format: “auth=[on/off]” Default: on. ASCII string that will be sent to a client when the connection is made. It must be quoted. Format: “login_banner=[string]” Default: none. ASCII string specifying the login prompt to be sent during authentication. It must be quoted.
Add network service examples: To configure a ClearTCP service to offer modem sharing on TCP port 2000, doing no authentication upon connect, using modem group Group1, type: Note: all DATA values must be enclosed in double quotations. add network service modem_sharing server_type cleartcpd socket 2000 data “auth=off,modem_group=\Group1\,service_type=dialout” To configure a TELNET service to offer CLI access on port 4000, doing authentication upon connect and dropping the connection on hangup (abbr.
add snmp trap_community address Adds to the list of community name/IP address pairs that are allowed to receive SNMP traps. You can see the list of authorized users with the list snmp communities command. Parameters address Description Group name defining who can receive SNMP traps. IP address of the SNMP manager, in the form nnn.nnn.nnn.nnn add syslog loglevel [loglevel] Adds an IP host to the list of IP hosts that will receive syslog entries.
add tftp client Adds the tftp client to the Authorization Table for TFTP access. Parameters Description Host name or IP address of a host to be added. An address of 0.0.0.0 allows all clients TFTP access. add user [name] login_service [RLOGIN | TELNET | CLEARTCP] network_service [ARAP | PPP | SLIP] password [password] enabled [yes | no] type [LOGIN,NETWORK,CALLBACK,DIAL_OUT, MANAGE] Adds a user to the Local User Table.
ARP arp output [outputfile_name] Prints the IP address (and Media Access Control Address [MAC] if on a locally connected network) of a network node to a file in FLASH or the CLI (default). If a node is not in the ARP cache, an ARP request will be sent out. Parameters Description IP address or node name for the IP and MAC address you seek.
DELETE Delete commands remove anything you previously added. delete appletalk network Deletes the previously added AppleTalk network. Make sure you disable the network using disable appletalk network before deleting it. Use list appletalk networks to view added networks. delete appletalk zone network Deletes an Appletalk zone from an Appletalk network.
delete DNS server preference Removes the name server associated with that preference number (preferred rank) from the table of accessible DNS servers. delete filter Removes the named filter from the Filter Table, and deletes the file stored in FLASH memory. Use list filters to see what filter files are in FLASH memory. delete file Deletes a file from the FLASH file system. Use list files to see which files are currently stored.
delete ip route Deletes an IP address from the IP Routing Table, that you previously added with add ip route. Deleting this route will cause IP packets destined for this network to use the default route, which you can see using list ip routes. See add defaultroute gateway to find out how to add a default route. delete ipx network Deletes an IPX network on the interface you specified with the add ipx network command.
delete modem_group Deletes a modem group from the Modem Group Table. You can list current modem groups and their assigned interfaces using the list modem_groups, and show modem_group commands. delete network service Deletes the specified network service from the list of available services. You must use disable network service before deleting the service. You can see which services are available and active using list available servers and list services.
delete user Deletes a user you previously added to the Local User Table. Use list users to see the currently defined user, and show user to see the attributes you assigned to that user using the add user or set user command. DIAL dial Generates an outgoing call to the location specified by the user name. You can use list users to list the defined users, along with the services they are defined to work with, and their current status. Maximum 32 characters allowed.
disable authentication remote Disables user authentication using remote RADIUS servers. You must have set authentication to define the RADIUS server, and enabled it using enable authentication remote. You can use show authentication to see if remote and/or local authentication is currently enabled. Users can still be authenticated using local authentication, if you have enabled it.
disable ip routing Disables all routing protocols on all IP networks. Currently, the only routing protocol is RIP, which means that disable ip rip performs the same function. You can use show ip routing to see the current status of IP routing. disable ip static_remote_routes Disables all statically defined remote routes on all IP networks, that you previously defined using add ip route. You can list the current IP routes using list ip routes.
disable modem_group Disables the modem group you enabled with the enable modem_group command. disable network service Disables a network service, such as TELNET or TFTP. If close_active_connection was specified as TRUE in the add network_service command, then all active connections are closed when the server is disabled. disable security_option snmp user_access Turns off SNMP access to the CLI. This prevents remote users from using SNMP and possibly damage the configuration.
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 new sessions to occur using that user name. Disabling a user is useful when prohibiting a user’s access temporarily. Note: disabling a user who is already connected doesn’t disconnect that user.
ENABLE enable accounting Enables remote accounting via RADIUS. Use disable accounting to disable accounting via RADIUS. enable security_option remote_user administration Enables remote TELNET users to access the CLI. This prevents remote users from modifying the configuration. You can use enable security_option remote_user administration to re-enable full TELNET access. enable appletalk network Enables a previously defined AppleTalk network.
enable interface Enables the specified interface. Enabling an interface enables it to transmit and receive data. You can enter multiple interfaces (ssss,ssss,ssss ...) or a range (mod:1 - 9). You can use list interfaces to see which interfaces are defined, and whether they are currently disabled. enable ip icmp_logging Enaables display of the Internet Control Message Protocol to the syslog server. enable ip forwarding Allows all IP networks to forward (route) packets.
enable ip routing Allows all routing protocols for all IP networks. Currently, this command enables only RIP, so it is functionally the same as enable ip rip. enable ip static_remote_routes Enables the statically defined remote routes, which you defined using the add ip route command. You can list the currently defined IP routes using list ip routes. enable ipx network Enables the specified IPX network, which you previously defined using the add ipx network command.
enable modem_group Enables the modem group you disabled with the disable modem_group command. The modem group All is provided as a default modem group with all NETServer (8 or 16) modems included. See also the set modem group command, which configures all interfaces in the modem group. enable network service Enables the network service that you previously defined with the add network service command.
enable telnet escape If the TELNET escape character was disabled by the disable TELNET escape command, this command re-enables it. When enabled, TELNET client users who press the TELNET escape key during their session will get a TELNET command line. & ] (cntrl ] ). A TELNET user can change By default the escape character is it using set escape in the TELNET program. enable user Allows a user to establish dial in and/or dial out sessions.
hangup user Makes the user unavailable for dial-in. This command has the same effect as hanging up the phone. hangup user all Makes all users unavailable for dial-in. This command has the same effect as hanging up the phone. HELP help Provides information about possible commands and their formats. Typing help alone lists the possible commands. Typing “help ” lists the possible parameters for that command.
HISTORY history & & Displays your previous CLI commands. You can recall commands from the -P (ctrl-P) to recall commands up the list, and -N (ctrlhistory using N) to recall commands working down the list. The default depth is 10 commands. You can modify the history depth using the set command history command. KILL kill <“process name”> Kills an active process. Use list processes to see which processes are currently active. You can only kill a process that you started.
list active interfaces Displays the operational status, administration status, index and name of all active interfaces. The output is the same as the list interfaces command, except non-active interfaces are not displayed. Inactive interfaces are interfaces with no current connections. list appletalk forwarding Displays the entries in the AppleTalk Forwarding Table. The table lists: • • • • • • Network Address Range - AppleTalk network address range NextHop - address of next hop router; 0.
list appletalk routes Displays the entries in the AppleTalk Routing Table. The table lists: • • • • • • Address Range - Range of addresses used on this route Next Hop - AppleTalk address of the next hop router. 0.0 implies the entry is a local network Port - Address of the network (route destination) Hops - How many hops away this network is Type - AppleTalk, PPP, Serial-Non Standard or Other State - State of the path to this network, listed from best to worst: GOOD, SUSPECT, PRETTY BAD, BAD.
list connections Displays all connections established on switched interfaces. It lists: • • • • IfName - interface used by each user User Name - user of each connection Type - type of connection: dialout, dial_in, callback,manual, ondemand, shared_modem, etc. DLL - datalink layer protocol list critical events Displays last ten critical status events, and system time when each occurred. You can change which events are logged as critical, using set facility.
list dns servers Displays DNS Name Servers, which you configured using the add dns server command. The name you defined for it, the preference, the IP address and current status (ACTIVE, INACTIVE) are listed for each DNS server. list facilities Displays the system facilities (processes) currently running, plus the default log level. The log level represents the severity of error that facility will output messages on the console port. You can change the log level using the set facility loglevel command.
list interfaces Displays the installed interfaces, along with their operational status, administration status, and interface index. If an interface is down under Admin Status, you can use enable interface to try to bring it up. The command lists: • • • • Index - number used to identify the interfaces position in the table Name - interface name: eth:1 Oper Status - current, operating status of the interface; UP or DOWN Admin Status - administrative status you designated interface to be, up or down.
list ip interface_block Displays the IP addresses associated with each system interface. If the interface has a point-to-point connection, then the neighbor field contains the address of the remote system.
list ipx networks Displays the IPX networks that you previously defined using the add ipx network command.
• Metric - number of hops through routers to reach this service list ipx static routes Displays all IPX static routes previously defined using add ipx route.
list modem_groups Displays modem groups that you previously defined using the add modem_group command, along with the number of interfaces in each group. For example: MODEM GROUPS GROUP Number of Interfaces All 8 list networks Displays all defined networks running any protocol.
list processes Displays all processes running on the system. • • • • Index - a reference number in the Process Table Name - designation of the process (e.g.: Domain Name System) Type - SYSTEM, APPLICATION, FORWARDER or DRIVER Status - ACTIVE, PENDING or INACTIVE list switched interfaces Displays the installed switched interfaces (modems), along with their operational status, administration status, and interface index.
list snmp communities or list snmp trap_communities These commands display the defined SNMP communities, which you previously defined using the add snmp community command. SNMP trap_communities does not list access. • • • Community Name - community designation for the IP address IP address - IP address of a member of the community Access privelege (R/W) - type of access a member has to MIBs list syslogs Displays IP addresses which get syslog entries from the system.
list tftp clients Displays IP addresses of all users allowed to use the Trivial File Transfer Protocol (TFTP) to connect to the system. You must have used add network service to add TFTP support to the system and used add tftp client to authorize users to connect. list udp listeners Displays User Datagram Protocol (UDP) ports being used by the system. These ports correspond to processes which are receiving UDP data (for example SNMP, User Management, TFTP service).
PING ping output [output_filename] count [count] interval [interval] timeout [timeout_value] Sends an ICMP echo request to a remote IP host. Parameters output count interval timeout Description IP address in dotted notation, or host name of remote system. A file name to direct output to. Number of ICMP echo requests to send. Seconds to wait between sending each request. Seconds to wait for an echo response to return.
RENAME rename file Copies files within the FLASH file system. The FLASH file system is a flat file system (no subdirectories). Use the list files command to see what files currently exist. Parameters Description Name of the original file. New name for the file RESET reset modem Resets the specified modem following changes to its configuration. This “hard” reset issues an ATZ! command, closing any active connections on that port.
RLOGIN rlogin login_name [login_name] TCP_port [number] Creates an rlogin client connection to the specified host. Parameters Description Either the IP address in nnn.nnn.nnn.nnn notation, or the host name of the remote system. User name needed to login to the remote system. TCP port number to create the connection to. By default, 513 is used. login_name TCP_port SAVE save all Saves all changes made during your CLI session.
Parameters primary_server secondary_server retransmissions start_time timeout use_servers Description Initial server to send the accounting information to, unless use_servers is set to BOTH, in which case both servers will be sent to. Second server to send the accounting information to, unless use_servers is set to BOTH, in which case both servers will be sent to. Sum of retransmissions to 1 or both servers (if needed), depending on value of use_servers. Default: 100. When accounting begins.
Parameters allow_password_change arap arap_node_network_range arap_zone force_manual_password_entry max_arap_nodes_reserved max_arap_sessions max_compressed_arap_sessions max_forwarding_table_size max_password_length max_routing_table_size min_arap_nodes_reserved min_password_length password_retries CLI Reference Guide Description Setting this parameter to TRUE allows ARAP users to change their passwords.
set appletalk network { aarp_gleaning [ENABLE | DISABLE] } { current_zone [name] } { ddp_checksums [TRUE | FALSE] } { default_zone [name] } { description [string] } { desired_node_address [appletalk_address] } { seed_router [TRUE | FALSE] } Sets parameters for all AppleTalk networks. Parameters aarp_gleaning current_zone ddp_checksums default_zone description desired_node_address seed_router 76 Description Designation of the AppleTalk network.
set authentication primary_server [IP_address or name] primary_secret [string] retransmissions [count] secondary_server [IP_address or name] secondary_secret [string] timeout [number_seconds] Configures the remote (RADIUS) authentication retransmission algorithm. Parameters primary_secret primary_server secondary_secret secondary_server retransmissions timeout Description A designation to employ for security purposes. Limit of 16 ASCII characters.
Parameters history prompt idle_timeout local_prompt login_required [no | yes] 78 Description Sets depth of the buffer holding command history. Use history command to see current depth and list of your last CLI commands. Default: 10 commands. Range: 1-500. Sets the global command prompt for the CLI. Use show command to see the currently defined prompt. Limit: 64 characters.
set connection host_select [ROUND_ROBIN | RANDOM] message [“prompt”] service [“prompt”] user_name [“prompt”] Configures connection parameters for all dial-in users. Note that “message” will only be displayed if there are no other “message” parameters set for that interface. Use show connection to see what the current settings are. Parameters host_select message service user_name Description Specifies how the system chooses which host to connect the user to.
set dial_out security [YES | NO] idle_timeout recovery_timeout Sets global parameters for all dialout connections over modems. Parameters security idle_timeout recovery_timeout Description Determines whether to require user name and password when dialing out. If YES, login authorization is required. Default: YES. Interval allowed before an idle connection is closed. 0 is no timeout: default (NO) is 5 minutes. If dialout is on (YES), timeouts derive from user values.
set dns server preference name address [ip address] This command redefines the name of a Domain Name Server, that you previously defined using add DNS server. Use list DNS servers to see the currently defined DNS servers. Parameters preference name address Description Priority of the name server in name searches. Designation - must be unique - given the DNS server. This field is optional, but is useful for keeping track of name servers. Limit: 32 characters.
set framed_route user gateway [ip_address] ip_route [ip_address] metric [number] Specifies a framed (static) network to the user profile for dialup connections. See add framed_route user and add ip route commands. Parameters gateway ip_route metric Description User name specified for the framed network. IP address of the gateway used to reach this remote network. IP address of the remote network Integer representing how far away the route is, in “hops” from other routers.
Parameters at_command directory_number call_type Description Designation you choose for a particular port (e.g.: mod:1). Field in which you can designate your AT command choice. Telephone number provided by your phone service. Call type specifies your desiged channel connection service. Choices are: • AUTO - System adapts to the proper connection setting. The I-modem first tries to make a V120, then a V110, then a V.
spid terminal_endpoint_id switch Service Profile ID provided by your phone supplier for each B channel. SPIDs tell the phone company of any special services you’ve ordered. Limit: 64 characters. The TEI permanently specifies your link with the central office switch. The value range is 0-63. This number is assigned by the telco. Default: 0. If you aren’t assigned a TEI, it is specified dynamically.
set interface filter_access [ON | OFF] input_filter output_filter Sets filter parameters for the specified protocol on the specified interface. You can see the available filter files using list filters, view the contents of a filter file using show filter, and add filter files to FLASH memory using TFTP. Parameters filter_access input_filter output_filter Description Designation of interface you are setting parameters for.
RIP Policies : The following RIP policies are supported by the IP route: • • • • • • • Send Default - disabled by default, causes router to advertise itself as the default router. Send Routes - enabled by default. Tells RIP to advertise (broadcast) its routes on the network every 30 seconds - is standard for a gateway router. Send Subnets - disabled by default. If this flag is on, only routes with the same network and with subnets on the same network are sent out the interface.
Parameters broadcast_algorithm reassembly_maximum_ size rip_authentication_key rip_policies_update Description Designation of the IP network for which you want to set parameters. Algorithm determines which address is used in broadcasts to represent the entire network. Choices are: • 1 - the IETF standard, nnn.nnn.nnn.255 (default) • 0 - the BSD standard, nnn.nnn.nnn.
set ip routing autonomous_system_number [number] table_maximum_size [number] metric_maximum_entries [number] rip_flags [METRICS, SEND_REQUEST] router_id [IP_address] Sets parameters for IP routing to the s pecified IP router address, which is the gateway to an Autonomous System. Parameters autonomous_system_number table_maximum_size metric_maximum_entries router_id rip_flags 88 Description Maximum number of IP routes system can hold in its table.
set ip system initial_pool_address [IP_address] pool_members [number] When dial-in network users have their IP addresses dynamically assigned, those IP addresses are allocated from a pool. Sets up that pool. The pool is created as a range, starting from an initial address. As PPP or SLIP users dial in, IP allocates an address from this pool and assigns them to the user. Parameters pool_members Description First IP address in pool, written in nnn.nnn.nnn.nnn notation.
Parameters delay_ticks diagnostics maximum_learning_retries netbios netbios_name_cache netbios_cache_timer netbios_max_hops packet_maximum_size rip rip_age_multiplier rip_broadcast rip_gap_timer rip_packet_size rip_periodic rip_update_interval sap_age_multiplier sap_broadcast 90 Description Designation of the IPX network. Maximum size: 32 characters. Interval in number of ticks it takes to reach this IPX network. Default: 1 for LAN networks, 40 for WAN networks. Range: 0 65535.
sap_gap_timer Time the system should wait between sending SAP packets. Default: 1 Size of SAP packets. Default: 510 bytes Whether or not SAP will send periodic updates. Default: ENABLED Whether or not SAP will look its nearest neighbors. Default: YES How often RIP should send periodic updates.
set login_host preference rlogin_port [port_number] telnet_port [port_number] clearTCP_port [port_number] Sets rlogin, TELNET or ClearTCP ports for a specified login host. The specified port number is used by the login host to accept connections using that method. Parameters rlogin_port telnet_port clearTCP_port 92 Description Preferred rank of a login host. Use list login_hosts to see the preference number associated with a login host.
set modem_group access [DIAL_IN | DIAL_OUT | TWOWAY] connection_type [DIRECT_CONN | NORMAL | DIRECT_NET | NO_PROMPT | PROMPT_USER_ONLY] dial_prefix [string] host_type [PROMPT | SELECT | SPECIFIED] host_address [IP_address] init_script [name] login_service [TELNET | RLOGIN | CLEARTCP] message [“login_message”] password [string] prompt [“prompt_message”] protocol [ARAP | PPP | SLIP] TCP_port [port_number] type [NETWORK | LOGIN | LOGIN_NETWORK] user_name [user name] Configures a previously defined
Parameters access connection_type dial_prefix host_type host_address init_script login_service message password prompt protocol TCP_port 94 Description Designation of the modem group. Limit of 32 characters. Sets access type for switched interface. Modem can allow dial-in only, dial-out only or both (TWO-WAY). Sets the connection type for switched interface. Options: • Direct_net uses the protocol parameter’s setting to create a virtual node connection.
type user_name Specifies type of connection allowed on interface. • Login port only allows login users • Network port only allows network users • Login_network allows either type Designation for the switched interface, used if connection type is no_prompt. Limit: 32 characters. set network service server_type [service_name] socket [socket_number] data [“string”] close_active_connections [TRUE | FALSE] Sets parameters for configured network services.
set ppp receive_authentication [NONE | PAP | CHAP | EITHER] Sets the type of authentication to be used when establishing PPP connections. See RFC 1334 for details about CHAP and PAP. Options are: Parameters NONE PAP CHAP EITHER Description Don’t check Use Password Authentication Protocol Use Challenge Handshake Authorization Protocol CHAP tried first, then PAP. Default.
set switched interface access [DIAL_IN | DIAL_OUT | TWO_WAY] at_command [string] connection_type [DIRECT_CONN | NORMAL | DIRECT_NET | NO_PROMPT | PROMPT_USER_ONLY] dial_prefix [string] filter_access [ON | OFF] host_type [PROMPT | SELECT | SPECIFIED] host_address [IP name or address] init_script [name] input_filter [name] login_service [TELNET | RLOGIN | CLEARTCP] message [“login_message”] output_filter [name] password [string] prompt [“prompt_message”] protocol [ARAP | PPP | SLIP] TCP_port
Parameters access at_command connection_type dial_prefix host_type host_address init_script login_service message prompt 98 Description The switched interface to modify. Limit: 32 characters. Sets access type for switched interface. The modem can allow dial-in only, dial-out only or both (TWO-WAY). String representing any generic AT command. When implemented, output is displayed immediately on CLI. Sets connection type for switched interface.
password protocol TCP_port type user_name Used if connection_type is no_prompt or prompt_user_only. Protocol (ARAP or PPP) to connect with, if connection type is direct_net. SLIP is not supported by direct_net connection type. TCP port number for the login host. This parameter is used when the connection type is direct_conn or direct_net. Type of connections to allow on the switched interface.
set syslog loglevel [level] Sets the error reporting level for syslog entries that will be sent to the specified IP address. You must have previously defined this syslog IP address using add syslog. There are five levels of logging: • • • • • CRITICAL - a serious system error, which may effect system integrity UNUSUAL - an abnormal event, which the system should recover from COMMON - a regularly occurring event that is not frequent VERBOSE - a regular periodic event, e.g.
set user alternate_phone_number [number] expiration [date] idle_timeout [seconds] input_filter [filter_name] message [“message”] modem_group [group_name] output_filter [filter_name] password [password] phone_number [number] session_timeout [seconds] type [LOGIN,NETWORK,CALLBACK,DIAL_OUT, MANAGE] Modifies user parameters. See table on next page.
Parameters alternate_phone_ number expiration idle_timeout input_filter message modem_group output_filter password phone_number session_timeout type 102 Description Name of user, previously defined using add user. Limit: 32 characters. Number to dial if the first number is busy. Limit: 64 characters. Date after which this user becomes inactive. The format is: DD-MMM-[YY]YY. Month is the first 3 letters of the month. Year is either 2 or 4 digits - 96 or 1996.
set dial_out user local_IP_address [ip_net_address] reply1_script [number] reply2_script [“string”] reply3_script [“string”] reply4_script [“string”] reply5_script [“string”] reply6_script [“string”] send1_script [“string”] send2_script [“string”] send3_script [“string”] send4_script [“string”] send5_script [“string”] send6_script [“string”] Sets parameters for dial-out users, both WAN (ISDN) and modem. Scripts strings are limited to 240 characters.
Sets parameters for dial-out users who connecting to a remote network. Parameters type appletalk default_route_ option end_time ip address_selection remote_IP_address ipx ipx_address range_appletalk_ address 104 Description Name user, previously defined using add user with dialout as the type. Describes what type of dial out connection this is: • ONDEMAND - makes connection when the system needs a session with remote network.
send_password spoofing start_time Password sent to remote network. Note: passwords you defined with other commands are for dial-in users. Maximum length: 15 characters. Whether to use spoofing across the remote connection, to save overhead on the dial-out line’s connection. Time to start a TIMED connection.
set network user address_selection [NEGOTIATE | ASSIGN | SPECIFIED] appletalk [ENABLE | DISABLE] default_route_option [ENABLE | DISABLE] filter_zones [ENABLE | DISABLE] header_compression [NONE | TCPIP] ip [ENABLE | DISABLE] ip_routing [LISTEN | SEND | BOTH | NONE] ipx [ENABLE | DISABLE] ipx_address [ipx_addr] ipx_routing [ALL | LISTEN | NONE | RESPOND | SEND] ipx_wan [ENABLE | DISABLE] MTU [number] network_service [ARAP | PPP | SLIP] range_appletalk_address [at_range] remote_ip_address [ip_addr] rip
Parameters address_selection appletalk default_route_ option filter_zones header_compression ip ip_routing ipx ipx_address ipx_routing Description User, who must have network as the type. Determines how the IP address will be assigned for incoming (client) IP network connections. • NEGOTIATE - brokers IP address between remote client and local user. • ASSIGN - chooses address from IP pool, configured using set ip system. Default.
ipx_wan MTU network_service range_appletalk_ address remote_IP_address rip rip_authentication rip_policies_update send_password spoofing 108 Protocol used when two IPX nets wish to negotiate the IPX net number for the WAN connection. Both ends of the WAN connection must enable this protocol for it to work. Default is DISABLED. Maximum Transfer Unit - largest data packet size allowed. Type of network service. Default is PPP. For AppleTalk connection, address range of the remote net.
set network user ppp channel_decrement [percent] channel_expansion [percent] compression_algorithm [ASCEND | AUTO | MICROSOFT | NONE | STAC] expansion_algorithm [CONSTANT | LINEAR] max_channels [number] min_size_compression [number] receive_acc_map [hex_number] reset_mode_compression [AUTO | EVERY_PACKET | EVERY_ERROR] transmit_acc_map [hex_number] Sets parameters for users whose type is NETWORK, and who will be connecting over an interface running multilink PPP.
Parameters channel_decrement channel_expansion compression_algorithm expansion_algorithm max_channels min_size_compression receive_acc_map reset_mode_compression transmit_acc_map 110 Description Name user, previously defined using add user with network as the type. When the line usage of the second channel drops below this point, PPP will drop to the first channel only.
SHOW Show commands display details about system entities. show accounting settings Displays RADIUS accounting settings, which you can modify using the set accounting command.
show appletalk counters Displays counters the system maintains for AppleTalk connections. • • • • • • • Table Lookups - # of times a node performed an address lookup in its Address Mapping Table. Table Hits - # of times the hardware address corresponding to an AppleTalk address was found in the Address Mapping Table. Queries Received - # of requests to determine the hardware address of a given protocol address. Replies Received - # of response packets received by a node.
show appletalk settings Displays the settings for AppleTalk, which you can modify using the set appletalk command. • • • • • • • • • • • • • • ARAP - Setting this parameter to ON allows users to connect remotely over a phone line using ARAP client software. Max ARAP Sessions - Maximum number of ARAP connections allowed at one time. Max Compressed ARAP Sessions - Maximum number of ARAP connections using compression allowed at one time.
show appletalk network counters Displays the counters for the specified Appletalk network.
show appletalk network settings Displays the settings for the specified network.
show authentication settings Displays the RADIUS and local User Authentication Settings, which you can modify using the set authentication command.
show configuration or show configuration settings Displays a variety of system information including system, network, protocol, interface, forwarding, routing, bridging, DNS, host and datalink parameters. show connection counters Displays the counters kept for dial-in connections. • Number of Calls - number of incoming calls show connection settings Displays the settings for dial-in connections, which can be modified using the set connection command.
System Date: 09-FEB-2107 15:06:10 System UpTime: 2d 08:37:54 show ddp or show ddp counters Displays the Counters for Appletalk DDP Forwarding and Listener • • • • • • • • • • • • • • APPLETALK DDP FORWARDING COUNTERS Forwarding Requests - forwarding requests received Bad Routes - packets transmitted that couldn’t find a route DDP Broadcast Errors - broadcast packets dropped because this wasn’t its destination DDP Hop Count Errors - packets dropped because hop count exceeded APPLETALK DDP COUNTERS Out
DIAL_OUT SETTINGS Security - Login Required: YES Idle Timeout (User: 5 Recovery Timeout (Workstation): 5 show dns counters Displays various counters for DNS.
show dns settings Displays settings for all DNS servers, which you can modify using set DNS.
show filter protocol [BR-ETH,BR-ETH-CALL,IP | IP-CALL, IP-RIP,IPX,IPX-CALL, IPX-RIP, IPX-SAP, ATALK,ATALK-CALL, ATALK-RTMP, ATALK-ZIP, LOGIN-ACCESS] Displays the filter rules, based on the protocol options specified. The filter name MUST be a filter file, as listed using list filters.
show icmp counters Shows Input and Output Counters for ICMP. Two types of ICMP messages error and query messages - are sent to syslog hosts.
• • • • • • • • • • • • Destination Unreachable - sum of these messages sent Time Exceeded - sum of these messages sent Parameter Problems - sum of these messages sent Source Quench - sum of these messages sent Redirects - sum of these messages sent Echos - sum of ICMP Echo (request) messages sent Echo Replies - sum of these messages sent Timestamps - sum of these messages sent Timestamp Replies - sum of these messages sent Address Masks - sum of these messages sent Address Mask Replies - sum of these mess
USRobotics Courier V.Everything Settings...
show interface counters Displays counters for the specified interface. • • • • • • • • • • • • • • INPUT COUNTERS Octets - bytes received Ucast - Unicast packets received MultiCast - Multicast packets received BroadCast - broadcast packets received Discards - Number of inbound packets which were chosen to be discarded even though no errors had been detected to prevent their being deliverable to a higher-layer protocol.
show interface settings Displays settings for the specified interface. An example of the settings is shown below.
show ip counters Displays system-wide IP network statistics.
show ip network settings Displays parameter settings for the specified IP network. See the set ip network command on page 85 for additional details.
show ipx counters Displays counters for all IPX network activity.
show ipx network counters Displays statistics for the specified IPX network. • • • • RIP Out Packets - sum of RIP packets transmitted RIP In Packets - sum of RIP packets received SAP Out Packets - sum of SAP packets transmitted SAP In Packets - sum of SAP packets received show ipx network settings Displays parameter settings for the specified IPX network. You can modify most of these values using the set ipx network command.
• • • • • • • • • • • RIP Max Packet Size - largest allowable size of a RIP packet RIP Broadcast - support ENABLED or DISABLED RIP Periodic - support ENABLED or DISABLED SAP State - support ENABLED or DISABLED SAP Pace - fastest pace, in packets per second, at which SAP packets may be sent on this circuit (not settable via the CLI) SAP Update (sec) - # of seconds waited before SAP entries aged out SAP Age Multiplier - number to multiply the sap_update_interval by, to obtain the value for the aging out the
show ipx sap settings Displays information about SAP for IPX. • • State - ON or OFF Incorrect SAP Packets - number of SAP packets that do not make sense show ipx settings Displays settings for dynamic IPX networks. You can modify these values using the set ipx system command.
show network settings Displays the configured settings for the specified network. The display varies depending on the type of network specified. show network counters Displays the statistical counters for the specified network. The display varies depending on the type of network specified. show ppp on interface settings Displays PPP settings on the specified WAN interface when interface is active.
• • • • • • • • • • • • • 134 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.
show ppp on interface counters Displays statistics for PPP running on the specified interface when interface is active. • • • • • • • • • • • • • • • • • COUNTERS for PPP BUNDLE Operational Status - not opened or opened Number Active Links - sum of active links using this PPP bundle Transmit Packets - sum of packets transmitted over this bundle Bytes from Upper Layer - sum of bytes received from an upper layer application for transmission over this bundle.
show ppp or show ppp settings Displays global settings for PPP. You can modify DIAL-IN Users Authentication using the set ppp receive_authentication command. Modify system transmit authentication name using set system command. • • DIAL-IN Users Authenticate PAP or CHAP - Choices are: CHAP, PAP, EITHER or NONE.
show snmp counters Displays many SNMP statistics. • • • • • • • • • • • • • • • • • INPUT COUNTERS Packets - number of SNMP packets received Bad Versions - SNMP messages for an unsupported SNMP version Bad Community Names - SNMP messages which used an unknown SNMP community name Bad Community Uses - SNMP messages which represented an SNMP operation not allowed by the SNMP community named in the message ASN.1 Parse Errors - sum of ASN.
• • • • • • • • • • OUTPUT COUNTERS Packets - sum of SNMP packets transmitted Too Big Errors - sum of SNMP PDUs generated by SNMP and for which the value of the error-status field is `tooBig No Such Name Errors - sum of SNMP PDUs generated by SNMP and for which the value of the error-status field is `noSuchName' Bad Value Errors - sum of SNMP PDUs generated by SNMP and for which the value of the error-status field is `badValue' General Errors - sum of SNMP PDUs generated by SNMP and for which the value of
• • • • System Location - site where system is located. Modify using set system command System Services - for example, Internet EndToEnd Applications System Transmit Authentication Name - keyword for PPP on the WAN, modified using set system command System Version - loaded version of the system software show tcp counters Displays system-wide TCP statistics.
show TCP settings Displays system-wide TCP settings. Note: These settings cannot be edited. • • • • TCP SETTINGS Retransmission Algorithm - for example, Van Jacobson Minimum Timeout - minimum retransmission timeout interval Maximum Timeout - maximum retransmission timeout interval Maximum Connections - sum of TCP connections allowed. Default: 1024. show telnet or show telnet settings Displays the status of the TELNET escape feature (ENABLED or DISABLED).
TELNET TELNET commands are available to users who dial in, and whose type is network (type parameter in add user), whose host_type is prompt (host_type parameter in set login user), and whose login_service is TELNET (login_service parameter in set login user). telnet Establishes a TELNET client session with the specified IP host name or address.
VERIFY verify filter Verifies the syntax of a filter file, which has been previously added to the table. If you update a filter file and TFTP it to the FLASH file system, and the file already exists in the Filter Table, then you use this command to verify the files syntax. You can use list filters to see which files are currently in the Filter File Table, and what the status of each is.
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. See the CLI Exit Commands to learn how to exit the CLI, and return to the Dial-in User Commands. rlogin Establishes an rlogin client session with the specified IP host name or IP address. You must have run add DNS host or add DNS server for the system to recognize an IP host name.
TELNET Commands The following commands are available to users whose host_type is prompt, and whose login_service is TELNET. Login users who have TELNET client ] (ctrl ] ). connections can access these commands by hitting & close Closes the active TELNET connection. help Lists the available commands send Sends a TELNET control character.
status Displays the IP address of the remote host and the value of the TELNET escape character. CLI Exit Commands These commands are available to dial-in (modem) and TELNET (LAN) users so they can disconnect from the CLI. Bye, Exit, Leave, Quit Leave the CLI, but keep this connection open. This command returns you to the Dial-In User or TELNET commands. Logout Leave the CLI and close this connection. This ends the dial-in user’s or TELNET session.
Command Line Edit && (( && && Command line edit allows non-destructive cursor movements on a command already typed. UO b (ctrl b) or f (ctrl f) or b (Esc-b) f (Esc-f) a (ctrl a) e (ctrl e) d (ctrl-d) k (ctrl k) (left arrow) (right arrow) go back one character go forward one character go back one word go forward one word go to beginning of command go to end of command delete character delete line Command Retrieval Command retrieval retrieves commands from the history of previous commands entered.
Output Pause The output will pause when there is more than 24 lines of output. Type ‘more’ (or press CR) to continue, or ‘quit’ to stop. Command Kill & To discontinue the current command action, and flush any commands which c (ctrl c). have been typed ahead, use Comments ; Nothing following the semicolon will be processed. This is useful when you are writing CLI script files. The do command runs a CLI script.
Index A Add command............................... 23 AppleTalk ARAP Clients add user ............................... 41 set appletalk ........................ 74 set modem_group ................ 93 set switched interface .......... 97 show appletalk network counters ........................ 114 show appletalk settings...... 113 Configuration add appletalk network ......... 27 add appletalk zone............... 28 delete appletalk network...... 43 delete appletalk zone...........
Diagnostics resolve name ........................72 Statistics show dns counters..............119 Domain Name Service (DNS).......24 F Filters add filter ...................................29 delete filter ...............................44 list filters...................................62 FLASH ROM ................................23 Frame Relay Configuration add user................................41 Managing disable user ..........................51 I Interface ..................................
TFTP add tftp client ...................... 41 delete tftp client................... 46 list tftp clients...................... 70 IPX Configuration add ipx network................... 32 add user ............................... 41 delete ipx network ............... 45 disable ipx network ............. 49 enable ipx network .............. 54 set ipx network .................... 89 show ipx network settings . 130 show ipx settings ............... 132 Routing add ipx route .......................
P Password .......................................23 Passwords add modem_group....................36 add user ....................................41 disable authentication local ......47 enable authentication local .......52 set appletalk..............................74 set dial_out user......................103 set dialout .................................80 set modem_group .....................93 set network user......................106 set ppp receive_authentication .96 set switched interface ..........
enable telnet escape............. 56 Service Repair Order SRO number ............................ 18 Set command .............. 21, 22, 23, 25 Show command ............................ 25 SNMP add snmp community ............... 39 add snmp trap_community....... 40 delete snmp community ........... 46 delete snmp trap_community ... 46 disable link_traps interface ...... 49 disable security_option snmp user_access.......................... 50 disable snmp authentication traps .................................
CLI Reference Guide 127
