[Top] [Table Of Contents] [Prev] [Next] [Index]
14 out of 25 total pages
 

Locations and DLCIs   11

  This chapter describes how to use the command line interface to configure the PortMaster to recognize dial-out network connections (locations). The configuration settings are stored in the location table. Detailed command definitions follow a command summary table. A summary table and details for the data link connection identifier (DLCI) commands used for Frame Relay subinterfaces are also described.

  Note ¯ After making changes to a location that is in use, you must reset the port that the location is using.

 
 

       Displaying Location Information

  Use the following commands to display information about dial-out locations:
 

       Summary of Location Commands

  The commands in Table 11-1 are used to configure the PortMaster for network dial-out.
  DLCI commands begin on page 11-22.

  Table 11-1 Location Configuration Commands 

 
  Command Syntax     
 add location Locname  - see page 11-3
 delete location Locname  - see page 11-3
 save location  - see page 11-4
 set location Locname analog on|off  - see page 11-4
 set location Locname automatic|manual|on_demand  - see page 11-5
 set location Locname chap on|off  - see page 11-6
 set location Locname compression on|off|stac|vj  - see page 11-6
 set location  Locname  crossbar-ip  Ipaddress   - see page 7-5
 set location Locname destination Ipaddress  - see page 11-7
 set location Locname group Group  - see page 11-7
 set location Locname high_water Number  - see page 11-8
 set location Locname idletime Number [minutes|seconds]  - see page 11-9
 set location Locname ifilter [Filtername]  - see page 11-9
 set location Locname ipxnet Ipxnetwork  - see page 11-10
 set location Locname local-ip-address Ipaddress  - see page 11-11
 set location Locname map Hex  - see page 11-12
 set location Locname maxports Number  - see page 11-12
 set location Locname mtu MTU  - see page 11-13
 set location Locname multilink on|off  - see page 11-14
 set location Locname netmask Ipmask  - see page 11-15
 set location Locname ofilter [Filtername]  - see page 11-15
 set location Locname password Password  - see page 11-16
 set location Locname protocol
slip|ppp|frame_relay|x75-sync 		 - see page 11-17
 set location  Locname  rip on |off |broadcast |listen |v2  {broadcast |multicast |on |
v1-compatibility } 		 - see page 7-17
 set location Locname route-filter incoming|outgoing [Filtername]  - see page 7-8
 set location Locname script|v25bis
RuleNumber "String1" "String2" 		 - see page 11-18
 set location Locname telephone String  - see page 11-19
 set location Locname username Username  - see page 11-20
 set location Locname voice on|off  - see page 11-21
 show location Locname  - see page 11-21
 show table location  - see page 11-22
 

       Location Commands

  These commands configure the location table of the PortMaster.
 

       add location

  This command adds a dial-out location to the location table.

  add location Locname

 
 Locname  Name of a remote location, up to 12 characters.

  The location name is usually an identifier that represents an entire location--for example, a city or a company name at that location. It is not usually the name of a single system.
 

       delete location

  This command deletes a dial-out location from the location table.

  delete location Locname

 
 Locname  Location name that is in the location table.

 

       save location

  This command writes any changes in the location table to the nonvolatile memory of the PortMaster.

  save location

  The save all  command can also be used.
 

       set location analog

  This command sets the PortMaster to use analog modem service for dialing out to the specified location.

  set location Locname analog on|off

 
 Locname  Location name that is in the location table.
 on  Enables analog modem service on dial-out.
 off  Disables analog modem service on dial-out, and causes the service to revert to ISDN.

  Use this command when analog rather than digital modem service is required for dial-out network connections.
 

       set location automatic|manual|on_demand

  This command modifies configuration parameters for the specified dial-out location.

  set location Locname automatic|manual|on_demand

 
 Locname  Location name that is in the location table.
 automatic  Sets the PortMaster to dial out to the location at boot time and to redial after a delay of 30 seconds if the connection drops.
 manual  Sets the PortMaster to dial to the remote location when the administrator uses the dial  command or pmdial  utility. This keyword is also used for network dialback users. This is the default.
 on_demand  Sets the PortMaster to dial to the remote location when packets are queued for that location.

 

       set location chap

  This command is used for configuring outbound CHAP authentication for a specified dial-out location.

  set location Locname chap on|off

 
 Locname  Location name that is in the location table. The username and password entered in the location table are used as the system identifier and MD5 secret in the CHAP authentication.
 on  CHAP authentication is negotiated for the specified location.
 off  CHAP authentication is not supported for an outbound dial. This is the default.

  The username and password entered in the location table are used as the system identifier and MD5 secret in the CHAP authentication. Use of this feature eliminates the need to use the system name and user table configurations for CHAP, unless the device being dialed also dials into the PortMaster.
 
 

       set location compression

  This command sets the use of Van Jacobson TCP/IP header compression and Stac LZS data compression for the dial-out location, improving interactive session performance.

  set location Locname compression on|off

 
 Locname  Location name that is in the location table.
 on  Enables both Van Jacobson and Stac LZS compression. This is the default.
 off  Disables compression.
 stac  Enables Stac LZS data compression only.
 vj  Enables Van Jacobson TCP/IP header compression only.
