SmartNode Series
SmartWare Release 5.2
Software Configuration Guide
Sales Office: +1 (301) 975-1000
Technical Support: +1 (301) 975-1007
E-mail: support@patton.com
URL: www.patton.com
Part Number: 07MSWR52_SCG, Rev. A
Revised: August 7, 2008
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
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.................................................................................................................................. 65
6 Configuration file handling........................................................................................................................... 76
7 Basic system management ............................................................................................................................. 90
8 RADIUS Client Configuration.................................................................................................................... 102
9 IP context overview ..................................................................................................................................... 114
10 IP interface configuration ........................................................................................................................... 120
11 NAT/NAPT configuration........................................................................................................................... 132
12 Ethernet port configuration ........................................................................................................................ 141
13 Link scheduler configuration ...................................................................................................................... 151
14 Serial port configuration ............................................................................................................................. 170
15 Frame Relay configuration .......................................................................................................................... 177
16 PRI port configuration................................................................................................................................ 191
17 BRI port configuration................................................................................................................................ 205
18 ISDN Overview ........................................................................................................................................... 212
19 ISDN configuration .................................................................................................................................... 217
20 RBS configuration....................................................................................................................................... 225
21 DSL Port Configuration.............................................................................................................................. 230
22 Basic IP routing configuration .................................................................................................................... 235
23 RIP configuration........................................................................................................................................ 242
24 Access control list configuration.................................................................................................................. 253
25 SNMP configuration ................................................................................................................................... 267
26 SNTP client configuration .......................................................................................................................... 282
27 DHCP configuration................................................................................................................................... 292
28 DNS configuration...................................................................................................................................... 304
29 DynDNS configuration............................................................................................................................... 308
30 PPP configuration....................................................................................................................................... 313
31 CS context overview .................................................................................................................................... 339
3
4
SmartWare Software Configuration Guide
32 VPN configuration ...................................................................................................................................... 362
33 CS interface configuration........................................................................................................................... 381
34 ISDN interface configuration...................................................................................................................... 390
35 FXS interface configuration......................................................................................................................... 404
36 FXO interface configuration ....................................................................................................................... 414
37 RBS interface configuration ........................................................................................................................ 426
38 H.323 interface configuration ..................................................................................................................... 431
39 SIP interface configuration ......................................................................................................................... 441
40 Call router configuration............................................................................................................................. 456
41 SIP call-router services ................................................................................................................................ 524
42 Tone configuration...................................................................................................................................... 529
43 FXS port configuration ............................................................................................................................... 537
44 FXO port configuration .............................................................................................................................. 542
45 H.323 gateway configuration ...................................................................................................................... 546
46 Context SIP gateway overview..................................................................................................................... 559
47 VoIP profile configuration .......................................................................................................................... 573
48 PSTN profile configuration......................................................................................................................... 597
49 SIP profile configuration............................................................................................................................. 601
50 Authentication Service................................................................................................................................. 604
51 Location Service .......................................................................................................................................... 607
52 VoIP debugging........................................................................................................................................... 624
A Terms and definitions ................................................................................................................................ 644
B Mode summary ........................................................................................................................................... 650
C Command summary ................................................................................................................................... 654
D Internetworking terms & acronyms ........................................................................................................... 657
E Used IP ports & available voice codecs ...................................................................................................... 662
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
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
Opening a secure configuration session over SSH ...........................................................................................59
Displaying the CLI version .............................................................................................................................60
Displaying account information ......................................................................................................................60
Switching to another account ..........................................................................................................................61
Checking identity and connected users ...........................................................................................................61
Command index numbers ...............................................................................................................................62
Ending a Telnet or console port session ..........................................................................................................64
Showing command default values ...................................................................................................................64
5 System image handling.................................................................................................................................. 65
Introduction..........................................................................................................................................................66
Memory regions in SmartWare..............................................................................................................................67
System image handling task list .............................................................................................................................68
Displaying system image information ..............................................................................................................69
Copying system images from a network server to Flash memory .....................................................................69
7
SmartWare Software Configuration Guide
Table of Contents
Upgrading the software directly ......................................................................................................................71
Auto provisioning of firmware and configuration ..................................................................................................72
Boot procedure......................................................................................................................................................74
Factory configuration ............................................................................................................................................75
Default Startup Configuration ........................................................................................................................75
IP Addresses in the Factory Configuration ......................................................................................................75
6 Configuration file handling........................................................................................................................... 76
Introduction..........................................................................................................................................................77
Understanding configuration files ...................................................................................................................77
Factory configuration ............................................................................................................................................79
Configuration file handling task list.......................................................................................................................79
Copying configurations within the local memory ............................................................................................80
Replacing the startup configuration with a configuration from Flash memory ................................................81
Copying configurations to and from a remote storage location ........................................................................82
Replacing the startup configuration with a configuration downloaded from TFTP server ...............................83
Displaying configuration file information .......................................................................................................83
Modifying the running configuration at the CLI .............................................................................................84
Modifying the running configuration offline ...................................................................................................85
Deleting a specified configuration ...................................................................................................................86
Encrypted file download .................................................................................................................................87
Encrypted Configuration Download .........................................................................................................87
Use Cases ..................................................................................................................................................88
7 Basic system management ............................................................................................................................. 90
Introduction..........................................................................................................................................................91
Basic system management configuration task list ...................................................................................................91
Managing feature license keys .........................................................................................................................92
Setting system information .............................................................................................................................93
Setting the system banner ................................................................................................................................94
Setting time and date ......................................................................................................................................95
Display clock information ...............................................................................................................................95
Display time since last restart ..........................................................................................................................96
Configuring the Web server ............................................................................................................................96
Determining and defining the active CLI version ............................................................................................96
Restarting the system ......................................................................................................................................97
Displaying the system logs ..............................................................................................................................97
Displaying reports ...........................................................................................................................................98
Controlling command execution .....................................................................................................................98
Timed execution of CLI command ...............................................................................................................100
Displaying the checksum of a configuration ..................................................................................................100
Configuration of terminal sessions ................................................................................................................100
8 RADIUS Client Configuration.................................................................................................................... 102
Introduction........................................................................................................................................................103
The AAA component ..........................................................................................................................................103
8
SmartWare Software Configuration Guide
Table of Contents
General AAA Configuration ..........................................................................................................................104
RADIUS configuration........................................................................................................................................106
Configuring RADIUS clients ........................................................................................................................107
Configuring RADIUS accounting .................................................................................................................108
Configuring the RADIUS server ...................................................................................................................110
Attributes in the RADIUS request message .............................................................................................110
Attributes in the RADIUS accept message ...............................................................................................111
Configuring the local database accounts ..............................................................................................................111
Storing call logs with quality information ............................................................................................................113
9 IP context overview ..................................................................................................................................... 114
Introduction........................................................................................................................................................115
IP context overview configuration task list...........................................................................................................116
Planning your IP configuration ...........................................................................................................................117
IP interface related information .....................................................................................................................117
QoS related information ...............................................................................................................................117
Configuring physical ports...................................................................................................................................117
Creating and configuring IP interfaces.................................................................................................................117
Configuring NAPT .............................................................................................................................................118
Configuring static IP routing...............................................................................................................................118
Configuring RIP..................................................................................................................................................118
Configuring access control lists............................................................................................................................119
Configuring quality of service (QoS) ...................................................................................................................119
10 IP interface configuration ........................................................................................................................... 120
Introduction........................................................................................................................................................121
IP interface configuration task list........................................................................................................................121
Creating an IP interface ................................................................................................................................121
Deleting an IP interface ................................................................................................................................122
Setting the IP address and netmask ...............................................................................................................123
Configuring a NAPT DMZ interface ............................................................................................................123
ICMP message processing .............................................................................................................................124
ICMP redirect messages ................................................................................................................................124
Router advertisement broadcast message .......................................................................................................124
Defining the MTU and MSS of the interface ................................................................................................125
Configuring an interface as a point-to-point link ..........................................................................................126
Displaying IP interface information ..............................................................................................................126
Displaying dynamic ARP entries ...................................................................................................................127
Flushing dynamic ARP entries ......................................................................................................................127
Processing gratuitous ARP requests ...............................................................................................................127
Testing connections with the ping command ................................................................................................127
IP link supervision ........................................................................................................................................128
Check connectivity of an IP link .............................................................................................................129
Show IP link status ..................................................................................................................................129
Debug connectivity .................................................................................................................................129
9
SmartWare Software Configuration Guide
Table of Contents
Debug ARP ...................................................................................................................................................129
Traceroute ....................................................................................................................................................130
Configuring the IGMP Proxy..............................................................................................................................131
11 NAT/NAPT configuration........................................................................................................................... 132
Introduction........................................................................................................................................................133
Dynamic NAPT ...........................................................................................................................................133
Static NAPT .................................................................................................................................................134
Dynamic NAT ..............................................................................................................................................134
Static NAT ...................................................................................................................................................135
NAPT traversal .............................................................................................................................................135
NAT/NAPT configuration task list .....................................................................................................................136
Creating a NAPT profile ...............................................................................................................................136
Configuring a NAPT DMZ host .............................................................................................................137
Defining NAPT port ranges ....................................................................................................................137
Preserving TCP/UDP port numbers in NAPT ........................................................................................138
Defining the UDP NAPT type ...............................................................................................................138
Activate NAT/NAPT ....................................................................................................................................139
Displaying NAT/NAPT configuration information ......................................................................................139
Configuring NAT static protocol entries .......................................................................................................140
12 Ethernet port configuration ........................................................................................................................ 141
Introduction........................................................................................................................................................142
Ethernet port configuration task list ....................................................................................................................142
Entering the Ethernet port configuration mode ............................................................................................142
Configuring medium for an Ethernet port ....................................................................................................142
Configuring Ethernet encapsulation type for an Ethernet port ......................................................................143
Binding an Ethernet port to an IP interface ..................................................................................................143
Multiple IP addresses on Ethernet ports ........................................................................................................144
Configuring a VLAN ....................................................................................................................................145
Configuring layer 2 CoS to service-class mapping for an Ethernet port .........................................................146
Adding a receive mapping table entry ......................................................................................................147
Adding a transmit mapping table entry ...................................................................................................148
Closing an Ethernet port ...............................................................................................................................148
Using the built-in Ethernet sniffer .......................................................................................................................149
13 Link scheduler configuration ...................................................................................................................... 151
Introduction........................................................................................................................................................152
Applying scheduling at the bottleneck ...........................................................................................................152
Using traffic classes .......................................................................................................................................152
Introduction to Scheduling
...........................................................................................................................153
Priority ....................................................................................................................................................153
Weighted fair queuing (WFQ) ................................................................................................................153
Shaping ...................................................................................................................................................153
Burst tolerant shaping or wfq ..................................................................................................................154
Hierarchy ................................................................................................................................................154
10
SmartWare Software Configuration Guide
Table of Contents
Quick references..................................................................................................................................................155
Setting the modem rate .................................................................................................................................155
Command cross reference .............................................................................................................................156
Link scheduler configuration task list...................................................................................................................156
Defining the access control list profile ...........................................................................................................157
Packet classification .................................................................................................................................157
Creating an access control list ..................................................................................................................158
Creating a service policy profile .....................................................................................................................159
Specifying the handling of traffic-classes ........................................................................................................161
Defining fair queuing weight ...................................................................................................................161
Defining the bit-rate ...............................................................................................................................162
Defining absolute priority .......................................................................................................................162
Defining the maximum queue length ......................................................................................................162
Specifying the type-of-service (TOS) field ...............................................................................................162
Specifying the precedence field ................................................................................................................163
Specifying differentiated services codepoint (DSCP) marking .................................................................163
Specifying layer 2 marking ......................................................................................................................164
Defining random early detection .............................................................................................................165
Discarding Excess Load ...........................................................................................................................165
Quality of Service for routed RTP streams ....................................................................................................165
Devoting the service policy profile to an interface .........................................................................................167
Displaying link arbitration status ..................................................................................................................168
Displaying link scheduling profile information .............................................................................................168
Enable statistics gathering .............................................................................................................................168
14 Serial port configuration ............................................................................................................................. 170
Introduction........................................................................................................................................................171
Serial port configuration task list .........................................................................................................................171
Disabling an interface ...................................................................................................................................171
Enabling an interface ....................................................................................................................................172
Configuring the serial encapsulation type ......................................................................................................173
Configuring the hardware port protocol ........................................................................................................173
Configuring the active clock edge ..................................................................................................................174
Configuring the baudrate ..............................................................................................................................175
15 Frame Relay configuration .......................................................................................................................... 177
Introduction........................................................................................................................................................178
Frame Relay configuration task list ......................................................................................................................178
Configuring Frame Relay encapsulation ........................................................................................................178
Configuring the LMI type .............................................................................................................................179
Configuring the keep-alive interval ...............................................................................................................179
Enabling fragmentation ................................................................................................................................180
Entering Frame Relay PVC configuration mode ...........................................................................................181
Configuring the PVC encapsulation type ......................................................................................................182
Binding the Frame Relay PVC to IP interface ...............................................................................................182
11
SmartWare Software Configuration Guide
Table of Contents
Enabling a Frame Relay PVC ........................................................................................................................184
Disabling a Frame Relay PVC .......................................................................................................................184
Debugging Frame Relay ................................................................................................................................185
Displaying Frame Relay information .............................................................................................................186
Integrated service access ................................................................................................................................187
Example 1: Frame Relay on e1t1 without a channel-group ...........................................................................189
16 PRI port configuration................................................................................................................................ 191
Introduction........................................................................................................................................................192
PRI port configuration task list............................................................................................................................192
Enable/Disable PRI port ...............................................................................................................................193
Configuring PRI port-type ............................................................................................................................193
Configuring PRI clock-mode ........................................................................................................................193
Configuring PRI line-code ............................................................................................................................193
Configuring PRI framing ..............................................................................................................................194
Configuring PRI line-build-out (E1T1 in T1 mode only) .............................................................................195
Configuring PRI used-connector (E1T1 in E1 mode only) ...........................................................................195
Configuring PRI application mode (E1T1 only) ...........................................................................................195
Configuring PRI LOS threshold (E1T1 only) ...............................................................................................196
Configuring PRI Loopback detection (E1T1 only) .......................................................................................196
Configuring PRI encapsulation .....................................................................................................................197
Create a Channel-Group ...............................................................................................................................198
Configuring Channel-Group Timeslots ........................................................................................................198
Configuring Channel-Group Encapsulation .................................................................................................198
Entering HDLC Configuration Mode ..........................................................................................................199
Configuring HDLC CRC-Type ...................................................................................................................199
Configuring HDLC Encapsulation ...............................................................................................................200
PRI Debugging .............................................................................................................................................200
PRI Configuration Examples ........................................................................................................................201
Example 1: ISDN ....................................................................................................................................202
Example 2: RBS without a channel-group ...............................................................................................202
Example 3: RBS with a channel-group ....................................................................................................202
Example 4: Frame Relay without a channel-group ...................................................................................203
Example 5: Framerelay with a channel-group ..........................................................................................204
Example 6: PPP without a channel-group ...............................................................................................204
Example 7: PPP with a channel-group .....................................................................................................204
17 BRI port configuration................................................................................................................................ 205
Introduction........................................................................................................................................................206
BRI port configuration task list............................................................................................................................206
Enable/Disable BRI port ...............................................................................................................................206
Configuring BRI clock-mode ........................................................................................................................206
Configuring BRI Power-Feed ........................................................................................................................207
Configuring BRI encapsulation .....................................................................................................................207
Creating a channel group ..............................................................................................................................207
12
SmartWare Software Configuration Guide
Table of Contents
Configuring channel-group timeslots ............................................................................................................208
Configuring channel-group encapsulation .....................................................................................................208
Entering HDLC configuration mode ............................................................................................................208
Configuring HDLC encapsulation ................................................................................................................208
BRI Debugging .............................................................................................................................................209
BRI Configuration Examples ........................................................................................................................210
Example 1: ISDN with auto clock/uni-side settings ................................................................................210
Example 2: ISDN with manual clock/uni-side settings ............................................................................210
Example 3: Multi-Link PPP over two B-Channels ..................................................................................211
18 ISDN Overview ........................................................................................................................................... 212
Introduction........................................................................................................................................................213
ISDN reference points ..................................................................................................................................213
Possible SmartNode port configurations .......................................................................................................214
ISDN UNI Signaling ....................................................................................................................................214
ISDN Configuration Concept.............................................................................................................................216
ISDN Layering .............................................................................................................................................216
19 ISDN configuration .................................................................................................................................... 217
Introduction........................................................................................................................................................218
ISDN configuration task list................................................................................................................................218
Enter Q.921 configuration mode ..................................................................................................................218
Configuring Q.921 parameters .....................................................................................................................218
Configuring Q.921 encapsulation .................................................................................................................219
Enter Q.931 configuration mode ..................................................................................................................219
Configuring Q.931 parameters .....................................................................................................................220
Configuring Q.931 encapsulation .................................................................................................................222
Debugging ISDN ..........................................................................................................................................222
ISDN Configuration Examples .....................................................................................................................223
20 RBS configuration....................................................................................................................................... 225
Introduction........................................................................................................................................................226
RBS configuration task list ..................................................................................................................................226
Enter RBS configuration mode .....................................................................................................................226
Configuring RBS protocol ............................................................................................................................226
Configuring RBS encapsulation ....................................................................................................................227
Debugging RBS ............................................................................................................................................227
RBS Configuration Examples ........................................................................................................................228
21 DSL Port Configuration.............................................................................................................................. 230
Introduction........................................................................................................................................................231
Line Setup ...........................................................................................................................................................231
Configuring PPPoE.............................................................................................................................................231
Configuration Summary......................................................................................................................................232
Setting up permanent virtual circuits (PVC)........................................................................................................233
Using PVC channels in bridged Ethernet mode ............................................................................................233
13
SmartWare Software Configuration Guide
Table of Contents
Using PVC channels with PPPoE .................................................................................................................233
Diagnostics ...................................................................................................................................................234
Troubleshooting DSL Connections.....................................................................................................................234
22 Basic IP routing configuration .................................................................................................................... 235
Introduction........................................................................................................................................................236
Routing tables ...............................................................................................................................................236
Static routing ................................................................................................................................................236
Policy routing ...............................................................................................................................................236
Basic IP routing configuration task list ................................................................................................................236
Configuring static IP routes ..........................................................................................................................237
Deleting static IP routes ................................................................................................................................238
Displaying IP route information ...................................................................................................................238
Configuring policy routing ...........................................................................................................................239
Examples .............................................................................................................................................................240
Basic static IP routing example ......................................................................................................................240
Changing the default UDP port range for RTP and RTCP .................................................................................241
23 RIP configuration........................................................................................................................................ 242
Introduction........................................................................................................................................................243
Routing protocol .................................................................................................................................................243
RIP configuration task list ...................................................................................................................................244
Enabling send RIP ........................................................................................................................................244
Enabling an interface to receive RIP ..............................................................................................................245
Specifying the send RIP version ....................................................................................................................245
Specifying the receive RIP version .................................................................................................................246
Enabling RIP learning ...................................................................................................................................246
Enabling an interface to receive RIP ..............................................................................................................247
Enabling RIP announcing .............................................................................................................................247
Enabling RIP auto summarization ................................................................................................................248
Specifying the default route metric ................................................................................................................248
Enabling RIP split-horizon processing ...........................................................................................................249
Enabling the poison reverse algorithm ...........................................................................................................249
Enabling holding down aged routes ..............................................................................................................250
Setting the RIP route expiry ..........................................................................................................................250
Displaying RIP configuration of an IP interface ............................................................................................251
Displaying global RIP information ................................................................................................................251
24 Access control list configuration.................................................................................................................. 253
Introduction........................................................................................................................................................254
About access control lists ...............................................................................................................................
......254
What access lists do .......................................................................................................................................254
Why you should configure access lists ...........................................................................................................254
When to configure access lists .......................................................................................................................255
Features of access control lists .......................................................................................................................255
Access control list configuration task list..............................................................................................................256
14
SmartWare Software Configuration Guide
Table of Contents
Mapping out the goals of the access control list .............................................................................................256
Creating an access control list profile and enter configuration mode .............................................................257
Adding a filter rule to the current access control list profile ...........................................................................257
Adding an ICMP filter rule to the current access control list profile ..............................................................259
Adding a TCP, UDP or SCTP filter rule to the current access control list profile .........................................261
Binding and unbinding an access control list profile to an IP interface ..........................................................263
Displaying an access control list profile .........................................................................................................264
Debugging an access control list profile .........................................................................................................264
Examples .............................................................................................................................................................266
Denying a specific subnet ..............................................................................................................................266
25 SNMP configuration ................................................................................................................................... 267
Introduction........................................................................................................................................................268
Simple Network Management Protocol (SNMP) ................................................................................................268
SNMP basic components ..............................................................................................................................268
SNMP basic commands ................................................................................................................................268
SNMP management information base (MIB) ...............................................................................................269
Network management framework .................................................................................................................269
Identification of a SmartNode via SNMP............................................................................................................269
SNMP tools.........................................................................................................................................................270
SNMP configuration task list ..............................................................................................................................270
Setting basic system information..........................................................................................................................270
Setting access community information ................................................................................................................272
Setting allowed host information .........................................................................................................................274
Specifying the default SNMP trap target .............................................................................................................274
Displaying SNMP related information ................................................................................................................275
Using the AdventNet SNMP utilities ..................................................................................................................275
Using the MibBrowser ..................................................................................................................................276
Using the TrapViewer ...................................................................................................................................277
Standard SNMP version 1 traps...........................................................................................................................279
SNMP interface traps ..........................................................................................................................................280
26 SNTP client configuration .......................................................................................................................... 282
Introduction........................................................................................................................................................283
SNTP client configuration task list......................................................................................................................283
Selecting SNTP time servers .........................................................................................................................284
Defining SNTP client operating mode ..........................................................................................................284
Defining SNTP local UDP port ....................................................................................................................285
Enabling and disabling the SNTP client .......................................................................................................286
Defining SNTP client poll interval ...............................................................................................................286
Defining SNTP client constant offset to GMT .............................................................................................287
Defining the SNTP client anycast address .....................................................................................................287
Enabling and disabling local clock offset compensation .................................................................................288
Showing SNTP client related information ....................................................................................................289
Debugging SNTP client operation ................................................................................................................289
15
SmartWare Software Configuration Guide
Table of Contents
Recommended public SNTP time servers............................................................................................................290
NIST Internet time service ............................................................................................................................290
Additional information on NTP and a list of other NTP servers ...................................................................291
27 DHCP configuration................................................................................................................................... 292
Introduction........................................................................................................................................................293
DHCP-client configuration tasks.........................................................................................................................294
Enable DHCP-client on an IP interface ........................................................................................................294
Release or renew a DHCP lease manually (advanced) ...................................................................................296
Get debug output from DHCP-client ...........................................................................................................296
DHCP-server configuration tasks ........................................................................................................................297
Configure DHCP-server profiles ...................................................................................................................297
Use DHCP-server profiles and enable the DHCP-server ...............................................................................299
Define the bootfile (Option 67) for the DHCP-server ..................................................................................300
Define the TFTP server (Option 66) for the DHCP-server ...........................................................................300
Check DHCP-server configuration and status ...............................................................................................300
Get debug output from the DHCP-server .....................................................................................................301
Configure DHCP-relay .................................................................................................................................302
Create/Modify DHCP-Relay profile .......................................................................................................302
Enable/Disable DHCP-Relay Agent ........................................................................................................303
28 DNS configuration...................................................................................................................................... 304
Introduction........................................................................................................................................................305
DNS configuration task list .................................................................................................................................305
Enabling the DNS resolver ............................................................................................................................305
Enabling the DNS relay ................................................................................................................................306
29 DynDNS configuration............................................................................................................................... 308
Introduction........................................................................................................................................................309
DynDNS configuration task list ..........................................................................................................................309
Creating a DynDNS account ........................................................................................................................309
Configuring the DNS resolver ......................................................................................................................309
Configuring basic DynDNS settings .............................................................................................................310
Configuring the DynDNS server ..................................................................................................................310
Configuring advanced DynDNS settings (optional) ......................................................................................311
Defining a mail exchanger for your hostname .........................................................................................311
Troubleshooting ...........................................................................................................................................311
30 PPP configuration....................................................................................................................................... 313
Introduction........................................................................................................................................................314
PPP configuration task list...................................................................................................................................315
Creating an IP interface for PPP ...................................................................................................................315
Disable interface IP address auto-configuration from PPP .............................................................................317
Creating a PPP subscriber .............................................................................................................................317
Trigger forced reconnect of PPP sessions using a timer .................................................................................319
Disable interface IP address auto-configuration from PPP .............................................................................319
16
SmartWare Software Configuration Guide
Table of Contents
Configuring a PPPoE session ........................................................................................................................319
Configuring PPP over a HDLC Link ............................................................................................................321
Creating a PPP profile ...................................................................................................................................321
Configuring the local and remote PPP MRRU .............................................................................................323
Displaying PPP configuration information ...................................................................................................324
Debugging PPP ............................................................................................................................................325
Sample configurations .........................................................................................................................................329
PPP over Ethernet (PPPoE) ..........................................................................................................................329
Without authentication, encapsulation multi, with NAPT ......................................................................329
With authentication, encapsulation PPPoE .............................................................................................329
PPP over a HDLC Link (Serial Port) ............................................................................................................330
Without authentication, numbered interface ...........................................................................................330
With authentication, unnumbered interface ............................................................................................330
PPP over a HDLC Link (E1T1 Port) ............................................................................................................330
Without authentication, numbered interface ...........................................................................................330
PPP Dial-up over ISDN ......................................................................................................................................331
PPP Dialer ....................................................................................................................................................331
Create a dialer .........................................................................................................................................332
Create outbound destinations ..................................................................................................................332
Configure recovery strategy .....................................................................................................................333
Create inbound destinations ....................................................................................................................334
Debug dialer functionality .......................................................................................................................336
Example – Dial-on demand feature .........................................................................................................336
Dial-up .........................................................................................................................................................337
Dial-up on demand .................................................................................................................................337
Dial-up on monitor .................................................................................................................................338
Dial-up nailed .........................................................................................................................................338
.....................................................................................................................................................................338
31 CS context overview .................................................................................................................................... 339
Introduction........................................................................................................................................................340
CS context configuration task list ........................................................................................................................341
Planning the CS configuration ............................................................................................................................341
Configuring general CS settings...........................................................................................................................343
Configuring the clock source ...................................................................................................................343
Debugging the clock source .....................................................................................................................344
Selecting PCM law compression ..............................................................................................................345
Configuring call routing ......................................................................................................................................345
Creating and configuring CS interfaces................................................................................................................346
Specify call routing ........................................................................................................................................346
Configuring dial tones.........................................................................................................................................347
Configuring voice over IP parameters ..................................................................................................................347
Configuring ISDN ports .....................................................................................................................................348
Configuring FXS ports ........................................................................................................................................348
17
SmartWare Software Configuration Guide
Table of Contents
Configuring an H.323 VoIP connection .............................................................................................................348
Configuring a SIP VoIP connection ....................................................................................................................348
Activating CS context configuration ....................................................................................................................349
Planning the CS context ...............................................................................................................................352
Configuring general CS settings ....................................................................................................................353
Configuring call routing ................................................................................................................................353
Configuring VoIP settings ............................................................................................................................355
Configuring BRI ports ..................................................................................................................................355
Configuring an H.323 VoIP connection .......................................................................................................356
Activating the CS context configuration ........................................................................................................356
Showing the running configuration ...............................................................................................................358
32 VPN configuration ...................................................................................................................................... 362
Introduction........................................................................................................................................................363
Authentication ..............................................................................................................................................363
Encryption ....................................................................................................................................................363
Transport and tunnel modes .........................................................................................................................364
Permanent IKE Tunnels ..........................................................................................................................364
Key management ..........................................................................................................................................364
VPN configuration task list .................................................................................................................................365
Creating an IPsec transformation profile .......................................................................................................365
Creating an IPsec policy profile .....................................................................................................................365
Creating/modifying an outgoing ACL profile for IPsec .................................................................................367
Configuration of an IP interface and the IP router for IPsec ..........................................................................368
Displaying IPsec configuration information ..................................................................................................368
Debugging IPsec ...........................................................................................................................................369
Key management (IKE) .......................................................................................................................................370
Main differences between manual & IKE IPSEC configurations .............................................................370
Creating an ISAKMP transform profile ...................................................................................................371
Creating an ISAKMP IPSEC policy profile .............................................................................................372
Creating/modifying an outgoing ACL profile for IPSEC .........................................................................373
Configuration of an IP interface and the IP router for IPSEC .................................................................373
Policy matching ......................................................................................................................................373
Sample configuration snippet ..................................................................................................................373
Troubleshooting ...........................................................................................................................................374
Encrypted Voice - Performance considerations ....................................................................................................375
Performance considerations ...........................................................................................................................375
Enabling RTP encryption support.......................................................................................................................375
Using an alternate source IP address for specific destinations...............................................................................376
Sample configurations .........................................................................................................................................377
IPsec tunnel, DES encryption .......................................................................................................................377
SmartNode configuration ........................................................................................................................377
Cisco router configuration .......................................................................................................................378
IPsec tunnel, AES encryption at 256 bit key length, AH authentication with HMAC-SHA1-96 ..................378
18
SmartWare Software Configuration Guide
Table of Contents
SmartNode configuration ........................................................................................................................378
Cisco router configuration .......................................................................................................................378
IPsec tunnel, 3DES encryption at 192 bit key length, ESP authentication with HMAC-MD5-96 ................379
SmartNode configuration ........................................................................................................................379
Cisco router configuration .......................................................................................................................379
33 CS interface configuration........................................................................................................................... 381
Introduction........................................................................................................................................................382
CS interface configuration task list ......................................................................................................................382
Creating and configuring CS interfaces................................................................................................................383
Configuring call routing ......................................................................................................................................384
Configuring the interface mapping tables ............................................................................................................385
Configuring the precall service tables...................................................................................................................388
34 ISDN interface configuration...................................................................................................................... 390
Introduction........................................................................................................................................................391
ISDN interface configuration task list..................................................................................................................391
Configuring DTMF dialing (optional) ..........................................................................................................392
Configuring an alternate PSTN profile (optional) .........................................................................................392
Configuring ringback tone on ISDN user-side interfaces ..............................................................................393
Configuring call waiting (optional) ...............................................................................................................393
Disabling call-waiting on ISDN DSS1 network interfaces .............................................................................393
Configuring Call-Hold on ISDN interfaces ..................................................................................................394
Enabling Display Information Elements on ISDN Ports ...............................................................................394
Configuring date/time publishing to terminals (optional) .............................................................................394
Sending the connected party number (COLP) (optional) ..............................................................................395
Enabling sending of date and time on ISDN DSS1 network interfaces .........................................................395
Defining the ‘network-type’ in ISDN interfaces ............................................................................................395
ISDN Explicit Call Transfer support (& SIP REFER Transmission) ............................................................395
ISDN Advice of Charge support ...................................................................................................................397
ISDN DivertingLegInformation2 Facility .....................................................................................................401
Transmit Direction .................................................................................................................................401
Receive Direction ....................................................................................................................................401
T1 Caller-Name Support ..............................................................................................................................401
35 FXS interface configuration......................................................................................................................... 404
Introduction........................................................................................................................................................405
FXS interface configuration task list ....................................................................................................................405
Configuring a subscriber number (recommended) ........................................................................................405
Configuring an alternate PSTN profile (optional) .........................................................................................406
Configuring caller-ID presentation (optional) ...............................................................................................406
Configuring flash hook processing (optional) ................................................................................................406
Configuring ringing-cadence (optional) ........................................................................................................407
Configuring the Message Waiting Indication feature for FXS .......................................................................408
Configuration .........................................................................................................................................408
Frequency-shift keying ............................................................................................................................409
19
SmartWare Software Configuration Guide
Table of Contents
FXS supplementary services description...............................................................................................................410
Call hold .......................................................................................................................................................411
Call waiting ...................................................................................................................................................411
Call waiting reminder ring ............................................................................................................................412
Drop passive call ...........................................................................................................................................412
Drop active call .............................................................................................................................................412
Call toggle .....................................................................................................................................................412
Call transfer ..................................................................................................................................................412
Conferencing ................................................................................................................................................413
Call park .......................................................................................................................................................413
36 FXO interface configuration ....................................................................................................................... 414
Introduction........................................................................................................................................................415
FXO services description .....................................................................................................................................416
Creating an FXO interface...................................................................................................................................416
Deleting an FXO interface...................................................................................................................................417
FXO interface configuration task list ...................................................................................................................418
FXO off-hook on caller ID ...........................................................................................................................418
Configuring an alternate PSTN profile (optional) .........................................................................................418
Configuring when the digits are dialed (optional) .........................................................................................419
Configuring the number of rings to wait before answering the call (optional) ...............................................421
Configuring how to detect a call has disconnected (optional) ........................................................................422
Configuring how to detect an outgoing call is connected (optional) ..............................................................423
Configuring the destination of the call ..........................................................................................................424
FXO Mute dialing ........................................................................................................................................424
FXO interface examples ................................................................................................................................425
37 RBS interface configuration ........................................................................................................................ 426
Introduction........................................................................................................................................................427
RBS interface configuration task list ....................................................................................................................427
Creating/Deleting a RBS interface.......................................................................................................................427
Configuring an alternate PSTN profile .........................................................................................................427
Configuring an alternate Tone-Set profile .....................................................................................................428
Configuring B-Channel allocation strategy ...................................................................................................428
Configuring additional disconnect signals .....................................................................................................428
Configuring number of Rings before Off-Hook ............................................................................................429
Configuring ready to dial strategy .................................................................................................................429
RBS interface debugging ...............................................................................................................................429
38 H.323 interface configuration ..................................................................................................................... 431
Introduction........................................................................................................................................................432
H.323 interface configuration task list.................................................................................................................432
Binding the interface to an H.323 gateway ...................................................................................................433
Configuring an alternate VoIP profile (optional) ...........................................................................................434
Configuring CLIP/CLIR support (optional) .................................................................................................435
Enabling ‘early-proceeding’ on H.323 interfaces ...........................................................................................436
20
SmartWare Software Configuration Guide
Table of Contents
Enabling the early call connect (optional) .....................................................................................................436
Enabling the early call disconnect (optional) .................................................................................................437
Enabling the via address support (optional) ...................................................................................................437
Override the default destination call signaling port (Optional) ......................................................................437
Configuring status inquiry settings (optional) ...............................................................................................438
AOC-D Support for H.323 ..........................................................................................................................439
39 SIP interface configuration ......................................................................................................................... 441
Introduction........................................................................................................................................................442
SIP interface configuration task list......................................................................................................................442
Binding the interface to a SIP gateway ..........................................................................................................443
Configure a remote host ................................................................................................................................443
Configuring a local host (Optional) ..............................................................................................................444
Using an alternate VoIP profile (Optional) ...................................................................................................444
Using an alternate SIP profile (Optional) ......................................................................................................445
Using an alternate Tone-Set profile (Optional) .............................................................................................445
Configuring early call connect / disconnect (Optional) .................................................................................446
Configuring address translation (Optional) ...................................................................................................446
Mapping call-control properties in SIP headers .......................................................................................446
Mapping SIP headers to call-control properties .......................................................................................447
Configuring ISDN Redirecting Number Tunneling Over SIP ................................................................447
Enabling SIP RFC Privacy, Asserted-Identity, & Preferred-Identity headers (RFC 3323/3325) ..............448
Updating caller address parameters ..........................................................................................................448
SIP Diversion Header ..............................................................................................................................449
Transmit Direction ...........................................................................................................................450
Receive Direction ..............................................................................................................................450
SIP REFER Transmission (& ISDN Explicit Call Transfer support) ............................................................451
AOC Over SIP (Optional) ............................................................................................................................453
Enabling the session timer (Optional) ...........................................................................................................454
Enabling the SIP penalty-box feature (Optional) ...........................................................................................454
Initiating a new SIP session for redirected SIP calls (Optional) .....................................................................454
Configure the SIP hold method (Optional) ..................................................................................................455
40 Call router configuration............................................................................................................................. 456
Introduction........................................................................................................................................................458
Call router configuration task list.........................................................................................................................460
Map out the goals for the call router .............................................................................................................460
Enable advanced call routing on circuit interfaces .........................................................................................461
Configure general call router behavior ...........................................................................................................461
Configure address completion timeout ....................................................................................................461
Configure default digit collection timeout and terminating character ......................................................462
Configure number prefix for ISDN number types ........................................................................................463
Configure call routing tables .........................................................................................................................464
Create a routing table ..............................................................................................................................464
Called party number routing table ................................................................................................................466
21
SmartWare Software Configuration Guide
Regular Expressions .................................................................................................................................466
Digit Collection ......................................................................................................................................468
Digit Collection Variants ........................................................................................................................469
Calling party number routing table .........................................................................................................472
Number type routing table ............................................................................................................................472
Numbering plan routing table .......................................................................................................................473
Name routing table .......................................................................................................................................474
IP address routing table .................................................................................................................................474
URI routing table ..........................................................................................................................................475
Presentation Indicator Routing Table ...........................................................................................................475
Screening Indicator Routing Table ...............................................................................................................476
Information transfer capability routing table .................................................................................................477
Call-router support for redirecting number and redirect reason .....................................................................478
Time of day routing table ..............................................................................................................................479
Day of Week Routing Table .........................................................................................................................479
Date routing table .........................................................................................................................................479
Deleting routing tables ..................................................................................................................................480
Configure mapping tables .............................................................................................................................481
E.164 to E.164 Mapping Tables ...................................................................................................................485
Custom SIP URIs from called-/calling-e164 properties .................................................................................488
Other mapping tables ...................................................................................................................................488
Deleting mapping tables ...............................................................................................................................489
Creating complex functions ..........................................................................................................................490
Deleting complex functions ..........................................................................................................................491
Digit collection & sending-complete behavior ..............................................................................................492
Sending-Complete ..................................................................................................................................492
Ingress interface .......................................................................................................................................492
Call-Router .............................................................................................................................................493
Egress Interface .......................................................................................................................................495
Creating call services .....................................................................................................................................497
Creating a hunt group service ........................................................................................................................497
Creating a distribution group service .............................................................................................................506
Distribution-Group Min-Concurrent setting ................................................................................................508
Call-router ‘limiter’ service ............................................................................................................................508
Priority service ..............................................................................................................................................509
CS Bridge service—‘VoIP Leased Line’ .........................................................................................................511
Configuring the service second-dialtone ........................................................................................................513
Deleting call services .....................................................................................................................................514
Activate the call router configuration ............................................................................................................514
Test the call router configuration ..................................................................................................................515
Configure partial rerouting ...........................................................................................................................521
Call reroute .............................................................................................................................................522
Enable acceptation of rerouting requests on ISDN. ...........................................................................522
Enable emission of rerouting requests on ISDN. ...............................................................................522
Table of Contents
22
SmartWare Software Configuration Guide
Table of Contents
Enable sending of “302 moved temporary” message on SIP. .............................................................522
Allow Push-Back .....................................................................................................................................522
Enable push-back – aaa service ..........................................................................................................522
Enable push-back – bridge service .....................................................................................................523
Enable push-back – distribution-group service ..................................................................................523
Enable push-back – hunt group service .............................................................................................523
Enable push-back – limiter service ....................................................................................................523
Enable push-back – priority service ...................................................................................................523
41 SIP call-router services ................................................................................................................................ 524
Introduction........................................................................................................................................................525
SIP conference-service .........................................................................................................................................525
SIP conference-service configuration task list ................................................................................................525
Entering conference-service configuration mode .....................................................................................525
Configuring the call routing destination ..................................................................................................525
Configuring the conference server ...........................................................................................................526
SIP location-service..............................................................................................................................................526
SIP location-service configuration task list ....................................................................................................527
Entering SIP location-service configuration mode ...................................................................................527
Binding a location service ........................................................................................................................528
Configuring multi-contact behavior ........................................................................................................528
Configuring the hunt timeout .................................................................................................................528
42 Tone configuration...................................................................................................................................... 529
Introduction........................................................................................................................................................530
Tone-set profiles..................................................................................................................................................530
Tone configuration task list .................................................................................................................................531
Configuring call-progress-tone profiles ..........................................................................................................531
Configure tone-set profiles ............................................................................................................................532
Enable tone-set profile ..................................................................................................................................533
Show call-progress-tone and tone-set profiles ................................................................................................534
43 FXS port configuration ............................................................................................................................... 537
Introduction........................................................................................................................................................538
Shutdown and enable FXS ports..........................................................................................................................538
Bind FXS ports to higher layer applications .........................................................................................................539
Configure country-specific FXS port parameters..................................................................................................539
Other FXS port parameters..................................................................................................................................540
Example ..............................................................................................................................................................541
44 FXO port configuration .............................................................................................................................. 542
Introduction........................................................................................................................................................543
Shutdown and enable FXO ports.........................................................................................................................543
Bind FXO ports to higher layer applications........................................................................................................543
Configure country specific FXO port parameters.................................................................................................544
Other FXO port parameters ................................................................................................................................544
SmartWare Software Configuration Guide Table of Contents
45 H.323 gateway configuration ...................................................................................................................... 546
Introduction........................................................................................................................................................547
Gateway configuration task list............................................................................................................................548
Binding the gateway to an IP interface ..........................................................................................................548
Enable the gateway ........................................................................................................................................548
Configure registration authentication service (RAS) (Optional) ....................................................................549
Configure H.235 Security (optional) ............................................................................................................550
H.235 configuration .....................................................................................................................................551
Advanced configuration options (optional) ...................................................................................................554
Enabling H.245 Tunneling .....................................................................................................................554
Enabling the fastconnect procedure .........................................................................................................555
Enabling the early H.245 procedure ........................................................................................................555
Changing the TCP port for inbound call-signaling connections ..............................................................556
Configuring the traffic class for H.323 signaling .....................................................................................556
Setting the response timeout ...................................................................................................................556
Setting the connect timeout ....................................................................................................................557
Configuring the terminal type for registration with the gatekeeper ..........................................................557
Troubleshooting ...........................................................................................................................................558
23
46 Context SIP gateway overview..................................................................................................................... 559
Introduction........................................................................................................................................................560
Context SIP Gateway configuration task list........................................................................................................561
Creating a context SIP gateway .....................................................................................................................561
Creating a transport interface ........................................................................................................................562
Configuring the IP binding ...........................................................................................................................562
Configuring a priority ...................................................................................................................................562
Configuring a spoofed contact address ..........................................................................................................563
Binding location services ...............................................................................................................................563
Enabling/disabling the context SIP gateway ..................................................................................................563
Troubleshooting..................................................................................................................................................564
Show status information ...............................................................................................................................564
Debug commands .........................................................................................................................................564
Configuration Examples ......................................................................................................................................565
Example 1 .....................................................................................................................................................565
Example 2 .....................................................................................................................................................565
Example 3 .....................................................................................................................................................565
Applications.........................................................................................................................................................566
Outbound Authentication ............................................................................................................................566
Inbound Authentication ...............................................................................................................................567
Outbound Registration .................................................................................................................................568
Inbound Registration ....................................................................................................................................570
B2B User Agent with Registered Clients .......................................................................................................571
47 VoIP profile configuration .......................................................................................................................... 573
Introduction........................................................................................................................................................574
SmartWare Software Configuration Guide Table of Contents
VoIP profile configuration task list ......................................................................................................................575
Creating a VoIP profile .................................................................................................................................575
Configure codecs ..........................................................................................................................................576
Configuring the transparent-clearmode codec ...............................................................................................578
Configuring the Cisco versions of the G.726 codecs .....................................................................................578
Configuring DTMF relay .............................................................................................................................579
Configuring RTP payload types ....................................................................................................................579
Configuring RTP payload type for transparent-clearmode ............................................................................580
Configuring RTP payload types for the g726-32k and g726-32k-cisco coders ..............................................580
Configuring RTP payload type for Cisco NSE ..............................................................................................580
Configuring Cisco NSE for Fax ....................................................................................................................580
Configuring the dejitter buffer (advanced) ....................................................................................................581
Enabling/disabling filters (advanced) .............................................................................................................583
Configuring Fax transmission .......................................................................................................................584
T.38 CED retransmission .............................................................................................................................587
T.38 No-Signal Retransmission ....................................................................................................................588
Fax bypass method ........................................................................................................................................588
Configuring fax failover ................................................................................................................................588
Configuring modem transmission .................................................................................................................589
Modem bypass method .................................................................................................................................589
Configuring the traffic class for Voice and Fax data ......................................................................................590
Configuring IP-IP codec negotiation .............................................................................................................590
Examples .............................................................................................................................................................591
Home office in an enterprise network ...........................................................................................................591
Home office with fax ....................................................................................................................................593
Soft phone client gateway ..............................................................................................................................594
48 PSTN profile configuration......................................................................................................................... 597
Introduction........................................................................................................................................................598
PSTN profile configuration task list ....................................................................................................................598
Creating a PSTN profile ...............................................................................................................................598
Configuring the echo canceller ......................................................................................................................599
Configuring output gain ...............................................................................................................................599
49 SIP profile configuration............................................................................................................................. 601
Introduction........................................................................................................................................................602
SIP profile configuration task list.........................................................................................................................602
Entering the configuration mode for a SIP profile .........................................................................................602
Mapping from a SIP disconnect cause ...........................................................................................................602
Mapping to a SIP cause .................................................................................................................................603
Mapping from a SIP redirection reason .........................................................................................................603
Mapping to a SIP redirection code ................................................................................................................603
50 Authentication Service................................................................................................................................. 604
Introduction........................................................................................................................................................605
Authentication Service configuration task list ......................................................................................................605
24
SmartWare Software Configuration Guide Table of Contents
Creating an Authentication Service ...............................................................................................................605
Configuring a Realm .....................................................................................................................................606
Configuring the authentication protocol .......................................................................................................606
Creating credentials ......................................................................................................................................606
Configuration Examples ......................................................................................................................................606
51 Location Service .......................................................................................................................................... 607
Introduction........................................................................................................................................................608
Location Service configuration task list................................................................................................................608
Creating a Location Service ...........................................................................................................................608
Adding a domain ..........................................................................................................................................608
Creating an identity ......................................................................................................................................609
Authentication outbound face .................................................................................................................610
Authentication inbound face ...................................................................................................................611
Registration outbound face ......................................................................................................................613
Registration inbound face ........................................................................................................................615
Call outbound face ..................................................................................................................................616
Call inbound face ....................................................................................................................................617
Creating an identity group ............................................................................................................................618
Inheriting from an identity group to an identity ...........................................................................................618
Configuring the Message Waiting Indication feature for SIP ........................................................................619
Subscription ............................................................................................................................................619
Notification .............................................................................................................................................620
Configuration .........................................................................................................................................620
Message Waiting Indication through Call-Control .......................................................................................622
Configuration Examples ......................................................................................................................................623
52 VoIP debugging........................................................................................................................................... 624
Introduction........................................................................................................................................................625
Debugging strategy..............................................................................................................................................625
Filtering debug monitor output...........................................................................................................................626
Verifying IP connectivity.....................................................................................................................................626
Debugging call signaling......................................................................................................................................627
Debugging ISDN signaling ...........................................................................................................................627
Verify an incoming call ...........................................................................................................................628
Verify an outgoing call ............................................................................................................................629
Verify ISDN layer 2 and 3 status .............................................................................................................631
Debugging FXS Signaling .............................................................................................................................632
Verify an incoming call ...........................................................................................................................632
Verify an outgoing call ............................................................................................................................633
Debugging H.323 Signaling .........................................................................................................................634
Verify an incoming call ...........................................................................................................................634
Verify an outgoing call ............................................................................................................................636
Debugging SIP signaling ...............................................................................................................................638
Verify an incoming call ...........................................................................................................................638
25
SmartWare Software Configuration Guide Table of Contents
Verify an outgoing call ............................................................................................................................638
Using SmartWare’s internal call generator .....................................................................................................639
Debugging voice data ..........................................................................................................................................640
Check system logs .........................................................................................................................................642
How to submit trouble reports to Patton ......................................................................................................642
A Terms and definitions ................................................................................................................................ 644
Introduction........................................................................................................................................................645
SmartWare architecture terms and definitions .....................................................................................................645
B Mode summary ........................................................................................................................................... 650
Introduction........................................................................................................................................................651
C Command summary ................................................................................................................................... 654
Introduction........................................................................................................................................................655
New Configuration Commands ..........................................................................................................................656
Other...................................................................................................................................................................656
Show help .....................................................................................................................................................656
Show command history ................................................................................................................................656
Restart system ...............................................................................................................................................656
D Internetworking terms & acronyms ........................................................................................................... 657
Abbreviations.......................................................................................................................................................658
E Used IP ports & available voice codecs ...................................................................................................... 662
Used IP ports ......................................................................................................................................................663
Available voice codecs .........................................................................................................................................664
26
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 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 68
9 Boot procedure . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 74
10 Sample configuration file . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 79
11 Local memory regions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 80
12 Remote memory regions for SmartWare . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 82
13 System banner with message to operators . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 94
14 Authentication procedure with a RADIUS server . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 104
15 How to use AAA methods and AAA profiles . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 104
16 IP context and related elements . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 115
17 Dynamic NAPT . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 134
18 Static NAPT . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 134
19 Dynamic NAT . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 135
20 Static NAT . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 135
21 Binding of an Ethernet port to an IP interface . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 144
22 Packet routing in SmartWare . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 153
23 Example of Hierarchical Scheduling . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 155
24 Elements of link scheduler configuration . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 157
25 Scenario with Web server regarded as a single source host . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 158
26 Structure of a Service-Policy Profile . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 160
27 Using a Service Policy Profile on an IP Interface . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 167
28 IP interface wan is bound to PVC 1 on port serial 0 0 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 183
29 Typical Integrated Service Access Scenario with dedicated PVCs . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 187
30 IP Context with logical IP interfaces bound to Ethernet port, serial port PVC 1 and PVC 2 . . . . . . . . . . . . . 188
31 ISDN reference points . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 213
32 ISDN signaling side . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 214
33 Integration of ISDN access lines . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 215
34 ISDN layering model . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 216
35 PBX connected to ISDN port 1/0 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 224
36 Configuring the G.SHDSL card for PPPoE . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 231
37 Internetwork with three routers and four networks . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 240
38 Using traffic filters to prevent traffic from being routed to a network . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 255
39 Deny a specific subnet on an interface . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 266
40 AdventNet MibBrowser displaying some of the System Group objects . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 272
41 AdventNet MibBrowser Settings Button on the Toolbar . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 276
42 AdventNet TrapViewer displaying received traps . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 277
43 AdventNet Trap Details window of TrapViewer . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 278
44 DHCP-client and DHCP-server . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 294
45 DNS relay diagram . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 306
46 PPP configuration overview . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 314
47 CS context configuration components . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 340
27
SmartWare Software Configuration Guide
48 Remote office in an Enterprise network . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 342
49 Direct call routing from one SmartNode to another . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 346
50 SmartNode in an Enterprise network . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 351
51 CS Configuration . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 352
52 CS interfaces on the CS context . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 382
53 Incoming call passing an interface mapping table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 387
54 Call passing an input and an output mapping table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 388
55 ISDN interfaces on the CS context . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 391
56 Example SIP network connecting two device to give a home office access to the CO PBX . . . . . . . . . . . . . . . 396
57 FXS interfaces on the CS context . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 405
58 FXO interfaces on the CS context . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 415
59 H.323 interfaces on the CS context . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 432
60 SIP interfaces on the CS context . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 442
61 Example SIP network connecting two devices to give a home office access to the CO PBX . . . . . . . . . . . . . . 452
62 Direct call routing vs. advanced call routing . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 459
63 Routing table outline . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 464
64 Mapping table outline . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 481
65 Mapping table examples . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 484
66 Hunt group service . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 498
67 Distribution group service . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 506
68 Distribution group service examples . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 507
69 ‘Limiter’ service diagram . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 509
70 Priority service diagram . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 510
71 CS Bridge service—‘VoIP Leased Line’ diagram . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 511
72 Bridge services diagram . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 512
73 Call routing example network . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 517
74 CS context and call router elements . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 519
75 Registration and Lookup . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 527
76 Assign tone-sets to a PSTN interfaces . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 531
77 Gateway between IP and CS contexts . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 547
78 Routing Architecture . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 560
79 VoIP profile association . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 574
80 DTMF Relay . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 579
81 Jitter and dejitter buffer . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 581
82 Adaptive versus static dejitter buffer . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 582
83 Multiple tandem and sequential post filtering . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 583
84 Fax relay and Fax bypass . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 585
85 Home office in an enterprise network . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 591
86 PSTN profile association . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 598
87 Echo Cancellation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 599
88 Applying output gain . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 599
89 Mode overview, 1 of 3 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 651
90 Mode Overview, 2 of 3 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 652
91 Mode Overview, 3 of 3 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 653
92 EBNF syntax . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 655
28
List of Tables
1 General conventions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 34
2 Mouse conventions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 36
3 Command edit shortcuts . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 52
4 Command cross reference . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 156
5 TOS values and their meaning . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 163
6 Traffic control info (TCI) field . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 164
7 Values defining detail of the queuing statistics . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 169
8 PVC Commands . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 233
9 PVC channels in bridged Ethernet mode . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 233
10 PVC channels in PPPoE mode . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 233
11 Diagnostics commans . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 234
12 Details available in the Trap Details window . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 278
13 Time servers operated by NIST . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 290
14 FXS services with permanent patterns . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 410
15 FXS services with configurable patterns . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 410
16 ISDN number types . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 463
17 Routing table types . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 464
18 Wildcard symbols used as keys in E.164 tables (calling-e164, called-e164) . . . . . . . . . . . . . . . . . . . . . . . . . . . 467
19 Wildcard symbols used as keys in E.164 tables (calling-e164, called-e164) . . . . . . . . . . . . . . . . . . . . . . . . . . . 468
20 Mapping table types . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 482
21 Hunt group drop causes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 500
29
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 644 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 114
• Chapter 31, "CS context overview" on page 339
30
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 65 describes how to load and maintain system images and
driver software.
• Chapter 6, "Configuration file handling" on page 76 describes how to upload and download configuration
files from and to a SmartNode.
• Chapter 7, "Basic system management" on page 90 describes parameters that report basic system informa-
tion to the operator or administrator, and their configuration.
• Chapter 8, "RADIUS Client Configuration" on page 102 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 114 outlines SmartWare Internet protocol (IP) context, together
with its related components.
• Chapter 10, "IP interface configuration" on page 120 provides a general overview of SmartNode interfaces
and describes the tasks involved in their configuration.
• Chapter 11, "NAT/NAPT configuration" on page 132 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 141 provides an overview of Ethernet ports and
describes the tasks involved in their configuration through SmartWare.
• Chapter 13, "Link scheduler configuration" on page 151 describes how to use and configure SmartWare
quality of service (QoS) features.
• Chapter 14, "Serial port configuration" on page 170 provides an overview of the serial port and describes
the tasks involved in its configuration through SmartWare.
• Chapter 15, "Frame Relay configuration" on page 177 provides an overview of how to configure frame relay
through SmartWare.
• Chapter 16, "PRI port configuration" on page 191 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 205 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 212 provides an overview of ISDN ports and describes the tasks
involved in configuring ISDN ports in SmartWare.
31
SmartWare Software Configuration Guide About this guide
• Chapter 19, "ISDN configuration" on page 217 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 225 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 426 provides an overview of RBS interfaces, and the
tasks involved in their configuration.
• Chapter 21, "DSL Port Configuration" on page 230 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 235 provides an overview of IP routing and describes
the tasks involved in configuring static IP routing in SmartWare.
• Chapter 23, "RIP configuration" on page 242 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 253 provides an overview of IP access control lists
and describes the tasks involved in their configuration through SmartWare.
• Chapter 25, "SNMP configuration" on page 267 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 282 describes how to configure a simple network time pro-
tocol (SNTP) client.
• Chapter 27, "DHCP configuration" on page 292 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 304 describes how to configure the domain name system
(DNS) component.
• Chapter 29, "DynDNS configuration" on page 308 describes configuring the dynamic DNS
(DynDNS) service.
• Chapter 30, "PPP configuration" on page 313 describes how to configure the point-to-point protocol over
different link layers.
• Chapter 31, "CS context overview" on page 339 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 362 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 381 gives an overview of interfaces in the CS context and
describes the tasks involved its configuration.
• Chapter 34, "ISDN interface configuration" on page 390 provides an overview of ISDN interfaces, and the
tasks involved in their configuration.
• Chapter 35, "FXS interface configuration" on page 404 provides an overview of FXS interfaces, and the
tasks involved their configuration.
32
SmartWare Software Configuration Guide About this guide
• Chapter 36, "FXO interface configuration" on page 414 provides an overview of FXO interfaces and the
tasks involved in configuring them.
• Chapter 38, "H.323 interface configuration" on page 431 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 441 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 456 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 524 provides an overview of specific SIP call router services
in SmartWare.
• Chapter 42, "Tone configuration" on page 529 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 537 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 542 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 546 provides an overview of the H.323 gateway and
describes the tasks involved in its configuration.
• Chapter 46, "Context SIP gateway overview" on page 559 provides an overview of the SIP gateway and
describes the tasks involved in its configuration.
• Chapter 47, "VoIP profile configuration" on page 573 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 597 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 601 gives an overview of mappings between SIP codes and
Q.931 causes.
• Chapter 50, "Authentication Service" on page 604 explains how to create and manage authentication ser-
vices in SmartWare.
• Chapter 51, "Location Service" on page 607 explains how to configure location services in SmartWare.
• Chapter 52, "VoIP debugging" on page 624 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 644 contains the terms and their definitions that are used
throughout this SmartWare Software Configuration Guide.
• Appendix B, "Mode summary" on page 650 illustrates the modes hierarchy.
• Appendix C, "Command summary" on page 654 is a command reference.
• Appendix D, "Internetworking terms & acronyms" on page 657 contains terms and definitions relating to
internetworking.
33
SmartWare Software Configuration Guide About this guide
• Appendix E, "Used IP ports & available voice codecs" on page 662 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
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
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
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
Chapter 1 System overview
Chapter contents
Introduction..........................................................................................................................................................39
SmartWare embedded software .............................................................................................................................40
Applications...........................................................................................................................................................41
Carrier networks .............................................................................................................................................41
Enterprise networks ........................................................................................................................................42
LAN telephony ...............................................................................................................................................43
38
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
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 65 for details on SmartWare image downloads.
SmartWare embedded software 40
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
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
SmartWare Software Configuration Guide 1 • System overview
PSTN
IPPBX
LAN
IP Phones
Figure 4. Typical LAN telephony system with a SmartNode gateway
Node
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
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
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
CS
switch
Telephone port
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
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
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
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
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
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 650 contains a detailed overview of all command modes, and
appendix C, “Command summary” on page 654 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 650.
Introduction 50
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
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
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
Opening a secure configuration session over SSH ...........................................................................................59
Displaying the CLI version .............................................................................................................................60
Displaying account information ......................................................................................................................60
Switching to another account ..........................................................................................................................61
Checking identity and connected users ...........................................................................................................61
Command index numbers ...............................................................................................................................62
Ending a Telnet or console port session ..........................................................................................................64
Showing command default values ...................................................................................................................64
53
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 60)
• Displaying account information (see page 60)
• Switching to another log-in account (see page 61)
• Checking identity and connected users (see page 61)
Introduction 54
SmartWare Software Configuration Guide 4 • Accessing the CLI
• Ending a Telnet or console port session (see page 64)
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
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
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
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
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
Opening a secure configuration session over SSH
A partial implementation of secure shell according RFC 4251, RFC 4252, RFC 4253 and RFC 4254 is provided. It is possible to open a secure configuration session over SSH to a SmartNode.
Note The Web-GUI and the copy tftp function are still unsecure!
The SSH Transport Layer supports the following Algorithms: “ssh-rsa” public key for signing, “diffie-hellmann-group1-sha1” and “diffie-hellmann-group14-sha1” for key exchange, “3des-cbc”, “aes256-cbc”, “aes192cbc” and “aes128-cbc” for encryption, “hmac-sha1” and “hmac-md5” for data integrity. For user authentication, only the method “password” is supported. On the Connection Layer, only the request for an interactive
command shell is supported.
After the first startup of SmartWare, the RSA server host key is going to be calculated. This calculation is done
in the background and with low priority, so that the SmartNode can operate normally. Until the RSA server
host key is calculated, which takes several minutes, it is not possible to open SSH sessions. The RSA server host
key is calculated only once and always remains the same.
Accessing the SmartWare CLI task list 59
SmartWare Software Configuration Guide 4 • Accessing the CLI
Mode: Configure
Step Command Purpose
1 [name](cfg)#terminal ssh use authentication <AAA
profile name>
Set the AAA profile which is going to be
used for user authentication. The AAA
profile “default” is uses as when not
specified otherwise.
Mode: Enable
Step Command Purpose
1 [name]#show ssh Displays status information of the SSH
server.
Mode: Enable
Step Command Purpose
1 [name]#debug ssh Prints debug information of the SSH
server.
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:
Mode: Administrator execution
Step Command Purpose
1 node#show accounts Displays the currently-configured administrator and operator
accounts
Accessing the SmartWare CLI task list 60
SmartWare Software Configuration Guide 4 • Accessing the CLI
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.
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
Accessing the SmartWare CLI task list 61
SmartWare Software Configuration Guide 4 • Accessing the CLI
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
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:
Accessing the SmartWare CLI task list 62
SmartWare Software Configuration Guide 4 • Accessing the CLI
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 silence-supression
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 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 64
Chapter 5 System image handling
Chapter contents
Introduction..........................................................................................................................................................66
Memory regions in SmartWare..............................................................................................................................67
System image handling task list .............................................................................................................................68
Displaying system image information ..............................................................................................................69
Copying system images from a network server to Flash memory .....................................................................69
Upgrading the software directly ......................................................................................................................71
Auto provisioning of firmware and configuration ..................................................................................................72
Boot procedure......................................................................................................................................................74
Factory configuration ............................................................................................................................................75
Default Startup Configuration ........................................................................................................................75
IP Addresses in the Factory Configuration ......................................................................................................75
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 68)
• Boot procedure and bootloader (see page 74)
Note Section “System image handling task list” on page 68 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 75.
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 75)
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 644
to ensure that you understand the concepts.
Introduction 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 68, 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 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 69)
• Copying the driver software from a network server to the Flash memory (see page 71)
System image handling task list 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 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 70
node(gw-h323)[h323]#shutdown
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 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 72
Chooses the unit’s startup-configuration as
destination of the downloaded file.
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 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 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 75
Chapter 6 Configuration file handling
Chapter contents
Introduction..........................................................................................................................................................77
Understanding configuration files ...................................................................................................................77
Factory configuration ............................................................................................................................................79
Configuration file handling task list.......................................................................................................................79
Copying configurations within the local memory ............................................................................................80
Replacing the startup configuration with a configuration from Flash memory ................................................81
Copying configurations to and from a remote storage location ........................................................................82
Replacing the startup configuration with a configuration downloaded from TFTP server ...............................83
Displaying configuration file information .......................................................................................................83
Modifying the running configuration at the CLI .............................................................................................84
Modifying the running configuration offline ...................................................................................................85
Deleting a specified configuration ...................................................................................................................86
Encrypted file download .................................................................................................................................87
Encrypted Configuration Download .........................................................................................................87
Use Cases ..................................................................................................................................................88
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 65 for more information.
This chapter includes the following sections:
• Factory configuration (see page 79)
• Configuration file handling task list (see page 79)
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 644 to ensure that you understand the concepts. Refer to chapter 5, “System image
handling” on page 65 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 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 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 644 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 84 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 79
SmartWare Software Configuration Guide 6 • Configuration file handling
• Copying configurations within the local memory (see page 80)
• Replacing the startup configuration with a configuration from the Flash memory (see page 81)
• Copying configurations to and from a remote storing location (see page 82)
• Replacing the startup configuration with a configuration downloaded from the TFTP server (see page 83)
• Displaying configuration file information (see page 83)
• Modifying the running configuration at the CLI (see page 84)
• Modifying the running configuration offline (see page 85)
• Deleting a specified configuration (see page 86)
• Downloading encrypted files (see page 87)
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
Figure 11. Local memory regions
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 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-
figuration with the startup configuration
backup already present in flash memory.
Note The configuration backup can be a previously backed up configuration or
previously downloaded from a TFTP server.
Configuration file handling task list 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 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 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 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 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 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 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 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 89
Chapter 7 Basic system management
Chapter contents
Introduction..........................................................................................................................................................91
Basic system management configuration task list ...................................................................................................91
Managing feature license keys .........................................................................................................................92
Setting system information .............................................................................................................................93
Setting the system banner ................................................................................................................................94
Setting time and date ......................................................................................................................................95
Display clock information ...............................................................................................................................95
Display time since last restart ..........................................................................................................................96
Configuring the Web server ............................................................................................................................96
Determining and defining the active CLI version ............................................................................................96
Restarting the system ......................................................................................................................................97
Displaying the system logs ..............................................................................................................................97
Displaying reports ...........................................................................................................................................98
Controlling command execution .....................................................................................................................98
Timed execution of CLI command ...............................................................................................................100
Displaying the checksum of a configuration ..................................................................................................100
Configuration of terminal sessions ................................................................................................................100
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 92)
• Setting system information (see page 93)
• Setting the system banner (see page 94)
• Setting time and date (see page 95)
• Displaying clock information (see page 95)
• Displaying time since last restart (see page 96)
• Configuring and starting the web server (see page 96)
• Determining and defining the active CLI version (see page 96)
• Restarting the system (see page 97)
• Displaying the system event log (see page 97)
• Controlling command execution (see page 98)
• Setting timed execution of CLI commands (see page 100)
• Displaying the checksum of a configuration (see page 100)
• Configuration of terminal sessions (see page 100)
• Identifying a unit by flashing all LED’s (see page 100)
Introduction 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 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 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 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 282 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 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-
sion
Basic system management configuration task list 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 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 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 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 100
Loading...