Sie sind auf Seite 1von 184

DRGOS 1.5.

1-R Command Reference

DRGOS 1.5.1-R Command Reference


Document information
PF-DOC-DRGOS-1.5.1-R-CMD. Published 2011-10-27. Source ID: 337239baf39343e40b48fa090b3012c741244ec7

Copyright and Legal notice


Copyright 2011 PacketFront International AB. All rights reserved. DRGOS, BECS, SMT, HMT, iBOS, the ASR Bootloader, program models and other software content and this documentation ("the Intellectual Property Rights") are protected by the Swedish Copyright Act (Sw: Upphovsrttslagen) and, if applicable, the Swedish Patents Act (Sw: Patentlagen). All and any copying and distribution of the Intellectual Property Rights, without authorization by PacketFront International AB is prohibited. The prohibition includes every form of reproduction and distribution. Every effort was made to ensure that the information in this document was complete and accurate at the time of printing. However, information is subject to change without notice. PacketFront assumes no liability for damages incurred directly or indirectly from errors, omissions or discrepancies between the software and this document. DRGOS, BECS, SMT, HMT, iBOS, IPD, HDD, DRG and ASR are trademarks of PacketFront. All other trademarks, service marks and trade names are proprietary to their respective owner. Purchasers, licensees and users accept and acknowledge that the products contain components (including components carrying certain firmware) and combinations of components that constitute trade secrets protected by PacketFront or its partners. Purchasers, licensees and users warrant that the delivered products will not be opened or dismantled, copied, altered or in any other way modified. Furthermore, purchasers, licensees and users agree not to attempt to reverse engineer, disassemble, modify, translate, create derivate works, rent, lease, loan, or without written permission distribute or sublicense the software, in whole or in part. The products and its hardware, firmware and software, including technical data, may be subject to EU and U.S export control laws, including the U.S Export Administration Act and its associated regulations and the International Traffic in Arms Regulations administerd by the US Department of State, and may be subject to export or import regulations in other countries. Purchasers and licensees agree to comply strictly with all such regulations and acknowledges that it has the responsibility to obtain licenses to export, re-export, or import hardware, firmare and software. Purchasers and licensees are not entitled to, and PacketFront is not in any event liable to pay, compensation for damages which delivered products or software has caused to other property or to persons or any other consequential damages, including but not limited to loss of profit, loss of production or any other indirect damages.

Table of Contents
1. Introduction .............................................................................................................. 1 Conventions used in this manual ............................................................................. 1 2. Commands ............................................................................................................... 3 access-list ............................................................................................................ 4 access-list clear-counters ........................................................................................ 6 boot system ......................................................................................................... 7 catv enable .......................................................................................................... 8 catv filter ............................................................................................................. 9 clear mac-address-table ........................................................................................ 10 clip enable ......................................................................................................... 11 codec ................................................................................................................ 12 codec preference ................................................................................................. 14 community ......................................................................................................... 15 configure terminal ............................................................................................... 16 copy .................................................................................................................. 17 country .............................................................................................................. 19 cwmp acs server ................................................................................................. 20 cwmp acs username ............................................................................................. 21 cwmp client username .......................................................................................... 22 cwmp enable ...................................................................................................... 23 cwmp interval ..................................................................................................... 24 cwmp source-interface .......................................................................................... 25 debug voip ......................................................................................................... 26 delete ................................................................................................................ 27 dhcp option ........................................................................................................ 28 dhcp server class ................................................................................................. 30 dhcp server client ................................................................................................ 31 dhcp server disable .............................................................................................. 32 dhcp server inherit option ..................................................................................... 33 dhcp server inherit source-interface ........................................................................ 35 dhcp server lease ................................................................................................. 36 dhcp server next-server ........................................................................................ 37 dhcp server option ............................................................................................... 38 dhcp server pool ................................................................................................. 40 dial plan ............................................................................................................ 41 dial quick-dial ..................................................................................................... 42 dial timeout ........................................................................................................ 43 do ..................................................................................................................... 44 domain .............................................................................................................. 45 dtmf relay .......................................................................................................... 46 dtmf rfc2833-payload ........................................................................................... 47 end ................................................................................................................... 48 exit ................................................................................................................... 49 hostname ........................................................................................................... 50 impedance .......................................................................................................... 51 interface ............................................................................................................. 52 ip access-group ................................................................................................... 53 ip address .......................................................................................................... 54 ip domain-name .................................................................................................. 56 ip icmp-echo ...................................................................................................... 57 ip igmp aggregation ............................................................................................. 58 ip igmp immediate-leave ...................................................................................... 59 ip igmp proxy ..................................................................................................... 60 ip igmp robustness .............................................................................................. 61 ip igmp snooping ................................................................................................ 62

iii

ip name-server .................................................................................................... 63 ip nat external-interface ........................................................................................ 64 ip nat forward ..................................................................................................... 65 ip route ............................................................................................................. 67 ip upnp .............................................................................................................. 68 ip upnp lan-interface ............................................................................................ 69 ip upnp source-interface ....................................................................................... 70 jitter-buffer ......................................................................................................... 71 logging server ..................................................................................................... 72 ls ...................................................................................................................... 73 management source-interface ................................................................................. 74 media ................................................................................................................ 75 next-server ......................................................................................................... 76 notify ................................................................................................................ 77 ping .................................................................................................................. 78 pppoe acname ..................................................................................................... 79 pppoe service ..................................................................................................... 80 pppoe username .................................................................................................. 81 quit ................................................................................................................... 82 reload ................................................................................................................ 83 ring-signal cadence .............................................................................................. 84 ring-signal frequency ........................................................................................... 86 ring-signal voltage ............................................................................................... 87 rtp port-range ..................................................................................................... 88 rxgain ................................................................................................................ 89 service ............................................................................................................... 90 show access-list .................................................................................................. 91 show arp ............................................................................................................ 92 show boot .......................................................................................................... 93 show catv .......................................................................................................... 94 show clock ......................................................................................................... 95 show controllers switch interface ........................................................................... 96 show cwmp status ............................................................................................... 98 show dhcp server clients ....................................................................................... 99 show dhcp server lease ....................................................................................... 100 show history ..................................................................................................... 101 show interface ................................................................................................... 102 show ip igmp forwarding .................................................................................... 103 show ip igmp snooping ....................................................................................... 104 show ip igmp snooping aggregation ...................................................................... 105 show ip igmp statistics ....................................................................................... 106 show ip name-server .......................................................................................... 107 show ip route .................................................................................................... 108 show logging .................................................................................................... 109 show mac-address-table ...................................................................................... 111 show memory ................................................................................................... 112 show processes .................................................................................................. 113 show running-config .......................................................................................... 115 show sockets ..................................................................................................... 116 show startup-config ............................................................................................ 117 show system load .............................................................................................. 118 show tech-support .............................................................................................. 120 show version ..................................................................................................... 121 show vlan ......................................................................................................... 122 show voip statistics ............................................................................................ 123 show voip status ................................................................................................ 125 show wlan ........................................................................................................ 126 shutdown .......................................................................................................... 128

iv

sip display-name ................................................................................................ sip domain ....................................................................................................... sip outbound-proxy ............................................................................................ sip parse strict ................................................................................................... sip phone-number .............................................................................................. sip proxy .......................................................................................................... sip register-expiry .............................................................................................. sip timer suspend-resume .................................................................................... sip username ..................................................................................................... snmp agent source-interface ................................................................................. snmp-group version ............................................................................................ snmp mib system ............................................................................................... snmp notification agent-authentication ................................................................... test logging ....................................................................................................... test voip {ring | tone} ......................................................................................... test voip get-hook-state ....................................................................................... timezone .......................................................................................................... tone ................................................................................................................. txgain .............................................................................................................. username .......................................................................................................... vlan member ..................................................................................................... vlan untagged ................................................................................................... voice ............................................................................................................... voip class5 internal ............................................................................................ voip media dscp ................................................................................................ voip media priority ............................................................................................ voip media source-interface ................................................................................. voip relay hookflash ........................................................................................... voip signaling dscp ............................................................................................ voip signaling priority ........................................................................................ voip signaling source-interface ............................................................................. voip timer clear ................................................................................................. voip timer hookflash .......................................................................................... wlan access-control ............................................................................................ wlan access-policy ............................................................................................. wlan bandwidth ................................................................................................. wlan channel ..................................................................................................... wlan country ..................................................................................................... wlan mode ....................................................................................................... wlan security authentication ................................................................................. wlan security key .............................................................................................. wlan security passphrase ..................................................................................... wlan ssid .......................................................................................................... wlan ssid broadcast ............................................................................................ wlan txpower .................................................................................................... write ................................................................................................................

129 130 131 132 133 134 135 136 137 138 139 140 141 142 143 144 145 146 148 149 150 151 152 153 154 155 156 157 158 159 160 161 162 163 164 165 166 167 168 169 171 172 173 174 175 176

vi

List of Tables
1.1. 1.2. 2.1. 2.2. Typeface conventions .............................................................................................. 1 Command syntax conventions ................................................................................... 1 VoIP Connection Status ........................................................................................ 125 VoIP Line Status ................................................................................................. 125

vii

viii

Chapter 1. Introduction
PacketFront Digital Residential Gateway (DRG) hardware runs an operating system (DRGOS) designed to provide a powerful, flexible and stable platform for modern Fiber to the Home (FTTH) customer premise equipment (CPE) needs. The operation of the DRG may be configured during runtime using command line interface (CLI) commands. This manual is intended for personnel configuring PacketFront DRG hardware running DRGOS, either directly using the CLI over an SSH connection, or via configuration files using the same syntax which may then be downloaded to the DRGs using a variety of mechanisms. To fully understand this manual, you will need expert knowledge of broadband, access and home networking, data communication protocols and to be familiar with PacketFront CPE hardware products. Please refer to the Software Configuration Guide for the relevant DRG platform which describes how to use commands to control specific functionality and for specific deployment scenarios.

Conventions used in this manual


The following typeface conventions apply:

Table 1.1. Typeface conventions


Typeface show version drgos# Description Denotes DRGOS commands Output to screen

The following command syntax conventions apply:

Table 1.2. Command syntax conventions


Character [] {keyword | keyword} <> a.b.c.d Description Denotes optional keywords or arguments Denotes mandatory keywords separated with |, you must select one of the keywords. Denotes user entered data Denotes standard 4-octet ip address format

Chapter 2. Commands

access-list
Context
configuration-root

Syntax
[no] access-list <name> Creates an access control list and brings the operator into the context of the list. [no] [ seq <1-2147483647> ] { deny | permit | reject } ip [ source { <a.b.c.d/m> | <a.b.c.d> <m.m.m.m> | host <a.b.c.d> | any } ] [ destination { <a.b.c.d/m> | <a.b.c.d> <m.m.m.m> | host <a.b.c.d> | any } ] [ protocol <0-255> ] Configure an access control entry for IP packets. [no] [ seq <1-2147483647> ] { deny | permit | reject } icmp [ source { <a.b.c.d/m> | <a.b.c.d> <m.m.m.m> | host <a.b.c.d> | any } ] [ destination { <a.b.c.d/m> | <a.b.c.d> <m.m.m.m> | host <a.b.c.d> | any } ] [ echo | echo-reply | host-unreachable | net-unreachable | unreachable ] Configure an access control entry for ICMP packets. [no] [ seq <1-2147483647> ] { deny | permit | reject } udp [ source { <a.b.c.d/m> | <a.b.c.d> <m.m.m.m> | host <a.b.c.d> | any } [ <1-65535> | range <1-65535> <1-65535> ] ] [ destination { <a.b.c.d/m> | <a.b.c.d> <m.m.m.m> | host <a.b.c.d> | any } [ <1-65535> | range <1-65535> <1-65535> ] ] Configure an access control entry for UDP packets. [no] [ seq <1-2147483647> ] { deny | permit | reject } tcp [ source { <a.b.c.d/m> | <a.b.c.d> <m.m.m.m> | host <a.b.c.d> | any } [ <1-65535> | range <1-65535> <1-65535> ] ] [ destination { <a.b.c.d/m> | <a.b.c.d> <m.m.m.m> | host <a.b.c.d> | any } [ <1-65535> | range <1-65535> <1-65535> ] ] [ flags { ack | fin | rst | syn | urg } ] Configure an access control entry for TCP packets.

Description
The access-list configuration command is used to create a named access list for filtering packets. Access-lists are used to control access based on source and destination IP address, protocol, port range for TCP or UDP and other protocol parameters. An access control list is identified by its name parameter. An access control list can consist of multiple entries. Each entry basically consists of three parts: the sequence number seq, the action deny, permit, or reject, and the matching statements. The rules of an access list are ordered by the sequence number seq. If no seq is specified, a seq number is automatically assigned to the entry: If the highest seq number in the same list is a multiple of 10, the next higher multiple of 10 is used (e.g. 50 is the highest seq number, then 60 is used); If the highest seq number in the same list is not a multiple of 10, the second higher multiple of 10 is used (e.g. 51 is the highest seq number, then 70 is used). Packets are checked against each entry of the access list in the order of the sequence number. The first entry matching the packet will take effect. There are three types of action that could be taken to the matched packets: deny, permit, and reject. deny and reject both drop the matched packet, the difference is that reject will send an ICMP notification but deny will not.

Commands

The matching statements include source, destination, and other protocol-specific parameters. For example, when matching UDP packets, the source port and destination port can be matched. All access lists have an implicit deny any any as the last entry. This means that if a packet is compared with all configured entries in the access list and no match is found the packet will be dropped. The assumption is that if an access list is applied on the packet stream, there is something to protect. If communication is not explicitly permitted it is not allowed to pass through. Entries in the access lists can be removed either by the full content, or by its sequence number in a no command. If both sequence number and the full content are specified, the sequence number will be used. The whole access list can be removed by only specifying the name.

Example
drgos(config)# access-list my-acl drgos(config-acl)# permit ip source any destination any protocol 17 drgos(config-acl)# deny ip destination 192.168.1.0/24 drgos(config-acl)# no seq 20 drgos(config-acl)# no reject ip source host 192.168.1.100 drgos(config)#no access-list test-acl

Default
This command has no default value.

History
This command was introduced in DRGOS 1.4.

See Also
ip access-group access-list clear-counters show access-list

access-list clear-counters
Context
configuration-root

Syntax
access-list clear-counters <name> Clear counters on access-list.

Description
The access-list clear-counters command clears the counters (number of hits) for all entries in the specified access-list. The number of hits for each entry is displayed when the show access-list command is executed.

Example
drgos(config)# access-list clear-counters my-acl

Default
This command has no default value.

History
This command was introduced in DRGOS 1.4.

See Also
access-list ip access-group show access-list

Commands

boot system
Context
configuration root

Syntax
[no] boot system Configure the system boot image

Description
The boot system configuration command sets the system image to boot at the next restart of the system. The current boot image can be shown by the show boot command.

Example
drgos(config)# boot system drgos-drg700-1.2.1-R.img

Default
This command has no default value.

History
This command was introduced in DRGOS 1.1.

See Also
show boot ls

catv enable
Context
configuration-root

Syntax
[no] catv enable Enable or disable the CATV function.

Description
The catv enable configuration command is used to enable/disable the CATV RF Overlay.

Example
drgos(config)# catv enable

Default
By default the CATV function is disabled.

History
This command was introduced in DRGOS 1.2.

See Also
catv filter show catv

Commands

catv filter
Context
configuration-root

Syntax
[no] catv filter Enable or disable the CATV channel filter.

Description
The no catv filter configuration command is used to disable the premium channel filter for the CATV.

Example
drgos(config)# no catv filter

Default
By default the CATV filter is enabled.

History
This command was introduced in DRGOS 1.2.

See Also
catv enable show catv

clear mac-address-table
Context
executable-root

Syntax
clear mac-address-table [ <interface> ] Clear the MAC address forwarding table

Description
The clear mac-address-table command clears all entries in the MAC address forwarding table. The optional interface name clears only entries for addresses present on the specified interface.

Example
drgos# clear mac-address-table wan

History
This command was introduced in DRGOS 1.2.

See Also
show mac-address-table

10

Commands

clip enable
Context
voice-line-configuration-root

Syntax
[no] clip enable Enable the CLIP for voice line

Description
The clip enable configuration command is used to enable/disable the CLIP (Calling Line Identification Presentation) service for one voice line. Calling Line Identification Presentation is a service that provides a called party with the Calling Line ID of the caller. If the CLIP enabled, the inbound caller ID will be provided to fxs port. By default the CLIP is disabled for every voice line.

Example
drgos(config)# voice line 1 drgos(config-voice-line)# clip enable

Default
By default CLIP is disabled for each voice line.

History
This command was introduced in DRGOS 1.1.

See Also
sip display-name sip phone-number country

11

codec
Context
voice-configuration-root

Syntax
[no] codec <name> {g711a|g711u|g729} [<packetization-time>] [silence-suppression] [echocancellation] Create a codec definition. Defined codecs may then be applied to voip lines

Description
The codec configuration command is used to create a codec definition. Each codec definition includes: codec name: Each codec must have a unique name. codec type name: g711a, g711u and g729 are supported. packetization: packetization time is a integer number in ms. The default value is 20 ms. Each codec type has different available packetization time: for g711a: 10, 20, 30, 40, 50, 60. for g711u: 10, 20, 30, 40, 50, 60. for g729: 10, 20, 30, 40, 50, 60, 70, 80. silence-suppression: Enable the Silence Suppression. The default value is disabled. echo-cancellation: Enable the Echo Cancellation. The default value is disabled. There are 3 predefined codecs: g711a: G.711 A-law codec with disabled Silence Suppression, enabled Echo Cancellation and 20 ms packetization time. g711u: G.711 -law codec with disabled Silence Suppression, enabled Echo Cancellation and 20 ms packetization time. g729: G.729 codec with disabled Silence Suppression, enabled Echo Cancellation and 20 ms packetization time. The no command will remove user defined codec, or reset one of the 3 predefined codecs to factory default value.

Example
drgos(config)# voice drgos(config-voice)# codec mycodec g711a 10 silence-suppression drgos(config-voice)# codec mycodec2 g711u 30 silence-suppression echo-cancellation drgos(config-voice)# codec g729 g729 50 echo-cancellation

Default
The 3 predefined default codecs are: named g711a: G.711 A-law codec with disabled Silence Suppression, enabled Echo Cancellation and 20 ms packetization time.

12

Commands

named g711u: G.711 -law codec with disabled Silence Suppression, enabled Echo Cancellation and 20 ms packetization time. named g729: G.729 codec with disabled Silence Suppression, enabled Echo Cancellation and 20 ms packetization time.

History
This command was introduced in DRGOS 1.1.

See Also
codec preference dtmf relay dtmf rfc2833-payload

13

codec preference
Context
voice-line-configuration-root

Syntax
[no] codec preference <codec-names> Set the codec preference for a voice line.

Description
The codec preference configuration command is used to set the codec preference for each voice line. The codec-names argument is a list of codec names. A codecs presence order in the name list denotes its priority. The first is in highest priority, and the last is in lowest priority.

Example
drgos(config)# voice line 1 drgos(config-voice-line)# codec preference mycodec g729 g711u

Default
Each voice line has a predefined default codec preference: "g711a g711u g729".

History
This command was introduced in DRGOS 1.1.

See Also
codec dtmf relay dtmf rfc2833-payload