|stac|vj

  Van Jacobson TCP/IP header compression can be used for SLIP and PPP connections. With SLIP, both sides need to be configured identically. For PPP connections, the PortMaster supports both bidirectional and unidirectional compression.
  The PortMaster supports Stac LZS data compression only for PPP connections with bidirectional compression. Stac LZS data compression cannot be used for SLIP connections.
 

       set location destination

  This command sets the IP address expected for the system at the remote end of the dial-out connection.

  set location Locname destination Ipaddress

 
 Locname  Location name that is in the location table.
 Ipaddress  IP address or 39-character hostname of the destination.

  For SLIP connections, enter the IP address or a valid hostname of the system at the remote end of the dial-up connection. For PPP connections, the destination can be specified or negotiated. Assigned addresses are not supported for dial-out locations. To negotiate the address, use 255.255.255.255.
 

       set location group

  This command defines which network dial-out ports can be used for a specified location.

  set location Locname group Group

 
 Locname  Location name that is in the location table.
 Group  Dial group from 0 to 100. The default is 0.

  Each location has a dial group number. Ports configured with this dial group number are available for dial-out to this location. This command can be used to reserve ports for dial-out to specific locations, or to differentiate among different types of modems that are compatible with the remote location.
 

       set location high_water

  This command sets the number of bytes of queued network traffic required to open an additional dial-out line to the remote location.

  set location Locname high_water Number

 
 Locname  Location name that is in the location table.
 Number  Number between 0 and 65535. The default is 0.

  This value is used only when maxports  is greater than 1 and network dial-out ports are available on the PortMaster. The PortMaster can quickly use all available ports for this location dial group if the high_water  setting is too small.
  Generally, interactive terminal traffic has no more than a few hundred bytes queued at any one time, but file transfers (for example, FTP) queue several thousand bytes. Consider size differences when deciding the number to use for high_water .
 

       set location idletime

  This command sets the length of time the line can be idle--in both directions--before the PortMaster disconnects the connection to a specified dial-out location.

  set location Locname idletime Number [minutes|seconds]

 
 Locname  Location name that is in the location table.
 Number  Timeout value from 0 to 255. The default value is 0.
 minutes  Sets the idle time in minutes. This is the default.
 seconds  Sets the idle time in seconds.

  The idle timeout value is specified in minutes or seconds and can be any value from 0 to 255. It is for manual and on-demand locations.
  If the idle timeout value is set to 0, the idle timer is disabled.
  If the value is set to 2 seconds or a longer interval, the connection is disconnected after having no traffic for the designated time. RIP packets are not counted as traffic.

  Note ¯ The idle time special value of 1 second applies only to asynchronous ports that have modem control turned on with the set  S0 cd on  command. Ports that are in the command state--with an administrator logged on--are not timed out with the special value of 1 second.

 

       set location ifilter

  This command sets a packet filter for packets entering the PortMaster from the interface this dial-out location establishes.

  set location Locname ifilter [Filtername

 
 Locname  Location name that is in the location table.
 Filtername  Name of the input filter. The maximum is 15 characters.
]

  When a filter is changed, any ports in use by the location must be reset for the changes take effect.
  To remove the filter, enter the command without a filter name.

  Note ¯ If a matching filter name is not in the filter table, this command is not effective and all traffic is permitted.

 

       set location ipxnet

  This command sets the IPX network number for the point-to-point connection.

  set location Locname ipxnet Ipxnetwork

 
 Locname  Location name that is in the location table.
 IPXnetwork  IPX network to be used for a serial link. A 32-bit hexadecimal value.

  Specify this number only if you are routing IPX across the link. The number is only used for the serial link itself, and must be different from the IPX network numbers at each end of the Ethernet.
 

       set location local-ip-address

  This command allows a dial-out location to assert a local IP address on a PortMaster asynchronous or ISDN dialout port for numbered IP networks.

  set location Locname local-ip-address Ipaddress

 
 Locname  Location name that is in the location table.
 Ipaddress  IP address or 39-character hostname.

  Use this command only when a unique IP subnet is required for a point-to-point network connection--when both ends of the connection require an IP address. This command is not needed for typical PortMaster operation. If this value is not set, the PortMaster uses the IP address of the Ether1 port.
 

       set location map

  This command sets the PPP asynchronous map for a specified dial-out location.

  set location Locname map Hex

 
 Locname  Location name that is in the location table.
 Hex  A 32-bit hexadecimal number. The default is 0x00000000.

  The PPP protocol supports the replacement of nonprinting ASCII data in the PPP stream. These characters are not sent through the line, but instead are replaced by a special set of characters that the remote site interprets as the original characters. The PPP asynchronous map is a bit map of characters that must be replaced. The lowest-order bit corresponds to the first ASCII character NUL, and so on. Most environments set the asynchronous map to zero to achieve maximum throughput. This command does not apply to the Serial Line Internet Protocol (SLIP).
  The command set location Locname map 0 disables the asynchronous mapping.
 

       set location maxports

  This command sets the maximum number of network dial-out ports the PortMaster can use for this location.

  set location Locname maxports Number

 
 Locname  Location name that is in the location table.
 Number  Number between 0 and 95. The default is 0.

  If 0  is selected, dialing to this location is disabled. If a number greater than 1 is selected, the PortMaster uses the value of high_water  to decide when to dial out on additional lines. If more than one line is open to the remote location, the PortMaster balances the load among the lines. If multiple lines are open, idle time is used to decide when to disconnect unused lines.
  The maximum number of ports should be the last setting configured for a location. When the number is set to greater than zero, the location is available for use.
 

       set location mtu

  This command sets the size of the maximum transmission unit (MTU) for the dial-out location.

  set location Locname mtu MTU

 
 Locname  Location name that is in the location table.
 MTU  MTU value, from 100 to 1500 bytes.

  The MTU defines the largest frame or packet that can be sent through this port without fragmentation. A packet that exceeds this value is automatically fragmented if IP, or discarded if IPX. PPP connections have a maximum MTU of 1500 bytes, and SLIP connections have a maximum of 1006 bytes.
 

       set location multilink

  This command determines whether the PortMaster uses RFC 1990 Multilink PPP or PortMaster multiline load balancing for dial-out to a specified location through multiple ports.

  set location Locname multilink on| off

 
 Locname  Location name that is in the location table.
 on  Enables Multilink PPP--for ISDN and analog connections only.
 off  Enables PortMaster multiline load-balancing. This is the default.

  PortMaster multiline load balancing and Multilink PPP provide methods for splitting, recombining, and sequencing packets across multiple logical data links. PortMaster multiline load balancing can be used only for communications between PortMaster products. In contrast, Multilink PPP can be used with an ISDN connection between devices that support the standard described in RFC 1990.
 

       set location netmask

  This command sets the IP netmask expected for the host or network at the remote end of the dial-out connection.

  set location Locname netmask Ipmask

 
 Locname  Location name that is in the location table.
 Ipmask  IP netmask in dotted decimal notation.

  Enter the netmask number in dotted decimal notation. For more information, see the section on netmasks in the PortMaster 4 Configuration Guide.
 

       set location ofilter

  This command sets a packet filter for packets exiting the PortMaster to the interface this dial-out location establishes.

  set location Locname ofilter [Filtername]

 
 Locname  Location name that is in the location table.
 Filtername  Name of the output filter. The maximum is 15 characters.

  When a filter is changed, any ports in use by the location must be reset to have the change take effect.
  You remove the filter by entering the command without a filter name.
 

       set location password

  This command sets up a password for automatic location table scripting for dialing to a remote location.

  set location Locname password Password

 
 Locname  Location name that is in the location table.
 Password  PAP password associated with the username. Alternatively, this password can be used with CHAP if CHAP authentication is set on  for the location; see
