Page 1
SmartNode Series
SmartWare Release 5.1
Software Configuration Guide
Sales Office: +1 (301) 975-1000
Technical Support: +1 (301) 975-1007
E-mail: support@patton.com
URL: www.patton.com
Document Number: 13211U8-006 Rev. A
Part Number: 07MSWR51_SCG
Revised: February 6, 2008
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 © 2008, Patton Electronics Company. All rights reserved.
Trademark Statement
The terms SmartWare, SmartView, SmartLink, and SmartNode are trademarks of Patton Electronics Company. All other trademarks presented in this document are the property of their respective owners.
Notices
The information contained in this document is not designed or intended for use as critical components in
human life-support systems, equipment used in hazardous environments, or nuclear control systems. Patton
Electronics Company disclaims any express or implied warranty of fitness for such uses.
The information in this document is subject to change without notice. Patton Electronics assumes no liability for errors that may appear in this document.
Any software described in this document is furnished under license and may be used or copied only in accordance with the terms of such license.
Supported Platforms
SmartNode 4110 Series SmartNode 4830 Series SmartNode 4552, 4562
SmartNode 4520 Series SmartNode 4900 Series SmartNode 4554, 4564
SmartNode 4600 Series SmartNode 4960 Smart-DTA
Page 3
Summary Table of Contents
1 System overview ............................................................................................................................................ 38
2 Configuration concepts ................................................................................................................................. 44
3 Command line interface (CLI) ...................................................................................................................... 49
4 Accessing the CLI .......................................................................................................................................... 53
5 System image handling.................................................................................................................................. 64
6 Configuration file handling........................................................................................................................... 75
7 Basic system management ............................................................................................................................. 89
8 RADIUS Client Configuration.................................................................................................................... 101
9 IP context overview ..................................................................................................................................... 112
10 IP interface configuration ........................................................................................................................... 118
11 NAT/NAPT configuration........................................................................................................................... 130
12 Ethernet port configuration ........................................................................................................................ 139
13 Link scheduler configuration ...................................................................................................................... 149
14 Serial port configuration ............................................................................................................................. 168
15 Frame Relay configuration .......................................................................................................................... 175
16 PRI port configuration................................................................................................................................ 189
17 BRI port configuration................................................................................................................................ 203
18 ISDN Overview ........................................................................................................................................... 210
19 ISDN configuration .................................................................................................................................... 215
20 RBS configuration....................................................................................................................................... 223
21 DSL Port Configuration.............................................................................................................................. 228
22 Basic IP routing configuration .................................................................................................................... 233
23 RIP configuration........................................................................................................................................ 240
24 Access control list configuration.................................................................................................................. 251
25 SNMP configuration ................................................................................................................................... 265
26 SNTP client configuration .......................................................................................................................... 280
27 DHCP configuration................................................................................................................................... 290
28 DNS configuration...................................................................................................................................... 302
29 DynDNS configuration............................................................................................................................... 306
30 PPP configuration....................................................................................................................................... 311
31 CS context overview .................................................................................................................................... 337
3
Page 4
4
SmartWare Software Configuration Guide
32 VPN configuration ...................................................................................................................................... 360
33 CS interface configuration........................................................................................................................... 379
34 ISDN interface configuration...................................................................................................................... 388
35 FXS interface configuration......................................................................................................................... 402
36 FXO interface configuration ....................................................................................................................... 409
37 RBS interface configuration ........................................................................................................................ 421
38 H.323 interface configuration ..................................................................................................................... 426
39 SIP interface configuration ......................................................................................................................... 436
40 Call router configuration............................................................................................................................. 451
41 SIP call-router services ................................................................................................................................ 519
42 Tone configuration...................................................................................................................................... 524
43 FXS port configuration ............................................................................................................................... 532
44 FXO port configuration .............................................................................................................................. 537
45 H.323 gateway configuration ...................................................................................................................... 541
46 Context SIP gateway overview..................................................................................................................... 554
47 VoIP profile configuration .......................................................................................................................... 568
48 PSTN profile configuration......................................................................................................................... 592
49 SIP profile configuration............................................................................................................................. 596
50 Authentication Service................................................................................................................................. 599
51 Location Service .......................................................................................................................................... 602
52 VoIP debugging........................................................................................................................................... 615
A Terms and definitions ................................................................................................................................ 635
B Mode summary ........................................................................................................................................... 641
C Command summary ................................................................................................................................... 645
D Internetworking terms & acronyms ........................................................................................................... 648
E Used IP ports & available voice codecs ...................................................................................................... 653
Page 5
Table of Contents
Summary Table of Contents ........................................................................................................................... 3
Table of Contents ........................................................................................................................................... 5
List of Figures ............................................................................................................................................... 27
List of Tables ................................................................................................................................................ 29
About this guide ........................................................................................................................................... 30
Audience............................................................................................................................................................... 30
How to read this guide ......................................................................................................................................... 30
Structure............................................................................................................................................................... 31
Precautions ........................................................................................................................................................... 34
Typographical conventions used in this document................................................................................................ 34
General conventions .......................................................................................................................................34
Mouse conventions .........................................................................................................................................36
Service and support ...............................................................................................................................................36
Patton support headquarters in the USA .........................................................................................................36
Alternate Patton support for Europe, Middle East, and Africa (EMEA) ..........................................................36
Warranty Service and Returned Merchandise Authorizations (RMAs)...................................................................37
Warranty coverage ..........................................................................................................................................37
Returns for credit ......................................................................................................................................37
Return for credit policy .............................................................................................................................37
RMA numbers ................................................................................................................................................37
Shipping instructions ................................................................................................................................37
1 System overview ............................................................................................................................................ 38
Introduction..........................................................................................................................................................39
SmartWare embedded software .............................................................................................................................40
Applications...........................................................................................................................................................41
Carrier networks .............................................................................................................................................41
Enterprise networks ........................................................................................................................................42
LAN telephony ...............................................................................................................................................43
2 Configuration concepts ................................................................................................................................. 44
Introduction..........................................................................................................................................................45
Contexts and Gateways..........................................................................................................................................46
Context ...........................................................................................................................................................46
Gateway ..........................................................................................................................................................46
Interfaces, Ports, and Bindings...............................................................................................................................47
Interfaces ........................................................................................................................................................47
Ports and circuits ............................................................................................................................................47
Bindings ..........................................................................................................................................................47
Profiles and Use commands...................................................................................................................................48
Profiles ............................................................................................................................................................48
Use Commands ..............................................................................................................................................48
5
Page 6
6
SmartWare Software Configuration Guide
Table of Contents
3 Command line interface (CLI) ...................................................................................................................... 49
Introduction..........................................................................................................................................................50
Command modes ..................................................................................................................................................50
CLI prompt ....................................................................................................................................................50
Navigating the CLI .........................................................................................................................................51
Initial mode ..............................................................................................................................................51
System changes ..........................................................................................................................................51
Configuration ...........................................................................................................................................51
Changing Modes .......................................................................................................................................51
Command editing .................................................................................................................................................51
Command help ...............................................................................................................................................51
The No form ..................................................................................................................................................51
Command completion ....................................................................................................................................51
Command history ...........................................................................................................................................52
Command Editing Shortcuts ..........................................................................................................................52
4 Accessing the CLI .......................................................................................................................................... 53
Introduction..........................................................................................................................................................54
Accessing the SmartWare CLI task list...................................................................................................................54
Accessing via the console port .........................................................................................................................55
Console port procedure .............................................................................................................................55
Telnet Procedure .......................................................................................................................................56
Using an alternate TCP listening port for the Telnet server .............................................................................56
Disabling the Telnet server ..............................................................................................................................56
Logging on ......................................................................................................................................................56
Selecting a secure password .............................................................................................................................57
Password encryption .......................................................................................................................................58
Factory preset administrator account .........................................................................................................58
Creating an operator account ....................................................................................................................58
Creating an administrator account ............................................................................................................59
Displaying the CLI version .............................................................................................................................59
Displaying account information ......................................................................................................................59
Switching to another account ..........................................................................................................................60
Checking identity and connected users ...........................................................................................................60
Command index numbers ...............................................................................................................................61
Ending a Telnet or console port session ..........................................................................................................63
Showing command default values ...................................................................................................................63
5 System image handling.................................................................................................................................. 64
Introduction..........................................................................................................................................................65
Memory regions in SmartWare..............................................................................................................................66
System image handling task list .............................................................................................................................67
Displaying system image information ..............................................................................................................68
Copying system images from a network server to Flash memory .....................................................................68
Upgrading the software directly ......................................................................................................................70
Page 7
7
SmartWare Software Configuration Guide
Table of Contents
Auto provisioning of firmware and configuration ..................................................................................................71
Boot procedure......................................................................................................................................................73
Factory configuration ............................................................................................................................................74
Default Startup Configuration ........................................................................................................................74
IP Addresses in the Factory Configuration ......................................................................................................74
6 Configuration file handling........................................................................................................................... 75
Introduction..........................................................................................................................................................76
Understanding configuration files ...................................................................................................................76
Factory configuration ............................................................................................................................................78
Configuration file handling task list.......................................................................................................................78
Copying configurations within the local memory ............................................................................................79
Replacing the startup configuration with a configuration from Flash memory ................................................80
Copying configurations to and from a remote storage location ........................................................................81
Replacing the startup configuration with a configuration downloaded from TFTP server ...............................82
Displaying configuration file information .......................................................................................................82
Modifying the running configuration at the CLI .............................................................................................83
Modifying the running configuration offline ...................................................................................................84
Deleting a specified configuration ...................................................................................................................85
Encrypted file download .................................................................................................................................86
Encrypted Configuration Download .........................................................................................................86
Use Cases ..................................................................................................................................................87
7 Basic system management ............................................................................................................................. 89
Introduction..........................................................................................................................................................90
Basic system management configuration task list ...................................................................................................90
Managing feature license keys .........................................................................................................................91
Setting system information .............................................................................................................................92
Setting the system banner ................................................................................................................................93
Setting time and date ......................................................................................................................................94
Display clock information ...............................................................................................................................94
Display time since last restart ..........................................................................................................................95
Configuring the Web server ............................................................................................................................95
Determining and defining the active CLI version ............................................................................................95
Restarting the system ......................................................................................................................................96
Displaying the system logs ..............................................................................................................................96
Displaying reports ...........................................................................................................................................97
Controlling command execution .....................................................................................................................97
Timed execution of CLI command .................................................................................................................99
Displaying the checksum of a configuration ....................................................................................................99
Configuration of terminal sessions ..................................................................................................................99
8 RADIUS Client Configuration.................................................................................................................... 101
Introduction........................................................................................................................................................102
The AAA component ..........................................................................................................................................102
General AAA Configuration ..........................................................................................................................103
Page 8
8
SmartWare Software Configuration Guide
Table of Contents
RADIUS configuration........................................................................................................................................105
Configuring RADIUS clients ........................................................................................................................106
Configuring RADIUS accounting .................................................................................................................107
Configuring the RADIUS server ...................................................................................................................109
Attributes in the RADIUS request message .............................................................................................109
Attributes in the RADIUS accept message ...............................................................................................110
Configuring the local database accounts ..............................................................................................................110
9 IP context overview ..................................................................................................................................... 112
Introduction........................................................................................................................................................113
IP context overview configuration task list...........................................................................................................114
Planning your IP configuration ...........................................................................................................................115
IP interface related information .....................................................................................................................115
QoS related information ...............................................................................................................................115
Configuring physical ports...................................................................................................................................115
Creating and configuring IP interfaces.................................................................................................................115
Configuring NAPT .............................................................................................................................................116
Configuring static IP routing...............................................................................................................................116
Configuring RIP..................................................................................................................................................116
Configuring access control lists............................................................................................................................117
Configuring quality of service (QoS) ...................................................................................................................117
10 IP interface configuration ........................................................................................................................... 118
Introduction........................................................................................................................................................119
IP interface configuration task list........................................................................................................................119
Creating an IP interface ................................................................................................................................119
Deleting an IP interface ................................................................................................................................120
Setting the IP address and netmask ...............................................................................................................121
Configuring a NAPT DMZ interface ............................................................................................................121
ICMP message processing .............................................................................................................................122
ICMP redirect messages ................................................................................................................................122
Router advertisement broadcast message .......................................................................................................122
Defining the MTU and MSS of the interface ................................................................................................123
Configuring an interface as a point-to-point link ..........................................................................................124
Displaying IP interface information ..............................................................................................................124
Displaying dynamic ARP entries ...................................................................................................................125
Flushing dynamic ARP entries ......................................................................................................................125
Processing gratuitous ARP requests ...............................................................................................................125
Testing connections with the ping command ................................................................................................125
IP link supervision ........................................................................................................................................126
Check connectivity of an IP link .............................................................................................................127
Show IP link status ..................................................................................................................................127
Debug connectivity .................................................................................................................................127
Debug ARP ...................................................................................................................................................127
Traceroute ....................................................................................................................................................128
Page 9
9
SmartWare Software Configuration Guide
Table of Contents
Configuring the IGMP Proxy..............................................................................................................................129
11 NAT/NAPT configuration........................................................................................................................... 130
Introduction........................................................................................................................................................131
Dynamic NAPT ...........................................................................................................................................131
Static NAPT .................................................................................................................................................132
Dynamic NAT ..............................................................................................................................................132
Static NAT ...................................................................................................................................................133
NAPT traversal .............................................................................................................................................133
NAT/NAPT configuration task list .....................................................................................................................134
Creating a NAPT profile ...............................................................................................................................134
Configuring a NAPT DMZ host .............................................................................................................135
Defining NAPT port ranges ....................................................................................................................135
Preserving TCP/UDP port numbers in NAPT ........................................................................................136
Defining the UDP NAPT type ...............................................................................................................136
Activate NAT/NAPT ....................................................................................................................................137
Displaying NAT/NAPT configuration information ......................................................................................137
Configuring NAT static protocol entries .......................................................................................................138
12 Ethernet port configuration ........................................................................................................................ 139
Introduction........................................................................................................................................................140
Ethernet port configuration task list ....................................................................................................................140
Entering the Ethernet port configuration mode ............................................................................................140
Configuring medium for an Ethernet port ....................................................................................................140
Configuring Ethernet encapsulation type for an Ethernet port ......................................................................141
Binding an Ethernet port to an IP interface ..................................................................................................141
Multiple IP addresses on Ethernet ports ........................................................................................................142
Configuring a VLAN ....................................................................................................................................143
Configuring layer 2 CoS to service-class mapping for an Ethernet port .........................................................144
Adding a receive mapping table entry ......................................................................................................145
Adding a transmit mapping table entry ...................................................................................................146
Closing an Ethernet port ...............................................................................................................................146
Using the built-in Ethernet sniffer .......................................................................................................................147
13 Link scheduler configuration ...................................................................................................................... 149
Introduction........................................................................................................................................................150
Applying scheduling at the bottleneck ...........................................................................................................150
Using traffic classes .......................................................................................................................................150
Introduction to Scheduling ...........................................................................................................................151
Priority ....................................................................................................................................................151
Weighted fair queuing (WFQ) ................................................................................................................151
Shaping ...................................................................................................................................................151
Burst tolerant shaping or wfq ..................................................................................................................152
Hierarchy ................................................................................................................................................152
Quick references..................................................................................................................................................153
Setting the modem rate .................................................................................................................................153
Page 10
10
SmartWare Software Configuration Guide
Table of Contents
Command cross reference .............................................................................................................................154
Link scheduler configuration task list...................................................................................................................154
Defining the access control list profile ...........................................................................................................155
Packet classification .................................................................................................................................155
Creating an access control list ..................................................................................................................156
Creating a service policy profile .....................................................................................................................157
Specifying the handling of traffic-classes ........................................................................................................159
Defining fair queuing weight ...................................................................................................................159
Defining the bit-rate ...............................................................................................................................160
Defining absolute priority .......................................................................................................................160
Defining the maximum queue length ......................................................................................................160
Specifying the type-of-service (TOS) field ...............................................................................................160
Specifying the precedence field ................................................................................................................161
Specifying differentiated services codepoint (DSCP) marking .................................................................161
Specifying layer 2 marking ......................................................................................................................162
Defining random early detection .............................................................................................................163
Discarding Excess Load ...........................................................................................................................163
Quality of Service for routed RTP streams ....................................................................................................163
Devoting the service policy profile to an interface .........................................................................................165
Displaying link arbitration status ..................................................................................................................166
Displaying link scheduling profile information .............................................................................................166
Enable statistics gathering .............................................................................................................................166
14 Serial port configuration ............................................................................................................................. 168
Introduction........................................................................................................................................................169
Serial port configuration task list .........................................................................................................................169
Disabling an interface ...................................................................................................................................169
Enabling an interface ....................................................................................................................................170
Configuring the serial encapsulation type ......................................................................................................171
Configuring the hardware port protocol ........................................................................................................171
Configuring the active clock edge ..................................................................................................................172
Configuring the baudrate ..............................................................................................................................173
15 Frame Relay configuration .......................................................................................................................... 175
Introduction........................................................................................................................................................176
Frame Relay configuration task list ......................................................................................................................176
Configuring Frame Relay encapsulation ........................................................................................................176
Configuring the LMI type .............................................................................................................................177
Configuring the keep-alive interval ...............................................................................................................177
Enabling fragmentation ................................................................................................................................178
Entering Frame Relay PVC configuration mode ...........................................................................................179
Configuring the PVC encapsulation type ......................................................................................................180
Binding the Frame Relay PVC to IP interface ...............................................................................................180
Enabling a Frame Relay PVC ........................................................................................................................182
Disabling a Frame Relay PVC .......................................................................................................................182
Page 11
11
SmartWare Software Configuration Guide
Table of Contents
Debugging Frame Relay ................................................................................................................................183
Displaying Frame Relay information .............................................................................................................184
Integrated service access ................................................................................................................................185
Example 1: Frame Relay on e1t1 without a channel-group ...........................................................................187
16 PRI port configuration................................................................................................................................ 189
Introduction........................................................................................................................................................190
PRI port configuration task list............................................................................................................................190
Enable/Disable PRI port ...............................................................................................................................191
Configuring PRI port-type ............................................................................................................................191
Configuring PRI clock-mode ........................................................................................................................191
Configuring PRI line-code ............................................................................................................................191
Configuring PRI framing ..............................................................................................................................192
Configuring PRI line-build-out (E1T1 in T1 mode only) .............................................................................193
Configuring PRI used-connector (E1T1 in E1 mode only) ...........................................................................193
Configuring PRI application mode (E1T1 only) ...........................................................................................193
Configuring PRI LOS threshold (E1T1 only) ...............................................................................................194
Configuring PRI Loopback detection (E1T1 only) .......................................................................................194
Configuring PRI encapsulation .....................................................................................................................195
Create a Channel-Group ...............................................................................................................................196
Configuring Channel-Group Timeslots ........................................................................................................196
Configuring Channel-Group Encapsulation .................................................................................................196
Entering HDLC Configuration Mode ..........................................................................................................197
Configuring HDLC CRC-Type ...................................................................................................................197
Configuring HDLC Encapsulation ...............................................................................................................198
PRI Debugging .............................................................................................................................................198
PRI Configuration Examples ........................................................................................................................199
Example 1: ISDN ....................................................................................................................................200
Example 2: RBS without a channel-group ...............................................................................................200
Example 3: RBS with a channel-group ....................................................................................................200
Example 4: Frame Relay without a channel-group ...................................................................................201
Example 5: Framerelay with a channel-group ..........................................................................................202
Example 6: PPP without a channel-group ...............................................................................................202
Example 7: PPP with a channel-group .....................................................................................................202
17 BRI port configuration................................................................................................................................ 203
Introduction........................................................................................................................................................204
BRI port configuration task list............................................................................................................................204
Enable/Disable BRI port ...............................................................................................................................204
Configuring BRI clock-mode ........................................................................................................................204
Configuring BRI Power-Feed ........................................................................................................................205
Configuring BRI encapsulation .....................................................................................................................205
Creating a channel group ..............................................................................................................................205
Configuring channel-group timeslots ............................................................................................................206
Configuring channel-group encapsulation .....................................................................................................206
Page 12
12
SmartWare Software Configuration Guide
Table of Contents
Entering HDLC configuration mode ............................................................................................................206
Configuring HDLC encapsulation ................................................................................................................206
BRI Debugging .............................................................................................................................................207
BRI Configuration Examples ........................................................................................................................208
Example 1: ISDN with auto clock/uni-side settings ................................................................................208
Example 2: ISDN with manual clock/uni-side settings ............................................................................208
Example 3: Multi-Link PPP over two B-Channels ..................................................................................209
18 ISDN Overview ........................................................................................................................................... 210
Introduction........................................................................................................................................................211
ISDN reference points ..................................................................................................................................211
Possible SmartNode port configurations .......................................................................................................212
ISDN UNI Signaling ....................................................................................................................................212
ISDN Configuration Concept.............................................................................................................................214
ISDN Layering .............................................................................................................................................214
19 ISDN configuration .................................................................................................................................... 215
Introduction........................................................................................................................................................216
ISDN configuration task list................................................................................................................................216
Enter Q.921 configuration mode ..................................................................................................................216
Configuring Q.921 parameters .....................................................................................................................216
Configuring Q.921 encapsulation .................................................................................................................217
Enter Q.931 configuration mode ..................................................................................................................217
Configuring Q.931 parameters .....................................................................................................................218
Configuring Q.931 encapsulation .................................................................................................................220
Debugging ISDN ..........................................................................................................................................220
ISDN Configuration Examples .....................................................................................................................221
20 RBS configuration....................................................................................................................................... 223
Introduction........................................................................................................................................................224
RBS configuration task list ..................................................................................................................................224
Enter RBS configuration mode .....................................................................................................................224
Configuring RBS protocol ............................................................................................................................224
Configuring RBS encapsulation ....................................................................................................................225
Debugging RBS ............................................................................................................................................225
RBS Configuration Examples ........................................................................................................................226
21 DSL Port Configuration.............................................................................................................................. 228
Introduction........................................................................................................................................................229
Line Setup ...........................................................................................................................................................229
Configuring PPPoE.............................................................................................................................................229
Configuration Summary......................................................................................................................................230
Setting up permanent virtual circuits (PVC)........................................................................................................231
Using PVC channels in bridged Ethernet mode ............................................................................................231
Using PVC channels with PPPoE .................................................................................................................231
Diagnostics ...................................................................................................................................................232
Page 13
13
SmartWare Software Configuration Guide
Table of Contents
Troubleshooting DSL Connections.....................................................................................................................232
22 Basic IP routing configuration .................................................................................................................... 233
Introduction........................................................................................................................................................234
Routing tables ...............................................................................................................................................234
Static routing ................................................................................................................................................234
Policy routing ...............................................................................................................................................234
Basic IP routing configuration task list ................................................................................................................234
Configuring static IP routes ..........................................................................................................................235
Deleting static IP routes ................................................................................................................................236
Displaying IP route information ...................................................................................................................236
Configuring policy routing ...........................................................................................................................237
Examples .............................................................................................................................................................238
Basic static IP routing example ......................................................................................................................238
Changing the default UDP port range for RTP and RTCP .................................................................................239
23 RIP configuration........................................................................................................................................ 240
Introduction........................................................................................................................................................241
Routing protocol .................................................................................................................................................241
RIP configuration task list ...................................................................................................................................242
Enabling send RIP ........................................................................................................................................242
Enabling an interface to receive RIP ..............................................................................................................243
Specifying the send RIP version ....................................................................................................................243
Specifying the receive RIP version .................................................................................................................244
Enabling RIP learning ...................................................................................................................................244
Enabling an interface to receive RIP ..............................................................................................................245
Enabling RIP announcing .............................................................................................................................245
Enabling RIP auto summarization ................................................................................................................246
Specifying the default route metric ................................................................................................................246
Enabling RIP split-horizon processing ...........................................................................................................247
Enabling the poison reverse algorithm ...........................................................................................................247
Enabling holding down aged routes ..............................................................................................................248
Setting the RIP route expiry ..........................................................................................................................248
Displaying RIP configuration of an IP interface ............................................................................................249
Displaying global RIP information ................................................................................................................249
24 Access control list configuration.................................................................................................................. 251
Introduction........................................................................................................................................................252
About access control lists .....................................................................................................................................252
What access lists do .......................................................................................................................................252
Why you should configure access lists
When to configure access lists .......................................................................................................................253
Features of access control lists .......................................................................................................................253
Access control list configuration task list..............................................................................................................254
Mapping out the goals of the access control list .............................................................................................254
Creating an access control list profile and enter configuration mode .............................................................255
...........................................................................................................252
Page 14
14
SmartWare Software Configuration Guide
Table of Contents
Adding a filter rule to the current access control list profile ...........................................................................255
Adding an ICMP filter rule to the current access control list profile ..............................................................257
Adding a TCP, UDP or SCTP filter rule to the current access control list profile .........................................259
Binding and unbinding an access control list profile to an IP interface ..........................................................261
Displaying an access control list profile .........................................................................................................262
Debugging an access control list profile .........................................................................................................262
Examples .............................................................................................................................................................264
Denying a specific subnet ..............................................................................................................................264
25 SNMP configuration ................................................................................................................................... 265
Introduction........................................................................................................................................................266
Simple Network Management Protocol (SNMP) ................................................................................................266
SNMP basic components ..............................................................................................................................266
SNMP basic commands ................................................................................................................................266
SNMP management information base (MIB) ...............................................................................................267
Network management framework .................................................................................................................267
Identification of a SmartNode via SNMP............................................................................................................267
SNMP tools.........................................................................................................................................................268
SNMP configuration task list ..............................................................................................................................268
Setting basic system information..........................................................................................................................268
Setting access community information ................................................................................................................270
Setting allowed host information .........................................................................................................................272
Specifying the default SNMP trap target .............................................................................................................272
Displaying SNMP related information ................................................................................................................273
Using the AdventNet SNMP utilities ..................................................................................................................273
Using the MibBrowser ..................................................................................................................................274
Using the TrapViewer ...................................................................................................................................275
Standard SNMP version 1 traps...........................................................................................................................277
SNMP interface traps ..........................................................................................................................................278
26 SNTP client configuration .......................................................................................................................... 280
Introduction........................................................................................................................................................281
SNTP client configuration task list......................................................................................................................281
Selecting SNTP time servers .........................................................................................................................282
Defining SNTP client operating mode ..........................................................................................................282
Defining SNTP local UDP port ....................................................................................................................283
Enabling and disabling the SNTP client .......................................................................................................284
Defining SNTP client poll interval ...............................................................................................................284
Defining SNTP client constant offset to GMT .............................................................................................285
Defining the SNTP client anycast address .....................................................................................................285
Enabling and disabling local clock offset compensation .................................................................................286
Showing SNTP client related information ....................................................................................................287
Debugging SNTP client operation ................................................................................................................287
Recommended public SNTP time servers............................................................................................................288
NIST Internet time service ............................................................................................................................288
Page 15
15
SmartWare Software Configuration Guide
Table of Contents
Additional information on NTP and a list of other NTP servers ...................................................................289
27 DHCP configuration................................................................................................................................... 290
Introduction........................................................................................................................................................291
DHCP-client configuration tasks.........................................................................................................................292
Enable DHCP-client on an IP interface ........................................................................................................292
Release or renew a DHCP lease manually (advanced) ...................................................................................294
Get debug output from DHCP-client ...........................................................................................................294
DHCP-server configuration tasks ........................................................................................................................295
Configure DHCP-server profiles ...................................................................................................................295
Use DHCP-server profiles and enable the DHCP-server ...............................................................................297
Define the bootfile (Option 67) for the DHCP-server ..................................................................................298
Define the TFTP server (Option 66) for the DHCP-server ...........................................................................298
Check DHCP-server configuration and status ...............................................................................................298
Get debug output from the DHCP-server .....................................................................................................299
Configure DHCP-relay .................................................................................................................................300
Create/Modify DHCP-Relay profile .......................................................................................................300
Enable/Disable DHCP-Relay Agent ........................................................................................................301
28 DNS configuration...................................................................................................................................... 302
Introduction........................................................................................................................................................303
DNS configuration task list .................................................................................................................................303
Enabling the DNS resolver ............................................................................................................................303
Enabling the DNS relay ................................................................................................................................304
29 DynDNS configuration............................................................................................................................... 306
Introduction........................................................................................................................................................307
DynDNS configuration task list ..........................................................................................................................307
Creating a DynDNS account ........................................................................................................................307
Configuring the DNS resolver ......................................................................................................................307
Configuring basic DynDNS settings .............................................................................................................308
Configuring the DynDNS server ..................................................................................................................308
Configuring advanced DynDNS settings (optional) ......................................................................................309
Defining a mail exchanger for your hostname .........................................................................................309
Troubleshooting ...........................................................................................................................................309
30 PPP configuration....................................................................................................................................... 311
Introduction........................................................................................................................................................312
PPP configuration task list...................................................................................................................................313
Creating an IP interface for PPP ...................................................................................................................313
Disable interface IP address auto-configuration from PPP .............................................................................315
Creating a PPP subscriber .............................................................................................................................315
Trigger forced reconnect of PPP sessions using a timer .................................................................................317
Disable interface IP address auto-configuration from PPP .............................................................................317
Configuring a PPPoE session ........................................................................................................................317
Configuring PPP over a HDLC Link ............................................................................................................319
Page 16
16
SmartWare Software Configuration Guide
Table of Contents
Creating a PPP profile ...................................................................................................................................319
Configuring the local and remote PPP MRRU .............................................................................................321
Displaying PPP configuration information ...................................................................................................322
Debugging PPP ............................................................................................................................................323
Sample configurations .........................................................................................................................................327
PPP over Ethernet (PPPoE) ..........................................................................................................................327
Without authentication, encapsulation multi, with NAPT ......................................................................327
With authentication, encapsulation PPPoE .............................................................................................327
PPP over a HDLC Link (Serial Port) ............................................................................................................328
Without authentication, numbered interface ...........................................................................................328
With authentication, unnumbered interface ............................................................................................328
PPP over a HDLC Link (E1T1 Port) ............................................................................................................328
Without authentication, numbered interface ...........................................................................................328
PPP Dial-up over ISDN ......................................................................................................................................329
PPP Dialer ....................................................................................................................................................329
Create a dialer .........................................................................................................................................330
Create outbound destinations ..................................................................................................................330
Configure recovery strategy .....................................................................................................................331
Create inbound destinations ....................................................................................................................332
Debug dialer functionality .......................................................................................................................334
Example – Dial-on demand feature .........................................................................................................334
Dial-up .........................................................................................................................................................335
Dial-up on demand .................................................................................................................................335
Dial-up on monitor .................................................................................................................................336
Dial-up nailed .........................................................................................................................................336
.....................................................................................................................................................................336
31 CS context overview .................................................................................................................................... 337
Introduction........................................................................................................................................................338
CS context configuration task list ........................................................................................................................339
Planning the CS configuration ............................................................................................................................339
Configuring general CS settings...........................................................................................................................341
Configuring the clock source ...................................................................................................................341
Debugging the clock source .....................................................................................................................342
Selecting PCM law compression ..............................................................................................................343
Configuring call routing ......................................................................................................................................343
Creating and configuring CS interfaces................................................................................................................344
Specify call routing ........................................................................................................................................344
Configuring dial tones.........................................................................................................................................345
Configuring voice over IP parameters ..................................................................................................................345
Configuring ISDN ports .....................................................................................................................................346
Configuring FXS ports ........................................................................................................................................346
Configuring an H.323 VoIP connection .............................................................................................................346
Configuring a SIP VoIP connection ....................................................................................................................346
Page 17
17
SmartWare Software Configuration Guide
Table of Contents
Activating CS context configuration ....................................................................................................................347
Planning the CS context ...............................................................................................................................350
Configuring general CS settings ....................................................................................................................351
Configuring call routing ................................................................................................................................351
Configuring VoIP settings ............................................................................................................................353
Configuring BRI ports ..................................................................................................................................353
Configuring an H.323 VoIP connection .......................................................................................................354
Activating the CS context configuration ........................................................................................................354
Showing the running configuration ...............................................................................................................356
32 VPN configuration ...................................................................................................................................... 360
Introduction........................................................................................................................................................361
Authentication ..............................................................................................................................................361
Encryption ....................................................................................................................................................361
Transport and tunnel modes .........................................................................................................................362
Permanent IKE Tunnels ..........................................................................................................................362
Key management ..........................................................................................................................................362
VPN configuration task list .................................................................................................................................363
Creating an IPsec transformation profile .......................................................................................................363
Creating an IPsec policy profile .....................................................................................................................363
Creating/modifying an outgoing ACL profile for IPsec .................................................................................365
Configuration of an IP interface and the IP router for IPsec ..........................................................................366
Displaying IPsec configuration information ..................................................................................................366
Debugging IPsec ...........................................................................................................................................367
Key management (IKE) .......................................................................................................................................368
Main differences between manual & IKE IPSEC configurations .............................................................368
Creating an ISAKMP transform profile ...................................................................................................369
Creating an ISAKMP IPSEC policy profile .............................................................................................370
Creating/modifying an outgoing ACL profile for IPSEC .........................................................................371
Configuration of an IP interface and the IP router for IPSEC .................................................................371
Policy matching ......................................................................................................................................371
Sample configuration snippet ..................................................................................................................371
Troubleshooting ...........................................................................................................................................372
Encrypted Voice - Performance considerations ....................................................................................................373
Performance considerations ...........................................................................................................................373
Enabling RTP encryption support.......................................................................................................................373
Using an alternate source IP address for specific destinations...............................................................................374
Sample configurations .........................................................................................................................................375
IPsec tunnel, DES encryption .......................................................................................................................375
SmartNode configuration ........................................................................................................................375
Cisco router configuration .......................................................................................................................376
IPsec tunnel, AES encryption at 256 bit key length, AH authentication with HMAC-SHA1-96 ..................376
SmartNode configuration ........................................................................................................................376
Cisco router configuration .......................................................................................................................376
Page 18
18
SmartWare Software Configuration Guide
Table of Contents
IPsec tunnel, 3DES encryption at 192 bit key length, ESP authentication with HMAC-MD5-96 ................377
SmartNode configuration ........................................................................................................................377
Cisco router configuration .......................................................................................................................377
33 CS interface configuration........................................................................................................................... 379
Introduction........................................................................................................................................................380
CS interface configuration task list ......................................................................................................................380
Creating and configuring CS interfaces................................................................................................................381
Configuring call routing ......................................................................................................................................382
Configuring the interface mapping tables ............................................................................................................383
Configuring the precall service tables...................................................................................................................386
34 ISDN interface configuration...................................................................................................................... 388
Introduction........................................................................................................................................................389
ISDN interface configuration task list..................................................................................................................389
Configuring DTMF dialing (optional) ..........................................................................................................390
Configuring an alternate PSTN profile (optional) .........................................................................................390
Configuring ringback tone on ISDN user-side interfaces ..............................................................................391
Configuring call waiting (optional) ...............................................................................................................391
Disabling call-waiting on ISDN DSS1 network interfaces .............................................................................391
Configuring Call-Hold on ISDN interfaces ..................................................................................................392
Enabling Display Information Elements on ISDN Ports ...............................................................................392
Configuring date/time publishing to terminals (optional) .............................................................................392
Enabling sending the connected party number (COLP) (optional) ...............................................................393
Enabling sending of date and time on ISDN DSS1 network interfaces .........................................................393
Defining the ‘network-type’ in ISDN interfaces ............................................................................................393
ISDN Explicit Call Transfer support (& SIP REFER Transmission) ............................................................393
ISDN Advice of Charge support ...................................................................................................................395
ISDN DivertingLegInformation2 Facility .....................................................................................................399
Transmit Direction .................................................................................................................................399
Receive Direction ....................................................................................................................................399
T1 Caller-Name Support ..............................................................................................................................399
35 FXS interface configuration......................................................................................................................... 402
Introduction........................................................................................................................................................403
FXS interface configuration task list ....................................................................................................................403
Configuring a subscriber number (recommended) ........................................................................................403
Configuring an alternate PSTN profile (optional) .........................................................................................404
Configuring caller-ID presentation (optional) ...............................................................................................404
Configuring flash hook processing (optional) ................................................................................................404
FXS supplementary services description...............................................................................................................405
Call hold .......................................................................................................................................................406
Call waiting ...................................................................................................................................................406
Call waiting reminder ring ............................................................................................................................407
Drop passive call ...........................................................................................................................................407
Drop active call .............................................................................................................................................407
Page 19
19
SmartWare Software Configuration Guide
Table of Contents
Call toggle .....................................................................................................................................................407
Call transfer ..................................................................................................................................................407
Conferencing ................................................................................................................................................408
Call park .......................................................................................................................................................408
36 FXO interface configuration ....................................................................................................................... 409
Introduction........................................................................................................................................................410
FXO services description .....................................................................................................................................411
Creating an FXO interface...................................................................................................................................411
Deleting an FXO interface...................................................................................................................................412
FXO interface configuration task list ...................................................................................................................413
FXO off-hook on caller ID ...........................................................................................................................413
Configuring an alternate PSTN profile (optional) .........................................................................................413
Configuring when the digits are dialed (optional) .........................................................................................414
Configuring the number of rings to wait before answering the call (optional) ...............................................416
Configuring how to detect a call has disconnected (optional) ........................................................................417
Configuring how to detect an outgoing call is connected (optional) ..............................................................418
Configuring the destination of the call ..........................................................................................................419
FXO Mute dialing ........................................................................................................................................419
FXO interface examples ................................................................................................................................420
37 RBS interface configuration ........................................................................................................................ 421
Introduction........................................................................................................................................................422
RBS interface configuration task list ....................................................................................................................422
Creating/Deleting a RBS interface.......................................................................................................................422
Configuring an alternate PSTN profile .........................................................................................................422
Configuring an alternate Tone-Set profile .....................................................................................................423
Configuring B-Channel allocation strategy ...................................................................................................423
Configuring additional disconnect signals .....................................................................................................423
Configuring number of Rings before Off-Hook ............................................................................................424
Configuring ready to dial strategy .................................................................................................................424
RBS interface debugging ...............................................................................................................................424
38 H.323 interface configuration ..................................................................................................................... 426
Introduction........................................................................................................................................................427
H.323 interface configuration task list.................................................................................................................427
Binding the interface to an H.323 gateway ...................................................................................................428
Configuring an alternate VoIP profile (optional) ...........................................................................................429
Configuring CLIP/CLIR support (optional) .................................................................................................430
Enabling ‘early-proceeding’ on H.323 interfaces ...........................................................................................431
Enabling the early call connect (optional) .....................................................................................................431
Enabling the early call disconnect (optional) .................................................................................................432
Enabling the via address support (optional) ...................................................................................................432
Override the default destination call signaling port (Optional) ......................................................................432
Configuring status inquiry settings (optional) ...............................................................................................433
Enabling or disabling overlapped sending support in H.323 .........................................................................434
Page 20
20
SmartWare Software Configuration Guide
Table of Contents
AOC-D Support for H.323 ..........................................................................................................................434
39 SIP interface configuration ......................................................................................................................... 436
Introduction........................................................................................................................................................437
SIP interface configuration task list......................................................................................................................437
Binding the interface to a SIP gateway ..........................................................................................................438
Configure a remote host ................................................................................................................................438
Configuring a local host (Optional) ..............................................................................................................439
Using an alternate VoIP profile (Optional) ...................................................................................................439
Using an alternate SIP profile (Optional) ......................................................................................................440
Using an alternate Tone-Set profile (Optional) .............................................................................................440
Configuring early call connect / disconnect (Optional) .................................................................................441
Configuring address translation (Optional) ...................................................................................................441
Mapping call-control properties in SIP headers .......................................................................................441
Mapping SIP headers to call-control properties .......................................................................................442
Configuring ISDN Redirecting Number Tunneling Over SIP ................................................................442
Enabling SIP RFC Privacy, Asserted-Identity, & Preferred-Identity headers (RFC 3323/3325) ..............443
Updating caller address parameters ..........................................................................................................443
SIP Diversion Header ..............................................................................................................................444
Transmit Direction ...........................................................................................................................445
Receive Direction ..............................................................................................................................445
SIP REFER Transmission (& ISDN Explicit Call Transfer support) ............................................................446
AOC Over SIP (Optional) ............................................................................................................................448
Enabling the session timer (Optional) ...........................................................................................................449
Enabling the SIP penalty-box feature (Optional) ...........................................................................................449
Initiating a new SIP session for redirected SIP calls (Optional) .....................................................................449
Configure the SIP hold method (Optional) ..................................................................................................450
40 Call router configuration............................................................................................................................. 451
Introduction........................................................................................................................................................453
Call router configuration task list.........................................................................................................................455
Map out the goals for the call router .............................................................................................................455
Enable advanced call routing on circuit interfaces .........................................................................................456
Configure general call router behavior ...........................................................................................................456
Configure address completion timeout ....................................................................................................456
Configure default digit collection timeout and terminating character ......................................................457
Configure number prefix for ISDN number types ........................................................................................458
Configure call routing tables .........................................................................................................................459
Create a routing table ..............................................................................................................................459
Called party number routing table ................................................................................................................461
Regular Expressions .................................................................................................................................461
Digit Collection ......................................................................................................................................463
Digit Collection Variants ........................................................................................................................464
Calling party number routing table .........................................................................................................467
Number type routing table ............................................................................................................................467
Page 21
21
SmartWare Software Configuration Guide
Numbering plan routing table .......................................................................................................................468
Name routing table .......................................................................................................................................469
IP address routing table .................................................................................................................................469
URI routing table ..........................................................................................................................................470
Presentation Indicator Routing Table ...........................................................................................................470
Screening Indicator Routing Table ...............................................................................................................471
Information transfer capability routing table .................................................................................................472
Call-router support for redirecting number and redirect reason .....................................................................473
Time of day routing table ..............................................................................................................................474
Day of Week Routing Table .........................................................................................................................474
Date routing table .........................................................................................................................................474
Deleting routing tables ..................................................................................................................................475
Configure mapping tables .............................................................................................................................476
E.164 to E.164 Mapping Tables ...................................................................................................................480
Custom SIP URIs from called-/calling-e164 properties .................................................................................483
Other mapping tables ...................................................................................................................................483
Deleting mapping tables ...............................................................................................................................484
Creating complex functions ..........................................................................................................................485
Deleting complex functions ..........................................................................................................................486
Digit collection & sending-complete behavior ..............................................................................................487
Sending-Complete ..................................................................................................................................487
Ingress interface .......................................................................................................................................487
Call-Router .............................................................................................................................................488
Egress Interface .......................................................................................................................................490
Creating call services .....................................................................................................................................492
Creating a hunt group service ........................................................................................................................492
Creating a distribution group service .............................................................................................................501
Distribution-Group Min-Concurrent setting ................................................................................................503
Call-router ‘limiter’ service ............................................................................................................................503
Priority service ..............................................................................................................................................504
CS Bridge service—‘VoIP Leased Line’ .........................................................................................................506
Configuring the service second-dialtone ........................................................................................................508
Deleting call services .....................................................................................................................................509
Activate the call router configuration ............................................................................................................509
Test the call router configuration ..................................................................................................................510
Configure partial rerouting ...........................................................................................................................516
Call reroute .............................................................................................................................................517
Enable acceptation of rerouting requests on ISDN. ...........................................................................517
Enable emission of rerouting requests on ISDN. ...............................................................................517
Enable sending of “302 moved temporary” message on SIP. .............................................................517
Allow Push-Back .....................................................................................................................................517
Enable push-back – aaa service ..........................................................................................................517
Enable push-back – bridge service .....................................................................................................518
Enable push-back – distribution-group service ..................................................................................518
Table of Contents
Page 22
22
SmartWare Software Configuration Guide
Table of Contents
Enable push-back – hunt group service .............................................................................................518
Enable push-back – limiter service ....................................................................................................518
Enable push-back – priority service ...................................................................................................518
41 SIP call-router services ................................................................................................................................ 519
Introduction........................................................................................................................................................520
SIP conference-service .........................................................................................................................................520
SIP conference-service configuration task list ................................................................................................520
Entering conference-service configuration mode .....................................................................................520
Configuring the call routing destination ..................................................................................................520
Configuring the conference server ...........................................................................................................521
SIP location-service..............................................................................................................................................521
SIP location-service configuration task list ....................................................................................................522
Entering SIP location-service configuration mode ...................................................................................522
Binding a location service ........................................................................................................................523
Configuring multi-contact behavior ........................................................................................................523
Configuring the hunt timeout .................................................................................................................523
42 Tone configuration...................................................................................................................................... 524
Introduction........................................................................................................................................................525
Tone-set profiles..................................................................................................................................................525
Tone configuration task list .................................................................................................................................526
Configuring call-progress-tone profiles ..........................................................................................................526
Configure tone-set profiles ............................................................................................................................527
Enable tone-set profile ..................................................................................................................................528
Show call-progress-tone and tone-set profiles ................................................................................................529
43 FXS port configuration ............................................................................................................................... 532
Introduction........................................................................................................................................................533
Shutdown and enable FXS ports..........................................................................................................................533
Bind FXS ports to higher layer applications .........................................................................................................534
Configure country-specific FXS port parameters..................................................................................................534
Other FXS port parameters..................................................................................................................................535
Example ..............................................................................................................................................................535
44 FXO port configuration .............................................................................................................................. 537
Introduction........................................................................................................................................................538
Shutdown and enable FXO ports.........................................................................................................................538
Bind FXO ports to higher layer applications........................................................................................................538
Configure country specific FXO port parameters.................................................................................................539
Other FXO port parameters ................................................................................................................................539
45 H.323 gateway configuration ...................................................................................................................... 541
Introduction........................................................................................................................................................542
Gateway configuration task list............................................................................................................................543
Binding the gateway to an IP interface ..........................................................................................................543
Enable the gateway ........................................................................................................................................543
Page 23
SmartWare Software Configuration Guide Table of Contents
Configure registration authentication service (RAS) (Optional) ....................................................................544
Configure H.235 Security (optional) ............................................................................................................545
H.235 configuration .....................................................................................................................................546
Advanced configuration options (optional) ...................................................................................................549
Enabling H.245 Tunneling .....................................................................................................................549
Enabling the fastconnect procedure .........................................................................................................550
Enabling the early H.245 procedure ........................................................................................................550
Changing the TCP port for inbound call-signaling connections ..............................................................551
Configuring the traffic class for H.323 signaling .....................................................................................551
Setting the response timeout ...................................................................................................................551
Setting the connect timeout ....................................................................................................................552
Configuring the terminal type for registration with the gatekeeper ..........................................................552
Troubleshooting ...........................................................................................................................................553
46 Context SIP gateway overview..................................................................................................................... 554
Introduction........................................................................................................................................................555
Context SIP Gateway configuration task list........................................................................................................556
Creating a context SIP gateway .....................................................................................................................556
Creating a transport interface ........................................................................................................................557
Configuring the IP binding ...........................................................................................................................557
Configuring a priority ...................................................................................................................................557
Configuring a spoofed contact address ..........................................................................................................558
Binding location services ...............................................................................................................................558
Enabling/disabling the context SIP gateway ..................................................................................................558
Troubleshooting..................................................................................................................................................559
Show status information ...............................................................................................................................559
Debug commands .........................................................................................................................................559
Configuration Examples ......................................................................................................................................560
Example 1 .....................................................................................................................................................560
Example 2 .....................................................................................................................................................560
Example 3 .....................................................................................................................................................560
Applications.........................................................................................................................................................561
Outbound Authentication ............................................................................................................................561
Inbound Authentication ...............................................................................................................................562
Outbound Registration .................................................................................................................................563
Inbound Registration ....................................................................................................................................565
B2B User Agent with Registered Clients .......................................................................................................566
47 VoIP profile configuration .......................................................................................................................... 568
Introduction........................................................................................................................................................569
VoIP profile configuration task list ......................................................................................................................570
Creating a VoIP profile .................................................................................................................................570
Configure codecs ..........................................................................................................................................571
Configuring the transparent-clearmode codec ...............................................................................................573
Configuring the Cisco versions of the G.726 codecs .....................................................................................573
23
Page 24
SmartWare Software Configuration Guide Table of Contents
Configuring DTMF relay .............................................................................................................................574
Configuring RTP payload types ....................................................................................................................574
Configuring RTP payload type for transparent-clearmode ............................................................................575
Configuring RTP payload types for the g726-32k and g726-32k-cisco coders ..............................................575
Configuring RTP payload type for Cisco NSE ..............................................................................................575
Configuring Cisco NSE for Fax ....................................................................................................................575
Configuring the dejitter buffer (advanced) ....................................................................................................576
Enabling/disabling filters (advanced) .............................................................................................................578
Configuring Fax transmission .......................................................................................................................579
T.38 CED retransmission .............................................................................................................................582
T.38 No-Signal Retransmission ....................................................................................................................583
Fax bypass method ........................................................................................................................................583
Configuring fax failover ................................................................................................................................583
Configuring modem transmission .................................................................................................................584
Modem bypass method .................................................................................................................................584
Configuring the traffic class for Voice and Fax data ......................................................................................585
Configuring IP-IP codec negotiation .............................................................................................................585
Examples .............................................................................................................................................................586
Home office in an enterprise network ...........................................................................................................586
Home office with fax ....................................................................................................................................588
Soft phone client gateway ..............................................................................................................................589
48 PSTN profile configuration......................................................................................................................... 592
Introduction........................................................................................................................................................593
PSTN profile configuration task list ....................................................................................................................593
Creating a PSTN profile ...............................................................................................................................593
Configuring the echo canceller ......................................................................................................................594
Configuring output gain ...............................................................................................................................594
49 SIP profile configuration............................................................................................................................. 596
Introduction........................................................................................................................................................597
SIP profile configuration task list.........................................................................................................................597
Entering the configuration mode for a SIP profile .........................................................................................597
Mapping from a SIP disconnect cause ...........................................................................................................597
Mapping to a SIP cause .................................................................................................................................598
Mapping from a SIP redirection reason .........................................................................................................598
Mapping to a SIP redirection code ................................................................................................................598
50 Authentication Service................................................................................................................................. 599
Introduction........................................................................................................................................................600
Authentication Service configuration task list ......................................................................................................600
Creating an Authentication Service ...............................................................................................................600
Configuring a Realm .....................................................................................................................................601
Configuring the authentication protocol .......................................................................................................601
Creating credentials ......................................................................................................................................601
Configuration Examples ......................................................................................................................................601
24
Page 25
SmartWare Software Configuration Guide Table of Contents
51 Location Service .......................................................................................................................................... 602
Introduction........................................................................................................................................................603
Location Service configuration task list................................................................................................................603
Creating a Location Service ...........................................................................................................................603
Adding a domain ..........................................................................................................................................603
Creating an identity ......................................................................................................................................604
Authentication outbound face .................................................................................................................605
Authentication inbound face ...................................................................................................................606
Registration outbound face ......................................................................................................................608
Registration inbound face ........................................................................................................................610
Call outbound face ..................................................................................................................................611
Call inbound face ....................................................................................................................................612
Creating an identity group ............................................................................................................................613
Inheriting from an identity group to an identity ...........................................................................................613
Configuration Examples ......................................................................................................................................614
52 VoIP debugging........................................................................................................................................... 615
Introduction........................................................................................................................................................616
Debugging strategy..............................................................................................................................................616
Filtering debug monitor output...........................................................................................................................617
Verifying IP connectivity.....................................................................................................................................617
Debugging call signaling......................................................................................................................................618
Debugging ISDN signaling ...........................................................................................................................618
Verify an incoming call ...........................................................................................................................619
Verify an outgoing call ............................................................................................................................620
Verify ISDN layer 2 and 3 status .............................................................................................................622
Debugging FXS Signaling .............................................................................................................................623
Verify an incoming call ...........................................................................................................................623
Verify an outgoing call ............................................................................................................................624
Debugging H.323 Signaling .........................................................................................................................625
Verify an incoming call ...........................................................................................................................625
Verify an outgoing call ............................................................................................................................627
Debugging SIP signaling ...............................................................................................................................629
Verify an incoming call ...........................................................................................................................629
Verify an outgoing call ............................................................................................................................629
Using SmartWare’s internal call generator .....................................................................................................630
Debugging voice data ..........................................................................................................................................631
Check system logs .........................................................................................................................................633
How to submit trouble reports to Patton ......................................................................................................633
A Terms and definitions ................................................................................................................................ 635
Introduction........................................................................................................................................................636
SmartWare architecture terms and definitions .....................................................................................................636
B Mode summary ........................................................................................................................................... 641
Introduction........................................................................................................................................................642
25
Page 26
SmartWare Software Configuration Guide Table of Contents
C Command summary ................................................................................................................................... 645
Introduction........................................................................................................................................................646
New Configuration Commands ..........................................................................................................................647
Other...................................................................................................................................................................647
Show help .....................................................................................................................................................647
Show command history ................................................................................................................................647
Restart system ...............................................................................................................................................647
D Internetworking terms & acronyms ........................................................................................................... 648
Abbreviations.......................................................................................................................................................649
E Used IP ports & available voice codecs ...................................................................................................... 653
Used IP ports ......................................................................................................................................................654
Available voice codecs .........................................................................................................................................655
26
Page 27
List of Figures
1 Basic system (abstract) model . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 40
2 Typical carrier network application with a SmartNode. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 41
3 Typical enterprise network with SmartNode . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 42
4 Typical LAN telephony system with a SmartNode gateway . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 43
5 Configuration concept overview . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 45
6 Setup for initial configuration via the console port . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 55
7 Login display . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 57
8 SmartNode memory regions logically defined in SmartWare . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 67
9 Boot procedure . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 73
10 Sample configuration file . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 78
11 Local memory regions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 79
12 Remote memory regions for SmartWare . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 81
13 System banner with message to operators . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 93
14 Authentication procedure with a RADIUS server . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 103
15 How to use AAA methods and AAA profiles . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 103
16 IP context and related elements . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 113
17 Dynamic NAPT . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 132
18 Static NAPT . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 132
19 Dynamic NAT . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 133
20 Static NAT . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 133
21 Binding of an Ethernet port to an IP interface . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 142
22 Packet routing in SmartWare . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 151
23 Example of Hierarchical Scheduling . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 153
24 Elements of link scheduler configuration . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 155
25 Scenario with Web server regarded as a single source host . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 156
26 Structure of a Service-Policy Profile . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 158
27 Using a Service Policy Profile on an IP Interface . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 165
28 IP interface wan is bound to PVC 1 on port serial 0 0 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 181
29 Typical Integrated Service Access Scenario with dedicated PVCs . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 185
30 IP Context with logical IP interfaces bound to Ethernet port, serial port PVC 1 and PVC 2 . . . . . . . . . . . . . 186
31 ISDN reference points . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 211
32 ISDN signaling side . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 212
33 Integration of ISDN access lines . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 213
34 ISDN layering model . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 214
35 PBX connected to ISDN port 1/0 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 222
36 Configuring the G.SHDSL card for PPPoE . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 229
37 Internetwork with three routers and four networks . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 238
38 Using traffic filters to prevent traffic from being routed to a network . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 253
39 Deny a specific subnet on an interface . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 264
40 AdventNet MibBrowser displaying some of the System Group objects . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 270
41 AdventNet MibBrowser Settings Button on the Toolbar . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 274
42 AdventNet TrapViewer displaying received traps . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 275
43 AdventNet Trap Details window of TrapViewer . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 276
44 DHCP-client and DHCP-server . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 292
45 DNS relay diagram . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 304
46 PPP configuration overview . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 312
47 CS context configuration components . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 338
27
Page 28
SmartWare Software Configuration Guide
48 Remote office in an Enterprise network . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 340
49 Direct call routing from one SmartNode to another . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 344
50 SmartNode in an Enterprise network . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 349
51 CS Configuration . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 350
52 CS interfaces on the CS context . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 380
53 Incoming call passing an interface mapping table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 385
54 Call passing an input and an output mapping table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 386
55 ISDN interfaces on the CS context . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 389
56 Example SIP network connecting two device to give a home office access to the CO PBX . . . . . . . . . . . . . . . 394
57 FXS interfaces on the CS context . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 403
58 FXO interfaces on the CS context . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 410
59 H.323 interfaces on the CS context . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 427
60 SIP interfaces on the CS context . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 437
61 Example SIP network connecting two devices to give a home office access to the CO PBX . . . . . . . . . . . . . . 447
62 Direct call routing vs. advanced call routing . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 454
63 Routing table outline . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 459
64 Mapping table outline . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 476
65 Mapping table examples . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 479
66 Hunt group service . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 493
67 Distribution group service . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 501
68 Distribution group service examples . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 502
69 ‘Limiter’ service diagram . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 504
70 Priority service diagram . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 505
71 CS Bridge service—‘VoIP Leased Line’ diagram . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 506
72 Bridge services diagram . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 507
73 Call routing example network . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 512
74 CS context and call router elements . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 514
75 Registration and Lookup . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 522
76 Assign tone-sets to a PSTN interfaces . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 526
77 Gateway between IP and CS contexts . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 542
78 Routing Architecture . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 555
79 VoIP profile association . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 569
80 DTMF Relay . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 574
81 Jitter and dejitter buffer . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 576
82 Adaptive versus static dejitter buffer . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 577
83 Multiple tandem and sequential post filtering . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 578
84 Fax relay and Fax bypass . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 580
85 Home office in an enterprise network . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 586
86 PSTN profile association . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 593
87 Echo Cancellation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 594
88 Applying output gain . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 594
89 Mode overview, 1 of 3 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 642
90 Mode Overview, 2 of 3 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 643
91 Mode Overview, 3 of 3 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 644
92 EBNF syntax . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 646
28
Page 29
List of Tables
1 General conventions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 34
2 Mouse conventions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 36
3 Command edit shortcuts . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 52
4 Command cross reference . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 154
5 TOS values and their meaning . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 161
6 Traffic control info (TCI) field . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 162
7 Values defining detail of the queuing statistics . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 167
8 PVC Commands . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 231
9 PVC channels in bridged Ethernet mode . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 231
10 PVC channels in PPPoE mode . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 231
11 Diagnostics commans . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 232
12 Details available in the Trap Details window . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 276
13 Time servers operated by NIST . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 288
14 FXS services with permanent patterns . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 405
15 FXS services with configurable patterns . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 405
16 ISDN number types . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 458
17 Routing table types . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 459
18 Wildcard symbols used as keys in E.164 tables (calling-e164, called-e164) . . . . . . . . . . . . . . . . . . . . . . . . . . . 462
19 Wildcard symbols used as keys in E.164 tables (calling-e164, called-e164) . . . . . . . . . . . . . . . . . . . . . . . . . . . 463
20 Mapping table types . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 477
21 Hunt group drop causes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 495
29
Page 30
About this guide
The objective of this SmartWare Software Configuration Guide is to provide information concerning the syntax
and usage of the command set. For hardware specfic information, refer to the getting started guide that came
with your unit.
This section describes the following:
• Who should use this guide (see “Audience”)
• How this document is organized (see “Structure”)
• Typographical conventions and terms used in this guide (see “Typographical conventions used in this docu-
ment” on page 34)
Audience
This guide is intended for the following users:
• System administrators who are responsible for installing and configuring networking equipment and who
are familiar with the SmartWare.
• System administrators with a basic networking background and experience, but who might not be familiar
with the SmartWare.
• Operators
• Installers
• Maintenance technicians
How to read this guide
SmartWare is a complex and multifaceted operating system. Without the necessary theoretical background you
will not be able to understand and use all the features available. Therefore, we recommend reading at least the
chapters listed below to get a general idea about SmartWare and the philosophy of contexts used for IP and circuit switching related configuration.
• Appendix A, "Terms and definitions" on page 635 contains the terms and their definitions that are used
throughout this SmartWare Software Configuration Guide
• Chapter 1, "System overview" on page 38 provides an overview of the main elements of a SmartWare sys-
tem.
• Chapter 9, "IP context overview" on page 112
• Chapter 31, "CS context overview" on page 337
30
Page 31
SmartWare Software Configuration Guide About this guide
Structure
This guide contains the following chapters and appendices:
• Chapter 1, "System overview" on page 38 provides an overview of the main elements of a SmartWare system.
• Chapter 2, "Configuration concepts" on page 44 introduces basic SmartWare configuration concepts.
• Chapter 3, "Command line interface (CLI)" on page 49 gives an overview of the CLI and the basic features
that allow you to navigate the CLI and edit commands effectively.
• Chapter 4, "Accessing the CLI" on page 53 describes the procedures for entering SmartWare commands via
the command line interface (CLI), to obtain help, to change operator mode and to terminate a session.
• Chapter 5, "System image handling" on page 64 describes how to load and maintain system images and
driver software.
• Chapter 6, "Configuration file handling" on page 75 describes how to upload and download configuration
files from and to a SmartNode.
• Chapter 7, "Basic system management" on page 89 describes parameters that report basic system informa-
tion to the operator or administrator, and their configuration.
• Chapter 8, "RADIUS Client Configuration" on page 101 provides an overview of the authentication,
authorization, and accounting (AAA) component in SmartWare and describes how to configure the
RADIUS client, a subpart of the AAA component.
• Chapter 9, "IP context overview" on page 112 outlines SmartWare Internet protocol (IP) context, together
with its related components.
• Chapter 10, "IP interface configuration" on page 118 provides a general overview of SmartNode interfaces
and describes the tasks involved in their configuration.
• Chapter 11, "NAT/NAPT configuration" on page 130 provides a general overview of the network address
port translation and describes the tasks involved in its configuration.
• Chapter 12, "Ethernet port configuration" on page 139 provides an overview of Ethernet ports and
describes the tasks involved in their configuration through SmartWare.
• Chapter 13, "Link scheduler configuration" on page 149 describes how to use and configure SmartWare
quality of service (QoS) features.
• Chapter 14, "Serial port configuration" on page 168 provides an overview of the serial port and describes
the tasks involved in its configuration through SmartWare.
• Chapter 15, "Frame Relay configuration" on page 175 provides an overview of how to configure frame relay
through SmartWare.
• Chapter 16, "PRI port configuration" on page 189 provides an overview of the T1/E1 ports, their charac-
teristics and the tasks involved in the configuration.
• Chapter 17, "BRI port configuration" on page 203 provides an overview of the BRI (Basic Rate Interface)
ports, their characteristics and the tasks involved in the configuration.
• Chapter 18, "ISDN Overview" on page 210 provides an overview of ISDN ports and describes the tasks
involved in configuring ISDN ports in SmartWare.
31
Page 32
SmartWare Software Configuration Guide About this guide
• Chapter 19, "ISDN configuration" on page 215 describes the configuration of the Q.921 and Q.931 proto-
col and how to bind the ISDN protocol to an application.
• Chapter 20, "RBS configuration" on page 223 describes the configuration of the Robbed Bit Signaling
(RBS) protocol and how to bind it to the Call Control application.
• Chapter 37, "RBS interface configuration" on page 421 provides an overview of RBS interfaces, and the
tasks involved in their configuration.
• Chapter 21, "DSL Port Configuration" on page 228 provides an overview of the the DSL ports (ADSL and
G.SHDSL), their characteristics and the tasks involved in the configuration.
• Chapter 22, "Basic IP routing configuration" on page 233 provides an overview of IP routing and describes
the tasks involved in configuring static IP routing in SmartWare.
• Chapter 23, "RIP configuration" on page 240 provides an overview of the routing information protocol
(RIP) and describes the tasks involved in configuring RIP features within SmartWare.
• Chapter 24, "Access control list configuration" on page 251 provides an overview of IP access control lists
and describes the tasks involved in their configuration through SmartWare.
• Chapter 25, "SNMP configuration" on page 265 on page 238 provides overview information about the
simple network management protocol (SNMP) and describes the tasks used to configure those of its features
supported by SmartWare.
• Chapter 26, "SNTP client configuration" on page 280 describes how to configure a simple network time pro-
tocol (SNTP) client.
• Chapter 27, "DHCP configuration" on page 290 provides an overview of the dynamic host configuration
control protocol (DHCP) and describes the tasks involved in its configuration.
• Chapter 28, "DNS configuration" on page 302 describes how to configure the domain name system
(DNS) component.
• Chapter 29, "DynDNS configuration" on page 306 describes configuring the dynamic DNS
(DynDNS) service.
• Chapter 30, "PPP configuration" on page 311 describes how to configure the point-to-point protocol over
different link layers.
• Chapter 31, "CS context overview" on page 337 gives an overview of SmartWare circuit-switching (CS) con-
text and its associated components and describes the tasks involved in its configuration.
• Chapter 32, "VPN configuration" on page 360 describes how to configure the VPN connections between
two SmartNodes or between a SmartNode and a third-party device.
• Chapter 33, "CS interface configuration" on page 379 gives an overview of interfaces in the CS context and
describes the tasks involved its configuration.
• Chapter 34, "ISDN interface configuration" on page 388 provides an overview of ISDN interfaces, and the
tasks involved in their configuration.
• Chapter 35, "FXS interface configuration" on page 402 provides an overview of FXS interfaces, and the
tasks involved their configuration.
32
Page 33
SmartWare Software Configuration Guide About this guide
• Chapter 36, "FXO interface configuration" on page 409 provides an overview of FXO interfaces and the
tasks involved in configuring them.
• Chapter 38, "H.323 interface configuration" on page 426 provides an overview of H.323 interfaces used by
H.323 gateways and describes the specific tasks involved in their configuration.
• Chapter 39, "SIP interface configuration" on page 436 provides an overview of SIP interfaces used by SIP
gateways and describes the specific tasks involved in their configuration.
• Chapter 40, "Call router configuration" on page 451 provides an overview of call router tables, mapping
tables and call services and describes the tasks involved in configuring the call router in SmartWare.
• Chapter 41, "SIP call-router services" on page 519 provides an overview of specific SIP call router services
in SmartWare.
• Chapter 42, "Tone configuration" on page 524 gives an overview of SmartWare call-progress-tone profiles
and tone-set profiles and describes the tasks involved in their configuration.
• Chapter 43, "FXS port configuration" on page 532 provides an overview of POTS signaling and Smart-
Node FXS ports and describes the tasks involved in configuring FXS ports in SmartWare.
• Chapter 44, "FXO port configuration" on page 537 provides an overview of POTS signaling and Smart-
Node FXO ports and describes the tasks involved in configuring FXO ports in SmartWare.
• Chapter 45, "H.323 gateway configuration" on page 541 provides an overview of the H.323 gateway and
describes the tasks involved in its configuration.
• Chapter 46, "Context SIP gateway overview" on page 554 provides an overview of the SIP gateway and
describes the tasks involved in its configuration.
• Chapter 47, "VoIP profile configuration" on page 568 gives an overview of SmartWare VoIP profiles, how
they are used and describes the tasks involved in VoIP profile configuration.
• Chapter 48, "PSTN profile configuration" on page 592 gives an overview of SmartWare PSTN profiles, and
describes how they are used and the tasks involved in PSTN profile configuration.
• Chapter 49, "SIP profile configuration" on page 596 gives an overview of mappings between SIP codes and
Q.931 causes.
• Chapter 50, "Authentication Service" on page 599 explains how to create and manage authentication ser-
vices in SmartWare.
• Chapter 51, "Location Service" on page 602 explains how to configure location services in SmartWare.
• Chapter 52, "VoIP debugging" on page 615 helps you to localize a system component that is responsible for
faults during operation of a SmartNode device.
• Appendix A, "Terms and definitions" on page 635 contains the terms and their definitions that are used
throughout this SmartWare Software Configuration Guide.
• Appendix B, "Mode summary" on page 641 illustrates the modes hierarchy.
• Appendix C, "Command summary" on page 645 is a command reference.
• Appendix D, "Internetworking terms & acronyms" on page 648 contains terms and definitions relating to
internetworking.
33
Page 34
SmartWare Software Configuration Guide About this guide
• Appendix E, "Used IP ports & available voice codecs" on page 653 describes the used IP ports and available
voice codecs in SmartWare.
• Appendix F, "Notes for upgrading from R3.10 to R3.20" on page 618 describes how to upgrade a
SmartNode device from Release 3.10 to 3.20.
Precautions
The following are used in this guide to help you become aware of potential problems:
Note A note presents additional information or interesting sidelights.
The alert symbol and IMPORTANT heading calls attention to
important information.
IMPORTANT
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. The procedures
described in this manual use the following text conventions:
Table 1. General conventions
Convention Meaning
Garamond blue type
Futura bold type Commands and keywords are in boldface font.
Futura bold-italic type Parts of commands, which are related to elements already named by the
Italicized Futura type Variables for which you supply values are in italic font
Garamond italic type
Garamond bold type
< >
[ ] Elements in square brackets are optional.
{a | b | c} Alternative but required keywords are grouped in braces ({ }) and are sepa-
node The leading IP address or nodename of a SmartNode is substituted with
node The leading node on a command line represents the nodename of the
Indicates a cross-reference hyperlink that points to a figure, graphic, table, or
section heading. Clicking on the hyperlink jumps you to the reference. When
you have finished reviewing the reference, click on the Go to Previous
View button in the Adobe® Acrobat® Reader toolbar to return to your
starting point.
user, are in boldface italic font.
Indicates the names of fields or windows.
Indicates the names of command buttons that execute an action.
Angle brackets indicate function and keyboard keys, such as <shift>,
<ctrl>, <c>, and so on.
rated by vertical bars ( | )
node in boldface italic font.
SmartNode
34
Page 35
SmartWare Software Configuration Guide About this guide
Table 1. General conventions
Convention Meaning
# An hash sign at the beginning of a line indicates a comment line.
35
Page 36
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 configuration).
Right mouse button This button refers the secondary or rightmost mouse button (unless you have
changed the default configuration).
Point This word means to move the mouse in such a way that the tip of the pointing
arrow on the screen ends up resting at the desired location.
Click Means to quickly press and release the left or right mouse button (as instructed in
the procedure). Make sure you do not move the mouse pointer while clicking a
mouse button.
Double-click Means to press and release the same mouse button two times quickly
Drag This word means to point the arrow and then hold down the left or right mouse but-
ton (as instructed in the procedure) as you move the mouse to a new location.
When you have moved the mouse pointer to the desired location, you can release
the mouse button.
Service and support
Patton Electronics offers a wide array of free technical services. If you have questions about any of our other
products we recommend you begin your search for answers by using our technical knowledge base. Here, we
have gathered together many of the more commonly asked questions and compiled them into a searchable
database to help you quickly solve your problems.
Patton support headquarters in the USA
• Online support: Available at www.patton.com
• E-mail support: E-mail sent to support@patton.com will be answered within 1 business day
• Telephone support: Standard telephone support is available five days a week—from 8:00 am to
5:00 pm EST (1300 to 2200 UTC/GMT)—by calling +1 (301) 975-1007
• Support via VoIP: Contact Patton free of charge by using a VoIP ISP phone to call
sip:support@patton.com
• Fax: +1 (253) 663-5693
Alternate Patton support for Europe, Middle East, and Africa (EMEA)
• Online support: Available at www.patton-inalp.com
• E-mail support: E-mail sent to support@patton-inalp.com will be answered within 1 business day
• Telephone support: Standard telephone support is available five days a week—from 8:00 am to
5:00 pm CET (0900 to 1800 UTC/GMT)—by calling +41 (0)31 985 25 55
• Fax: +41 (0)31 985 25 26
Service and support 36
Page 37
SmartWare Software Configuration Guide About this guide
Warranty Service and Returned Merchandise Authorizations (RMAs)
Patton Electronics is an ISO-9001 certified manufacturer and our products are carefully tested before shipment. 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. It is often more convenient for you to work with your local reseller to obtain a replacement.
Patton services our products no matter how you acquired them.
Warranty coverage
Our products are under warranty to be free from defects, and we will, at our option, repair or replace the product should it fail within one year from the first date of shipment. Our warranty is limited to defects in workmanship or materials, and does not cover customer damage, lightning or power surge damage, abuse, or
unauthorized modification.
Returns for credit
Customer satisfaction is important to us, therefore any product may be returned with authorization within 30
days from the shipment date for a full credit of the purchase price. If you have ordered the wrong equipment or
you are dissatisfied in any way, please contact us to request an RMA number to accept your return. Patton is
not responsible for equipment returned without a Return Authorization.
Return for credit policy
• Less than 30 days: No Charge. Your credit will be issued upon receipt and inspection of the equipment.
• 30 to 60 days: We will add a 20% restocking charge (crediting your account with 80% of the purchase price).
• Over 60 days: Products will be accepted for repairs only.
RMA numbers
RMA numbers are required for all product returns. You can obtain an RMA by doing one of the following:
• Completing a request on the RMA Request page in the Support section at www.patton.com
• By calling +1 (301) 975-1007 and speaking to a Technical Support Engineer
• By sending an e-mail to returns@patton.com
All returned units must have the RMA number clearly visible on the outside of the shipping container. Please use
the original packing material that the device came in or pack the unit securely to avoid damage during shipping.
Shipping instructions
The RMA number should be clearly visible on the address label. Our shipping address is as follows:
Patton Electronics Company
RMA#: xxxx
7622 Rickenbacker Dr.
Gaithersburg, MD 20879-4773 USA
Patton will ship the equipment back to you in the same manner you ship it to us. Patton will pay the return
shipping costs.
Warranty Service and Returned Merchandise Authorizations (RMAs) 37
Page 38
Chapter 1 System overview
Chapter contents
Introduction..........................................................................................................................................................39
SmartWare embedded software .............................................................................................................................40
Applications...........................................................................................................................................................41
Carrier networks .............................................................................................................................................41
Enterprise networks ........................................................................................................................................42
LAN telephony ...............................................................................................................................................43
38
Page 39
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 41, is typically composed of the following main elements plus a third-party network infra-
structure:
• The first and most obvious element is the SmartNode devices (also referred to as hardware platforms or net-
work nodes) that provide the physical connectivity, the CPU and DSP resources. All SmartNode models
support packet-routed and circuit-switched traffic equally well.
• The second element comprises the embedded software—called SmartWare—running on the SmartNode
hardware platforms.
• Finally, a third-party IP network and transmission infrastructure provides IP connectivity between the
above elements. This infrastructure can range from a simple Ethernet hub or switch to highly complex networks including multiple access technologies, backbone transmission, and services nodes.
Introduction 39
Page 40
SmartWare Software Configuration Guide 1 • System overview
y
P
y
r
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.
• A gateway (GW) that converts telephone circuits into Internet protocol (IP) packet streams and vice versa.
H.323-compliant and SIP Voice over IP (VoIP) is supported.
• An IP router with on-board ports and optional data interface cards is QoS enabled, thereby allowing classi-
fication, shaping, and scheduling of multiple service classes.
For more detailed hardware information, refer to the getting started guide that came with your SmartNode system.
Local
elephony
Circuit Switch
Public Telephon
Node
VoI
Gatewa
IP WAN
IP LAN
Figure 1. Basic system (abstract) model
SmartWare embedded software
SmartWare is the application software that runs on the SmartNode hardware platforms. SmartWare is available
in several releases. Refer to SmartWare release notes for detailed information about hardware support.
IP Route
A SmartWare build is a binary image file. It is usually divided into several checksum-protected files to improve
download efficiency and security. The download to the SmartNode is handled in sequence by using a download batchfile. Refer to chapter 5, “System image handling” on page 64 for details on SmartWare image downloads.
SmartWare embedded software 40
Page 41
SmartWare Software Configuration Guide 1 • System overview
Applications
The Patton SmartNode product family consists of highly flexible multi-service IP network devices, which fit a
range of networking applications. This section provides an overview of the following SmartNode applications
and the main elements in a SmartNode network.
• Carrier networks—SmartNodes are used as customer gateways or integrated access devices at the customer
premises. These applications are also called Integrated Service Access (ISA).
• Enterprise networks—SmartNodes are used as WAN routers and voice gateways for inter-site networking.
These applications are also called multiservice intranets (MSI).
• LAN telephony—SmartNodes serve as gateways between the LAN and the local PBX or PSTN access.
These applications are also called LAN voice gateway (LVG).
Carrier networks
The network termination (NT) device in a multi-service IP based provider network plays a vital role. It provides the service access point for the subscriber with respect to physical connectivity and protocol interoperability.
Since the access bandwidth in most cases represents a network bottleneck, the NT must also ensure traffic classification and the enforcement of service level agreements (SLA) on the access link. In broadband access networks, this NT is also called an Integrated Access Device (IAD) or customer gateway.
SmartNode products offer unique features as customer gateways for business services. It provides amongst others full ISDN feature support, local switching and breakout options and mass provisioning support.
1
2
3
4
5 6
7 8 9
0 #
*
PSTN
1
2 3
4
5 6
7 8 9
0 #
Subscriber PBX
*
Node
M
Access
Backbone
GW
Services
Internet
Subscriber LAN
Figure 2. Typical carrier network application with a SmartNode.
Figure 2 shows the deployment of SmartNodes in carrier networks. Each subscriber site is equipped with a
SmartNode that connects the subscriber LAN on one side with the provider network and services on the other.
Applications 41
Page 42
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. With the use of an external modem, the SmartNode can connect to leased lines or any bridged-Ethernet
broadband access.
Enterprise networks
In company-owned and operated wide area networks, SmartNodes can be used to converge voice and data
communications on the same IP link.
In combination with centralized services such as groupware and unified messaging, the SmartNodes provide
migration and investment protection for legacy telephony systems.
1
2
3
4
5 6
7 8 9
#
0
*
1
2
3
4
5 6
7 8 9
0 #
*
PBX site A
LAN site A
Node
PSTN
Carrier A
WAN
PSTN
Carrier B
PBX site B
Node
LAN site B
1
2
3
4
5 6
7 8 9
#
0
*
1
2
3
4
5 6
7 8 9
0 #
*
Figure 3. Typical enterprise network with SmartNode
Figure 3 shows the deployment of SmartNodes in enterprise networks. Each site (headquarter, branch or home
office) is equipped with a SmartNode that connects the local LAN and telephony infrastructure with the IP
WAN and the local PSTN carrier.
Applications 42
Page 43
SmartWare Software Configuration Guide 1 • System overview
PSTN
IPPBX
LAN
IP Phones
Node
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 telephony (see figure 4).
A standalone gateway has performance reliability and scalability advantages compared with PC-based gateway
cards. In this application, the SmartNode also offers a migration path to enterprise or carrier networking.
Figure 4 shows the deployment of a SmartNode as a LAN voice gateway.
The PSTN connections can be scaled from a single ISDN basic rate access to multiple primary rate lines. With
Q.SIG, integration in private PBX networks is also supported.
Applications 43
Page 44
Chapter 2 Configuration concepts
Chapter contents
Introduction..........................................................................................................................................................45
Contexts and Gateways..........................................................................................................................................46
Context ...........................................................................................................................................................46
Gateway ..........................................................................................................................................................46
Interfaces, Ports, and Bindings...............................................................................................................................47
Interfaces ........................................................................................................................................................47
Ports and circuits ............................................................................................................................................47
Bindings ..........................................................................................................................................................47
Profiles and Use commands...................................................................................................................................48
Profiles ............................................................................................................................................................48
Use Commands ..............................................................................................................................................48
44
Page 45
Gateway
SmartWare Software Configuration Guide 2 • Configuration concepts
Introduction
This chapter introduces basic SmartWare configuration concepts. A good understanding of these concepts is
vital for the configuration 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. Once you understand and know this structure, you will
find it much more intuitive to navigate through the CLI and configure specific features.
This chapter includes the following sections:
• Contexts and gateways (see page 46)
• Interfaces, ports, and bindings (see page 47)
• Profiles and Use commands (see page 48)
Patton SmartNodes are multi-service network devices that offer high flexibility for the inter-working of circuitswitched and packet-routed networks and services. In order to consistently support a growing set of functions,
protocols, and applications, SmartWare configuration is based on a number of abstract concepts that represent
the various SmartWare components.
H.323 GW
“h323”
bind
bind command
SIP GW
“sip”
commands
Context
Interfaces
Circuit
Ports
VoIP
NAPT
Profile
use command
ACL
Profile
bind command
use command
Profile
Service
Context
IP
router
bind command
PVC
Ethernet
Serial
Policy
Profile
use command
Tone-
set
Profile
use
commands
bind command
Context
switch
Telephone port
CS
use command
use
commands
bind command
Telephone port
Figure 5. Configuration concept overview
Figure 5 shows the various elements of a complete SmartNode configuration. Each of these elements imple-
ments one of the configuration concepts described in this chapter. The figure also shows the relationships and
associations between the different elements. The relations are specified through bind (arrow) and use (bullet-
VoIP
Profile
Tone-
set
Profile
Introduction 45
Page 46
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 profiles to contexts.
The sections that follow refer to figure 5 on page 45 and describe the concepts and elements in more
detail.
Contexts and Gateways
Context
A context represents one specific networking technology or protocol, namely IP (Internet Protocol) or CS (circuit-switching). A context can be seen as virtual dedicated equipment within the SmartNode. For example:
• A CS context contains the circuit-switching functions of the SmartNode. It can be thought of as an embed-
ded multiplexer or cross-connect within the SmartNode
• An IP context contains the routing functions of the SmartNode. It can be thought of as an embedded
router within the SmartNode
The contexts are identified by a name and contain the configuration commands that are related to the technology
they represent. A separate configuration can be built by means of the context concept for newly supported network layer technologies without complicating the configuration methods of existing features. For example, as
bridging, ATM, or FR switching becomes available so a bridging, ATM, or FR context can be introduced.
Each context contains a number of interfaces, which build the connections to other SmartWare elements and
the outside world. Figure 5 on page 45 shows two contexts:
• one of type IP named router
• one of type CS named switch
Note SmartWare currently supports only one instance of the CS and IP context types.
Example
The IP context named router can contain static routes, RIP, and NAT configuration parameters. The default
circuit-switching context named switch can contain number translations, local breakout conditions, and leastcost routing parameters.
Gateway
The concept of a gateway is introduced for the communication between contexts of different types. A gateway
handles connections between different technologies or protocols. For example, a VoIP gateway connects an IP
context to a circuit-switching context.
The gateways are each of a specific type and are identified by a name. Each named gateway contains its configuration parameters. With this concept, multiple vitual gateways can be instantiated and used at the same time.
Contexts and Gateways 46
Page 47
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. Interfaces are configured as part of a context, and are independent of physical ports and circuits.
The decoupling of the interface from the physical layer entities enables many of the advanced features offered
by SmartWare.
In order for the higher-layer protocols to become active, you must associate an interface with a physical port or
circuit. This association is referred to as a binding in SmartWare. Refer to the “Bindings” section for more
information. In figure 5 on page 45, the IP context shows three interfaces and the CS context shows four interfaces. These interfaces are configured within their contexts. The bindings shown in the figure are not present
when the interfaces are configured; they are configured later.
Ports and circuits
Ports and circuits in SmartWare represent the physical connectors and channels on the SmartNode hardware.
The configuration of a port or circuit includes parameters for the physical and data link layer such as line
clocking, line code, framing and encapsulation formats or media access control. Before any higher-layer user
data can flow through a physical port or circuit, you must associate that port or circuit with an interface on a
context. This association is referred to as a binding. Refer to the “Bindings” section for more information.
Examples of ports are: Ethernet, Serial, DSL, FXS or FXO. Ports are numbered according to the label (or
abbreviation) printed on the hardware.
Example: Ethernet 0/1, Serial 0/0, BRI 3/2
Some ports may contain multiple circuits. For example, serial ports can contain one or more Frame Relay Permanent Virtual Circuits (PVC). If a port has one or more circuits configured, the individual circuits are bound
to interfaces on a context. The port itself may not be bound in that case.
Example: frame-relay pvc 112.
Figure 5 on page 45 shows five ports. Three ports are bound directly to an IP interface. One port has a single
circuit configured, which is bound to the IP context. Two ISDN ports are bound to CS interfaces.
Bindings
Bindings form the association between circuits or ports and the interfaces configured on a context. No user
data can flow on a circuit or Ethernet port until some higher-layer service is configured and associated with it.
Bindings are configured statically in the port or circuit configuration. The binding is created bottom-up, that is
from the port to the interface.
In the case of VoIP CS interfaces, bindings are configured statically in the CS interface configuration. The
binding is created from the interface to the gateway.
Bindings from ports to interfaces shown in figure 5 on page 45.
Interfaces, Ports, and Bindings 47
Page 48
SmartWare Software Configuration Guide 2 • Configuration concepts
Profiles and Use commands
Profiles
Profiles provide configuration shortcuts. They contain specific settings that can be used in multiple contexts,
interfaces, or gateways. This concept allows to avoid repetitions of groups of configuration commands that are
the same for multiple elements in a configuration.
Profiles used in the IP and CS contexts are shown in figure 5 on page 45.
Use Commands
Use commands form the association between profiles and contexts, gateways, or interfaces. For example, when
a profile is used in a context, all the configuration settings in that profile become active within the context.
Profiles and Use commands 48
Page 49
Chapter 3 Command line interface (CLI)
Chapter contents
Introduction..........................................................................................................................................................50
Command modes ..................................................................................................................................................50
CLI prompt ....................................................................................................................................................50
Navigating the CLI .........................................................................................................................................51
Initial mode ..............................................................................................................................................51
System changes ..........................................................................................................................................51
Configuration ...........................................................................................................................................51
Changing Modes .......................................................................................................................................51
Command editing .................................................................................................................................................51
Command help ...............................................................................................................................................51
The No form ..................................................................................................................................................51
Command completion ....................................................................................................................................51
Command history ...........................................................................................................................................52
Command Editing Shortcuts ..........................................................................................................................52
49
Page 50
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 configure the complete SmartWare
functionality. You can enter CLI commands online or as a configuration script in the form of a text file. The
CLI also includes monitoring and debugging commands. CLI commands are simple strings of keywords and
user-specified arguments.
This chapter gives an overview of the CLI and the basic features that allow you to navigate the CLI and edit
commands effectively. The following topics are covered:
• Command Modes
• Command Editing (see page 51)
Command modes
The CLI is composed of modes. There are two mode groups: the exec mode group and the configuration mode
group. Within the exec mode group there are two modes: operator exec and administrator exec. The configuration mode group contains all of the remaining modes. A command mode is an environment within which a
group of related commands is valid. All commands are mode-specific, and certain commands are valid in more
than one mode. A command mode provides command line completion and context help within the mode. The
command modes are organized hierarchically. The current working mode is indicated by the CLI prompt.
Appendix B, “Mode summary” on page 641 contains a detailed overview of all command modes, and
appendix C, “Command summary” on page 645 describes the commands that are valid in each mode.
CLI prompt
For interactive (online) sessions, the system prompt is displayed as:
nodename>
In the operator exec mode, the system prompt is displayed as:
nodename#
In the administrator exec mode and in the different configuration modes, the system prompt is displayed as:
nodename(mode)[name]#
Where:
• nodename is the currently configured name of the SmartNode, the IP address or the hardware type of the
device that is being configured
• mode is a string indicating the current configuration mode, if applicable.
• name is the name of the instance of the current configuration mode
Example: the prompt in
node(radius)[deepblue]#
radius-client mode, assuming the nodename node and the instance deepblue is:
The CLI commands used to enter each mode and the system prompt that is displayed when you are working
in each mode is summarized in appendix B, “Mode summary” on page 641.
Introduction 50
Page 51
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.
System changes
In order to make changes to the system, the administrator exec (privileged exec) mode must be entered. The
enable user interface command is used for this purpose (the enable command is only accessible if you are
logged in as an administrator). Once in administrator exec mode, all of the system commands are available to
you.
Configuration
To make configuration changes, the configuration mode must be entered by using the
configure command in
the administrator exec mode.
Changing Modes
The
exit command moves the user up one level in the mode hierarchy (the same command works in any of
configuration modes). For example, when in pvc configuration mode, typing
exit will take you to framerelay
configuration mode.
exit command terminates a CLI session when typed from the operator exec mode.
The
A session can also be terminated by using the
logout command within any mode.
Command editing
Command help
To see a list of all CLI commands available within a mode, type a question mark <?> or the <tab> key at the
system prompt in the mode of interest. A list of all available commands is displayed. Commands that have
become available in the current mode are displayed at the bottom of the list, separated by a line. Commands
from higher hierarchy levels are listed at the top.
You can also type the question mark or the <tab> key while in the middle of entering a command. Doing so
displays the list of allowed choices for the current keyword in the command. Liberal use of the question mark
functionality is an easy and effective way to explore the command syntax.
The No form
Almost every command supports the keyword
function or “deletes” a command from the configuration. For example, to enable the DHCP server trace tool,
enter the command
no debug dhcop-server.
debug dhcp-server. To subsequently disable the DHCP server trace, enter the command
Command completion
You can use the <tab> key in any mode to carry out command completion. Partially typing a command name
and pressing the <tab> key causes the command to be displayed in full up to the point where a further choice
has to be made. For example, rather than typing
no. Typing the no keyword in front of a command disables the
configure, typing conf and pressing the <tab> key causes the
Command editing 51
Page 52
SmartWare Software Configuration Guide 3 • Command line interface (CLI)
CLI to complete the command at the prompt. If the number of characters is not sufficient 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 configure mode and press <tab>, the selections
configure, copy, and context are
displayed.
Command history
SmartWare maintains a list of previously entered commands that you can go through by pressing the <uparrow> and <down-arrow> keys, and then pressing <enter> to enter the command.
The show history command displays a list of the commands you can go through by using the arrow keys.
Command Editing Shortcuts
SmartWare CLI provides a number of command shortcuts that facilitate editing of the command line. Command editing shortcuts are summarized in table 3 on page 52. The syntax <Ctrl>-<p> means press the <p> key
while holding down the keyboard’s control key (sometimes labeled Control, Ctl, or Ctrl, depending on the keyboard and operating system of your computer).
<Esc>-<f> is handled differently; press and release the escape key (often labeled Esc on many keyboards) and
then press the <f> key.
Table 3. Command edit shortcuts
Keyboard Description
<Ctrl>-<p> or <up-arrow> Recall previous command in the command history.
<Ctrl>-<p> or <up-arrow> Recall next command in the command history.
<Ctrl>-<p> or <up-arrow> Move cursor forward one character.
<Ctrl>-<p> or <up-arrow> Move cursor backward one character.
<Esc>-<f> Move cursor forward one word.
<Esc>-<b> Move cursor backward one word.
<Ctrl>-<a> Move cursor to beginning of line.
<Ctrl>-<e> Move cursor to end of line.
<Ctrl>-<k> Delete to end of line.
<Ctrl>-<u> Delete to beginning of line.
<Ctrl>-<d> Delete character.
<Esc>-<d> Delete word.
<Ctrl>-<c> Quit editing the current line.
<Ctrl>-<l> Refresh (redraw) the display.
<Ctrl>-<t> Transpose characters.
<Ctrl>-<v> Insert a code to indicate to the system that the keystroke immediately fol-
lowing should be treated as normal text, not a CLI command.
For example, pressing the question mark <?> character in the CLI prints a
list of possible tokens. If you want to use the ? in a configuration command, e.g. to enter a regular expression, press Ctrl-v immediately followed by the question mark <?>.
Command editing 52
Page 53
Chapter 4 Accessing the CLI
Chapter contents
Introduction..........................................................................................................................................................54
Accessing the SmartWare CLI task list...................................................................................................................54
Accessing via the console port .........................................................................................................................55
Console port procedure .............................................................................................................................55
Telnet Procedure .......................................................................................................................................56
Using an alternate TCP listening port for the Telnet server .............................................................................56
Disabling the Telnet server ..............................................................................................................................56
Logging on ......................................................................................................................................................56
Selecting a secure password .............................................................................................................................57
Password encryption .......................................................................................................................................58
Factory preset administrator account .........................................................................................................58
Creating an operator account ....................................................................................................................58
Creating an administrator account ............................................................................................................59
Displaying the CLI version .............................................................................................................................59
Displaying account information ......................................................................................................................59
Switching to another account ..........................................................................................................................60
Checking identity and connected users ...........................................................................................................60
Command index numbers ...............................................................................................................................61
Ending a Telnet or console port session ..........................................................................................................63
Showing command default values ...................................................................................................................63
53
Page 54
SmartWare Software Configuration Guide 4 • Accessing the CLI
Introduction
SmartNode products are designed for remote management and volume deployment. The management and
configuration 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 configuration, management, and maintenance tasks.
This chapter describes the procedures for entering SmartWare commands via the command line interface (CLI),
to obtain help, to change operator mode, and to terminate a session. You can access a SmartNode as follows:
• Directly, via the console port (if available)
• Remotely, via the IP network (by using a Telnet application)
The ports available for connection and their labels are shown in the getting started guide that came with your
unit.
Remember that the CLI supports a command history and command completion. By scrolling with the up and
down arrow keys, you can find many of your previously entered commands. Another timesaving tool is command completion. If you type part of a command and then press the <tab> key, the SmartWare shell will
present you with either the remaining portion of the command or a list of possible commands. These features
are described in chapter 3, “Command line interface (CLI)” on page 49. The telnet server can be disabled
if desired.
Although SmartWare supports concurrent sessions via Telnet or
the console port, we do not recommend working with more than
IMPORTANT
one session to configure a specific SmartNode. However, using
one session for configuration and another for debugging is a
good idea.
Accessing the SmartWare CLI task list
The following sections describe the basic tasks involved in accessing the SmartWare command line interface.
Depending on your application scenario, some tasks are mandatory while others could be optional.
• Accessing via the console port (see page 55)
• Accessing via a Telnet session (see page 55)
• Using an alternate TCP listening port for the Telnet server (see page 56)
• Disabling the Telnet server (see page 56)
• Logging on (see page 56)
• Selecting a secure password (see page 57)
• Configuring operators and administrators (see page 58)
• Displaying the CLI version (see page 59)
• Displaying account information (see page 59)
• Switching to another log-in account (see page 60)
• Checking identity and connected users (see page 60)
Introduction 54
Page 55
SmartWare Software Configuration Guide 4 • Accessing the CLI
• Ending a Telnet or console port session (see page 63)
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 figure 6).
The host must use a terminal emulation application that supports serial interface communication.
Serial interface
Host
Figure 6. Setup for initial configuration via the console port
Note You do not need to configure IP settings if you access the SmartNode via the
Console
Node
Node
console port.
Console port procedure
Before using the CLI to enter configuration commands, do the following:
1. Set up the hardware as described in the getting started guide.
2. Configure your serial terminal as described in the getting started guide.
3. Connect the serial terminal to your SmartNode. Use a serial cable according to the description in the get-
ting started guide included with your SmartNode device.
4. Power on your SmartNode. A series of boot messages are displayed on the terminal screen. At the end of
the boot sequence, press the <return> key and the login screen will be displayed.
5. Proceed with logging in.
Accessing the SmartWare CLI task list 55
Page 56
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 configuration of the Ethernet port (LAN port) is not known or is
incorrectly configured, you will have to use the console interface.
Telnet Procedure
Before you begin to use the CLI to input configuration commands, do the following:
1. Set up the SmartNode as described in the getting started guide included with your SmartNode device.
2. Connect the host (PC) or hub to the SmartNode as described in the getting started guide.
3. Power on your SmartNode and wait until the Run LED lights.
4. Open a Telnet session to the IP address shown in the getting started guide.
5. Proceed with logging in.
Using an alternate TCP listening port for the Telnet server
The following command defines an alternate listening port for the telnet server.
Mode: Configure
Step Command Purpose
1 [name](cfg)# terminal telnet port <port> Uses TCP port <port> for accepting
telnet connections
Disabling the Telnet server
The telnet server can be disabled using the following command.
Mode: Configure
Step Command Purpose
1 [name](cfg)# no terminal telnet Disables the telnet server
Logging on
Accessing your SmartNode via the local console port or via a Telnet session opens a login screen. The following
description of the login process is based on a Telnet session scenario but is identical to that used when accessing
via the local console port.
The opening Telnet screen you see resembles that shown in figure 7. The window header bar shows the IP
address of the target SmartNode.
A factory preset administrator account with name administrator and an empty password is available when you
first access the unit. For that reason, use the name administrator after the login prompt and simply press the
<enter> key after the password prompt.
Accessing the SmartWare CLI task list 56
Page 57
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 figure 7, such as the IP address in the system prompt
and window header bar, may be different on your unit.
You are responsible for creating a new administrator account to
maintain system security. Patton Electronics accepts no responsi-
IMPORTANT
bility for losses or damage caused by loss or misuse of passwords. Please read the following sections to secure your network
equipment properly.
Selecting a secure password
It is not uncommon for someone to try to break into (often referred to as hacking) a network device. The network administrator should do everything possible to make the network secure. Carefully read the questions
below and see if any applies to you:
• Do your passwords consist of a pet’s name, birthdays or names of friends or family members, your license
plate number, social security number, favorite number, color, flower, animal, and so on?
• Do you use the same password repeatedly? (Example: Your ATM PIN, cell phone voice mail, house alarm
setting code, etc.)
• Could your password or a portion thereof be found in the dictionary?
• Is your password less than six characters long?
To prevent unauthorized access, you should select passwords that are not dictionary words or any of the abovementioned examples. Every password should be at least 6 characters long and include at least one capital letter,
one number, and one lowercase letter.
A good example of a password is: 3Bmshtr
You are probably asking yourself, “How am I going to remember that?” It’s easy, the password above is an acronym taken from: “three blind mice, see how they run.” Making a good password is that easy—but please, don’t
use the above example password for your SmartNode device!
Accessing the SmartWare CLI task list 57
Page 58
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
configuration file—to protect against that type of theft, SmartWare encrypts passwords by default. Encryption
prevents the password from being readable in the configuration file.
• Plain text
• Encrypted text (for example, the password mypassword always appears in encrypted form as
HUAvCYeILWZz3hQvS0IEpQ== encrypted when doing a
show command)
The command
show running-config always displays the passwords in encrypted format. To encrypt a pass-
word, enter the password in plain format and retrieve the encrypted format from the running-config or store it
permanently into the startup-config (with the command
copy running-config startup-config).
Factory preset administrator account
SmartWare contains a factory preset administrator account with the name administrator and an empty password. After adding a new administrator account, the factory preset administrator account is automatically
deleted and only the newly created administrator account is available. You can create more than one administrator account, but there has to be at least one administrator account defined. If, for some reason, the last
administrator account is deleted, the factory preset administrator account with the name administrator and an
empty password is automatically recreated.
Configuring operators and administrators
Creating an operator account
Operators do not have the privileges to run the
enable command and therefore cannot modify the system
configuration. Operators can view partial system information.
Creating a new operator account is described in the following procedure:
Mode: Operator execution
Step Command Purpose
1 node>enable Enters administration execution mode
2 node#configure Enters configuration mode
3 node(cfg)# operator name password password Creates a new operator account name and
password password
4 copy running-config startup-config Saves the change made to the running config-
uration of the SmartNode, so that it will be
used following a reload
Example: Create an operator account
The following example shows how to add a new operator account with a login name support and a matching
password of s4DF&qw. The changed configuration is then saved.
node>enable
node#configure
node(cfg)#operator support password s4DF&qw
Accessing the SmartWare CLI task list 58
Page 59
SmartWare Software Configuration Guide 4 • Accessing the CLI
node(cfg)#copy running-config startup-config
Creating an administrator account
Administrators can run the
enable command and access additional information within the SmartWare config-
uration modes. Therefore administrators can modify the system configuration, as well as view all relevant system information.
Creating a new administrator account is described in the following procedure:
Mode: Operator execution
Step Command Purpose
1 node>enable Enters administration execution mode
2 node#configure Enters configuration mode
3 node(cfg)# administrator name password password Creates a new administrator account
name and password password
4 node(cfg)#copy running-config startup-config Permanently stores the new administrator
account parameters.
Example: Create an administrator account
The following example shows how to add a new administrator account with a login name super and a matching
password Gh3*Ke4h.
node>enable
node#configure
node(cfg)#administrator super password Gh3*Ke4h
node(cfg)#copy running-config startup-config
Displaying the CLI version
This procedure displays the version of the currently running CLI.
Mode: Operator execution
Step Command Purpose
1 node>show version cli Displays the CLI version
Example: Displaying the CLI version
The following example shows how to display the version of the current running CLI on your device, if you
start from the operator execution mode.
node>show version cli
CLI version : 3.00
Displaying account information
You can use the
show command to display information about existing administrator and operator accounts.
This command is not available for an operator account.
The following procedure describes how to display account information:
Accessing the SmartWare CLI task list 59
Page 60
SmartWare Software Configuration Guide 4 • Accessing the CLI
Mode: Administrator execution
Step Command Purpose
1 node#show accounts Displays the currently-configured administrator and operator
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
operator accounts:
support
Switching to another account
A user can use the
a user can change from his current account to another existing account ‘name’. After executing
su command to switch from one user account to working in another. With this command,
su with the
account name to which the user wants to change as argument, he must enter the password of the particular
account to get privileged access.
Mode: Administrator or operator execution
Step Command Purpose
1 node>su account-name Changes to the user account account-name.
Example: Switching to another account
The following example shows how to change from your current user account to an administrator account,
starting from the operator execution mode. In the example below the
who command is used to check the
identity within both accounts
login: support
password: <password>
node>who
You are operator support
node>su super
Enter password: <password>
node>who
You are administrator super
Checking identity and connected users
The
who command displays who is logged in or gives more detailed information about users and process
states. Depending on the execution mode, the command displays varying information. In administrator execution mode, the command output is more detailed and shows information about the ID, user name, state, idle
time, and location. In operator execution mode, only the user name being used at the moment is reported,
which helps checking the identity.
Accessing the SmartWare CLI task list 60
Page 61
SmartWare Software Configuration Guide 4 • Accessing the CLI
Mode: Administrator or operator execution
Step Command Purpose
1 node#who Shows more detailed information about the users ID, name, state, idle time and
location
or
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.
Used in administrator execution mode:
node#who
ID User name State Idle Location
* 0 administrator exec 00:00:00 172.16.224.44:1160
1 support exec 00:01:56 172.16.224.44:1165
Note The “*” character identifies the user executing the who command. ID repre-
sents the ID of the account. State represents the actual running condition of
the user, which can be logout, login, exec, or config.
Used in operator execution mode:
node>who
You are operator support
Command index numbers
A command index number (indicated by the boldface 1, 2, and 3 index numbers in the example below) indicates the position of a command in a list of commands (that is, a command with index 1 will appear higher in
the configuration file than one with index 3).
192.168.1.1(pf-voip)[default]#show running-config
...
profile voip default
codec 1 g711ulaw64k rx-length 20 tx-length 20
codec 2 g711alaw64k rx-length 20 tx-length 20
codec 3 g723-6k3 rx-length 30 tx-length 30
dejitter-max-delay 200
...
commands that make use of index numbers always show the index in the running config. However, the index
can be omitted when entering the command. If you enter such a command with an index, it is inserted into list
at the position defined by the index. If you enter such a command without an index, it is placed at the bottom
Accessing the SmartWare CLI task list 61
Page 62
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 changing 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
codec 2 g711alaw64k rx-length 20 tx-length 20
codec 3 g723-6k3 rx-length 30 tx-length 30
dejitter-max-delay 200
...
Listing after changing index number:
192.168.1.1(pf-voip)[default]#codec 3 before 1
192.168.1.1(pf-voip)[default]#show running-config
...
profile voip default
codec 1 g723-6k3 rx-length 30 tx-length 30
codec 2 g711ulaw64k rx-length 20 tx-length 20
codec 3 g711alaw64k rx-length 20 tx-length 20
dejitter-max-delay 200
...
Note Succeeding indexes are automatically renumbered.
Example 2: Moving the G.723 codec back position 3
This command moves the G.723 codec from the top to third place. As a result, the other two codecs move up
in the list as their indexes are automatically renumbered to accommodate the new third-place codec.
192.168.1.1(pf-voip)[default]#codec 1 after 3
192.168.1.1(pf-voip)[default]#show running-config
...
profile voip default
codec 1 g711ulaw64k rx-length 20 tx-length 20
codec 2 g711alaw64k rx-length 20 tx-length 20
codec 3 g723-6k3 rx-length 30 tx-length 30
dejitter-max-delay 200
...
Example 3: Inserting a codec at a specific position in the list.
This command assigns the G.729 codec the index number 1 so the codec appears at the top of the list.
192.168.1.1(pf-voip)[default]#codec 1 g729 tx-length 30 rx-length 30 silencesupression
192.168.1.1(pf-voip)[default]#show running-config
...
profile voip default
codec 1 g729 rx-length 30 tx-length 30 silence-supression
codec 2 g711ulaw64k rx-length 20 tx-length 20
codec 3 g711alaw64k rx-length 20 tx-length 20
codec 4 g723-6k3 rx-length 30 tx-length 30
dejitter-max-delay 200
...
Accessing the SmartWare CLI task list 62
Page 63
SmartWare Software Configuration Guide 4 • Accessing the CLI
Ending a Telnet or console port session
Use the
sion. To confirm the
logout command in the operator or administration execution mode to end a Telnet or console port ses-
logout command, you must enter yes on the dialog line as shown in the example below.
Mode: Operator execution
Step Command Purpose
1 node>logout Terminates the session after a confirmation by the user.
Example: End a Telnet or console port session
The following example shows how to terminate a session from the administrator execution configuration
mode.
node>logout
Press 'yes' to logout, 'no' to cancel :
After confirming the dialog with “yes”, the Telnet session is terminated.
Note Using the command exit in the operator execution mode also terminates a
Telnet or console port session, but without any confirmation dialog.
Showing command default values
If a command is set to its default value, it is not displayed in the running-config in order to make it more readable. There are a few exceptions to this rule. The command cli config defaults makes commands also appearin
the running-config that are set to default values. no li config defaults turns it off.
Accessing the SmartWare CLI task list 63
Page 64
Chapter 5 System image handling
Chapter contents
Introduction..........................................................................................................................................................65
Memory regions in SmartWare..............................................................................................................................66
System image handling task list .............................................................................................................................67
Displaying system image information ..............................................................................................................68
Copying system images from a network server to Flash memory .....................................................................68
Upgrading the software directly ......................................................................................................................70
Auto provisioning of firmware and configuration ..................................................................................................71
Boot procedure......................................................................................................................................................73
Factory configuration ............................................................................................................................................74
Default Startup Configuration ........................................................................................................................74
IP Addresses in the Factory Configuration ......................................................................................................74
64
Page 65
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. The application image is the software which actually operates the
SmartNode. Driver images are used to operate the various optional PMC interface cards.
This chapter includes the following sections:
• Memory regions in Smartware
• System image handling task list (see page 67)
• Boot procedure and bootloader (see page 73)
Note Section “System image handling task list” on page 67 describes the standard
way to upgrade the SmartWare. If you encounter problems that won’t let you
upgrade using the standard method, refer to section “Factory configuration”
on page 74.
Note Refer to appendix F, “Notes for upgrading from R3.10 to R3.20” on
page 618 for information on converting from SmartWare release R3.10
to R3.20
• Factory configuration (see page 74)
Patton SmartNode devices are shipped with default system software which is stored in persistent memory.
Along with the default system software (application image and driver images), a factory configuration, factory-
config, has been loaded into the SmartNode at the factory. This configuration file sets the initial basic operating
parameters of the SmartNode, such as enabling the Ethernet ports, setting the default IP addresses and the
DHCP server.
Other configuration files may be stored in the SmartNode persistent memory. A configuration file is an ordered
list of commands. Some of the various configuration files are
• factory-config (read-only)
• startup-config
• running-config
• user-config1, user-config2, etc. (these are specific application configurations created by the user)
Backups of the configuration files can be stored on a remote trivial file transfer protocol (TFTP) server. The
remote tftp server must be accessible via one of the SmartNode IP interfaces. Tftp cannot be used from the
console interface.
The following sections focus on SmartWare memory regions, as well as the software components you can copy
into the memory or move between a TFTP server and the memory of the SmartNode. As SmartWare uses a
specific vocabulary in naming those software components, refer to appendix A, “Terms and definitions” on 635
to ensure that you understand the concepts.
Introduction 65
Page 66
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 figure 8 on
page 67, 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 configuration files to
the SmartNode. The command syntax in SmartWare requires you to prefix
the file path on the TFTP server with tftp: followed by the absolute file path.
You need to start from the root directory of the TFTP server.
The three physical regions of memory are the remote tftp server’s memory, the Volatile memories, and the Per-
sistent memory in the SmartNode. The remote tftp server has one logical region, tftp:, which can contain vari-
ous configuration files and batch files for system software upgrade/download. Within the SmartNode the
Volatile physical region contains one logical region, system:, which is random access memory (RAM). When no
power is applied to the SmartNode, the system: region contains no data, no configuration—nothing; it is volatile. The system: region contains the current running configuration, called running-config.
The third and last physical memory region is the Persistent portion. It has two logical regions called flash:
and nvram:.
• The logical region flash: stores the application image, the driver images and the bootloader image. These
images are not lost when the SmartNode is powered off.
• The logical region nvram: stores the various configuration files. The factory default configuration file is
always present in nvram:, and can be restored as the running-config by pressing the reset button. For those
models that do not have a reset button, use the
copy command. The startup-config and user-specific con-
figurations are also stored in nvram:.
The factory configuration is read-only. It is contained in the logical region nvram: of the SmartNode. It is
used—if no user-specific configuration is available—to start-up SmartWare with a minimal functionality. This
configuration is named factory-config in SmartWare terminology.
On powering up a SmartNode (or pressing the Reset button on applicable units) with no pre-configured user
configuration files, the default factory-config file is also the startup-config and the running-config. Upon changing
any configuration parameters, the changes are made to the running-config in the system: region of the Volatile
memory. Unless these changes are copied into startup-config or another user-named configuration file, all configuration changes will be lost if the SmartNode is powered down.
A dedicated user-specific configuration must be created and stored in the nvram: region of persistent memory.
In fact, you may create numerous user-specific configurations in the same SmartNode, but if only one dedicated user-specific config is required, you may save it in startup-config by using the
startup-config
command. Any future time you restart the SmartNode, it will use this saved configuration. In
copy running-config
other words, the startup-config configuration file becomes your default operating configuration.
If you have created and saved numerous user-defined operating configuration files, you can change the startup
default configuration file simply by copying the selected config file into startup-config and rebooting
the SmartNode.
Any configuration stored in logical region nvram: or system: can be copied to a remote server by using TFTP.
Memory regions in SmartWare 66
Page 67
SmartWare Software Configuration Guide 5 • System image handling
Operating configurations cannot be executed from the persistent memory, so the configuration used for operating 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. SmartWare) is started and a
configuration must be available. Shortly before SmartWare has completed all startup processes, the configuration startup-config is copied from nvram: in persistent memory to the running-config configuration in system: in
volatile memory.
You can back up the running-config to nvram: or to a remote TFTP server with a user-defined name.
Note When returning to the factory-config by using the copy factory-config star-
tup-config
command, all user-specific configurations saved in nvram:
remain even after reload.
Memory Regions in
Embedded Software
Remote (TFTP Server) Local
tftp:
• Configuration
Files
• Batchfiles for
System Image
download
Image / Microcode Download
Storing the current Running Configuration remotely
Configuration File Upload
flash:
• Application Image
• Bootloader Image
• Microcode Image
Configuration File Download
nvram
• Factory
Configuration
“factory-config”
(read-only)
• Startup
Configuration
“startup-config”
• User specific
Configuration
“user-config”
Storing the current Configuration locally
VolatilePersistent
:
Only on Startup to execute the
Startup or Factory Configuration
system:
• current Running
Configuration
“running-config”
Figure 8. SmartNode memory regions logically defined in SmartWare
System image handling task list
To load and maintain system images, perform the tasks described in the following sections:
• Displaying system image information
• Copying system images from a network server to the Flash memory (see page 68)
• Copying the driver software from a network server to the Flash memory (see page 70)
System image handling task list 67
Page 68
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
1 show version Lists the system software release version, information about optional interface
cards mounted in slots and other information that is the currently running system
software. If you have just completed a download of new system software from the
tftp server, you must execute the reload command in order to be running with the
new system software. This applies equally to driver software.
Example: Display system image information
The following example shows the information that is available for a SmartNode 2000 series device with an
optional IC-4BRV interface card mounted in slot 2.
node#show version
Productname : SN4638/5BIS/UI
Software Version : R3.T 2006-12-04 H323 SIP BRI
Supplier :
Provider :
Subscriber :
Information for Slot 0:
SN4638/5BIS/UI (Admin State: Application Started, Real State:
Application Started)
Hardware Version : 1, 3
Serial number : 00A0BA0209B1
PLD Version : 0x46010102
Software Version : R3.T 2006-12-04 H323 SIP BRI
Copying system images from a network server to Flash memory
As mentioned previously, the system image file contains the application software that runs SmartWare; it is
loaded into the flash memory at the Patton Electronics Co. factory. Since most of the voice and data features of
the SmartNode are defined and implemented in the application software, upgrading to a new release might be
necessary if you want to have additional voice and data features available. A new system image file must be
stored permanently into the flash memory of your SmartNode to be present when booting the device.
Since the system image file is preloaded at the Patton Electronics Co. factory, you will have to download a new
SmartWare application software only if a major software upgrade is necessary or if recommended by Patton
Electronics Co. Under normal circumstances, downloading a system image file should not be needed.
Downloading a new system image file means storing it permanently at a defined location within the SmartNode flash memory. To store the system image file, you must use a special download script file. This script file
defines how to handle the system image file and where to store it. You cannot download any system image file
without an appropriate script file.
Each line in the script file is a command for the CLI of your SmartNode. To download a system image file,
which will replace the currently running SmartWare application software, a script file with only one command
is necessary.
System image handling task list 68
Page 69
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 file. Comment lines contain information for administrators or operators who maintain or use the script file.
The following example shows a script file used to download a system image and command line syntax definition file from a TFTP server.
# script file for system image download
# Patton Electronics Co. 2001-10-24
image.bin 1369474 21; ver 2300.1,2300.2;
cli.xml
+/flash/cli/spec.xml
*UÊDä
Note The script file includes a 32-bit CRC on the last line, displayed as four char-
acters when seen in an ordinary text editor. Do not delete the line containing
the CRC entry or the download will fail!
You can download the script file with the
copy command. The copy command source defines the TFTP path
to the script file and the target is set to use the script parser. After downloading the script file, the system image
file and command line syntax definition file download starts automatically.
Mode: Administrator execution
Step Command Purpose
1 node(cfg)# copy tftp://node-ip-address/b flash: Downloads the script file b from the TFTP
server at address node-ip-address and starts
the system image download process. This
progress is visualized with a counter, counting up from 0 to 100% according to the
downloaded amount of the file size for each
file that needs to be downloaded.
Example: Copy system images from a network server to the Flash memory
The following example shows how to download the driver software image file from the TFTP server at IP
address 172.16.36.80. The download is defined by a script file, which has to be downloaded first. After downloading the script file, the driver software image file is downloaded automatically.
SN>enable
SN#configure
SN(cfg)#copy tftp://172.16.36.80/sn2300/build22032/b flash:
Completed image download
Completed file download /flash/cli/spec.xml
SN(cfg)#
Note When encountering problems due to memory exhaustion (message Parsing
batch file...% APP - OUT OF MEMORY). shutdown the H.323 gateway
prior to initiating the download command as follows (which will temporarily free the required memory):
System image handling task list 69
node(gw-h323)[h323]#shutdown
Page 70
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-file to the CLI command
“copy”. The SmartWare downloads the whole ZIP file. During this time the download progress is displayed in
bytes. After downloading, the ZIP file containing batch file “bw” or “b” will be extracted and executed. This
leads to writing the SmartWare image, which is also part of the ZIP file, to the flash. The web pages are
updated too. After writing the image to the flash, the Smartware needs to be reloaded with the command
reload.
Mode: enable
Step Command Purpose
1 node(cfg)# copy tftp://<server-ip-address>/
<path>/<smartwaredeliveryfile>.zip :flash
Downloads the specified delivery file from
the TFTP server and starts the driver software image upgrade process.
Example: An example of such a Smartware upgrade session, where the new software is in the file
SN1000_SIP_R3.T_2006-08-10.zip which is stored on a tftp-server with the ip address 192.186.22.44:
node#copy tftp://192.186.22.44/SN1000_SIP_R3.T_2006-08-10.zip flash:
Download... 3124510 Bytes
Downloading image...completed (2715796 bytes)
Erasing flash...completed.
Writing to flash...completed
Processing files...completed
node#reload
System image handling task list 70
Page 71
SmartWare Software Configuration Guide 5 • System image handling
Auto provisioning of firmware and configuration
The new auto provisioning capability enables you to automatically distribute up-to-date configurations and
firmware to a large number of units using TFTP. It works as follows:
The unit downloads a specific file from a TFTP server. If this file has changed since the last download, it is
stored and executed. If the file on the server did not change since the last download, no action is taken. If the
units are configured to do auto provisioning, a network operator can only update the firmware files on the
TFTP server, which automatically distributes it to all units. The “profile provisioning” configures this. Here’s
an example for firmware provisioning:
profile provisioning FIRMWARE
destination script
location 1 tftp://172.16.1.2/firmware/b
location 2 tftp://172.16.1.33/firmware/b
activation reload graceful
Explanation:
Step Command Purpose
1 [name] (pf-prov)[FIRMWARE]#destination script Chooses the unit’s script interpreter as des-
tination of the downloaded file. Use this
for firmware updates. Script files are the
b, b1, … files that come with each unit
firmware update.
2 [name] (pf-prov)[FIRMWARE]#location 1
tftp://172.16.1.2/firmware/b
3 [name] (pf-prov)[FIRMWARE]#location 2
tftp://172.16.1.33/firmware/b
4 [name] (pf-prov)[FIRMWARE]#activation reload
graceful
Specifies the location of the file to check
for changes.
Specifies alternate locations of the file. If
the first could not be contacted, the second is tried, and so on.
Specifies how the new firmware is to be
activated. Choose between immediate or
graceful reload.
Here’s an example for configuration provisioning:
profile provisioning CONFIG
destination configuration
location 1 tftp://tftp1.provider.net/configs/$(system.mac).cfg location 2 tftp://172.16.1.33/configs/$(system.mac).cfg activa-
tion reload graceful
Explanation:
Step Command Purpose
1 [name] (pf-prov)[CONFIG]#destination
configuration
Auto provisioning of firmware and configuration 71
Chooses the unit’s startup-configuration as
destination of the downloaded file.
Page 72
SmartWare Software Configuration Guide 5 • System image handling
Step Command Purpose
2 [name] (pf-prov)[CONFIG]#location 1
tftp://tftp1.provider.net /configs/
$(system.mac).cfg
3 [name] (pf-prov)[CONFIG]#location 2
tftp://172.16.1.33/configs/$(system.mac).cfg
4 [name] (pf-prov)[CONFIG]#activation reload
graceful
Specifies the location of the file to check
for changes. $(system.mac) is a placeholder for the unit’s MAC address of
ETH 0/0. Using host names instead of IP
addresses works only if DNS resolver is
enabled and configured.
Specifies alternate locations of the file. If
the first could not be contacted, the second is tried, and so on.
Specifies how the new configuration
should be activated. Choose between
immediate or graceful reload.
Note the placeholder used in the file location. Placeholders can be used for each part of the location, be it
server address, path or filename. The following place holders are available:
• $(system.mac)—MAC address of ETH 0/0 (without “:” between the hexadecimal characters)
• $(system.serial)—serial number of the unit
• $(dhcp.66)—DHCP option 66 (TFTP server IP), as delivered by the DHCP server (only if DHCP
is enabled)
• $(dhcp.67)—DHCP option 67 (Boot file name), as delivered by the DHCP server (only if DHCP
is enabled)
To use and debug provisioning:
Step Command Purpose
1 [name] (cfg)provisioning execute FIRMWARE Executes the provisioning profile
FIRMWARE once
2 [name] (cfg)debug provisioning Enables debug output for all
provisioning operations
To continuously poll for firmware or configuration changes, use the
with the new
timer command as described below. Here’s how to do both firmware and configuration provi-
provisioning execute command together
sioning, with a polling interval of 10 minutes.
timer FIRMWARE_UPDATE now + 2 minutes every 10 minutes “provisioning execute FIRMWARE”
timer CONFIG_UPDATE now + 2 minutes every 10 minutes “provisioning execute CONFIG”
Auto provisioning of firmware and configuration 72
Page 73
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. One of the last start-up tasks to finish in bringing up the entire system is handling the operating configuration. The configuration startup-config is copied from the logical region nvram: in
nonvolatile memory to the logical region running-config in the volatile memory. The SmartWare now uses the
running-config to set up the operating configuration of the SmartNode. Figure 9 illustrates the boot procedure.
Power-On
Bootstrap Bootloader
pressed
Reset Button
released
Application
Application
Image
valid
start Software Modules
System Button
use startup-config use factory-config
invalid
released
System Up
Figure 9. Boot procedure
pressed
There are two situations during bootstrap when the bootloader takes control:
• “If the user has pressed the system button, it launches the bootloader, the bootstrap application checks the
status of the Reset button (not available for SN4xxx) on the back panel of the SmartNode.”
• If a valid application image is not available
Boot procedure 73
Page 74
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. After downloading an application image, the bootstrap will only switch to the
newly loaded application image if it is valid. If it is not valid, the bootstrap still uses the application image
which existed prior to doing a software upgrade.
If the application image is valid, it is started and SmartWare is brought into operation module by module.
During this system initialization phase (when the message Press reset button to restore factory defaults... appears
on the console screen), the status of the reset button on the back panel of the SmartNode is checked. If the button has been pressed, the factory configuration is loaded into the volatile memory and is used to parameterize
the SmartWare (not available for SN4xxx). If the button has not been pressed, the startup configuration is
loaded into the volatile memory and is used to parameterize the SmartWare.
Factory configuration
SmartNodes are delivered with a factory configuration stored in the logical region nvram: of the memory. It is used
to initially parameterize the network and component settings of SmartWare, which makes sense at the very beginning. Moreover, in case of SmartWare malfunction, you can reset to the initial state by reloading the factory configuration. The factory configuration consists of the default settings for the IP networking subsystem.
Once the user-specific configuration is created and stored as startup configuration, the factory configuration is
no longer used but it remains in the persistent memory. It is possible to switch back to the factory configuration at any time during the operation of a SmartNode.
Default Startup Configuration
The SmartNodes delivered from the factory contain both a factory configuration and a default startup configuration. While the factory configuration contains only basic IP connectivity settings, the default startup configuration includes settings for most SmartWare functions. Note that if you press and hold the system button
(Reset) for 5 seconds the factory configuration is copied onto the startup configuration (overwrite). The default
startup config is then lost.
IP Addresses in the Factory Configuration
The factory configuration contains the following IP interfaces and address configurations bound by the Ethernet ports 0/0 and 0/1:
interface eth0
ipaddress dhcp
mtu 1500
interface eth1
ipaddress 192.168.1.1 255.255.255.0
mtu 1500
Avoid downloading any system image if you do not completely
understand what you have to do!
IMPORTANT
Factory configuration 74
Page 75
Chapter 6 Configuration file handling
Chapter contents
Introduction..........................................................................................................................................................76
Understanding configuration files ...................................................................................................................76
Factory configuration ............................................................................................................................................78
Configuration file handling task list.......................................................................................................................78
Copying configurations within the local memory ............................................................................................79
Replacing the startup configuration with a configuration from Flash memory ................................................80
Copying configurations to and from a remote storage location ........................................................................81
Replacing the startup configuration with a configuration downloaded from TFTP server ...............................82
Displaying configuration file information .......................................................................................................82
Modifying the running configuration at the CLI .............................................................................................83
Modifying the running configuration offline ...................................................................................................84
Deleting a specified configuration ...................................................................................................................85
Encrypted file download .................................................................................................................................86
Encrypted Configuration Download .........................................................................................................86
Use Cases ..................................................................................................................................................87
75
Page 76
SmartWare Software Configuration Guide 6 • Configuration file handling
Introduction
This chapter describes how to upload and download configuration files from and to SmartWare. A configuration file is a batch file of SmartWare commands used in the software modules that perform specific functions of
the SmartNode. This chapter also describes some aspects of configuration file management. Refer to chapter 5,
“System image handling” on page 64 for more information.
This chapter includes the following sections:
• Factory configuration (see page 78)
• Configuration file handling task list (see page 78)
All Patton SmartNode devices are shipped with a factory configuration file, which is stored in their flash memory.
A configuration file is like a script file containing SmartWare commands that can be loaded into the system.
Configuration files may also contain only partial configurations. This allows you to keep a library of command
sequences that you may want to use as required. By default, the system automatically loads the factory configuration from the flash memory if no user-specific configuration is defined as the startup configuration.
Changing the current running configuration is possible as follows:
• You may change the running configuration interactively. Interactive configuring requires that you access the
CLI by using the
configuration mode with the command
commands that are necessary to configure your SmartNode.
enable command to enter administrator execution mode. You must then switch to the
configure. Once in configuration mode, enter the configuration
• You can also create a new configuration file or modify an existing one offline. You can copy configuration
files from the flash memory to a remote server. Transferring configuration files between the flash memory
and a remote system requires the Trivial File Transfer Protocol (TFTP). The TFTP server must be reachable
through one of the SmartNode network interfaces.
See chapter 4, “Accessing the CLI” on page 53 for information concerning access to the CLI.
The following sections focus on SmartWare memory regions and software components that can be copied
within the memory or uploaded/downloaded between a TFTP server and the memory of the SmartNode.
Since SmartWare uses a specific vocabulary in naming those software components, refer to appendix A, “Terms
and definitions” on page 635 to ensure that you understand the concepts. Refer to chapter 5, “System image
handling” on page 64 for a brief description of how SmartWare uses system memory.
Understanding configuration files
Configuration files contain commands that are used to define the functionality of SmartWare. During system
startup, the command parser reads the factory or startup configuration file command-by-command, organizes the
arguments, and dispatches each command to the command shell for execution. If you use the CLI to enter a command during operation, you alter the running configuration accordingly. In other words, you are modifying a live,
in-service system configuration.
Introduction 76
Page 77
SmartWare Software Configuration Guide 6 • Configuration file handling
Figure 10, shows the characteristics of a configuration file. It is stored on a TFTP server in the file myconfig.cfg
for later download. The command syntax used to enter commands with the CLI and add commands in configuration files is identical. For better comprehension, you can add comments in configuration files. To add a line
with a comment to your configuration file, simply begin the line with the hash (#) character. The command
parser skips everything after the hash character to the end of the line.
#----------------------------------------------------------------#
# My Configuration File
#----------------------------------------------------------------#
# SNTP configuration used for time synchronization
cli version 3.00
sntp-client
sntp-client server primary 172.16.1.10 port 123 version 4
sntp-client poll-interval 600
sntp-client gmt-offset + 01:00:00
# system definitions
system
clock-source 1 2
hostname node
# IP context configuration
context ip router
route 0.0.0.0 0.0.0.0 172.19.32.2 1
route 172.19.41.0 255.255.255.0 172.19.33.250
route 172.19.49.0 255.255.255.0 172.19.33.250
# interface LAN used for connection to internal network
interface lan
ipaddress 172.19.33.30 255.255.255.0
mtu 1500
# interface WAN used for connection to access network
interface wan
ipaddress 172.19.32.30 255.255.255.0
mtu 1500
# CS context configuration
context cs switch
no shutdown
# routing table configuration
routing-table called-e164 rtab
route 2.. dest-interface telecom-operator
# interface used to access the PSTN telecom operator
interface isdn telecom-operator
route call dest-interface h323
# interface used to access the VoIP telecom provider
interface h323 voip-provider
route call dest-table rtab
remoteip 172.19.33.60
Introduction 77
Page 78
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
encapsulation ip
bind interface wan router
no shutdown
Figure 10. Sample configuration file
Each configuration file stored in the flash memory needs a unique name. The user has to assign a file name to
any user-specific configuration. SmartWare predefines some names for configuration files. These are the factory
configuration (factory-config), startup configuration (startup-config), and running configuration (running-
config) file names. Refer to appendix A, “Terms and definitions” on page 635 to learn more about configura-
tion file types.
Factory configuration
SmartNodes are delivered with a factory configuration in the logical region nvram:. This factory configuration
initially parameterizes the most useful network and component settings of SmartWare.
Once a user-specific configuration is created and stored as the startup configuration, the factory configuration
is no longer used, but still remains in the persistent memory. It is possible to switch back to the factory configuration at any time during the operation of a SmartNode configuration. The getting started guide included
with your SmartNode device describes the restoration procedure for restoring the default settings.
Configuration file handling task list
This section describes how to create, load, and maintain configuration files. Configuration files contain a set of
user-configured commands that customize the functionality of your SmartNode device to suit your own operating requirements.
The tasks in this chapter assume that you have at least a minimal configuration running on your system. You
can create a basic configuration file by using the
configuration at the CLI” on page 83 for details.
configure command; see section “Modifying the running
To display, copy, delete, and download or upload configuration files, perform the tasks described in the following sections:
Factory configuration 78
Page 79
SmartWare Software Configuration Guide 6 • Configuration file handling
• Copying configurations within the local memory (see page 79)
• Replacing the startup configuration with a configuration from the Flash memory (see page 80)
• Copying configurations to and from a remote storing location (see page 81)
• Replacing the startup configuration with a configuration downloaded from the TFTP server (see page 82)
• Displaying configuration file information (see page 82)
• Modifying the running configuration at the CLI (see page 83)
• Modifying the running configuration offline (see page 84)
• Deleting a specified configuration (see page 85)
• Downloading encrypted files (see page 86)
Copying configurations within the local memory
Configuration files may be copied into the local memory in order to switch between different configurations.
Remember the different local memory regions in SmartWare as shown in figure 11.
Local Memory Regions
Copy Configuration Files within
the persistent Memory Region
Local
nvram:
• Factory
Configuration
“factory-config”
(read-only)
• Startup
Configuration
“startup-config”
• User specific
Configuration
“user-config”
Store the current Running
Configuration persistently
VolatilePersistent
system:
• current Running
Configuration
“running-config”
Only on Startup to execute
the Startup or Factory
Configuration
In most cases, the interactively modified running configuration known as the running-config, which is located
in the volatile memory region system:, is copied into the persistent memory region nvram:. This running config
is stored under the name startup-config and replaces the existing startup configuration.
Configuration file handling task list 79
Figure 11. Local memory regions
Page 80
SmartWare Software Configuration Guide 6 • Configuration file handling
You can copy the current running configuration into the persistent memory region nvram: under a user-specified name, if you want to preserve that configuration.
In addition, an already existing configuration is usually copied into the persistent memory region nvram: by
using a user-specified name, for conservation or later activation.
As shown in figure 11 the local memory regions are identified by their unique names, like nvram:, which is
located in flash memory, and system:, which is the system RAM, i.e. the volatile memory. As already mentioned, configuration files in the same memory region need a unique name. For example, it is not possible to
have two configuration files with the name running-config in the memory region nvram:.
As you might expect, the
copy command does not move but replicates a selected source to a target configura-
tion file in the specified memory region. Therefore the source configuration file is not lost after the copy process. There are three predefined configuration file names for which it is optional to specify the memory region,
namely factory-config, startup-config and running-config.
Mode: Administrator execution
Step Command Purpose
1 node#copy {factory-config | startup-
config | running-config | nvram: source-
name } nvram:target-name
Copies the selected source configuration file
source-name as target configuration file targetname into the local memory.
Example: Backing up the startup configuration
The following example shows how to make a backup copy of the startup configuration. It is copied under the
name backup into the flash memory region nvram:.
node#copy startup-config nvram:backup
Replacing the startup configuration with a configuration from Flash memory
It is possible to replace the startup configuration by a configuration that is already present in the flash memory.
You can do so by copying it to the area of the flash memory where the startup configuration is stored.
Mode: Administrator execution
Step Command Purpose
1 node# copy nvram:backup startup-config Replaces the existing persistent startup con-
Note The configuration backup can be a previously backed up configuration or
previously downloaded from a TFTP server.
Configuration file handling task list 80
figuration with the startup configuration
backup already present in flash memory.
Page 81
SmartWare Software Configuration Guide 6 • Configuration file handling
Copying configurations to and from a remote storage location
Configuration files 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 configuration file. We will explain the usage of the
remote memory region tftp: in the following section more detailed. Another typical task is uploading the current
running configuration to the remote data store for backup purpose, or if an extensive configuration file is to be
edited on the remote host. In this case the running configuration, named running-config, which is to be found in
the volatile memory region system: is transferred to the TFTP server. On the TFTP server the running configuration is stored to a file whose name is defined as one of the arguments of the
copy command.
Remote (TFTP Server)
tftp:
• Configuration Files
• Batchfiles for
System Image
download
Configuration File Upload
Configuration File Download
Store the current Running
nvram:
• Factory
Configuration
“factory-config”
(read-only)
• Startup
Configuration
“startup-config”
• User specific
Configuration
“user-config”
Configuration remotely
Local (Intelligent Access Device)
Remote Memory
Regions
VolatilePersistent
system:
• current Running
Configuration
“running-config”
Figure 12. Remote memory regions for SmartWare
Finally, configuration files, i.e. the startup configuration or a user-specific configuration that is stored in the
persistent memory region nvram: are often uploaded to the remote data store for backup, edit or cloning purposes. The latter procedure is very helpful when you have several SmartNode devices, each using a configuration which does not greatly differ from the others, or which is the same for all devices. During the
configuration of the first SmartNode according to your requirements, the running configuration of this device,
named running-config and located in the volatile memory region system:, is edited. Next, the configuration is
tested and if everything is as required, the running configuration is copied as startup configuration, named star-
tup-config, into the persistent memory region nvram: of the target device. After this, the startup configuration is
transferred to the TFTP server, where it can be distributed to other SmartNode devices. These devices therefore
get clones of the starting system if the configuration does not need any modifications.
Configuration file handling task list 81
Page 82
SmartWare Software Configuration Guide 6 • Configuration file handling
Replacing the startup configuration with a configuration downloaded from
TFTP server
From within the administration execution mode, you can replace the startup-configuration by downloading a
configuration from the TFTP server into the flash memory area where to store the startup configuration.
Mode: Administrator execution
Step Command Purpose
1 node(cfg)# copy tftp://ip-address[:port]/
new-startup nvram:startup-config
Downloads the configuration file new-startup from
the TFTP server at address ip-address replacing the
existing persistent startup configuration. Optionally
you can enter the UDP port where the TFTP server listens. If the port is not specified, the default port 69 is
used. This progress is visualized with a counter,
counting up from 0 to 100% according to the downloaded amount of the file size. Should the download
fail, an error message % File Transfer - Get failed is
displayed.
Example: Sample configuration download from the TFTP server
The following example shows how to replace the persistent startup configuration in the flash memory of a
SmartNode by overwriting it with the configuration contained in the file new-startup located on the TFTP
server at IP address 172.16.36.80.
1. Download the startup configuration with the
copy command into the flash memory area where to store
the startup configuration.
node>enable
node#configure
node(cfg)#copy tftp://172.16.36.80/user/new-startup nvram:startup-config
Download...100%
node(cfg)#
2. Check the content of the persistent startup configuration by listing its command settings with the show
command.
node#show nvram:startup-config
Displaying configuration file information
This procedure describes how to display information about configuration files
Mode: Administrator execution
Command Purpose
show nvram: Lists all persistent configurations
show running-config Displays the contents of the running configuration file
show startup-config Displays the contents of the startup configuration file
Configuration file handling task list 82
Page 83
SmartWare Software Configuration Guide 6 • Configuration file handling
It is recommended that you never save a configuration in startupconfig or a user-specific configuration with the cli config defaults
IMPORTANT
Note Application files can be very long when displayed (by using the show com-
command because the additional list of default commands consumes significant portions of the nvram: memory.
mand). To make them easier to read, many default commands are not displayed when executing the
show running-config command. However, the
administrator may want to see the entire configuration, including these normally “hidden” default commands. To see all commands, execute the
config defaults
command. By issuing a show running-config command
cli
afterwards, you will see all the commands, a list which is significantly longer.
To hide these hidden commands again, issue the
defaults
command.
no cli config
Modifying the running configuration at the CLI
SmartWare accepts interactive modifications on the currently running configuration via the CLI. Interactive
configuring needs access to the CLI. Use the
then switch to the configuration mode by typing the command
enable command to enter administrator execution mode, and
configure. Once in configuration mode, you
can enter the configuration commands that are necessary to your SmartNode’s operation. When you configure
SmartWare by using the CLI, the shell executes the commands as you enter them.
When you log in using the CLI, all commands you enter directly modify the running configuration located in
the volatile memory region system: (or RAM) of your SmartNode. Because it is located in volatile memory, to
be made permanent, your modifications must be copied to the persistent (non-volatile) memory. In most cases
you will store it as the upcoming startup configuration in the persistent memory region nvram: under the name
startup-config. On the next start-up the system will initialize itself using the modified configuration. After the
startup configuration has been saved to persistent memory, you have to restart the SmartNode by using the
reload command to cause the system to initialize with the new configuration.
The execution command
reload accepts with the following options:
• graceful—reloads the system only if no voice calls are ongoing. If there are voice calls, the system waits until
they all are closed to reload.
• forced—reloads the system without prompting for confirmation or for saving the running-configuration
(no need to type yes or no). The question whether to save the running-configuration is automatically
answered with no, the question whether to reload or not with yes.
Mode: Administrator execution
Step Command Purpose
1 node#configure Enters administrator configuration mode
2 Enter all necessary configuration commands.
3 node(cfg)#copy running-config startup-config Saves the running configuration file as the
upcoming startup configuration
4 node(cfg)#reload Restarts the system
Configuration file handling task list 83
Page 84
SmartWare Software Configuration Guide 6 • Configuration file handling
Example: Modifying the running configuration at the CLI
The following example shows how to modify the currently running configuration via the CLI and save it as the
startup configuration.
node#configure
node(cfg)#…
node(cfg)#copy running-config startup-config
node(cfg)#reload
Press 'yes' to restart, 'no' to cancel : yes
The system is going down
Modifying the running configuration offline
In cases of complex configuration changes, which are easier to do offline, you may store a configuration on a
TFTP server, where you can edit and save it. Since the SmartNode is acting as a TFTP client, it initiates all file
transfer operations.
First, upload the running configuration, named running-config, from the SmartNode to the TFTP server. You
can then edit the configuration file located on the TFTP server by using any regular text editor. Once the configuration has been edited, download it back into the SmartNode as upcoming startup configuration and store
it in the persistent memory region nvram: under the name startup-config. Finally, restart the SmartNode by
using the
reload command to activate the changes.
Mode: Administrator execution
Step Command Purpose
1 node#copy running-config tftp://node-ip-
address[:port]/current-config
2 Offline editing of the configuration file current-
3 node#copy tftp://node-ip-address/current-config
nvram: startup-config
4 node#reload Restarts the system
Uploads the current running configuration as file
current-config to the TFTP server at address node-
ip-address. Optionally you can enter the UDP
port where the TFTP server listens. If the port is
not specified, the default port 69 is used. This
progress is visualized with a counter, counting up
from 0 to 100% according to the downloaded
amount of the file size. If the upload should fail
an error message “% File Transfer - Put failed” is
displayed.
config on the TFTP server using any regular text
editor.
Downloads the modified configuration file current-config from the TFTP server at address nodeip-address into the persistent memory region
nvram: by using the name startup-config. This
progress is visualized with a counter, counting up
from 0 to 100% according to the downloaded
amount of the file size. Should the download fail,
an error message “% File Transfer - Get failed” is
displayed.
Configuration file handling task list 84
Page 85
SmartWare Software Configuration Guide 6 • Configuration file handling
Example: Modifying the running configuration offline
The following example shows how to upload the running configuration from the SmartNode to the file cur-
rent-config on a TFTP server at IP address 172.16.36.80. The uploaded configuration file is written into the
root directory specified by the TFTP server settings, and overwrites any existing file with the same name. Read
your TFTP server manual to get a thorough understanding of its behavior. After this, the configuration file is
available for offline editing on the TFTP server. Once the configuration file current-config has been modified, it
is downloaded from the TFTP server, at IP address 172.16.36.80, into the persistent memory region nvram:
using the name startup-config. It will become active after a reload.
node#copy running-config tftp://172.16.36.80/user/current-config
Upload...100%
At this point in time, the offline editing of the configuration file current-config on the TFTP server takes place.
node#copy tftp://172.16.36.80/user/ current-config nvram:startup-config
Download...100%
node#reload
Press 'yes' to restart, 'no' to cancel : yes
The system is going down
Deleting a specified configuration
This procedure describes how to delete configuration files from the SmartNode flash memory region nvram:.
Mode: Administrator execution
Step Command Purpose
1 node#show nvram: Lists the loaded configurations
2 node#erase name Deletes the configuration name from the flash memory.
Example: Deleting a specified configuration
The following example shows how to delete a specific configuration from among a set of three available configurations in Flash memory. The configuration named minimal is to be deleted, since it is no longer used.
1. Use the command
node#show nvram:
Persistent configurations:
backup
minimal
startup-config
factory-config
show nvram: to list all available configurations.
2. Delete the configuration named minimal explicitly.
node#erase nvram:minimal
3. Enter again the command show nvram: to check if the selected configuration was deleted successfully
from the set of available configurations.
node#show nvram:
Persistent configurations:
backup
Configuration file handling task list 85
Page 86
SmartWare Software Configuration Guide 6 • Configuration file handling
startup-config
factory-config
Encrypted file download
This section explains how configuration files can be transported encrypted over IP.
TFTP as a configuration download mechanism has the advantage of being extremely simple (trivial) and applicable in any network without any requirements for specialized management servers or applications. It has the
disadvantage of being completely insecure.
The security hole of downloading complete configurations—which may contain IP addresses, login names,
ect.—using TFTP becomes particularly pressing in combination with the auto-provisioning feature which
allows large scale distribution of configurations in entire networks.
To alleviate this problem and maintain the simplicity of TFTP downloads support for encrypted configuration
file downloads is introduced.
Goal: Prevent maliciously intercepted configurations to be readable by unauthorized users.
Pre-requisites: Only authorized users have configuration access to the SmartNode. The configurations can be
stored in plain form on the SmartNode. SNMP Write Access shall be restricted by means of communities and
ACLs to prevent unauthorized SNMP initiated configuration downloads. Telnet access shall be restricted by
means of credentials and ACLs.
Encrypted Configuration Download
An external encryption tool on the PC is used to encrypt the configuration file:
enctool encrypt <plain-config-file> <enc-config-file> [<key>]
The encrypted configuration file can then be downloaded with TFTP triggered by
• The CLI copy command: copy tftp://<host>/<path> <config-file>
• Auto provisioning
• SNMP
• HTTP
On the SmartNode the encryption is detected and the configuration file is automatically decrypted before
stored to flash.
A custom encryption key can be:
• Downloaded to the SmartNode
• Specified with the PC encryption tool
The encryption key may include the MAC address and/or serial number of the SmartNode using the placeholders $(system.mac) and $(system.serial) respectively.
An encrypted configuration file can be uploaded to a TFTP server on request, specifying the encrypted flag:
copy <config-file> tftp://<host>/<path> encrypted
On the PC the encryption tool can be used to decrypt the file:
Configuration file handling task list 86
Page 87
SmartWare Software Configuration Guide 6 • Configuration file handling
enctool decrypt <enc-config-file> <plain-config-file> [<key>]
A log file 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 configuration file that is downloaded later. A default encryption key is already installed
on the SmartNode.
To install an encryption key you have to create a file on your TFTP server that contains the key. Then you have
to download this key file to the SmartNode using the copy command of the SmartNode.
The key file shall contain a key string of at most 24 characters on a single line. Spaces, tabs and LF/CR characters are trimmed. The key must not contain LF/CR or the null character and must not start or end with a space
or tab. If the key contains more than 24 characters, only the first 24 characters are considered.
The key may contain variables that are resolved when the key file is downloaded to a SmartNode. Using this
mechanism you can specify device-specific encryption keys. We currently support the following variables:
• $(system.mac): The MAC address of the first ethernet port. Execute the show port ethernet command on a
SmartNode to display the MAC address of a SmartNode. This value without the colon separators and with
all lower-case hexadecimal letters is used instead of the variable on the SmartNode.
• $(system.serial): The serial number of the SmartNode. Execute the show version command on the Smart-
Node to display the serial number.
When your key file contains the following line:
123$(system.serial)abc$(system.mac)XYZ
The command show port ethernet shows the following:
Ethernet Configuration
------------------------------------Port : ethernet 0 0 0
State : OPENED
MAC Address : 00:0C:F1:87:D9:09
Speed : 10MBit/s
Duplex : Half
Encapsulation : ip
Binding : interface eth0 router
The command show version displays the following:
[...]
Serial number : 100000020002
[...]
The encryption key on this SmartNode will be interpreted as:
Configuration file handling task list 87
Page 88
SmartWare Software Configuration Guide 6 • Configuration file handling
123100000020002abc000cf187d909XYZ
Then you have to download the created key file to the SmartNode. Open a telnet session and type in the following 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 file relative to the
TFTP root.
The downloaded key also defines how the passwords are
encrypted in your configuration files. After you downloaded a
IMPORTANT
key file you have to regenerate the startup-config from the
running-config by executing the command.
copy running-config startup-config
If you don’t do this, the device will fail executing the commands
that have encrypted password arguments in the startup-config.
Encrypt a configuration file
Use the encryption tool to encrypt a configuration file on your PC. Therefore you have to enter the
following command.
enctool encrypt <plain-file> <encrypted-file> [<key>]
Where <plain-file> is the path of the non-encrypted input configuration file and <encrypted-file> is the path of
the encrypted output configuration file. <key> specifies the encryption key which shall be used to encrypt the
configuration file. If omitted the default key is used.
Download an encrypted configuration file
Now you can download the configuration file as usual using the CLI copy-command, the auto-provisioning
feature, HTTP or SNMP download. The SmartNode automatically detects that a downloaded file is encrypted
and tries to decrypt the file using the pre-installed key.
Upload an encrypted configuration file
The SmartNode immediately decrypts a configuration file after downloading it. This is the configuration
file is stored non-encrypted in the flash memory. Thus when you upload a configuration it is
uploaded non-encrypted.
You may upload an encrypted configuration file specifying the encrypted flag at the end of the copy command:
#copy startup-config tftp://<ip>/<path> encrypted
This encrypts the configuration file before sending it to the TFTP server. Use the enctool decrypt command
on the PC to regain the original configuration.
Configuration file handling task list 88
Page 89
Chapter 7 Basic system management
Chapter contents
Introduction..........................................................................................................................................................90
Basic system management configuration task list ...................................................................................................90
Managing feature license keys .........................................................................................................................91
Setting system information .............................................................................................................................92
Setting the system banner ................................................................................................................................93
Setting time and date ......................................................................................................................................94
Display clock information ...............................................................................................................................94
Display time since last restart ..........................................................................................................................95
Configuring the Web server ............................................................................................................................95
Determining and defining the active CLI version ............................................................................................95
Restarting the system ......................................................................................................................................96
Displaying the system logs ..............................................................................................................................96
Displaying reports ...........................................................................................................................................97
Controlling command execution .....................................................................................................................97
Timed execution of CLI command .................................................................................................................99
Displaying the checksum of a configuration ....................................................................................................99
Configuration of terminal sessions ..................................................................................................................99
89
Page 90
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 configuration. The following are basic parameters that can be established when setting up a new system:
• Defining the system's hostname
• Setting the location of the system
• Providing reference contact information
• Setting the clock
Additionally, the following tasks are described in this chapter:
• Checking the CRC of configuration files
• Displaying the currently running SmartWare commands
• Moving SmartWare commands into the foreground
• Setting the system banner
• Enabling the embedded web server
Basic system management configuration task list
All tasks in the following sections are optional, though some such as setting time and calendar services and system information are highly recommended.
To configure basic system parameters, perform the tasks described in the following sections.
• Managing feature license keys (see page 91)
• Setting system information (see page 92)
• Setting the system banner (see page 93)
• Setting time and date (see page 94)
• Displaying clock information (see page 94)
• Displaying time since last restart (see page 95)
• Configuring and starting the web server (see page 95)
• Determining and defining the active CLI version (see page 95)
• Restarting the system (see page 96)
• Displaying the system event log (see page 96)
• Controlling command execution (see page 97)
• Setting timed execution of CLI commands (see page 99)
• Displaying the checksum of a configuration (see page 99)
• Configuration of terminal sessions (see page 99)
• Identifying a unit by flashing all LED’s (see page 99)
Introduction 90
Page 91
SmartWare Software Configuration Guide 7 • Basic system management
Managing feature license keys
Several features of the firmware require a system specific 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 file containing the
license keys from a TFTP server to the equipment. Therefore, a TFTP server must be present in the IP network
where you can store the license keys file obtained from the distributor. If no TFTP server is available, the
license key can also be manually typed (or copied and pasted) in a console or Telnet window. Both procedures
are described below.
Mode: Configure
Step Command Purpose
1 node(cfg)#copy tftp://tftp-server/path/file-
name licenses:
Downloads the license key file and install the
licenses.
Example: Installing license keys from a TFTP server
The following example shows the command used to install license keys, which are stored in a license file on a
TFTP server.
node(cfg)#copy tftp://172.16.4.3/keystore/myLicense.lic licenses:
Mode: Configure
Step Command Purpose
1 node(cfg)#install license license-key Install the license key
2 Repeat step 1 for any additional license keys
Example: Installing license keys from the console
The following example shows the command used to install license keys manually on the console.
node(cfg)#install license 10011002R1Ws63yKV5v28eVmhDsVGj/JwKqIdpC4Wr1BHaNtenXUYF/
2gNLoihifacaTPLKcV+uQDG8LJis6EdW6uNk/
GxVObDEwPFJ5bTV3bIIfUZ1eUe+8c5OpCCd7PSAe83Ty2c/
CnZPSlEjIrVlJrr8VhOr1DYxkEV9evBp+tSY+y9sCeXhDWt5Xq15SAPlznTLQmym7fDakvm+zltzswX/
KX13sdkR0ub9IX4Sjn6YrvkyrJ2dCGivTTB3iOBmRjV1u
After installing license keys, you can check if the license keys have been added successfully to your system using
the following command.
Mode: Configure
Step Command Purpose
1 node(cfg)#show licenses Display all installed licenses
Example: Displaying installed licenses
The following example shows the command used to display all installed licenses on a system and a sample of its
output.
Basic system management configuration task list 91
Page 92
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
• Supplier
By default there is no information specified for any of the above parameters.
System contact information tells the user how to contact the information service, e.g. the help line of the service provider. The contact information may be any alphanumeric string, including spaces, that is no longer
than one line. This entry corresponds to the MIB II system sysContact object.
The system name, also called the hostname, is used to uniquely identify the SmartNode in your network. The
selected name should follow the rules for ARPANET hostnames. Names must start with a letter, end with a letter or digit, and have as interior characters only letters, digits, and hyphens. Names must be 63 characters or
fewer. For more information, refer to RFC 1035. This entry corresponds to the MIB II system sysName object.
After setting the hostname of the SmartNode the CLI prompt will be replaced with the chosen name.
Assigning explanatory location information to describe the system physical location of your SmartNode (e.g.
server room, wiring closet, 3rd floor, etc.) is very supportive. This entry corresponds to the MIB II system sysLocation object.
The system provider information is used to identify the provider contact for this SmartNode device, together
with information on how to contact this provider. The provider is a company making services available to subscribers. The provider information may be any alphanumeric string, including spaces, that is no longer than
one line. This entry corresponds to the Patton Electronics enterprise-specific MIB provider object.
The system subscriber information is used to get in touch with subscriber for this SmartNode device, together
with information on how to contact this subscriber. The subscriber is a company or person using one or more
services from a provider. The subscriber information may be any alphanumeric string, including spaces, that is
no longer than one line. This entry corresponds to the Patton Electronics enterprise-specific MIB subscriber
object.
The system supplier information is used to get in touch with the supplier for this SmartNode device, together
with information on how to contact this supplier. The supplier is a company delivering SmartNode devices to
a provider. The supplier information may be any alphanumeric string, including spaces, that is no longer than
one line. This entry corresponds to the Patton Electronics enterprise-specific MIB supplier object.
Basic system management configuration task list 92
Page 93
SmartWare Software Configuration Guide 7 • Basic system management
Mode: Configure
Step Command Purpose
1 node(cfg)#system contact information Sets the contact information to information
2 node(cfg)#system hostname information Sets the hostname to information
3 node(cfg)#system location information Sets the location information to information
4 node(cfg)#system provider information Sets the provider information to information
5 node(cfg)#system subscriber information Sets the subscriber information to information
6 node(cfg)#system supplier information Sets the supplier information to information
Note If the system information must have more than one word, enclose it in dou-
ble quotes.
Example: Setting system information
The following example shows the commands used to configure the contact information for your device, if you
start from the operator execution mode.
node(cfg)#system contact "Bill Anybody, Phone 818 700 1504"
node(cfg)#system hostname node
node(cfg)#system location “Wiring Closet, 3rd Floor”
node(cfg)#system provider “Best Internet Services, contact@bis.com, Phone 818 700
2340”
node(cfg)# system subscriber “Mechanical Tools Inc., jsmith@mechtool.com, Phone 818
700 1402”
node(cfg)# system supplier “WhiteBox Networks Inc., contact@whitebox.com, Phone 818
700 1212”
Setting the system banner
The system banner is displayed on all systems that connect to your SmartNode via Telnet or a serial connection
(see figure 13). It appears at login and is useful for sending messages that affect administrators and operators,
such as scheduled maintenance or system shutdowns. By default no banner is present on login.
To create a system banner use the
banner command followed by the message you want displayed. If the ban-
ner message has to be formed out of more than one word the information is enclosed by double quotes. Adding
the escape sequence “\n” to the string forming the banner creates a new line on the connected terminal screen.
Use the
no banner command to delete the message.
Mechanical Tools Inc.
jsmith@mechtool.com
Phone 818 700 1402
login:
Figure 13. System banner with message to operators
Mode: Configure
Step Command Purpose
1 node(cfg)#banner message Sets the message for the system banner to message
Basic system management configuration task list 93
Page 94
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
configuration mode.
node(cfg)#banner \n#\n# The password of all operators has changed\n# please contact
the administrator\n#"
Setting time and date
All SmartNode devices provide time-of-day and date services. These services allow the products to accurately
keep track of the current time and date. The system clock specifies year, month, day, hour, minutes, and
optionally seconds. The time is in 24-hour format yyyy-mm-ddThh:mm:ss and is retained after a reload.
Mode: Configure
Step Command Purpose
1 node(cfg)#clock set yyyy-mm-ddThh:mm:ss Sets the system clock to yyyy-mm-ddThh:mm:ss
Note The integrated SNTP client allows synchronization of time-of-day and date
to a reference time server. Refer to chapter 26, “SNTP client configuration”
on page 280 for more details.
Example: Setting time and date
The following example shows the commands used to set the system clock of your device to August 6, 2001 at
16:55:57, if you start from the operator execution mode.
node(cfg)#clock set 2001-08-06T16:55:57
Display clock information
This procedure describes how to display the current date and time
Mode: Both in operator and administrator execution
Step Command Purpose
1 node>show clock Display the local time.
Example: Display clock information
The following example shows the commands used to display the time and date settings of your device in local
time, if you start from the operator execution mode.
node>show clock
2001-08-06T16:55:57
Basic system management configuration task list 94
Page 95
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
1 node>show uptime Display the time since last restart.
Example:
The following example shows how to display the uptime of your device, if you start from the configuration mode.
node>show uptime
The system is up for 54 days, 23 hours, 44 minutes, 18 seconds
Configuring the Web server
The embedded web server has two parameters that are configurable.
Note Changing the language parameter does not affect the language of the web
configuration pages.
Mode: Configure
Step Command Purpose
1 node(cfg)#webserver language
{de | en}
2 node(cfg)#webserver port port-
number
Sets the language to either German (de) or English (en).
Sets the listening port number in the 1 to 65535, default
port number for the web server is 80.
Example: Configuring and starting the Web server
The following example shows how to set the web server language and the listening port of your device, if you
start from the configuration mode.
node(cfg)#webserver language en
node(cfg)#webserver port 80
Determining and defining the active CLI version
SmartWare allows having a number of CLI version installed together, whereas only one CLI version is activated. There are commands available to determine the currently running CLI version and if necessary switch to
another CLI version. The idea of having several CLI version available on a system is mostly to offer reduced or
enhanced command sets to users.
Mode: Configure
Step Command Purpose
1 node(cfg)#show version cli Displays the currently running CLI version
2 node(cfg)#cli version version.revision Selects the active CLI version in the form version.revi-
Basic system management configuration task list 95
sion
Page 96
SmartWare Software Configuration Guide 7 • Basic system management
Example: Defining the desired CLI version
The following example shows how to determine the running CLI version and define CLI version 2.10 for your
device, if you start from the configuration mode.
node(cfg)#show version cli
CLI version : 3.00
node(cfg)#cli version 2.10
Restarting the system
In case the SmartNode has to be restarted, the
reload command must be used. The reload command includes
a two-dialog, where the user is allowed to store any unsaved configuration data and finally confirms the
system restart.
Restarting the system interrupts running data transfers and all
voice calls.
IMPORTANT
The execution command reload has been enhanced with the following options:
• graceful—reloads the system only if no voice calls are ongoing. If there are voice calls, the system waits until
they all are closed to reload.
• forced—reloads the system without prompting for confirmation or for saving the running-configuration
(no need to type yes or no). The question whether to save the running-configuration is automatically
answered with no, the question whether to reload or not with yes.
Mode: Administrator execution
Step Command Purpose
1 node#reload Restarts the system
Example: Restarting the system
The following example shows how to restart the currently running system, if you start from the administrator
execution mode.
node#reload
System configuration has been changed.
Press 'yes' to store, 'no' to drop changes : yes
Press 'yes' to restart, 'no' to cancel : yes
The system is going down
Displaying the system logs
The system logs contain warnings and information from the system components of SmartWare. In case of
problems it is often useful to check the event or the supervisor logs for information about malfunctioning system components. The event log stores general events such as flash full, DSP failed etc., comparable with the
event log on Windows NT. The supervisor log stores information from the system supervisor such as memory
full, task failed etc.
Basic system management configuration task list 96
Page 97
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.
Mode: Administrator execution
Step Command Purpose
1 node#show log [event] Show event log.
2 node#show log supervisor Show log of the system supervisor. Used For example, after an unex-
pectedly reboot.
3 node#show log reset Output a list of reset reasons (with date and time).
4 node#show log boot Displays the console and log messages captured during startup of the
unit.
5 node#show log login Displays a list of succeeded and failed CLI login attempts.
6 node#show log file-
transfer
Displays the history of all recently executed file transfer operations
(up to 50 entries).
Displaying reports
The show reports command is used to dump combined system information. The show reports command
sequentially executes the following log commands:
show version
show clock
show uptime
show licenses
show memory stat
show log reset
show log boot
show log event
show log supervisor
show factory-config
show startup-config
show running-config
Mode: Administrator execution
Step Command Purpose
1 node#show reports Dumps the combined system information.
Controlling command execution
The SmartWare command shell includes a basic set of commands that allow you to control the execution of
other running commands. In SmartWare, the commands jobs and fg are used for such purposes. The command
jobs lists all running commands, and fg allows switching back a suspended command to the fore-
ground. Moreover using <ctrl>-<z> suspends an active command and lets the system prompt reappear. With
<ctrl>-<c> the currently active command can be terminated.
Basic system management configuration task list 97
Page 98
SmartWare Software Configuration Guide 7 • Basic system management
Mode: Administrator execution
Step Command Purpose
1 Execute the first command
2 node#<Ctrl-Z> Suspend the active command and get system prompt back
3 Execute the second command
4 node#jobs Shows the currently running commands
5 node#fg jobid Brings job with jobid back to foreground
6 node#<Ctrl-C> Terminates the currently running command
Example: Controlling Command Execution
The following example shows how to suspend an active command, list the running commands, switch back a
suspended command and terminate a currently active command on your device, if you start from the configuration mode.
node>ping 172.16.36.80 1000 timeout 3
Sending 1000 ICMP echo requests to 172.16.36.80, timeout is 3 seconds:
Reply from 172.16.36.80: Time <10ms
Reply from 172.16.36.80: Time <10ms
Reply from 172.16.36.80: Time <10ms
Reply from 172.16.36.80: Time <10ms
<Ctrl>-<z> suspend active command
% 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
% Resumed [ping]
Reply from 172.16.36.80: Time <10ms
Reply from 172.16.36.80: Time <10ms
<Ctrl>-<c> terminate current command
% Aborted (ping)
Basic system management configuration task list 98
Page 99
SmartWare Software Configuration Guide 7 • Basic system management
Timed execution of CLI command
The command
timer allows the timed execution of CLI commands. The timer command is incremental; this
means for each time it is entered, a new timer is created. All timers appear in the running-configuration, except
if they have been created with the volatile option. It is possible to specify for each timer the start time and the
reoccurrence. Use the CLI help (tab completion) for detailed description of all configuration options.
Some examples:
timer FIRMWARE_UPDATE now + 2 minutes every 10 minutes “provisioning execute FIRMWARE”
Starts a timer named FIRMWARE_UPDATE, whose first execution time is 2 minutes after the command is
entered (2 minutes after device startup if the command is in the startup-configuration), and is executed every
10 minutes afterwards. This timer does not expire. The executed CLI command is
execute FIRMWARE
timer volatile RELOAD midnight + 1 hour “reload graceful”
.
provisioning
Starts a volatile timer named RELOAD (does not appear in the running-configuration, and thus is not stored in
the startup-configuration). The timer is executed once, 1 hour after midnight, and reloads the
system gracefully.
Displaying the checksum of a configuration
In SmartWare configuration files, e.g. startup configuration, running configuration, and user-specific configuration, contain a checksum entry. This checksum informs the user about the validity and helps distinguish configuration files on the basis of the checksum.
Mode: Administrator execution
Step Command Purpose
1 node#show crc filename Displays checksum of a configuration
Example:
Displaying the checksum of a configuration
The following example shows how to display the checksum of the configuration test of your device, if you start
from the configuration mode.
node#show crc nvram:test
File nvram: test:
checksum: 0xfaddc88a
Configuration of terminal sessions
In certain cases it may be desirable to change the settings of the current terminal session.
Mode: System
Step Command Purpose
1 [name] (sys)#terminal height Configures the terminal height.
Basic system management configuration task list 99
Page 100
SmartWare Software Configuration Guide 7 • Basic system management
Step Command Purpose
2 [name] (sys)#[no] terminal idle-time-
logout
After 30 minutes without user input, a terminal session
is automatically closed. If longer session periods are
required (logging/debugging) this command allows
to increase the session timeout, or to disable it completely.
3 [name] (sys)#terminal more Enables pausing of display for commands which pro-
duce more output than the current terminal window
can display at once.
4 [name] (sys)#terminal width Configures the terminal width.
When there are many VoIP units in the same location, use this command to flash all the LED’s on a specific
unit for a specified period of time. This makes identification of the physical unit very easy.
Step Command Purpose
1 [name] #blink <seconds> Enter an integer for the period of time you want the
LED’s to flash on the physical unit.
Basic system management configuration task list 100
Loading...