14

Commands

community
Context
snmp-group-configuration-root

Syntax
[no] community <name> {read-only|read-write} Configure SNMP community

Description
The community configuration command is available for SNMP groups for version 1 and version 2c of the protocol. The community command specifies a community to be used by a remote host to read or write SNMP objects. The read-only or read-write keyword defines if the access to the SNMP MIB should allow the remote host to modify information.

Example
drgos(config-snmp-group)# community public read-only drgos(config-snmp-group)# community private read-write

Default
This command has no default value.

History
This command was introduced in DRGOS 1.2.

See Also
snmp-group version

15

configure terminal
Context
executable-root

Syntax
configure terminal Enter system configuration mode

Description
The configure terminal command is used to manually configure DRGOS from the command line interface. The command makes the session enter configuration mode to allow configuration commands to be entered. When in configuration mode the prompt is modified with the addition of the current configuration context to the system hostname.

Example
drgos# configure terminal drgos(config)# interface wan drgos(config-if-wan)# end drgos#

History
This command was introduced in DRGOS 1.1.

See Also
end

16

Commands

copy
Context
executable-root

Syntax
copy { http:// | tftp:// | local:<filename> } { tftp:// | bootflash | flash | bootloader | running-config [replace] | startup-config } Copy file

Description
The copy command copies a file between a source and destination. The http:// keyword designates a URL for a remote file. The file will be copied using the HTTP protocol. The host and path to the file must also be provided. The tftp:// keyword designates a URL for a remote file. The file will be copied using the TFTP protocol. The host and path to the file must also be provided. The local: keyword designates a URL for a local file. The local file will be copied to a TFTP destination. One can copy some debug files, e.g. log files, core dump files, from DRG by using the TFTP protocol. The bootflash keyword designates the system boot image. If copying to the bootflash, the file will be copied to local file system and be marked as system next boot image (same as using boot system command on the file). The flash keyword designates the local file system. If copying to the flash, the file will be copied to local file system. The bootloader keyword designates the system bootloader. If copying to the bootloader, the file will be copied to local bootloader flash area. The running-config keyword designates the system running configuration. If running-config is set as destination, the file copied will merge with the current running configuration. For this destination, by using the optional *replace" argument, the current running configuration will be entirely replaced by the file. The startup-config keyword designates the system configuration stored on the flash filesystem (using the write command). When set as destination the startup configuration of the system will be replaced by the file copied.

Example
drgos# copy http://10.195.0.14/config.txt startup-config Connecting to 10.195.0.14 (10.195.0.14:80) startup-config 100% |*******************************| Transferred 145 bytes from http://10.195.0.14/config.txt

145

--:--:-- ETA

drgos# copy http://172.19.36.203/drgos-drg700-0.7.1-R.img bootflash Transferred 7889518 bytes sucessfully in 90 seconds drgos# copy tftp://172.19.36.210/drgos-drg700-0.7.2-R.img flash Transferred 7889512 bytes sucessfully in 86 seconds drgos# copy tftp://172.19.33.8/drgldr-drg700-0.5.3-R.img bootloader Transferred 286668 bytes sucessfully in 30 seconds drgos# copy local:sipapp.log tftp://172.19.33.8/sipapp.log

17

Transferred 128769 bytes sucessfully in 8 seconds

History
This command was introduced in DRGOS 1.1. The "local:<filename>" argument was added in DRGOS 1.4.

See Also
show running-config show startup-config write ls

18

Commands

country
Context
voice-configuration-root

Syntax
[no] country <iso-3166-code> Configure country code for voice service

Description
The country configuration command is used to set the country code for voice services. Some voice functions are dependent on location, i.e. country. These include FXS settings, call progress tones etc. The following countries are fully supported, i.e. line impedance, ring sequence, call progress tones and CLIP methods are per the national standards for that country. Countries which are not on this list use default settings based upon the default country, i.e. Sweden. In these cases line impedance is ETSI standard, ring sequence and call progress tones are per Sweden, and CLIP uses Bellcore FSK. It is possible to override the default settings for features, e.g. tones, CLIP type etc, for supported and unsupported countries using the individual commands described elsewhere in this document. Australia Austria Belgium Brazil Bulgaria Canada China Cyprus Czech Republic Denmark Estonia Finland France Germany Greece Hong Kong Hungary Iceland Ireland Israel Italy Japan Latvia Lithuania Luxembourg Malta Netherlands New Zealand Norway Poland Portugal Romania Russia Saudi Arabia Singapore Slovakia Slovenia South Africa Spain Sweden Switzerland Turkey United Arab Emirates United Kingdom United States Uruguay Venezuela Russia uses a non-standard CLIP format which is currently not supported.

You can find a complete list of countries and their ISO3166 codes at http://en.wikipedia.org/wiki/ISO_3166-1_alpha-2.

Example
drgos(config)# voice drgos(config-voice)# country us

Default
By default the country is se.

History
This command was introduced in DRGOS 1.1. Israel was added as a supported country in DRGOS 1.4.1.

See Also
clip enable

19

cwmp acs server


Context
configuration-root

Syntax
[no] cwmp acs server <url> Set the ACS (Auto-Configuration Server) URL.

Description
The cwmp acs server configuration command sets the ACS (Auto-Configuration Server) URL for the CWMP protocol. The url parameter specifies the ACS location with which the CWMP client will build a connection. It should be a valid HTTP or HTTPS URL.

Example
drgos(config)# cwmp acs server http://172.19.33.31:8080/dps/TR069

Default
The default value of the URL is empty. If so, the ACS discovery will be attempted if CWMP client is not disabled.

History
This command was introduced in DRGOS 1.2.

See Also
cwmp source-interface cwmp enable cwmp acs username cwmp client username cwmp interval show cwmp status

20

Commands

cwmp acs username


Context
configuration-root

Syntax
[no] cwmp acs username <username> password <password> Set the ACS (Auto-Configuration Server) username and password.

Description
The cwmp acs username configuration command sets the ACS (Auto-Configuration Server) username and password for the CWMP protocol. The username and password parameters are used by DRGs CWMP client to log into ACS server.

Example
drgos(config)# cwmp acs username foo password foobar

Default
Both the default username and password of CWMP ACS are empty ("").

History
This command was introduced in DRGOS 1.2.

See Also
cwmp enable cwmp acs server cwmp client username cwmp interval show cwmp status

21

cwmp client username


Context
configuration-root

Syntax
[no] cwmp client username <username> password <password> Set the username and password of CWMP client.

Description
The cwmp client username configuration command sets the username and password for the CWMP client of the DRG. The CWMP will authenticate a ACS by using the username and password parameters.

Example
drgos(config)# cwmp client username foo password foobar

Default
Both the default username and password of CWMP client are "".

History
This command was introduced in DRGOS 1.2.

See Also
cwmp enable cwmp acs server cwmp acs username cwmp interval show cwmp status

22

Commands

cwmp enable
Context
configuration-root

Syntax
[no] cwmp enable Enable or disable the CWMP client.

Description
The no cwmp enable configuration command is used to disable the CWMP (CPE WAN Management Protocol) client.

Example
drgos(config)# no cwmp enable

Default
By default the CWMP client is enabled.

History
This command was introduced in DRGOS 1.2.

See Also
cwmp acs server cwmp acs username cwmp client username cwmp interval show cwmp status

23

cwmp interval
Context
configuration-root

Syntax
[no] cwmp interval <seconds> Set the CWMP client polling interval.

Description
The cwmp interval configuration command sets the CWMP client periodic inform interval. The ACS may override specified value. The ACS can use this mechanism to alter the polling interval to specific intervals when required.

The CWMP client may periodically poll the Server by sending the Inform method call. The seconds parameter defines the periodic inform interval at which the CPE will connect to the ACS. The unit is seconds.

Example
drgos(config)# cwmp interval 21600

Default
By default the interval value is 86400 seconds (24 hours).

History
This command was introduced in DRGOS 1.2.

See Also
cwmp enable cwmp acs server cwmp acs username cwmp client username show cwmp status

24

Commands

cwmp source-interface
Context
configuration-root

Syntax
[no] cwmp source-interface <ifname> Set the source interface of the CWMP client.

Description
The cwmp source-interface configuration command sets the source interface for the CWMP client of the DRG. The CWMP client will communicate to the ACS through this network interface.

Example
drgos(config)# cwmp source-interface vlan1 drgos(config)# cwmp source-interface wan

Default
The default CWMP source interface is "wan" interface.

History
This command was introduced in DRGOS 1.2.

See Also
cwmp enable cwmp acs server cwmp acs username cwmp interval show cwmp status

25

debug voip
Context
executable-root

Syntax
debug voip [trace] Enable debugging VoIP application

Description
The debug voip command is used to debug the voip application, including changing the syslog level to "debugging" and optionally capturing a trace file of VoIP signalling and media packets. When using the trace option, the captured trace file is saved in a file (e.g. sipapp.pcap). After running "undebug voip" command, the "copy" command can copy the file to an external host for further inspection.

Example
drgos# debug voip drgos# debug voip trace

History
This command was introduced in DRGOS 1.4.

See Also
show logging ls copy

26

Commands

delete
Context
executable-root

Syntax
delete local:<filename> Delete a file

Description
The delete command is used to remove a file from the local file system. It is only possible to delete files from the RAM file system, and only those files which are shown by an "ls" command, i.e. *.log, *.cap etc. Please note that the .img file is on the FLASH file system. So it cannot be deleted by using the "delete" command.

Example
drgos# ls 9362442 8530577 978115 drgos# delete drgos# ls 9362442 8530577 Nov 22 2010 drgos-drg700-1.3.1-R.img Jan 1 00:11 drgos-drg700-1.4.1-RC02.img Jan 1 02:11 sipapp.log local:sipapp.pcap Nov 22 2010 drgos-drg700-1.3.1-R.img Jan 1 00:11 drgos-drg700-1.4.1-RC02.img

History
From DRGOS 1.4, the command can list some debug files.

See Also
ls copy

27

dhcp option
Context
class-configuration-root client-configuration-root

Syntax
[no] dhcp option {<standard-option-name> | <1-254> [type <option-type>]} [<option-value>] Set, update or delete a DHCP option for specified client

Description
The dhcp option is used to manage different or extra options to specified DHCP clients, including create, update or delete a DHCP option. A standard DHCP option (as defined RFC2132 may be described by standard-option-name. The supported standard DHCP options names are: netmask (option 1): Subnet Mask, whose value can be a IPv4 address or a netmask prefix. The default value is same as the subnet mask of LAN interface. broadcast-address (option 28): Broadcast Address, whose value is a IPv4 address. The default value is same as the broadcast address of LAN interface. router (option 3): Routers, whose value is a list of IPv4 addresses, separated by ",". The default value is same as the IP address of LAN interface. dns-server (option 6): Domain Name Servers, whose value is a list of IPv4 addresses separated by ",". The default value is same as the IP address of LAN interface. domain-name (option 15): Domain Name, specifies the domain name that client should use when resolving hostnames via DNS. The default value is "domain_not_set.invalid". renewal-time (option 58): Renewal Time, specifies the time interval from address assignment until the client transitions to the RENEWING state. The option value is in units of seconds, and is specified as a unsigned integer. Default value is half the lease time. rebinding-time (option 59): Rebinding Time, specifies the time interval from address assignment until the client transitions to the REBINDING state. The option value is in units of seconds, and is specified as a unsigned integer. Default value is seven eights of the lease time. ntp-server (option 42): NTP Servers, whose value is a list of IPv4 addresses separated by ",". No default value. bootfile-name (option 67): Bootfile name, identifies a bootfile when the file field in the DHCP header has been used for DHCP options. The value is formatted as a character string. No default value. name-server (option 5): Name server, specifies a list of name servers available to the client. Its value is a list of IPv4 addresses separated by ",". No default value. root-path (option 17): Root path, specifies the path-name that contains the clients root disk. The path is formatted as a character string. No default value. swap-server (option 16): Swap server, specifies the IP address of the clients swap server. Its value is a list of IPv4 addresses separated by ",". No default value.

28

Commands

host-name (option 12): Host name, specifies the name of the client. The name may or may not be qualified with the local domain name. lease-time (option 51): IP address lease time, the DHCP server uses this option to specify the lease time it is willing to offer. The time is in units of seconds. tftp-server-name (option 66): TFTP server name, whose value is used to identify a TFTP server when the sname field in the DHCP header has been used for DHCP options. No default value. An option can be described by its option number. An option number may take a value from 1 to 254. If an option is defined by its option number, the option-type can be set using the type keyword. This identifies the expected type of the option value so that it may be processed correctly. The following option types are supported. If a standard option is defined by option number, the option-type value will be ignored if it does not match the standard option type, i.e. one cannot redefine the type of standard options using this mechanism. bool Input is boolean value byte Input is byte (8 bits) value hex Input is hex string integer Input is integer (32 bits) value ip Input is IPv4 address record Input is record short Input is short int (16 bits) value string Input is string

Example
drgos(class-config)# drgos(class-config)# drgos(class-config)# drgos(class-config)# drgos(class-config)# drgos(class-config)# dhcp option netmask 24 dhcp option netmask 255.255.255.0 dhcp option dns-server 172.19.33.8,172.19.33.10 dhcp option 201 type string drgos no dhcp option netmask no dhcp option 211

Default
By default, no DHCP options are defined.

History
This command was introduced in DRGOS 1.3.2

See Also
dhcp server class dhcp server client next-server

29

dhcp server class


Context
configuration-root

Syntax
[no] dhcp server class <vendor-class-name> [exact] Configure or remove configuration for clients with specified vendor-class.

Description
The dhcp server class configuration command is used to enter the "config-dhcp-class" context. The "config-dhcp-class" context may be used to specify DHCP option values which will be provided to DHCP clients whose vendor class identifier matches the specified value. If exact is specified the DHCP server options will be provided to clients whose vendor-class exactly matches the vendor-class-name. If exact is not specified, the DHCP server options will be provided to clients where the vendor-class-name is a substring of the client vendor-class identifier.

Example
drgos(config)# dhcp server class Packetfront drgos(config-dhcp-class)# drgos(config)# dhcp server class "Packetfront DRG700" exact drgos(config-dhcp-class)#

Default
By default, no vendor-class contexts exist.

History
This command was introduced in DRGOS 1.3.2

See Also
dhcp server client dhcp option next-server

30

Commands

dhcp server client


Context
configuration-root

Syntax
[no] dhcp server client <mac> Configure or remove configuration for a specific client.

Description
The dhcp server client configuration command is used to enter the "config-dhcp-client" context. The "config-dhcp-client" context is used to set DHCP server options for a client with the specified mac address.

Example
drgos(config)# dhcp server client 0011.2233.4455 drgos(config-dhcp-client)# drgos(config)# dhcp server client 00:11:22:33:44:55 drgos(config-dhcp-client)#

Default
By default, no client contexts exist.

History
This command was introduced in DRGOS 1.3.2

See Also
dhcp server class dhcp option next-server

31

dhcp server disable


Context
configuration-root

Syntax
[no] dhcp server disable Disable or enable DHCP Server

Description
The dhcp server disable command is used to disable DHCP server. By default, the DHCP server is enabled.

Example
drgos(config)# dhcp server disable

Default
By default the DHCP server is enabled.

History
This command was introduced in DRGOS 1.1.

See Also
dhcp server pool dhcp server lease dhcp server option

32

Commands

dhcp server inherit option


Context
configuration-root

Syntax
[no] dhcp server inherit option {<standard-option-name> | <1-254> [type <option-type>]} Add or remove a DHCP option inheritance

Description
The dhcp server inherit option configuration command is used to manage DHCP option inheritance. This allows the specification of options which will be requested from an upstream DHCP server. If the server provides option values, this information will be provided to DHCP clients whether the relevant option was requested or not. This feature may be used to provide option information to DHCP clients, e.g. IPTV set-top boxes, which require such information to allow them to boot. DHCP inheritance prevents the need to configure specific option information on each DRG individually. The option information may be administered on a central DHCP server and then relevant DRGs may be configured to request the information needed by their clients. A standard DHCP option (as defined RFC2132 may be described by standard-option-name. The supported standard DHCP options names are: name-server (option 5): Name Server, whose value is a list of name servers available to the client. Servers SHOULD be listed in order of preference. No default value. dns-server (option 6): Domain Name Servers, whose value is a list of IPv4 addresses separated by ",". The default value is same as the IP address of the interface on which the DHCP server is running. swap-server (option 16): Swap Server, specifies the IP address of the clients swap server. No default value. root-path (option 17): Root Path, specifies the path-name that contains the clients root disk. The path is formatted as a character string consisting of characters from the NVT ASCII character set. No default value. ntp-server (option 42): NTP Servers, whose value is a list of is NTP servers which are available to the client. The addresses are separated by ",". No default value. tftp-server-name (option 66): TFTP server name, whose value is used to identify a TFTP server when the sname field in the DHCP header has been used for DHCP options. No default value. bootfile-name (option 67): Bootfile name, whose value is used to identify a bootfile when the file field in the DHCP header has been used for DHCP options. No default value. An inherited option can be described by its option number. An option number may take a value from 1 to 254. If an inherited option is defined by its option number, the option-type can be set using the type keyword. This identifies the expected type of the received option value so that it may be processed correctly. The following option types are supported. If a standard option is defined by option number, the option-type value will be ignored if it does not match the standard option type, i.e. one cannot redefine the type of standard options using this mechanism.

33

bool Input is boolean value byte Input is byte (8 bits) value hex Input is hex string integer Input is integer (32 bits) value ip Input is IPv4 address record Input is record short Input is short int (16 bits) value string Input is string

Example
drgos(config)# dhcp server inherit option netmask drgos(config)# dhcp server inherit option 201 type string

Default
No DHCP options are inherited by default.

History
This command was introduced in DRGOS 1.3.

See Also
dhcp server inherit source-interface

34

Commands

dhcp server inherit source-interface


Context
configuration-root

Syntax
[no] dhcp server inherit source-interface <interface-name> Define or remove the interface used for DHCP option inheritance

Description
The dhcp server inherit source-interface configuration command is used to define the source interface used for DHCP option inheritance. The source interface is normally a WAN side network interface. The DRG will only request the configured DHCP options from the source interface. The source interface used is typically the management or IPTV service interface.

Example
drgos(config)# dhcp server inherit source-interface vlan1

Default
This command has no default value.

History
This command was introduced in DRGOS 1.3.

See Also
dhcp server inherit option

35

dhcp server lease


Context
configuration-root

Syntax
[no] dhcp server lease [<mac-addr>] [<host-name>] [<a.b.c.d> [<leasetime>]] Create, update or delete a static lease for a host.

Description
The dhcp server lease configuration command is used to manage static leases for hosts. By using a static lease, one can allocate a fixed IP address to a host on your network, identified by its MAC (hardware) address or host name. Several forms of the command are permitted. The host may be identified by either its MAC address or hostname; in the first form, the host will be allocated the specified hostname, IP address and optionally lease time. In the second form the host is again identified by its MAC address and simply provided with an IP address. In the final form the host is idenfitied by the hostname used by the client, and an IP address is defined for the host, with an optional lease time. The "leasetime" specifies the duration of the lease provided to client. The value of the lease time is in seconds. The default value is 24 hours.

Example
drgos(config)# dhcp server lease 0011.2233.4455 mypc 192.168.1.2 3600 drgos(config)# dhcp server lease 0011.2233.4455 192.168.1.2 drgos(config)# dhcp server lease mypc 192.168.1.12 3600

Default
There is no default for this command.

History
This command was introduced in DRGOS 1.1.

See Also
dhcp server pool dhcp server option

36

Commands

dhcp server next-server


Context
configuration-root

Syntax
[no] dhcp server next-server <a.b.c.d> Configure the siaddr for DHCP server

Description
The dhcp server next-server is used to configure the siaddr on DHCP. The siaddr is a standard field in DHCP header. It specifies the address of the server to use in the next step of the clients bootstrap process.

Example
drgos(config)# dhcp server next-server 172.19.33.8 drgos(config)# no dhcp server next-server

Default
The default value is the DHCP servers own address.

History
This command was introduced in DRGOS 1.3.2

See Also
dhcp server option

37

dhcp server option


Context
configuration-root

Syntax
[no] dhcp server option {<standard-option-name> | <1-254> [type <option-type>]} [<option-value>] Set, update or delete a DHCP option

Description
The dhcp server option is used to manage different or extra options to DHCP clients, including create, update or delete a DHCP option. A standard DHCP option (as defined RFC2132 may be described by standard-option-name. The supported standard DHCP options names are: netmask (option 1): Subnet Mask, whose value can be a IPv4 address or a netmask prefix. The default value is same as the subnet mask of LAN interface. broadcast-address (option 28): Broadcast Address, whose value is a IPv4 address. The default value is same as the broadcast address of LAN interface. router (option 3): Routers, whose value is a list of IPv4 addresses, separated by ",". The default value is same as the IP address of LAN interface. dns-server (option 6): Domain Name Servers, whose value is a list of IPv4 addresses separated by ",". The default value is same as the IP address of LAN interface. domain-name (option 15): Domain Name, specifies the domain name that client should use when resolving hostnames via DNS. The default value is "domain_not_set.invalid". renewal-time (option 58): Renewal Time, specifies the time interval from address assignment until the client transitions to the RENEWING state. The option value is in units of seconds, and is specified as a unsigned integer. Default value is half the lease time. rebinding-time (option 59): Rebinding Time, specifies the time interval from address assignment until the client transitions to the REBINDING state. The option value is in units of seconds, and is specified as a unsigned integer. Default value is seven eights of the lease time. ntp-server (option 42): NTP Servers, whose value is a list of IPv4 addresses separated by ",". No default value. bootfile-name (option 67): Bootfile name, identifies a bootfile when the file field in the DHCP header has been used for DHCP options. The value is formatted as a character string. No default value. name-server (option 5): Name server, specifies a list of name servers available to the client. Its value is a list of IPv4 addresses separated by ",". No default value. root-path (option 17): Root path, specifies the path-name that contains the clients root disk. The path is formatted as a character string. No default value. swap-server (option 16): Swap server, specifies the IP address of the clients swap server. Its value is a list of IPv4 addresses separated by ",". No default value.

38

Commands

host-name (option 12): Host name, specifies the name of the client. The name may or may not be qualified with the local domain name. lease-time (option 51): IP address lease time, the DHCP server uses this option to specify the lease time it is willing to offer. The time is in units of seconds. tftp-server-name (option 66): TFTP server name, whose value is used to identify a TFTP server when the sname field in the DHCP header has been used for DHCP options. No default value. An option can be described by its option number. An option number may take a value from 1 to 254. If an option is defined by its option number, the option-type can be set using the type keyword. This identifies the expected type of the option value so that it may be processed correctly. The following option types are supported. If a standard option is defined by option number, the option-type value will be ignored if it does not match the standard option type, i.e. one cannot redefine the type of standard options using this mechanism. bool Input is boolean value byte Input is byte (8 bits) value hex Input is hex string integer Input is integer (32 bits) value ip Input is IPv4 address record Input is record short Input is short int (16 bits) value string Input is string

Example
drgos(config)# drgos(config)# drgos(config)# drgos(config)# drgos(config)# drgos(config)# drgos(config)# dhcp server option netmask 255.255.255.0 dhcp server option netmask 24 no dhcp server option netmask dhcp server option dns-server 172.19.33.8,172.19.33.10 no dhcp server option dns-server dhcp server option 201 type string drgos no dhcp server option 201

Default
The default value for each option is described in the list above.

History
This command was introduced in DRGOS 1.1. Support for "option number" and "option-type" fields was introduced in DRGOS 1.3.

See Also
dhcp server pool dhcp server lease dhcp server next-server

39

dhcp server pool


Context
configuration-root

Syntax
[no] dhcp server pool [<start> <size>] [<leasetime>] Update or reset the DHCP address pool

Description
The dhcp server pool configuration command is used to manage DHCP address pool, including update and reset. The address pool is a range of continuous IP address resource, which can be dynamically offered to client hosts. The DHCP address pool is defined by the starting offset and the size in the LAN network. The maximum size of a pool is 253. By default, the start value is 64 and the size value is 190. As the default IP address of the LAN interface is 192.168.1.254/24, the DHCP address pool by default contains 190 IP addresses starting from 192.168.1.64 to 192.168.1.253. The "leasetime" (deprecated) option specifies the lease time of the IP addresses assigned to the clients. The value of lease time is an unsigned integer in seconds. In normal cases, it is not recommended to set the "leasetime" option. This option is deprecated and will be removed in a future version of the DRGOS. To serve the same purpose, use the "dhcp server option lease-time <value>" command instead.

Example
drgos(config)# dhcp server pool 10 20 3600 drgos(config)# dhcp server pool 10 10

Default
The default for start is 64. The default for size is 190. The default for leasetime is 86400 seconds (24 hours).

History
This command was introduced in DRGOS 1.1.

See Also
dhcp server lease dhcp server option

40

Commands

dial plan
Context
voice-configuration-root

Syntax
[no] dial plan <dial-plan> Set telephone dial plan.

Description
The dial plan configuration command is used to set the telephone dial plan. The dial plan is valid for all voice lines. The dial plan specifies how to interpret digit sequences dialed by the user, and how to convert those sequences into an outbound dial string. For the syntax of the dial plan, please refer to other manual.

Example
drgos(config)# voice drgos(config-voice)# dial plan (0T|00T|[1-7]xxx|9xxxxxxxx|xx.#|xx.T)

Default
The default dial plan is "(xx.#|xx.T)".

History
This command was introduced in DRGOS 1.1. The default dialplan was corrected in 1.5.1.

See Also
dial timeout dial quick-dial

41

dial quick-dial
Context
voice-configuration-root

Syntax
[no] dial quick-dial Enable or disable the quick dial function.

Description
The no dial quick-dial configuration command is used to disable the quick dial function for all voice lines. If the quick dial function is enabled, the dial string will be sent immediately without waitting for the timer period T, by ending with a "" key. The "" key will not be sent.

Example
drgos(config)# voice drgos(config-voice)# no dial quick-dial

Default
By default, the quick dial function is enabled.

History
This command was introduced in DRGOS 1.1.

See Also
dial plan dial timeout

42

Commands

dial timeout
Context
voice-configuration-root

Syntax
[no] dial timeout <period> Set the dial timeout period in seconds.

Description
The dial timeout configuration command is used to set the timeout period between the latest keystroke and sending the dial string. The dial timeout is valid for all voice lines. When the user dials a sequence of digits, the dial timeout timer is restarted after each key press. If no keys are pressed within the timeout period, then the current dial string will be immediately sent to the network. If the quick dial function is enabled and the user presses the "#" key at any stage, the current dial string will immediately be sent to the network without waiting for the timeout timer expiry.

Example
drgos(config)# voice drgos(config-voice)# dial timeout 10

Default
The default period of the dial timeout is 4 seconds.

History
This command was introduced in DRGOS 1.1.

See Also
dial plan dial quick-dial

43

do
Context
all configuration contexts

Syntax
do <command> Run executable command in configuration context

Description
The do command runs an executable command from the configuration context. This allows you to view the results of new configuration settings without leaving the configuration context.

Example
drgos# configure terminal drgos(config)# interface wan drgos(config-if-wan)# ip address dhcp drgos(config-if-wan)# do show int wan wan Link encap:Ethernet HWaddr 00:0F:5D:A0:02:F0 inet addr:10.126.3.100 Bcast:10.126.3.255 Mask:255.255.255.0 inet6 addr: fe80::20f:5dff:fea0:2f0/64 Scope:Link UP BROADCAST RUNNING MULTICAST MTU:1500 Metric:1 RX packets:2489 errors:0 dropped:0 overruns:0 frame:0 TX packets:1363 errors:0 dropped:0 overruns:0 carrier:0 collisions:0 txqueuelen:1000 RX bytes:1221267 (1.1 MiB) TX bytes:155980 (152.3 KiB) Interrupt:53 drgos(config-if-wan)#

History
This command was introduced in DRGOS 1.2.

44

Commands

domain
Context
interface-wan-configuration-root interface-vlan-configuration-root

Syntax
[no] domain <domain-name> Set domain for an interfaces dynamic learned name-servers.

Description
The domain configuration command is used to set the domain-name used with DHCP or PPPoE learned name-servers. This will restrict DRGOS DNS queries for this domain to the learned nameservers on this interface. This domain-name is not added to DNS queries that do not have a domain, it is used to filter qualify DNS queries with this domain, to use only the learned name-server on this interface. Statically configured name-servers for this interface do not use this setting, but have their own statically configured values per static configured name-server.

Example
drgos(config)# interface vlan100 drgos(config-if-vlan)# domain "my.example.net" drgos(config)# interface vlan100/1 drgos(config-if-vlan)# domain "abc.example.net"

Default
By default there is no static domain setting for an interface.

History
This command was introduced in DRGOS 1.5.1.

See Also
show interface ip address ip domain-name ip name-server

45

dtmf relay
Context
voice-line-configuration-root

Syntax
[no] dtmf relay {inband|rfc2833|sip-info [method dtmf-relay]} Set the DTMF Relay mode for a voice line.

Description
The dtmf relay configuration command is used to select the DTMF signaling relay mode for a voice line. Three DTMF relay modes are supported: inband, rfc2833 and sip-info. inband is the default DTMF signaling relay mode. Two message formats are supported for the sip-info DTMF relay mode: plain-text and dtmf-relay. The dtmf-relay format contains signal and duration information. By default plain-text format is used. By default, when using DTMF relay mode rfc2833 or sip-info, hookflash events are not relayed. One can use the voip relay hookflash command to enable hookflash events being sent using the rfc2833 or sip-info methods.

Example
drgos(config)# voice line drgos(config-voice-line)# drgos(config-voice-line)# drgos(config-voice-line)# 1 dtmf relay rfc2833 dtmf relay sip-info dtmf relay sip-info method dtmf-relay

Default
The default DTMF relay mode is inband.

History
This command was introduced in DRGOS 1.1. The dtmf relay sip-info was extended in DRGOS 1.4.2 to support the optional dtmf-relay format.

See Also
dtmf rfc2833-payload voip relay hookflash voip class5 internal codec codec preference

46

Commands

dtmf rfc2833-payload
Context
voice-configuration-root

Syntax
[no] dtmf rfc2833-payload <type-value> Set the RTP payload type value for RFC2833

Description
The dtmf rfc2833-payload configuration command is used to configure the value of RTP payload for RFC2833. The value should be between 96 and 127.

Example
drgos(config)# voice drgos(config-voice)# dtmf rfc2833-payload 100

Default
The default value is 101.

History
This command was introduced in DRGOS 1.1.

See Also
dtmf relay codec codec preference

47

end
Context
configuration-root

Syntax
end Exit from configuration mode

Description
The end command ends the configuration session and return to admin mode.

Example
drgos# configure terminal drgos(config)# interface wan drgos(config-if-wan)# end drgos#

History
This command was introduced in DRGOS 1.1.

See Also
exit configure terminal

48

Commands

exit
Context
configuration-root configuration-context

Syntax
exit Leave the current context

Description
The exit command Leave the current context. In configuration mode, the user is moved up one context or leaves configuration mode and enters admin mode.

Example
drgos# configure terminal drgos(config)# interface wan drgos(config-if-wan)# exit drgos(config)# exit drgos#

History
This command was introduced in DRGOS 1.1.

See Also
end configure terminal

49

hostname
Context
configuration-root

Syntax
[no] hostname <name> Configure the system hostname

Description
The hostname configuration command sets the system hostname in DRGOS.

Default
The default hostname is drgos.

History
This command was introduced in DRGOS 1.1.

50

Commands

impedance
Context
voice-line-configuration-root

Syntax
[no] impedance <impedance-value> Sets the analogue line impedance for selected voice line.

Description
The impedance configuration command sets impedance value for one voice line. Belowing are the default impedance values for some countries. 600_0_0: United States, Canada, Russia, Korea, Indonesia, Italy, Poland, Spain, Thailand, China, Israel 270_750_150: Sweden, European CTR21 norm 370_620_310: United Kingdom, New Zealand 220_820_120: New Zealand, Australia, Germany 600_0_1000: Japan 200_680_100: China 220_820_115: South Africa, Slovakia, Slovenia, Austria, Germany, Mexico, Switzerland 900_0_0:

Example
drgos(config)# voice line 1 drgos(config-voice-line)# impedance 270_750_150

Default
If not configured, the impedance defaults to the default impedance of the selected voice country value.

History
This command was introduced in DRGOS 1.2.

See Also
country

51

interface
Context
configuration-root

Syntax
interface wan Configure the WAN interface. interface lan Configure the logical LAN interface. interface lan/ethernet<1-4> Configure physical LAN interface. [no] interface vlan<1-4094>[/<1-4>] Configure or remove configuration for a vlan interface, or sub-interface.

Description
The interface configuration command enter the interface context of the selected interface type. Vlan interfaces are dynamic and will be created when entering the configuration context for that interface. Dynamic interfaces can be deleted with the no interface command. Please refer to the Configuration Guide for further details on the use of sub-interfaces. BECS requires that the MAC address used by the management interface remains constant, therefore if using sub-interfaces, /1 must be used for the management interface.

Example
drgos(config)# interface vlan100 drgos(config)# interface vlan100/1 drgos(config)# interface wan drgos(config-if-wan)#

Default
The type and number of interfaces present in the system depends on the system model and configuration.

History
This command was introduced in DRGOS 1.1.

See Also
show interface

52

Commands

ip access-group
Context
interface-wan-configuration-root interface-lan-configuration-root interface-vlan-configuration-root

Syntax
[no] ip access-group <access-list> { in | out } Attach an access-list to or detach it from an interface.

Description
The ip access-group configuration command applies an access-list to an interface. access-list is the name of the access list that will be attached or detached. in or out specifies whether the incoming or outgoing packets will be applied with the access list.

Example
drgos(config-if-vlan1)# ip access-group my-acl in

Default
This command has no default value.

History
This command was introduced in DRGOS 1.4.

See Also
access-list access-list clear-counters show access-list

53

ip address
Context
interface-wan-configuration-root (deprecated) interface-lan-configuration-root interface-vlan-configuration-root

Syntax
[no] ip address <a.b.c.d/m> Set IP address with prefix. [no] ip address <a.b.c.d> <m.m.m.m> Set IP address with separate net mask. [no] ip address dhcp Set IP address using DHCP. [no] ip address pppoe Set IP address using PPPoE. [no] ip address none Disable IP address.

Description
The ip address configuration command is used to set the ip address for an interface. If the dhcp option is used a DHCP client will be started to obtain an ip address for the interface. The received ip address can be seen with the show interface command. If the pppoe option is used a PPPoE client will be started to obtain an ip address for the interface. The received ip address can be seen with the show interface command. The none option can be used to disable the IP address on the wan and lan interface that will otherwise have default values. Each interface can have only one IP address. All IP ranges are valid except for: 0.0.0.0/8, 127.0.0.0/8 and 224.0.0.0 - 255.255.255.255. From DRGOS 1.5.1, the command in the wan interface context is deprecated. In the future, this command will not be supported in the wan interface context. Operators are therefore encouraged to use the following vlan interface configuration, which is functionally equivalent, and will replace the current default configuration in a future DRGOS release.
interface wan ip address none vlan member 1 vlan untagged 1 interface vlan1 ip address dhcp

54

Commands

Example
drgos(config)# interface lan drgos(config-if-lan)# ip address 10.0.0.1/24 drgos(config)# interface wan drgos(config-if-wan)# ip address none drgos(config)# interface vlan12 drgos(config-if-vlan)# ip address dhcp drgos(config)# interface vlan22 drgos(config-if-vlan)# ip address pppoe

Default
The default for the wan interface is ip address dhcp. The default for the lan interface is ip address 192.168.1.254/24. Other interfaces do not have any default value.

History
This command was introduced in DRGOS 1.1. Support for PPPoE was added in DRGOS 1.2. From DRGOS 1.5.1, the command in the wan interface context is deprecated.

See Also
show interface

55

ip domain-name
Context
configuration-root

Syntax
[no] ip domain-name <domain-name> Set the domain name for the DRG.

Description
The ip domain-name configuration command is used to set the domain name for the DRG. The primary purpose of domain name is to simplify DNS name resolution. If the hostname to be resolved is not fully qualified, the configured domain name is automatically added.

Example
drgos(config)# ip domain-name packetfront.com

Default
There is no default value for domain name.

History
This command was introduced in DRGOS 1.1.

See Also
ip name-server dhcp server option

56

Commands

ip icmp-echo
Context
interface-wan-configuration-root interface-lan-configuration-root interface-vlan-configuration-root

Syntax
[no] ip icmp-echo Enable or disable ICMP echo for current interface.

Description
The no ip icmp-echo configuration command is used to disable ICMP echo for current network interface. The ICMP echo message is usually used by "ping" utility and "traceroute" utility to test the network connectivity and routes. User can enable or disable the ICMP echo. If the ICMP echo disabled, then DRG will not reply the ICMP echo request.

Example
drgos(config)# interface wan drgos(config-if-wan)# no ip icmp-echo

Default
By default the ICMP echo is enabled.

History
This command was introduced in DRGOS 1.1.

See Also
ping

57

ip igmp aggregation
Context
interface-vlan-configuration-root

Syntax
[no] ip igmp aggregation Configure IGMP report message aggregation

Description
The ip igmp aggregation configuration command is used to control IGMP reports of configured vlan. IGMP leave messages are suppressed from being sent upstream to the querier until the last reporter has left the group. IGMP join messages are suppressed from being sent upstream to the querier unless the join is from the first reporter for that group.

Example
drgos(config)# interface vlan8 drgos(config-if-vlan)# ip igmp snooping drgos(config-if-vlan)# no ip igmp aggregation

Default
IGMP snooping aggregation is enabled by default.

History
This command was introduced in DRGOS 1.2.

See Also
ip igmp snooping

58

Commands

ip igmp immediate-leave
Context
interface-vlan-configuration-root interface-lan-configuration-root

Syntax
[no] ip igmp immediate-leave Configure IGMP snooping immediate-leave

Description
When the ip igmp immediate-leave configuration command is activated, IGMP leave messages are suppressed from being sent upstream to the querier until the last reporter has left the group. Report messages are not flooded out on the LAN side.

Example
drgos(config)# interface vlan8 drgos(config-if-vlan)# ip igmp snooping drgos(config-if-vlan)# ip igmp immediate-leave

Default
IGMP snooping immediate-leave is disabled by default.

History
This command was introduced in DRGOS 1.2.

See Also
ip igmp snooping ip igmp robustness ip igmp proxy

59

ip igmp proxy
Context
interface-lan-configuration-root

Syntax
[no] ip igmp proxy <upstream interface> Enable L3 proxy and configure the upstream interface for IGMP traffic.

Description
The ip igmp proxy configuration command is used to control the interception of IGMP packets of configured upstream interface which operate on L3 mode. IGMP proxy should be used to allow the system to distribute multicast groups only to the L3 ports where there are active receivers of the groups. The IGMP proxy feature only supports IGMP version 2 and version 3 packets when it is enabled, All version 1 packets received will be silently dropped.

Example
drgos(config)# interface lan drgos(config-if-lan)# ip igmp proxy wan

Default
IGMP proxy is disabled by default.

History
This command was introduced in DRGOS 1.3.

See Also
ip igmp immediate-leave ip igmp robustness

60

Commands

ip igmp robustness
Context
interface-vlan-configuration-root interface-lan-configuration-root

Syntax
[no] ip igmp robustness <value> Configure IGMP snooping robustness

Description
The ip igmp robustness configuration command is used to set the IGMP robustness value. The robustness value is a way of indicating how susceptible the subnet is to lost packets. IGMP can recover from robustness variable minus 1 lost IGMP packets.

Example
drgos(config)# interface vlan6 drgos(config-if-vlan)# ip igmp snooping drgos(config-if-vlan)# ip igmp robustness 3

Default
IGMP snooping robustness is default set to 2.

History
This command was introduced in DRGOS 1.2. context changed in DRGOS 1.3 to also support lan.

See Also
ip igmp snooping ip igmp immediate-leave

61

ip igmp snooping
Context
interface-vlan-configuration-root

Syntax
[no] ip igmp snooping Configure IGMP snooping

Description
The ip igmp snooping configuration command is used to control the interception of IGMP packets of configured vlan on the interface which operate on L2 mode. IGMP snooping should be used to allow the system to distribute multicast groups only to the interfaces where there are active receivers of the groups. Otherwise, the system will act in a similar manner to a layer 2 switch and flood multicast groups to all switched interfaces. The IGMP snooping feature only supports IGMP version 2 and version 3 packets when it is enabled, All version 1 packets received will be silently dropped.

Example
drgos(config)# interface vlan4 drgos(config-if-vlan)# ip igmp snooping

Default
IGMP snooping is disabled by default for all vlans.

History
This command was introduced in DRGOS 1.1. The command context was changed to the vlan interface in DRGOS 1.2.

See Also
show ip igmp snooping ip igmp immediate-leave ip igmp robustness

62

Commands

ip name-server
Context
configuration-root

Syntax
[no] ip name-server <a.b.c.d> [source-interface <interface>] Configure a static DNS name server.

Description
The ip name-server configuration command is used to configure DNS servers. Multiple domain name servers can be configured. If multiple domain name servers are configured, DRGOS accepts the first authoritative answer received from any server. Optionally a source-interface may be specified to define which interface is used for queries sent to the specific name-server. If no source-interface is specified, the source routing table will be used to determine the source interface. These static name-servers are queried in conjunction with the name-servers which are dynamically learned on all interfaces. A statically defined name-server will take precedence over any learned name-server on the same interface.

Example
drgos(config)# ip name-server 192.168.1.2 drgos(config)# ip name-server 10.0.0.173 source-interface vlan10

Default
By default there are no statically configured name servers, only those dynamically learned by DHCP or PPPoE.

History
This command was introduced in DRGOS 1.1. This command was extended in DRGOS 1.5.1 to support setting the source-interface.

See Also
ip domain-name dhcp server option show ip name-server

63

ip nat external-interface
Context
interface-lan-configuration-root

Syntax
[no] ip nat external-interface <ifname> Configure the output interface for NAT traffic.

Description
The ip nat external-interface configuration command is used for NAT traffic and to define the output interface that is connected to public network. Network address translation (NAT) is the process of modifying network address information in IP headers for the purpose of remapping one IP address space into another.

Example
drgos(config)# interface lan drgos(config-if-lan)# ip nat external-interface vlan3

Default
No default external-interface is defined.

History
This command was introduced in DRGOS 1.2. DRGOS used wan as the default external-interface. From DRGOS 1.4, no default external-interface is defined.

See Also
ip nat forward

64

Commands

ip nat forward
Context
configuration-root

Syntax
[no] ip nat forward [ seq <1-2147483647> ] protocol <tcp | udp | both> port <port-list> destination-host {<a.b.c.d> | <hostname>} [ destination-port <destination-port-list> ] [ name <name> ] Configure the port mapping for NAT traffic.

Description
The ip nat forward configuration command is used to add or delete the port forwarding rules for external network traffic to be forwarded into the internal network. The port forwarding rules are ordered by the sequence number seq. The smaller the seq is, the higher priority the rule has. It is recommended to set the seq as the multiple of 10, e.g., 70, 80, 90, etc., so that a new rule can be inserted into rules in the future. If no sequence number is specified, the nearest even 10, counting from the highest previous sequence number, is used automatically. The protocol and port-list parameters define the traffic that will be forwarded. The destination-host and destination-port-list parameters define the destination to which the traffic will be sent. The port-list and destination-port-list parameters may contain single port, port range, and their combinations such as "80,8000,8080-8089". The protocol parameter could be tcp, udp, or both. both means both TCP and UDP protocols. The destination-port-list is an optional parameter. If it is not specified, it will be set to the same value as defined in port-list.

Remapping of port ranges is not supported. Therefore if remapping is required, destination-portlist must only contain a port, or list of ports. If destination-port-list is specified and both port-list and destination-port-list only contains single ports, the number of ports in destination-port-list must match the number of ports in the port-list. For example, with the command ip nat forward seq 110 protocol udp port 80,2032-2033 destination-host 192.168.1.181, a new rule with the sequence number of 110 will be added to the NAT, and the NAT will forward any UDP packets hat are received on port 80, or 2032 - 2033, to the corresponding port of the host 192.168.1.181. The no ip nat forward command deletes the port mapping rules. There are two ways to delete a rule: to specify the seq, or to specify the protocol and port-list. In both cases, only the rule which exactly matches the seq or protocol and port-list is deleted. If no rule matches the specified parameter, delete operation will be failed. In the deleting case, the destination-host and destination-port-list parameters are ignored.

Example
drgos(config)# ip nat forward seq 150 protocol tcp port 10080,18000,18080 destination-host 192.168.1.181 destination-port 80,8000,8080 name webserver drgos(config)# ip nat forward protocol both port 2022 destination-host 192.168.1.32 destination-port 22 name "ssh server"

65

drgos(config)# no ip nat forward seq 190 drgos(config)# no ip nat forward protocol both port 5060

Default
By default there are no port mappings defined.

History
This command was introduced in DRGOS 1.4.

See Also
ip nat external-interface

66

Commands

ip route
Context
configuration-root

Syntax
[no] ip route {<a.b.c.d>/m|<a.b.c.d> <m.m.m.m>} <a.b.c.d> Configure system static route

Description
The ip route configuration command creates a static IP route in the system. The route is configured as ip route <target> <gateway>. The target is either specified as a network/prefix or with the old-style network-subnetmask dot notation. The 0.0.0.0/0 target represents a default route entry. The gateway specifies the IP address of the next hop gateway towards the destination. All the static routes are bound to WAN interfaces.

Example
drgos(config)# ip route 202.119.49.65/24 172.19.36.9 drgos(config)# ip route 221.232.119.49 255.255.255.0 172.19.36.2

Default
There are no default static routes. Routes may also be added by a DHCP client (when "ip address dhcp" is configured on an interfaces), these routes will not be shown in the running configuration but will be shown by the show ip route command.

History
This command was introduced in DRGOS 1.1.

See Also
show ip route

67

ip upnp
Context
configuration-root

Syntax
[no] ip upnp Enable the UPnP service.

Description
The ip upnp configuration command is used to enable or disable the UPnP (Universal Plug-n-Play) service of drgos. The UPnP service is designed to work on small NATed LANs. A domestic network with one wireless router and a few devices with private IP addresses. The service is provided on the routers LAN interface, which is connected to the private network. The clients in private network multicast their port mapping requests, and the router receives the requests, then it automatically allocates port mapping for the clients.

Example
drgos(config)# ip upnp

Default
By default the UPnP is disabled.

History
This command was introduced in DRGOS 1.2.

See Also
ip upnp source-interface ip upnp lan-interface ip nat external-interface

68

Commands

ip upnp lan-interface
Context
configuration-root

Syntax
[no] ip upnp lan-interface <interface> Configure lan interface for UPnP service.

Description
The ip upnp lan-interface configuration command is used to set the LAN side interface connecting the internal network on which UPnP service will listen the internal clients' UPnP port mapping requests.

Example
drgos(config)# ip upnp lan-interface lan

Default
By default there is no lan-interface specified for UPnP, the DRGOS will auto select lan as lan-interface when UPnP enabled.

History
This command was introduced in DRGOS 1.2.

See Also
ip upnp ip upnp source-interface ip nat external-interface

69

ip upnp source-interface
Context
configuration-root

Syntax
[no] ip upnp source-interface <interface> Configure source interface for UPnP service.

Description
The ip upnp source-interface configuration command is used to define the interface connected to the public network on which UPnP service will work. The UPnP daemon will map the IP and port of local clients to this interface according to the clients' port mapping requests.

Example
drgos(config)# ip upnp source-interface vlan100

Default
By default there is no source-interface specified for UPnP, the DRGOS will auto select ip nat external-interface or wan interface as source-interface when UPnP enabled.

History
This command was introduced in DRGOS 1.2.

See Also
ip upnp ip upnp lan-interface ip nat external-interface

70

Commands

jitter-buffer
Context
voice-configuration-root

Syntax
[no] jitter-buffer mode {adaptive|fixed} [no] jitter-buffer auto-switch [no] jitter-buffer duration {adaptive|fixed} <buffer-length> Configure jitter buffer for voice service.

Description
The jitter-buffer configuration commands are used to configure the jitter buffer mode for all voice lines. The jitter buffer is designed to remove the effects of jitter from the decoded voice stream, buffering each arriving packet for a short interval before playing it out. This substitutes additional delay and packet loss due to discarded late packets for jitter. The "fixed" jitter buffer maintains a constant duration whereas the "adaptive" jitter buffer has the capability to adjust its duration dynamically in order to optimize the delay/discard tradeoff. The jitter-buffer mode command is used to select the jitter buffer mode. The factory default jitter-buffer configuration is in "adaptive" mode. The jitter-buffer duration command is used to set the buffer size in "fixed" mode, and maximum buffer size in "adaptive" mode. The upper limit of the buffer size is 200ms for "fixed" mode, and 300ms for "adaptive" mode. The default buffer duration is 40ms for "fixed" mode, and 100ms for "adaptive" mode. For fax service, jitter buffer can auto-switch to fixed mode when modem tones are detected. The jitter-buffer auto-switch configuration command is used to enable/disable this auto-switch.

Example
drgos(config)# voice drgos(config-voice)# jitter-buffer mode fixed drgos(config-voice)# jitter-buffer duration adaptive 200 drgos(config-voice)# jitter-buffer auto-switch

Default
By default the factory jitter buffer is in "adaptive" mode. The default buffer duration is 40ms for "fixed" mode, and 100ms for "adaptive" mode. The "auto-switch" feature is disabled by default.

History
This command was introduced in DRGOS 1.1.

71

logging server
Context
configuration-root

Syntax
[no] logging server {<hostname> | <a.b.c.d>} [port <1-65535>] Configure remote logging

Description
The logging server configuration command can be used to specify a remote host as a remote logging server. Either a hostname or IP address can be specified. The default port of the remote logging server is the standard UDP port 514 for syslog. A different UDP port can be specified by using port option.

Example
drgos(config)# logging server syslog.packetfront.com drgos(config)# logging server 192.168.1.2 port 1000

Default
This command has no default value. If not configured, DRGOS only generates local logs.

History
This command was introduced in DRGOS 1.5.1.

See Also
show logging

72

Commands

ls
Context
executable-root

Syntax
ls List files on flash

Description
The ls command lists files on the file system. Firmware images and some debug files, e.g. log and core files, are shown.

Example
drgos# ls 9362442 Nov 22 2010 drgos-drg700-1.3.1-R.img 8530577 Jan 1 00:11 drgos-drg700-1.4.1-RC02.img 978115 Jan 1 02:11 sipapp.log

History
This command was introduced in DRGOS 1.1. From DRGOS 1.4, the command will include debug files if present.

See Also
boot system

73

management source-interface
Context
configuration-root

Syntax
[no] management source-interface <interface> Configure management source-interface

Description
The management source-interface configuration command sets the default interface to be used for management traffic, for example ntp, http/tftp (copy command) and ping. Many protocols and functions have their own source-interface configuration commands, for example snmp agent source-interface and cwmp source-interface. For those protocols and functions these configuration commands (or their default values) will control what source interface will used.

Example
drgos(config)# management source-interface vlan100

Default
The default management source interface is wan.

History
This command was introduced in DRGOS 1.2.

See Also
snmp agent source-interface cwmp source-interface voip signaling source-interface voip media source-interface ip upnp source-interface

74

Commands

media
Context
interface-lan-ethernet-configuration-root

Syntax
[no] media {auto|1000-full|100-full|100-half|10-full|10-half} Configure interface transmission speed and duplex mode

Description
The media configuration command configures the media settings on the selected interface. Available command options depend on the type of interface configured. The 10-full, 10-half, 100-full, 100-half and 1000-full keywords configures half or full duplex operation at 10, 100 or 1000 Mbit/s. The auto keyword enables interface auto-negotiation for media settings. According to IEEE802.3, if auto negotiation is enabled on one side of a link but the other side has a fixed setting with full-duplex, the link will not become operational and CRC errors will be seen on the full-duplex interface.

Example
drgos(config)# interface lan/ethernet1 drgos(config-if-lan-eth)# media auto

Default
The default for all interfaces is auto.

History
This command was introduced in DRGOS 1.3.

75

next-server
Context
class-configuration-root client-configuration-root

Syntax
[no] next-server <a.b.c.d> Configure the siaddr for DHCP server

Description
The next-server is used to configure the siaddr on DHCP. The siaddr is a standard field in DHCP header. It specifies the address of the server to use in the next step of the clients bootstrap process.

Example
drgos(class-config)# next-server 172.19.33.8 drgos(class-config)# no next-server

Default
The default value is the DHCP servers own address.

History
This command was introduced in DRGOS 1.3.2

See Also
dhcp server class dhcp server client dhcp option

76

Commands

notify
Context
snmp-group-configuration-root

Syntax
[no] notify {<a.b.c.d>|<hostname>} community <name> trap Configure SNMP version 1 notifications [no] notify {<a.b.c.d>|<hostname>} community <name> {inform|trap} Configure SNMP version 2c notifications

Description
The notify configuration command is used to specify the IP address or hostname of a remote host to which the DRGOS should send notification messages. For SNMP version 1 and version 2c these are also commonly known as SNMP trap messages. For SNMP version 1 a community name must be configured for the notification messages. For SNMP version 2c a community name must be configured for the notification messages. The notification can be of either trap or inform message type.

Example
drgos(config)# snmp-group drgos(config-snmp-group)# drgos(config)# snmp-group drgos(cofnig-snmp-group)# version 1 notify 192.168.1.11 community public trap version 2c notify 192.168.4.1 community private inform

Default
The default SNMP notification type is trap, and the default UDP port is 162 for version 1 and 2c.

History
This command was introduced in DRGOS 1.2.

See Also
community

77

ping
Context
executable-root

Syntax
ping { <hostname> | <a.b.c.d> } [count <1-65535>] [size <64-32768>] Send ICMP echo request to a remote host.

Description
The ping command can be used to test network connectivity on IP level between the current DRGOS system and a target. The ping command operates by sending ICMP echo request packets. A working TCP/IP stack will respond with ICMP echo reply packets. If reply packets are received from the target, the network segments and routers in between the current system and the target are capable of IP packet forwarding. ICMP messages may be filtered by firewalls and other network devices, which means that if the ping attempt is unsuccessful, the cause might be something other than a broken network connection or router. Once completed the ping command present statistics for the session, indicating the number of packets sent and received and a percentage of the number of packets lost. The minimum, average and maximum packet round trip is measured and presented. The ping command may be interrupted by the CTRL-C key. If a hostname is specified, ping will try to resolve the hostname using the configured ip name server and ip domain name. Optional command line options include count which sets the number of ICMP echo packets to transmit and size which sets the packet size.

History
This command was introduced in DRGOS 1.1.

See Also
ip icmp-echo

78

Commands

pppoe acname
Context
interface-wan-configuration-root interface-lan-configuration-root interface-vlan-configuration-root

Syntax
[no] pppoe acname <name> Set PPPoE access concentrator name.

Description
The pppoe acname configuration command is used to set the name of the AC (access concentrator) providing the PPPoE service. Any responses from ACs not matching the configured acname are ignored. The interface ip address must be set to "ip address pppoe" for this command to have any effect. AC names containing spaces must be quoted with double quotes (").

Example
drgos(config)# interface wan drgos(config-if-wan)# ip address pppoe drgos(config-if-wan)# pppoe acname "access concentrator 1"

Default
There are no default values for the pppoe acname configuration command.

History
This command was introduced in DRGOS 1.2.

See Also
ip address pppoe username pppoe service

79

pppoe service
Context
interface-wan-configuration-root interface-lan-configuration-root interface-vlan-configuration-root

Syntax
[no] pppoe service <name> Set PPPoE service name.

Description
The pppoe service configuration command is used to set the desired service name. pppoe will only initiate sessions with access concentrators which can provide the specified service. The interface ip address must be set to "ip address pppoe" for this command to have any effect. Service names containing spaces must be quoted with double quotes (").

Example
drgos(config)# interface wan drgos(config-if-wan)# ip address pppoe drgos(config-if-wan)# pppoe service "service 1"

Default
There are no default values for the pppoe service configuration command.

History
This command was introduced in DRGOS 1.2.

See Also
ip address pppoe username pppoe acname

80

Commands

pppoe username
Context
interface-wan-configuration-root interface-lan-configuration-root interface-vlan-configuration-root

Syntax
[no] pppoe username <username> passsword <password> Set PPPoE username and password.

Description
The pppoe username configuration command is used to set the username and password to be used when the interface address is set to pppoe. The interface ip address must be set to "ip address pppoe" for this command to have any effect. Usernames and passwords containing spaces must be quoted with double quotes (").

Example
drgos(config)# interface wan drgos(config-if-wan)# ip address pppoe drgos(config-if-wan)# pppoe username user1234 password "password for user1234"

Default
There are no default values for the pppoe username configuration command.

History
This command was introduced in DRGOS 1.2.

See Also
ip address

81

quit
Context
executable-root

Syntax
quit Logout from system

Description
The quit command terminates the current session. When connected with an SSH connection, the connection is closed. When connected on the management port, the session is terminated and the login prompt is displayed again.

Example
drgos# quit Connection to 192.168.1.254 closed.

History
This command was introduced in DRGOS 1.1.

82

Commands

reload
Context
executable-root

Syntax
reload [ in <0-2147483647> ] Reload the system reload cancel Cancel a pending reload

Description
The reload command is used to restart DRGOS and the system. The in keyword can be used to set the delay between the command execution and the actual restart of DRGOS. The reload cancel command cancels any pending reload of the system. At the next restart the image specified with the boot system configuration command will be started.

Example
drgos# reload in 300 System will be reloaded in 300 seconds! drgos# reload Reboot the system. Are you sure [y/N]? y Rebooting system

History
This command was introduced in DRGOS 1.1.

83

ring-signal cadence
Context
voice-line-configuration-root

Syntax
[no] ring-signal cadence <index> <cadence-value> Sets one entry of the ring cadence table for selected voice line.

Description
The ring-signal cadence configuration command sets the ring cadence table for one voice line. There is a ring cadence table for each line. The cadence-value parameter describes the cadence value of the cadence table. The initial values for each entries in the table are: 1: "on(1000),off(4000),r", Distinct Ringing 1, the primary cadence 2: "on(1000),off(3000),r", Distinct Ringing 2 3: "on(800),off(400),on(800),off(4000),r", Distinct Ringing 3 4: "on(400),off(200),on(400),off(200),on(800),off(4000),r", Distinct Ringing 4 5: "on(800),off(1000),on(400),off(50),on(400),off(3000),r", Distinct Ringing 5 6: "on(500),off(100),r", Distinct Ringing 6 7: "on(1000),off(1000),r", Distinct Ringing 7 8: "on(0),off(0),r", Distinct Ringing 8, no cadence 9: "on(1000),off(20),r", Distinct Ringing 9, Ring Splash 1 10: "on(500),off(20),r", Distinct Ringing 10, Ring Splash 2 11: "on(300),off(400),r", CCBS Ringing, Ring Call Alert The "language" for specifying the ring cadence pattern format is summarized by the following ABNF: Timeval ::= time in milliseconds Repeatval ::= # of cycles to repeat OnOff ::= "on" | "off" Repeat ::= "r" Active ::= OnOff "(" Timeval ")" Sequence ::= Active *("," Active) Repetition ::= "[" Sequence "]" Repeatval Cycle ::= Sequence | Repetition Cadence ::= Cycle *("," Cycle) ["," Repeat]

84

Commands

Example: on(200),off(300),on(100),off(400),on(200),idle(4000),r
200ms 100ms 200ms 200ms 100ms 200ms ##### ### ##### ##### ### ##### # # # # # # # # # # # # # #300 # #400ms # # 4000ms # #300 # #400ms # # 4000ms #### ###### ######## ##################### ###### ######## ####### ^ ^ |<--------------- cycle ----------------->|

NB that the cadence-value parameter support a maximum of 4 ring pulse durations per cadence.

Example
drgos(config)# voice line 1 drgos(config-voice-line)# ring-signal cadence 2 on(1000),off(3000),r drgos(config-voice-line)# no ring-signal cadence 4

Default
If not configured, the ring cadence is determined by the selected voice country value.

History
This command was introduced in DRGOS 1.2.

See Also
country ring-signal voltage ring-signal frequency

85

ring-signal frequency
Context
voice-line-configuration-root

Syntax
[no] ring-signal frequency <16 | 20 | 25 | 50> Sets the frequency of the ring signal for selected voice line.

Description
The ring-signal frequency configuration command sets the frequency value of ring for one voice line. There are four frequency values supported: 16, 20, 25, 50. The units are Hz. When 16Hz is selected, the actual frequency used is 16.66Hz.

Example
drgos(config)# voice line 1 drgos(config-voice-line)# ring-signal frequency 20

Default
If not configured, the ring frequency is determined by the selected voice country value.

History
This command was introduced in DRGOS 1.2.

See Also
country ring-signal cadence ring-signal voltage

86

Commands

ring-signal voltage
Context
voice-line-configuration-root

Syntax
[no] ring-signal voltage <voltage-value> Sets the ring signal voltage for selected voice line.

Description
The ring-signal voltage configuration command sets the ring signal voltage for the voice line. The voltage-value parameter may take a value in the range 40 to 110. The units are Vrms.

Example
drgos(config)# voice line 1 drgos(config-voice-line)# ring-signal voltage 55

Default
If not configured, the ring voltage is determined by the selected voice country value.

History
This command was introduced in DRGOS 1.2.

See Also
country ring-signal cadence ring-signal frequency

87

rtp port-range
Context
voice-configuration-root

Syntax
[no] rtp port-range <start-port> <end-port> Set the port range used by RTP transmission.

Description
The rtp port-range configuration command is used to set the port range which is used for RTP transmission. The port range is a set of contiguous UDP ports specially allocated for RTP transmission. The range is identified by the start port and end port, and both the start port and the end port are included. The minimum size of the port range is 16 UDP ports. Default RTP port range is 16 UDP ports from 8000 to 8015.

Example
drgos(config)# voice drgos(config-voice)# rtp port-range 8300 8320

Default
Default RTP port range is 16 UDP ports from 8000 to 8015.

History
This command was introduced in DRGOS 1.1.

88

Commands

rxgain
Context
voice-line-configuration-root

Syntax
[no] rxgain <gain-value> Sets the receiving gain value.

Description
The rxgain configuration command sets the receiving gain value, i.e. the gain from the packet network towards analogue line. The gain-value value ranges from -12 dB to +6 dB.

Example
drgos(config)# voice line 1 drgos(config-voice-line)# rxgain -1

Default
The default receiving gain value is -3 dB.

History
This command was introduced in DRGOS 1.2.

See Also
txgain

89

service
Context
interface-wan-configuration-root interface-lan-configuration-root interface-vlan-configuration-root

Syntax
[no] service <service-name> Set service for current interface.

Description
The service configuration command is used to indicate a service name for the interface. If the interface uses DHCP to receive an IP address, then the indicated service name will be appended to the DHCP vendor- class-identifier (option 60) field generated by the DHCP client. This permits the DHCP server to associate the client context with the specified service. BECS uses the information provided in the service value to associate specific services to the interface context. Becs requires that the management service interface is indicated using service management command as shown below.

Example
drgos(config)# interface vlan100 drgos(config-if-vlan)# service nat drgos(config)# interface vlan100/1 drgos(config-if-vlan)# service management

Default
There are no default values for the service configuration command.

History
This command was introduced in DRGOS 1.3.

See Also
show interface ip address

90

Commands

show access-list
Context
root

Syntax
show access-list [ <name> ] Show configured access-lists.

Description
The show access-list command displays the currently configured access-lists in the system. In the first line of the result, the number of entries and the number of hits of the implicit deny are displayed. For each entry in the list, the number of packets that have matched the entry is also displayed. If name is specified, only the specified access-list is displayed, otherwise all access-lists are displayed.

Example
drgos# show access-list my-acl Access-list my-acl (2 entries, 5 implicit denies) seq 10 deny ip 192.168.1.0/24 (2 hits) seq 20 permit ip any any (250 hits)

Default
This command has no default value.

History
This command was introduced in DRGOS 1.4.

See Also
access-list access-list clear-counters ip access-group

91

show arp
Context
executable-root

Syntax
show arp Display the system ARP table

Description
The show arp command display the system address resolution table. It shows all currently known local hosts, their IP address and MAC address, on which interface the host is known to be connected.

Example
drgos# show arp IP address 192.168.2.226 172.19.41.1 172.19.41.252 HW type 0x1 0x1 0x1 Flags 0x2 0x2 0x2 HW address 00:A0:C9:BA:C9:90 00:04:A7:08:67:29 00:16:76:D9:A3:80 Mask * * * Device lan wan wan

History
This command was introduced in DRGOS 1.1.

92

Commands

show boot
Context
executable-root

Syntax
show boot Display the current boot image

Description
The show boot command display which file on the flash that is the current system boot image. This may be different from the currently running image if the boot image has been changed by the boot system configuration command. The file indicated will be used as boot image when the system is next restarted.

Example
drgos# show boot boot=drgos-drg700-1.3.1-R

History
This command was introduced in DRGOS 1.1.

See Also
copy boot system

93

show catv
Context
executable-root

Syntax
show catv Show CATV status

Description
The show catv command shows the status of the CATV RF Overlay status.

Example
drgos# show catv catv Administratively enabled Filter present: disabled CATV signal present, optical power -1.358 dBm

History
This command was introduced in DRGOS 1.2.

See Also
catv enable catv filter

94

Commands

show clock
Context
executable-root

Syntax
show clock [monotime] Display the system time

Description
The show clock command displays the current time and date of the system. The monotime keyword displays the time in seconds and milliseconds since the system started.

Example
drgos# show clock Tue Jul 06 16:35:55 2010 UTC drgos# show clock monotime 11297.45

History
This command was introduced in DRGOS 1.2.

95

show controllers switch interface


Context
executable-root

Syntax
show controllers switch interface [ cpu-lan | cpu-wan | wan ] Display traffic statistics of low-level switch hardware interfaces in the system.

Description
The show controllers switch interface command is used to display traffic statistics of low-level switch hardware interfaces in the system. By default, the command displays traffic statistics of all switch interfaces, including "cpu-lan", "cpu-wan" and "wan". It can display a specific interface by giving the interface name.

Example
drgos# show controllers switch-interface port WAN statistics: 0 packets input, 0 bytes, 0 input errors 0 input queue drops, 0 unknown protocols 0 broadcasts, 0 multicasts, 0 pause 0 runts, 0 oversized, 0 CRC 0 jabbers, 0 fragments, 0 symbol 0 aligment 95203 packets output, 42650944 bytes, 0 output errors 0 output queue drops 95203 broadcasts, 0 multicasts, 0 pause 0 collisions, 0 deferred port CPU_WAN statistics: 95228 packets input, 42659188 bytes, 0 input errors 0 input queue drops, 0 unknown protocols 95220 broadcasts, 8 multicasts, 0 pause 0 runts, 0 oversized, 0 CRC 0 jabbers, 0 fragments, 0 symbol 0 aligment 0 packets output, 0 bytes, 0 output errors 0 output queue drops 0 broadcasts, 0 multicasts, 0 pause 0 collisions, 0 deferred port CPU_LAN statistics: 64 packets input, 5342 bytes, 0 input errors 0 input queue drops, 0 unknown protocols 0 broadcasts, 20 multicasts, 0 pause 0 runts, 0 oversized, 0 CRC 0 jabbers, 0 fragments, 0 symbol 0 aligment 341 packets output, 34586 bytes, 0 output errors 0 output queue drops 33 broadcasts, 11 multicasts, 0 pause 0 collisions, 0 deferred drgos# show controllers switch-interface cpu-wan port CPU_WAN statistics: 95192 packets input, 42643060 bytes, 0 input errors 0 input queue drops, 0 unknown protocols 95184 broadcasts, 8 multicasts, 0 pause 0 runts, 0 oversized, 0 CRC 0 jabbers, 0 fragments, 0 symbol 0 aligment 0 packets output, 0 bytes, 0 output errors 0 output queue drops 0 broadcasts, 0 multicasts, 0 pause 0 collisions, 0 deferred

96

Commands

History
This command was introduced in DRGOS 1.4.

See Also
show interface show processes show memory

97

show cwmp status


Context
executable-root

Syntax
show cwmp status [verbose] [lines <lines>] Show CWMP status.

Description
The show cwmp status configuration command is used to show the status information of CWMP (CPE WAN Management Protocol). The CWMP status includes Sessions, RPCs, Connection Request, etc. By default, the command will briefly display some important log entries. If user wants to display more detail status information, the optional argument "verbose" can be used. By default, the command only displays last 20 lines of the status information. If user wants to display more or less number of lines, the optional argument "lines" can be used to specify the expected number of lines. The maximum number of the lines is limited to 500 lines.

Example
drgos# drgos# drgos# drgos# show show show show cwmp cwmp cwmp cwmp status status lines 10 status verbose status verbose lines 100

History
This command was introduced in DRGOS 1.2.

See Also
cwmp enable cwmp acs server cwmp acs username cwmp client username cwmp interval

98

Commands

show dhcp server clients


Context
executable-root

Syntax
show dhcp server clients Display DHCP server clients

Description
The show dhcp server clients command is used to display information about DHCP server clients. The client information includes the IP address, MAC address, hostname and lease expiry time. Some information, e.g. hostname, may not be present if not provided by the client.

Example
drgos# show dhcp server clients Client MAC address Hostname Expires --------------------------------------------------------------------------------172.19.81.170 0014.c2e7.24ca foobar Sat Feb 26 02:36:12 UTC 2011

History
This command was introduced in DRGOS 1.4.

See Also
show dhcp server lease show memory show processes show sockets

99

show dhcp server lease


Context
executable-root

Syntax
show dhcp server lease [ [ ip <a.b.c.d> ] | [ mac <mac-addr> ] ] Display DHCP server lease information

Description
The show dhcp server lease command is used to display DHCP server lease information. By default the command displays information about all DHCP leases. It is also possible to display information about a specific lease by specifying the IP or MAC address.

Example
drgos# drgos# drgos# drgos# show show show show dhcp dhcp dhcp dhcp server server server server lease lease mac 00:17:a4:e2:1f:a0 lease mac 0017.a4e2.1fa0 lease ip 172.19.81.1

History
This command was introduced in DRGOS 1.4.

See Also
show dhcp server clients show memory show processes show sockets

100

Commands

show history
Context
executable-root

Syntax
show history [configuration] Display the content of the command history buffer.

Description
The show history command displays a list of recently entered commands. There are two separate history lists, one for executable root context and one for configuration context. If configuration is specified the history from configuration context will be shown otherwise the history from executable root context will be shown. The command history is stored per session.

Example
drgos# show history 000 sh ver 001 show ip route 002 conf t 003 show history drgos# show history conf 000 interface lan 001 ip address 192.168.3.254/24 002 no shutdown 003 end drgos#

History
This command was introduced in DRGOS 1.2.

101

show interface
Context
executable-root

Syntax
show interface [<interface>] Display information about the system interfaces

Description
The show interface command display information about physical and logical interfaces in the system. Information displayed include hardware (HWaddr) and ip (inet and inet6) addresses (if any) on the interface and the status of the interface. In addition counters for packets and bytes sent and received on the interface is displayed. The counters include error counters to indicate bad packets sent or received. For configurable interfaces, the transmission speed and duplex mode are displayed for both administrative and operational state. The type of interface determine additional information.

Example
drgos# show interface wan Link encap:Ethernet HWaddr 00:0F:5D:20:00:10 inet6 addr: fe80::20f:5dff:fe20:10/64 Scope:Link UP BROADCAST RUNNING MULTICAST MTU:1500 Metric:1 RX packets:9282 errors:0 dropped:0 overruns:0 frame:0 TX packets:23 errors:0 dropped:0 overruns:0 carrier:0 collisions:0 txqueuelen:1000 RX bytes:672479 (656.7 KiB) TX bytes:2884 (2.8 KiB) Interrupt:53 lan Link encap:Ethernet HWaddr 00:0F:5D:20:00:11 inet addr:172.19.36.72 Bcast:172.19.36.255 Mask:255.255.255.0 inet6 addr: fe80::200:ff:fe00:0/64 Scope:Link UP BROADCAST RUNNING MULTICAST MTU:1500 Metric:1 RX packets:59 errors:0 dropped:0 overruns:0 frame:0 TX packets:27 errors:0 dropped:0 overruns:0 carrier:0 collisions:0 txqueuelen:0 RX bytes:3827 (3.7 KiB) TX bytes:3006 (2.9 KiB)

lan/ethernet1 is administratively up, line protocol is up Duplex auto (half), Speed auto (10) 504651 packets input, 52075744 bytes, 0 input errors 0 input queue drops, 0 unknown protocols 400588 broadcasts, 72932 multicasts, 0 pause 0 runts, 0 oversized, 0 CRC 0 jabbers, 0 fragments, 0 symbol 0 aligment 31085 packets output, 2012389 bytes, 0 output errors 0 output queue drops 14 broadcasts, 40 multicasts, 0 pause 0 collisions, 0 deferred

History
This command was introduced in DRGOS 1.1.

102

Commands

show ip igmp forwarding


Context
executable-root

Syntax
show ip igmp forwarding Displays the current active forwarding table in the kernel.

Description
The show ip igmp forwarding command displays information about the forwarding of multicast groups. The ingress interface is displayed for each source and group. The current traffic rate and a list of egress interfaces to which the group is forwarded is also listed.

Example
drgos# show ip igmp forwarding (10.90.159.10, 239.90.2.12) upstream vlan4 Downstream: lan (IGMP snooped) (Hardware switched) Joined: lan/ethernet1

History
This command was introduced in DRGOS 1.3.

See Also
ip igmp snooping

103

show ip igmp snooping


Context
executable-root

Syntax
show ip igmp snooping Show igmp snoop information

Description
The show ip igmp snooping command displays the vlan, group address, snooping interface, and all snooped local receivers.

Example
drgos# show ip igmp snooping VID Group Snooped interface Age 0 239.10.10.10 lan/ethernet1

MisRprt

Reporter Sources

Version

Mode

0m 8s

1.1.1.1 V3 exclude: 3.3.3.3

L2

History
This command was introduced in DRGOS 1.1.

See Also
ip igmp snooping

104

Commands

show ip igmp snooping aggregation


Context
executable-root

Syntax
show ip igmp snooping aggregation Show details of igmp aggregation (V3)

Description
The show ip igmp snooping aggregation command displays the summarized V3 state of a group within a vlan.

Example
drgos# show ip igmp snooping aggregation VID Group Sources 0 239.10.10.10 include: 3.3.3.3 include: 4.4.4.4 include: 5.5.5.5

History
This command was introduced in DRGOS 1.3.

See Also
ip igmp snooping

105

show ip igmp statistics


Context
executable-root

Syntax
show ip igmp statistics Show details of igmp statistics

Description
The show ip igmp statistics command displays internal status of traffic counters.

Example
drgos# show ip igmp statistics 30 igmp packets input 5 igmpv2 reports, 5 igmpv2 leaves 5 igmpv3 reports, 5 igmpv3 leaves 5 unknown, 5 invalid 30 igmp packets output 5 igmpv2 reports, 5 igmpv2 leaves 5 igmpv3 reports, 5 igmpv3 leaves 5 general query, 5 specific query

History
This command was introduced in DRGOS 1.3.

See Also
ip igmp snooping

106

Commands

show ip name-server
Context
executable-root

Syntax
show ip name-server Display the current DNS resolver name-server usage.

Description
The show ip name-server command is used to view the current DNS resolver name-server, interface and domain related information.

Example
drgos# show ip name-server interface name-server vlan100 172.18.76.2 vlan200 10.70.1.77 vlan300 230.50.19.88 threehundred.example.org domain twohundred.example.com threehundred.example.com,

History
This command was introduced in DRGOS 1.5.1.

See Also
ip name-server

107

show ip route
Context
executable-root

Syntax
show ip route Show system routing table

Description
The show ip route command display the system routing table. The system routing table consist of routes known by different routing protocols, static routes and connected subnets.

Example
drgos# show ip route Kernel IP routing table Destination Gateway 10.126.30.0 0.0.0.0 192.168.1.0 0.0.0.0 10.126.3.0 0.0.0.0 0.0.0.0 10.126.3.1 0.0.0.0 10.126.30.1 drgos#

Genmask 255.255.255.0 255.255.255.0 255.255.255.0 0.0.0.0 0.0.0.0

Flags U U U UG UG

Metric 1 1 0 0 1

Ref 0 0 0 0 0

Use 0 0 0 0 0

Iface vlan100 lan wan wan vlan100

History
This command was introduced in DRGOS 1.1. Output changed in DRGOS 1.2 to include metric.

See Also
ip route

108

Commands

show logging
Context
executable-root

Syntax
show logging [ facility <facility> ] [ level <level> ] Display the system log.

Description
The show logging command displays all system log entries at level "notifications" and above by default. Each line is prefixed by a time stamp, facility, level, process or user followed by the log message. It is possible to display facility specific log by using the optional "facility" argument. The logging facilities include:
auth authpriv cron daemon ftp kern local0 local1 local2 local3 local4 local5 local6 local7 lpr mail news syslog user uucp Authorization system Private authorization system Cron/at facility System daemons FTP daemon Kernel Local use Local use Local use Local use Local use Local use Local use Local use Line printer system Mail system USENET news Syslog itself User process Unix-to-Unix copy system

The following local facilities are reserved for some internal applications: local0 Reserved for local SIP application. local1 Reserved for local CWMP application (DSL Forum TR069). local2 Reserved for local Firewall application. It is possible to display log entries of specific level and above by using "level" argument. The logging levels include:
emergencies alerts critical errors warnings notifications informational debugging System is unusable (level 0) Immediate action needed (level 1) Critical conditions (level 2) Error conditions (level 3) Warning conditions (level 4) Normal but significant conditions (level 5) Informational messages (level 6) Debugging messages (level 7)

The "emergencies" is the highest level (level 0), and reversely the "debugging" is the lowest level (level 7). And the default log level is "notifications".

Example
drgos# show logging drgos# show logging facility user drgos# show logging level informational

109

drgos# show logging facility daemon level warnings

History
This command was introduced in DRGOS 1.1. The "facility" and "level" arguments were added in DRGOS 1.4.

See Also
test logging

110

Commands

show mac-address-table
Context
executable-root

Syntax
show mac-address-table Displays the current MAC address forwarding table

Description
The show mac-address-table command display a list of all MAC addresses currently learnt from the MAC forwarding table for each Layer 2 interface.

Example
drgos# show mac-address-table MAC-Address Vlan Flags Port -----------------------------------------00:04:a7:08:67:29 100 0 wan 00:14:6c:eb:a2:f1 100 0 wan 00:16:76:d9:a3:80 100 0 wan 00:a0:c9:ba:c9:90 0 0 lan/ethernet1 00:00:00:42:01:00 0 0 lan/ethernet2 00:00:00:43:01:00 0 0 lan/ethernet3

History
This command was introduced in DRGOS 1.2.

See Also
clear mac-address-table

111

show memory
Context
executable-root

Syntax
show memory Display amount of free and used memory in the system.

Description
The show memory command is used to display amount of free and used memory in the system.

Example
drgos# show memory total Mem: 118944 Swap: 0 Total: 118944 used 50928 0 50928 free 68016 0 68016 shared 0 buffers 0

History
This command was introduced in DRGOS 1.4.

See Also
show processes show sockets

112

Commands

show processes
Context
executable-root

Syntax
show processes Show a snapshot of all current processes.

Description
The show processes command is used to show a snapshot of all current processes.

Example
drgos# show processes PID USER VSZ STAT COMMAND 1 root 1104 S init 2 root 0 SWN [ksoftirqd/0] 3 root 0 SW [watchdog/0] 4 root 0 SW< [events/0] 5 root 0 SW< [khelper] 6 root 0 SW< [kthread] 33 root 0 SW< [kblockd/0] 37 root 0 SW< [khubd] 54 root 0 SW [pdflush] 55 root 0 SW [pdflush] 56 root 0 SW< [kswapd0] 57 root 0 SW< [aio/0] 102 root 0 SW [mtdblockd] 315 root 1116 S -ash 657 root 1552 S /sbin/ma 666 root 1164 S /sbin/syslogd -C64 -m 0 677 root 1096 S klogd 680 root 1096 S klogd 733 root 556 S /sbin/hotplug2 --override --persistent --max-children 976 root 612 S /usr/sbin/watchdog 1210 root 1460 S msconfig bg 1306 root 1608 S /usr/bin/cmm -f /etc/config/fastforward 1311 root 1608 S /usr/bin/cmm -f /etc/config/fastforward 1318 root 1608 S /usr/bin/cmm -f /etc/config/fastforward 1320 root 1608 S /usr/bin/cmm -f /etc/config/fastforward 1321 root 1608 S /usr/bin/cmm -f /etc/config/fastforward 1322 root 1608 S /usr/bin/cmm -f /etc/config/fastforward 1323 root 1608 S /usr/bin/cmm -f /etc/config/fastforward 1324 root 1608 S /usr/bin/cmm -f /etc/config/fastforward 1325 root 1608 S /usr/bin/cmm -f /etc/config/fastforward 1326 root 1608 S /usr/bin/cmm -f /etc/config/fastforward 1327 root 1608 S /usr/bin/cmm -f /etc/config/fastforward 2602 root 1108 S /bin/sh /bin/wanHunter.sh 3061 root 1488 S /usr/bin/unetlink 3066 root 3980 S /usr/sbin/snmpd -Lf /dev/null -p /var/run/snmpd.pid 3101 root 3980 S /usr/sbin/snmpd -Lf /dev/null -p /var/run/snmpd.pid 3102 root 3980 S /usr/sbin/snmpd -Lf /dev/null -p /var/run/snmpd.pid 3264 root 1104 S /usr/sbin/httpd -p 80 -h /www -r drgos 3267 root 1456 S /usr/bin/catvmonitor 3400 root 604 S miniupnpd -i eth0 -n br-lan -p 5000 -U 3408 root 2452 S /usr/bin/sipapp -l 5 3409 root 2452 S /usr/bin/sipapp -l 5 3413 root 2452 S /usr/bin/sipapp -l 5 3456 root 4872 S dimclient 3469 root 2192 S igmp -t eth2 3498 root 4872 S dimclient 3499 root 4872 S dimclient 3588 root 4872 S dimclient 3589 root 4872 S dimclient

113

3676 3685 3785 4072 9144 15569 15597 15598 24251 24252 25156 25207

root root root root root root root root root root root nobody

848 4872 4872 1124 12396 1096 1100 1104 0 0 592 760

S S S S S S S R SW SW S S

/usr/sbin/dropbear -p 172.19.41.104:22 dimclient dimclient udhcpc -t 0 -i eth0.100 -O option150 -O option230 -V oxsh sleep 5 sh -c /bin/ps /bin/ps [RtmpCmdQTask] [RtmpWscTask] /usr/sbin/ntpclient -i 14400 -s -l -D -p 123 -h 0.ope /usr/sbin/dnsmasq --dhcp-optsfile=/tmp/dhcp_opts_file

History
This command was introduced in DRGOS 1.4.

See Also
show memory show sockets

114

Commands

show running-config
Context
executable-root

Syntax
show running-config [ context <string> | debug | group <string> ] [ role <user|operator> ] Displays the active system configuration

Description
The show running-config command displays the currently running system configuration to the terminal. The option context shows a specified context, debug shows configuration debugging (including group belonging) and group shows specified group of configuration commands from config. The role shows configuration identified by different administrative roles, i.e. operators or end users. The role keyword may therefore be used to display configuration specified by the operator or end user. This command works exactly as the write terminal command.

Example
drgos# show running-config ! version drgos-drg700-1.1.0-R interface lan ip address 172.19.36.72/24 interface lan/ethernet1 interface lan/ethernet2 vlan member 1,2,4-8 interface lan/ethernet3 interface lan/ethernet4 interface wan !end

History
This command was introduced in DRGOS 1.1. The role option was added in DRGOS 1.4.

See Also
write show startup-config

115

show sockets
Context
executable-root

Syntax
show sockets Display list of open sockets

Description
The show sockets command is used to show details of open network sockets.

Example
drgos# show sockets Active Internet connections (servers and established) Proto Recv-Q Send-Q Local Address Foreign Address tcp 0 0 0.0.0.0:53 0.0.0.0:* tcp 0 0 172.19.41.104:22 0.0.0.0:* udp 0 0 192.168.2.254:1024 0.0.0.0:* udp 0 0 0.0.0.0:161 0.0.0.0:* udp 0 0 0.0.0.0:53 0.0.0.0:* udp 0 1240 0.0.0.0:67 0.0.0.0:* udp 0 0 0.0.0.0:1900 0.0.0.0:* udp 0 0 172.19.41.104:123 141.35.1.80:123 raw 0 0 0.0.0.0:2 0.0.0.0:*

State LISTEN LISTEN

ESTABLISHED 7

History
This command was introduced in DRGOS 1.4.

See Also
show processes show memory

116

Commands

show startup-config
Context
executable-root

Syntax
show startup-config [ role <operator|user> ] Display the configuration stored on flash

Description
The show startup-config command displays the system configuration stored on the flash file system to the terminal. The startup-config is loaded into running config when DRGOS starts. The role keyword indentifies which configuration should be displayed. user identifies the configuration defined by the end user. operator identifies the configuration defined by the the operator. If role keyword is not defined, then the combined configuration is displayed.

Example
drgos# show startup-config interface lan ip address 172.19.36.72/24 interface lan/ethernet1 interface lan/ethernet2 interface lan/ethernet3 interface lan/ethernet4 interface wan

History
This command was introduced in DRGOS 1.1.

See Also
show running-config write

117

show system load


Context
executable-root

Syntax
show system load [detailed] Show system load.

Description
The show system load command is used to show the historic system load, including the average CPU usage for the last 10 seconds. Using the "detailed" option also shows the average run queue length for every 5 second period in the last hour.

Example
drgos# show system load System load, average interval is 10 sec CPU load User: 3.39% Nice: 0.00% System: 6.89% I/O Wait: 0.00% Steal: 0.00% Idle: 89.72% drgos# show system load detailed System load, average interval is 10 sec CPU load User: 6.99% Nice: 0.00% System: 5.29% I/O Wait: 0.00% Steal: 0.00% Idle: 87.72% System load average for previous 60 minutes (5s intervals): Ago +0s +5s +10s +15s +20s +25s +30s +35s +40s +45s +50s +55s -------------------------------------------------------------------------------13m4s : 0.55 0.53 0.50 0.46 0.41 0.38 0.35 0.31 0.26 0.15 12m4s : 1.27 1.24 1.22 1.19 1.15 1.10 1.03 0.95 0.86 0.75 0.66 0.59 11m4s : 1.21 1.23 1.24 1.26 1.27 1.28 1.29 1.29 1.30 1.30 1.29 1.28 10m4s : 1.06 1.07 1.09 1.10 1.12 1.13 1.14 1.16 1.17 1.18 1.19 1.20 9m4s : 1.02 1.02 1.02 1.03 1.03 1.03 1.04 1.05 1.05 1.06 1.06 1.06 8m4s : 0.96 0.97 0.97 0.98 0.99 0.99 0.99 0.99 1.00 1.00 1.01 1.01 7m4s : 0.87 0.87 0.88 0.89 0.90 0.91 0.92 0.92 0.93 0.94 0.95 0.96 6m4s : 0.81 0.81 0.82 0.82 0.82 0.82 0.82 0.82 0.83 0.84 0.85 0.86 5m4s : 0.82 0.82 0.81 0.81 0.81 0.81 0.81 0.81 0.81 0.81 0.81 0.81 4m4s : 0.85 0.85 0.85 0.84 0.84 0.84 0.83 0.83 0.82 0.82 0.82 0.82 3m4s : 0.83 0.83 0.84 0.84 0.84 0.84 0.85 0.85 0.85 0.85 0.85 0.85 2m4s : 0.79 0.79 0.79 0.80 0.80 0.80 0.81 0.81 0.81 0.82 0.82 0.83 1m4s : 0.77 0.77 0.77 0.77 0.77 0.77 0.78 0.78 0.78 0.78 0.78 0.79 4s : 0.79 0.78 0.78 0.78 0.78 0.78 0.77 0.77 0.77 0.77 0.77 0.77

History
This command was introduced in DRGOS 1.4.

See Also
show processes

118

Commands

show memory

119

show tech-support
Context
executable-root

Syntax
show tech-support [ all | l2 | routing | voip ] Display technical information about the system.

Description
The show tech-support command executes a set of show commands. The output of the show techsupport command contains valuable information to assist PacketFront TAC in resolving issues. The all keyword generates a complete tech support output. The routing keyword generates routing related tech support output. The l2 keyword generates Layer 2 related tech support output. The voip keyword generates VoIP related tech support output.

Example
drgos# show tech-support

History
This command was introduced in DRGOS 1.2, and enhanced in DRGOS 1.4.

120

Commands

show version
Context
executable-root

Syntax
show version Display system hardware and software status

Description
The show version command display information about the system hardware and software.

Example
drgos# show version Digital Residential Gateway Operating System (DRGOS) Copyright (c) 2010 by PacketFront Systems AB DRGOS version: drgos-drg700-1.1.0-RC1 Compiled: Fri May 7 18:16:47 CST 2010 Source ID: 7fe64dc8c1f701540db2325bf1f966c61cd056ee drgos uptime is 13h42m27s Bootloader 1 version: drgldr-drg700-1.0.2-R (May 11 2010 - 15:26:05) Bootloader 2 version: drgldr-drg700-1.0.1-R (Apr 23 2010 - 13:16:41) Bootstrap version: drgboot-drg700-1.0.1-R (Apr 23 2010 - 13:14:05) Product name: DRG715 Product number: FJB623MH Product revision: 1.0 Product date: 2010-01-16 Serial number: HL01315485 Base MAC address: 000F5DA002F0

History
This command was introduced in DRGOS 1.1.

121

show vlan
Context
executable-root

Syntax
show vlan Displays the current interface to VLAN mappings

Description
The show vlan command display a table of configured vlan and the physical interfaces configured into each vlan.

Example
drgos# show vlan VLAN Interfaces ----------------------------------------------------------------3 lan/ethernet3 9 lan/ethernet1 lan/ethernet2 lan/ethernet3 lan/ethernet4 wan 10 lan/ethernet1 3014 lan/ethernet2 3015 lan/ethernet3

History
This command was introduced in DRGOS 1.1.

See Also
vlan member

122

Commands

show voip statistics


Context
executable-root

Syntax
show voip statistics Show voip statistics.

Description
The show voip statistics command is used to show the statistics information of the VoIP application. The statistics information includes originating and incoming calls and RTP of each POTS line.

Example
drgos# show voip statistics Voice Line Statistics Line 1 Incoming Calls Received: Incoming Calls Answered: Incoming Calls Connected: Incoming Calls Failed: Outgoing Calls Attempted: Outgoing Calls Answered: Outgoing Calls Connected: Outgoing Calls Failed: Dropped Calls: Total Call Time(s): RTP Packets Sent: RTP Bytes Sent: RTP Packets Received: RTP Bytes Received: RTP Packets Lost: Jitter Buffer Overruns: Jitter Buffer Underruns:

2 2 2 0 2 0 1 1 0 69 3444 551040 3417 546720 0 0 0

Session 1 Session Start Time: Mon Dec 27 08:15:49 2010 Local RTP Address: 172.19.33.199:8002 Remote RTP Address: 172.19.33.127:8000 Line 2 Incoming Calls Received: Incoming Calls Answered: Incoming Calls Connected: Incoming Calls Failed: Outgoing Calls Attempted: Outgoing Calls Answered: Outgoing Calls Connected: Outgoing Calls Failed: Dropped Calls: Total Call Time(s): RTP Packets Sent: RTP Bytes Sent: RTP Packets Received: RTP Bytes Received: RTP Packets Lost: Jitter Buffer Overruns: Jitter Buffer Underruns:

0 0 0 0 1 1 1 0 0 7 367 58720 378 60480 0 0 0

123

History
This command was introduced in DRGOS 1.3. This information used to be displayed using the "show voip status" command.

124

Commands

show voip status


Context
executable-root

Syntax
show voip status Show voice line registration and handset status.

Description
The show voip status command is used to show the connection and handset status of voice lines. The connection status may take one of the values described in the following table.

Table 2.1. VoIP Connection Status


Status Registered Unregistered Incomplete Comment Line registered to proxy Line is not registered to proxy Incomplete configuration

The line status may take one of the following values described in the following table.

Table 2.2. VoIP Line Status


On-hook Off-hook Ringing Handset on-hook, or no handsets present Handset off-hook Line is currently ringing

Example
drgos# show voip status Voice line Connection status 1 Registered 2 Incomplete drgos# show voip status Voice line Connection status 1 Registered 2 Registration failed Line status On-hook On-hook

Line status Off-hook On-hook

History
This command was added in v1.2 and modified in v1.3. The functionality provided in v1.2 is now available using the "show voip statistics" command.

125

show wlan
Context
executable-root

Syntax
show wlan [interface <wireless-interface> [clients]] Show wireless LAN (IEEE802.11) interface status.

Description
The show wlan command shows the status of wireless device or interface. If interface is omitted, the status of wireless device will be displayed. To see the statistics related to virtual wireless interface, specify the interface option. The clients option can be used to show the wireless clients connected to a specific virtual wireless interface.

Example
drgos# show wlan Wireless lan mode 802.11bgn, channel auto, country code se Signal strength 100mW (20dBm), 20 MHz bandwidth Interface wlan1 SSID wifi1 Authentication wpa2, encryption aes Mac address 00:0f:5d:20:00:14, 3 clients connected Radio enabled, channel 1 Interface wlan2 SSID wifi2 (hidden) Authentication wpa2, encryption aes Mac address 00:0f:5d:20:00:15, 0 clients connected Radio enabled, channel 1 Interface wlan3 SSID wifi3 (hidden) Authentication wpa2, encryption aes Mac address 00:0f:5d:20:00:16, 0 clients connected Radio disabled, channel 1 Interface wlan4 SSID wifi4 (hidden) Authentication wpa2, encryption aes Mac address 00:0f:5d:20:00:17, 0 clients connected Radio disabled, channel 1 drgos# show wlan interface wlan1 Wireless lan mode 802.11bgn, channel auto, country code se Signal strength 100mW (20dBm), 20 MHz bandwidth Interface wlan1 SSID wifi1 Authentication wpa2, encryption aes Mac address 00:0f:5d:20:00:14, 3 clients connected Radio enabled, channel 1 326354 packets input, 12376487 bytes, 44210 input errors 0 input queue drops, 0 unknown protocols 0 broadcasts, 0 multicasts, 0 pause 0 runts, 0 oversized, 0 CRC 0 jabbers, 0 fragments, 0 symbol, 0 aligment 1256238 packets output, 429436178 bytes, 0 output errors 0 output queue drops 0 broadcasts, 0 multicasts, 0 pause 0 collisions, 0 deferred

126

Commands

drgos# show wlan interface wlan1 clients Wireless lan mode 802.11bgn, channel auto, country code se Signal strength 100mW (20dBm), 20 MHz bandwidth Interface wlan1 SSID wifi1 Authentication wpa2, encryption aes Mac address 00:0f:5d:20:00:14, 3 clients connected Radio enabled, channel 1 Client MAC address Signal(dBm) Expires -------------------------------------------------------------------------172.19.36.163 00:24:21:56:42:68 -43 0 days 23:45:16 pf-test 00:24:21:56:42:69 -11 0 days 00:00:15 172.19.36.225 00:24:21:56:42:6a -89 2 days 12:22:14

History
This command was introduced in DRGOS 1.1.

127

shutdown
Context
interface-wan-configuration-root interface-lan-configuration-root interface-lan-ethernet-configuration-root interface-wlan-configuration-root interface-vlan-configuration-root

Syntax
[no] shutdown Configure interface administrative status

Description
The shutdown configuration command is used to administratively disable an interface. When used on an interface such as the Ethernet interfaces, the command disables receiving and transmitting data on the interface.

Example
drgos(config)# interface lan/ethernet1 drgos(config-if-lan-eth)# shutdown

Default
The default is for all interfaces to be in no shutdown mode.

History
This command was introduced in DRGOS 1.2.

128

Commands

sip display-name
Context
voice-line-configuration-root

Syntax
[no] sip display-name <displayname> Set the SIP display-name of a voice line.

Description
The sip display-name configuration command is used to set the SIP display-name of current voice line. In every outbound phone call, the display-name will be sent to called party and be presented as Caller Line Identification.

Example
drgos(config)# voice line 1 drgos(config-voice-line)# sip display-name foo

Default
There is no default SIP display name.

History
This command was introduced in DRGOS 1.1.

See Also
clip enable sip proxy sip outbound-proxy sip username sip domain sip phone-number

129

sip domain
Context
voice-line-configuration-root

Syntax
[no] sip domain <domainname> Set the domain of the SIP client in a voice line.

Description
The sip domain configuration command is used to set the domain of the SIP client in a voice line. The SIP domain will be used by the voice line, to register the SIP client into a SIP registrar.

Example
drgos(config)# sip domain voice.packetfront.com drgos(config)# no sip domain

Default
There is no default SIP domain.

History
This command was introduced in DRGOS 1.1.

See Also
sip proxy sip outbound-proxy sip username sip display-name sip phone-number

130

Commands

sip outbound-proxy
Context
voice-line-configuration-root

Syntax
[no] sip outbound-proxy {<a.b.c.d>|<hostname>} [port <port>] Set the SIP outbound proxy for one voice line.

Description
The sip outbound-proxy configuration command is used to set the address and port of the SIP outbound proxy for the current voice line. The outbound proxy is a normal SIP proxy. It receives requests from the voice line, even though it may not be the server resolved by the Request-URI. The voice line uses the proxy for all SIP sessions, just like when a Web browser uses a Web proxy for all Web transactions. Usually, the outbound proxy is placed alongside the firewall and let SIP traffic pass from the internal network to the Internet. You can use IPV4 address (a.b.c.d) or hostname to specify the address of the SIP outbound proxy. The port command may be specified to use an other port than the default.

Example
drgos(config)# voice line 1 dros(config-voice-line)# sip outbound-proxy sip.example.com port 5061 drgos(config-voice-line) no sip outbound-proxy

Default
There is in default SIP outbound proxy. The default port of the SIP outbound proxy is 5060.

History
This command was introduced in DRGOS 1.2.

See Also
sip proxy sip domain sip display-name sip phone-number

131

sip parse strict


Context
voice-configuration-root

Syntax
[no] sip parse strict Configure the SIP URI to be strictly parsed.

Description
The sip parse strict command is used to configure whether the SIP URI should be parsed strictly or not. The SIP standard (RFC3261) says "For two URIs to be equal, the user, password, host, and port components MUST match." However, many manufacturers do not obey this rule strictly. Therefore there are many SIP implementations which do not comply with this requirement, e.g. some SIP implementations will omit the optional port when using the default value of 5060. sip parse strict will force compliant parsing of the SIP URI, i.e. the SIP URI will be checked strictly against the RFC3261 requirement. no sip parse strict will use loose checking of the SIP URI, i.e. alternative URIs will be accepted. In some cases this can increase the possibility of specially crafted packets being used to create non-existant calls. PacketFront strongly recommended the use of ACLs to ensure that SIP signaling packets will only be accepted from devices on the VoIP network.

Example
drgos(config)# voice drgos(config-voice)# sip parse strict

Default
By default, the SIP URI is not checked strictly.

History
This command was introduced in DRGOS 1.4.

132

Commands

sip phone-number
Context
voice-line-configuration-root

Syntax
[no] sip phone-number <number> Set the phone number of a voice line.

Description
The sip phone-number configuration command is used to set the phone number or scheme name of the SIP URI of current voice line.

Example
drgos(config)# voice line drgos(config-voice-line)# drgos(config-voice-line)# drgos(config-voice-line)# drgos(config-voice-line)# 1 sip sip sip sip phone-number phone-number phone-number phone-number 901511 +862115000774328 Fred-Smith.IT "foo bar"

Default
There is no default SIP phone number.

History
This command was introduced in DRGOS 1.1. This command expanded in DRGOS 1.4.1 to expand character set support.

See Also
sip domain sip display-name sip username sip proxy sip outbound-proxy clip enable

133

sip proxy
Context
voice-line-configuration-root

Syntax
[no] sip proxy {<a.b.c.d>|<hostname>} [port <1-65535>] Set the SIP proxy for one voice line.

Description
The sip proxy configuration command is used to set the address and port of the SIP proxy for the current voice line. Before you can have voice service in a voice line, you have to configure the SIP proxy for the line. You can use IPV4 address (a.b.c.d) or hostname to specify the address of the SIP proxy. The port command may be specified to use an other port than the default.

Example
drgos(config)# voice line 1 drgos(config-voice-line)# sip proxy 192.168.10.8 drgos(config-voice-line)# sip proxy sip1.example.com 4086

Default
There is no default SIP proxy, if not configured on a line the voice service will be disabled on that line. The default port of the SIP proxy is 5060.

History
This command was introduced in DRGOS 1.1.

See Also
sip outbound-proxy sip domain sip display-name sip phone-number

134

Commands

sip register-expiry
Context
voice-line-configuration-root

Syntax
[no] sip register-expiry [<period>] Set the requested expiry time of SIP registration in seconds.

Description
The sip register-expiry configuration command is used to set the requested expiry time of SIP registration in seconds.

Example
drgos(config)# voice line 1 drgos(config-voice-line)# sip register-expiry 7200

Default
The default value of the requested expiry time of SIP registration is 3600s.

History
This command was introduced in DRGOS 1.1.

See Also
sip proxy sip outbound-proxy sip username sip domain sip display-name sip phone-number

135

sip timer suspend-resume


Context
voice-line-configuration-root

Syntax
[no] sip timer suspend-resume <0-120> Sets the value of the suspend-resume timer.

Description
The sip timer suspend-resume configuration command is used to configure the value of the suspend-resume timer. When a callee terminates a call by hanging up, the current call will not be cleared immediately. The call will be suspended for a period equal to the value of the suspend-resume timer. During this period, the callee may pick up the handset, or an alternative handset on the same line, and resume the call. The suspend-resume timer may take a value between 0 and 120 seconds. Configuring a suspend-resume timer value of 0 will disable the suspend-resume feature. In this case if the callee terminates the call, the call will be cleared immediately.

Example
drgos(config)# voice line 1 drgos(config-voice-line)# sip timer suspend-resume 60

Default
The default suspend-resume timer value is 90 seconds.

History
This command was introduced in DRGOS 1.4.

136

Commands

sip username
Context
voice-line-configuration-root

Syntax
[no] sip username <username> password <password> Set the SIP user name and password in a voice line.

Description
The sip username configuration command is used to set the SIP user name and password in current voice line. The SIP user name and password will be used for SIP authentication.

Example
drgos(config)# voice line 1 drgos(config-voice-line)# sip username foo password foobar

Default
There is no default SIP user.

History
This command was introduced in DRGOS 1.1.

See Also
sip proxy sip outbound-proxy sip domain sip display-name sip phone-number

137

snmp agent source-interface


Context
configuration-root

Syntax
[no] snmp agent source-interface <interface> Configure source interface for SNMP agent traffic

Description
The snmp agent source-interface configuration command sets the interface from which to select the source IP address for all SNMP communication from the system. A network management system typically expects to send and receive SNMP communication to a single address on a monitored system. If requests are sent to a different address than the response is received from including the source of SNMP traps, the result can be confusing for the management system.

Example
drgos(config)# snmp agent source-interface wan

Default
By default the SNMP agent will use the address of wan interface.

History
This command was introduced in DRGOS 1.2.

138

Commands

snmp-group version
Context
configuration-root

Syntax
[no] snmp-group version <1|2c> [<name>] Create an SNMP group

Description
The snmp-group configuration command is used to create a context of SNMP settings for an instance of the protocol. A SNMP group represents a set of parameters to access the system remotely or send notifications for a particular version of the protocol. The version keyword must be included to specify the version of SNMP for which configuration will be entered. the DRGOS supports SNMP version 1 and 2c. The optional <name> can be used if configuration for the same version of the protocol for any reason needs to be separated. This might be the case if different entities manage the system.

Example
drgos(config)# snmp-group version 1 isp1 drgos(cofnig)# snmp-group version 2c

Default
This command has no default value.

History
This command was introduced in DRGOS 1.2.

See Also
community

139

snmp mib system


Context
configuration-root

Syntax
[no] snmp mib system {contact <string> |location <string>} Specify MIB-II system parameters

Description
The snmp mib system configuration command is used to set SNMP MIB-II system group variables. The contact keyword specifies a text string to be displayed as system.sysContact.0. The location keyword specifies a text string to be displayed as system.sysLocation.0.

Example
drgos(config)# snmp mib system contact "ISPNOC Duty Mgr, 709 82 00" drgos(config)# snmp mib system location "Basement, building 7#"

Default
This command has no defaults.

History
This command was introduced in DRGOS 1.2.

140

Commands

snmp notification agent-authentication


Context
configuration-root

Syntax
[no] snmp notification agent-authentication Send authenticationFailure traps

Description
The snmp notification agent-authentication configuration command configures the DRGOS snmp agent to send the generic authenticationFailure trap whenever an incoming SNMP request fails to authenticate.

Example
drgos(config)# snmp notification agent-authentication

Default
this command is default disabled.

History
This command was introduced in DRGOS 1.2.

141

test logging
Context
executable-root

Syntax
test logging message <level> <message> Log a test message

Description
The test logging command can be used to test logging a message. The level keyword sets the level of the logged message and can be one of the following: emergencies, alerts, critical, errors, warnings, notifications, informational or debugging.

Example
drgos# test logging message info "This is a test message"

History
This command was introduced in DRGOS 1.1.

See Also
show logging

142

Commands

test voip {ring | tone}


Context
executable-root

Syntax
test voip <1-2> {ring | tone} {start | stop} Test whether a voice line is able to ring or to play tones on the phone connected to a voice line.

Description
The command test voip { ring | tone} is used to test whether a voice line is able to ring or to play tones. This may be useful for trouble-shooting issues where expected tones are not present, or phone does not ring as expected. The dial tone the configured country will be played when the tone test is requested. The handset connected to a voice line must be in off-hook state when using the test tone, and the handset must be in on-hook state when using the test ring.

Example
The following commands start and stop ringing on the handset connected to voice line 1.
drgos# test voip 1 ring start Start ringing drgos# test voip 1 ring stop Ringing stopped

The following commands start and stop playing dial tone on the handset connected to voice line 1.
drgos# test voip 1 tone start Start playing dial tone drgos# test voip 1 tone stop Stopped playing dial tone

History
This command was introduced in DRGOS 1.4.

See Also
test voip get-hook-state

143

test voip get-hook-state


Context
executable-root

Syntax
test voip <1-2> get-hook-state Get the hook state of a voice line directly from the SLIC driver.

Description
The command test voip get-hook-state is used to get the current hook state of a phone which is connected on the indicated voice line. The show voip status command also can show the hook states from voice application. In the normal case, the two commands shall display the same value except that show voip status can show the third state, ringing. They may display different values in a fault condition.

Example
The following commands get the hook states of the handsets connected to voice line 1 and voice line 2.
drgos# debug voip 1 get-hook-state On-hook drgos# debug voip 2 get-hook-state Off-hook

History
This command was introduced in DRGOS 1.4.

See Also
show voip status

144

Commands

timezone
Context
configuration-root

Syntax
[no] clock timezone { <timezone> | < -14 - 12 > } Set the system timezone.

Description
The clock timezone configuration command is used to set the timezone used for the system clock. The timezone can be set either by a named timezone, by a geographical location or with an offset in hours relative to the Coordinated Universal Time (UTC).

Example
drgos(config)# clock timezone CET drgos(config)# clock timezone Europe/Stockholm drgos(config)# clock timezone -2

Default
The default system timezone is GMT0.

History
This command was introduced in DRGOS 1.4.

See Also
show clock

145

tone
Context
voice-configuration-root

Syntax
[no] tone <tone-name> <tone-value> Sets the frequency, voltage, and cadence for tones.

Description
The tone configuration command sets the frequency, voltage, and cadence for tones. The tone-name parameter specifies which tone the user want to set. The tone-value parameter specifies the frequency, voltage, and cadence of the tone. 14 different tones are supported. The tone names and their initial values are: dialtone: 425@-5 [mailto:425@-5]#on(1000),r busy: 425@-10 [mailto:425@-10]#on(250),off(250),r ringback: 425@-10 [mailto:425@-10]#on(1000),off(5000),r congestion: 425@-10 [mailto:425@-10]#on(250),off(750),r callwait: 425@-10 [mailto:425@-10]#on(200),off(500),on(200) callforward: 950@-10 [mailto:950@-10]#on(300),off(300),on(300),off(300),on(300) stutterdialtone: 425@-5 [mailto:425@-5]#on(320),off(20),r callwait2: no initial value, user must define it before using it callwait3: no initial value, user must define it before using it callwait4: no initial value, user must define it before using it confirm: no initial value, user must define it before using it offhookwarn: no initial value, user must define it before using it indicator: no initial value, user must define it before using it reorder: no initial value, user must define it before using it The "language" for specifying the tone components can be summarized by the following ABNF: Freqval ::= frequency in Hz Powerval ::= power in dBm0 Timeval ::= time in milliseconds Repeatval ::= # of cycles to repeat Idle ::= "idle" OnOff ::= "on" | "off"

146

Commands

Repeat ::= "r" Inactive ::= Idle "(" Timeval ")" Active ::= OnOff "(" Timeval ")" Sequence ::= Active *("," Active) Repetition ::= "[" Sequence "]" Repeatval Cycle ::= Sequence | Repetition Cadence ::= Cycle *("," Cycle) ["," Inactive] ["," Repeat] Toneref ::= "{" Tonename "(" Timeval ")}" Toneseq ::= Toneref *("|" Toneref) ["," Repeat] Freqcomp ::= Freqval "@" Powerval Freq ::= Freqcomp *3("+" Freqcomp) Tone ::= Toneseq | (Freq "#" Cadence)

Example
drgos(config)# voice drgos(config-voice)# tone dialtone 425@-5#on(1000),r

Default
If not configured, each tone is determined by the selected voice country value.

History
This command was introduced in DRGOS 1.2.

See Also
country

147

txgain
Context
voice-line-configuration-root

Syntax
[no] txgain <gain-value> Sets the transmission gain value.

Description
The txgain configuration command sets the transmission gain value, i.e. the gain from the analogue line towards the packet network. The gain-value value ranges from -12 dB to +6 dB.

Example
drgos(config)# voice line 1 drgos(config-voice-line)# txgain 5

Default
The default transmission gain value is -6 dB.

History
This command was introduced in DRGOS 1.2.

See Also
rxgain

148

Commands

username
Context
configuration-root

Syntax
[no] username <username> password <password> [ encrypted ] Configure password for a local user [no] username <username> access { cli | gui } Configure type of access for local user

Description
The username configuration command is used to create a local user in DRGOS. The password keyword is used to configure the password the user must enter to gain access to the system. The password can be entered as a clear text or encrypted string. DRGOS accepts passwords encrypted with the MD5 hash alogorithm which must be in the format $1$<salt>$<hash> as used by the crypt() function on most UNIX systems. Use the encrypted keyword to indicate that the password is already encrypted. Otherwise, DRGOS will apply the crypt() function on the clear text entered to create the encrypted password shown in the configuration. The access keyword is used to configure the type of access the user will be allowed. When cli is specified the user will be allowed to log in to the command line interface using SSH. When gui is specified the user will be allowed to log in to the graphical user interface using a web browser. Both cli and gui may be specified for the same user (on separate lines).

Example
drgos(config)# drgos(config)# drgos(config)# drgos(config)# drgos(config)# username username username username username noc password verysecret noc access cli admin password $1$q1YvY1kG$PM/L0zpTp1CYOh2cs6xw50 encrypted admin access cli admin access gui

Default
By default a user exists called "admin" with password "admin" that can access the gui interface and a user exists called "operator" with password "operator" that can access the command line interface. The default users will be prefixed with ! in the output from show running-config. They can disabled by entering no username admin and no username operator in the configuration.

History
This command was introduced in DRGOS 1.1.

149

vlan member
Context
interface-wan-configuration-root interface-lan-ethernet-configuration-root

Syntax
[no] vlan member <1-4094> Configure interface vlan membership

Description
The vlan member configuration command defines the VLANs to which an interface is a member. Only 802.1Q tagged Ethernet frames matching the configured VLAN will be allowed to be sent and received on the interface. Any other frames will be dropped. Due to limitations in the DRG700 hardware, the total number of VLAN IDs used on all interfaces may not exceed 63. If more than 63 VLAN IDs are configured, only the lowest 63 VLAN IDs will be used. For example, if "vlan member 101-160,301-303" is configured then those 63 VLANs will work as expected. However, if "vlan member 201" is added later (either to the same interface or another interface), there will be a total of 64 VLAN IDs and therefore the highest VLAN ID (303) will stop working.

Example
drgos(config)# interface wan drgos(config-wan)# vlan member 1,2,10-18,20

Default
This command has no default value.

History
This command was introduced in DRGOS 1.1.

See Also
vlan untagged show vlan

150

Commands

vlan untagged
Context
interface-wan-configuration-root interface-lan-ethernet-configuration-root

Syntax
[no] vlan untagged <1-4096> [priority <0-7>] Configure interface untagged vlan

Description
The vlan untagged configuration command configures a vlan for which the interface will operate in untagged mode. This command makes the interface part of a vlan interface configured with the same vlan id. Any untagged (no 802.1Q header) ethernet frames received on the interface will also be received by that vlan interface. The 802.1Q header will be stripped (if present) of any ethernet frame from that vlan interface being sent out the configured interface. The priority keyword can be used to specify what priority should be set in the 802.1Q header that will be added to received untagged packets. The interface must also be a member of the untagged vlan. This is configured with the vlan member configuration command.

An interface that is member of more than one vlan and operating in untagged mode for one of those vlans will continue to forward 802.1Q tagged ethernet frames for the untagged vlans.

Example
drgos(config)# interface wan drgos(config-wan)# vlan member 1,2,10-18,20 drgos(config-wan)# vlan untagged 2

Default
The default priority is 0.

History
This command was introduced in DRGOS 1.1.

See Also
vlan member

151

voice
Context
configuration-root

Syntax
voice [line <number>] Enter "voice" or "voice line" context

Description
The voice command is used to enter the "voice" context or one of "voice line" contexts. The "voice" context is used for global voice configuration. Any command executed in the "voice" context will affect all voice lines. Each voice line also has a "voice line" context. The line number is used to identify a "voice line" context. Any command executed in a "voice line" context will only affect that specfic voice line.

Example
drgos(config)# voice drgos(config-voice)# exit drgos(config)# voice line 2 drgos(config-voice-line)# exit

Default
This command has no default value.

History
This command was introduced in DRGOS 1.1.

152

Commands

voip class5 internal


Context
voice-line-configuration-root

Syntax
[no] voip class5 internal Control the internal processing of VoIP class 5 services.

Description
The voip class5 internal configuration command is used to enable or disable internal VoIP Class 5 services. Class 5 services provide complex functionality, e.g. hold, resume, call waiting, 3-party calls, and call forwarding. Class 5 services can be provided in the following ways: Simple Class 5 services are integrated within DRGOS and are enabled by default. These services are called "internal Class 5 services". More advanced Class 5 services can be provided by the VoIP service provider using the call control agent, e.g. SIP proxy, to control the call behavior. These services are called "external Class 5 services". Please see the Software Configuration Guide for further details of the operation of Class 5 services.

Example
drgos(config)# voice line 1 drgos(config-voice-line)# no voip class5 internal

Default
By default internal class 5 services are enabled.

History
This command was introduced in DRGOS 1.4.

153

voip media dscp


Context
voice-configuration-root

Syntax
[no] voip media dscp <0-63> Configure DiffServ code point for outgoing media packets.

Description
The voip media dscp configuration command is used to set the 6-bit DSCP (Differentiated Services Code Point) field value in the header of outgoing voip media IP packets.

Example
drgos(config)# voice drgos(config-voice)# voip media dscp 20

Default
The default dscp value for outgoing media packets is 0.

History
This command was introduced in DRGOS 1.2.

154

Commands

voip media priority


Context
voice-configuration-root

Syntax
[no] voip media priority <0-7> Configure ethernet priority(802.1p) tag for outgoing rtp frames.

Description
The voip media priority configuration command is used to set the ethernet priority(802.1p) tag value for outgoing voip media frames.

Example
drgos(config)# voice drgos(config-voice)# voip media priority 3

Default
The default priority value for outgoing media frame is 0.

History
This command was introduced in DRGOS 1.2.

155

voip media source-interface


Context
voice-configuration-root

Syntax
[no] voip media source-interface <interface> Configure source interface for outgoing voip media packets.

Description
The voip media source-interface configuration command is used to set the source interface for outgoing media packets. All the voip media packets will be sent out from the specified Layer 3 interface.

Example
drgos(config)# voice drgos(config-voice)# voip media source-interface vlan200

Default
The default source interface for outgoing media packets is wan.

History
This command was introduced in DRGOS 1.2.

156

Commands

voip relay hookflash


Context
voice-line-configuration-root

Syntax
[no] voip relay hookflash Configure the hook flash relay function for selected voice line.

Description
The voip relay hookflash command enables the hook flash relay function for one voice line. When the flash hook relay is enabled, the hook flash event will be transmitted as a SIP INFO message or RFC2833 RTP event, using the same method as that of the DTMF tones. no voip relay hookflash will disable this function, i.e., the hook flash event will be ignored.

Example
drgos(config)# voice line 1 drgos(config-voice-line)# voip relay hookflash

Default
The hook flash relay function is disabled by default.

History
This command was introduced in DRGOS 1.4.

157

voip signaling dscp


Context
voice-configuration-root

Syntax
[no] voip signaling dscp <0-63> Configure DiffServ code point for outgoing signaling packets.

Description
The voip signaling dscp configuration command is used to set the 6-bit DSCP(Differentiated Services Code Point) field value in the header of outgoing voip signaling IP packets.

Example
drgos(config)# voice drgos(config-voice)# voip signaling dscp 10

Default
The default dscp value for outgoing signaling packets is 0.

History
This command was introduced in DRGOS 1.2.

158

Commands

voip signaling priority


Context
voice-configuration-root

Syntax
[no] voip signaling priority <0-7> Configure ethernet priority(802.1p) tag for outgoing signaling frames.

Description
The voip signaling priority configuration command is used to set the ethernet priority(802.1p) tag value for outgoing voip signaling frames.

Example
drgos(config)# voice drgos(config-voice)# voip signaling priority 3

Default
The default priority value for outgoing signaling frame is 0.

History
This command was introduced in DRGOS 1.2.

159

voip signaling source-interface


Context
voice-configuration-root

Syntax
[no] voip signaling source-interface <interface> Configure source interface for outgoing voip signaling packets.

Description
The voip signaling source-interface configuration command is used to set the source interface for outgoing signaling packets. All the voip signaling packets will be sent out from the specified Layer 3 interface.

Example
drgos(config)# voice drgos(config-voice)# voip signaling source-interface vlan100

Default
The default source interface for outgoing signaling packets is wan.

History
This command was introduced in DRGOS 1.2.

160

Commands

voip timer clear


Context
voice-configuration-root

Syntax
[no] voip timer clear <10-2000> Set the call clear timer value.

Description
The voip timer clear configuration command is used to configure the value of the call clear timer. A call shall be considered to be cleared if the hookswitch has been pressed for more than a period specified by the clear timer. The value shall be between 10 and 2000 milliseconds.

Example
drgos(config)# voice drgos(config-voice)# voip timer clear 650

Default
The default value is 800.

History
This command was introduced in DRGOS 1.4.

See Also
voip timer hookflash

161

voip timer hookflash


Context
voice-configuration-root

Syntax
[no] voip timer hookflash <10-2000> Set the hookflash timer for the hookswitch operations.

Description
The voip timer hookflash configuration command is used to configure the value of hookflash timer for the hookswitch. A hookflash shall be considered to have occurred if the hookswitch is pressed for less than period specified by the hookflash timer. The value shall be between 10 and 2000 milliseconds.

Example
drgos(config)# voice drgos(config-voice)# voip timer hookflash 300

Default
The default value is 140.

History
This command was introduced in DRGOS 1.4.

See Also
voip timer clear

162

Commands

wlan access-control
Context
interface-wlan-configuration-root

Syntax
[no] wlan access-control { <h.h.h> | <x:x:x:x:x:x> } Configure wireless LAN (802.11 a/b/g/n) access control list entry

Description
Access to the wireless network can be resticted by filtering based on the MAC addresses of the connecting devices. The wlan access-control configuration command adds a MAC address to the wlan access control list. Depending on the setting of wlan access-policy all devices matching an entry in the list will either be allowed or rejected. Any number of entries maybe added. Use no to remove an entry (if no MAC address is specified all entries will be removed).

Example
drgos(config)# interface wlan1 drgos(config-if-wlan)# wlan access-policy allow drgos(config-if-wlan)# wlan access-control 0024.2156.426a drgos(config-if-wlan)# wlan access-control 00:21:9b:66:52:35

Default
This command has no default value.

History
This command was introduced in DRGOS 1.1.

See Also
wlan access-policy

163

wlan access-policy
Context
interface-wlan-configuration-root

Syntax
[no] wlan access-policy { allow | reject } Configure wireless LAN (802.11 a/b/g/n) access policy

Description
Access to the wireless network can be resticted by filtering based on the MAC addresses of the connecting devices. The wlan access-policy configuration command specifies the policy of the MAC address filter. When the policy is set to allow only the clients with MAC addresses in the access control list will be permitted to access the wireless network. When set to reject clients with MAC addresses in the access control list will be prevented from accessing the wireless network.

Example
drgos(config)# interface wlan1 drgos(config-if-wlan)# wlan access-policy allow drgos(config-if-wlan)# wlan access-control 0024.2156.426a

Default
Default is disabled (no filtering will be performed).

History
This command was introduced in DRGOS 1.1.

See Also
wlan access-control

164

Commands

wlan bandwidth
Context
configuration-root

Syntax
[no] wlan bandwidth { 20 | 40 } Configure wireless LAN (802.11 a/b/g/n) channel bandwidth

Description
The command wlan bandwidth configures the preferred wireless channel bandwidth to use. The default bandiwdth of each channel is 20 MHz. Setting the bandwidth to 40 MHz may give better throughput if the radio spectrum is available. The IEEE 802.11 a/b/g/n standards specifies 20 MHz as the standard channel bandwidth.

Example
drgos(config)# wlan bandwidth 40

Default
By default, the channel bandwidth is set to 20 MHz.

History
This command was introduced in DRGOS 1.1.

See Also
wlan channel

165

wlan channel
Context
configuration-root

Syntax
[no] wlan channel <channel-number> Configure wireless LAN (802.11 a/b/g/n) channel number

Description
The command wlan channel configures the preferred wireless channel to use. The 802.11 wireless device currently use three distinct frequency ranges, 2.4 GHz, 3.6 GHz and 4.9/5.0 GHz bands. Each range is divided into multitude of channels. Countries apply their own regulations to both the allowable channels and allowed maximum power levels within these frequency ranges. For DRG700 we use 2.4GHz frequency range, which is divided into channel 1-14. The channel specifies the preferred channel relative to the regulatory domain restrictions.

Example
drgos(config)# wlan channel 13

Default
By default, the channel neednt be specified, this means channel is auto selected for that country.

History
This command was introduced in DRGOS 1.1.

See Also
wlan country wlan txpower

166

Commands

wlan country
Context
configuration-root

Syntax
[no] wlan country <country-code> Configure wireless LAN (802.11 a/b/g/n) country code

Description
The wlan country configuration command Specifies the basic radio domain regulation paremeters. The 802.11 wireless device currently use three distinct frequency ranges, 2.4 GHz, 3.6 GHz and 4.9/5.0 GHz bands. Each range is divided into multitude of channels. Countries apply their own regulations to both the allowable channels and allowed maximum power levels within these frequency ranges. For DRG700 we use 2.4GHz frequency range, which is divided into channel 1-14. The country specifies the country code, which represent certain geographical regulatory domains. Each domain has its own regulation for wireless devices radio parameter like supported channels and transmission power. so the country parameter will affect the available channels and transmission powers. The country code is defined in ISO-3166 and in the format of short names in English, for example, se stands for Sweden, you can get whole list at http://www.iso.org/iso/country_codes/ iso_3166_code_lists/english_country_names_and_code_elements.htm. When setting the country, you should also use wlan channel to set the preferred channel for that regulatory domain. In general, selecting the auto channel is recommended.

Example
drgos(config)# wlan country se

Default
The default value for country is se.

History
This command was introduced in DRGOS 1.1.

See Also
wlan channel wlan mode wlan txpower

167

wlan mode
Context
configuration-root

Syntax
[no] wlan mode {11b|11g|11n|11bg|11gn|11bgn} Configure wireless LAN mode of operation (802.11 a/b/g/n).

Description
The wlan mode configuration command set the wireless standards running on the network. The DRG700 supports 802.11b, 802.11g, 802.11n wireless protocols and their mixed mode.

Example
drgos(config)# wlan mode 11g

Default
The default mode is 11bgn.

History
This command was introduced in DRGOS 1.1.

168

Commands

wlan security authentication


Context
interface-wlan-configuration-root

Syntax
[no] wlan security authentication none [no] wlan security authentication wep {open|shared} [{{key <1-4>}|passphrase}] [no] wlan security authentication {wpa|wpa2} {aes|tkip|tkipaes} Configure wlan security authentication and encryption paramters.

Description
The wlan security authentication configuration command set the security parameters for wireless network. Because wireless network operates by sending information over radio waves, it can be more vulnerable to intruders than traditional wired network. Since it is impossible to physically prevent someone from connecting to the wireless network, some additional measures is needed to keep the network secure. the authentication for the wireless clients access, encryption for the wireless data, and mac address filter for the clients are the most common security measures. When a wireless client connect to the network, the Access Point can use different methods to authenticate the clients. There are three authentication methods that can be selected: WEP, WPA and WPA2. WEP is a basic authentication method, which is not as secure as WPA and WPA2. WPA is a security standard stronger than WEP. WPA2 is a more advanced, more secure version of WPA. It is also possible to select none, which means no authentication needed. When selecting none as authentication method, please make sure to restrict access to the wlan through MAC based access restrictions configured with wlan access-policy and wlan access-control. The encryption method specifies data encryption to use. For WEP, open and shared is supported, which use static encryption key; for WPA or WPA2, aes, tkip and tkipaes are supported. TKIP and AES are encryption methods with dynamic encryption keys. For WEP authentication and encryption, the optional key index specifies the key used when encrypting data using WEP. There are four key indexes to choose from when encrypting WEP traffic. If passphrase is specified instead of a key index, the WEP key will be generated from the passphrase (configured with the wlan security passphrase command). If neither key index, nor passphrase is specified, the default key index 1 is used for WEP encryption. For WPA and WPA2, a passphrase with a 8-63 characters, or exactly 64 hexadecimal characters, is used for the encryption. When using WEP, if a non-default passphrase has been entered using the wlan security passphrase configuration command, the passphrase is used. Otherwise the key selected by the wlan security key command is used. If neither passphrase, nor key index has been selected, the key index 1 is used for the wep authentication.

Example
drgos(config)# interface wlan1 drgos(config-if-wlan)# wlan security drgos(config-if-wlan)# wlan security drgos(config)# interface wlan2 drgos(config-if-wlan)# wlan security drgos(config-if-wlan)# wlan security drgos(config)# interface wlan3 authentication wep shared passphrase passphrase "pfse1234" authentication wpa tkip passphrase "4321esfp"

169

drgos(config-if-wlan)# wlan security authentication wep open key 2 drgos(config-if-wlan)# wlan security key 2 hex 01234abcde0123456789abcdef

Default
By default, the wireless authentication method is wpa2, the encryption method is aes, and the encryption key is device specific and can be found on label on rear of unit and on CD. Default key for security authentication wep is key 1.

History
This command was introduced in DRGOS 1.1. The command syntax was modified in DRGOS 1.2.

See Also
wlan security key wlan security passphrase

170

Commands

wlan security key


Context
interface-wlan-configuration-root

Syntax
[no] wlan security key <1-4> hex <keyvalue> Configure wireless LAN (802.11 a/b/g/n) WEP key 1-4

Description
The wlan security key configuration command specifies the encryption key used by WEP. The key can be 40/64 bits (10 hex digits) or 104/128 bits (26 hex digits).

Example
drgos(config-if-wlan)# wlan security key 1 hex 8f58765dfe

Default
No default values.

History
This command was introduced in DRGOS 1.1. The command was modified in DRGOS 1.2.

See Also
wlan security authentication

171

wlan security passphrase


Context
interface-wlan-configuration-root

Syntax
[no] wlan security passphrase "passphrase" Configure wlan security passphrase.

Description
The wlan security passphrase configuration command set the security passphrase used for encryption. Because wireless network operates by sending information over radio waves, it can be more vulnerable to intruders than traditional wired network. Since it is impossible to physically prevent someone from connecting to the wireless network, some additional measures is needed to keep the network secure. the authentication for the wireless clients access, encryption for the wireless data, and mac address filter for the clients are the most common security measures. The wlan security authentication parameter specifies the security authentication method for the wireless network. When a wireless client connect to the network, the Access Point can use different methods to authenticate the clients. There are three authentication methods that can be selected: WEP, WPA and WPA2. WEP is a basic authentication method, which is not as secure as WPA and WPA2. WPA is a security standard stronger than WEP. WPA2 is a more advanced, more secure version of WPA. It is also possible to select none, which means no authentication needed. When a wlan security authentication wep command is set to use a passphrase the configured passphrase will be used to generate the authentication key used in WEP authentication.

Example
drgos(config)# interface wlan1 drgos(config-if-wlan)# wlan security drgos(config-if-wlan)# wlan security drgos(config)# interface wlan2 drgos(config-if-wlan)# wlan security drgos(config-if-wlan)# wlan security authentication wep shared passphrase "pfse1234" authentication wpa tkip passphrase "4321esfp"

Default
By default, the wireless authentication method is wpa2, the encryption method is aes, and key is device specific and can be found on label on rear of unit and on CD.

History
This command was introduced in DRGOS 1.1. The command syntax was modified for DRGOS 1.2.

See Also
wlan security authentication

172

Commands

wlan ssid
Context
interface-wlan-configuration-root

Syntax
[no] wlan ssid <ssid> Configure wireless LAN (802.11 a/b/g/n) SSID

Description
The wlan ssid configuration command specifies the SSID of the wireless network. The SSID is the network name shared among all points in a wireless network. The SSID must be identical for all devices in the wireless network. It is case-sensitive and must not exceed 32 characters(use any characters on the keyboard). Make sure this setting is the same for all points in your wireless network. For added security, you should change the default SSID to a unique name.

Example
drgos(config-if-wlan)# wlan ssid packetfront10

Default
The default value for wireless SSID is ssid plus wifi interface index, for example, the defautlt SSID for wlan1 is ssid1.

History
This command was introduced in DRGOS 1.1.

See Also
wlan ssid broadcast

173

wlan ssid broadcast


Context
interface-wlan-configuration-root

Syntax
[no] wlan ssid broadcast Configure wireless LAN (802.11 a/b/g/n) SSID broadcast

Description
The wlan ssid broadcast configuration command specifies if the current Wireless interface broadcast its SSID. When wireless clients scan the local area for wireless networks to associate with, they will detect the SSID broadcast by the Access Point. To not broadcast the Access Points SSID, use no wireless ssid broadcast, which will make DRG700 hidden to wireless clients. In this case, only the clients know the SSID in advance can access this wireless network with SSID.

Example
drgos(config)# interface wlan1 drgos(config-if-wlan)# no wlan ssid broadcast

Default
By default, the wlan ssid broadcast is enabled.

History
This command was introduced in DRGOS 1.1.

See Also
wlan ssid

174

Commands

wlan txpower
Context
configuration-root

Syntax
[no] wlan txpower <0-100> Configure wireless LAN (802.11 a/b/g/n) transmit power

Description
The 802.11 wireless device currently use three distinct frequency ranges, 2.4 GHz, 3.6 GHz and 4.9/5.0 GHz bands. Each range is divided into multitude of channels. Countries apply their own regulations to both the allowable channels and allowed maximum power levels within these frequency ranges. For DRG700 we use 2.4GHz frequency range, which is divided into channel 1-14. The wlan txpower configuration commands specifies the percentage of maximal transmit power relative to the current regulatory domain restrictions. For example, if the regulatory domain restriction allows transmissions of up to 10 dB, then setting the percentage at 50% allows maximal transmit power of 7dB.

Example
drgos(config)# wlan txpower 90

Default
The default value for txpower is 100, that means device operates on the max available transmission power.

History
This command was introduced in DRGOS 1.1.

See Also
wlan channel wlan country

175

write
Context
executable-root

Syntax
write [ memory ] Write running configuration to flash write terminal Write running configuration to terminal write erase [ role <operator|user> ] Erase configuration currently stored on flash

Description
The write command controls the storage of the system configuration. When executed without argument or with the optional memory keyword, the current running configuration is written to the flash file system startup config. The terminal keyword writes the current running configuration to the terminal. It is not stored on flash. The erase keyword removes the currently stored configuration from flash. When the DRG restarts, there is no startup config and it will start empty. The role keyword indentifies to which config should be written. user identified the configuration set by the end user. operator identified the configuration set by the the operator.

Example
drgos# write memory Wrote 170 bytes of configuration

History
This command was introduced in DRGOS 1.1.

See Also
show running-config show startup-config

176

Das könnte Ihnen auch gefallen