Page 1 SmartNode Series SmartWare Release 3.21 Software Conﬁguration Guide Sales Ofﬁce: +1 (301) 975-1000 Technical Support: +1 (301) 975-1007 E-mail: support@patton.com URL: www.patton.com Document Number: 13211U8-003 Rev. B Part Number: 07MSWR321_SCG Revised: March 27, 2007...
Page 2 Patton Electronics Company, Inc. 7622 Rickenbacker Drive, Gaithersburg, MD 20879 USA Tel: +1 (301) 975-1000 • Fax: +1 (301) 869-9293 • Support: +1 (301) 975-1007 Web: www.patton.com • E-mail: support@patton.com Copyright Statement Copyright © 2007, Patton Electronics Company. All rights reserved. Trademark Statement The terms SmartWare, SmartView, SmartLink, and SmartNode are trademarks of Patton Electronics Com- pany.
Page 3: Table Of Contents
Summary Table of Contents System overview ............................33 Configuration concepts ..........................39 Command line interface (CLI) ........................44 Accessing the CLI ............................48 System image handling..........................59 Configuration file handling........................... 70 Basic system management ..........................84 RADIUS Client Configuration........................95 IP context overview .............................
Page 4 SmartWare Software Configuration Guide H.323 interface configuration ........................369 SIP interface configuration ......................... 379 Call router configuration..........................392 Tone configuration............................457 ISDN port configuration..........................465 FXS port configuration ..........................480 FXO port configuration ..........................485 H.323 gateway configuration ........................489 SIP gateway configuration...........................
Page 5: Table Of Contents
Table of Contents Summary Table of Contents ........................... 3 Table of Contents ............................5 List of Figures ............................... 23 List of Tables ..............................25 About this guide ............................26 Audience................................26 How to read this guide ............................26 Structure................................27 Precautions ................................
Page 6 SmartWare Software Configuration Guide Table of Contents Use Commands ..............................43 Command line interface (CLI) ........................44 Introduction ................................45 Command modes ..............................45 CLI prompt ..............................45 Navigating the CLI ............................46 Initial mode ..............................46 System changes ............................46 Configuration ............................46 Changing Modes ............................46 Command editing ..............................46 Command help ...............................46...
Page 7 SmartWare Software Configuration Guide Table of Contents Upgrading the software directly ........................65 Auto provisioning of firmware and configuration ....................66 Boot procedure..............................68 Factory configuration ............................69 Default Startup Configuration ........................69 IP Addresses in the Factory Configuration ......................69 Configuration file handling........................... 70 Introduction ................................71 Understanding configuration files ........................71...
Page 8 SmartWare Software Configuration Guide Table of Contents RADIUS configuration............................99 Configuring RADIUS clients ........................100 Configuring RADIUS accounting .........................101 Configuring the RADIUS server ........................103 Attributes in the RADIUS request message .....................103 Attributes in the RADIUS accept message ....................104 Configuring the local database accounts ......................104 IP context overview .............................
Page 9 SmartWare Software Configuration Guide Table of Contents Dynamic NAT ..............................125 Static NAT ..............................126 NAPT traversal .............................126 NAT/NAPT configuration task list ........................127 Creating a NAPT profile ..........................127 Configuring a NAPT DMZ host ......................128 Defining NAPT port ranges ........................128 Preserving TCP/UDP port numbers in NAPT ..................129 Defining the UDP NAPT type .......................129...
Page 10 SmartWare Software Configuration Guide Table of Contents Creating a service policy profile ........................150 Specifying the handling of traffic-classes ......................152 Defining fair queuing weight ........................152 Defining the bit-rate ..........................153 Defining absolute priority ........................153 Defining the maximum queue length ......................153 Specifying the type-of-service (TOS) field ....................153 Specifying the precedence field ........................154...
Page 11 SmartWare Software Configuration Guide Table of Contents Configuring T1/E1 port-type ........................182 Configuring T1/E1 clock-mode ........................182 Configuring T1/E1 line-code ........................182 Configuring T1/E1 framing ..........................182 Configuring T1/E1 line-build-out (T1 only) ....................183 Configuring T1/E1 used-connector (E1 only) ....................183 Configuring T1/E1 application mode ......................183 Configuring T1/E1 LOS threshold .......................184 Configuring E1/T1 Loopback detection...
Page 12 SmartWare Software Configuration Guide Table of Contents Changing the default UDP port range for RTP and RTCP .................201 configuration............................202 Introduction ................................203 Routing protocol ..............................203 RIP configuration task list ...........................204 Enabling send RIP ............................204 Enabling an interface to receive RIP ......................205 Specifying the send RIP version ........................205...
Page 13 SmartWare Software Configuration Guide Table of Contents Network management framework .........................228 Identification of a SmartNode via SNMP......................228 SNMP tools.................................229 SNMP configuration task list ..........................229 Setting basic system information..........................229 Setting access community information ........................231 Setting allowed host information .........................233 Specifying the default SNMP trap target ......................233 Displaying SNMP related information ........................234...
Page 14 SmartWare Software Configuration Guide Table of Contents DNS configuration task list ..........................262 Enabling the DNS resolver ..........................262 Enabling the DNS relay ..........................263 DynDNS configuration ..........................265 Introduction ................................266 DynDNS configuration task list ..........................266 Creating a DynDNS account ........................266 Configuring the DNS resolver ........................266 Configuring basic DynDNS settings ......................267...
Page 15 SmartWare Software Configuration Guide Table of Contents Configuration of an IP interface and the IP router for IPsec ................293 Displaying IPsec configuration information ....................293 Debugging IPsec ............................294 Key management (IKE) ............................295 Main differences between manual & IKE IPSEC configurations .............295 Creating an ISAKMP transform profile ....................296 Creating an ISAKMP IPSEC policy profile...
Page 16 SmartWare Software Configuration Guide Table of Contents Configuring call routing ..........................318 Configuring VoIP settings ..........................320 Configuring BRI ports ..........................320 Configuring an H.323 VoIP connection .......................321 Activating the CS context configuration ......................321 Showing the running configuration .......................323 CS interface configuration........................... 327 Introduction ................................328 CS interface configuration task list...
Page 17 SmartWare Software Configuration Guide Table of Contents Configuring call waiting supplementary service (optional) ................355 Configuring additional call offering supplementary service (optional) ............355 FXO interface configuration ........................357 Introduction ................................358 FXO services description .............................359 Creating an FXO interface...........................359 Deleting an FXO interface...........................360 FXO interface configuration task list ........................361...
Page 18 SmartWare Software Configuration Guide Table of Contents SIP Diversion Header ...........................389 Transmit Direction ..........................389 Receive Direction ............................390 AOC Over SIP ..............................391 Call router configuration..........................392 Introduction ................................394 Call router configuration task list.........................396 Map out the goals for the call router ......................396 Enable advanced call routing on circuit interfaces ..................397...
Page 19 SmartWare Software Configuration Guide Table of Contents Call-Router .............................429 Egress Interface ............................431 Creating call services .............................433 Creating a hunt group service ........................433 Creating a distribution group service ......................442 Distribution-Group Min-Concurrent setting ....................444 Call-router ‘limiter’ service ..........................444 Priority service ..............................445 CS Bridge service—‘VoIP Leased Line’ ......................447 Deleting call services .............................449...
Page 20 SmartWare Software Configuration Guide Table of Contents Configure country-specific FXS port parameters....................482 Other FXS port parameters..........................483 Example ................................483 FXO port configuration ..........................485 Introduction ................................486 Shutdown and enable FXO ports.........................486 Bind FXO ports to higher layer applications......................486 Configure country specific FXO port parameters....................487 Other FXO port parameters ..........................487...
Page 21 SmartWare Software Configuration Guide Table of Contents Configuring the traffic class for SIP signaling ..................510 Define session timer version ........................511 Define call transfer version ........................511 SIP Profile ...............................512 Manually configuring the SIP contact IP address ..................513 Initiating a new SIP session for redirected SIP calls .................513 Enabling the SIP penalty-box feature ......................513...
Page 22 SmartWare Software Configuration Guide Table of Contents Introduction ................................545 Debugging strategy..............................545 Filtering debug monitor output ...........................546 Verifying IP connectivity .............................546 Debugging call signaling............................547 Debugging ISDN signaling ...........................547 Verify an incoming call ...........................548 Verify an outgoing call ..........................549 Verify ISDN layer 1,2,3 status ........................551 Debugging FXS Signaling ..........................552...
Page 23: List Of Figures
List of Figures Basic system (abstract) model ............. . 35 Typical carrier network application with a SmartNode.
Page 24 SmartWare Software Configuration Guide Incoming call passing an interface mapping table ..........333 Call passing an input and an output mapping table .
Page 25: List Of Tables
List of Tables General conventions ..............30 Mouse conventions .
Page 26: System Overview
About this guide The objective of this SmartWare Software Conﬁguration Guide is to provide information concerning the syntax and usage of the command set. For hardware specﬁc information, refer to the getting started guide that came with your unit. This section describes the following: •...
Page 27: Configuration Concepts
SmartWare Software Configuration Guide About this guide Structure This guide contains the following chapters and appendices: • Chapter 1, "System overview" on page 33 provides an overview of the main elements of a SmartWare system. • Chapter 2, "Conﬁguration concepts" on page 39 introduces basic SmartWare conﬁguration concepts.
Page 28: Snmp Configuration
SmartWare Software Configuration Guide About this guide • Chapter 18, "RIP conﬁguration" on page 202 provides an overview of the routing information protocol (RIP) and describes the tasks involved in conﬁguring RIP features within SmartWare. • Chapter 19, "Access control list conﬁguration" on page 212 provides an overview of IP access control lists and describes the tasks involved in their conﬁguration through SmartWare.
Page 29: Precautions
SmartWare Software Configuration Guide About this guide • Chapter 36, "ISDN port conﬁguration" on page 465 provides an overview of SmartNode ISDN ports and describes the tasks involved in conﬁguring ISDN ports in SmartWare. • Chapter 37, "FXS port conﬁguration" on page 480 provides an overview of POTS signaling and Smart- Node FXS ports and describes the tasks involved in conﬁguring FXS ports in SmartWare.
Page 30: Typographical Conventions Used In This Document
SmartWare Software Configuration Guide About this guide Typographical conventions used in this document This section describes the typographical conventions and terms used in this guide. General conventions In this guide we use certain typographical conventions to distinguish elements of commands and examples. In general, the conventions we use conform to those found in IEEE POSIX publications.
Page 31: Mouse Conventions
SmartWare Software Configuration Guide About this guide Mouse conventions The following conventions are used when describing mouse actions: Table 2. Mouse conventions Convention Meaning Left mouse button This button refers to the primary or leftmost mouse button (unless you have changed the default conﬁguration).
Page 32: Warranty Service And Returned Merchandise Authorizations (Rmas)
SmartWare Software Configuration Guide About this guide Warranty Service and Returned Merchandise Authorizations (RMAs) Patton Electronics is an ISO-9001 certiﬁed manufacturer and our products are carefully tested before ship- ment. All of our products are backed by a comprehensive warranty program. Note If you purchased your equipment from a Patton Electronics reseller, ask your reseller how you should proceed with warranty service.
Page 33: System Overview
Chapter 1 System overview Chapter contents Introduction ................................34 SmartWare embedded software ..........................35 Applications................................36 Carrier networks .............................36 Enterprise networks ............................37 LAN telephony ...............................38...
Page 34: Introduction
SmartWare Software Configuration Guide 1 • System overview Introduction This chapter provides an overview of the main elements of a SmartNode system. A complete SmartNode system or network, as installed in any of the application scenarios introduced in section “Applications” on page 36, is typically composed of the following main elements plus a third-party network infra- structure: •...
Page 35: Smartware Embedded Software
SmartWare Software Configuration Guide 1 • System overview Figure 1 depicts the basic system model of a Patton SmartNode. All SmartNode devices have the following main components: • 64k circuit switching between on-board ISDN ports and between ISDN and PSTN interface cards. The circuit switching engine uses dedicated hardware resources and therefore can bypass the VoIP gateway and packet routing engine.
Page 36: Applications
SmartWare Software Configuration Guide 1 • System overview Applications The Patton SmartNode product family consists of highly ﬂexible multi-service IP network devices, which ﬁt a range of networking applications. This section provides an overview of the following SmartNode applications and the main elements in a SmartNode network. •...
Page 37: Enterprise Networks
SmartWare Software Configuration Guide 1 • System overview Typical services in these networks are softswitch-based telephony, PSTN access through V5.2 gateways, PBX networking services, and LAN interconnection. Typical access technologies for these networks include xDSL, WLL, PowerLine, cable and conventional leased lines.
Page 38: Lan Telephony
SmartWare Software Configuration Guide 1 • System overview PSTN IPPBX Node IP Phones Figure 4. Typical LAN telephony system with a SmartNode gateway LAN telephony With its voice-over-IP gateway features, the SmartNode can be used as a standalone gateway for VoIP tele- phony (see ﬁgure A standalone gateway has performance reliability and scalability advantages compared with PC-based gateway...
Page 39 Chapter 2 Conﬁguration concepts Chapter contents Introduction ................................40 Contexts and Gateways............................41 Context ................................41 Gateway ................................41 ....................................42 Interfaces, Ports, and Bindings..........................42 Interfaces ................................42 Ports and circuits ............................42 Bindings ................................42 Profiles and Use commands...........................43 Profiles ................................43 Use Commands ..............................43...
Page 40: Configuration Concepts
SmartWare Software Configuration Guide 2 • Configuration concepts Introduction This chapter introduces basic SmartWare conﬁguration concepts. A good understanding of these concepts is vital for the conﬁguration tasks explained in the remaining chapters of this guide. Patton strongly recommends that you read through this chapter because it introduces the fundamental ideas behind the structure of the command line interface.
Page 41: Contexts And Gateways
SmartWare Software Configuration Guide 2 • Configuration concepts lines) commands. For example, you need bind commands to bind a physical port to a logical interface, and use commands to assign proﬁles to contexts. The sections that follow refer to ﬁgure 5 on page 40 and describe the concepts and elements in more detail.
Page 42: Interfaces, Ports, And Bindings
SmartWare Software Configuration Guide 2 • Configuration concepts Interfaces, Ports, and Bindings Interfaces The concept of an interface in SmartWare differs from that in traditional networking devices. Traditionally, the term interface is often synonymous with port or circuit, which are physical entities. In SmartWare however, an interface is a logical construct that provides higher-layer protocol and service information, such as layer 3 addressing.
Page 43: Profiles And Use Commands
SmartWare Software Configuration Guide 2 • Configuration concepts Proﬁles and Use commands Proﬁles Proﬁles provide conﬁguration shortcuts. They contain speciﬁc settings that can be used in multiple contexts, interfaces, or gateways. This concept allows to avoid repetitions of groups of conﬁguration commands that are the same for multiple elements in a conﬁguration.
Page 44: Command Line Interface (Cli)
Chapter 3 Command line interface (CLI) Chapter contents Introduction ................................45 Command modes ..............................45 CLI prompt ..............................45 Navigating the CLI ............................46 Initial mode ..............................46 System changes ............................46 Configuration ............................46 Changing Modes ............................46 Command editing ..............................46 Command help ...............................46 The No form ..............................46 Command completion ............................46...
Page 45: Introduction
SmartWare Software Configuration Guide 3 • Command line interface (CLI) Introduction The primary user interface to SmartWare is the command line interface (CLI). You can access the CLI via the SmartNode console port or through a Telnet session. The CLI lets you conﬁgure the complete SmartWare functionality.
Page 46: Navigating The Cli
SmartWare Software Configuration Guide 3 • Command line interface (CLI) Navigating the CLI Initial mode When you initiate a session, you can log in with operator or administrator privileges. Whichever login you use, the CLI is always set to operator exec (non-privileged exec) mode by default upon startup. This mode allows you to examine the state of the system using a subset of the available CLI commands.
Page 47: Command History
SmartWare Software Configuration Guide 3 • Command line interface (CLI) CLI to complete the command at the prompt. If the number of characters is not sufﬁcient to uniquely identify the command, the CLI will provide a list with all commands starting with the typed characters. For example, if you enter the string co in the conﬁgure mode and press <tab>, the selections , and conﬁgure...
Page 48: Accessing The Cli
Chapter 4 Accessing the CLI Chapter contents Introduction ................................49 Accessing the SmartWare CLI task list........................49 Accessing via the console port .........................50 Console port procedure ..........................50 Telnet Procedure ............................51 Using an alternate TCP listening port for the Telnet server ................51 Disabling the Telnet server ..........................51 Logging on ..............................51...
Page 49: Introduction
SmartWare Software Configuration Guide 4 • Accessing the CLI Introduction SmartNode products are designed for remote management and volume deployment. The management and conﬁguration of SmartNodes is therefore based on IP network connectivity. Once a SmartNode is connected to, and addressable in, an IP network, you can remotely perform all conﬁguration, management, and mainte- nance tasks.
Page 50: Accessing Via The Console Port
SmartWare Software Configuration Guide 4 • Accessing the CLI • Ending a Telnet or console port session (see page Accessing via the console port If a console port is available, the host computer can be connected directly to it with a serial cable (see ﬁgure The host must use a terminal emulation application that supports serial interface communication.
Page 51: Telnet Procedure
SmartWare Software Configuration Guide 4 • Accessing the CLI Accessing via a Telnet session This is the most commonly used and recommended method for connecting to a SmartNode. It is way faster than console access.The Telnet host accesses the SmartNode via its network interface. Note If the IP conﬁguration of the Ethernet port (LAN port) is not known or is incorrectly conﬁgured, you will have to use the console interface.
Page 52: Selecting A Secure Password
SmartWare Software Configuration Guide 4 • Accessing the CLI Figure 7. Login display Upon logging in you are in operator execution mode, indicated by the “>” as command line prompt. Now you can enter system commands. Note Details on screen in ﬁgure 7, such as the IP address in the system prompt and window header bar, may be different on your unit.
Page 53: Password Encryption
SmartWare Software Configuration Guide 4 • Accessing the CLI Password encryption Unencrypted passwords can be stolen by hackers using protocol analyzers to scan packets or by examining the conﬁguration ﬁle—to protect against that type of theft, SmartWare encrypts passwords by default. Encryption prevents the password from being readable in the conﬁguration ﬁle.
Page 54: Creating An Administrator Account
SmartWare Software Configuration Guide 4 • Accessing the CLI node(cfg)#copy running-config startup-config Creating an administrator account Administrators can run the command and access additional information within the SmartWare conﬁg- enable uration modes. Therefore administrators can modify the system conﬁguration, as well as view all relevant sys- tem information.
Page 55: Switching To Another Account
SmartWare Software Configuration Guide 4 • Accessing the CLI Mode: Administrator execution Step Command Purpose Displays the currently-conﬁgured administrator and operator node# show accounts accounts Example: Display account information The following example shows how to display information about existing administrator and operator accounts. node#show accounts administrator accounts: super...
Page 56: Command Index Numbers
SmartWare Software Configuration Guide 4 • Accessing the CLI Mode: Administrator or operator execution Step Command Purpose node# who Shows more detailed information about the users ID, name, state, idle time and location node> who Shows the user login identity Example: Checking identity and connected users The following example shows how to report who is logged in or more detailed information about users and process states, depending on the execution mode in which you are working.
Page 57 SmartWare Software Configuration Guide 4 • Accessing the CLI of the list. Also, you can change a commands position in a listing (moving it up or down in the list) by chang- ing its index number. Example 1: Moving the G.723 codec from position 3 in the list to position 1 at the top of the list. Listing before changing the G.723 codec index number: profile voip default codec 1 g711ulaw64k rx-length 20 tx-length 20...
Page 58: Ending A Telnet Or Console Port Session
SmartWare Software Configuration Guide 4 • Accessing the CLI Ending a Telnet or console port session Use the command in the operator or administration execution mode to end a Telnet or console port ses- logout sion. To conﬁrm the command, you must enter yes on the dialog line as shown in the example below. logout Mode: Operator execution Step...
Page 59: System Image Handling
Chapter 5 System image handling Chapter contents Introduction ................................60 Memory regions in SmartWare..........................61 System image handling task list ..........................62 Displaying system image information ......................63 Copying system images from a network server to Flash memory ..............63 Upgrading the software directly ........................65 Auto provisioning of firmware and configuration ....................66 Boot...
Page 60: Introduction
SmartWare Software Configuration Guide 5 • System image handling Introduction This chapter describes how to load, maintain, and update the various software images in the SmartNode. The SmartWare system software consists of the application image and the driver images. The images are stored in persistent (non-volatile) memory.
Page 61: Memory Regions In Smartware
SmartWare Software Configuration Guide 5 • System image handling Memory regions in SmartWare The SmartNode’s memory contains several logical regions and several physical regions as shown in ﬁgure 8 page 62, each separate from the other. Note You will use a remote TFTP server for uploading and downloading the application image, the driver images, and the various conﬁguration ﬁles to the SmartNode.
Page 62: Configuration File
SmartWare Software Configuration Guide 5 • System image handling Operating conﬁgurations cannot be executed from the persistent memory, so the conﬁguration used for oper- ating the SmartNode is copied into the volatile memory of the SmartNode prior to normal operation. This procedure takes place after the system bootstrap, where the application image (i.e.
Page 63: Displaying System Image Information
SmartWare Software Configuration Guide 5 • System image handling Displaying system image information This procedure displays information about system images and driver software Mode: Administrator execution Step Command Purpose Lists the system software release version, information about optional interface show version cards mounted in slots and other information that is the currently running system software.
Page 64 SmartWare Software Configuration Guide 5 • System image handling Comment lines must have a hash character # in column one and can appear anywhere in the script ﬁle. Com- ment lines contain information for administrators or operators who maintain or use the script ﬁle. The following example shows a script ﬁle used to download a system image and command line syntax deﬁni- tion ﬁle from a TFTP server.
Page 65: Upgrading The Software Directly
SmartWare Software Configuration Guide 5 • System image handling After the successful download, either issue the reload command (in order to start the IPNode with the new software) or restart the H.323 gateway, thus enabling calls again (with the current software): node(gw-h323)[h323]#no shutdown Upgrading the software directly It is possible to upgrade the software directly by passing the name of the delivered zip-ﬁle to the CLI command...
Page 66: Auto Provisioning Of Firmware And Configuration
SmartWare Software Configuration Guide 5 • System image handling Auto provisioning of ﬁrmware and conﬁguration The new auto provisioning capability enables you to automatically distribute up-to-date conﬁgurations and ﬁrmware to a large number of units using TFTP. It works as follows: The unit downloads a speciﬁc ﬁle from a TFTP server.
Page 67 SmartWare Software Configuration Guide 5 • System image handling Step Command Purpose Speciﬁes the location of the ﬁle to check [name] (pf-prov)[CONFIG]#location 1 for changes. $(system.mac) is a place- tftp://tftp1.provider.net /conﬁgs/ holder for the unit’s MAC address of $(system.mac).cfg ETH 0/0. Using host names instead of IP addresses works only if DNS resolver is enabled and conﬁgured.
Page 68: Boot Procedure
SmartWare Software Configuration Guide 5 • System image handling Boot procedure During a normal boot procedure of a SmartNode, the bootstrap application checks for an application image in the persistent memory of the logical region nvram:. The application image is then executed, i.e. the SmartWare is started module by module.
Page 69: Factory Configuration
SmartWare Software Configuration Guide 5 • System image handling The bootloader ensures that basic operations, network access, and downloads are possible in case of interrupted or corrupted application image downloads. After downloading an application image (that is, new system software/software upgrade), the bootloader ensures that basic operations, network access, and downloads are possible in case of interrupted or corrupted application image downloads.
Page 70: Configuration File Handling
Chapter 6 Conﬁguration ﬁle handling Chapter contents Introduction ................................71 Understanding configuration files ........................71 Factory configuration ............................73 Configuration file handling task list........................73 Copying configurations within the local memory ....................74 Replacing the startup configuration with a configuration from Flash memory ..........75 Copying configurations to and from a remote storage location ................76 Replacing the startup configuration with a configuration downloaded from TFTP server .......77...
Page 71: Introduction
SmartWare Software Configuration Guide 6 • Configuration file handling Introduction This chapter describes how to upload and download conﬁguration ﬁles from and to SmartWare. A conﬁgura- tion ﬁle is a batch ﬁle of SmartWare commands used in the software modules that perform speciﬁc functions of the SmartNode.
Page 72 SmartWare Software Configuration Guide 6 • Configuration file handling Figure 10, shows the characteristics of a conﬁguration ﬁle. It is stored on a TFTP server in the ﬁle myconﬁg.cfg for later download. The command syntax used to enter commands with the CLI and add commands in conﬁg- uration ﬁles is identical.
Page 73: Factory Configuration
SmartWare Software Configuration Guide 6 • Configuration file handling bind gateway h323 # H.323 gateway primarily used gateway h323 faststart no ras gatekeeper-discovery auto bind interface lan router no shutdown port ethernet 0 0 medium auto encapsulation ip bind interface lan router no shutdown port ethernet 0 1 medium 10 half...
Page 74: Copying Configurations Within The Local Memory
SmartWare Software Configuration Guide 6 • Configuration file handling • Copying conﬁgurations within the local memory (see page • Replacing the startup conﬁguration with a conﬁguration from the Flash memory (see page • Copying conﬁgurations to and from a remote storing location (see page •...
Page 75: Replacing The Startup Configuration With A Configuration From Flash Memory
SmartWare Software Configuration Guide 6 • Configuration file handling You can copy the current running conﬁguration into the persistent memory region nvram: under a user-speci- ﬁed name, if you want to preserve that conﬁguration. In addition, an already existing conﬁguration is usually copied into the persistent memory region nvram: by using a user-speciﬁed name, for conservation or later activation.
Page 76: Copying Configurations To And From A Remote Storage Location
SmartWare Software Configuration Guide 6 • Configuration file handling Copying conﬁgurations to and from a remote storage location Conﬁguration ﬁles can be copied from local memory (persistent or volatile region) to a remote data store. From within SmartWare, the remote TFTP server is represented by the memory region tftp: in combination with the IP address of the TFTP server and the name and path of the conﬁguration ﬁle.
Page 77: Replacing The Startup Configuration With A Configuration Downloaded From Tftp Server
SmartWare Software Configuration Guide 6 • Configuration file handling Replacing the startup conﬁguration with a conﬁguration downloaded from TFTP server From within the administration execution mode, you can replace the startup-conﬁguration by downloading a conﬁguration from the TFTP server into the ﬂash memory area where to store the startup conﬁguration. Mode: Administrator execution Step Command...
Page 78: Modifying The Running Configuration At The Cli
SmartWare Software Configuration Guide 6 • Configuration file handling It is recommended that you never save a conﬁguration in startup- conﬁg or a user-speciﬁc conﬁguration with the cli conﬁg defaults command because the additional list of default commands con- IMPORTANT sumes signiﬁcant portions of the nvram: memory.
Page 79: Modifying The Running Configuration Offline
SmartWare Software Configuration Guide 6 • Configuration file handling Example: Modifying the running conﬁguration at the CLI The following example shows how to modify the currently running conﬁguration via the CLI and save it as the startup conﬁguration. node#configure node(cfg)#… node(cfg)#copy running-config startup-config node(cfg)#reload Press 'yes' to restart, 'no' to cancel : yes...
Page 80: Deleting A Specified Configuration
SmartWare Software Configuration Guide 6 • Configuration file handling Example: Modifying the running conﬁguration ofﬂine The following example shows how to upload the running conﬁguration from the SmartNode to the ﬁle cur- rent-conﬁg on a TFTP server at IP address 172.16.36.80. The uploaded conﬁguration ﬁle is written into the root directory speciﬁed by the TFTP server settings, and overwrites any existing ﬁle with the same name.
Page 81: Encrypted File Download
SmartWare Software Configuration Guide 6 • Configuration file handling startup-config factory-config Encrypted ﬁle download This section explains how conﬁguration ﬁles can be transported encrypted over IP. TFTP as a conﬁguration download mechanism has the advantage of being extremely simple (trivial) and appli- cable in any network without any requirements for specialized management servers or applications.
Page 82: Use Cases
SmartWare Software Configuration Guide 6 • Configuration file handling enctool decrypt <enc-config-file> <plain-config-file> [<key>] A log ﬁle lists the last up/downloads: show log file-transfer Use Cases Install a custom encryption key (optional) You can install a custom encryption key with the SmartNode. The encryption key is used to automatically decrypt an encrypted conﬁguration ﬁle that is downloaded later.
Page 83 SmartWare Software Configuration Guide 6 • Configuration file handling 123100000020002abc000cf187d909XYZ Then you have to download the created key ﬁle to the SmartNode. Open a telnet session and type in the fol- lowing commands: >enable #copy tftp://<ip>/<path> key: where <ip> is the IP address of your TFTP server and <path> is the path to the key ﬁle relative to the TFTP root.
Page 84: Basic System Management
Chapter 7 Basic system management Chapter contents Introduction ................................85 Basic system management configuration task list ....................85 Managing feature license keys .........................86 Setting system information ..........................87 Setting the system banner ..........................88 Setting time and date ............................89 Display clock information ..........................89 Display time since last restart ..........................90 Configuring the Web server ..........................90...
Page 85: Introduction
SmartWare Software Configuration Guide 7 • Basic system management Introduction This chapter describes parameters that report basic system information to the operator or administrator, and their conﬁguration. The following are basic parameters that can be established when setting up a new system: •...
Page 86: Managing Feature License Keys
SmartWare Software Configuration Guide 7 • Basic system management Managing feature license keys Several features of the ﬁrmware require a system speciﬁc license key to be installed to enable the feature. This section describes how to install the feature license keys on your equipment. Because license keys comprise very long strings of characters, the standard way of installing them is to download the ﬁle containing the license keys from a TFTP server to the equipment.
Page 87: Setting System Information
SmartWare Software Configuration Guide 7 • Basic system management node(cfg)#show licenses VPN [vpn] License serial number: 14343534 Status: Active node(cfg)# Setting system information The system information includes the following parameters: • Contact • Hostname • Location • Provider • Subscriber •...
Page 88: Setting The System Banner
SmartWare Software Configuration Guide 7 • Basic system management Mode: Conﬁgure Step Command Purpose node (cfg)#system contact information Sets the contact information to information node (cfg)#system hostname information Sets the hostname to information node (cfg)#system location information Sets the location information to information node (cfg)#system provider information Sets the provider information to information node (cfg)#system subscriber information...
Page 89: Setting Time And Date
SmartWare Software Configuration Guide 7 • Basic system management Example: Setting the system banner The following example shows how to set a message for the system banner for your device, if you start from the conﬁguration mode. node(cfg)#banner \n#\n# The password of all operators has changed\n# please contact the administrator\n#"...
Page 90: Display Time Since Last Restart
SmartWare Software Configuration Guide 7 • Basic system management Display time since last restart This procedure describes how to display the time since last restart Mode: Operator execution Step Command Purpose Display the time since last restart. node >show uptime Example: The following example shows how to display the uptime of your device, if you start from the conﬁguration mode.
Page 91: Restarting The System
SmartWare Software Configuration Guide 7 • Basic system management Example: Deﬁning the desired CLI version The following example shows how to determine the running CLI version and deﬁne CLI version 2.10 for your device, if you start from the conﬁguration mode. node(cfg)#show version cli CLI version : 3.00 node(cfg)#cli version 2.10...
Page 92: Controlling Command Execution
SmartWare Software Configuration Guide 7 • Basic system management System resets may have a number of reasons, the most prominent being a manual reset issued on the Telnet/ console (‘reload’). Other reset reasons include power off failures and system failures. In order to pinpoint the problem, the reset log contains the reset cause.
Page 93: Timed Execution Of Cli Command
SmartWare Software Configuration Guide 7 • Basic system management % Suspended System prompt reappears and is ready to execute further commands node>show ip interface ------------------------------------------------------------ Context: router … Show the currently running commands node>jobs * [run ] jobs 0 [bg ] ping Bring job 0 to foreground node>fg...
Page 94: Configuration Of Terminal Sessions
SmartWare Software Configuration Guide 7 • Basic system management Mode: Administrator execution Step Command Purpose node #show crc filename Displays checksum of a conﬁguration Example: checksum of a conﬁguration Displaying the The following example shows how to display the checksum of the conﬁguration test of your device, if you start from the conﬁguration mode.
Page 95: Radius Client Configuration
Chapter 8 RADIUS Client Conﬁguration Chapter contents Introduction ................................96 The AAA component ............................96 General AAA Configuration ..........................97 RADIUS configuration............................99 Configuring RADIUS clients ........................100 Configuring RADIUS accounting .........................101 Configuring the RADIUS server ........................103 Attributes in the RADIUS request message .....................103 Attributes in the RADIUS accept message ....................104 Configuring the local database accounts ......................104...
Page 96: Introduction
SmartWare Software Configuration Guide 8 • RADIUS Client Configuration Introduction This chapter provides an overview of the authentication, authorization, and accounting (AAA) component and describes how to conﬁgure the RADIUS client, a subpart of the AAA component. It is important to under- stand how AAA works before conﬁguring the RADIUS client.
Page 97: General Aaa Configuration
SmartWare Software Configuration Guide 8 • RADIUS Client Configuration Figure 14 illustrates the authentication procedure for a user logging into a SmartNode that is conﬁgured to use RADIUS as authentication method. AAA Server (RADIUS) 3. Authentication accepted 4. Access granted 2.
Page 98 SmartWare Software Configuration Guide 8 • RADIUS Client Configuration 3. Query the local database (see “Conﬁguring the local database accounts” on page 104 for information on how to conﬁgure the local database) If, e.g. radius_deepblue is not available, radius_extern will be queried after a timeout. But if radius_deepblue gives an answer that rejects the login request, the remaining methods are not used and the login is denied.
Page 99: Radius Configuration
SmartWare Software Configuration Guide 8 • RADIUS Client Configuration node(pf-auth)[remote-~]#exit node(cfg)# node(cfg)#profile authentication local-only node(pf-auth)[local-o~]#method local node(pf-auth)[local-o~]#method none node(pf-auth)[local-o~]#exit node(cfg)#terminal Telnet use authentication remote-radius node(cfg)#terminal console use authentication local-only node(cfg)#show profile authentication Authentication Profile: default Server-Timeout: 10 Methods: local (Type=local) none (Type=none) Authentication Profile: remote-radius Server-Timeout: 15...
Page 100: Configuring Radius Clients
SmartWare Software Configuration Guide 8 • RADIUS Client Configuration Transactions between the RADIUS client and server are authenticated through the use of a shared secret, which is never sent over the network—the same secret must thus be known to the server and the client by conﬁguration. Using this secret as an encryption key, user passwords are sent encrypted between the client and RADIUS server.
Page 101: Configuring Radius Accounting
SmartWare Software Configuration Guide 8 • RADIUS Client Configuration node(cfg)# Conﬁguring RADIUS accounting The RADIUS accounting functionality can be added to a call-router conﬁguration by inserting an AAA call- control service between two call-router elements. Any call that is then routed through the AAA service will cause call detail records (CDRs) to be sent to the radius server.
Page 102 SmartWare Software Configuration Guide 8 • RADIUS Client Configuration The following procedure guides you through the steps necessary to enable RADIUS accounting in an existing conﬁguration: Mode: Conﬁgure Step Command Purpose Create a new RADIUS client node (cfg)# radius-client <client-name> Deﬁne the RADIUS server to be used.
Page 103: Configuring The Radius Server
SmartWare Software Configuration Guide 8 • RADIUS Client Configuration Step Command Purpose Deﬁne, if accounting shall be started at call-setup or call-con- node (svc-aaa)[svc-name]# (Optional) nect time. The default is at call-connect time. accounting-start-trigger [setup | connect] If setup is speciﬁed, an interim update will be Note sent at call-connect time.
Page 104: Attributes In The Radius Accept Message
SmartWare Software Configuration Guide 8 • RADIUS Client Configuration Attributes in the RADIUS accept message After the user and his credentials are approved by the authentication procedure on the RADIUS server, the SmartNode expects a RADIUS accept message with the following attributes: Attribute Attribute Type Description...
Page 105 SmartWare Software Configuration Guide 8 • RADIUS Client Configuration servers are down or the network is not reachable, you can create an emergency user in the local database so that you can still access the SmartNode. Perform the following steps to conﬁgure the local accounts. Mode: Conﬁgure Step Command...
Page 106: Ip Context Overview
Chapter 9 IP context overview Chapter contents Introduction ................................107 IP context overview configuration task list......................108 Planning your IP configuration ...........................109 IP interface related information ........................109 QoS related information ..........................109 Configuring physical ports...........................109 Creating and configuring IP interfaces.........................109 Configuring NAPT .............................110 Configuring static IP routing..........................110 Configuring...
Page 107: Introduction
SmartWare Software Configuration Guide 9 • IP context overview Introduction This chapter outlines the SmartWare Internet protocol (IP) context and its related components. You will get the fundamental understanding on how to set up your SmartNode to make use of IP related services. The following sections describe the conﬁguration steps necessary to put together certain IP services and the ref- erences to the related chapters that explain the issue in more details.
Page 108: Ip Context Overview Configuration Task List
SmartWare Software Configuration Guide 9 • IP context overview The IP context undertakes the task of doing all IP-related transport of data and voice packets via the logical inter- faces and available gateways. In addition, using proﬁles—which together with the IP context pinpoint how to handle packets for speciﬁc services—enhances the possible ﬁeld of application.
Page 109: Planning Your Ip Configuration
SmartWare Software Configuration Guide 9 • IP context overview Planning your IP conﬁguration The following subsections provide network connection considerations for several types of physical ports types. Patton recommends that you draw a network overview diagram displaying all neighboring IP nodes and serial connected elements.
Page 110: Configuring Napt
SmartWare Software Configuration Guide 9 • IP context overview Conﬁguring NAPT Network address port translation (NAPT), which is an extension to NAT, uses TCP/UDP ports in addition to network addresses (IP addresses) to map multiple private network addresses to a single outside address. NAPT enables small ofﬁces to save money by requiring only one ofﬁcial outside IP address to connect several hosts via a SmartNode to the access network.
Page 111: Configuring Access Control Lists
SmartWare Software Configuration Guide 9 • IP context overview Conﬁguring access control lists Packet ﬁltering helps to control packet movement through the network. Such control can help to limit net- work trafﬁc and to restrict network use by certain users or devices. An access control list is a sequential collection of permit and deny conditions that apply to packets on a certain interface.
Page 112: Ip Interface Configuration
Chapter 10 IP interface conﬁguration Chapter contents Introduction ................................113 IP interface configuration task list........................113 Creating an IP interface ..........................113 Deleting an IP interface ..........................114 Setting the IP address and netmask .......................115 Configuring a NAPT DMZ interface ......................115 ICMP message processing ..........................116 ICMP redirect messages ..........................116...
Page 113: Introduction
SmartWare Software Configuration Guide 10 • IP interface configuration Introduction This chapter provides a general overview of IP interfaces and describes the tasks involved in their conﬁgura- tion. An interface is a logical entity that provides higher-layer protocol and service information, such as Layer 3 addressing.
Page 114: Deleting An Ip Interface
SmartWare Software Configuration Guide 10 • IP interface configuration Example: Create IP interfaces The procedure illustrated below assumes that you would like to create an IP interface named lan Use the fol- lowing commands in administrator conﬁguration mode. node>enable node#configure node(cfg)#context ip router node(ctx-ip)[router]#interface lan node(if-ip)[lan]#...
Page 115: Setting The Ip Address And Netmask
SmartWare Software Configuration Guide 10 • IP interface configuration Setting the IP address and netmask Each IP interface needs its explicit IP address and an appropriate net mask to be set. You can use the interface conﬁguration command to perform the following tasks: ipaddress •...
Page 116: Icmp Message Processing
SmartWare Software Configuration Guide 10 • IP interface configuration ICMP message processing The IP suite offers a number of services that control and manage IP connections. The Internet Control Mes- sage Protocol (ICMP) provides many of these services. Routers send ICMP messages to hosts or other routers when a problem is discovered with the Internet header.
Page 117: Defining The Mtu And Mss Of The Interface
SmartWare Software Configuration Guide 10 • IP interface configuration Mode: Interface Step Command Purpose node (ctx-ip)[router]#interface name Selects the interface name for ICMP message pro- cessing conﬁguration node (if-ip)[ name ]# icmp router-discovery Enables to send router advertisement broadcast messages Example: Router advertisement broadcast message The following example shows how to enable sending router advertisement broadcast messages on IP interface lan.
Page 118: Configuring An Interface As A Point-To-Point Link
SmartWare Software Configuration Guide 10 • IP interface configuration The following example shows how to deﬁne the MTU of the IP interface lan to 1000 and to adjust the MSS in both directions to MTU-40. Use the following commands in IP context conﬁguration mode. node(ctx-ip)[router]#interface lan node(if-ip)[lan]#mtu 1000 node(if-ip)[lan]#tcp adjust-mss rx mtu...
Page 119: Displaying Dynamic Arp Entries
SmartWare Software Configuration Guide 10 • IP interface configuration ------------------------------------------------------------ Context: router Name: IP Address: 172.17.100.210 255.255.255.0 MTU: 1500 ICMP router-discovery: enabled ICMP redirect: send only State: CLOSED Binding: ethernet 0 0 1/ethernet/ip … Displaying dynamic ARP entries The following command can be used to display the dynamically learned ARP entries on an IP interface or on the entire system.
Page 120: Debug Arp
SmartWare Software Configuration Guide 10 • IP interface configuration • [trafﬁc-class <trafﬁc-class>] which indicates the IP packets in a trafﬁc class are routed via the deﬁned Nexthop in the routing table entry for that trafﬁc-class. Default: local-default. When using for fault isolation, you should ﬁrst run it on the respective IP interface to verify that the local ping LAN or WAN interface is up and running.
Page 121: Configuring The Igmp Proxy
SmartWare Software Configuration Guide 10 • IP interface configuration Example: Debug ARP output node(cfg)#debug arp node(cfg)#ping 10.9.10.11 Sending 5, 56 bytes, ICMP echo requests to 10.9.10.11: 17:25:40 > Entry 10.9.10.11: Sending first request 17:25:40 > Tx ARP Request: Who has 10.9.10.11 tell 10.9.10.1 at 00:A0:BA:00:92:4F 17:25:40 >...
Page 122 SmartWare Software Configuration Guide 10 • IP interface configuration Mode: Context IP Step Command Purpose Go to the IP interface, which shall act as the IGMP proxy node (ctx-ip)[ctx- name ]# upstream interface interface <if-name> Deﬁne the interface as the IGMP proxy upstream interface node(if-ip)[if- name ]# igmp interface-type proxy- upstream...
Page 123: Nat/Napt Configuration
Chapter 11 NAT/NAPT conﬁguration Chapter contents Introduction ................................124 Dynamic NAPT ............................124 Static NAPT ..............................125 Dynamic NAT ..............................125 Static NAT ..............................126 NAPT traversal .............................126 NAT/NAPT configuration task list ........................127 Creating a NAPT profile ..........................127 Configuring a NAPT DMZ host ......................128 Defining NAPT port ranges ........................128 Preserving TCP/UDP port numbers in NAPT ..................129...
Page 124: Introduction
SmartWare Software Configuration Guide 11 • NAT/NAPT configuration Introduction This chapter provides a general overview of Network Address (Port) Translation and describes the tasks involved in its conﬁguration. For further information about the functionality of Network Address Translation (NAT) and Network Address Port Translation (NAPT), consult the RFCs 1631 and 3022.
Page 125: Static Napt
SmartWare Software Configuration Guide 11 • NAT/NAPT configuration Global Network Local Network (Local Interface Address) 192.168.1.1 131.1.1.1 (Global Interface Address) 131.1.1.10 - 131.1.1.15 (Global NAT Address Pool) Source Address modified 131.1.1.10 - 131.1.1.15 192.168.1.30 - 192.168.1.39 Destination Address modified Figure 17. Dynamic NAPT Static NAPT Dynamic NAPT does not permit hosts on the global network to access hosts on the local network.
Page 126: Static Nat
SmartWare Software Configuration Guide 11 • NAT/NAPT configuration Dynamic NAT is particularly useful for protocols that do not build on UDP or TCP but directly on IP (e.g. GRE, ESP). See also section “NAPT traversal” on page 126. (Local Interface Address) 192.168.1.1 131.1.1.1 (Global Interface Address) 131.1.1.20 (Global NAT Address) Source Address modified...
Page 127: Nat/Napt Configuration Task List
SmartWare Software Configuration Guide 11 • NAT/NAPT configuration it should create and which IP addresses/ports it must modify (e.g. for voice connections in addition to signal- ing connections). It performs this task for the protocol FTP. Other protocols such as H.323 and SIP cannot traverse the SmartWare NAPT.
Page 128: Configuring A Napt Dmz Host
SmartWare Software Configuration Guide 11 • NAT/NAPT configuration Step Command Purpose node (pf-napt)[ name ]#static local- Creates a Static NAT entry: local-ip is mapped to ip global-ip global-ip . (optional) (max. 20 entries) node (pf-napt)[ name ]#static Creates a static NAT entry: trafﬁc of the IP protocol { ah|esp|gre|ipv6 } local_ip AH, ESP, GRE, or IPv6 respectively directed to the (optional)
Page 129: Preserving Tcp/Udp Port Numbers In Napt
SmartWare Software Configuration Guide 11 • NAT/NAPT configuration Mode: proﬁle napt <pf-name> Step Command Purpose [ name ] (pf-napt)[pf-name]# tcp- Deﬁne the TCP port range port-range <range-start-tcp- port> <range-end-tcp-port> [ name ] (pf-napt)[pf-name]# udp- Deﬁne the UDP port range port-range <range-start-udp- port>...
Page 130: Activate Nat/Napt
SmartWare Software Configuration Guide 11 • NAT/NAPT configuration Activate NAT/NAPT To activate a NAT/NAPT component, bind its NAPT proﬁle to an IP interface. This binding identiﬁes the global interface of the respective NAT/NAPT component. All other IP interfaces are local relative to this NAT/ NAPT.
Page 131: Configuring Nat Static Protocol Entries
SmartWare Software Configuration Guide 11 • NAT/NAPT configuration Example: Display NAT/NAPT conﬁguration information node(pf-napt)[access]#show profile napt access NAPT profile access: -------------------------- STATIC NAPT MAPPINGS Protocol Local IP Local Port Global IP Global Port -------- --------------- ----------- --------------- ----------- 192.168.1.20 0.0.0.0 192.168.1.20 131.1.1.3 STATIC NAT PROTOCOL MAPPINGS...
Page 132: Ethernet Port Configuration
Chapter 12 Ethernet port conﬁguration Chapter contents Introduction ................................133 Ethernet port configuration task list ........................133 Entering the Ethernet port configuration mode ....................133 Configuring medium for an Ethernet port ....................133 Configuring Ethernet encapsulation type for an Ethernet port ..............134 Binding an Ethernet port to an IP interface ....................134 Multiple IP addresses on Ethernet ports ......................135...
Page 133: Introduction
SmartWare Software Configuration Guide 12 • Ethernet port configuration Introduction This chapter provides an overview of Ethernet ports and describes the tasks involved in conﬁguring Ethernet ports through the SmartWare. Ethernet port conﬁguration task list To conﬁgure Ethernet ports, perform the tasks described in the following sections. Most of the task are required to have an operable Ethernet port, some of the tasks are optional, but might be required for your application.
Page 134: Configuring Ethernet Encapsulation Type For An Ethernet Port
SmartWare Software Configuration Guide 12 • Ethernet port configuration Example: Conﬁguring medium for an Ethernet port The following example shows how to conﬁgure medium auto-sense for the Ethernet port on slot 0 and port 0 of a SmartNode 4524 device. node(cfg)#port ethernet 0 0 node(prt-eth)[0/0]#medium auto Conﬁguring Ethernet encapsulation type for an Ethernet port...
Page 135: Multiple Ip Addresses On Ethernet Ports
SmartWare Software Configuration Guide 12 • Ethernet port configuration Figure 21 shows the logical binding of the Ethernet port at slot 0 on port 0 to the IP interface lan which is deﬁned in the IP context router. Context “router” interface lan interface wan bind command...
Page 136: Configuring A Vlan
SmartWare Software Configuration Guide 12 • Ethernet port configuration Mode: Conﬁgure Step Command Purpose [ name ] (cfg)# context ip Enter the IP context conﬁguration mode. [ name ] (ctx-ip)[router]# interface <ip-if-1-name> Create the ﬁrst IP interface. [name] (if-ip)[ <ip-if-1-name>]# ipaddress <ip- Set the IP address for the ﬁrst IP inter- address-1>...
Page 137: Configuring Layer 2 Cos To Service-Class Mapping For An Ethernet Port
SmartWare Software Configuration Guide 12 • Ethernet port configuration Mode: Conﬁgure Step Command Purpose node (conﬁg)#port ethernet slot port Enter Ethernet port conﬁgura- tion. node (prt-eth)[ slot/port ]#vlan id Create new VLAN port. node (vlan)[ id ]#encapsulation {ip|pppoe|multi} Deﬁnes the payload type(s) to be used on this VLAN: •...
Page 138: Adding A Receive Mapping Table Entry
SmartWare Software Configuration Guide 12 • Ethernet port configuration Mode: Conﬁgure Step Command Purpose node (cfg)#port ethernet slot port Enters Ethernet port conﬁgura- tion mode for the interface on slot and port node (prt-eth)[ slot/port ]#map cos layer 2 class of service value Selects the layer 2 CoS to trafﬁc- to trafﬁc class name class mapping.
Page 139: Adding A Transmit Mapping Table Entry
SmartWare Software Configuration Guide 12 • Ethernet port configuration Adding a transmit mapping table entry The transmit mapping table deﬁnes the conversion of transmitting ﬁrmware-speciﬁc service class value into a Layer 2 CoS to service class value. Each conversion is stored as a mapping table entry, so the transmitting map- ping table consists of several mapping table entries.
Page 140: Using The Built-In Ethernet Sniffer
SmartWare Software Configuration Guide 12 • Ethernet port configuration Example: Disabling an Ethernet port The following example shows how to disable the Ethernet port on slot 0 and port 0. node(cfg)#port ethernet 0 0 node(prt-eth)[0/0]#shutdown Checking the state of the Ethernet port on slot 0 and port 0 shows that the interface was closed. node(prt-eth)[0/1]#show port ethernet 0 1 Ethernet Configuration -------------------------------------...
Page 141 SmartWare Software Configuration Guide 12 • Ethernet port configuration The following is an example of how the sniffer is normally used: Step Command Purpose [ name ] (cfg)# sniff ethernet Enable the sniffer on ethernet port 0 1. (Normally the sniffer stops capturing, if the capture buffer is full.
Page 142: Link Scheduler Configuration
Chapter 13 Link scheduler conﬁguration Chapter contents Introduction ................................143 Applying scheduling at the bottleneck ......................143 Using traffic classes ............................143 Introduction to Scheduling ...........................144 Priority ..............................144 Weighted fair queuing (WFQ) ........................144 Shaping ..............................144 Burst tolerant shaping or wfq ........................145 Hierarchy ..............................145 Quick references ..............................146 Setting the modem rate...
Page 143: Introduction
SmartWare Software Configuration Guide 13 • Link scheduler configuration Introduction This chapter describes how to use and conﬁgure the Quality of Service (QoS) features. Refer to chapter 19, “Access control list conﬁguration” on page 212 more information on the use of access control lists. This chapter includes the following sections: •...
Page 144: Introduction To Scheduling
SmartWare Software Configuration Guide 13 • Link scheduler configuration Local applications (CLI, Web Server) Routing IPSec encryption/ decryption Access control list (ACL) Network address translation (NAT) Voice mux/ Voice demux processing Sequence of processing stages Link Scheduler passed by a routed packet To/from network port (Ethernet, PPPoE, Frame relay, etc.) Figure 22.
Page 145: Burst Tolerant Shaping Or Wfq
SmartWare Software Configuration Guide 13 • Link scheduler configuration service that is only available for a limited bandwidth e.g. low delay. When connecting the SmartNode to a Diff- Serv network shaping might be a required operation. Burst tolerant shaping or wfq For weighted fair queuing and shaping there is a variation of the scheduler that allows to specify if a trafﬁc class may temporarily receive a higher rate as long as the average stays below the limit.
Page 146: Quick References
SmartWare Software Configuration Guide 13 • Link scheduler configuration Mode priority local voice min. 30% min. 40% Level_1 min. 30% Mail Low_Priority Default Mode Shaper Define 2nd level Define 1st level Use arbiter on arbiter arbiter an interface Figure 23. Example of Hierarchical Scheduling Quick references The following sections provide a minimal “standard”...
Page 147: Command Cross Reference
SmartWare Software Configuration Guide 13 • Link scheduler configuration • “rate-limit 512” allows no more than 512 kbit/sec to pass which avoids queueing in the modem. • “header-length 20” speciﬁes how many framing bytes are added by the modem to “pack” the IP packet on the link.
Page 148: Defining The Access Control List Profile
SmartWare Software Configuration Guide 13 • Link scheduler configuration • Enable statistics gathering (see page 159) Profile Packet Classification Predefined Classes Different Types (Classes) of Traffic The service-policy profile defines the arbitration mode and order in which packets of different classes are served.
Page 149: Creating An Access Control List
SmartWare Software Configuration Guide 13 • Link scheduler configuration • local-default—All other packets that originate from the SmartNode itself. • default—All trafﬁc that has not otherwise been labeled. Creating an access control list The procedure to create an access control list is described in detail in chapter 19, “Access control list conﬁgura- tion”...
Page 150: Creating A Service Policy Profile
SmartWare Software Configuration Guide 13 • Link scheduler configuration Mode: Conﬁgure Step Command Purpose node (cfg)#proﬁle acl name Creates a new access control list proﬁle named name node (pf-acl)[ name ]#permit ip host ip-address any trafﬁc-class Creates an IP access con- class-name trol list entry that permits access for host at IP...
Page 151 SmartWare Software Configuration Guide 13 • Link scheduler configuration profile service-policy <profile-name> link rate, arbitration common settings common parameters source traffic-class <x> bandwidth, packet mark settings for class x queue-size, etc. source traffic-class <y> settings for class y source traffic-class default settings for all other traffic-classes not listed Figure 26.
Page 152: Specifying The Handling Of Traffic-Classes
SmartWare Software Configuration Guide 13 • Link scheduler configuration The following lines conﬁgure the source trafﬁc-classes. When using weighted fair queuing (wfq) each user- speciﬁed source trafﬁc-class needs a value specifying its share of the overall bandwidth. For this purpose the share command is used, which deﬁnes the relative weights of the source trafﬁc-classes and policies.
Page 153: Defining The Bit-Rate
SmartWare Software Configuration Guide 13 • Link scheduler configuration Mode: Source Command Purpose node (src)[ name ]#share percentage Deﬁnes fair queuing weight (relative to other sources) to percent- age for the selected class or policy name Deﬁning the bit-rate The command is used with shaper link arbitration to assign the (average) bit-rate to the selected source.
Page 154: Specifying The Precedence Field
SmartWare Software Configuration Guide 13 • Link scheduler configuration The type-of-service (TOS) byte in an IP header speciﬁes precedence (priority) and type of service (RFC791, RFC1349). The precedence ﬁeld is deﬁned by the ﬁrst three bits and supports eight levels of priority. The next four bits—which are set by the command—determine the type-of-service (TOS).
Page 155: Specifying Layer 2 Marking
SmartWare Software Configuration Guide 13 • Link scheduler configuration “trafﬁc-class” number called. With SmartWare you can inspect the DSCP value in the ACL rules and modify the DSCP value with the link scheduler command. set ip dscp Note When conﬁguring service differentiation on the SmartNode, ensure that codepoint settings are arranged with the service provider.
Page 156: Defining Random Early Detection
SmartWare Software Configuration Guide 13 • Link scheduler configuration Deﬁning random early detection The command is used to request random early detection (RED). When a queue carries lots of random-detect TCP transfers that last longer than simple web requests, there is a risk that TCP ﬂow-control might be inefﬁ- cient.
Page 157 SmartWare Software Configuration Guide 13 • Link scheduler configuration Mode: proﬁle service-policy/proﬁle Command Purpose [ name ] (pf-srvp)[<name>]# [no] map packet-size Assigns IP packets of a predeﬁned or speci- ﬁed range to a trafﬁc-class. To name a spe- {routed-voice | routed-voice-encrypted | [<lower-size> <upper-size>] } trafﬁc-class <trafﬁc-class-name>...
Page 158: Devoting The Service Policy Profile To An Interface
SmartWare Software Configuration Guide 13 • Link scheduler configuration Devoting the service policy proﬁle to an interface Any service policy proﬁle needs to be bound to a certain IP interface to get activated. According the terminol- ogy of SmartWare a service policy proﬁle is used on a certain IP interface, as shown in ﬁgure Service Policy...
Page 159: Displaying Link Arbitration Status
SmartWare Software Configuration Guide 13 • Link scheduler configuration node(ctx-ip)[router]#interface wan node(if-ip)[wan]#use profile service-policy Voice_Prio out Displaying link arbitration status command displays link arbitration status. This command supports the optional show service-policy argument that select a certain IP interface. This command is available in the operator mode. interface Mode: Operator execution Step...
Page 160 SmartWare Software Configuration Guide 13 • Link scheduler configuration The command has optional values (in the range of 1 to 4) that deﬁne the level of detail (see table Table 7. Values deﬁning detail of the queuing statistics Optional Value Implication on Command Output Statistic gathering is switched off Display amount of packets passed (did not have to wait), queued (arrived ear-...
Page 161: Serial Port Configuration
Chapter 14 Serial port conﬁguration Chapter contents Introduction ................................162 Serial port configuration task list .........................162 Disabling an interface ...........................163 Enabling an interface ............................163 Configuring the serial encapsulation type ......................164 Configuring the hardware port protocol ......................165 Configuring the active clock edge ........................166 Configuring the baudrate ..........................166...
Page 162: Introduction
SmartWare Software Configuration Guide 14 • Serial port configuration Introduction This chapter provides an overview of the serial port and describes the tasks involved in its conﬁguration includes the following sections: • Serial port conﬁguration task list • Conﬁguration tasks •...
Page 163: Disabling An Interface
SmartWare Software Configuration Guide 14 • Serial port configuration Disabling an interface Before you replace a compact serial cable or attach your SmartNode to other serial equipment, use the command to disable the serial interfaces. This prevents anomalies and hardware faults. When you shutdown shut down an interface, it has the state CLOSED in the command display.
Page 164: Configuring The Serial Encapsulation Type
SmartWare Software Configuration Guide 14 • Serial port configuration Mode: Administrator execution Step Command Purpose node (cfg)#port serial slot port Selects the serial interface on slot and port node (prt-ser)[ slot/port ]#no shutdown Enables the interface node (prt-ser)[ slot/port ]#show port serial Displays the serial interface conﬁguration. Example: Enabling an interface The example shows how to enable the built-in serial interface on slot 0 and port 0.
Page 165: Configuring The Hardware Port Protocol
SmartWare Software Configuration Guide 14 • Serial port configuration node(prt-ser)[0/0]#encapsulation framerelay node(prt-ser)[0/0]#show port serial Serial Interface Configuration ------------------------------ Port : serial 0 0 0 State : CLOSED Hardware Port : V.35 Transmit Edge : normal Port Type : DTE CRC Type : CRC-16 Max Frame Length: 2048 Recv Threshold...
Page 166: Configuring The Active Clock Edge
SmartWare Software Configuration Guide 14 • Serial port configuration Recv Threshold Encapsulation : framerelay Conﬁguring the active clock edge Depending on the system conﬁgurations—i.e. when using long cables, with certain modem types or data rates—synchronization problems may occur on the serial port. In these cases, it may be necessary to conﬁgure the clock edge on which data is transmitted.
Page 167 SmartWare Software Configuration Guide 14 • Serial port configuration Mode: Port serial Step Command Purpose node (prt-ser)[ slot/port ]# baudrate Conﬁgures the baudrate for the serial interface. baudrate Example: Conﬁguring baudrate to 64,000 bps The following example conﬁgures a baudrate of 64,000 bps on the serial interface. Verify that the command output displays the correct baudrate.
Page 168: Enter Frame Relay Mode
SmartWare Software Configuration Guide 14 • Serial port configuration Rx abort sequence: Rx non octet: Rx frame len violation: Rx DPLL error: Sent frames: 116106 Tx good frames: 116106 Tx CTS lost: Tx underrun: Status Link: Control Line: enabled True Baudrate: 64000 bps Enter Frame Relay mode This section describes how to conﬁgure Frame Relay on the serial interface, after setting the basic serial inter-...
Page 169: Configuring The Keep-Alive Interval
SmartWare Software Configuration Guide 14 • Serial port configuration Mode: Frame Relay Step Command Purpose node (frm-rel)[ slot/port ]#lmi-type {ansi | gof | itu} Sets the LMI type Example: Conﬁguring the LMI type The following example sets the LMI type to ANSI T1.617 Annex D for Frame Relay over the serial interface on slot 0 and port 0.
Page 170 SmartWare Software Configuration Guide 14 • Serial port configuration This procedure describes how to enable Frame Relay fragmentation Mode: Frame Relay Step Command Purpose node (cfg)#port serial slot port Selects the serial interface on slot and port. node (prt-ser)[ 0/0 ]#framerelay Enters Frame Relay conﬁguration mode.
Page 171: Entering Frame Relay Pvc Configuration Mode
SmartWare Software Configuration Guide 14 • Serial port configuration The fragmentation size depends on the available bandwidth, the chosen codec, and its packet length: • The less bandwidth available per call, the smaller the fragment size has to be conﬁgured. •...
Page 172: Configuring The Pvc Encapsulation Type
SmartWare Software Configuration Guide 14 • Serial port configuration The following example enters the conﬁguration mode for PVC with the assigned DLCI of 1 for Frame Relay over the serial interface on slot 0 and port 0. node(cfg)#port serial 0 0 node(prt-ser)[0/0]#framerelay node(frm-rel)[0/0]#pvc 1 node(pvc)[1]#...
Page 173: Ip Interface Wan Is Bound To Pvc 1 On Port Serial 0 0
SmartWare Software Configuration Guide 14 • Serial port configuration Frame Relay PVC. If serial Frame Relay PVC shall be used as WAN access, a suitable name for the logical IP interface could be wan as in ﬁgure 28 below. Context “router”...
Page 174: Enabling A Frame Relay Pvc
SmartWare Software Configuration Guide 14 • Serial port configuration Enabling a Frame Relay PVC After binding Framerelay PVC to an ip interface it must be enabled for packet processing. This procedure acti- vates the PVC by opening the bound ip interface. This procedure describes how to enable Framerelay PVC for packet processing Mode: PVC Step...
Page 175: Debugging Frame Relay
SmartWare Software Configuration Guide 14 • Serial port configuration node(pvc)[1]#shutdown Check the PVC 1 status by using and verify that the entry shutdown occurs in the con- show running-conﬁg ﬁguration part responsible for this PVC. node(pvc)[1]#show running-config Running configuration: #----------------------------------------------------------------# # 2500 …...
Page 176: Displaying Serial Port Information
SmartWare Software Configuration Guide 14 • Serial port configuration Displaying serial port information The following example shows the commands used to display serial port conﬁguration settings. HDLC Driver: 0x8496b8 ===================== Slot: Number of Ports: HDLC Driver: 0x8496b8 ===================== Slot: Number of Ports: Port: serial 0 0 0 ------------------ State:...
Page 177: Integrated Service Access
SmartWare Software Configuration Guide 14 • Serial port configuration PVC Configuration: Port DLCI State Fragment Encaps Binding -------------------------------------------------------------- serial 0 0 0 open disabled rfc1490 wan@router PSTN Internet Multi Multi Service Service Provider PVC 1 Provider Node Leased Line Node Modem Modem Network...
Page 178: Ip Context With Logical Ip Interfaces Bound To Ethernet Port, Serial Port Pvc 1 And Pvc 2
SmartWare Software Configuration Guide 14 • Serial port configuration Between the leased line modem and the SmartNode, ANSI T.617 type of LMI packets have to be exchanged. In addition, the keep-alive interval has to be set to 20 seconds. To guarantee voice quality, fragmentation is enabled on the PVC which carries voice (PVC 1) and a service proﬁle is assigned which gives priority to voices packets.
Page 179 SmartWare Software Configuration Guide 14 • Serial port configuration node(src)[local-d~]#source class default … 4. Conﬁgure the serial interface settings. node(cfg)#port serial 0 0 node(prt-ser)[0/0]#shutdown node(prt-ser)[0/0]#encapsulation framerelay node(prt-ser)[0/0]#hardware-port x21 node(prt-ser)[0/0]#port-type dte … 5. Conﬁgure the Frame Relay. You must thus change to the Frame Relay conﬁguration mode. Use the ser- vice-policy proﬁle deﬁned above to give voice priority over data.
Page 180: T1/E1 Port Configuration
Chapter 15 T1/E1 port conﬁguration Chapter contents Introduction ................................181 T1/E1 port configuration task list........................181 Enable/Disable T1/E1 port ...........................181 Configuring T1/E1 port-type ........................182 Configuring T1/E1 clock-mode ........................182 Configuring T1/E1 line-code ........................182 Configuring T1/E1 framing ..........................182 Configuring T1/E1 line-build-out (T1 only) ....................183 Configuring T1/E1 used-connector (E1 only) ....................183 Configuring T1/E1 application mode...
Page 181: Introduction
SmartWare Software Configuration Guide 15 • T1/E1 port configuration Introduction This chapter provides an overview of the T1/E1 ports, their characteristics and the tasks involved in the conﬁguration. The conﬁgurable parameters for the T1/E1 port are type (T1 or E1), clock mode (or source) (master or slave), line code (AMI, HDB3, or B8ZS), framing (CRC-4, ESF, or unframed), line-build-out (for T1 only) and encapsulation (channelized or HDLC).
Page 182: Configuring T1/E1 Port-Type
SmartWare Software Configuration Guide 15 • T1/E1 port configuration Conﬁguring T1/E1 port-type The T1/E1 Port can either work in T1 or in E1 (G.704) mode. This mode can be changed dynamically as long as no encapsulation or encapsulation ‘hdlc’ is set. Be aware that changing the port-type also resets the framing and linecode parameters to the default values of the new port-type.
Page 183: Configuring T1/E1 Line-Build-Out (T1 Only)
SmartWare Software Configuration Guide 15 • T1/E1 port configuration The advantage of the unframed mode (obviously with hdlc encapsulation) is the utilization of the whole link speed for user data transmission, 2.048MBit/s for E1 and 1.544MBit/s for T1. However note that HDLC has its own overhead which decreases the actual data rate.
Page 184: Configuring T1/E1 Los Threshold
SmartWare Software Configuration Guide 15 • T1/E1 port configuration Conﬁguring T1/E1 LOS threshold This command takes effect only if the T1/E1 port is conﬁgured for long-haul applications. It speciﬁes the sen- sitivity for Loss Of Signal threshold. A signal suffers more attenuation over long distances than over short dis- tances.
Page 185: Configuring T1/E1 Encapsulation
SmartWare Software Configuration Guide 15 • T1/E1 port configuration The command has three other options that allow you to manually switch on/off different loops. All these addi- tional options are applicable in T1 and E1 mode. The ‘line-interface’ loop sends back the whole link bandwidth (2048kBit/s or 1544kBit/s). In ‘payload’...
Page 186: Configuring Channel-Group Timeslots
SmartWare Software Configuration Guide 15 • T1/E1 port configuration mode is immediately entered. To remove an existing channel-group the ‘no’ form of the command has to be used. Mode: port e1t1 <slot> <port> Step Command Purpose [ name ] (prt-e1t1)[slot/port]#[no] channel- Enters the channel-group conﬁguration mode of group-name .
Page 187: Configuring Hdlc Crc-Type
SmartWare Software Configuration Guide 15 • T1/E1 port configuration tion mode the encapsulation must be set to ‘hdlc’ as well followed by conﬁguring at least one timeslot per the ‘timeslots’ command. Mode: port e1t1 <slot> <port> Step Command Purpose [ name ] (prt-e1t1)[slot/port]# hdlc Entering the hdlc conﬁguration mode Mode: channel-group <group>...
Page 188: Example 1: Frame Relay Without A Channel-Group
SmartWare Software Configuration Guide 15 • T1/E1 port configuration Example 1: Frame Relay without a channel-group port e1t1 0 0 port-type e1 framing crc4 encapsulation hdlc hdlc encapsulation framerelay framerelay lmi-type itu pvc 100 encapsulation rfc1490 bind interface pvc100 router no shutdown port e1t1 0 0 no shutdown...
Page 189: Example 2: Framerelay With A Channel-Group
SmartWare Software Configuration Guide 15 • T1/E1 port configuration Example 2: Framerelay with a channel-group port e1t1 0 0 port-type e1 framing crc4 encapsulation channelized channel-group myGroup timeslots 13-17 encapsulation hdlc hdlc encapsulation framerelay framerelay lmi-type itu pvc 100 encapsulation rfc1490 bind interface pvc100 router no shutdown port e1t1 0 0...
Page 190: Dsl Port Configuration
Chapter 16 DSL Port Conﬁguration Chapter contents Introduction ................................191 Line Setup ................................191 Configuring PPPoE .............................191 Configuration Summary............................192 Setting up permanent virtual circuits (PVC)......................193 Using PVC channels in bridged Ethernet mode ....................193 Using PVC channels with PPPoE .........................193 Diagnostics ..............................194 Troubleshooting DSL Connections ........................194...
Page 191: Introduction
SmartWare Software Configuration Guide 16 • DSL Port Configuration Introduction This chapter provides an overview of the DSL ports (ADSL and G.SHDSL), their characteristics and the tasks involved in the conﬁguration. port dsl 0 0 vpi 8 vci 35 pppoe Profile session MyISP Subscriber PPP...
Page 192: Configuration Summary
SmartWare Software Configuration Guide 16 • DSL Port Configuration Next, you will need to create a WAN proﬁle, create a WAN interface, and create a subscriber. Then, you can conﬁgure the DSL port (port dsl 0 0) for PPPoE. Follow this example: profile napt WAN context ip router interface WAN...
Page 193: Setting Up Permanent Virtual Circuits (Pvc)
SmartWare Software Configuration Guide 16 • DSL Port Configuration Setting up permanent virtual circuits (PVC) The modems currently available are using ATM to multiplex trafﬁc over the DSL framing connection. ATM allows you to have separate logical connections running in parallel. Those connections are called permanent virtual circuits (PVC).
Page 194: Diagnostics
SmartWare Software Configuration Guide 16 • DSL Port Configuration Diagnostics Table 11. Diagnostics commans Command Purpose Step 1 node> show dsl type Displays the type of modem installed. Step 2 node> show dsl line-state Displays information about the state of the DSL link.
Page 195: Basic Ip Routing Configuration
Chapter 17 Basic IP routing conﬁguration Chapter contents Introduction ................................196 Routing tables ...............................196 Static routing ..............................196 Policy routing ...............................196 Basic IP routing configuration task list ........................196 Configuring static IP routes ..........................197 Deleting static IP routes ..........................198 Displaying IP route information ........................198 Configuring policy routing ...........................199...
Page 196: Introduction
SmartWare Software Configuration Guide 17 • Basic IP routing configuration Introduction This chapter provides an overview of IP routing and describes the tasks involved in conﬁguring static IP rout- ing. IP routing moves information across an internetwork from a source to a destination, typically passing through one or more intermediate nodes along the way.
Page 197: Configuring Static Ip Routes
SmartWare Software Configuration Guide 17 • Basic IP routing configuration • Displaying IP route information (see page 198) Conﬁguring static IP routes Rather than dynamically selecting the best route to a destination, you can conﬁgure one or more static routes to that destination.
Page 198: Deleting Static Ip Routes
SmartWare Software Configuration Guide 17 • Basic IP routing configuration Deleting static IP routes form of the command deletes a static IP route from the routing table. route This procedure describes how to delete one or more static IP routes from the routing table Mode: Administrator execution Step Command...
Page 199: Configuring Policy Routing
SmartWare Software Configuration Guide 17 • Basic IP routing configuration Conﬁguring policy routing Step Command Purpose Enters the IP router node (cfg)#context ip router context Deﬁne a static routing node(ctx-ip)[router]#[no] route destination netmask inter- table entry face|gateway [metric ] [trafﬁc-class <trafﬁc-class> ] Where the syntax is: •...
Page 200: Examples
SmartWare Software Configuration Guide 17 • Basic IP routing configuration In this routing table two default routes (0.0.0.0/0) are deﬁned. The ﬁrst default route is valid for packets of the class local-voice only. The second default route is valid for all packets. Thus voice packets generated locally (trafﬁc-class local-voice) will travel via the gateway (Nexthop) 172.16.32.1.
Page 201: Changing The Default Udp Port Range For Rtp And Rtcp
SmartWare Software Configuration Guide 17 • Basic IP routing configuration The necessary routing-table entries for the scenario described are listed below. node>enable node#configure node(cfg)#context ip router node(ctx-ip)[router]# route 10.1.5.10 255.255.255.255 172.16.40.2 node(ctx-ip)[router]# route 10.2.0.0 255.255.0.0 172.17.100.2 node>show ip route Routes of IP context 'router': Status codes: * valid, U up, H host, G Gateway, L local, D default Destination Nexthop...
Page 202: Rip Configuration
Chapter 18 RIP conﬁguration Chapter contents Introduction ................................203 Routing protocol ..............................203 RIP configuration task list ...........................204 Enabling send RIP ............................204 Enabling an interface to receive RIP ......................205 Specifying the send RIP version ........................205 Specifying the receive RIP version .........................206 Enabling RIP learning ...........................206 Enabling an interface to receive RIP ......................207...
Page 203: Introduction
SmartWare Software Configuration Guide 18 • RIP configuration Introduction This chapter provides an overview of the Routing Information Protocol (RIP) and describes the tasks involved in conﬁguring RIP features includes the following sections: • Routing protocol • RIP conﬁguration task list (see page 204) RIP is a relatively old but still commonly used interior gateway protocol created for use in small, homogeneous...
Page 204: Rip Configuration Task List
SmartWare Software Configuration Guide 18 • RIP configuration RIP 2 is more useful in a variety of environments and allows the use of variable subnet masks on your network. It is also necessary for implementation of classless addressing as accomplished with CIDR (classless inter- domain routing).
Page 205: Enabling An Interface To Receive Rip
SmartWare Software Configuration Guide 18 • RIP configuration Example: Enabling send RIP The following example shows how to enable send RIP on IP interface wan. node(cfg)#context ip router node(ctx-ip)[router]#interface wan node(if-ip)[wan]#rip supply Enabling an interface to receive RIP By default an interface does not listen to routing information. This procedure describes how to enable interface to receive RIP information Mode: Interface Step...
Page 206: Specifying The Receive Rip Version
SmartWare Software Configuration Guide 18 • RIP configuration Specifying the receive RIP version By default, RIP version 1 and version 2 packets are received. Alternatively, you can explicitly conﬁgure the RIP version to be received with the last command argument as following: •...
Page 207: Enabling An Interface To Receive Rip
SmartWare Software Configuration Guide 18 • RIP configuration The following example shows how to enable RIP learn host and default on IP interface wan. node(cfg)#context ip router node(ctx-ip)[router]#interface wan node(if-ip)[wan]#rip learn host node(if-ip)[wan]#rip learn default Enabling an interface to receive RIP This procedure describes how to enable receive RIP on an IP interface Mode: Interface Step...
Page 208: Enabling Rip Auto Summarization
SmartWare Software Configuration Guide 18 • RIP configuration node(cfg)#context ip router node(ctx-ip)[router]#interface wan node(if-ip)[wan]#rip announce default node(if-ip)[wan]#rip announce host Enabling RIP auto summarization Summarizing routes in RIP Version 2 improves scalability and efﬁciency in large networks. Auto-summarization attempts to automatically summarize groups of adjacent routes into single entries, the goal being to reduce the total number of entries in the RIP routing table, reducing the size of the table and allowing the router to handle more routes.
Page 209: Enabling Rip Split-Horizon Processing
SmartWare Software Configuration Guide 18 • RIP configuration Mode: Interface Step Command Purpose node (if-ip)[ name ]#rip default-route-value value Sets the routing metric to value indicating the distance to the destination on interface name Example: Specifying the default route metric The following example shows how to set the routing metric to 4 on IP interface wan.
Page 210: Enabling Holding Down Aged Routes
SmartWare Software Configuration Guide 18 • RIP configuration Mode: Interface Step Command Purpose node (if-ip)[ name ]#rip poison-reverse Enables the poison reverse algorithm on interface name Example: Enabling the poison reverse algorithm The following example shows how to enable the poison reverse algorithm on IP interface wan. node(cfg)#context ip router node(ctx-ip)[router]#interface wan node(if-ip)[wan]#rip poison-reverse...
Page 211: Displaying Global Rip Information
SmartWare Software Configuration Guide 18 • RIP configuration node(if-ip)[wan]#show rip interface wan Interface wan (IP context router): -------------------------------------------------- listen: disabled supply: enabled send version: 1compatible receive version: 1or2 learn host: disabled learn default: disabled announce host: disabled announce static: disabled announce default: disabled announce self-as-default: disabled route-holddown: enabled...
Page 212: Access Control List Configuration
Chapter 19 Access control list conﬁguration Chapter contents Introduction ................................213 About access control lists .............................213 What access lists do ............................213 Why you should configure access lists ......................213 When to configure access lists ........................214 Features of access control lists ........................214 Access control list configuration task list......................215 Mapping out the goals of the access control list .....................215...
Page 213: Introduction
SmartWare Software Configuration Guide 19 • Access control list configuration Introduction This chapter provides an overview of IP Access Control Lists and describes the tasks involved in conﬁguring them. This chapter includes the following sections: • About access control lists •...
Page 214: When To Configure Access Lists
SmartWare Software Configuration Guide 19 • Access control list configuration For example, access lists can allow one host to access a part of your network, and prevent another host from accessing the same area. In ﬁgure 33 host A is allowed to access the Human Resources network and host B is prevented from accessing the Human Resources network.
Page 215: Access Control List Configuration Task List
SmartWare Software Configuration Guide 19 • Access control list configuration • All access control lists have an implicit deny ip any any at the end. A packet that does not match the criteria of the ﬁrst statement is subjected to the criteria of the second statement and so on until the end of the access control list is reached, at which point the packet is dropped.
Page 216: Creating An Access Control List Profile And Enter Configuration Mode
SmartWare Software Configuration Guide 19 • Access control list configuration Before you begin to enter the commands that create and conﬁgure the IP access control list, be sure that you are clear about what you want to achieve with the list. Consider whether it is better to deny speciﬁc accesses and permit all others or to permit speciﬁc accesses and deny all others.
Page 217 SmartWare Software Configuration Guide 19 • Access control list configuration Mode: Proﬁle access control list Step Command Purpose node (pf-acl)[ name ]#deny ip { src src-wildcard | any | host Creates an IP access of control list src } { dest dest-wildcard | any | host dest } [cos group ] entry that denies access deﬁned according to the command options...
Page 218: Adding An Icmp Filter Rule To The Current Access Control List Profile
SmartWare Software Configuration Guide 19 • Access control list configuration Adding an ICMP ﬁlter rule to the current access control list proﬁle The command permit or deny are used to deﬁne an ICMP ﬁlter rule. Each ICMP ﬁlter rule represents an ICMP access of control list entry.
Page 219 SmartWare Software Configuration Guide 19 • Access control list configuration Where the syntax is as following: Keyword Meaning The source address to be included in the rule. An IP address in dotted-decimal-format, e.g. 64.231.1.10. A wildcard for the source address. Expressed in dotted-decimal format this value speciﬁes src-wildcard which bits are signiﬁcant for matching.
Page 220: Adding A Tcp, Udp Or Sctp Filter Rule To The Current Access Control List Profile
SmartWare Software Configuration Guide 19 • Access control list configuration The same effect can also be obtained by using the simpler message name option. See the following example. node(cfg)#profile acl WanRx node(pf-acl)[WanRX]#deny icmp any any msg echo node(pf-acl)[WanRX]#exit node(cfg)# Adding a TCP, UDP or SCTP ﬁlter rule to the current access control list proﬁle The commands permit or deny are used to deﬁne a TCP, UDP or SCTP ﬁlter rule.
Page 221 SmartWare Software Configuration Guide 19 • Access control list configuration Where the syntax is: Keyword Meaning The source address to be included in the rule. An IP address in dotted-decimal-format, e.g. 64.231.1.10. A wildcard for the source address. Expressed in dotted-decimal format this value speciﬁes src-wildcard which bits are signiﬁcant for matching.
Page 222: Binding And Unbinding An Access Control List Profile To An Ip Interface
SmartWare Software Configuration Guide 19 • Access control list configuration Binding and unbinding an access control list proﬁle to an IP interface The command use is used to bind an access control list proﬁle to an IP interface. This procedure describes how to bind an access control list proﬁle to incoming packets on an IP interface Mode: Proﬁle access control list Step...
Page 223: Displaying An Access Control List Profile
SmartWare Software Configuration Guide 19 • Access control list configuration Unbind an access control list proﬁle from an interface. node(cfg)#context ip router node(cfg-ip)[router]#interface wan node(cfg-if)[wan]#no use profile acl in Note When unbinding an access control list proﬁle the name argument is not required, since only one incoming and outgoing access control list can be active at the same time on a certain IP interface.
Page 224 SmartWare Software Configuration Guide 19 • Access control list configuration Mode: Interface Step Command Purpose Selects the IP router context node (cfg)#context ip router node (ctx-ip)[router]#interface if-name Selects IP interface if-name for which access control list profile shall be debugged node (if-ip)[ if-name ]#debug acl {in | out} [level] Enables access control list debug monitor with a certain debug level for the selected...
Page 225: Examples
SmartWare Software Configuration Guide 19 • Access control list configuration Examples Denying a speciﬁc subnet Figure 34 shows an example in which a server attached to network 172.16.1.0 shall not be accessible from outside networks connected to IP interface lan. To prevent access, an incoming ﬁlter rule named Jamming is deﬁned, which blocks any IP trafﬁc from network 172.16.2.0 and has to be bound to IP interface lan.
Page 226: Snmp Configuration
Chapter 20 SNMP conﬁguration Chapter contents Introduction ................................227 Simple Network Management Protocol (SNMP) ....................227 SNMP basic components ..........................227 SNMP basic commands ..........................227 SNMP management information base (MIB) ....................228 Network management framework .........................228 Identification of a SmartNode via SNMP......................228 SNMP tools.................................229 SNMP configuration task list ..........................229 Setting basic system...
Page 227: Introduction
SmartWare Software Configuration Guide 20 • SNMP configuration Introduction This chapter provides overview information about Simple Network Management Protocol (SNMP) and describes the tasks used to conﬁgure those of its features supported. This chapter includes the following sections: • Simple Network Management Protocol (SNMP) •...
Page 228: Snmp Management Information Base (Mib)
SmartWare Software Configuration Guide 20 • SNMP configuration • Traversal operations are used by the NMS to determine which variables a managed device supports and to sequentially gather information in variable tables, such as a routing table. SNMP management information base (MIB) A Management Information Base (MIB) is a collection of information that is organized hierarchically.
Page 229: Snmp Tools
SmartWare Software Configuration Guide 20 • SNMP configuration The SNMP agent running in SmartWare is SNMP version 1 (SNMPv1) compliant. SNMP version 2 (SNMPv2) and SNMP version 3 (SNMPv3) are not currently supported. IMPORTANT SNMP tools Patton recommends the AdventNet MibBrowser, TrapViewer and other SNMP tools. Check the AdventNet Web server at http://www.adventnet.com for latest releases.
Page 230 SmartWare Software Configuration Guide 20 • SNMP configuration Mode: Administrator execution Step Command Purpose node (cfg)#system contact name Sets the contact persons name node (cfg)#system location location Sets the system location node (cfg)#system hostname hostname Sets the system hostname and command line prompt If any of the command options name, location, or hostname has to be formed out of more than one word, the information is put in “double quotes”.
Page 231: Setting Access Community Information
SmartWare Software Configuration Guide 20 • SNMP configuration Figure 35. AdventNet MibBrowser displaying some of the System Group objects Example: Setting the system group objects In the following example the system information is set for later access via SNMP. See ﬁgure 35 for a typical MIB browser application accessing these MIB-II system group objects representing the system information.
Page 232 SmartWare Software Configuration Guide 20 • SNMP configuration Community strings also provide a weak form of access control in earlier versions of SNMP version 1 and 2. SNMP version 3 provides much improved access control using strong authentication and should be preferred over SNMP version 1 and 2 wherever it is supported.
Page 233: Setting Allowed Host Information
SmartWare Software Configuration Guide 20 • SNMP configuration Setting allowed host information If a host has to access SNMP MIB objects on a certain node, it explicitly needs the right to access the SNMP agent. Therefore a host needs an entry, which allows accessing the device. The host is identiﬁed by its IP address and has to use a certain community string for security precautions.
Page 234: Displaying Snmp Related Information
SmartWare Software Configuration Guide 20 • SNMP configuration In the following example the NMS running on host with IP address 172.16.224.44 shall be deﬁned as SNMP trap target. Since the NMS requires that SNMP message headers have a community of Not4evEryOne the secu- rity-name argument is set accordingly.
Page 235: Using The Mibbrowser
SmartWare Software Configuration Guide 20 • SNMP configuration The TrapViewer is a graphical tool to view the Traps received from one or more SNMP agents. The Trap viewer can listen to one or more port at a time and the traps can be sent from any host. Moreover the TrapViewer con- tains a Trap parser editor, which is a tool to create a trap parser ﬁle.
Page 236: Using The Trapviewer
SmartWare Software Configuration Guide 20 • SNMP configuration Using the TrapViewer TrapViewer is a graphical tool to view the traps received from one or more SNMP agents. The TrapViewer can listen to one or more port at a time and the traps can be sent from any host. Invoke the TrapViewer through the usage of the MibBrowser.
Page 237: Adventnet Trap Details Window Of Trapviewer
SmartWare Software Configuration Guide 20 • SNMP configuration Message that by default has the object identiﬁer format (sequence of numeric or textual labels on the SNs along a path from the root to the object) of the trap if any, or it is blank. •...
Page 238: Standard Snmp Version 1 Traps
SmartWare Software Configuration Guide 20 • SNMP configuration Table 12. Details available in the Trap Details window (Continued) Trap Details Description The source IP address from which the Trap was sent is displayed here. Entity This ﬁeld reveals the port on which the Trap was sent by the originator. RemotePort The Community string is displayed here.
Page 239: Snmp Interface Traps
SmartWare Software Configuration Guide 20 • SNMP configuration linkUp TRAP-TYPE ENTERPRISE snmp VARIABLES { ifIndex } DESCRIPTION "A linkUp trap signifies that the sending protocol entity recognizes that one of the communication links represented in the agent's configuration has come up." ::= 3 Note The linkUp trap is not sent if any of the ISDN ports has come up.
Page 240 SmartWare Software Configuration Guide 20 • SNMP configuration 2002-09-06T14:54:39 : LOGINFO : Link up on interface eth00. 2002-09-06T14:54:39 : LOGINFO : Link up on interface eth01. 2002-09-06T14:56:02 : LOGINFO : Link up on interface SLOT2:00 ISDN D 2002-09-10T14:21:20 : LOGINFO : Link down on interface SLOT2:00 ISDN SNMP interface traps...
Page 241: Sntp Client Configuration
Chapter 21 SNTP client conﬁguration Chapter contents Introduction ................................242 SNTP client configuration task list ........................242 Selecting SNTP time servers .........................243 Defining SNTP client operating mode ......................243 Defining SNTP local UDP port ........................244 Enabling and disabling the SNTP client .......................245 Defining SNTP client poll interval .......................245 Defining SNTP client constant offset to GMT .....................246...
Page 242: Introduction
SmartWare Software Configuration Guide 21 • SNTP client configuration Introduction This chapter describes how to conﬁgure Simple Network Time Protocol (SNTP) client, it includes the follow- ing sections: • SNTP client conﬁguration task list • Recommended Public SNTP Time Servers (see page 249) The Simple Network Time Protocol (SNTP) is an adaptation of the Network Time Protocol (NTP) that is...
Page 243: Selecting Sntp Time Servers
SmartWare Software Configuration Guide 21 • SNTP client configuration Selecting SNTP time servers This procedure describes how to select a primary and secondary SNTP time server Mode: Conﬁgure Step Command Purpose node (cfg)#sntp-client server primary host Enter the SNTP primary server IP address or hostname node (cfg)#sntp-client server secondary host Enter the SNTP secondary server IP...
Page 244: Defining Sntp Local Udp Port
SmartWare Software Configuration Guide 21 • SNTP client configuration Example: Conﬁguring SNTP client operating mode Conﬁgures the SNTP client operating mode to unicast operation node(cfg)#sntp-client operating-mode unicast Conﬁgures the SNTP client operating mode to anycast operation node(cfg)#sntp-client operating-mode anycast Conﬁgures the SNTP client operating mode to multicast operation node(cfg)#sntp-client operating-mode multicast Deﬁning SNTP local UDP port The communication between an SNTP client and its the primary or secondary SNTP time server uses UDP.
Page 245: Enabling And Disabling The Sntp Client
SmartWare Software Configuration Guide 21 • SNTP client configuration Enabling and disabling the SNTP client The SNTP client is disabled by default and has to be enabled if clock synchronization shall be used. This pro- cedure describes how to enable or disable the SNTP client Mode: Conﬁgure Step Command...
Page 246: Defining Sntp Client Constant Offset To Gmt
SmartWare Software Configuration Guide 21 • SNTP client configuration Deﬁning SNTP client constant offset to GMT Setting the offset of the device local time zone from Greenwich Mean Time is required if the local time shall be used for time dependent routing decisions or other reasons. Greenwich Mean Time (GMT) is also known as Zulu Time and Universal Time Coordinated (UTC), refer to http://greenwichmeantime.com/ for more details and information about your time zone and offset to GMT.
Page 247: Enabling And Disabling Local Clock Offset Compensation
SmartWare Software Configuration Guide 21 • SNTP client configuration Mode: Conﬁgure Step Command Purpose node (cfg)#sntp-client anycast-address ip- Set the anycast-address to ip-address a designated address {port | port-number } local broadcast or multicast group address to which a request is sent. In addition an explicit SNTP server port-number in the range from 1 to 65535 can be deﬁned or the argument port is selected, which sets the value for port to 123.
Page 248: Showing Sntp Client Related Information
SmartWare Software Configuration Guide 21 • SNTP client configuration Example: Disabling the SNTP client root delay compensation node(cfg)#no sntp-client root-delay-compensation Showing SNTP client related information During set-up and operation of the SNTP client, displaying the information and status of the SNTP client is very useful.
Page 249: Recommended Public Sntp Time Servers
SmartWare Software Configuration Guide 21 • SNTP client configuration Example: Enable the SNTP debug monitor The following example shows how to enable the SNTP debug monitor and some typical debug information. node(cfg)#debug sntp client node(cfg)#14:44:21 SNTP > SNTP message sent with Timestamp: 2001-10-26T14:44:21 14:44:21 SNTP >...
Page 250: Additional Information On Ntp And A List Of Other Ntp Servers
SmartWare Software Configuration Guide 21 • SNTP client configuration For more information about NIST Internet Time Service (ITS) check their web server at http://www.boulder.nist.gov/timefreq/service/its.htm Additional information on NTP and a list of other NTP servers The site http://ntp.isc.org contains a maintained list of available NTP/SNTP servers. Please only use the ones with an open access policy! Recommended public SNTP time servers...
Page 251: Dhcp Configuration
Chapter 22 DHCP conﬁguration Chapter contents Introduction ................................252 DHCP-client configuration tasks.........................253 Enable DHCP-client on an IP interface ......................253 Release or renew a DHCP lease manually (advanced) ...................255 Get debug output from DHCP-client ......................255 DHCP-server configuration tasks ........................256 Configure DHCP-server profiles ........................256 Use DHCP-server profiles and enable the DHCP-server ................258...
Page 252: Introduction
SmartWare Software Configuration Guide 22 • DHCP configuration Introduction This chapter provides an overview of the Dynamic Host Conﬁguration Control Protocol (DHCP) and describes the tasks involved in their conﬁguration. This chapter includes the following sections: • DHCP-client conﬁguration tasks (see page 253) •...
Page 253: Dhcp-Client Configuration Tasks
SmartWare Software Configuration Guide 22 • DHCP configuration DHCP-server and DHCP-client are illustrated in ﬁgure Node Node DHCP Server Node Node DHCP Clients DHCP Clients Node Node DHCP Server Figure 39. DHCP-client and DHCP-server DHCP-client conﬁguration tasks To conﬁgure the SmartNode as DHCP-client perform the steps mentioned below. •...
Page 254 SmartWare Software Configuration Guide 22 • DHCP configuration interface, e.g. the default gateway, DNS server IP addresses, etc. To enable the DHCP-client on an IP interface perform the steps described below. Mode: context IP Step Command Purpose node (ctx-ip)[router]#interface name Creates an IP interface with name name and enters ‘conﬁgure’...
Page 255: Release Or Renew A Dhcp Lease Manually (Advanced)
SmartWare Software Configuration Guide 22 • DHCP configuration Release or renew a DHCP lease manually (advanced) After enabling the DHCP-client, the interface receives a DHCP lease from the DHCP-server. To manually release and/or renew this DHCP lease use the command described below. This procedure describes how to release and renew the DHCP lease Mode: interface Step...
Page 256: Dhcp-Server Configuration Tasks
SmartWare Software Configuration Guide 22 • DHCP configuration 2001-01-01T01:17:47 : LOGINFO : router/eth0 (Rqst): Got DHCP lease for 172.16.224.102 01:17:47 DHCPC > router/eth0 (Rqst): DHCP ACK received. 01:17:47 DHCPC > router/eth0 (Rqst): Lease is valid for 28800 seconds 01:17:47 DHCPC > router/eth0 (Rqst): (t1: 14400, t2: 25200) 01:17:47 DHCPC >...
Page 257 SmartWare Software Configuration Guide 22 • DHCP configuration Mode: Conﬁgure Step Command Purpose node (cfg)#proﬁle dhcp-server name Enter DHCP-server proﬁle mode node (pf-dhcps)[name]#network ip- Deﬁnes the IP address range for which this pro- address ip-mask ﬁle is responsible IP address: basic DHCP information (‘your (cli- ent) IP address’) IP mask: DHCP Option 1 node (pf-dhcps)[name]#[no] include ip-...
Page 258: Use Dhcp-Server Profiles And Enable The Dhcp-Server
SmartWare Software Configuration Guide 22 • DHCP configuration Step Command Purpose node (pf-dhcps)[name]#[no] bootﬁle boot- Deﬁnes the bootﬁle the client shall use when file-name (optional) starting. Usually this is used in conjunction with the next-server command. Basic DHCP information (‘Boot ﬁle name’) Deﬁnes the address of the next server in the node (pf-dhcps)[name]#[no] next-server (optional)
Page 259: Check Dhcp-Server Configuration And Status
SmartWare Software Configuration Guide 22 • DHCP configuration Check DHCP-server conﬁguration and status This procedure describes how to check the conﬁguration and current status of the DHCP-server Mode: Any Step Command Purpose node (cfg) #show dhcp-server Displays conﬁguration and status information Example: node(ctx-ip)[router]#show dhcp-server The DHCP server is running...
Page 260 SmartWare Software Configuration Guide 22 • DHCP configuration Example: Enable DHCP debug monitor This example shows how to enable the DHCP-server debug monitor. The debug output shows an activation of the DHCP-server, a DHCP-client requesting a lease, and a DHCP-client releasing a lease. node(ctx-ip)[router]#debug dhcp-server 21:40:29 DHCPS >...
Page 261: Dns Configuration
Chapter 23 conﬁguration Chapter contents Introduction ................................262 DNS configuration task list ..........................262 Enabling the DNS resolver ..........................262 Enabling the DNS relay ..........................263...
Page 262: Introduction
SmartWare Software Configuration Guide 23 • DNS configuration Introduction The domain name system (DNS) enables users to contact a remote host by using easily remembered text labels (www.patton.com, for example) instead of having to use the host’s numeric address (209.45.110.15, for exam- ple).
Page 263: Enabling The Dns Relay
SmartWare Software Configuration Guide 23 • DNS configuration You can test the DNS server conﬁguration using the dns-lookup command as follows: Example: Testing DNS server conﬁguration node(cfg)#dns-lookup www.patton.com Name: www.patton.com Address: 209.49.110.5 Note The DNS resolver automatically learns domain name servers if it receives them through PPP or DHCP protocols.
Page 264 SmartWare Software Configuration Guide 23 • DNS configuration address. DNS Relay agents maintain a cache of host names and IP addresses, much smaller than a DNS Server. It acts as a liaison between the DNS Server and the DNS client Advantages in conﬁguring a DNS Relay in the SmartNode are: •...
Page 265: Dyndns Configuration
Chapter 24 DynDNS conﬁguration Chapter contents Introduction ................................266 DynDNS configuration task list ..........................266 Creating a DynDNS account ........................266 Configuring the DNS resolver ........................266 Configuring basic DynDNS settings ......................267 Configuring advanced DynDNS settings (optional) ..................267 Defining a mail exchanger for your hostname ..................267 Troubleshooting ............................268...
Page 266: Introduction
SmartWare Software Configuration Guide 24 • DynDNS configuration Introduction SmartNodes are often used in applications where the addresses of their IP interfaces are not assigned statically (i.e. permanently) but instead are conﬁgured dynamically. In these applications, the IP address is assigned dynamically using protocols like DHCP or PPP.
Page 267: Configuring Basic Dyndns Settings
SmartWare Software Configuration Guide 24 • DynDNS configuration Conﬁguring basic DynDNS settings The following procedure describes the steps necessary to enable the DynDNS feature. Mode: DynDNS Step Command Purpose node(dyndns)#authentication user pass- Deﬁnes the authentication credentials of your word DynDNS account Deﬁnes the DynDNS service to use node(dyndns)#service {dynamic|static|custom}...
Page 268: Troubleshooting
SmartWare Software Configuration Guide 24 • DynDNS configuration Example: Deﬁning a mail exchanger The following example shows how to deﬁne a mail exchanger named mail.mycompany.com, which should be used as the primary mail-exchanger for the registered DynDNS hostname. node>enable node#configure node(cfg)#context ip node(ctx-ip)[router]#dyndns node(dyndns)#mail-exchanger mail.mycompany.com...
Page 269 SmartWare Software Configuration Guide 24 • DynDNS configuration 16:20:43 DYNDNS> Resolved 'update.dyndns.org'. 16:20:43 DYNDNS> Updating DNS... 16:20:43 DYNDNS> Sending request... 16:20:44 DYNDNS> DNS updated successfully 16:20:44 DYNDNS> Registered IP address is (57.32.59.64). If required, you can force the DynDNS component to re-register the current IP address on the DynDNS server—even if the dynamic IP address has not changed—using the following command (this command could also be useful for observing the update process in the debug monitor).
Page 270: Ppp Configuration
Chapter 25 PPP conﬁguration Chapter contents Introduction ................................271 PPP configuration task list...........................272 Creating an IP interface for PPP ........................272 Disable interface IP address auto-configuration from PPP ................274 Creating a PPP subscriber ..........................274 Trigger forced reconnect of PPP sessions using a timer .................276 Disable interface IP address auto-configuration from PPP ................276...
Page 271: Introduction
SmartWare Software Configuration Guide 25 • PPP configuration Introduction This chapter describes how to conﬁgure the point-to-point protocol over different link layers. The point-to-point protocol (PPP) provides a standard method for transporting multi-protocol datagrams over point-to-point links as deﬁned by the RFC1661 etc. SmartWare offers PPP over the following link layers: •...
Page 272: Ppp Configuration Task List
SmartWare Software Configuration Guide 25 • PPP configuration PPP conﬁguration task list To conﬁgure PPP, perform the following tasks: • Creating an IP interface for PPP • Conﬁguring for IP address auto-conﬁguration from PPP (see page 274) • Creating a PPP subscriber (for authentication) (see page 274) •...
Page 273 SmartWare Software Configuration Guide 25 • PPP configuration Step Command Purpose The PPP remote peer offers an IP address for the node (if-ip)[name]#ipaddress IP interface. The IP interface adopts this IP unnumbered address Once PPP has established an IP connection, the node (if-ip)[name]#ipaddress dhcp IP interface can use DHCP to acquire an IP address.
Page 274: Disable Interface Ip Address Auto-Configuration From Ppp
SmartWare Software Configuration Guide 25 • PPP configuration Step Command Purpose node (if-ip)[name]#use proﬁle napt name Assigns the NAPT proﬁle name to applied to (optional) this IP interface. See 11, “NAT/NAPT conﬁgu- on page 123 to learn how to create a ration”...
Page 275 SmartWare Software Configuration Guide 25 • PPP configuration Step Command Purpose Deﬁnes the direction of the connection establish- node (subscr)[name]# dial {in|out} ment with PPP over ISDN. This information allows to use different subscribers for incoming and out- going calls. With the other two link layers, set the direction as follows: PPP over Ethernet: ‘dial out’...
Page 276: Trigger Forced Reconnect Of Ppp Sessions Using A Timer
SmartWare Software Configuration Guide 25 • PPP configuration Trigger forced reconnect of PPP sessions using a timer In some situations, it is useful to disconnect and reconnect a PPP session at a clearly deﬁned time. The follow- ing procedure shows how PPP can be conﬁgured to reconnect the connection every time a timer expires. A common application for this feature: some ISPs disconnect the PPP session after a ﬁxed period of time, for example, 16 hours.
Page 277 SmartWare Software Configuration Guide 25 • PPP configuration Mode: Conﬁgure Step Command Purpose node (cfg) #port ethernet slot port Enters Ethernet port conﬁguration mode for the interface on slot and port Deﬁnes the payload type(s) to be used on the node (prt-eth)[slot/port]# encapsulation Ethernet: {ip|pppoe|multi}...
Page 278: Configuring A Serial Port For Ppp
SmartWare Software Configuration Guide 25 • PPP configuration Example: Conﬁgure a PPPoE session The procedure below conﬁgures a PPPoE session for the connection to a DSL provider using the credentials speciﬁed in the subscriber proﬁle above. node(cfg)#port ethernet 0 0 node(prt-eth)[0/0]#encapsulation pppoe node(prt-eth)[0/0]#no shutdown node(prt-eth)[0/0]#pppoe...
Page 279: Creating A Ppp Profile
SmartWare Software Configuration Guide 25 • PPP configuration Creating a PPP proﬁle A PPP proﬁle allows to adjust additional PPP parameters like the maximum transmit unit (MTU) and maxi- mum receive unit (MRU). Only the most important parameters are listed here. The proﬁle default is always present and supplies the parameters if no other proﬁle has been created or no pro- ﬁle can be used with a certain type of PPP connection.
Page 280: Displaying Ppp Configuration Information
SmartWare Software Configuration Guide 25 • PPP configuration node(pf-ppp)[PPPoE]#port ethernet 0 0 node(prt-eth)[0/0]#pppoe node(pppoe)[0/0]#session green node(session)[green]#use profile ppp PPPoE Displaying PPP conﬁguration information This section shows how to display and verify the PPP conﬁguration information. Mode: Conﬁgure Step Command Purpose Gives the best overview of all PPP related conﬁgura- node (cfg) #show running-conﬁg tion information.
Page 281: Debugging Ppp
SmartWare Software Configuration Guide 25 • PPP configuration Example: Display a PPP proﬁle node(pf-ppp)[PPPoE]#show profile ppp PPPoE Profiles: --------- Name: default LCP Configure-Request: interval 3000 ms, max 10 LCP Configure-Nak: max 5 LCP Terminate-Request: interval 3000 ms, max 2 LCP Echo-Request: interval 10000 ms, max 3 MTU: 68 - 1920...
Page 282 SmartWare Software Configuration Guide 25 • PPP configuration Mode: Conﬁgure Step Command Purpose node (cfg) #show ppp links [ level ] Displays status and conﬁguration information of the Link Control Protocol (LCP) and the authentica- tion protocol(s) (PAP and/or CHAP). Check whether the states of the two protocols are ‘Opened’.
Page 283 SmartWare Software Configuration Guide 25 • PPP configuration Example: Display PPP link information node(cfg)#show ppp links 4 PPP Link Information: ===================== Link: Name: ethernet 0 0 0/pppoe/ppp_green Protocols: LCP, PAP LCP: Name: ethernet 0 0 0/pppoe/ppp_green State: Opened Conf-Req send rate: 3000ms Max.
Page 284 SmartWare Software Configuration Guide 25 • PPP configuration Example: Display PPP network protocol information node(session)[green]#show ppp networks 4 PPP Network Information: ======================== Network: Name: ethernet 0 0 0/pppoe/ppp_green/net State: IPCP: Name: ethernet 0 0 0/pppoe/ppp_green/net State: Opened Conf-Req send rate: 3000ms Max.
Page 285: Sample Configurations
SmartWare Software Configuration Guide 25 • PPP configuration Service: Access-Concentrator: State: Opened Sent Initiations: Sent Requests: Peer Session-ID: 3786 Peer MAC-Address: 00:01:02:B8:4E:E4 Sample conﬁgurations PPP over Ethernet (PPPoE) Without authentication, encapsulation multi, with NAPT profile napt WAN context ip router interface normal_ip_interface ipaddress 172.16.1.1 255.255.0.0 interface ppp_interface...
Page 286: Ppp Over Serial Link
SmartWare Software Configuration Guide 25 • PPP configuration identification outbound <user> password <password> bind interface ppp_interface router port ethernet 0 0 encapsulation pppoe no shutdown pppoe session green bind subscriber joe_example no shutdown PPP over serial link Without authentication, numbered interface context ip router interface ppp_interface ipaddress 172.17.1.1 255.255.255.252...
Page 287: Vpn Configuration
Chapter 26 VPN conﬁguration Chapter contents Introduction ................................288 Authentication ..............................288 Encryption ..............................288 Transport and tunnel modes .........................289 Permanent IKE Tunnels ..........................289 Key management ............................289 VPN configuration task list ..........................290 Creating an IPsec transformation profile .......................290 Creating an IPsec policy profile ........................290 Creating/modifying an outgoing ACL profile for IPsec .................292...
Page 288: Introduction
SmartWare Software Configuration Guide 26 • VPN configuration Introduction This chapter describes how to conﬁgure the VPN connections between two SmartNodes or between a SmartNode and a third-party device. A virtual private network (VPN) is a private data network that uses the public telecommunications infrastruc- ture, maintaining privacy through the use of a tunneling protocol and security procedures.
Page 289: Transport And Tunnel Modes
SmartWare Software Configuration Guide 26 • VPN configuration Transport and tunnel modes The mode determines the payload of the ESP packet and hence the application: • Transport mode: Encapsulates only the payload of the original IP packet, but not its header, so the IPsec peers must be at the endpoints of the communications link.
Page 290: Vpn Configuration Task List
SmartWare Software Configuration Guide 26 • VPN configuration VPN conﬁguration task list To conﬁgure a VPN connection, perform the following tasks: • Creating an IPsec transformation proﬁle • Creating an IPsec policy proﬁle • Creating/modifying an outgoing ACL proﬁle for IPsec •...
Page 291 SmartWare Software Configuration Guide 26 • VPN configuration Procedure: To create an IPsec policy proﬁle Mode: Conﬁgure Step Command Purpose Creates the IPsec policy profile name node (cfg)#profile ipsec-policy-man- ual name Selects the IPsec transformation profile to be node (pf-ipstr)[name]#use profile ipsec-transform name applied node (pf-ipstr)[ name ]#session-key...
Page 292: Creating/Modifying An Outgoing Acl Profile For Ipsec
SmartWare Software Configuration Guide 26 • VPN configuration Use no in front of the above commands to delete a proﬁle or a conﬁguration entry. Example: Create an IPsec policy proﬁle The following example deﬁnes a proﬁle for AES-encryption at a key length of 128. node(cfg)#profile ipsec-policy-manual ToBerne node(pf-ipsma)[ToBerne]#use profile ipsec-transform AES_128 node(pf-ipsma)[ToBerne]#session-key inbound esp-encryption...
Page 293: Configuration Of An Ip Interface And The Ip Router For Ipsec
SmartWare Software Configuration Guide 26 • VPN configuration Conﬁguration of an IP interface and the IP router for IPsec The IP interface that provides connectivity to the IPsec peer, must now activate the outgoing ACL proﬁle con- ﬁgured in the previous section. Furthermore, the IP router must have a route for the remote network that points to the respective IP interface.
Page 294: Debugging Ipsec
SmartWare Software Configuration Guide 26 • VPN configuration Example: Display IPsec transformation proﬁles node(cfg)#show profile ipsec-transform IPSEC transform profiles: Name: AES_128 ESP Encryption: AES-CBC, Key length: 128 Example: Display IPsec policy proﬁles node(cfg)#show profile ipsec-policy-manual Manually keyed IPsec policy profiles: Name: ToBerne, Peer: 200.200.200.1, Mode: tunnel, transform-profile: AES_128 ESP SPI Inbound: 1111, Outbound: 2222 ESP Encryption Key Inbound: 1234567890ABCDEF1234567890ABCDEF...
Page 295: Key Management (Ike)
SmartWare Software Configuration Guide 26 • VPN configuration MANUAL ToBerne Tunnel 200.200.200.1 1111 AES-CBC 128 3622/unlimited 19047/unlimited OUT MANUAL ToBerne Tunnel 200.200.200.1 2222 AES-CBC 128 2857/unlimited 19047/unlimited Key management (IKE) In addition to manual keyed IPSEC connections, support for automatically keyed IPSEC connections using the Internet Key Exchange (IKE / RFC2409) protocol has been integrated, which is based on Internet Security Association and Key Management Protocol (ISAKMP / RFC2408).
Page 296: Creating An Isakmp Transform Profile
SmartWare Software Configuration Guide 26 • VPN configuration can optionally also specify a security association lifetime for IKE security associations. If the lifetime of the security association expires, IKE will automatically negotiate a new security association. The default lifetime for ISPEC security associations is one hour without any limit on the transmitted data volume. The parameters deﬁned in this proﬁle are used for the negotiation of IPSEC security associations in quick mode.
Page 297: Creating An Isakmp Ipsec Policy Profile
SmartWare Software Configuration Guide 26 • VPN configuration Creating an ISAKMP IPSEC policy proﬁle To deﬁne all the settings and proﬁles needed to establish an IPSEC security association, you need to create an ISAKMP IPSEC policy proﬁle There you can specify the ISAKMP and IPSEC transforms you created above, which should be used and other necessary parameters.
Page 298: Creating/Modifying An Outgoing Acl Profile For Ipsec
SmartWare Software Configuration Guide 26 • VPN configuration Step Command Purpose Optionally if the remote system requires pro- node (pf- ipsik)[< name >]# protected- tected networks to be specified in the identity network {host <local-host-ip>}|{sub- (optional) payload of the quick mode, you can define one net <local-subnet-address>...
Page 299: Troubleshooting
SmartWare Software Configuration Guide 26 • VPN configuration permit 4 ip any 10.0.0.0 0.255.255.255 ipsec-policy VPN permit 5 ip any any proﬁle ipsec-transform IPSEC_3DES_192 esp-encryption 3des-cbc 192 proﬁle isakmp-transform ISAKMP_3DES_192 encryption 3des-cbc 192 authentication-algorithm sha1 proﬁle ipsec-policy-isakmp VPN authentication-method pre-shared-key sdfkl@hgdslkfs/iuçkﬂd$gus+ghf mode tunnel peer 1.2.3.4 difﬁe-hellman-group group2...
Page 300: Encrypted Voice - Performance Considerations
SmartWare Software Configuration Guide 26 • VPN configuration In addition to the monitors there are also show commands, which display current information about IKE and IPSEC. show ike policy <policy-name> • Displays information about the conﬁguration options of speciﬁc policy as well as an indication, if the policy is valid or not.
Page 301: Using An Alternate Source Ip Address For Specific Destinations
SmartWare Software Configuration Guide 26 • VPN configuration Mode: Context ip /interface <if-name> Step Command Purpose Enable or disable RTP encryption support on an node (if-ip)[if- name ]# [no] rtp-encryp- IP interface. tion Using an alternate source IP address for speciﬁc destinations Normally, locally originated IP packets use the IP address of the outbound IP interface as their source address.
Page 302: Cisco Router Configuration
SmartWare Software Configuration Guide 26 • VPN configuration mode tunnel profile acl VPN_Out permit ip 192.168.1.0 0.0.0.255 172.16.0.0 0.0.255.255 ipsec-policy VPN_DES permit ip any any profile acl VPN_In permit esp any any permit ah any any permit ip 172.16.0.0 0.0.255.255 192.168.1.0 0.0.0.255 deny ip any any context ip router interface LAN...
Page 303: Cisco Router Configuration
SmartWare Software Configuration Guide 26 • VPN configuration profile ipsec-policy-manual VPN_AES_SHA1 use profile ipsec-transform AES_SHA1 session-key inbound ah-authentication 1234567890ABCDEF1234567890ABCDEF12345678 session-key outbound ah-authentication FEDCBA0987654321FEDCBA0987654321FEDCBA09 session-key inbound esp-encryption 1234567890ABCDEF1234567890ABCDEF1234567890ABCDEF1234567890ABCDEF session-key outbound esp-encryption FEDCBA0987654321FEDCBA0987654321FEDCBA0987654321FEDCBA0987654321 spi inbound ah 3333 spi outbound ah 4444 spi inbound esp 5555 spi outbound esp 6666 peer 200.200.200.1 mode tunnel...
Page 304: Cisco Router Configuration
SmartWare Software Configuration Guide 26 • VPN configuration session-key outbound esp-encryption FEDCBA0987654321FEDCBA0987654321FEDCBA0987654321 spi inbound esp 7777 spi outbound esp 8888 peer 200.200.200.1 mode tunnel For the remainder of the conﬁguration (see above), just change the name of the IPsec policy proﬁle in the ACL proﬁle VPN_Out Cisco router conﬁguration crypto ipsec transform-set 3DES_MD5 esp-3des esp-md5-hmac...
Page 305: Cs Context Overview
Chapter 27 CS context overview Chapter contents Introduction ................................306 CS context configuration task list ........................307 Planning the CS configuration ..........................307 Configuring general CS settings...........................309 Configuring call routing ............................310 Creating and configuring CS interfaces........................311 Specify call routing ............................311 Configuring dial tones ............................312 Configuring voice over IP parameters ........................312...
Page 306: Introduction
SmartWare Software Configuration Guide 27 • CS context overview Introduction This chapter gives an overview of the circuit-switching (CS) context and associated components, and describes the tasks involved in its conﬁguration. It describes the steps needed conﬁgure voice connectivity, and refers to other chapters where a conﬁguration topic is explained in more detail.
Page 307: Cs Context Configuration Task List
SmartWare Software Configuration Guide 27 • CS context overview The CS context and its associated components route and establish voice calls. For example, the signaling for dial-up circuits is routed and the corresponding voice call circuits are switched between PSTN interfaces and via VoIP interfaces to the VoIP gateways and the IP context (see section “Conﬁguring call routing”...
Page 308 SmartWare Software Configuration Guide 27 • CS context overview Figure 43 shows a typical application with a remote ofﬁce in an enterprise network. The example focuses on the SmartNode in the remote ofﬁce. There is an ISDN phone, a personal computer, a connection to the public ISDN network, and a connection to the IP backbone.
Page 309: Configuring General Cs Settings
SmartWare Software Configuration Guide 27 • CS context overview Note Be careful when choosing where you get your clock source, if the clock used for packaging the ISDN voice frames is not synchronized with the remote ISDN clock, bit errors may result (such synchronization problems would probably cause a fax transmission to fail).
Page 310: Configuring Call Routing
SmartWare Software Configuration Guide 27 • CS context overview Mode: System Step Command Purpose node (sys)#clock-source internal Generates the reference clock internally or speciﬁes a speciﬁc port to receive the node (sys)#clock-source slot-number port-number reference clock. node (sys)#ic voice slot-number Changes to ic_voice mode.
Page 311: Creating And Configuring Cs Interfaces
SmartWare Software Configuration Guide 27 • CS context overview SIP GW SIP GW H.323 GW H.323 GW A party B party Context IP Context IP router H.323 Interface H.323 Interface router Context CS Context CS switch switch ISDN Interface ISDN Interface IP Interface IP Interface Ethernet Port...
Page 312: Configuring Dial Tones
SmartWare Software Configuration Guide 27 • CS context overview Basic interface routing allows you to forward all incoming calls on a CS interface directly to a destination CS interface. The call router allows you to route calls to all available CS interfaces, based on a call property such as calling number, destination number and ISDN bearer capability and many more.
Page 313: Configuring Isdn Ports
SmartWare Software Configuration Guide 27 • CS context overview Conﬁguring ISDN ports BRI and E1/T1 ports represent physical ports on the SmartNode. The conﬁguration of the ISDN ports depends on the port type (BRI, E1 or T1), and on the connected voice device. To conﬁgure the ISDN ports, refer to chapter 36, “ISDN port conﬁguration”...
Page 314: Activating Cs Context Configuration
SmartWare Software Configuration Guide 27 • CS context overview Activating CS context conﬁguration After conﬁguring the CS context and its components, the conﬁguration must be activated. This includes bind- ing the physical ports to the CS interfaces and enabling the gateways, ports, and the CS context. In order to become functional, each interface must be bound from one port from which it receives incoming calls, and to which it forwards outgoing calls.
Page 315 SmartWare Software Configuration Guide 27 • CS context overview Mode: Context CS Step Command Purpose Show the CS context configuration. node (ctx-cs)[switch]#show call-router config detail level Level could be 1..5. Level 1 shows less, level 5 shows all information. node (ctx-cs)[switch]#debug call-router detail level Enable the call-router debug monitor.
Page 316: Smartnode In An Enterprise Network
SmartWare Software Configuration Guide 27 • CS context overview 02:14:30 > Updating tables in 3 seconds... 02:14:33 > [switch] Reloading tables now 02:14:33 > [switch] Flushing all tables 02:14:33 > [switch] Loading table 'TAB-ISDN-SERVICE' 02:14:33 > [switch] Loading table 'TAB-DEST-A' 02:14:33 >...
Page 317: Planning The Cs Context
SmartWare Software Configuration Guide 27 • CS context overview • Calls from ofﬁce A or B with number 5xx to ofﬁce C • All other calls from ofﬁce A or B to the PSTN (local breakout) Gateway H.323 H.323 interface: IF-COMPOFF-A H.323 interface: IF-COMPOFF-B Session Router...
Page 318: Configuring General Cs Settings
SmartWare Software Configuration Guide 27 • CS context overview • We enable DTMF relay and specify codec G.723. (Refer to section “Conﬁguring voice over IP parameters” on page 312). • We deﬁne H.323 direct call signaling. (Refer to section “Conﬁguring an H.323 VoIP connection” page 313).
Page 319 SmartWare Software Configuration Guide 27 • CS context overview Finally, we conﬁgure the call router. Here we create a routing table that examines the called party number of a call and routes numbers starting with a 1 and containing at least 3 digits to the hunt group that tries to reach company ofﬁce A over VoIP and falls back to the PSTN.
Page 320: Configuring Voip Settings
SmartWare Software Configuration Guide 27 • CS context overview node(rt-tab)[HUNT-PU~]#cyclic node(rt-tab)[HUNT-PU~]#route call 1 dest-interface IF-PUBLIC-PSTN1 node(rt-tab)[HUNT-PU~]#route call 2 dest-interface IF-PUBLIC-PSTN2 node(rt-tab)[HUNT-PU~]#exit node(ctx-cs)[switch]#exit node(cfg)# Conﬁguring VoIP settings Because we need G.723 as codec we enable DTMF relay: node(cfg)#profile voip H323-VOIP-PROFILE node(pf-voip)[H323-VO~]#codec 1 g723-6k3 node(pf-voip)[H323-VO~]#dtmf-relay node(pf-voip)[H323-VO~]#exit node(cfg)#...
Page 321: Configuring An H.323 Voip Connection
SmartWare Software Configuration Guide 27 • CS context overview node(q931)[2/2]#uni-side user node(q931)[2/2]#encapsulation cc-isdn node(q931)[2/2]#bind interface IF-PBX1 node(q931)[2/2]#exit node(q921)[2/2]#exit node(prt-bri)[2/2]#no shutdown node(cfg)#port bri 2 1 node(prt-bri)[2/3]#q921 node(q921)[2/3]#q931 node(q921)[2/3]#protocol pp node(q931)[2/3]#uni-side user node(q931)[2/3]#encapsulation cc-isdn node(q931)[2/3]#bind interface IF-PBX1 node(q931)[2/3]#exit node(q921)[2/3]#exit node(prt-bri)[2/3]#no shutdown Conﬁguring an H.323 VoIP connection Next we conﬁgure call signaling: node(cfg)#gateway h323 h323 node(gw-h323)[h323]#no ras...
Page 322 SmartWare Software Configuration Guide 27 • CS context overview Table switch/IF-COMPOFF-A-precall-service: Value Function Dest-Type Dest-Name ------------------------------------------------------------------------------- dest-table TAB-CALLED-NUMBER Table switch/IF-COMPOFF-B-precall-service: Value Function Dest-Type Dest-Name ------------------------------------------------------------------------------- dest-table TAB-CALLED-NUMBER Table switch/TAB-CALLED-NUMBER: Value Function Dest-Type Dest-Name called-e164 ------------------------------------------------------------------------------- dest-service HUNT-COMPOFF-A dest-service HUNT-COMPOFF-B dest-service HUNT-PBX default dest-service...
Page 323: Showing The Running Configuration
SmartWare Software Configuration Guide 27 • CS context overview 02:30:28 > [switch] Loading table 'IF-PUBLIC-PSTN2-precall-service' 02:30:28 > [switch] Loading table 'IF-COMPOFF-A-precall-service' 02:30:28 > [switch] Loading table 'IF-COMPOFF-B-precall-service' 02:30:28 > [switch] Loading table 'TAB-CALLED-NUMBER' node(ctx-cs)[switch]# Showing the running conﬁguration The conﬁguration script for our application looks as follows: cli version 3.00 system clock-source 2 3...
Page 324 SmartWare Software Configuration Guide 27 • CS context overview interface isdn IF-PUBLIC-PSTN1 route call dest-table TAB-CALLED-NUMBER interface isdn IF-PUBLIC-PSTN2 route call dest-table TAB-CALLED-NUMBER service hunt-group HUNT-COMPOFF-A timeout 5 drop-cause normal-unspecified drop-cause no-circuit-channel-available drop-cause network-out-of-order drop-cause temporary-failure drop-cause switching-equipment-congestion drop-cause access-info-discarded drop-cause circuit-channel-not-available drop-cause resources-unavailable route call 1 dest-interface IF-COMPOFF-A...
Page 325 SmartWare Software Configuration Guide 27 • CS context overview route call 1 dest-interface IF-PUBLIC-PSTN1 route call 2 dest-interface IF-PUBLIC-PSTN2 context cs switch no shutdown gateway h323 h323 faststart bind interface eth0 router no shutdown port ethernet 0 0 medium 10 half encapsulation ip bind interface eth0 router no shutdown...
Page 326 SmartWare Software Configuration Guide 27 • CS context overview port bri 2 1 no shutdown port bri 2 2 clock auto encapsulation q921 q921 protocol pp uni-side auto encapsulation q931 q931 protocol dss1 uni-side user encapsulation cc-isdn bind interface IF-PUBLIC-PSTN1 port bri 2 2 no shutdown port bri 2 3...
Page 327: Cs Interface Configuration
Chapter 28 CS interface conﬁguration Chapter contents Introduction ................................328 CS interface configuration task list ........................328 Creating and configuring CS interfaces........................329 Configuring call routing ............................330 Configuring the interface mapping tables ......................331 Configuring the precall service tables ........................334...
Page 328: Introduction
SmartWare Software Configuration Guide 28 • CS interface configuration Introduction This chapter provides an overview of interfaces in the CS context and describes the tasks involved in their con- ﬁguration. Within the CS context, an interface is a logical entity providing call signaling for incoming and out- going calls to and from telephony ports and voice over IP gateways.
Page 329: Creating And Configuring Cs Interfaces
SmartWare Software Configuration Guide 28 • CS interface configuration page 457 and chapter 41, “VoIP proﬁle conﬁguration” on page 517. To create and conﬁgure CS interfaces you have to perform the conﬁguration tasks listed below. • Creating and conﬁguring CS interfaces •...
Page 330: Configuring Call Routing
SmartWare Software Configuration Guide 28 • CS interface configuration The following example shows how to create and conﬁgure an interface, how to display it, and how to delete another. node>enable node#configure node(cfg)#context cs node(ctx-cs)[switch]#interface isdn IF-PBX1 node(if-pstn)[IF-PBX1]#route call dest-interface TAB-CALLED-NUMBER node(if-pstn)[IF-PBX1]#show call-control provider Provider: IF-PBX1 =================...
Page 331: Configuring The Interface Mapping Tables
SmartWare Software Configuration Guide 28 • CS interface configuration In the environment of the CS interfaces, it is necessary to specify whether the call will be routed directly to another CS interface (basic interface routing) or to a ﬁrst lookup table from the call router (advanced call rout- ing).
Page 332 SmartWare Software Configuration Guide 28 • CS interface configuration to another user agent having a different URI than the called one. This new URI as well as the derived E.164 number cannot be manipulated using the call router before presenting it to the other party. To circumvent this limitation, you can use mapping tables directly on an interface.
Page 333: Incoming Call Passing An Interface Mapping Table
SmartWare Software Configuration Guide 28 • CS interface configuration Mapping-Table: PRIV-TO-GLOB use (input) input property output property Context CS switch E.164 E.164 interface isdn IF-PHONES (..) 00419988825\1 Incoming Call #1 Incoming Call #1 Calling Calling E.164 E.164 0041998882520 Called Called E.164 E.164 0041998882521...
Page 334: Configuring The Precall Service Tables
SmartWare Software Configuration Guide 28 • CS interface configuration Mapping-Table: PRIV-TO-GLOB use (input) input property output property Context CS switch E.164 E.164 interface isdn IF-PHONES (..) 00419988825\1 Incoming Call Incoming Call Calling Calling E.164 E.164 0041998882520 Called Called E.164 E.164 0041998882521 Routing-Table: TAB-CALLED-NUMBER Outgoing Call...
Page 335 SmartWare Software Configuration Guide 28 • CS interface configuration • interrogate-cw—Detects whether or not the call-waiting supplementary service is active on the interface that uses the precall service table. Note Currently you can only use precall service tables on FXS interfaces. Procedure: To create precall service table and use it on an FXS interface Mode: Context CS Step...
Page 336: Isdn Interface Configuration
Chapter 29 ISDN interface conﬁguration Chapter contents Introduction ................................337 ISDN interface configuration task list........................337 Configuring DTMF dialing (optional) ......................338 Configuring an alternate PSTN profile (optional) ..................338 Configuring ringback tone on ISDN user-side interfaces ................339 Configuring call waiting (optional) .......................339 Disabling call-waiting on ISDN DSS1 network interfaces ................339 Configuring Call-Hold on ISDN interfaces ....................340...
Page 337: Introduction
SmartWare Software Configuration Guide 29 • ISDN interface configuration Introduction This chapter provides an overview of ISDN interfaces, and the tasks involved in their conﬁguration. This chap- ter does not explain the basic conﬁguration steps equal to all CS interfaces. Information about basic interface conﬁguration can be found in the general chapter about CS interface conﬁguration (see chapter 28, “CS inter- face conﬁguration”...
Page 338: Configuring Dtmf Dialing (Optional)
SmartWare Software Configuration Guide 29 • ISDN interface configuration Conﬁguring DTMF dialing (optional) Most ISDN terminals support two modes of call setup: En-bloc dialing and overlap dialing. En-bloc dialing transports the full called party information in the ﬁrst SETUP message from the terminal. This means that the user must dial the number before going off-hook.
Page 339: Configuring Ringback Tone On Isdn User-Side Interfaces
SmartWare Software Configuration Guide 29 • ISDN interface configuration Example: Conﬁgure an alternate PSTN proﬁle The following example shows how to replace the PSTN proﬁle default of the ISDN interface with the PSTN proﬁle myproﬁle. node>enable node#configure node(cfg)#context cs node(ctx-cs)[switch]#interface isdn myIsdnIf node(if-isdn)[myIsdnIf]#use profile pstn myprofile Conﬁguring ringback tone on ISDN user-side interfaces If a ring-back tone needs to be played towards the PSTN from an ISDN user-side interface, this can be forced...
Page 340: Configuring Call-Hold On Isdn Interfaces
SmartWare Software Configuration Guide 29 • ISDN interface configuration Conﬁguring Call-Hold on ISDN interfaces Normally, the call-hold feature is disabled on ISDN point-to-point links and enabled on ISDN point-to-mul- tipoint links. However, you can manually enable or disable the Call-Hold feature using the following com- mand: The default setting can be achieved using the ‘auto’...
Page 341: Enable Sending Of Date And Time On Isdn Dss1 Network Interfaces
SmartWare Software Configuration Guide 29 • ISDN interface configuration Enable sending of date and time on ISDN DSS1 network interfaces This procedure enables sending of date and time information on an ISDN network side interface. Mode: interface isdn <if-name> Step Command Purpose [ name ] (if-isdn)[ if-name ]# isdn-date-time...
Page 342 SmartWare Software Configuration Guide 29 • ISDN interface configuration Home Office Central Office te w u te v ic d ia ic e te w g ra n so n so P or ic e P or ic e E ne E ne E ne te w...
Page 343: Isdn Advice Of Charge Support
SmartWare Software Configuration Guide 29 • ISDN interface configuration The push-back mechanism can be conﬁgured on each interface separately. Per default push-back is enabled for ISDN and SIP interfaces. You only have to change the conﬁguration if you don’t want internally looped calls to be pushed back to the network.
Page 344 SmartWare Software Configuration Guide 29 • ISDN interface configuration The following procedure disables the reception of AOC messages from the network on an ISDN user interface. Step Command Purpose Go to the ISDN interface, for which you want to node (ctx-ip)[ctx- name ]# interface isdn disable AOC <if-name>...
Page 345 SmartWare Software Configuration Guide 29 • ISDN interface configuration there is no AOC information from the network. In that case a message containing the value noChargeAvailable is sent. Step Command Purpose Go to the ISDN network interface, for which you node (ctx-ip)[ctx- name ]# interface isdn want to enable AOC for all calls <if-name>...
Page 346 SmartWare Software Configuration Guide 29 • ISDN interface configuration The following table shows an overview of the AOC variants: aoc- x no aoc- x aoc- x automatic aoc- x explicit transparent Default option ISDN User Interface (connected to a PBX switch etc.) No message from No information for- No information for-...
Page 347: Isdn Divertingleginformation2 Facility
SmartWare Software Configuration Guide 29 • ISDN interface configuration ISDN DivertingLegInformation2 Facility SmartWare is now able to extract the redirecting information from the DiverstingLegInformation2 Facility and to provide them to the call control. In the other direction, the redirecting information can be sent as DiverstingLegInformation2 Facility in addition to the Redirecting Number Information Element.
Page 348 SmartWare Software Configuration Guide 29 • ISDN interface configuration • caller-name early-alerting <timeout>: This conﬁguration command speciﬁes the behaviour for incoming ISDN calls. Some networks only deliver the name after an alerting indication. These networks simulate the mid-ring name delivery feature of analog lines. If early alerting is enabled, we send back a faked ALERT- ING message after a conﬁgurable timeout when we receive a NameInformationFollowing indication.
Page 349 SmartWare Software Configuration Guide 29 • ISDN interface configuration Step Command Purpose (optional) If no name is present in an incoming node( if-isdn)#caller-name ignore- ISDN call and if the incoming SETUP message con- absence 1000 tains the NameInformationFollowing indication, we forward the call to the routing destination any- way after 1000ms (500ms after faking the ALERT- ING message in this example).
Page 350: Fxs Interface Configuration
Chapter 30 FXS interface conﬁguration Chapter contents Introduction ................................351 FXS supplementary services description.......................351 Call holding ..............................351 Call waiting ..............................351 Making a second call while holding first call ....................352 FXS interface configuration task list ........................353 Configuring a subscriber number (recommended) ..................353 Configuring an alternate PSTN profile (optional) ..................353 Configuring caller-ID presentation (optional)
Page 351: Introduction
SmartWare Software Configuration Guide 30 • FXS interface configuration Introduction This chapter provides an overview of FXS interfaces, and the tasks involved in their conﬁguration. This chapter does not explain the basic conﬁguration steps equal to all CS interfaces. Information about basic interface con- ﬁguration can be found in the general chapter about CS interface conﬁguration (see chapter 28, “CS interface conﬁguration”...
Page 352: Making A Second Call While Holding First Call
SmartWare Software Configuration Guide 30 • FXS interface configuration Note This feature is not used when the connected analog equipment is a fax, answering machine or similar device. Procedure: To reject a waiting call, when a waiting call is announced with a special tone signal, the user can either: •...
Page 353: Fxs Interface Configuration Task List
SmartWare Software Configuration Guide 30 • FXS interface configuration FXS interface conﬁguration task list This section describes the conﬁguration tasks for FXS interfaces. There is no mandatory conﬁguration for basic FXS operation—most conﬁguration commands refer to the use of supplementary services. Next to the basic CS interface settings, the following conﬁgurations can be made: •...
Page 354: Configuring Caller-Id Presentation (Optional)
SmartWare Software Configuration Guide 30 • FXS interface configuration There is a PSTN proﬁle named default, which always exists in the system. If no different PSTN proﬁle name is explicitly conﬁgured on the FXS interface, the proﬁle named default is used. Procedure: To deﬁne an alternate PSTN proﬁle for the FXS interface Mode: Interface FXS Step...
Page 355: Configuring Call Waiting Supplementary Service (Optional)
SmartWare Software Configuration Guide 30 • FXS interface configuration Procedure: To conﬁgure call holding Mode: Interface FXS Step Command Purpose Enables/Disables call holding supplementary ser- node (if-fxs)[ if-name ]#[no] call-hold vice (Default: enabled) Example: Disable call holding The following example shows how to disable call holding node>enable node#configure node(cfg)#context cs...
Page 356 SmartWare Software Configuration Guide 30 • FXS interface configuration Mode: Interface FXS Step Command Purpose Enables/Disables additional call offering supple- node (if-fxs)[ if-name ]#[no] additional- mentary service (Default: enabled) call-offering Example: Disable additional call offering The following example shows how to disable call holding node>enable node#configure node(cfg)#context cs...
Page 357: Fxo Interface Configuration
Chapter 31 FXO interface conﬁguration Chapter contents Introduction ................................358 FXO services description .............................359 Creating an FXO interface...........................359 Deleting an FXO interface...........................360 FXO interface configuration task list ........................361 FXO off-hook on caller ID ...........................361 Configuring an alternate PSTN profile (optional) ..................361 Configuring when the digits are dialed (optional) ..................362 Configuring the number of rings to wait before answering the call (optional)
Page 358: Introduction
SmartWare Software Configuration Guide 31 • FXO interface configuration Introduction This chapter provides an overview of FXO interfaces and the tasks involved in conﬁguring them. This chapter does not explain the basic conﬁguration steps common to all Context Switch (CS) interfaces. Information about basic interface conﬁguration can be found in chapter 28, “CS interface conﬁguration”...
Page 359: Fxo Services Description
SmartWare Software Configuration Guide 31 • FXO interface configuration FXO services description The wide variety of applications and services are supported through a rich feature set. The major characteristics and features are • 2-wire loop-start • Off-hook and ring detection supervision •...
Page 360: Deleting An Fxo Interface
SmartWare Software Configuration Guide 31 • FXO interface configuration Once you are in the Context CS mode, you can enter the FXO conﬁguration mode with the next steps. Step Prompt & command Purpose node(ctx-cs)[switch]#interface fxo name The “interface fxo” command creates the new interface name, which represents an FXO inter- face.
Page 361: Fxo Interface Configuration Task List
SmartWare Software Configuration Guide 31 • FXO interface configuration FXO interface conﬁguration task list There are numerous conﬁgurable parameters that apply to the FXO interface. The basic commands are listed with a short description of their function. • ring-number on-caller-id— Determines if the FXO interface will go off-hook upon reception of a speci- ﬁed caller-ID.
Page 362: Configuring When The Digits Are Dialed (Optional)
SmartWare Software Configuration Guide 31 • FXO interface configuration Mode: Interface FXO Step Prompt, command & response Purpose Basic prompt in Operator Exec mode node> Enters Administration execution mode node>enable Response: The prompt in administration execu- node# tion mode is the # Enters the Configure configuration mode node#configure Response: The prompt in the Configure configu-...
Page 363 SmartWare Software Configuration Guide 31 • FXO interface configuration Mode: Interface FXO Step Prompt, command & response Purpose Basic prompt in Operator node> Exec mode Enters Administration execu- node>enable tion mode Response: The prompt in node# administration execution mode is the # Enters the Configure configu- node#configure ration mode...
Page 364: Configuring The Number Of Rings To Wait Before Answering The Call (Optional)
SmartWare Software Configuration Guide 31 • FXO interface configuration Note Verify that you have conﬁgured the dial-tone for the country in which the SmartNode is installed. (see chapter 35, “Tone conﬁguration” on page 457). If the dial-tone is not conﬁgured for the proper country, the FXO interface will not detect when the remote FXS switch is sending dial-tone.
Page 365: Configuring How To Detect A Call Has Disconnected (Optional)
SmartWare Software Configuration Guide 31 • FXO interface configuration Conﬁguring how to detect a call has disconnected (optional) When a call has disconnected, the FXO interface may detect and verify the termination of the phone call by three different methods. •...
Page 366: Configuring How To Detect An Outgoing Call Is Connected (Optional)
SmartWare Software Configuration Guide 31 • FXO interface configuration Conﬁguring how to detect an outgoing call is connected (optional) An FXO interface has the following methods for verifying the connection of an outgoing call after the dialing has been completed: •...
Page 367: Configuring The Destination Of The Call
SmartWare Software Configuration Guide 31 • FXO interface configuration Conﬁguring the destination of the call The last command in conﬁguring the FXO Interface is the route command. This command conﬁgures the call router. You can conﬁgure the routing-destination for call setup and for service activation. For complete details, see chapter 34, “Call router conﬁguration”...
Page 368: Fxo Interface Examples
SmartWare Software Configuration Guide 31 • FXO interface configuration FXO interface examples Example 1: Conﬁguring an FXO interface which is to be connected to a PSTN network for analog line exten- sion over IP. The FXS switch provides caller-id between the ﬁrst and second ring and uses battery reversal to indicate a connected call.
Page 369: 323 Interface Configuration
Chapter 32 H.323 interface conﬁguration Chapter contents Introduction ................................370 H.323 interface configuration task list .........................370 Binding the interface to an H.323 gateway ....................371 Configuring an alternate VoIP profile (optional) ...................372 Configuring CLIP/CLIR support (optional) ....................373 Enabling ‘early-proceeding’ on H.323 interfaces ...................374 Enabling the early call disconnect (optional) ....................374...
Page 370: Introduction
SmartWare Software Configuration Guide 32 • H.323 interface configuration Introduction This chapter provides an overview of H.323 interfaces used by H.323 gateways and describes the speciﬁc tasks involved in their conﬁguration. This chapter does not explain the basic conﬁguration steps required for all CS interfaces.
Page 371: H.323 Interface Configuration Task List
SmartWare Software Configuration Guide 32 • H.323 interface configuration • Conﬁguring information transfer capability handling (optional) • Conﬁguring CLIP/CLIR support (optional) • Enabling the early-proceeding feature for call setup • Enabling the early call disconnect (optional) • Enabling the via address support (optional) •...
Page 372: Configuring An Alternate Voip Profile (Optional)
SmartWare Software Configuration Guide 32 • H.323 interface configuration The following example shows how to associate an H.323 interface named MyH323If with a remote H.323 entity, which has the IP address 1.2.3.4 node>enable node#configure node(cfg)#context cs node(ctx-cs)[switch]#interface h323 MyH323If node(if-h323)[myh323if]#remoteip 1.2.3.4 Conﬁguring an alternate VoIP proﬁle (optional) Normally, the VoIP proﬁle deﬁned in the H.323 gateway is used for all the calls over that gateway.
Page 373: Configuring Clip/Clir Support (Optional)
SmartWare Software Configuration Guide 32 • H.323 interface configuration Mode: Interface H.323 Step Command Purpose Speciﬁes the information transfer capability to node ( if- h323 )[ if-name ]#itc rx {3k1- be used for calls from the H.323 gateway to audio | 7k-audio | restricted-digital | another gateway of the system (incoming unrestricted-digital | speech | video | calls).
Page 374: Enabling 'Early-Proceeding' On H.323 Interfaces
SmartWare Software Configuration Guide 32 • H.323 interface configuration Mode: Interface H.323 Step Command Purpose node ( if- h323 )[ if-name ]#clip-clir-support Enables CLIP/CLIR support on the H.323 interface Example: Enable CLIP/CLIR support The following example shows how to enable CLIP/CLIR support on the H.323 interface MyH323If. node>enable node#configure node(cfg)#context cs...
Page 375: Enabling The Via Address Support (Optional)
SmartWare Software Configuration Guide 32 • H.323 interface configuration Example: Enable early call disconnect The following example shows how to enable early call disconnect on an H.323 interface named MyH323If. node>enable node#configure node(cfg)#context cs node(ctx-cs)[switch]#interface h323 MyH323If node(if-h323)[MyH323If]#early-disconnect Enabling the via address support (optional) Some LAN Voice applications require the H.323 gateway to add the calling party number of the connected terminal as an H.323 E.164 Alias to the Facility message when transferring a call to another gateway.
Page 376: Configuring Status Inquiry Settings (Optional)
SmartWare Software Configuration Guide 32 • H.323 interface configuration Example: Specifying an alternate destination call-signaling port The following example shows how to set the destination call-signaling port number for the H.323 interface MyH323If to 2300. node>enable node#configure node(cfg)#context cs node(ctx-cs)[switch]#interface h323 MyH323If node(if-h323)[MyH323If]#remoteport 2300 Conﬁguring status inquiry settings (optional) Normally, the H.323 gateway will send out status inquiries every minute on each connected H.323 call.
Page 377: Enabling Or Disabling Overlapped Sending Support In H.323
SmartWare Software Configuration Guide 32 • H.323 interface configuration The following example the status inquiry interval for the H.323 interface MyH323If to 120 seconds. node>enable node#configure node(cfg)#context cs node(ctx-cs)[switch]#interface h323 MyH323If node(if-h323)[MyH323If]#status-inquiry timeout 120 Enabling or disabling overlapped sending support in H.323 This procedure disables support for overlapped sending on an H.323 interface.
Page 378 SmartWare Software Configuration Guide 32 • H.323 interface configuration Step Command Purpose node(if-h323)[if-name]# [no] aoc-d emit Enables or disables transmission of AOC-D information in FACILITY messages received from the other side of the gateway. Default: Transmission is disabled. When enabled, the H.323 gateway sends FACILITY messages containing AOC-D PDUs whenever the charge of a call changes.
Page 379: Sip Interface Configuration
Chapter 33 SIP interface conﬁguration Chapter contents Introduction ................................380 SIP interface configuration task list........................380 Binding the interface to a SIP gateway ......................381 Configure a remote host ..........................381 Configuring an alternate VoIP profile (Optional) ..................382 Configuring early call connect / disconnect (optional) ..................383 Configuring a phone context (optional) ......................383...
Page 380: Introduction
SmartWare Software Configuration Guide 33 • SIP interface configuration Introduction This chapter provides an overview of SIP interfaces used by SIP gateways and describes the speciﬁc tasks involved in their conﬁguration. This chapter does not explain the basic conﬁguration steps required for all CS interfaces.
Page 381: Binding The Interface To A Sip Gateway
SmartWare Software Configuration Guide 33 • SIP interface configuration • Conﬁgure early call connect / disconnect (Optional) • Conﬁgure a phone context (Optional) • Mapping call-control properties to SIP headers • Enabling support for SIP remote-party-id headers • Conﬁguring ISDN redirecting number tunneling over SIP (optional) •...
Page 382: Configuring An Alternate Voip Profile (Optional)
SmartWare Software Configuration Guide 33 • SIP interface configuration Mode: Interface SIP Step Command Purpose node (if-sip)[ if-name ]#remoteip ip-address Deﬁnes the IP address or DNS hostname of the remote SIP entity, for which this interface shall be used. Examples: Deﬁne the remote SIP entity using an IP address The following example shows how to associate a SIP interface named MySipIf with a remote SIP entity, which has the IP address 1.2.3.4 node>enable...
Page 383: Configuring Early Call Connect / Disconnect (Optional)
SmartWare Software Configuration Guide 33 • SIP interface configuration node(if-sip)[MySipIf]#use profile voip myprofile Conﬁguring early call connect / disconnect (optional) Normally, SIP calls are fully connected by sending a 200 OK response to the INVITE request, if the called party answers the call. Any call progress tones or announcements are transmitted in the early SIP dialog. There are however several SIP user agents, which do not support media to be transmitted or received in an early dia- log.
Page 384: Mapping Call-Control Properties To Sip Headers
SmartWare Software Configuration Guide 33 • SIP interface configuration Procedure: To deﬁne a phone context for the SIP interface Mode: Interface SIP Step Command Purpose node (if-sip)[ if-name ]#phone-context Specify a phone context for the interface Example: Conﬁgure a phone-context The following example shows how to conﬁgure a phone-context named mycompany for the SIP interface MySipIf.
Page 385: Configuring Isdn Redirecting Number Tunneling Over Sip
SmartWare Software Configuration Guide 33 • SIP interface configuration address-translation commands map as shown in the following two examples. Example 1: Address-translation incoming-call <call-control header> mapping <SIP-header> Example 2: Address-translation outgoing-call <SIP-header> mapping <call-control header> In two more examples, the ﬁrst line maps the to-header contents of the inbound call to the called-e164 prop- erty of the call control, while the second line maps the request header contents to the called-name property of the call-control.
Page 386: Enabling Support For Sip Remote-Party-Id Headers
SmartWare Software Configuration Guide 33 • SIP interface configuration Mode: interface sip Step Command Purpose Enables Redirecting Party Number Tunneling node (if-sip)[if- name ]# address-transla- ISDN ‡ SIP: Enables transmission of the target tion outgoing-call request-uri target- and cause parameters in the Request-URI for param call redir outgoing SIP calls.
Page 387: Sip Refer Transmission (& Isdn Explicit Call Transfer Support)
SmartWare Software Configuration Guide 33 • SIP interface configuration The type of header sent depends on the screening-indicator property of the call-control. When receiving one of these privacy headers the screening-indicator is also set depending on the received header type. Mode: Context CS Step Command...
Page 388 SmartWare Software Configuration Guide 33 • SIP interface configuration Figure 57 shows an example scenario where a SIP network connects two devices to give a home ofﬁce access to a PBX in the central ofﬁce. Home Office Central Office te w u te v ic d ia...
Page 389: Sip Diversion Header
SmartWare Software Configuration Guide 33 • SIP interface configuration The push back mechanism over ISDN (using ECT) and SIP (using REFER) works independently of the pro- tocol that invoked the call-transfer. For example, the same scenario also works if the phone in the home ofﬁce is connected to an FXS port.
Page 390: Receive Direction
SmartWare Software Configuration Guide 33 • SIP interface configuration Mode: interface sip <interface> Step Command Purpose [ name ] (if-sip)[ interface ]#address-transla- Enables or disables sending of the Diversion Header and speciﬁes the Host Part of the URI. tion outgoing-call diversion-header call: If available, the Host Part of the calling host-part {call | default-server | domain from-header will be taken else the local ip...
Page 391: Aoc Over Sip
SmartWare Software Configuration Guide 33 • SIP interface configuration AOC Over SIP This enhancement allows sending AOC information transparently from ISDN (or H.323) to SIP and vice- versa. AOC-D elements are hex-encoded and sent as application/QSIG content in SIP INFO messages during a session.
Page 392: Call Router Configuration
Chapter 34 Call router conﬁguration Chapter contents Introduction ................................394 Call router configuration task list.........................396 Map out the goals for the call router ......................396 Enable advanced call routing on circuit interfaces ..................397 Configure general call router behavior ......................397 Configure address completion timeout ....................397 Configure default digit collection timeout and terminating character ............398...
Page 393 SmartWare Software Configuration Guide 34 • Call router configuration Egress Interface ............................431 Creating call services .............................433 Creating a hunt group service ........................433 Creating a distribution group service ......................442 Distribution-Group Min-Concurrent setting ....................444 Call-router ‘limiter’ service ..........................444 Priority service ..............................445 CS Bridge service—‘VoIP Leased Line’ ......................447 Deleting call services .............................449...
Page 394: Introduction
SmartWare Software Configuration Guide 34 • Call router configuration Introduction This chapter provides an overview of call router tables, mapping tables and call services and describes the tasks involved in conﬁguring the call router in SmartWare. This chapter includes the following sections: •...
Page 395: Direct Call Routing Vs. Advanced Call Routing
SmartWare Software Configuration Guide 34 • Call router configuration service is an example for a call service. Figure 58 illustrates direct call and advanced call routing. In this chapter, advanced call routing is explained. For conﬁguring direct call routing refer to chapter 34, “Call router conﬁgu- ration”...
Page 396: Call Router Configuration Task List
SmartWare Software Configuration Guide 34 • Call router configuration • Time of day; hour:minute:second • Date; day.month.year The call router allows you to solve practically any call routing and call property manipulation requirement that you may have. The call router is very ﬂexible in allowing the construction of IMPORTANT decision trees based on linked routing tables.
Page 397: Enable Advanced Call Routing On Circuit Interfaces
SmartWare Software Configuration Guide 34 • Call router configuration The call router is able to accommodate almost every combination of these requirements through a customized conﬁguration. In order to keep this conﬁguration compact we recommend that you ﬁrst deﬁne the routing requirements and restrictions that apply to your installation.
Page 398: Configure Default Digit Collection Timeout And Terminating Character
SmartWare Software Configuration Guide 34 • Call router configuration Mode: Context CS Step Command Purpose node (ctx-cs)[ switch ]# Conﬁgures the address completion timeout by specifying the timeout in seconds. If not conﬁg- address-completion timeout timeout ured, the default address completion timeout is 12 seconds.
Page 399: Configure Number Prefix For Isdn Number Types
SmartWare Software Configuration Guide 34 • Call router configuration Example: Conﬁgure address completion timeout node[switch]#digit-collection timeout 3 node[switch]#digit-collection terminating-char * Conﬁgures the digit collection timeout to 3s. The digit-collection timeout can be stopped by the user entering the asterisk (*) character. Conﬁgure number preﬁx for ISDN number types The called and calling party numbers in an ISDN signaling message are of a deﬁned number type;...
Page 400: Configure Call Routing Tables
SmartWare Software Configuration Guide 34 • Call router configuration Conﬁgure call routing tables Routing tables are identiﬁed by names that can be any arbitrary string. For ease of identiﬁcation the table type is typically used as part of the name. Call router tables are created by entering the routing-table command, which also brings you into the routing...
Page 401 SmartWare Software Configuration Guide 34 • Call router configuration Table 16. Routing table types (Continued) Type Description calling-e164 Route calls based on the calling party E.164 number. Entries of calling-e164 tables can use wildcards to summarize routes. called-type-of-number Route calls based on the called party number type. ISDN distinguishes different type of numbers.
Page 402: Called Party Number Routing Table
SmartWare Software Configuration Guide 34 • Call router configuration Mode: Context CS Step Command Purpose node(ctx-cs)[switch]#routing-table Create a routing table table-name of the speciﬁed table-type . table-type table-name This enters the table mode where entries can be added or removed. To enter a previously created table from the context CS mode, you may leave away the table-type .
Page 403: Wildcard Symbols Used As Keys In E.164 Tables (Calling-E164, Called-E164)
SmartWare Software Configuration Guide 34 • Call router configuration The following table shows the wildcard characters that are supported: Table 17. Wildcard symbols used as keys in E.164 tables (calling-e164, called-e164) Symbol Description Indicates a single-digit placeholder. For example, 888 ..matches any dialed number beginning with 888, plus at least four additional digits.
Page 404: Digit Collection
SmartWare Software Configuration Guide 34 • Call router configuration The next table shows some examples of how these wildcard symbols are applied to the key of a table entry: Table 18. Wildcard symbols used as keys in E.164 tables (calling-e164, called-e164) Expression Description 88825.+...
Page 405: Digit Collection Variants
SmartWare Software Configuration Guide 34 • Call router configuration The default value for the interdigit timeout is 5 seconds and can be conﬁgured using the digit-collection command in the context CS conﬁguration mode. You may want to override this default timeout for a timeout speciﬁc entry.
Page 406 SmartWare Software Configuration Guide 34 • Call router configuration digits, the address completion timeout elapses and the call is dropped. The digit collection timeout is active when a route is complete but a T-indicator is speciﬁed on the selected route, e.g. when the dialed number of 0991 is tried to match the entry 099T.
Page 407 SmartWare Software Configuration Guide 34 • Call router configuration route default dest-interface IF5entry #5 Note The numbers that are normally dialed are longer than the preﬁxes listed in the table test. For example, if the numbering plan is deﬁned using ﬁve digits, a user normally dials a number like 12345 to reach a destination.
Page 408: Calling Party Number Routing Table
SmartWare Software Configuration Guide 34 • Call router configuration Dialed Selected Description Number Entry Entry #1 and #2 match the dialed number of 121, but entry #2 matches better. The call is immediately placed to IF2. Only entry #1 matches the dialed number of 191. Thus the call is routed immediately to interface IF1.
Page 409: Numbering Plan Routing Table
SmartWare Software Configuration Guide 34 • Call router configuration Note When you speciﬁed a national or international preﬁx using the commands national-preﬁx or international-preﬁx respectively. in the context CS conﬁg- uration mode, the calling or called party number is extended with the speci- ﬁed preﬁx and the type-of-number is set to unknown in the incoming interface.
Page 410: Name Routing Table
SmartWare Software Configuration Guide 34 • Call router configuration The call router can route calls according to the following numbering plans. These values beside default can be used for the key parameter to create a routing table entry: • unknown—Unknown numbering plan. This is the default value for calls that arrive through an interface that does not support the numbering plan property.
Page 411: Uri Routing Table
SmartWare Software Configuration Guide 34 • Call router configuration You may specify a whole subnet with the key parameter of the routing table entry. The format of the key parameter is ipaddress[/mask-size]; the mask size may be omitted. Note Incoming SIP and H.323 calls use the calling party IP address property to store the IP address of the remote SIP user agent or H.323 terminal, respec- tively.
Page 412: Screening Indicator Routing Table
SmartWare Software Configuration Guide 34 • Call router configuration Note Incoming ISDN calls set the presentation indicator according to the received ISDN Setup message. Incoming H.323 calls only set the presentation indi- cator transparently when Octet3a handling is enabled. Other interfaces set the presentation indicator to allowed.
Page 413: Information Transfer Capability Routing Table
SmartWare Software Configuration Guide 34 • Call router configuration The call router can route calls according to the following screening indicators. These values beside default can be used for the key parameter to create a routing table entry: • user-not-screened—The calling party number is provided by the user but not screened by the network. Thus the calling party possibly send a number that is not owned by the calling party.
Page 414: Call-Router Support For Redirecting Number And Redirect Reason
SmartWare Software Configuration Guide 34 • Call router configuration The call router can route calls according to the following information transfer capabilities. These values beside default can be used for the key parameter to create a routing table entry: • speech—Voice terminals (Telephones) •...
Page 415: Time Of Day Routing Table
SmartWare Software Configuration Guide 34 • Call router configuration • default: Any other unhandled case Mode: context cs Step Command Purpose [ name ] (ctx-cs)[ router ]# routing-table Creates a redirect reason routing table. calling-redir-reason <table-name> Both the redirecting-number and the redirect-reason can also be used in any call-router mapping tables. Time of day routing table The time table is used to route calls based upon the current system time during one day, i.e.
Page 416: Deleting Routing Tables
SmartWare Software Configuration Guide 34 • Call router configuration node(rt-tab)[HOLIDAY~]#route default dest-interface IF-VOIP Deleting routing tables To remove individual routing tables you can use the form of the command. Alternatively routing table you can remove speciﬁc entries of a routing table by entering the routing table conﬁguration mode and use the form of the command.
Page 417: Configure Mapping Tables
SmartWare Software Configuration Guide 34 • Call router configuration Mode: Context CS Step Command Purpose node (ctx-cs)[ switch ]#no routing-table Delete the routing table table-name . table-name Note: You do not have to enter the type of the table when just deleting it.
Page 418: Mapping Table Types
SmartWare Software Configuration Guide 34 • Call router configuration You can create a mapping table that examines and modiﬁes a speciﬁc kind of property, e.g. the called party number. In this case you have to specify an input-type of called-e164 and an output-type of called-164. If you want to replace both, the called and the calling party property with the same mapping table, you can create a mapping table with input-type e164 and output-type e164, i.e.
Page 419 SmartWare Software Configuration Guide 34 • Call router configuration Table 19. Mapping table types (Continued) Type Description Input-Type Description Output-Type called-name Selects an entry based on the display name Sets the display name of the called of the called party. party.
Page 420: Mapping Table Examples
SmartWare Software Configuration Guide 34 • Call router configuration Let’s examine the mechanism of mapping tables in more detail. Figure 61 shows three mapping tables and a call that is routed through this mapping table. The call contains various call properties that are examined and modiﬁed by the mapping tables: Example #1 Mapping-Table...
Page 421: E.164 To E.164 Mapping Tables
SmartWare Software Configuration Guide 34 • Call router configuration Example #4: This example shows the same input call properties as in example #3. The mapping table is also almost the same, but unlike in the previous example, here we don’t look for a speciﬁc number type (e.g. called party number, calling party number), but for any E.164 number property of the call.
Page 422 SmartWare Software Configuration Guide 34 • Call router configuration Detailed Example: You have an internal dial plan that uses three digit numbers starting with a 2 (e.g. 200, 201, etc.). So when an internal subscriber makes a call, its calling party number contains three digits. 1.
Page 423 SmartWare Software Configuration Guide 34 • Call router configuration The input *50998882525 matches the expression *5(.%) – the preﬁx *5 followed by any character repeated zero or more times. The ﬁrst bracket encloses the number after the preﬁx: *5(.%) == *5(0998882525) -> \1 = 0998882525 The output is built from the ﬁrst bracket \1.
Page 424: Custom Sip Uris From Called-/Calling-E164 Properties
SmartWare Software Configuration Guide 34 • Call router configuration The input called party number 0778881111 matches the expression (.%) – any character repeated zero or more times. The ﬁrst bracket encloses the last whole called party number: (.%) == (0778881111) -> \1 = 0778881111 The output (calling party number) is built from the ﬁrst bracket \1.
Page 425: Deleting Mapping Tables
SmartWare Software Configuration Guide 34 • Call router configuration node(cfg)#context cs node(ctx-cs)[switch]#mapping-table called-type-of-number to called-type-of-number SET-INT node(rt-tab)[SET-INT]#map default to international Any called party number type matches the default entry. Note that the input-type of the table does not matter when the mapping table contains only the default entry. Anyway an input-type must be speciﬁed when creat- ing the mapping table.
Page 426: Creating Complex Functions
SmartWare Software Configuration Guide 34 • Call router configuration Example: Remove entries from a mapping table The running-conﬁg shows the following table: mapping-table called-e164 to called-e164 MY-TABLE map 10 to 20 map 11 to 21 map 12 to 22 map 13 to 23 To remove the ﬁrst two entries from the table enter the following commands: node(cfg)#context cs node(ctx-cs)[switch]#mapping-table MY-TABLE...
Page 427: Deleting Complex Functions
SmartWare Software Configuration Guide 34 • Call router configuration Mode: Context CS Step Command Purpose node (ctx-cs)[ switch ]#complex- Create a complex function function-name . function function-name node(func)[function-name]#execute Add or inserts an entry to the complex function. function can function be another complex function or a mapping table that shall be executed.
Page 428: Digit Collection & Sending-Complete Behavior
SmartWare Software Configuration Guide 34 • Call router configuration To remove the ﬁrst two entries from the complex function enter the following commands. Pay attention on the index. When removing the ﬁrst entry, the MAP2 function becomes entry with index 1. Thus you have to spec- ify index 1 twice to remove the ﬁrst two entries: node(cfg)#context cs node(ctx-cs)[switch]#complext-function MY-FUNC...
Page 429: Call-Router
SmartWare Software Configuration Guide 34 • Call router configuration The possible values for the type argument are: • transparent: Transparently passes an address-complete indication (e.g. ISDN Sending Complete Informa- tion Element) to the call-control. • set: Always sets the address-complete indication ﬂag towards the call-control even when no such indication is received from the calling party.
Page 430 SmartWare Software Configuration Guide 34 • Call router configuration The following table shows the different digit-collection timeout conﬁgurations and their effect on a T-termi- nated route when the digit-collection timeout elapses. Important settings are marked bold. Digit Collection Timeout Egress Properties (Result Ingress Properties Conﬁguration of call-routing)
Page 431: Egress Interface
SmartWare Software Configuration Guide 34 • Call router configuration not the egress interface propagates the address-complete indication depends on the interface conﬁguration (see below). The next table shows the different digit-collection terminating-character conﬁgurations and their effect on a T- terminated route when the terminating-character is received. Digit Collection Terminating-Char Egress Properties Ingress Properties...
Page 432 SmartWare Software Configuration Guide 34 • Call router configuration The possible values for the type argument are: • transparent: Transparently passes an address-complete indication to the signaling-protocol (e.g. ISDN by sending a Sending Complete Information Element). • set: Always sends a Sending Complete Information Element with the SETUP message. This conﬁguration can be used to disable overlap-sending on an interface.
Page 433: Creating Call Services
SmartWare Software Configuration Guide 34 • Call router configuration Step Command Purpose node (rt-tab)[tab- name ]#exit Leaves the routing table conﬁguration mode and returns to the context cs conﬁguration mode node (cts-cs)[ ctx-name ]#digit-col- Conﬁgures the digit-collection timeout to 5 seconds and sets lection timeout 5 set-address- the address-complete indication if the timeout elapses complete-indication...
Page 434: Hunt Group Service
SmartWare Software Configuration Guide 34 • Call router configuration interfaces IF-BRI0 up to IF-BRI3. All four ISDN interfaces lead to the same provider. Since the call router does not know the load on the BRIs, it has to be able to try BRI0 and, if BRI0 already serves two calls, use BRI1, and so on.
Page 435 SmartWare Software Configuration Guide 34 • Call router configuration Note Unlike previous versions of SmartWare, now you can hunt a call over differ- ent interface types, not only over ISDN interfaces. You can, e.g. create a hunt group to try to call over a H.323 interface and, if this call fails, do a fallback to an ISDN interface.
Page 436: Hunt Group Drop Causes
SmartWare Software Configuration Guide 34 • Call router configuration The following table lists all drop causes and speciﬁes whether the cause is used for hunting the next destination or dropping the original call. The behavior can be conﬁgured for each hunt group individually for each cause using the command in the hunt group service mode.
Page 437 SmartWare Software Configuration Guide 34 • Call router configuration Table 20. Hunt group drop causes (Continued) Default Behavior Class Cause of the Hunt Description Group Service Drop original call The connection fails because the destina- Normal Event no-user-responding (Cont.) tion does not respond to the call. This cause is used when a user does not respond to a call establishment message with either an alerting or a connect indica-...
Page 438 SmartWare Software Configuration Guide 34 • Call router configuration Table 20. Hunt group drop causes (Continued) Default Behavior Class Cause of the Hunt Description Group Service Drop original call The status message is generated in direct Normal Event response-to-status- (Cont.) response to receiving a status inquiry mes- enquiry sage.
Page 439 SmartWare Software Configuration Guide 34 • Call router configuration Table 20. Hunt group drop causes (Continued) Default Behavior Class Cause of the Hunt Description Group Service Drop original call The network normally provides the Service or bearer-capability-not- requested bearer capability, but it is Option Not available unavailable at the present time.
Page 440 SmartWare Software Configuration Guide 34 • Call router configuration Table 20. Hunt group drop causes (Continued) Default Behavior Class Cause of the Hunt Description Group Service Drop original call This cause indicates that the network has Invalid Message call-identity-in-use (Cont.) received a call suspends request.
Page 441 SmartWare Software Configuration Guide 34 • Call router configuration Table 20. Hunt group drop causes (Continued) Default Behavior Class Cause of the Hunt Description Group Service Drop original call The remote equipment receives a message Protocol Error ie-does-not-exist (Cont.) that includes information elements or call properties that are not recognized.
Page 442: Creating A Distribution Group Service
SmartWare Software Configuration Guide 34 • Call router configuration Creating a distribution group service A distribution group service distributes a call to multiple destinations interfaces. Figure 63 shows an example scenario where a call from a SIP interface is ﬁrst processed by several tables. The second table decides that the call must be forwarded to phones that are connected to various FXS interfaces.
Page 443: Distribution Group Service Examples
SmartWare Software Configuration Guide 34 • Call router configuration - 4 call destinations - No max. concurrent 4 picks up - 4 call destinations - max. concurrent = 2 after 5s after 10s 4 picks up - timeout = 5 Figure 64.
Page 444: Distribution-Group Min-Concurrent Setting
SmartWare Software Configuration Guide 34 • Call router configuration Note It does not make sense to conﬁgure the maximum number of concurrent destinations but no timeout, though the software does not prevent this con- ﬁguration. Distribution-Group Min-Concurrent setting A new command in the call-control’s distribution-group service lets the user specify how many of the conﬁg- ured call destinations should be tried ﬁrst: .
Page 445: Priority Service
SmartWare Software Configuration Guide 34 • Call router configuration Figure 65. ‘Limiter’ service diagram context cs switch interface isdn localexchange route call dest-service mylimiter.inbound interface isdn voicemail interface sip sip bind gateway sip route call dest-service mylimiter.outbound service limiter mylimiter max-calls 20 port inbound route call dest-interface sip...
Page 446: Priority Service Diagram
SmartWare Software Configuration Guide 34 • Call router configuration service hunt-group services priority (prio) routing table priority: 2 route 911 dest-service prio.high high FXO If1 route default dest-service prio.low1 priority: 0 low1 FXO If2 priority: 0 low2 Figure 66. Priority service diagram By default, the service drops any lower priority calls if a higher priority call fails.
Page 447: Cs Bridge Service-'Voip Leased Line
SmartWare Software Configuration Guide 34 • Call router configuration CS Bridge service—‘VoIP Leased Line’ The circuit switch (CS) bridge service provides the functional ability to create a leased line between two FXS ports, with the FXS ports on different SmartNodes. The call is point-to-point in an always connected state, also known as nailed up.
Page 448: Bridge Services Diagram
SmartWare Software Configuration Guide 34 • Call router configuration port (see ﬁgure 68). Each of these interfaces is responsible for one of the two independent calls. The listener port terminates the “FXS call” and the dialer port terminates the “RTP call.” Listener Port –...
Page 449: Deleting Call Services
SmartWare Software Configuration Guide 34 • Call router configuration Mode: Context CS Step Command Purpose [ name ] (ctx-cs)[switch]#[no] ser- Enters the bridge service conﬁguration mode / deletes a vice bridge BRIDGE1 bridge service. [ name ] (svc-bridg)[BRIDGE1]#port Creates a port on the service that can accept or spawn calls DIALER (the max number of ports is currently limited to two) [ name ] (port)[DIALER]# dial persis-...
Page 450: Activate The Call Router Configuration
SmartWare Software Configuration Guide 34 • Call router configuration Mode: Context CS Step Command Purpose node (ctx-cs)[ switch ]#no service service- Delete the service service-name . name Note: You do not have to enter the type of the service when just deleting it.
Page 451: Test The Call Router Configuration
SmartWare Software Configuration Guide 34 • Call router configuration Test the call router conﬁguration After activating the call router conﬁguration you can test the call router by simulating a route lookup as if a call is routed to a table. You have to execute the test call-router command and specify all necessary call properties together with the routing table you want to test.
Page 452: Call Routing Example Network
SmartWare Software Configuration Guide 34 • Call router configuration 16:55:33 > 02: Prefix Timeout Expression: E164-Number of 123 completely (no timeout) matches 1[0-4] 16:55:33 > 03: Prefix Timeout Expression: E164-Number of 123 does not match 11 16:55:33 > 04: Prefix Timeout Expression: E164-Number of 123 does not match 111 16:55:33 >...
Page 453 SmartWare Software Configuration Guide 34 • Call router configuration • The number block for site A is 022 782 55 00 to 99 • The number block for site B is 033 665 2 000 to 999 • The Carrier Access Code (CAC) for Apple is 1055 •...
Page 454: Cs Context And Call Router Elements
SmartWare Software Configuration Guide 34 • Call router configuration Figure 70 shows the corresponding CS Context and call router elements in node A: Context interface isdn IF-PBX-A interface isdn IF-LOCAL-BREAKOUT Call Router MAP- CAC- APPLE SVC- FALL MAP- BACK CAC- ORANGE interface h323 IF-NODE-B TAB-...
Page 455 SmartWare Software Configuration Guide 34 • Call router configuration # Bearer capability routing table “TAB-ISDN-SERVICE” routing-table itc TAB-ISDN-SERVICE route unrestricted-digital dest-interface IF-LOCAL-BREAKOUT route default dest-table TAB-DEST-A # Called party number routing table “TAB-DEST-A” routing-table called-e164 TAB-DEST-A route 0 dest-interface IF-LOCAL-BREAKOUT MAP-CAC-ORANGE route 00 dest-interface IF-NODE-C MAP-CLI-MELON route 07[4-6] dest-interface IF-LOCAL-BREAKOUT MAP-CAC-APPLE route 0336652...
Page 456 SmartWare Software Configuration Guide 34 • Call router configuration node(if-isdn)[IF-LOCA~]#exit node(ctx-cs)[switch]#interface h323 IF-NODE-B node(if-h323)[IF-NODE-B]#route dest-interface IF-PBX-A node(if-h323)[IF-NODE-B]#exit node(ctx-cs)[switch]#interface sip IF-NODE-C node(IF-NODE-C)[IF-NODE-C]#route dest-interface IF-PBX-A node(IF-NODE-C)[IF-NODE-C]#exit The conﬁguration is now complete. Prior to activating the conﬁguration enable the call router debug monitor to check the loading of the call router elements.
Page 457: Tone Configuration
Chapter 35 Tone conﬁguration Chapter contents Introduction ................................458 Tone-set profiles..............................458 MGCP-Events ..............................459 Tone configuration task list ..........................459 Configuring call-progress-tone profiles ......................460 Configure tone-set profiles ..........................460 Enable tone-set profile ..........................461 Show call-progress-tone and tone-set profiles ....................462...
Page 458: Introduction
SmartWare Software Configuration Guide 35 • Tone configuration Introduction This chapter gives an overview of call-progress-tone proﬁles and tone-set proﬁles, and describes the tasks involved in their conﬁguration. In-band tones keep the user informed about the state of his call or additional services such as call-waiting, hold etc.
Page 459: Mgcp-Events
SmartWare Software Configuration Guide 35 • Tone configuration its own tone-set proﬁle. If no tone-set is assigned to a PSTN interface the default tone-set is taken. Figure 71 illustrates the relation ship between call-progress-tone proﬁles, tone-set proﬁles and PSTN interfaces. call-progress-tone profiles Call Setup A Dial-A...
Page 460: Configuring Call-Progress-Tone Profiles
SmartWare Software Configuration Guide 35 • Tone configuration • Enabling the generation of local in-band tones • Showing call-progress-tone and tone-set proﬁles Conﬁguring call-progress-tone proﬁles Each call-progress-tone consists of a sequence of different tones and pauses. Arbitrary tone cadences can be conﬁgured.
Page 461: Enable Tone-Set Profile
SmartWare Software Configuration Guide 35 • Tone configuration Procedure: To conﬁgure a tone-set proﬁle Mode: Conﬁgure Step Command Purpose Creates tone-set name and enters tone-set pro- node (cfg)#proﬁle tone-set name ﬁle conﬁguration mode. Map a call-progress-tone proﬁle to an internal node (pf-tones)[ name ]#map tone.
Page 462: Show Call-Progress-Tone And Tone-Set Profiles
SmartWare Software Configuration Guide 35 • Tone configuration Mode: Interface Step Command Purpose node (ctx-cs)[switch]#interface if-type if- Enter interface conﬁguration mode. name Assign a user deﬁned tone-set proﬁle to an node (if- type )[ if-name ]#use proﬁle tone- interface. set name Example: Assign tone-set proﬁles to an ISDN interface The example shows how to use the SWISS tone-set for the CS context, and use the USA tone-set for an indi- vidual interface.
Page 463 SmartWare Software Configuration Guide 35 • Tone configuration The following example shows how to display the tone-set proﬁle. node#show profile tone-set test Tone Profile: test ================== Used: by 0 module(s) DTMF Duration: 80ms DTMF Interspace: 80ms Tones ----- dial-tone: belgianSpec ringback-tone: defaultAlertingtone hold-tone:...
Page 464 SmartWare Software Configuration Guide 35 • Tone configuration node(ctx-cs)[switch]#interface isdn bri0 node(if-isdn)[bri0]#use profile tone-set UK Tone configuration task list...
Page 465: Isdn Port Configuration
Chapter 36 ISDN port conﬁguration Chapter contents Introduction ................................466 ISDN reference points ..........................466 Possible SmartNode port configurations .......................467 ISDN UNI Signaling ............................467 ISDN Configuration Concept ..........................469 ISDN Layering .............................469 Configuration example ..........................470 Description .............................470 ISDN port configuration task list ........................471 Shutdown and enable ISDN ports ........................471 Configure BRI port parameters (Layer 1)
Page 466: Introduction
SmartWare Software Configuration Guide 36 • ISDN port configuration Introduction This chapter provides an overview of ISDN ports and describes the tasks involved in conﬁguring ISDN ports in SmartWare. ISDN ports are the physical ISDN connections on the SmartNode devices. There are two types of ISDN ports: •...
Page 467: Possible Smartnode Port Configurations
SmartWare Software Configuration Guide 36 • ISDN port configuration The S reference point is on the subscriber interface. This is the typical 4-wire connection between an ISDN phone and an ISDN PBX. Be aware that many ISDN PBX vendors use non-standard proprietary 2-wire inter- faces to connect the Terminals to the PBX.
Page 468: Integration Of Isdn Access Lines
SmartWare Software Configuration Guide 36 • ISDN port configuration Basic Rate Access Line point-to-point Node Phone IP Network Basic Rate Access point-to-multipoint (S-bus) Local Exchange Node Phones IP Network Primary Rate Access Line IP Network Node Node Phone Legend: Terminal Equipment (Phone) Local Exchange Network Termination 1 (Modem) Line Termination...
Page 469: Isdn Configuration Concept
SmartWare Software Configuration Guide 36 • ISDN port configuration Connector pin-out and short circuits—Some of the Smart- Node ISDN BRI ports are conﬁgurable to operate as network or terminal ports. The pin-out of the sockets is switched according to IMPORTANT this conﬁguration.
Page 470: Configuration Example
SmartWare Software Configuration Guide 36 • ISDN port configuration Conﬁguration example Let’s have a look at the conﬁguration of a BRI port, running the network side of the DSS1 protocol. To this ISDN port a phone can be attached. port bri 0 1 clock auto encapsulation q921 q921...
Page 471: Isdn Port Configuration Task List
SmartWare Software Configuration Guide 36 • ISDN port configuration ISDN port conﬁguration task list Conﬁguring ISDN ports typically consists of the following tasks: • Shutdown and enable ISDN ports • Conﬁgure ISDN layer 1 parameters for BRI ports • Conﬁgure ISDN layer 1 parameters for PRI ports •...
Page 472: Configure Pri Port Parameters (Layer 1)
SmartWare Software Configuration Guide 36 • ISDN port configuration Mode: Port bri Step Command Purpose Specify the clock mode (default: auto) node (prt-bri)[slot/port]#clock auto The BRI port can either generate the clocking for the line, or accept the clock from the line. node (prt-bri)[slot/port]#clock master The options ‘master’...
Page 473: Configure Isdn Layer 2 Parameters (Q921)
SmartWare Software Configuration Guide 36 • ISDN port configuration Mode: Port {e1|t1} Step Command Purpose Specify the clock mode (Default: auto) node (prt-e1)[slot/port]#clock auto The PRI port can either generate the clocking for the line, or accept the clock from the line. node (prt-e1)[slot/port]#clock master The options ‘master’...
Page 474: Configure Isdn Layer 3 Parameters (Q931)
SmartWare Software Configuration Guide 36 • ISDN port configuration Mode: q921 Step Command Purpose Specify ISDN layer 2 operating mode node (q921)[slot/port]#protocol pp (Default: BRI: pmp, PRI: pp). The ISDN layer 2 of BRI ports can operate in node (q921)[slot/port]#protocol pmp point-to-point (pp) or point-to-multipoint (pmp) mode.
Page 475: Enabling Pss1/Q.sig
SmartWare Software Configuration Guide 36 • ISDN port configuration Enabling PSS1/Q.SIG This procedure conﬁgures an ISDN port for use with Q.SIG / PSS1 protocol. Mode: port bri <slot> <port> or port e1 <slot> <port> or port t1 <slot> <port> Step Command Purpose [ name ] (prt-bri)[slot/port]# q921...
Page 476 SmartWare Software Configuration Guide 36 • ISDN port configuration Step Command Purpose Limits the total number of concurrent calls node (q931)[slot/port]#max-calls number- on the port. of-calls The no form of the command restores the default settings. node (q931)[slot/port]#no max-calls if the channel-range and Note max-calls command are used simultaneously, the...
Page 477: Show Isdn Port Status
SmartWare Software Configuration Guide 36 • ISDN port configuration Show ISDN port status Procedure: To display the current status of an ISDN port Mode: Exec Step Command Purpose Show the status of one or more ISDN node #show port isdn [ slot port ] [detail <- level>...
Page 478: Examples
SmartWare Software Configuration Guide 36 • ISDN port configuration Layer 3 Protocol: Dss1 UniSide: MinChannel: MaxChannel: MaxCalls: AIS Blue Alarm: Hunt Mode: Ascending Signalling Mode: Etsi Examples Example: Conﬁguring BRI port as Euro-ISDN interface The following example shows how to conﬁgure port 0/0 as a Euro ISDN interface with user side signaling. 172.16.40.71(cfg)#port bri 0 0 172.16.40.71(prt-bri)[0/0]#q921 172.16.40.71(q921)[0/0]#q931...
Page 479: Pbx Connected To Isdn Port 1/0
SmartWare Software Configuration Guide 36 • ISDN port configuration Example: QSIG Assume the scenario as illustrated in ﬁgure Node Node ISDN Port 1/0 Figure 76. PBX connected to ISDN port 1/0 Conﬁgure the ISDN port 1/0 to work as a Q-SIG master port but clock-slave and allow a maximum of eight parallel B-channel connections.
Page 480: Fxs Port Configuration
Chapter 37 FXS port conﬁguration Chapter contents Introduction ................................481 Shutdown and enable FXS ports..........................481 Bind FXS ports to higher layer applications ......................482 Configure country-specific FXS port parameters....................482 Other FXS port parameters..........................483 Example ................................483...
Page 481: Introduction
SmartWare Software Configuration Guide 37 • FXS port configuration Introduction This chapter provides an overview of POTS signaling and SmartNode FXS ports and describes the tasks involved in conﬁguring FXS ports in SmartWare. This chapter includes the following sections: • Shutdown and enable FXS ports (see page 481)
Page 482: Bind Fxs Ports To Higher Layer Applications
SmartWare Software Configuration Guide 37 • FXS port configuration Bind FXS ports to higher layer applications An FXS port needs to be associated to an fxs interface in a CS context. The same mechanism of encapsulation and binding is used as known for e.g. Ethernet ports (see “Interfaces, Ports, and Bindings”...
Page 483: Other Fxs Port Parameters
SmartWare Software Configuration Guide 37 • FXS port configuration Other FXS port parameters This section describes the commands available for the conﬁguration of an FXS port. Procedure: Conﬁgure the FXS port parameters Mode: Conﬁgure Step Command Purpose node (conﬁg)#port fxs slot port Enter FXS port conﬁguration mode node (prt-fxs) [ slot / port ]#[no] battery- Reverses the line polarity at connect/disconnect of...
Page 484 SmartWare Software Configuration Guide 37 • FXS port configuration 172.16.40.71#configure 172.16.40.71(cfg)#port fxs 0 0 172.16.40.71(prt-fxs)[0/0]#use profile fxs us 172.16.40.71(prt-fxs)[0/0]#caller-id format bell 172.16.40.71(prt-fxs)[0/0]#flash-hook-duration 350 172.16.40.71(prt-fxs)[0/0]#encapsulation cc-fxs 172.16.40.71(prt-fxs)[0/0]#bind interface fxs00 switch 172.16.40.71(prt-fxs)[0/0]#exit 172.16.40.71(cfg)#system Example...
Page 485: Fxo Port Configuration
Chapter 38 FXO port conﬁguration Chapter contents Introduction ................................486 Shutdown and enable FXO ports.........................486 Bind FXO ports to higher layer applications......................486 Configure country specific FXO port parameters....................487 Other FXO port parameters ..........................487...
Page 486: Fxo Port Configuration
SmartWare Software Configuration Guide 38 • FXO port configuration Introduction This chapter provides an overview of POTS signaling and SmartNode FXO ports and describes the tasks involved in conﬁguring FXO ports in SmartWare. This chapter includes the following sections: • Shutdown and enable FXO ports (see page 486)
Page 487: Configure Country Specific Fxo Port Parameters
SmartWare Software Configuration Guide 38 • FXO port configuration Conﬁgure country speciﬁc FXO port parameters Unlike ISDN, POTS is heavily country speciﬁc even though there is a good chance that a setting for one coun- try works reasonably good in another country. Country speciﬁc settings are contained in a so-called fxo proﬁle which is integrated in the ﬁrmware of the SmartNode.
Page 488 SmartWare Software Configuration Guide 38 • FXO port configuration Mode: Conﬁgure Step Command Purpose node (conﬁg)#port fxo slot port Enter FXO port conﬁguration mode node (prt-fxo)[ slot / port ]#caller-id for- Speciﬁes which line protocol is used for caller-id mat { bell | etsi } transmission.
Page 489: Gateway Configuration
Chapter 39 H.323 gateway conﬁguration Chapter contents \Introduction...............................490 Gateway configuration task list ..........................491 Binding the gateway to an IP interface ......................491 Enable the gateway ............................491 Configure registration authentication service (RAS) (Optional) ..............492 Configure H.235 Security (optional) ......................493 H.235 configuration .............................494 Advanced configuration options (optional) ....................497 Enabling H.245 Tunneling...
Page 490: H.323 Gateway Configuration
SmartWare Software Configuration Guide 39 • H.323 gateway configuration Introduction This chapter provides an overview of the H.323 gateway and describes the tasks involved in its conﬁguration. A gateway is always needed when communication is required between different networks. A gateway provides: •...
Page 491: Gateway Configuration Task List
SmartWare Software Configuration Guide 39 • H.323 gateway configuration Gateway conﬁguration task list This chapter describes the conﬁguration of the H.323 gateway. Some parameters can be conﬁgured in the gate- way conﬁguration mode and may be overwritten in another conﬁguration mode, For example, in the H.323 CS interface.
Page 492: Configure Registration Authentication Service (Ras) (Optional)
SmartWare Software Configuration Guide 39 • H.323 gateway configuration The following example shows how to enable an already deﬁned H.323 Gateway. node(cfg)#gateway h323 h323 node(gw-h323)[h323]#no shutdown Conﬁgure registration authentication service (RAS) (Optional) The H.323 gateway can either work in combination with a gatekeeper, which uses the RAS protocol for com- munication with the gateways or it can be used for direct calls between gateways without a gatekeeper.
Page 493: Configure H.235 Security (Optional)
SmartWare Software Configuration Guide 39 • H.323 gateway configuration Mode: Gateway H.323 Step Command Purpose node (gw-h323)[h323]#gatekeeper-discov- Specify that gatekeeper discovery has to be done automatically ery auto [gkid] node (gw-h323)[h323]#gatekeeper-discov- Specify the gatekeeper explicitly. You can ery manual ip-address ip-port [gkid] repeat this command to add multiple gate- keepers.
Page 494: Configuration
SmartWare Software Configuration Guide 39 • H.323 gateway configuration H.235v2 Annex D provides H.323 RAS and H.225 message authentication and integrity check thus thwarting any replay and spooﬁng attacks on H.323 calls. If H.235 is switched on, the following security attacks are thwarted: •...
Page 495 SmartWare Software Configuration Guide 39 • H.323 gateway configuration Mode: Gateway H.323 Step Command Purpose Sets the master password (32 hex digits, 0–9, node (gw-h323)[h323]#h235security master- A–F) with which the H.235 password is password master-password decrypted. Conﬁgure the master password only Note over secure links (e.g.
Page 496 SmartWare Software Configuration Guide 39 • H.323 gateway configuration Step Command Purpose node (gw-h323)[h323]#h235-security ras- Enables or disables H.235 security for trans- auth-int-tx [<msg>] mitted RAS packets. msg is the message type. node (gw-h323)[h323]#no h235-security ras-auth-int-tx [<msg>] node (gw-h323)[h323]#h235-security q931- Enables or disables H.235 security for call- auth-int signaling.
Page 497: Advanced Configuration Options (Optional)
SmartWare Software Configuration Guide 39 • H.323 gateway configuration Example: Switch on H.235 security The following example shows how to use the password encryption tool and how to enable H.235 security. Additionally the H.235 security debug monitor is enabled. Generate the encrypted H.235 password from ‘myh235pwd’: C:\>getcryptopassword myh235pwd 12d3f4e76a83c6dd1067a6d34fe5cb21 H.235 Password : myh235pwd...
Page 498: Enabling The Fastconnect Procedure
SmartWare Software Configuration Guide 39 • H.323 gateway configuration Mode: Gateway H.323 Step Command Purpose node (gw-h323)[h323]#h245-tunneling Enables H.245 tunneling. Example: Enabling H.245 tunneling The following example shows how to enable H.245 tunneling on an already deﬁned H.323 Gateway. node(cfg)#gateway h323 h323 node(gw-h323)[h323]#h245-tunneling] Enabling the fastconnect procedure If the fastconnect procedure is enabled, no separate H.245 connection is opened and all media channel speciﬁc...
Page 499: Changing The Tcp Port For Inbound Call-Signaling Connections
SmartWare Software Configuration Guide 39 • H.323 gateway configuration Changing the TCP port for inbound call-signaling connections The default TCP listening port for inbound call-signaling connections is per default 1720 as deﬁned in the H.323 standard. The following procedure describes how to change the port number. Mode: Gateway H.323 Step Command...
Page 500: Setting The Connect Timeout
SmartWare Software Configuration Guide 39 • H.323 gateway configuration Setting the connect timeout Per default the H.323 gateway waits for 60s when the call is in the alerting phase for the call to be answered. If the call is not answered within that time, the call is dropped. The value of this timer can be changed using the following procedure: Mode: Gateway H.323 Step...
Page 501: Troubleshooting
SmartWare Software Configuration Guide 39 • H.323 gateway configuration Troubleshooting You can display basic status information of the H.323 gateway using the following command: Mode: Conﬁgure Step Command Purpose node (gw-h323)[h323]# show gateway Displays H.323 gateway status information. The detail level parameter is a number in the h323 status [detail level ] range 0 to 5 and indicates how much detail should be displayed.
Page 502: Sip Gateway Configuration
Chapter 40 SIP gateway conﬁguration Chapter contents Introduction ................................503 Gateway configuration task list ..........................503 Configure DNS resolver ..........................504 Binding the gateway to an IP interface ......................504 Enable the Gateway ............................505 Create a SIP service ............................505 Registering with a registrar (optional) ......................505 Configure a realm ............................507...
Page 503: Introduction
SmartWare Software Configuration Guide 40 • SIP gateway configuration Introduction This chapter provides an overview of the SIP gateway and describes the tasks involved in its conﬁguration. When communication is required between different networks a gateway is always needed between them. A gateway provides: •...
Page 504: Configure Dns Resolver
SmartWare Software Configuration Guide 40 • SIP gateway configuration possible conﬁgurations, which are involved in a speciﬁc conﬁguration topic are described in the respective con- ﬁguration task. You cannot have more than 8 SIP gateways. Even though more than 8 gateways can be conﬁgure, the system only supports 8.
Page 505: Enable The Gateway
SmartWare Software Configuration Guide 40 • SIP gateway configuration Enable the Gateway In order to become active the SIP gateway must be enabled. The following procedure enables the SIP gateway: Mode: Gateway SIP Step Command Purpose Enable the SIP gateway node (gw- sip )[ sip ]#no shutdown Example: Enabling an SIP Gateway Conﬁguration The following example shows how to enable an already deﬁned SIP Gateway.
Page 506 SmartWare Software Configuration Guide 40 • SIP gateway configuration Step Command Purpose Adds a user for SIP registration and the cre- [ name ] (svc-sip)[ service ]# user <user> [authen- dentials for authentication. ticate [name <login>] password <password> [default]] [register [display-name <display- name>][phone-context <phone-context>]] Repeat step 2 to add more than one user to be registered.
Page 507: Configure A Realm
SmartWare Software Configuration Guide 40 • SIP gateway configuration Don’t use a registrar but use the following authentication credentials when the proxy requires client authentica- tion: user MY-DEFAULT-USER authenticate name my-name password my-password default Since the user is not registered, the user-name can directly be used as login-name. Thus the following com- mand conﬁgures the same: user my-name authenticate my-password default Example: Register three users to a SIP registrar all using the same authentication credentials:...
Page 508: Configure A Default Server (Optional)
SmartWare Software Configuration Guide 40 • SIP gateway configuration Mode: Gateway SIP/service Step Command Purpose Deﬁne the name of your SIP domain node (svc-sip)[service]#domain domain-name Example: Deﬁning the name of the SIP domain The following example shows how to deﬁne the SIP domain name. node(cfg)#gateway sip sip node(gw-sip)[sip]#service default node(svc-sip)[service]#domain mycompany.com...
Page 509: Automatic Detection Of The Nat Ip Address For Sip
SmartWare Software Configuration Guide 40 • SIP gateway configuration Example: Conﬁguring a default server The following example shows how to conﬁgure a default server, which acts as a loose-router. node>enable node#configure node(cfg)#gateway sip sip node(gw-sip)[sip]#service default node(svc-sip)[service]#default server sipproxy.mycompany.com Automatic detection of the NAT IP address for SIP In some cases, it is possible to get SIP working through a NAT, if the user agent behind the NAT inserts the public IP address of the NAT into the SIP contact and SDP headers instead of the devices own IP address.
Page 510: Enable The Session Timer (Optional)
SmartWare Software Configuration Guide 40 • SIP gateway configuration Enable the session timer (optional) The gateway implements the SIP session timer feature, which is currently only deﬁned in SIP draft standards. The session timer feature allows a gateway to check periodically during a call, if the remote gateway is still alive and if the call is still connected on the remote gateway.
Page 511: Define Session Timer Version
SmartWare Software Configuration Guide 40 • SIP gateway configuration Deﬁne session timer version There is currently no ﬁnal standard available for the implementation of the session timer feature in SIP. How- ever different versions of draft standard implementations are used in current SIP products. For compatibility with current SIP equipment, the gateway supports two different versions of the session-timer draft standard.
Page 512: Sip Profile
SmartWare Software Configuration Guide 40 • SIP gateway configuration Example: Deﬁning the call transfer version The following example shows how to use the implementation of the call-transfer according to draft-ietf-sip-cc- transfer-02. node(cfg)#gateway sip sip node(gw-sip)[sip]#service default node(svc-sip)[service]#call-transfer-version 2 SIP Proﬁle There is a new proﬁle type, the SIP proﬁle.
Page 513: Manually Configuring The Sip Contact Ip Address
SmartWare Software Configuration Guide 40 • SIP gateway configuration Manually conﬁguring the SIP contact IP address Normally SIP cannot pass a router, which does NAPT. However, if the router only replaces the IP addresses but not the port numbers, it is possible to get SIP working through the NAT, by conﬁguring the global IP address of the NAT router as the contact-address in the SIP gateway.
Page 514: Changing The Sip Transaction Timeout
SmartWare Software Configuration Guide 40 • SIP gateway configuration Changing the SIP transaction timeout The following command changes the SIP transaction timeout from the default of 32 seconds to a user- selected value. Mode: gateway sip <sip> Step Command Purpose Sets the transaction timeout to the [ name ] (gw-sip)[ gw-name ]# transaction speciﬁed value.
Page 515: Sip Multicast Registration
SmartWare Software Configuration Guide 40 • SIP gateway configuration The SIP gateway also provides several debugging monitors to observe the dynamic behavior of the SIP gateway. These monitors allow efﬁcient troubleshooting of SIP problems. The most often used monitors are listed in the following table.
Page 516: Default Server
SmartWare Software Configuration Guide 40 • SIP gateway configuration Default Server Additionally, the default server can be set to auto so that actual registrar is always taken as default server. When both are set to auto, the registration mechanism discovers the registrar and the address of the discovered regis- trar is also taken as default server.
Page 517: Voip Profile Configuration
Chapter 41 VoIP proﬁle conﬁguration Chapter contents Introduction ................................518 VoIP profile configuration task list ........................518 Creating a VoIP profile ..........................519 Configure codecs ............................520 Configuring the Cisco versions of the G.726 Codecs ..................522 Configuring DTMF relay ..........................522 Configuring RTP payload types ........................523 Configuring RTP payload type for Cisco NSE ....................523...
Page 518: Introduction
SmartWare Software Configuration Guide 41 • VoIP profile configuration Introduction This chapter gives an overview of VoIP proﬁles, and describes how they are used and the tasks involved in VoIP proﬁle conﬁguration. A VoIP proﬁle is a container for all datapath-related settings on VoIP connections. The proﬁle settings apply to all calls going through the interface.
Page 519: Creating A Voip Profile
SmartWare Software Configuration Guide 41 • VoIP profile configuration • Enabling DTMF relay (see page 520) • Conﬁguring RTP payload types (see page 523) • Conﬁguring the dejitter buffer (advanced) (see page 523) • Enabling/disabling ﬁlters (advanced) (see page 527) •...
Page 520: Configure Codecs
SmartWare Software Configuration Guide 41 • VoIP profile configuration Conﬁgure codecs The VoIP proﬁle contains a list of codecs the forms the set of allowed codecs that can be used to set up a VoIP connection. The list is assembled in order of priority (i.e. the ﬁrst entered codec is the most preferred one). For each codec in the list, a set of parameters can be conﬁgured.
Page 521 SmartWare Software Configuration Guide 41 • VoIP profile configuration Mode: Proﬁle VoIP Step Command Purpose node (pf-voip)[ name ]#codec g729 tx- Appends codec g729 to the list of codecs. Speci- fies the payload duration for transmitted RTP pack- length 30 rx-length 30 silence- ets of this codec, and the maximum supported suppression payload duration for received RTP packets of this...
Page 522: Configuring The Cisco Versions Of The G.726 Codecs
SmartWare Software Configuration Guide 41 • VoIP profile configuration Mode: Proﬁle VoIP Step Command Purpose node (pf-voip)[ name ]#codec 1 g729 tx- Inserts codec g729 at the first position of the list (most preferred codec). The parameters are the length 30 rx-length 30 silence- same previously described.
Page 523: Configuring Rtp Payload Types
SmartWare Software Configuration Guide 41 • VoIP profile configuration Signalling of dtmf tones payload encoder decoder Detects dtmf tones Generates dtmf tones Figure 80. DTMF Relay This procedure describes how to conﬁgure DTMF relay Mode: Proﬁle VoIP Step Command Purpose node (pf-voip)[ pf-name ]#dtmf-relay Define how DTMF digits shall be transmitted.
Page 524: Configuring Cisco Nse For Fax
SmartWare Software Configuration Guide 41 • VoIP profile configuration NSEs are normally sent with RTP payload type 100. The RTP packets have the same source and destination IP addresses and UDP ports as the other packets in the media stream, but differ in the RTP payload types so they can be distinguished from the stream’s audio packets.
Page 525: Jitter And Dejitter Buffer
SmartWare Software Configuration Guide 41 • VoIP profile configuration Voice Packets Node Network Node Node Node x + dx Buffer Voice Decoder Figure 81. Jitter and dejitter buffer The dejitter buffer delays incoming packets so it can present them to the decompression algorithm at ﬁxed intervals.
Page 526: Adaptive Versus Static Dejitter Buffer
SmartWare Software Configuration Guide 41 • VoIP profile configuration The operating modes for the dejitter buffer are illustrated in ﬁgure • Adaptive—The adaptive buffer automatically adapts to variations in the network’s delay characteristics and in general yields the best results for voice conversations. In the adaptive dejitter buffer there are parameters that can be conﬁgured (such as shrink-speed, grow-step, etc.) that should not be changed unless it is necessary to do so.
Page 527: Enabling/Disabling Filters (Advanced)
SmartWare Software Configuration Guide 41 • VoIP profile configuration Mode: Proﬁle VoIP Step Command Purpose node (pf-voip)[ name ]#dejitter-mode mode Specify the dejitter buffer as adaptive, static or static-data. node (pf-voip)[ name ]#dejitter-max-delay Specify the maximum delay in milliseconds that the max-delay dejitter buffer is allowed to introduce.
Page 528: Configuring Fax Transmission
SmartWare Software Configuration Guide 41 • VoIP profile configuration Conﬁguring Fax transmission Fax is a protocol for electronically transmitting written material in-band over a voice channel. In public switched telephone networks (PSTN), a fax is handled the same way as a voice conversation. A G3 Fax device transforms (modulates) a scanned page into audible tones that are transmitted in-band.
Page 529: Fax Relay And Fax Bypass
SmartWare Software Configuration Guide 41 • VoIP profile configuration FAX Bypass generated tones transported in RTP payload Node Node Node Node RTP Stream Modulated data Modulated data Modulated data FAX Relay reference data transported over T.38 Terminate fax protocol Terminate fax protocol Node Node Node...
Page 530 SmartWare Software Configuration Guide 41 • VoIP profile configuration Mode: Proﬁle VoIP Step Command Purpose node (pf-voip)[ name ]#fax transmis- Adds fax bypass transmission with codec G.711 to the list of fax transmission modes.Alternative sion bypass g711alaw64k codecs available are: G.711uLaw •...
Page 531: T.38 Ced Retransmission
SmartWare Software Configuration Guide 41 • VoIP profile configuration Step Command Purpose Adjusts the volume of the fax signals re-generated node (pf-voip)[ name ]#fax volume volume on the receiver side. The volume is in dB, in the (optional) range -18.5 ... -3.5 (Default: -9.5dB). Sets maximum allowed bit-rate for fax relay node (pf-voip)[ name ]# fax max-bit- (Default 14400 Bit/sec).
Page 532: Fax Bypass Method
SmartWare Software Configuration Guide 41 • VoIP profile configuration Mode: proﬁle voip proﬁle-name Step Command Purpose Specifies the number of CED retransmissions. [ name ] (pf-voip)[name]#[no] fax ced- retransmission number Default: 2 Fax bypass method This command speciﬁes the method for notifying the remote device that the RTP Stream has switched to a voice-band FAX transmission.
Page 533: Configuring Modem Transmission
SmartWare Software Configuration Guide 41 • VoIP profile configuration Conﬁguring modem transmission Modem transmission is similar to fax transmission, except that modem data is always transported in bypass mode. This means that an ordered list of bypass codecs can be deﬁned for modem transmission. If no modem transmission codec is conﬁgured, no action is taken to change the codec when modem is detected.
Page 534: Configuring The Traffic Class For Voice And Fax Data
SmartWare Software Configuration Guide 41 • VoIP profile configuration Conﬁguring the trafﬁc class for Voice and Fax data The trafﬁc class for voice data and fax data is conﬁgurable. The conﬁgured trafﬁc class is used as additional routing criterion in the IP routing table. Mode: Proﬁle VoIP Step Command...
Page 535 SmartWare Software Configuration Guide 41 • VoIP profile configuration 5 node(pf-voip)[Wire128~]#no codec g711uLaw64k 6 node(pf-voip)[Wire128~]#codec g723-6k3 tx-length 30 rx-length 30 silence-suppres- sion 7 node(pf-voip)[Wire128~]#dejitter-max-delay 100 8 node(pf-voip)[Wire128~]]#show profile voip Wire128kbit VoIP Profile: Wire128kbit ========================= Used: by 0 module(s) Codecs ------ G.723 6k3: rxlen=30;txlen=30;ss Fax Transmission...
Page 536: Home Office With Fax
SmartWare Software Configuration Guide 41 • VoIP profile configuration Payload Type NTE: Description: 3. Create VoIP proﬁle and give it a name. All settings have default values 4., 5. Remove the default codecs G.711alaw and G.711uLaw 6. Add codec g723-6k3 with silence-suppression enabled 7.
Page 537: Soft Phone Client Gateway
SmartWare Software Configuration Guide 41 • VoIP profile configuration Shrink Speed: Grow Step: Grow Attenuation: High Pass Filter: enabled Post Filter: enabled Detection: CED Tone T.38 High Speed Redundant Packets: T.38 Low Speed Redundant Packets: Max. Bit Rate: 9600bps Volume: -9.500dB Error Correction: enabled...
Page 538 SmartWare Software Configuration Guide 41 • VoIP profile configuration 2 node#configure 3 node(cfg)#profile voip softPhone 4 node(pf-voip)[softPho~]#no codec g711aLaw64k 5 node(pf-voip)[softPho~]#codec g723-6k3 tx-length 30 rx-length 30 no-silence-sup- pression 6 node(pf-voip)[softPho~]#no dtmf-relay 7 node(pf-voip)[softPho]]#show profile voip softPhone VoIP Profile: softPhone ======================= Used: by 0 module(s) Codecs...
Page 539 SmartWare Software Configuration Guide 41 • VoIP profile configuration Relay: disabled Mute Encoder: disabled Payload Type NTE: Description: 3. Create VoIP proﬁle and give it a name. All settings have default values 4. Remove the default codec G.711alaw that is not supported. 5.
Page 540: Pstn Profile Configuration
Chapter 42 PSTN proﬁle conﬁguration Chapter contents Introduction ................................541 PSTN profile configuration task list ........................541 Creating a PSTN profile ..........................541 Configuring the echo canceller ........................542 Configuring output gain ..........................542...
Page 541: Introduction
SmartWare Software Configuration Guide 42 • PSTN profile configuration Introduction This chapter gives an overview of PSTN proﬁles, and describes how they are used and the tasks involved in PSTN proﬁle conﬁguration. A PSTN proﬁle is a container for all datapath-related settings on PSTN connections. It can be assigned to PSTN interfaces in context CS.
Page 542: Configuring The Echo Canceller
SmartWare Software Configuration Guide 42 • PSTN profile configuration Procedure: Create a PSTN Proﬁle and enter the PSTN proﬁle conﬁguration mode Mode: Conﬁgure Step Command Purpose node (cfg)#profile pstn name Create a PSTN profile with name name and enter PSTN profile configuration mode.
Page 543 SmartWare Software Configuration Guide 42 • PSTN profile configuration Mode: Proﬁle PSTN Step Command Purpose node (pf-pstn)[ name ]#output-gain gain Set the output gain to value in dB PSTN profile configuration task list...
Page 544: Voip Debugging
Chapter 43 VoIP debugging Chapter contents Introduction ................................545 Debugging strategy..............................545 Filtering debug monitor output ...........................546 Verifying IP connectivity .............................546 Debugging call signaling............................547 Debugging ISDN signaling ...........................547 Verify an incoming call ...........................548 Verify an outgoing call ..........................549 Verify ISDN layer 1,2,3 status ........................551 Debugging FXS Signaling ..........................552...
Page 545: Introduction
SmartWare Software Configuration Guide 43 • VoIP debugging Introduction This chapter describes how to debug VoIP sessions, including the signaling part and the voice data path part (speech, fax, and modem connectivity). It provides debugging strategies to help locate the source of a problem, and describes the show and debug commands used to verify correct system operation and to troubleshoot problems.
Page 546: Filtering Debug Monitor Output
SmartWare Software Configuration Guide 43 • VoIP debugging Filtering debug monitor output The output of the debug monitors can be ﬁltered using the following command to let the terminal only print important information. The speciﬁed expression is a regular expression, which is used by the ﬁlter to select important lines.
Page 547: Debugging Call Signaling
SmartWare Software Configuration Guide 43 • VoIP debugging route to host” response) and a successful connection to host 172.16.40.122 (which received and sent packets with no loss). node#ping 192.195.23.1 10 timeout 5 Sending 10 ICMP echo requests to 192.195.23.10, timeout is 5 seconds: % No route to host node# node#ping 172.16.40.122...
Page 548: Verify An Incoming Call
SmartWare Software Configuration Guide 43 • VoIP debugging Command Purpose Prints all errors occurring in ISDN call control and unit #debug ccisdn error ISDN datapath control. Always switch this monitor on when debugging ISDN. Prints operations on the ISDN part of the voice unit #debug ccisdn datapath data path.
Page 549: Verify An Outgoing Call
SmartWare Software Configuration Guide 43 • VoIP debugging 18:34:10 > [TERMINAL-00b73348] >> SETUP ACKNOWLEDGEMENT (DSS1 Ntwk) 18:34:10 > [TERMINAL-00b73348] State: OVERLAP SENDING, Event: PEER TRYING 18:34:10 > [TERMINAL-00b73348] State: OVERLAP SENDING, Event: PEER ALERTING 18:34:10 > [TERMINAL-00b73348] Set state to CALL DELIVERED 18:34:10 >...
Page 550 SmartWare Software Configuration Guide 43 • VoIP debugging unit(cfg)#call 123456 dial 987654321 dest-interface PSTN unit(cfg)#22:03:06 > [PSTN] Added endpoint PSTN-00b70a20 22:03:06 > [PSTN] NEW CALL. Allocated Endpoint PSTN-00b70a20 22:03:06 > [PSTN-00b70a20] >> SETUP (DSS1 User) Bearer capability : speech - CCITT circuit mode - 64kBit/s - G.711 A-law Calling party number : 123456 unknown number - unknown numbering plan...
Page 551: Verify Isdn Layer 1,2,3 Status
SmartWare Software Configuration Guide 43 • VoIP debugging • If there is a RELEASE or DISCONNECT message instead of the ALERTING, either ISDN connectivity is not working (i.e. the message cannot be sent to the ISDN line), or the PSTN has rejected the call. Verify ISDN port status using the command (see chapter 36, “ISDN port conﬁguration”...
Page 552: Debugging Fxs Signaling
SmartWare Software Configuration Guide 43 • VoIP debugging EOXGW01# The line “link state: up” tells you that layer 1 is up. To debug the layers 1-3 state machines, use the command debug isdn event slot port {all | layer1 | layer2 | layer3}. Debugging FXS Signaling Overview: FXS debug monitors Command...
Page 553: Verify An Outgoing Call
SmartWare Software Configuration Guide 43 • VoIP debugging • : The dial-tone is played. 09:00:11 CFXS > [EP PHONE] Change state to DIAL-TONE. • : The ﬁrst digit has been touched. Dial- 09:00:13 CFXS > [EP PHONE] Change state to DIALING. tone stops.
Page 554: Debugging H.323 Signaling
SmartWare Software Configuration Guide 43 • VoIP debugging • : The port begins to ring on the analog line. This 09:13:55 FXS > [0 1] Set state to 'Ringing' means that the binding of the port to the context CS interface is correct, and your phone should now be ringing.
Page 555 SmartWare Software Configuration Guide 43 • VoIP debugging H.323 Gateway: h323 =================== State: Stack Handle: 0x193ce44 RAS Engine ---------- State: REGISTERED Gatekeeper: 172.16.32.51/1719 Allocated Endpoints: Allocated RAS Engines: Allocated Control Channels: Allocated Outgoing Logical Slowstart Channels: 0 Allocated Outgoing Logical Faststart Channels: 0 Allocated Incoming Logical Channels: unit# unit#00:29:03 H323 >...
Page 556: Verify An Outgoing Call
SmartWare Software Configuration Guide 43 • VoIP debugging 00:29:08 H323 > [EP h323-00c13dc0] Set channel state to OPENING 00:29:08 H323 > [EP h323-00c13dc0] State: CONNECTED, Call Event: PROGRESS 00:29:08 H323 > [EP h323-00c13dc0] Stack: State: CONNECTED (CALL) 00:29:08 H323 > [EP h323-00c13dc0] Stack: New Incoming Logical Channel: 00bcca48 00:29:08 H323 >...
Page 557 SmartWare Software Configuration Guide 43 • VoIP debugging 01:00:10 H323 > [EP h323-00c07230] Destination Address: TEL:60,60 01:00:10 H323 > [EP h323-00c07230] Source Address: TEL:50,50 01:00:10 H323 > [EP h323-00c07230] Presentation Indicator: Presentation allowed 01:00:10 H323 > [EP h323-00c07230] Screening Indicator: User provided, not screened 01:00:10 H323 >...
Page 558: Debugging Sip Signaling
SmartWare Software Configuration Guide 43 • VoIP debugging the called gateway does not indicate any H.323 message received, use debug gateway h323 tpktchan verify that a packet is being sent. Debugging SIP signaling Overview: SIP debug monitors Command Purpose Prints all SIP messages that are sent / received. unit #debug gateway sip transport [detail detail ] This is a good monitor to start with when debug-...
Page 559: Verify An Outgoing Call
SmartWare Software Configuration Guide 43 • VoIP debugging • The line indicates that the 18:53:40 SIP_TR> Received INVITE sip:50@172.16.32.32 SIP/2.0 INVITE message has been received. This means that the SIP network is functional • 18:53:40 SIP_TR > Sent SIP/2.0 100 Trying 18:53:40 SIP_TR>...
Page 560 SmartWare Software Configuration Guide 43 • VoIP debugging circuit mode - 64kBit/s - G.711 A-law Calling party number : 55 unknown number - unknown numbering plan presentation allowed - user provided not screened Called party number : 50 unknown number - unknown numbering plan High layer compatibility : telephony CCITT 19:17:38...
Page 561: Debugging Voice Data
SmartWare Software Configuration Guide 43 • VoIP debugging Debugging voice data There are several debug monitors that can help identify problems in VoIP connections. The most common VoIP problems are: voice quality problems (dropouts), fax transmission errors, no establishment of voice con- nection, and wrong tone or playback.
Page 562 SmartWare Software Configuration Guide 43 • VoIP debugging Traces the ﬂow of T.30 communication states between the fax machines debug dsp t30 (for T.38 Fax transmission only), and logs changes. Gives approx. 10lines of debug output per transmitted fax page. Usage: To debug all T.38 Fax related problems.
Page 563: Check System Logs
SmartWare Software Configuration Guide 43 • VoIP debugging Use the following debug monitors to start with, if you assume that signaling is OK: Step Command Purpose Enable the voip events monitor. unit #debug voip events Enable the T.38 events monitor unit #debug voip t38 events Enable the T.38 dejitter monitor unit #debug voip t38 dejitter...
Page 564 SmartWare Software Configuration Guide 43 • VoIP debugging Note In order to correlate the output of different protocol monitors (e.g. ISDN signaling and gateway SIP signaling), run the monitors concurrently. You can do this either in the same Telnet session, or using different Telnet ses- sions.
Page 565: Terms And Definitions
Appendix A Terms and deﬁnitions Chapter contents Introduction ................................566 SmartWare architecture terms and definitions .....................566...
Page 566: Introduction
Model 3201 G.SHDSL Integrated Access Device User Guide A • Terms and definitions Introduction This chapter contains the terms and their deﬁnitions that are used throughout this SmartWare Software Conﬁg- uration Guide. This guide contains many terms that are related to speciﬁc networking technologies areas such as LAN protocols, WAN technologies, routing, Ethernet, and Frame Relay.
Page 567 Model 3201 G.SHDSL Integrated Access Device User Guide A • Terms and definitions Term or Deﬁnition Meaning Comfort Noise Comfort noise is generated at the remote end of the silent direction to avoid the impression that the connection is dead. See also Silence Com- pression .
Page 568 Model 3201 G.SHDSL Integrated Access Device User Guide A • Terms and definitions Term or Deﬁnition Meaning ﬂash: A region in the persistent memory of a SmartNode. See also flash mem- ory . Gatekeeper Gatekeepers manage H.323 zones, which are logical collections of devices such as all H.323 devices within an IP subnet.
Page 569 Model 3201 G.SHDSL Integrated Access Device User Guide A • Terms and definitions Term or Deﬁnition Meaning Network Management System System responsible for managing at least part of a network. An NMS is generally a reasonably powerful and well-equipped computer, such as an engineering workstation.
Page 570 Model 3201 G.SHDSL Integrated Access Device User Guide A • Terms and definitions Term or Deﬁnition Meaning Startup Conﬁguration The startup conﬁguration is stored in the persistent memory (nvram:) and is always copied for execution to the running conﬁguration in the volatile memory (system:) after a system start-up.
Page 571: Mode Summary
Appendix B Mode summary Chapter contents Introduction ................................572...
Page 572: Mode Overview, 1 Of 3
SmartWare Software Configuration Guide B • Mode summary Introduction Figure 89 on page 572, ﬁgure 90 on page 573, and ﬁgure 91 on page 574 show the conﬁguration mode hierar- chy. Each box contains the mode name, the command to enter in this mode and the mode prompt printed in a Telnet or console session.
Page 573: Mode Overview, 2 Of 3
SmartWare Software Configuration Guide B • Mode summary Gateways Gateway H323 Gateway H323 gateway h323 <name> gateway h323 <name> <host>(gw-h323)[<name>]# <host>(gw-h323)[<name>]# Gateway SIP gateway sip <name> <host>(gw-sip)[<name>]# Ports Port Ethernet PPPoE PPPoE Session port ethernet <slot> <port> session <session> <host>(prt-eth)[<slot>/<port>]# <host>(pppoe)[<slot>/<port>]# <host>(session)[<session>]# Gateway H323...
Page 574: Mode Overview, 3 Of 3
SmartWare Software Configuration Guide B • Mode summary Profiles Profile ACL port ethernet <slot> <port> profile acl <profile_name> Profile Authentication Gateway H323 profile authentication <name> gateway h323 <name> <host>(pf-auth)[<name>]# Profile Call-Progress-Tone Gateway H323 profile call-progress-tone <name> gateway h323 <name> <host>(pf-callp)[<name>]# Profile DHCP Server Gateway H323 profile dhcp-server <name>...
Page 575: Command Summary
Appendix C Command summary Chapter contents Introduction ................................576 New Configuration Commands ..........................577 Other...................................577 Show help ..............................577 Show command history ..........................577 Restart system ...............................577...
Page 576: Introduction
SmartWare Software Configuration Guide C • Command summary Introduction This chapter provides an overview of all CLI commands and modes available. It is organized as follows: Mode Name Enter Command Command 1 … Exit Mode Name … Several commands contain a lot of parameters and arguments. The command syntax is described as follows: •...
Page 577: New Configuration Commands
SmartWare Software Configuration Guide C • Command summary New Conﬁguration Commands The commands documented in the Release Note only cover new additions which are not yet included in the current revision of the Software Conﬁguration Guide. You may download the release notes at www.pat- ton.com/support.
Page 578: Internetworking Terms & Acronyms
Appendix D Internetworking terms & acronyms Chapter contents Abbreviations...............................579...
Page 579: Abbreviations
SmartWare Software Configuration Guide D • Internetworking terms & acronyms Abbreviations Abbreviation Meaning Numeric 10BaseT Ethernet Physical Medium ATM Adaptive Layer Available Bit Rate Alternating Current Advice of Charge Asynchronous Transfer Mode audio 3.1 ISDN Audio Service up to 3.1 kHz audio 7.2 ISDN Audio Service up to 7.2 kHz Basic Rate Access...
Page 580 SmartWare Software Configuration Guide D • Internetworking terms & acronyms Abbreviation Meaning E-DSS1 ETSI Euro ISDN Standard Embedded File System Exchange Termination Ethernet Frequently Asked Questions Federal Communication Commission Frame Relay G.711 ITU-T Voice encoding standard G.723 ITU-T Voice compression standard Graphic User Interface Gateway H.323...
Page 581 SmartWare Software Configuration Guide D • Internetworking terms & acronyms Abbreviation Meaning MIB II Management Information Base II Modem Modulator – Demodulator Multiple Subscriber Number NAPT Network Address Port Translation Network Address Translation Network Interface Card Network Termination Network Termination 1 Network Termination 2 NT2ab Network Termination with 2a/b Connections...
Page 582 SmartWare Software Configuration Guide D • Internetworking terms & acronyms Abbreviation Meaning node-connection for Trunk Line node-connection for Subscriber Line Segmentation and Reassembly S-Bus Subscriber Line (Connection) Bus Switched Circuit Network SCTP Stream Control Transmission Protocol SDSL Symmetric Digital Subscriber Line SGCP Simple Gateway Control Protocol Session Initiation Protocol.
Page 583: Used Ip Ports & Available Voice Codecs
Appendix E Used IP ports & available voice codecs Chapter contents Used IP ports ..............................584 Available voice codecs ............................585...
Page 584: Used Ip Ports
SmartWare Software Configuration Guide E • Used IP ports & available voice codecs Used IP ports Component Port Description UDP 1719 RAS for gatekeeper connection H.323 TCP 1720 Call signaling port for H.323 (adjustable) UDP 4864…5118 (even numbers) Voice data (RTP) UDP 4865…5119 (odd numbers) Voice statistics (RTCP) UDP 5060...
Page 585: Available Voice Codecs
SmartWare Software Configuration Guide E • Used IP ports & available voice codecs Available voice codecs Used Band- Net Band- Min. width per Protocol Codec width per Compression Call (kbps, Usage Call (kbps) Delay (ms) incl. IP header) G.711 A-law Uncompressed, best voice qual- H.323 ity, European audio-digitizing...

This manual is also suitable for:

Smartware release 3.21

Patton electronics SmartNode Series Software Configuration Manual

Summary Table of Contents

Table of Contents

List of Figures

List of Tables

About this Guide

Configuration Concepts

Configuration File Handling

Nat/Napt

SNMP Configuration

DHCP Configuration

Chapter 1 System Overview

Chapter 2 Configuration Concepts

Command Line Interface (CLI)

Chapter 4 Accessing the CLI

Chapter 5 System Image Handling

Chapter 6 Configuration File Handling

Chapter 7 Basic System Management

Chapter 8 RADIUS Client Configuration

Chapter 9 IP Context Overview

Chapter 10 IP Interface Configuration

Chapter 11 NAT/NAPT Configuration

Chapter 12 Ethernet Port Configuration

Chapter 13 Link Scheduler Configuration

Chapter 14 Serial Port Configuration

Quick Links

Troubleshooting

Related Manuals for Patton electronics SmartNode Series

Summary of Contents for Patton electronics SmartNode Series