page 11-6. The maximum password length is 64 characters.

  Location table scripting, which uses this command together with the set location telephone  and set location username  commands, provides a simple alternative to setting up a V.25bis or chat dial script.
  This is the preferred way to set up location table scripting when dialing to a remote location.
 

       set location protocol

  This command sets the protocol for encapsulating packets for the specified dial-out location.

  set location Locname protocol slip|ppp|frame_relay|x75-sync

 
 Locname  Location name that is in the location table.
 slip  SLIP protocol.
 ppp  PPP protocol.
 frame_relay  Frame Relay subinterface.
 x75-sync  X.75 protocol.

  PPP can be used with either IP or IPX packet routing, or both.

  Note ¯ The PortMaster 4 supports IPX protocols on ComOS 4.1 and later releases.

 

       set location script

  This command sets up a dial script for dialing to a remote location.

  set location Locname script|v25bis RuleNumber "String1" "String2"

 
 Locname  Location name that is in the location table.
 script  Enables a dial script for dial-out on an asynchronous port. The total length of all strings in the script must not exceed 256 characters.
 v25bis  Enables a dial script for synchronous V.25bis protocol dial-out, for switched 56Kbps or ISDN.
 RuleNumber  Rule number, from 1 up. Use rule number 99 to delete the script.
 "String1"  Send string of up to 30 characters, in quotation marks.
 "String2"  Expect string of up to 30 characters, in quotation marks.

  Note ¯ Alternatively, for PPP users, you can set up automatic location table scripting. This method is much simpler to administer, and is preferred for setting up location table scripting. See the commands set location telephone , set location username , and set location password  for information.

  Each send string is sent from the PortMaster to the modem or remote host. When the expect string is matched against the input from the remote end, the next line in the send string is sent, and so on. When the last line in the script is finished, the PortMaster activates the data link protocol specified for this location. Therefore, the last entry in the dial command script must be an expect string indicating that the remote location is ready to begin receiving network packets.
  Any printable ASCII character can be placed in the send or expect strings. In addition, the following special characters are available:
 
 \r  ASCII carriage return. Send strings usually end with the \r  character. Do not use \r  in the send string for the V.25bis protocol.
 \0XX  Replaced by the octal digit in the XX.
 \\  Replaced by a single backslash.
  When you are connecting to a remote PortMaster, the final expect string to verify must be SL/IP  for SLIP connections and PPP  or a tilde (~ ) for PPP connections. A tilde is always the first character of a PPP frame. For other manufacturer's products, consult their manuals.
  The dial script can also be used to implement outbound PAP authentication. If you specify a PAP username and password in the last line of the dial script, the PortMaster can be authenticated by the remote end using PAP. This capability is shown in the final example below.
 

       set location telephone

  This command sets up a telephone number for automatic location table scripting for dialing to a remote location.

  set location Locname telephone String

 
 Locname  Location name that is in the location table.
 String  Telephone number to dial. Specify multiple numbers by separating them with ampersands (&). The maximum string length is 64 characters.

  Location table scripting, which uses this command together with the set location username  and set location password  commands, provides a simple alternative for PPP users to setting up a V.25bis or chat dial script.
  This is the preferred way for PPP users to set up location table scripting when dialing to a remote location.
  set location script - page 11-18

  set location username - page 11-20

 

       set location username

  This command sets up a PAP or CHAP username for automatic location table scripting for dialing to a remote location.

  set location Locname username Username

 
 Locname  Location name that is in the location table.
 Username  PAP or CHAP username to use when logging in to the remote location.  The maximum name length is 64 characters.

  Location table scripting, which uses this command together with the set location telephone  and set location password  commands, provides a simple alternative for PPP users to setting up a V.25bis or chat dial script.
  This is the preferred way for PPP users to set up location table scripting when dialing to a remote location.
 

       set location voice

  This command forces a data-over-voice call on an outbound ISDN connection to a specified dial-out location.

  set location Locname voice on|off

 
 Locname  Location name that is in the location table.
 on  Forces data-over-voice via 3.1KHz audio service on an outbound ISDN connection.
 off  Disables data-over-voice on an outbound ISDN connection. This is the default.

  Data over voice is supported for inbound and outbound ISDN connections. The PortMaster automatically accepts inbound voice calls and treats them as data calls.
 

       show location

  This command displays configuration information for a specified dial-out location.

  show location Locname

 
 Locname  Location name that is in the location table.

 

       show table location

  Network dial-out destinations are configured in the location table. This command shows the current entries in the location table.

  show table location

 

       DLCI  Commands

  The commands in Table 11-2 configure the PortMaster to recognize data link connection identifiers (DLCIs). You can split a Frame Relay interface into primary and secondary subinterfaces according to the data link connection identifier (DLCI). The configuration settings are stored in the DLCI table.

  Table 11-2 DLCI Configuration Commands

 
  Command Syntax     
 add dlci|ipdlci|ipxdlci Locname  Dlci [Ipaddress| Ipxnode]  - see page 11-23
 add W1 dlci  - see page page 6-3
 delete dlci|ipdlci|ipxdlci Locname  Dlci  - see page 11-24
 delete W1 dlci  - see page 6-4
 show location Locname  - see page 11-21
 

       add dlci

  This command sets the Frame Relay subinterfaces for a specified location that has been configured to use Frame Relay service.

  add dlci|ipxdlci Locname Dlci :[Ipaddress|Ipxnode]

 
 dlci  Use for IP connections.
 ipxdlci  Use for IPX connections.
 Locname  Location name that is in the location table.
 Dlci  DLCI number, from 1 to 1023.
 :Ipaddress  Optional IP address of the router attached to the permanent virtual circuit (PVC) represented by the DLCI.
 :Ipxnode  IPX node address of the PortMaster attached to the permanent virtual circuit (PVC) represented by the DLCI. This value is the PortMaster MAC address--a 48-bit number.

  The PortMaster supports a feature called DLCI bundling to allow one synchronous port with multiple DLCIs to be split into up to 32 Frame Relay subinterfaces. Each Frame Relay subinterface can have up to 50 DLCI mappings. Splitting is done through the use of the location table and the DLCI table.
  The port to which the Frame Relay is connected must be set for Frame Relay, and must be in the same dial group as the location. Each subinterface must have its own subnet or network number.
  You can configure the PortMaster for no more than 864 (T1) or 810 (E1) interfaces. Refer to the PortMaster 4 Configuration Guide  for more information.
  You can change values in the add dlci  command by repeating the command with new values. You do not need to delete the existing DLCI entries before changing the values.
  In this example, port S1  is configured for Frame Relay and a new location sub1  is configured as a subinterface. Commands and responses are shown.

  Command> set s1 protocol frame
 Protocol for port S1 changed from slip to frame_relay

  Command> set s1 group 1
 Group number for port S1 changed from 0 to 1

  Command> add location sub1
 Location sub1 successfully added

  Command> set location sub1 protocol frame
 sub1 protocol changed to frame_relay

  Command> set location sub1 group 1
 sub1 group number changed from 0 to 1

  Command> set location sub1 address 192.168.3.1
 sub1 destination changed from 0.0.0.0 to 192.168.3.1

  Command> set location sub1 netmask 255.255.255.0
 sub1 netmask changed from 0.0.0.0 to 255.255.255.0

  Command> set location sub1 routing on
 sub1 routing changed from off to on (broadcast,listen)

  Command> add dlci sub1 16
 New dlci successfully added

  Command> add dlci sub1 17
 New dlci successfully added

  Command> save all
 Command> reset s1 

  add W1 dlci - page 6-3
delete dlci - page 11-24
 

       delete dlci

  This command deletes entries from the DLCI table.

  delete dlci|ipxdlci Locname Dlci

 
 dlci  Use for IP connections.
 ipxdlci  Use for IPX connections.
 Locname  Specified location name that is in the location table.
 Dlci  DLCI number, from 1 to 1023.

   The PortMaster 4 supports IPX protocols on ComOS 4.1 and later releases.
 
  This procedure is the reverse of adding the DLCI subinterfaces. You can confirm the removal by using the show location  command.
[Top] [Table Of Contents] [Prev] [Next] [Index]
14 out of 25 total pages
spider@livingston.com
Copyright © 1999, Lucent Technologies. All rights reserved.