MRV LX Series Commands Reference Guide - Oracle Documentation

LX-Series Commands Reference Guide

Corporate Headquarters MRV Communications, Inc. Corporate Center 20415 Nordhoff Street Chatsworth, CA 91311 Tel: 818-773-0900 Fax: 818-773-0906 www.mrv.com (Internet)

Sales and Customer Support MRV Americas 295 Foster Street Littleton, MA 01460 Tel: 800-338-5316 (U.S.) Tel: +011 978-952-4888 (Outside U.S.) [email protected] (email) www.mrv.com (Internet)

451-0310E

MRV International Industrial Zone P.O. Box 614 Yokneam, Israel 20682 Tel: 972-4-993-6200 [email protected] (email) www.mrv.com (Internet)

All rights reserved. No part of this publication may be reproduced without the prior written consent of MRV Communications, Inc. The information in this document is subject to change without notice and should not be construed as a commitment by MRV Communications, Inc. MRV Communications, Inc. reserves the right to revise this publication and to make changes in content from time to time, without obligation to provide notification of such revision or changes. MRV Communications, Inc. assumes no responsibility for errors that may appear in this document. Copyright © 2003 by MRV Communications, Inc. This product includes software developed by the OpenSSL Project for use in the OpenSSL Toolkit (http://www.openssl.org/ ). This product includes cryptographic software written by Eric Young ([email protected]). This product includes software written by Tim Hudson ([email protected]).

Service Information Should you experience trouble with this equipment, please contact one of the following support locations:

2

•

If you purchased your equipment in the Americas, contact MRV Americas Service and Support in the U.S. at 978-952-4888. (If you are calling from outside the U.S., call +011 978-952-4888.)

•

If you purchased your equipment outside the Americas (Europe, EU, Middle-East, Africa, Asia), contact MRV International Service and Support at 972-4-993-6200.

451-0310E

Secure Shell Disclaimer THE SECURE SHELL SOFTWARE IS PROVIDED BY ERIC YOUNG "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE AUTHOR OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OR SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.

451-0310E

3

Table of Contents Preface ................................................................................................................ 21 Conventions ................................................................................................................................. 22 Using the Function Keys ............................................................................................................. 22 Navigating the LX Command Line Interface (CLI) .................................................................... 23 User Command Mode ............................................................................................................ 24 Superuser Command Mode ................................................................................................... 25 Configuration Command Mode ............................................................................................. 25 Asynchronous Command Mode ............................................................................................ 26 Ethernet Command Mode ...................................................................................................... 26 PPP Command Mode ............................................................................................................. 27 Modem Command Mode ....................................................................................................... 27 Subscriber Command Mode .................................................................................................. 27 SNMP Command Mode ........................................................................................................ 28 Interface Command Mode ..................................................................................................... 28 Menu Command Mode .......................................................................................................... 28 Menu Editing Command Mode ............................................................................................. 29 Notification Command Mode ................................................................................................ 29 Broadcast Group Command Mode ........................................................................................ 29 Online Help ................................................................................................................................. 30 Related Documents ..................................................................................................................... 31

Chapter 1 - User Commands ............................................................................ 33 clear ........................................................................................................................................ 34 disconnect .............................................................................................................................. 35 enable ..................................................................................................................................... 36 exit ......................................................................................................................................... 37 no ........................................................................................................................................... 38 pause enable ........................................................................................................................... 39 ping ........................................................................................................................................ 40 show clock ............................................................................................................................. 41 show port ................................................................................................................................ 42 show service ........................................................................................................................... 53 show session .......................................................................................................................... 54 show subscriber ...................................................................................................................... 55 show version .......................................................................................................................... 61 ssh .......................................................................................................................................... 62 telnet ....................................................................................................................................... 63 terminal .................................................................................................................................. 64

451-0310E

5

Chapter 2 - Superuser Commands .................................................................. 65 clear ........................................................................................................................................ 66 configuration .......................................................................................................................... 67 debug port async ppp ............................................................................................................. 68 debug snmp ............................................................................................................................ 69 debug subscriber .................................................................................................................... 70 disconnect .............................................................................................................................. 71 exit ......................................................................................................................................... 72 logout ..................................................................................................................................... 73 no ........................................................................................................................................... 74 outlet ...................................................................................................................................... 75 outlet group ............................................................................................................................ 76 pause enable ........................................................................................................................... 77 ping ........................................................................................................................................ 78 reload ..................................................................................................................................... 79 save configuration .................................................................................................................. 80 setup ....................................................................................................................................... 81 shell ........................................................................................................................................ 82 show audit log ........................................................................................................................ 83 show broadcast group characteristics .................................................................................... 84 show broadcast group summary ............................................................................................ 85 show clock ............................................................................................................................. 86 show command log ................................................................................................................ 87 show configuration ................................................................................................................ 88 show configuration log .......................................................................................................... 89 show debug port async ppp .................................................................................................... 90 show debug subscriber ........................................................................................................... 91 show device status ................................................................................................................. 92 show device summary ............................................................................................................ 94 show interface characteristics ................................................................................................ 95 show interface port mapping .................................................................................................. 97 show interface rotary ............................................................................................................. 99 show interface status ............................................................................................................ 100 show interface summary ...................................................................................................... 101 show kernel log .................................................................................................................... 102 show log ............................................................................................................................... 103 show notification message ................................................................................................... 104 show notification serviceprofile ........................................................................................... 105 show notification userprofile ............................................................................................... 106 show outlet group status ...................................................................................................... 107

6

451-0310E

show port async apd ............................................................................................................. 108 show port async characteristics ............................................................................................ 109 show port async modem ...................................................................................................... 110 show port async pattern match characteristics ..................................................................... 111 show port async ppp ............................................................................................................ 112 show port async ppp status .................................................................................................. 113 show port async status ......................................................................................................... 114 show port async summary .................................................................................................... 115 show port ethernet characteristics ........................................................................................ 116 show port ethernet status ...................................................................................................... 117 show port ethernet summary ................................................................................................ 119 show radius characteristics .................................................................................................. 120 show radius status ................................................................................................................ 122 show radius summary .......................................................................................................... 124 show route ............................................................................................................................ 125 show securid characteristics ................................................................................................. 126 show securid status .............................................................................................................. 128 show securid summary ......................................................................................................... 129 show service ......................................................................................................................... 130 show session ........................................................................................................................ 131 show snmp characteristics ................................................................................................... 132 show snmp client ................................................................................................................. 133 show snmp v3 ...................................................................................................................... 134 show subscriber .................................................................................................................... 137 show subscriber summary .................................................................................................... 138 show system characteristics ................................................................................................. 139 show system ppciboot .......................................................................................................... 141 show system status ............................................................................................................... 142 show tacacs+ characteristics ................................................................................................ 144 show tacacs+ status .............................................................................................................. 146 show tacacs+ summary ........................................................................................................ 148 show users ............................................................................................................................ 149 show version ........................................................................................................................ 150 ssh ........................................................................................................................................ 151 telnet ..................................................................................................................................... 152 terminal ................................................................................................................................ 153 update ................................................................................................................................... 154 zero all .................................................................................................................................. 155 zero log ................................................................................................................................ 156 zero securid secret ................................................................................................................ 157

451-0310E

7

Chapter 3 - Configuration Commands ........................................................... 159 boot configuration from flash .............................................................................................. 160 boot configuration from name ............................................................................................. 161 boot configuration from network ......................................................................................... 162 broadcast group .................................................................................................................... 163 broadcast group enable ........................................................................................................ 164 clock ..................................................................................................................................... 165 copy port .............................................................................................................................. 166 copy subscriber .................................................................................................................... 167 date ....................................................................................................................................... 168 default boot .......................................................................................................................... 169 default configuration ............................................................................................................ 170 default log size ..................................................................................................................... 171 default outlet group off time ................................................................................................ 172 default tftp ............................................................................................................................ 173 domain name ........................................................................................................................ 174 end ........................................................................................................................................ 175 exit ....................................................................................................................................... 176 fingerd enable ...................................................................................................................... 177 gateway ................................................................................................................................ 178 hostname .............................................................................................................................. 179 interface ............................................................................................................................... 180 iptables ................................................................................................................................. 181 location ................................................................................................................................. 182 log size ................................................................................................................................. 183 menu ..................................................................................................................................... 184 no ......................................................................................................................................... 185 notification ........................................................................................................................... 186 ntp enable ............................................................................................................................. 187 ntp server address ................................................................................................................. 188 outlet group .......................................................................................................................... 189 outlet group name ................................................................................................................ 190 outlet group off time ............................................................................................................ 191 password .............................................................................................................................. 192 password enable ................................................................................................................... 193 port async ............................................................................................................................. 194 port ethernet ......................................................................................................................... 195 ppciboot address .................................................................................................................. 196 ppciboot address assignment option .................................................................................... 197 ppciboot ethernet network link ............................................................................................ 198

8

451-0310E

ppciboot gateway ................................................................................................................. 199 ppciboot image filename ...................................................................................................... 200 ppciboot image load from .................................................................................................... 201 ppciboot mask ...................................................................................................................... 202 ppciboot tftp server .............................................................................................................. 203 primary dns .......................................................................................................................... 204 radius period ........................................................................................................................ 205 radius primary accounting server address ............................................................................ 206 radius primary accounting server port ................................................................................. 207 radius primary accounting server retransmit ....................................................................... 208 radius primary accounting server secret .............................................................................. 209 radius primary accounting server timeout ........................................................................... 210 radius primary authentication server address ....................................................................... 211 radius primary authentication server port ............................................................................ 212 radius primary authentication server retransmit .................................................................. 213 radius primary authentication server secret ......................................................................... 214 radius primary authentication server timeout ...................................................................... 215 radius secondary accounting server address ........................................................................ 216 radius secondary accounting server port .............................................................................. 217 radius secondary accounting server retransmit .................................................................... 218 radius secondary accounting server secret ........................................................................... 219 radius secondary accounting server timeout ........................................................................ 220 radius secondary authentication server address ................................................................... 221 radius secondary authentication server port ......................................................................... 222 radius secondary authentication server retransmit ............................................................... 223 radius secondary authentication server secret ...................................................................... 224 radius secondary authentication server timeout ................................................................... 225 route address ........................................................................................................................ 226 route gateway ....................................................................................................................... 227 route mask ............................................................................................................................ 228 secondary dns ....................................................................................................................... 229 securid authentication encryption ........................................................................................ 230 securid authentication port ................................................................................................... 231 securid authentication retransmit ......................................................................................... 232 securid authentication timeout ............................................................................................. 233 securid authentication version ............................................................................................. 234 securid master authentication server address ....................................................................... 235 securid master authentication server name .......................................................................... 236 securid primary authentication server address ..................................................................... 237 securid primary authentication server name ........................................................................ 238

451-0310E

9

securid slave authentication server address ......................................................................... 239 securid slave authentication server name ............................................................................. 240 service .................................................................................................................................. 241 snmp ..................................................................................................................................... 242 snmp enable ......................................................................................................................... 243 ssh enable ............................................................................................................................. 244 ssh v1 ................................................................................................................................... 245 ssh v2 ................................................................................................................................... 246 subscriber ............................................................................................................................. 247 tacacs+ period ...................................................................................................................... 248 tacacs+ primary accounting server address ......................................................................... 249 tacacs+ primary accounting server port ............................................................................... 250 tacacs+ primary accounting server retransmit ..................................................................... 251 tacacs+ primary accounting server secret ............................................................................ 252 tacacs+ primary accounting server timeout ......................................................................... 253 tacacs+ primary authentication server address .................................................................... 254 tacacs+ primary authentication server port .......................................................................... 255 tacacs+ primary authentication server retransmit ................................................................ 256 tacacs+ primary authentication server secret ....................................................................... 257 tacacs+ primary authentication server timeout .................................................................... 258 tacacs+ secondary accounting server address ...................................................................... 259 tacacs+ secondary accounting server port ........................................................................... 260 tacacs+ secondary accounting server retransmit .................................................................. 261 tacacs+ secondary accounting server secret ........................................................................ 262 tacacs+ secondary accounting server timeout ...................................................................... 263 tacacs+ secondary authentication server address ................................................................. 264 tacacs+ secondary authentication server port ...................................................................... 265 tacacs+ secondary authentication server retransmit ............................................................ 266 tacacs+ secondary authentication server secret ................................................................... 267 tacacs+ secondary authentication server timeout ................................................................ 268 tacacs+ superuser password request enable ......................................................................... 269 telnet enable ......................................................................................................................... 270 tftp ........................................................................................................................................ 271 timed enable ......................................................................................................................... 272 timezone ............................................................................................................................... 273 web_server enable ................................................................................................................ 274

Chapter 4 - Interface Commands ................................................................... 275 address ................................................................................................................................. 276 authentication fallback enable ............................................................................................. 277

10

451-0310E

authentication local enable ................................................................................................... 278 authentication none .............................................................................................................. 279 authentication radius enable ................................................................................................. 280 authentication securid enable ............................................................................................... 281 authentication tacacs+ enable ............................................................................................. 282 broadcast .............................................................................................................................. 283 default mtu ........................................................................................................................... 284 default rotary ........................................................................................................................ 285 default ssh keepalive ............................................................................................................ 286 default ssh port ..................................................................................................................... 287 default telnet port ................................................................................................................. 288 end ........................................................................................................................................ 289 exit ....................................................................................................................................... 290 mask ..................................................................................................................................... 291 mtu ....................................................................................................................................... 292 no ......................................................................................................................................... 293 radius accounting enable ...................................................................................................... 294 rotary enable ........................................................................................................................ 295 rotary port ............................................................................................................................ 296 rotary ssh port ...................................................................................................................... 297 rotary tcp port ....................................................................................................................... 298 rotary type ............................................................................................................................ 299 serial ..................................................................................................................................... 300 ssh keepalive count .............................................................................................................. 301 ssh keepalive interval ........................................................................................................... 302 ssh port ................................................................................................................................. 303 tacacs+ accounting enable ................................................................................................... 304 telnet port ............................................................................................................................. 305

Chapter 5 - Asynchronous Commands ......................................................... 307 access ................................................................................................................................... 308 access power model ............................................................................................................. 309 apd enable ............................................................................................................................ 310 apd retry ............................................................................................................................... 311 apd signature ........................................................................................................................ 312 apd timeout .......................................................................................................................... 313 authentication enable ........................................................................................................... 314 authentication fallback enable ............................................................................................. 316 autobaud enable ................................................................................................................... 317 autobaud retry ...................................................................................................................... 318

451-0310E

11

autodial enable ..................................................................................................................... 319 autohangup enable ............................................................................................................... 320 banner ................................................................................................................................... 321 bits ........................................................................................................................................ 322 break enable ......................................................................................................................... 323 break special ........................................................................................................................ 324 connect command ................................................................................................................ 325 databuffer display ................................................................................................................ 326 databuffer size ...................................................................................................................... 327 databuffer syslog enable ...................................................................................................... 328 databuffer timestamp enable ................................................................................................ 329 default apd ............................................................................................................................ 330 default databuffer size .......................................................................................................... 331 default port ........................................................................................................................... 332 default power off time .......................................................................................................... 333 default speed ........................................................................................................................ 334 end ........................................................................................................................................ 335 exit ....................................................................................................................................... 336 flowcontrol ........................................................................................................................... 337 modem ................................................................................................................................. 338 modem enable ...................................................................................................................... 339 name ..................................................................................................................................... 340 no ......................................................................................................................................... 341 outlet name ........................................................................................................................... 342 parity .................................................................................................................................... 343 pattern match enable ............................................................................................................ 344 pattern string ........................................................................................................................ 345 power off time ...................................................................................................................... 347 ppp ....................................................................................................................................... 348 ppp enable ............................................................................................................................ 349 prompt .................................................................................................................................. 350 radius accounting enable ...................................................................................................... 351 signals syslog enable ............................................................................................................ 352 special break enable ............................................................................................................. 353 special break string .............................................................................................................. 354 speed .................................................................................................................................... 355 stopbits ................................................................................................................................. 356 tacacs+ accounting enable ................................................................................................... 357 telnet break string ................................................................................................................. 358 telnet negotiation enable ...................................................................................................... 359

12

451-0310E

transparency enable .............................................................................................................. 360

Chapter 6 - Ethernet Commands .................................................................... 361 description ............................................................................................................................ 362 end ........................................................................................................................................ 363 exit ....................................................................................................................................... 364 no description ....................................................................................................................... 365 speed .................................................................................................................................... 366

Chapter 7 - Subscriber Commands ............................................................... 367 access console enable ........................................................................................................... 368 access port ............................................................................................................................ 369 access ssh enable .................................................................................................................. 370 access telnet enable .............................................................................................................. 371 access web enable ................................................................................................................ 372 audit log enable .................................................................................................................... 373 backward_switch ................................................................................................................. 374 command log enable ............................................................................................................ 375 dedicated service .................................................................................................................. 376 default access port ................................................................................................................ 377 default access remote ........................................................................................................... 378 default backward_switch ..................................................................................................... 379 default dialback retry ........................................................................................................... 380 default forward_switch ........................................................................................................ 381 default idletime .................................................................................................................... 382 default local_switch ............................................................................................................. 383 default ssh log level ............................................................................................................. 384 dialback enable .................................................................................................................... 385 dialback number ................................................................................................................... 386 dialback retry ....................................................................................................................... 387 end ........................................................................................................................................ 388 exit ....................................................................................................................................... 389 forward_switch .................................................................................................................... 390 idletime ................................................................................................................................ 391 local_switch ......................................................................................................................... 392 maxsubscriber ...................................................................................................................... 393 menu enable ......................................................................................................................... 394 no ......................................................................................................................................... 395 password .............................................................................................................................. 396 password enable ................................................................................................................... 397

451-0310E

13

pause enable ......................................................................................................................... 398 preferred service .................................................................................................................. 399 prompt .................................................................................................................................. 400 security level superuser ........................................................................................................ 401 session .................................................................................................................................. 402 shell enable .......................................................................................................................... 403 ssh cipher ............................................................................................................................. 404 ssh key .................................................................................................................................. 405 ssh log level ......................................................................................................................... 406 telnet mode ........................................................................................................................... 407 terminal ................................................................................................................................ 408

Chapter 8 - SNMP Commands ........................................................................ 409 contact .................................................................................................................................. 410 default v3 client ................................................................................................................... 411 end ........................................................................................................................................ 412 exit ....................................................................................................................................... 413 get client ............................................................................................................................... 414 get client community ........................................................................................................... 415 get client version .................................................................................................................. 416 location ................................................................................................................................. 417 log enable ............................................................................................................................. 418 no ......................................................................................................................................... 419 set client ............................................................................................................................... 420 set client community ............................................................................................................ 421 set client version .................................................................................................................. 422 trap client ............................................................................................................................. 423 trap client community .......................................................................................................... 424 trap client version ................................................................................................................. 425 v3 client access context match ............................................................................................. 426 v3 client access context prefix ............................................................................................. 427 v3 client access read view .................................................................................................... 428 v3 client access security ....................................................................................................... 429 v3 client access write view .................................................................................................. 430 v3 client group security model ............................................................................................. 431 v3 client name ...................................................................................................................... 432 v3 client security community ............................................................................................... 433 v3 client security source ...................................................................................................... 434 v3 client view ....................................................................................................................... 435 v3 engine .............................................................................................................................. 436

14

451-0310E

Chapter 9 - Modem Commands ...................................................................... 437 default initstring ................................................................................................................... 438 dialout number ..................................................................................................................... 439 end ........................................................................................................................................ 440 exit ....................................................................................................................................... 441 initstring ............................................................................................................................... 442 no ......................................................................................................................................... 443 retry ...................................................................................................................................... 444 timeout ................................................................................................................................. 445 type ....................................................................................................................................... 446

Chapter 10 - PPP Commands ......................................................................... 447 accounting enable ................................................................................................................ 448 authentication ....................................................................................................................... 449 ccp enable ............................................................................................................................ 450 default authentication ........................................................................................................... 451 default ipcp .......................................................................................................................... 452 default lcp compression ....................................................................................................... 453 default lcp echo failure ........................................................................................................ 454 default lcp failure limit ........................................................................................................ 455 default lcp timeout ............................................................................................................... 456 default mode client username .............................................................................................. 457 default mtu ........................................................................................................................... 458 default remote address ......................................................................................................... 459 end ........................................................................................................................................ 460 exit ....................................................................................................................................... 461 ipcp accept address enable ................................................................................................... 462 ipcp compression enable ...................................................................................................... 463 ipcp failure limit ................................................................................................................... 464 ipcp timeout ......................................................................................................................... 465 lcp compression enable ........................................................................................................ 466 lcp echo failure ..................................................................................................................... 467 lcp echo interval ................................................................................................................... 468 lcp failure limit ..................................................................................................................... 469 lcp timeout ........................................................................................................................... 470 local address ......................................................................................................................... 471 mode client ........................................................................................................................... 472 mode client username .......................................................................................................... 473 mode server .......................................................................................................................... 474 mtu ....................................................................................................................................... 475

451-0310E

15

no ......................................................................................................................................... 476 remote address ..................................................................................................................... 477

Chapter 11 - Menu Commands ....................................................................... 479 delete .................................................................................................................................... 480 end ........................................................................................................................................ 481 exit ....................................................................................................................................... 482 import ................................................................................................................................... 483 list ......................................................................................................................................... 484 no ......................................................................................................................................... 485 open ...................................................................................................................................... 486

Chapter 12 - Menu Editing Commands .......................................................... 487 control key ........................................................................................................................... 488 display .................................................................................................................................. 489 end ........................................................................................................................................ 490 entry ..................................................................................................................................... 491 entry command .................................................................................................................... 492 entry label ............................................................................................................................ 493 entry menu ........................................................................................................................... 494 exit ....................................................................................................................................... 495 header ................................................................................................................................... 496 list ......................................................................................................................................... 497 menu ..................................................................................................................................... 498 menu continue string ............................................................................................................ 499 menu prompt ........................................................................................................................ 500 no control key ...................................................................................................................... 501 no entry ................................................................................................................................ 502 no header .............................................................................................................................. 503 no menu continue string ....................................................................................................... 504 no menu prompt ................................................................................................................... 505 open ...................................................................................................................................... 506 save ...................................................................................................................................... 507

Chapter 13 - Notification Commands ............................................................ 509 end ........................................................................................................................................ 510 exit ....................................................................................................................................... 511 message facility .................................................................................................................... 512 message priority ................................................................................................................... 513 message string ...................................................................................................................... 514

16

451-0310E

no ......................................................................................................................................... 515 serviceprofile async port ...................................................................................................... 516 serviceprofile bits ................................................................................................................. 517 serviceprofile driver ............................................................................................................. 518 serviceprofile file ................................................................................................................. 519 serviceprofile host ................................................................................................................ 520 serviceprofile modem port ................................................................................................... 521 serviceprofile parity ............................................................................................................. 522 serviceprofile port ................................................................................................................ 523 serviceprofile protocol ......................................................................................................... 524 serviceprofile server ............................................................................................................. 527 serviceprofile smsc .............................................................................................................. 528 serviceprofile stopbits .......................................................................................................... 530 userprofile contact ................................................................................................................ 531 userprofile facility ................................................................................................................ 532 userprofile priority ............................................................................................................... 533 userprofile serviceprofile ..................................................................................................... 534

Chapter 14 - Broadcast Group Commands ................................................... 535 end ........................................................................................................................................ 536 exit ....................................................................................................................................... 537 master port ........................................................................................................................... 538 mode ..................................................................................................................................... 539 no master port ...................................................................................................................... 540 no slave port ......................................................................................................................... 541 no slave port discard ............................................................................................................ 542 no slave port localecho ........................................................................................................ 543 slave port .............................................................................................................................. 544

Index ................................................................................................................. 547

451-0310E

17

Figures Figure 1 - LX Command Modes ........................................................................ 23 Figure 2 - Clock Display ................................................................................... 41 Figure 3 - Port Characteristics Screen ............................................................. 43 Figure 4 - Port APD Settings Screen ...............................................................46 Figure 5 - Port Modem Settings ....................................................................... 47 Figure 6 - Port PPP Settings Screen ................................................................ 48 Figure 7 - Port Status Screen (non-outlet) ....................................................... 50 Figure 8 - Port Status Screen (Outlet) ............................................................. 52 Figure 9 - Service Screen ..................................................................................53 Figure 10 - Session Screen ................................................................................ 54 Figure 11 - Subscriber Characteristics Screen ................................................ 56 Figure 12 - Subscriber Status Screen .............................................................. 59 Figure 13 - TCP Settings Screen ...................................................................... 60 Figure 14 - Version Screen ............................................................................... 61 Figure 15 - Audit Log Display .......................................................................... 83 Figure 16 - Broadcast Group Characteristics Display .................................... 84 Figure 17 - Broadcast Group Summary Display ............................................. 85 Figure 18 - Clock Display ................................................................................. 86 Figure 19 - Command Log Display ................................................................... 87 Figure 20 - Configuration Data Display .......................................................... 88 Figure 21 - Configuration Log Display ............................................................ 89 Figure 22 - Subscriber Debug Data .................................................................. 91 Figure 23 - Device Display for An OUTLET Port ............................................ 92 Figure 24 - Device Display for A SENSOR Port .............................................. 93 Figure 25 - Device Summary Display .............................................................. 94 Figure 26 - Interface Characteristics Display ................................................. 95 Figure 27 - Port Mapping Display .................................................................... 98 Figure 28 - Rotary Characteristics Display ..................................................... 99 Figure 29 - Interface Status Display .............................................................. 100 Figure 30 - Interfaces Summary Display ....................................................... 101 Figure 31 - Kernel Log Display ...................................................................... 102 Figure 32 - Log Display ................................................................................... 103 Figure 33 - Message Display ..........................................................................104 Figure 34 - Service Profile Display ................................................................. 105 Figure 35 - User Profile Display ..................................................................... 106 Figure 36 - Outlet Group Status Display ....................................................... 107 Figure 37 - Pattern Match Characteristics Display ...................................... 111 Figure 38 - PPP Status Display ...................................................................... 113 Figure 39 - Asynchronous Port Summary Data ............................................ 115 Figure 40 - Ethernet Port Characteristics ..................................................... 116 Figure 41 - Ethernet Port Statistical Information ........................................ 117 Figure 42 - Ethernet Summary Information ................................................. 119 Figure 43 - RADIUS Display ..........................................................................120 Figure 44 - RADIUS Status Display .............................................................. 122 Figure 45 - RADIUS Summary Display ......................................................... 124

451-0310E

19

Figure 46 - Route Display ............................................................................... 125 Figure 47 - SecurID Characteristics Display ................................................. 126 Figure 48 - SecurID Status Display ............................................................... 128 Figure 49 - SecurID Summary Display .......................................................... 129 Figure 50 - Service Screen .............................................................................. 130 Figure 51 - SNMP Characteristics Display ................................................... 132 Figure 52 - SNMP Client Display .................................................................. 133 Figure 53 - V3 Display .................................................................................... 134 Figure 54 - Subscriber Summary Display ..................................................... 138 Figure 55 - System Display ............................................................................ 139 Figure 56 - ppciboot Configured Load Settings Display ............................... 141 Figure 57 - System Status Display ................................................................. 142 Figure 58 - TACACS+ Display ....................................................................... 144 Figure 59 - TACACS+ Status Display ............................................................ 146 Figure 60 - TACACS+ Summary Display ......................................................148 Figure 61 - Users Screen ................................................................................. 149 Figure 62 - Version Screen ............................................................................. 150

20

451-0310E

Preface This guide describes the purpose, syntax, and options of each of the LX commands. This guide is organized as follows: •

Chapter 1 – Describes the User commands.

•

Chapter 2 – Describes the Superuser commands.

•

Chapter 3 – Describes the Configuration commands.

•

Chapter 4 – Describes the Interface commands.

•

Chapter 5 – Describes the Asynchronous commands.

•

Chapter 6 – Describes the Ethernet commands.

•

Chapter 7 – Describes the Subscriber commands.

•

Chapter 8 – Describes the SNMP commands.

•

Chapter 9 – Describes the Modem commands.

•

Chapter 10 – Describes the PPP commands.

•

Chapter 11 – Describes the Menu commands.

•

Chapter 12 – Describes the Menu Editing commands.

•

Chapter 13 – Describes the Notification commands.

•

Chapter 14 – Describes the Broadcast Group commands.

451-0310E

21

Preface

Conventions The following conventions are used throughout this guide: •

Command execution – Unless otherwise specified, commands are executed when you press .

•

Command syntax – Where command options or command syntax are shown, keywords and commands are shown in lowercase letters.

•

Keyboard characters (keys) – Keyboard characters are represented using left and right angle brackets (< and >). For example, the notation refers to the CTRL key; refers to the letter A; and refers to the RETURN key.

•

Typographical conventions – The following typographical conventions are used: Monospace Typeface – indicates text that can be displayed or typed at a terminal (i.e., displays, user input, messages, prompts, etc.). italics – are used to indicate variables in command syntax descriptions.

Using the Function Keys The LX Command Line Interface (CLI) supports the following function keys: •

Tab key – Completes a partially typed command. For example, if you type the tab key after you type show ve at the Superuser command prompt, the show version command will be executed.

•

Up arrow – Recalls the last command.

•

Ctrl-F – Moves forward to the next session.

•

Ctrl-B – Moves back to the previous session.

•

Ctrl-L – Returns you to the Local Command Mode. NOTE: You must press the Enter key after you type Ctrl-F, Ctrl-B, or Ctrl-L.

22

451-0310E

Preface

Navigating the LX Command Line Interface (CLI) The LX CLI is structured as a set of nested command modes. Each command mode is used to implement a group of related features or functions. Figure 1 (below) lists the command modes in the LX CLI.

User Enter “enable” command and login to Superuser command mode

Superuser Notification Cconfiguration

Nnotification

SNMP

Ssnmp

Configuration Ibroadcast group

Pport ethernet

Pport async Ssubscriber

Iinterface

Broadcast Group

Asynchronous

Mmenu

Interface Menu Oopen

Ethernet

Subscriber

Pppp

PPP

Mmodem

Modem

Menu Editing Figure 1 - LX Command Modes Each command mode has its own command prompt (e.g., Config:0 >>) and its own set of commands. Type a question mark (?) (or press the Tab key) at any of the LX CLI command prompts to display the commands that can be executed in the current command mode. For example, type a question mark at the Menu :0 >> prompt to display the commands that can be executed in the Menu command mode.

451-0310E

23

Preface Except for the User command mode, each command mode is nested in a previous command mode. (The User command mode is the basic command mode of the LX CLI; you are in the User command mode when you log in to the LX unit.) For example, the Superuser command mode is nested in User command mode; the Configuration command mode is nested in the Superuser command mode, and so on. To enter a nested command mode, you must enter the appropriate command from the previous command mode. For example, to enter the Configuration command mode you must enter the configuration command from the Superuser command mode. You can use the exit command to return to the previous command mode. For example, you would enter the exit command in the Configuration command mode to return to the Superuser command mode. The rest of this section describes the LX command modes and the commands that are used to access each of them.

User Command Mode When you log on to the LX unit, you are in the User command mode. This is indicated by the User command prompt (e.g., InReach:0 >). The User command mode includes commands for doing the following: •

Managing your LX session and terminal.

•

Pinging remote hosts.

•

Connecting to remote hosts via SSH and Telnet.

•

Displaying your subscriber-specific information.

•

Accessing the Superuser command mode.

Refer to “User Commands” on page 33 for detailed information on the commands that you can execute in the User Command Mode.

24

451-0310E

Preface

Superuser Command Mode The Superuser command prompt (e.g., InReach:0 >>) is displayed when you are in the Superuser command mode. You can access the Superuser command mode by executing the enable command in the User command mode (see “enable” on page 36). In the Superuser command mode, you can perform all of the tasks that you can perform in User command mode, as well as the following: •

Manage the LX unit.

•

Display global information for the LX unit.

•

Access the Linux shell.

•

Access the Configuration command mode.

Refer to “Superuser Commands” on page 65 for detailed information on the commands that you can execute in the Superuser Command Mode.

Configuration Command Mode The Configuration command prompt (e.g., Config:0 >>) is displayed when you are in the Configuration command mode. You can access the Configuration command mode by executing the configuration command in the Superuser command mode (see “configuration” on page 67). In the Configuration command mode, you can perform such tasks as the following: •

Specify the server-level configuration of the LX unit. The server-level configuration includes the Superuser password and settings for ppciboot, RADIUS, the Network Time Protocol (NTP), and all other server-level features.

•

Access the Asynchronous command mode.

•

Access the Ethernet command mode.

•

Access the Interface command mode.

451-0310E

25

Preface •

Access the Menu command mode.

•

Access the Notification command mode.

•

Access the SNMP command mode.

•

Access the Subscriber command mode.

Refer to “Configuration Commands” on page 159 for detailed information on the commands that you can execute in the Configuration Command Mode.

Asynchronous Command Mode The Asynchronous command prompt (e.g., Async 4-4:0 >>) is displayed when you are in the Asynchronous command mode. You can access the Asynchronous command mode by executing the port async command in the Configuration command mode (see “port async” on page 194). In the Asynchronous command mode, you can do the following: •

Configure asynchronous port settings such as access methods, APD settings, autobaud, autodial, flow control, and inbound and outbound authentication.

•

Access the PPP command mode.

•

Access the Modem command mode.

Refer to “Asynchronous Commands” on page 307 for detailed information on the commands that you can execute in the Asynchronous Command Mode.

Ethernet Command Mode The Ethernet command prompt (e.g., Ether 1-1:0 >>) is displayed when you are in the Ethernet command mode. You can access the Ethernet command mode by executing the port ethernet command in the Configuration command mode (see “port ethernet” on page 195). In the Ethernet command mode, you can configure Ethernet port descriptions and the duplex mode and speed of Ethernet ports. Refer to “Ethernet Commands” on page 361 for detailed information on the commands that you can execute in the Ethernet Command Mode.

26

451-0310E

Preface

PPP Command Mode The PPP command prompt (e.g., PPP 4-4:0 >>) is displayed when you are in the PPP command mode. You can access the PPP command mode by executing the ppp command in the Asynchronous command mode (see “ppp” on page 348). In the PPP command mode, you can configure the Point-to-Point Protocol (PPP) for asynchronous ports. Some of the settings that you can configure include accounting, authentication, IPCP parameters, and LCP parameters. Refer to “PPP Commands” on page 447 for detailed information on the commands that you can execute in the PPP Command Mode.

Modem Command Mode The Modem command prompt (e.g., Modem 4-4:0 >>) is displayed when you are in the Modem command mode. You can access the Modem command mode by executing the modem command in the Asynchronous command mode (see “modem” on page 338). In the Modem command mode, you can configure external modems for asynchronous ports. Some of the settings that you can configure include DTRWAIT, dialout, and the modem initialization string. Refer to “Modem Commands” on page 437 for detailed information on the commands that you can execute in the Modem Command Mode.

Subscriber Command Mode The Subscriber command prompt (e.g., Subs_mark >>) is displayed when you are in the Subscriber command mode. You can access the Subscriber command mode by executing the subscriber command in the Configuration command mode (see “subscriber” on page 247). In the Subscriber command mode, you can provision subscribers of the LX unit. Some of the subscriber settings include function keys, Telnet settings, and security settings. Refer to “Subscriber Commands” on page 367 for detailed information on the commands that you can execute in the Subscriber Command Mode.

451-0310E

27

Preface

SNMP Command Mode The SNMP command prompt (e.g., Snmp:0 >>) is displayed when you are in the SNMP command mode. You can access the SNMP command mode by executing the snmp command in the Configuration command mode (see “snmp” on page 242). In the SNMP command mode, you can configure the SNMP settings for an LX unit. Refer to “SNMP Commands” on page 409 for detailed information on the commands that you can execute in the SNMP Command Mode.

Interface Command Mode The Interface command prompt (e.g., Intf 1-1:0 >>) is displayed when you are in the Interface command mode. You can access the Interface command mode by executing the interface command in the Configuration command mode (see “interface” on page 180). In the Interface command mode, you can configure interfaces for the LX unit. Some of the settings that you can configure include the IP settings, MTU, and IP Rotaries for the interface, as well as SSH and Telnet settings. Refer to “Interface Commands” on page 275 for detailed information on the commands that you can execute in the Interface Command Mode.

Menu Command Mode The Menu command prompt (e.g., Menu :0 >>) is displayed when you are in the Menu command mode. You can access the Menu command mode by executing the menu command in the Configuration command mode (see “menu” on page 184). In the Menu command mode, you can delete, import, and display menus and access the Menu Editing command mode. Refer to “Menu Commands” on page 479 for detailed information on the commands that you can execute in the Menu Command Mode.

28

451-0310E

Preface

Menu Editing Command Mode The Menu Editing command prompt (e.g., mark-1:0 >>) is displayed when you are in the Menu Editing command mode. You can access the Menu Editing command mode by executing the open command in the Menu command mode (see “open” on page 486). In the Menu Editing command mode, you can create and modify menus. Refer to “Menu Editing Commands” on page 487 for detailed information on the commands that you can execute in the Menu Editing Command Mode.

Notification Command Mode The Notification command prompt (e.g., Notification:0 >>) is displayed when you are in the Notification command mode. You can access the Notification command mode by executing the notification command in the Configuration command mode (see “notification” on page 186). In the Notification command mode, you can configure the sending of accounting log messages to pagers, email addresses, SNMP trap clients, local files, remote hosts, syslogd, and asynchronous ports. Refer to “Notification Commands” on page 509 for detailed information on the commands that you can execute in the Notification Command Mode.

Broadcast Group Command Mode The Broadcast Group command prompt (e.g., BrGroups 6:0 >>) is displayed when you are in the Broadcast Group command mode. You can access the Broadcast Group command mode by executing the broadcast group command in the Configuration command mode (see “broadcast group” on page 163). In the Broadcast Group command mode, you can configure a Broadcast Group. A Broadcast Group consists of Slave Ports and Master Ports. The Slave Ports receive data broadcasts from the Master Ports, or vice versa. Refer to “Broadcast Group Commands” on page 535 for detailed information on the commands that you can execute in the Broadcast Group Command Mode.

451-0310E

29

Preface

Online Help The question mark character (?), and the Tab key, are used to display online help in the LX Command Line Interface (CLI). The following guidelines will help you to navigate the online help system: •

Type the ? character (or press the Tab key) at the command prompt in any command mode to display the first keyword of each command that can be executed in that command mode. For example, the following is displayed when you type the ? character at the User mode command prompt: User Commands: clear disconnect enable exit no pause ping show ssh telnet terminal

•

30

Clear screen and reset terminal line Disconnect session Turn on privileged commands Exits and disconnects user Negate Pause enable Send echo messages Show running system information Secured Shell (Triple-DES/Blowfish) Open a telnet connection Set the terminal type

Type the ? character (or press the Tab key) after the displayed keyword to list the options for that keyword. For example, type show? to list the options of the show keyword. You could then type show port? to list the next item in the syntax of the show port command.

451-0310E

Preface

Related Documents For detailed information on the LX commands, refer to the LX-Series Configuration Guide (P/N 451-0311B). For more information on the LX hardware, refer to Getting Started with the LX Series (P/N 451-0308E). The LX Quick Start Instructions (P/N 451-0312F) describes how to get the LX unit up and running.

451-0310E

31

Preface

32

451-0310E

Chapter 1 User Commands

The User commands are executed in the User command mode. The User command mode is in effect immediately upon logging in to the LX unit. The User Command prompt indicates that the LX unit is in the User command mode. The format of the User command prompt is as follows: : > where

is the username that was entered at the Login: prompt. is the session number of the current connection.

For example, in the InReach:0 > prompt, the username is InReach and the session number is 0. The rest of this chapter describes the commands that you can enter in the User command mode.

451-0310E

33

clear Clear the screen and removes any user input from the command buffer. Syntax clear Example clear

34

451-0310E

disconnect Disconnects a session to the LX unit. NOTE: You can not use this command to disconnect the current session. For example, you can not use this command to disconnect session 0 when you are logged in to session 0. Syntax disconnect NUMBER|all Where

Means

NUMBER

The session number of the session that is to be disconnected.

all

Disconnect all sessions other than the session from which this command is executed.

Examples disconnect 3 disconnect all

451-0310E

35

enable Displays a password prompt for logging into Superuser mode. When you are logged into Superuser mode, you can execute the Superuser commands. Refer to “Superuser Commands” on page 65 for more information on the Superuser commands. Syntax enable Usage Guidelines When you execute the enable command, the Password: prompt is displayed: To enter Superuser mode, you must enter a Superuser password at the Password: prompt. The default Superuser password is system. The Superuser prompt is displayed when you are in Superuser mode. The Superuser prompt is in the following format: : >> where is the username that was entered at the Login: prompt. is the session number of the current connection. For example, in the InReach:0 >> prompt, the username is InReach and the session number is 0. Example enable

36

451-0310E

exit When the exit command is executed in User Mode, it exits the LX CLI and closes the connection to the LX unit. Syntax exit Usage Guidelines The exit command can be issued in all of the LX Command Modes. However, the effect of the exit command varies, depending on the mode from which it is issued. As noted above, issuing the exit command in User Mode exits the LX CLI and closes the connection to the LX unit. Issuing the exit command in any mode other than User returns the user to the previous command mode. For example, issuing the exit command in Superuser Mode returns the user to User Mode; issuing the exit command in Configuration Mode returns the user to Superuser Mode, and so on. Example exit

451-0310E

37

no Disables (negates) specific features and boolean parameters on the LX unit. Refer to “Usage Guidelines” (below) for more information about using the no command in the User mode. Syntax no Where

Means

feature_name

The name of the feature or boolean parameter that is to be disabled.

Usage Guidelines The allowable arguments for this command consist of only those features and boolean parameters that can be set in the User command mode and are currently enabled. To view the features and boolean parameters that are currently enabled, type the no command followed by a question mark (?).

Example no pause

38

451-0310E

pause enable Configures the screen to pause after displaying the number of lines specified in the “lines/screen” value for the terminal. Syntax pause enable Example pause enable

451-0310E

39

ping Sends a series of 4 echo messages to a destination host. Syntax ping [A.B.C.D|NAME] Where

Means

A.B.C.D

The IP Address of the destination host. (See “Usage Guidelines” (below) for the default value of this field.)

NAME

The domain name of the destination host. (See “Usage Guidelines” (below) for the default value of this field.)

Usage Guidelines If a destination host is not specified, the echo message is sent to the default destination host which is your Preferred Service. Refer to the preferred service command on page 399 for information on configuring a Preferred Service. If the ping command is executed without a destination host, and you do not have a Preferred Service configured, the following error message is displayed: No Preferred Service Configured Examples ping 119.20.112.3 ping ping FinanceServer

40

451-0310E

show clock Displays the day, date, time, and timezone for the LX unit. Syntax show clock Example show clock Figure 2 shows an example of the clock display. Mon, 24 Mar 2003 14:39:16 UTC

Figure 2 - Clock Display

451-0310E

41

show port Displays the user-level port information for the LX port where you are connected. NOTE: You cannot execute this command on a virtual port or on the DIAG port (port 0). NOTE: You must be in Superuser Mode to display port information for ports other than the one where you are connected. Refer to Chapter 2 for more information on the Superuser show port commands. Syntax show port characteristics|apd|modem|ppp|status Where

Means

characteristics

Displays general port characteristics. Refer to “Port Characteristics” on page 43 for descriptions of the general port characteristics.

apd

Displays the port APD settings. Refer to “Port APD Settings” on page 46 for descriptions of the port APD settings.

modem

Displays the port Modem settings. Refer to “Port Modem Settings” on page 47 for descriptions of the port Modem settings.

ppp

Displays the port PPP settings. Refer to “Port PPP Settings” on page 48 for descriptions of the port PPP settings.

status

Displays the port status information. Refer to “Port Status Display” on page 50 for descriptions of the port status information.

Examples show port characteristics show port apd show port modem show port ppp show port status

42

451-0310E

show port (continued) Port Characteristics Figure 3 shows an example of the Port Characteristics screen. Time: Mon 24 Mar 2003 19:10:43 Banner: Welcome to MRV Communications, In-Reach Product Division. Port Number: 5 Transparent Mode: Enabled Access: Databuffer Flow Control: Xon Port Name: N/A Stop Bits: 1 Port Type: Physical Parity: None Device Name: /dev/pts/4 Bits per Character: 8 Port Prompt String: login Autobaud: Disabled Break: Enabled Auto Dial: Disabled Special Break String: 1234 Autobaud Retry: 5 Telnet Negotiations: Disabled Autohangup: Disabled Telnet Cr filter: N/A Radius Accounting: Disabled Inbound Authentication: Disabled Tacacs+ Accounting: Disabled Outbound Authentication: Disabled Data Buffer Size: 1024 Authentication FallBack: Disabled Data Buffer Display: Disabled Data Buffer Time Stamp: Enabled Data Buffer Syslog: Enabled Connect Command: export MYPALMDIR=/root/palm

Figure 3 - Port Characteristics Screen Field

Description

Time

The date and time that the show port characteristics command was executed.

Banner

The version of LX software that is running on the LX unit.

Port Number

The port at which you are logged in.

Access

The type of access the port can have to a service node, and/or the type of access other interactive users and service nodes can have to the port. The possible values are: Dynamic, Local, Remote, Databuffer, Power, or Sensor.

Port Name

An ASCII string that is typically used to identify the port that is displayed in this screen.

Port Type

The port Type. The possible values are Serial, Ethernet, and Virtual.

Device Name

The device name of the port.

Port Prompt String

The prompt that is displayed when a user logs in to this port. If this is a custom prompt, this field will contain the custom prompt. If this is the default login prompt, this field will contain “login”.

Break

The action the port will take when the user presses the BREAK key. The possible values are Enabled or Disabled.

Special Break String

The unique break string for the port.

451-0310E

43

show port (continued)

Telnet Negotiations

Indicates whether Telnet Negotiations are Enabled or Disabled.

Telnet CR Filter

Indicates the filtering for carriage returns in Telnet sessions.

Inbound Authentication

Indicates whether inbound authentication is Enabled or Disabled on the port.

Outbound Authentication

Indicates whether outbound authentication is Enabled or Disabled on the port.

Authentication Fallback

Indicates whether users can log in by Fallback if the authentication server (RADIUS or TACACS+) is unreachable. The possible settings of this field are Enabled and Disabled.

Data Buffer Time Stamp

Indicates whether the Data Buffer Timestamp feature is Enabled or Disabled.

Connect Command

The command, or commands, that are executed when a connection to the port is made.

Transparent Mode

Indicates whether Transparent Mode is Enabled or Disabled on the port.

Flow Control

The flow control ("handshaking") method used by the serial interface to control data transfer between the LX port and the device connected to the port. The possible values are XON, CTS, and NONE (disabled). The default value is XON.

Stop Bits

The number of stop bits used to maintain synchronization of data. The possible values are 1 or 2.

Parity

The method by which the LX unit and the device connected to the port check for single-bit errors in characters transmitted or received by the port. (This is called a parity check because the device provides an extra bit, called a parity bit, for error checking.) The possible values are EVEN, NONE, and ODD, and the default value is NONE.

Bits per Character

The number of bits per character for data characters that are transmitted or received over the serial connection between the LX port and the device connected to the port. The possible values are 7 or 8 bits. The default value is 8.

Autobaud

Indicates whether Autobaud is enabled or disabled on the port. If Autobaud is enabled, the port will attempt to determine the speed of incoming connections.

Auto Dial

Indicates whether Auto Dial is Enabled or Disabled for the port. Auto Dial consists of the Dialback and Dialout features.

Autobaud Retry

The number of times that the LX port will attempt to determine the speed of an incoming connection.

44

451-0310E

show port (continued) Autohangup

Indicates whether the port will log out when the last session is terminated. The allowable values are Enabled and Disabled.

RADIUS Accounting

Shows the current status of RADIUS accounting. The valid values are Enabled or Disabled.

TACACS+ Accounting

Shows the current status of TACACS+ accounting. The valid values are Enabled or Disabled.

Data Buffer Size

The size, in bytes, of the port data buffer.

Data Buffer Display

Indicates whether the contents of the databuffer will be displayed when the user logs into the port. The allowable values are Enabled and Disabled.

Data Buffer Syslog

Indicates whether the Data Buffer syslog feature is Enabled or Disabled.

451-0310E

45

show port (continued) Port APD Settings Figure 4 shows an example of the Port APD Settings screen. Time: Mon 24 Mar 2003 12:50:42 UTC Banner: MRV Communication Linux 2.4.9.8 Rel 0.0.34 Device Name: /dev/pts/0 Port Number: 5 Apd Feature: Enabled Apd Timeout: 0 Apd Signature: 414141 Port Name: Port_1 Apd Retry: 0 Port Type: Physical

Figure 4 - Port APD Settings Screen Field

Description

Time

The date and time that the show port characteristics command was executed.

Banner

The field identifies the release of Linux and the version of the LX software that is running on the LX unit.

Device Name

The port name.

Apd Feature

Shows whether Automatic Protocol Detection (APD) is Enabled or Disabled on this port.

Apd Signature

The signature of the expected protocol.

Apd Retry

The number of retries that remote hosts can have after they fail to make an APD connection on the first try.

Apd Timeout

The length of time, in seconds, that the port can spend in an attempt to determine which protocol is being used to make a connection.

Port Type

The port Type. The possible values are Serial, Ethernet, and Virtual.

Port Number

The port at which you are logged in.

Port Name

The name of the LX port.

46

451-0310E

show port (continued) Port Modem Settings Figure 5 shows an example of the Port Modem Settings screen. Time: Mon 24 Mar 2003 12:50:42 UTC Banner: MRV Communication Linux 2.4.9.8 Rel 0.0.34 Device Name: /dev/pts/0 Port Number: Port Type: Virtual Port Name: Modem Control: Disabled Modem Timeout: Modem Retry: 6 Modem Dial Type: Modem Dialout Num.: 19785558371 Modem Init String: AT S7=45 S0=1 L1 V1 X4 &C1 &1 Q0 &S1

7 N/A 40 N/A

Figure 5 - Port Modem Settings Field

Description

Time

The date and time that the show port characteristics command was executed.

Banner

The field identifies the release of Linux and the version of the LX software that is running on the LX unit.

Device Name

The port name.

Port Type

The port Type. The possible values are Serial, Ethernet, and Virtual.

Modem Control

Shows whether the PPP modem feature is Enabled or Disabled on this port.

Modem Retry

The number of times the LX unit attempts to connect to the remote modem.

Modem Dialout Num.

The telephone number that the modem will dial for a dialout connection.

Modem Init String

A configuration string that is sent to the remote modem.

Port Number

The Port Number.

Port Name

A text string that typically identifies the modem port.

Modem Timeout

The length of time that the remote modem has to respond to the LX unit.

Modem Dial Type

Indicates whether the Modem Type for the port is Dial In or Dial Out.

451-0310E

47

show port (continued) Port PPP Settings Figure 6 shows an example of the PPP Settings screen. Time: Port Device: /dev/pts/2 PPP Feature: Disabled PPP Mode: Server Passive PPP Authent: None PPP Port Type: Physical PPP Local IP Address: 0.0.0.0 PPP Remote IP Address: 0.0.0.0 PPP LCP Compress.: Enabled PPP LCP Failure Limit: 10 PPP LCP Echo Failure Limit: 0 PPP LCP Echo Interval: 0 PPP LCP Timeout: 4 PPP CCP: Enabled Port Name: N/A Client Mode Username: Client Mode PAP Secret: Client Mode CHAP Secret:

Mon 24 Mar 2003 19:08:19 UTC Port Number: N/A PPP Debug: Disabled PPP MTU: 1400 PPP Authent. Retry: 3 PPP Authent. Timeout: 60

PPP PPP PPP PPP PPP PPP

IPCP Compress.(VJ): IPCP Failure Limit: IPCP Timeout: IPCP Accept Remote: IPCP Accept Local: Accounting:

Enabled 10 4 Disabled Disabled Disabled N/A N/A N/A

Figure 6 - Port PPP Settings Screen Field

Description

Port Device

The port name.

PPP Feature

Indicates whether the Point-to-Point Protocol (PPP) is Enabled or Disabled on the port.

PPP Mode

Indicates the PPP Mode for the port. The possible values are Client, Server Active, or Server Passive.

PPP Authent

The PPP Authentication method for the port. The allowable values are PAP, CHAP, and None.

PPP Port Type

The PPP port type.

PPP Local IP Address

The IP Address assigned to the port.

PPP Remote IP Address

The IP address of the remote device that the port will attempt to negotiate when the remote device does not specify an Internet address on its own.

PPP LCP Compress

Indicates whether the use of LCP compression is Enabled or Disabled over the PPP link.

PPP LCP Failure Limit

The number of attempts at LCP option negotiation that can be made by the port.

48

451-0310E

show port (continued) PPP LCP Echo Failure Limit

The interval between the sending of LCP echo requests.

PPP LCP Timeout

The length of time that the port has for LCP option negotiation.

PPP CCP

Indicates whether the PPP Compression Control Protocol (CCP) is Enabled or Disabled for the port.

Port Name

The name of the PPP port.

Client Mode Username

The username for the PAP client.

Client Mode PAP Secret

The PAP authentication secret for the PPP client.

Client Mode CHAP Secret

The CHAP authentication secret for the PPP client.

Port Number

The port at which you are currently logged in.

PPP Debug

Indicates whether PPP debugging is Enabled or Disabled on the port.

PPP MTU

The Maximum Transmission Unit (MTU) for PPP links on the port.

PPP Authent. Retry

The number of times that the port can attempt to authenticate a PPP link.

PPP Authent. Timeout

The length of time that the port has to authenticate a PPP link.

PPP IPCP Compress.

Indicates whether the use of Van Jacobson (VJ) compression is Enabled or Disabled over the PPP link.

PPP IPCP Failure Limit

The number of attempts at IPCP option negotiation that can be made by the port.

PPP IPCP Timeout

The length of time that the port has for IPCP option negotiation.

PPP IPCP Accept Remote

Indicates whether the port is configured to accept or reject the negotiation of remote addresses. If the value is Enabled, the port is configured to accept the negotiation of remote addresses. If the value is Disabled, the port is configured to reject the negotiation of remote addresses.

PPP IPCP Accept Local

Indicates whether the port is configured to accept or reject the negotiation of local addresses. If the value is Enabled, the port is configured to accept the negotiation of local addresses. If the value is Disabled, the port is configured to reject the negotiation of local addresses.

PPP Accounting

Indicates whether PPP accounting is Enabled or Disabled on the port.

451-0310E

49

show port (continued) Port Status Display Figure 7 shows an example of the port status screen for non-outlet ports.

Time: Mon 24 Mar 2003 13:19:01 UTC Port Device: /dev/ttyGN8 Remote Partner Host IP Address: Locally Connected by IP Address: Autobaud: Enabled Port Lock Status: In Use Transmit Bytes: 137260 Frame Errors: 0 Parity Errors: 0 Buffer Overruns: 0 Last Transmit Char: 0x0 Input Signals: CTS= DSR=

Up Up

Port Number:

8 0.0.0.0 0.0.0.0 Speed: 9600 Port Name: Port_8 Receive Bytes: 8728 Overrun Errors: 0 Break Signals: 2 IRQ Number: 4 Last Receive Char: 0x0

Output Signals: RTS= DTR=

Up Up

Figure 7 - Port Status Screen (non-outlet) Field

Description

Port Device

The name of the port.

Remote Partner Host IP Address

If the port is connected to a remote host, the IP Address of the remote host appears in this field.

Locally Connected by IP Address

If the port is locally connected to a host, the IP Address of the LX unit, or the rotary address for the port, appears in this field.

Autobaud

Indicates whether Autobaud is enabled or disabled on the port. If Autobaud is enabled, the port will attempt to determine the speed of incoming connections.

Port Lock Status

Indicates whether or not the port is locked.

Transmit Bytes

The number of bytes transmitted on the port since the counters were last reset to zero.

Frame Errors

The number of bytes received at the port with illegally formatted frames, since the counter was reset to zero. Frequent framing errors (more than 20 per day for a terminal; 200 per day for a modem) may indicate a problem with the port or the device attached to the port, or mismatched settings between the port and the data received from the attached serial device.

50

451-0310E

show port (continued)

Parity Errors

The number of bytes received at the port with parity errors, since the counters were reset to zero. Frequent parity errors (more than 20 per day for a terminal; 200 per day for a modem, due to line noise) may indicate a problem with the port or the device attached to the port, or mismatched settings between the port and the device connected to the port.

Buffer Overruns

The number of times characters were lost because the LX unit input buffers were full, since the counters were reset to zero. Buffer overruns indicate that there may be a flow control problem, such as mismatched flow control methods, between the port and the device connected to the port.

Last Transmit Char

The last character transmitted on the port.

Input Signals

The status of the port CTS and DSR signals.

Port Number

The port number of the asynchronous port.

Time

The day, date, and time of the LX system clock.

Speed

The port speed.

Port Name

The name of the asynchronous port.

Receive Bytes

The number of bytes received on the port since the counters were last reset to zero.

Overrun Errors

The number of port overrun errors since the counters were last reset to zero.

Break Signals

The number of break signals since the counters were last reset to zero.

IRQ Number

The IRQ Number for the port.

Last Receive Char

The last character received on the port.

Output Signals

The status of the port RTS and DTR signals.

451-0310E

51

show port (continued) Figure 8 shows an example of the port status screen for outlet ports.

Time: Mon 24 Mar 2003 20:05:47 Device Type: Model Name: Total Outlet Strip Load: Outlet Minimum Off Time: Outlet Name State 1 plug1 On 2 plug2 On 3 plug3 On 4 plug4 On 5 plug5 On 6 plug6 On 7 plug7 On 8 plug8 On 9 plug9 On 10 plug10 On 11 plug11 On 12 plug12 On 13 plug13 On 14 plug14 On 15 plug15 On 16 plug16 On

Device Number:

Load N/A N/A N/A N/A N/A N/A N/A N/A N/A N/A N/A N/A N/A N/A N/A N/A

4 IR5150 N/A 0.25 15 Assigned Groups 1 4 13 1 6 10 1 7 1 2 4 2 2 2 3 4 3 3 3 4 5 4 5 4 5 5

Figure 8 - Port Status Screen (Outlet) Field

Description

Device

Identifies the type of Power Control unit.

Model Name

The Model Name of the Power Control unit.

Total Outlet Strip Load

The total load for the Power Control unit.

Outlet Minimum Off Time

The minimum time that outlets in this Power Control unit must remain off after they are turned off with the outlet or outlet group command.

Outlet

The Outlet Number of an outlet.

Name

The descriptive name of an outlet.

State

The ON or OFF state of the outlet.

Load

The load on the outlet.

Assigned Groups

The outlet groups to which the outlet is assigned.

52

451-0310E

show service Displays the names and addresses of the available services. Syntax show service Example show service Figure 9 shows an example of the Service screen. Mon, 08 Apr 2002 13:14:40 UTC Service Name dewey huey

IP Address 123.123.1.1 123.123.1.2

Figure 9 - Service Screen Field

Description

Service

The name of an available service or server/host.

IP Address

The IP Address of the available service

451-0310E

53

show session Displays information about your opened connections, including opened sessions to services or hosts on the network, as well as CLI sessions opened on the port. Syntax show session Where

Means

session_number

The session number of an opened connection.

Example show session 3 Figure 10 shows an example of the Session screen. Number 3

Device /dev/pts/1

Program cli

Pid 8384

Time 2589

Status *

Figure 10 - Session Screen Field

Description

Number

The Session Number. The possible values are 1, 2, 3, or 4.

Device

The Linux port name.

Program

The program running on the LX unit.

Pid

The Process ID for the session.

Time

The time elapsed since the start of the session.

Status

Indicates whether the displayed session is the active session. An asterisk (*) means that the displayed session is the active session. An hyphen (-) means that the displayed session is not the active session.

54

451-0310E

show subscriber Displays your subscriber information. Syntax show subscriber characteristics|status|tcp Where

Means

characteristics

Displays your subscriber characteristics. Refer to “Subscriber Characteristics” on page 56 for descriptions of the subscriber characteristics.

status

Displays your subscriber status information. Refer to “Subscriber Status” on page 59 for descriptions of the status information for subscribers.

tcp

Displays your subscriber TCP settings. Refer to “Subscriber TCP Settings” on page 60 for descriptions of your subscriber TCP settings.

Examples show subscriber characteristics show subscriber status show subscriber tcp

451-0310E

55

show subscriber (continued) Subscriber Characteristics Figure 11 shows an example of the Subscriber Characteristics screen. Subscriber Name: Security: Preferred Service: Command Logging: Maximum Connections: Shell : Debug Feature: Idle Timeout: Menu Feature: Forward Switch: Backward Switch: Dialback Retry: Dialback Timeout: Port Access list: Remote Access list:

demo Superuser Disabled 50 Disabled Disabled 0 Disabled ^F ^B 4 45

User Prompt: Dedicated Service: User Password: Maximum Sessions: Screen Pause: Debug File: Session Timeout: Menu Name: Local Switch: Dialback Feature: Dialback Number: Audit Feature:

Demo Disabled 4 Enabled /tmp/D_demo 0 /config/M_demo ^L Disabled

Disabled 1-8 Telnet Ssh Web_Server

Figure 11 - Subscriber Characteristics Screen Field

Description

Subscriber Name

The name under which the subscriber is logged in.

Security

The level of security that the subscriber has. The possible values are None and Superuser.

Preferred Service

The service to which the subscriber will be connected when the subscriber makes a connect request without specifying a service.

Command Logging

Indicates whether the Command Logging Feature is Enabled or Disabled for the subscriber.

Maximum Connections

The maximum number of concurrent connections that the subscriber can have to the LX unit.

Shell

Indicates whether the Shell mode is Enabled or Disabled for this subscriber.

Debug Feature

Shows whether the Debug feature is enabled for this user. The allowable values are Enabled and Disabled.

Idle Timeout

The length of time that the subscriber can go without entering keyboard data before she is logged out.

Menu Feature

Indicates whether a menu will be displayed when the subscriber successfully logs in to the LX unit. The allowable values are Enabled and Disabled. Note: If this feature is Enabled, a Menu Name must be specified for the user. For more information, refer to the Menu Name field (below).

56

451-0310E

show subscriber (continued)

Forward Switch

The keyboard character that the subscriber types to switch to the next session.

Backward Switch

The keyboard character that the subscriber types to switch to the previous session.

Dialback Retry

The number of times that the modem on the LX unit can attempt to answer a dialback call.

Dialback Timeout

The length of time that the modem can spend attempting to make a modem connection.

Port Access List

The LX ports that the user can access.

Remote Access List

The methods that the user can use to make remote connections.

User Prompt

The subscriber-specific field of the subscriber User prompt. For example, for a subscriber prompt of InReach:0 >, the subscriberspecific field is InReach.

Dedicated Service

The service to which the subscriber is permanently assigned.

User Password

Indicates whether or not the subscriber must enter a password when he logs in to the account. If the value of this field is Enabled, the subscriber must enter a password when logging in to this account. If the value of this field is Disabled, the subscriber does not enter a password when logging in to this account.

Maximum Sessions

The maximum number of concurrent sessions allowed for the subscriber.

Screen Pause

Indicates whether or not the screen is enabled to pause after 26 lines of output are displayed.

Debug File

Shows the location and filename of the Debug file for this subscriber on the LX unit.

Session Timeout

Indicates the maximum length of time for a subscriber session. The allowable values are 0 through 65535. A value of 0 means that there is no limit to the length of a subscriber session.

Menu Name

Shows the location and filename of the subscriber menu on the LX unit.

Local Switch

The keyboard character that the subscriber types to return to the local command mode.

Audit Feature

Indicates whether the Audit feature is Enabled or Disabled.

451-0310E

57

show subscriber (continued)

Dialback Feature

Indicates whether or not the subscriber requires a dialback script in order to be logged in. (The dialback script contains commands that cause a modem to dial a designated telephone number.) The allowable values are Enabled and Disabled.

Dialback Number

The telephone number that the LX modem will dial when the subscriber makes a Dialback call to the LX unit.

58

451-0310E

show subscriber (continued) Subscriber Status Figure 12 shows an example of the Subscriber Status screen. Time: Subs. Name: Configured TermType:

InReach ANSI

Mon, 08 Apr 2002 14:39:16 UTC Number of Connections: 1 Session Mode: Normal

Figure 12 - Subscriber Status Screen Field

Description

Subs. Name

The name under which the subscriber is logged in.

Configured TermType

The terminal type that is configured for the subscriber.

Session Mode

The Telnet binary option for the subscriber session.

Number of Connections

The number of connections that the subscriber currently has to the LX unit.

451-0310E

59

show subscriber (continued) Subscriber TCP Settings Figure 13 shows an example of the TCP Settings screen. Time: Subscriber Name: SSH Name: SSH Port:

InReach InReach 22

Mon, 08 Apr 2002 14:39:16 UTC Telnet Line Mode: Character Mode SSH Encryption: Triple-DES SSH Log Level: 23

Figure 13 - TCP Settings Screen Field

Description

Subscriber Name

The name under which the subscriber is logged in.

Telnet Line Mode

Indicates the Telnet Line Mode. The possible values are Character and Block.

SSH Name

The SSH Name for the subscriber.

SSH Port

The ports that are enabled as SSH ports for this subscriber.

SSH Encryption

The form of SSH encryption used by the subscriber.

SSH Log Level

The Revision Level of the SSH Log for this subscriber.

60

451-0310E

show version Displays the Linux OS version, Linux In-Reach version, LX software version, and ppciboot version for the LX unit. Syntax show version Example show version Figure 14 shows an example of the Version screen. Linux Kernel Version: Linux In-Reach Version: Software Version: Ppciboot Version:

2.4.9 15 2.2.0 0.9.3.26

Figure 14 - Version Screen Field

Description

Linux Kernel Version

The version of the Linux Operating System that is running on the LX unit.

Linux In-Reach Version

The version of the In-Reach implementation of Linux.

Software Version

The version of the LX software that is running on the LX unit.

Ppciboot Version

The version of ppciboot that the LX unit is using.

451-0310E

61

ssh Opens a Secure Shell (Triple-DES/BLOWFISH) connection. Syntax ssh [A.B.C.D [NUMBER]]|[NAME [NUMBER]] [LOGIN NAME] Where

Means

A.B.C.D

The IP Address of the SSH server to which the connection is being made. (See “Usage Guidelines” (below) for the default value of this field.)

NAME

The Domain Name of the SSH server to which the connection is being made. (See “Usage Guidelines” (below) for the default value of this field.)

NUMBER

The socket number to which the connection is being made.

LOGIN NAME

The name that you are using to log in to the SSH server.

Usage Guidelines The default SSH server is your Preferred Service. Refer to the preferred service command on page 399 for information on configuring a Preferred Service. If the ssh command is executed without an SSH server, and you do not have a Preferred Service configured, the following error message is displayed: No Preferred Service Configured Examples ssh 102.19.240.14 ssh 102.19.240.14 2322 ssh ssh 102.19.240.14 2322 henryh

62

451-0310E

telnet Opens a Telnet connection to a host. Syntax telnet [A.B.C.D [NUMBER]]|[NAME [NUMBER]] Where

Means

A.B.C.D

The IP Address of the Telnet host. (See “Usage Guidelines” (below) for the default value of this field.)

NAME

The Domain Name of the Telnet host. (See “Usage Guidelines” (below) for the default value of this field.)

NUMBER

The socket number to which the connection is being made.

Usage Guidelines The default Telnet host is your Preferred Service. Refer to the preferred service command on page 399 for information on configuring a Preferred Service. If the telnet command is executed without a Telnet host, and you do not have a Preferred Service configured, the following error message is displayed: No Preferred Service Configured Examples telnet 102.19.240.14 telnet 102.19.240.14 2500 telnet

451-0310E

63

terminal Sets the terminal type for the LX user. Syntax terminal Where

Means

terminal_type

The terminal type for the LX user. The allowable terminal types are VT100 and ANSI.

Example terminal vt100 terminal ansi

64

451-0310E

Chapter 2 Superuser Commands

The Superuser commands are executed in the Superuser command mode. When the LX unit is in the Superuser command mode, the Superuser command prompt (e.g., InReach:0 >>) is displayed on the terminal screen. The format of the Superuser command prompt is as follows: : >> where

is the username that was entered at the Login: prompt. is the session number of the current connection.

For example, in the InReach:0 >> prompt, the username is InReach and the session number is 0. To enter the Superuser command mode, do one of the following: •

If you are in the User command mode, execute the enable command. This displays the Password: prompt. Enter a Superuser password at the Password: prompt. Refer to page 36 for more information on the enable command.

•

451-0310E

If you are in a command mode other than User, execute the end command or the exit command until the Superuser command prompt is displayed.

65

clear Clear the screen and removes any user input from the command buffer. Syntax clear Example clear

66

451-0310E

configuration Enters the Configuration command mode. When this command is executed, the configuration prompt (e.g., Config >>) is displayed. Only the Configuration commands can be executed from the configuration prompt. For more information on the Configuration commands, refer to “Configuration Commands” on page 159. Syntax configuration Example configuration

451-0310E

67

debug port async ppp Generates debug information for PPP sessions on an asynchronous port. The debug information can be displayed by executing the show debug port async ppp command (see page 90). Syntax debug port async NUMBER ppp Where

Means

NUMBER

An asynchronous port number.

Example debug port async 5 ppp

68

451-0310E

debug snmp Generates debug information for SNMP. Syntax debug snmp Example debug snmp

451-0310E

69

debug subscriber Generates debug information for a subscriber. The debug information can be displayed by executing the show debug subscriber command (see page 91). Syntax debug subscriber Where

Means

subscriber_name

The subscriber for which debug information is to be generated.

Example debug subscriber bill

70

451-0310E

disconnect Disconnects a session to the LX unit. NOTE: You can not use this command to disconnect the current session. For example, you can not use this command to disconnect session 0 when you are logged in to session 0. Syntax disconnect NUMBER|all Where

Means

NUMBER

The session number of the session that is to be disconnected.

all

Disconnect all sessions other than the session from which this command is executed.

Examples disconnect 3 disconnect all

451-0310E

71

exit Returns you to the previous command mode. For example, if the current command mode is Superuser, issuing this command will return you to the User command mode. Syntax exit Usage Guidelines The exit command can be issued in all of the LX Command Modes. However, the effect of the exit command varies, depending on the command mode from which it is issued. As noted above, issuing the exit command in the Superuser command mode returns the user to the previous command mode. The same goes for issuing the exit command in any command mode other than the User command mode. For example, issuing the exit command in the Configuration command mode returns the user to the Superuser command mode; issuing the exit command in the Subscriber command mode returns the user to the Configuration command mode, and so on. Issuing the exit command in the User command mode exits the LX CLI and closes the connection to the LX unit. Example exit

72

451-0310E

logout Logs out a device, an LX port, or an LX subscriber. Syntax logout |port | Where

Means

device_name

The name of the device that is to be logged out. For example, the command logout /dev/ttyGN3 logs out the Linux device /dev/ttyGN3 (port 4).

port_number

The LX port that is to be logged out. For example, the command logout port 3 logs out port 3.

subscriber_name

The name of the subscriber to be logged out. For example, the command logout mark logs out the subscriber mark.

Syntax logout /dev/ttyGN3 logout port 3 logout mark

451-0310E

73

no Disables (negates) specific features and boolean parameters on the LX unit. Refer to “Usage Guidelines” (below) for more information about using the no command in the Superuser command mode. Syntax no Where

Means

feature_name

The name of the feature or boolean parameter that is to be disabled.

Usage Guidelines The allowable arguments for this command consist of only those features and boolean parameters that can be set in the Superuser command mode and are currently enabled. To view the features and boolean parameters that are currently enabled, type the no command followed by a question mark (?). Example no pause

74

451-0310E

outlet Reboots a Power Control Relay or turns a Power Control Relay on or off. Syntax outlet : on|off|reboot Where

Means

power_master

Specifies the Power Master from which the Power Control Relay is managed. Note: Refer to “access power model” on page 309 for information on configuring a port as a Power Master.

control_relay

Specifies a Power Control Relay on the IR-5100 or IR-5150 that is managed from the Power Master. The Power Master number, combined with the Power Control Relay number, uniquely identifies each Power Control Relay. For example, 2:5 identifies Power Control Relay 5 on the device that is managed from port 2.

on

Turn the Power Control Relay on.

off

Turn the Power Control Relay off.

reboot

Reboot the Power Control Relay.

Examples outlet 3:5 on outlet 5:2 off outlet 6:1 reboot

451-0310E

75

outlet group Reboots, or turns on or off, all of the outlets in an outlet group. Syntax outlet group | on|off|reboot Where

Means

group_number

An integer number that specifies an existing outlet group.

group_name

The descriptive name of an existing outlet group.

on

Turn the outlets in the group on.

off

Turn the outlets in the group off.

reboot

Reboot the outlets in the group.

Examples outlet group 5 reboot outlet group Laboutlets off outlet group 6 on

76

451-0310E

pause enable Configures the screen to pause after displaying the number of lines specified in the “lines/screen” value for the terminal. Syntax pause enable Example pause enable

451-0310E

77

ping Sends a series of 4 echo messages to a destination host. Syntax ping [A.B.C.D|NAME] Where

Means

A.B.C.D

The IP Address of the destination host. (See “Usage Guidelines” (below) for the default value of this field.)

NAME

The domain name of the destination host. (See “Usage Guidelines” (below) for the default value of this field.)

Usage Guidelines If a destination host is not specified, the echo message is sent to the default destination host which is your Preferred Service. Refer to the preferred service command on page 399 for information on configuring a Preferred Service. If the ping command is executed without a destination host, and you do not have a Preferred Service configured, the following error message is displayed: No Preferred Service Configured Examples ping 119.20.112.3 ping ping FinanceServer

78

451-0310E

reload Re-starts the LX unit. Syntax reload Usage Guidelines If the LX parameter set has been saved since the last time the LX unit was re-started, or since the last configuration change was made, the LX unit will be re-started immediately. If the LX parameters have not been saved, you will be prompted to save them before the LX is re-started. Configuration is not saved!!! Proceed anyway? (y/n) : Enter y to re-start the LX unit without saving the changes. Enter n to abort the command. Refer to “save configuration” on page 80 for more information on saving the LX parameters. Example reload

451-0310E

79

save configuration Saves the configuration of the LX unit to the local flash or to a network parameter server. Syntax save configuration flash|[network |] Where

Means

flash

Save the LX-unit configuration to the local flash.

network

Save the LX-unit configuration to a network parameter server.

filename

Identifies the network file to which the LX-unit configuration is to be saved. The filename must not include a .zip suffix. For example, unit1 is a valid filename, but unit1.zip is not a valid filename.

domain_name

Specifies the domain name of the TFTP server to which the LX-unit configuration is to be saved.

ip_address

Specifies the IP Address of the TFTP server to which the LX-unit configuration is to be saved.

Examples save configuration flash save config network unit1 119.25.42.37

80

451-0310E

setup Runs the setup utility (Quick Start Configurator). For more information on the Quick Start Configurator, refer to the LX Quick Start Instructions. Syntax setup Example setup

451-0310E

81

shell Enters the Built-in Linux shell on the LX unit. Syntax shell Usage Guidelines When this command is executed, the following is displayed on the Linux monitor: BusyBox v0.60.1 (2002.04.16-12:27+0000) Built-in shell (ash) Enter ‘help’ for a list of built-in commands InReach:/# You can enter any command in the Built-in Linux shell from the command prompt (InReach:/# in the above example). Enter help at the command prompt for a list of the built-in commands. The format of the command prompt is :/#, where is the username of the subscriber. Enter exit at the command prompt to return to Superuser Mode. Example shell

82

451-0310E

show audit log Displays the audit log for a port or a subscriber. Syntax show audit log []|[] Where

Means

port_number

Specifies an asynchronous port number on the LX unit.

subscriber_name

Specifies an LX subscriber name.

Usage Guidelines If you execute show audit log for a subscriber, the display will only contain audit log data for the subscriber in question. If you execute show audit log for a port, the display will contain audit log data for all of the subscribers that are logged in at the port. Example show audit show audit log 5 show audit log mark Figure 15 shows an example of the audit log display. Nov Nov Nov Nov Nov Nov Nov Nov Nov Nov

18 18 18 18 18 18 18 18 18 18

16:08:32 16:08:50 16:08:50 16:08:50 16:08:55 16:08:55 16:08:55 16:08:55 16:08:55 16:08:55

yves yves yves yves yves yves yves yves yves yves

ttyGN0 ttyGN0 ttyGN0 ttyGN0 ttyGN0 ttyGN0 ttyGN0 ttyGN0 ttyGN0 ttyGN0

0 1 2 3 3 3 3 3 3 3

Subs_yves >>end Yves:0 >> Yves:1 > Yves:2 > Yves:3 >sho session Number Device 0 /dev/pts/0 1 /dev/pts/3 2 /dev/pts/4 3 /dev/pts/5

Program Superuser User User User

Pid 477 481 482 483

Time 98 5 5 5

Status *

Figure 15 - Audit Log Display

451-0310E

83

show broadcast group characteristics Displays the characteristics of Broadcast Groups. Syntax show broadcast group all| characteristics Where

Means

all

Display information for all Broadcast Groups.

group_number

The group number of a Broadcast Group.

Example show broadcast group 1 characteristics show broadcast group all characteristics Figure 16 shows an example of the Broadcast Group Characteristics Display. Time: 08 Nov 2002 16:29:26 US/EASTERN Broadcast Group Number: 1 Mode: State: Disabled Async Master port(s) with Timestamp:

Line Mode

Async Master port(s) without Timestamp: 1,4 TCP Master port(s) with Timestamp: TCP Master port(s) without Timestamp: Async Slave port(s) with Discard: Async Slave port(s) without Discard: 2-3,5-7 Async Slave port(s) with Local Echo: Async Slave port(s) without Local Echo: 2-3,5-7 TCP Slave port(s) with Discard: TCP Slave port(s) without Discard: TCP Slave port(s) with Local Echo: TCP Slave port(s) without Local Echo:

Figure 16 - Broadcast Group Characteristics Display

84

451-0310E

show broadcast group summary Displays summary information on all of the Broadcast Groups that are configured on the LX unit. Syntax show broadcast group summary Example show broadcast group summary Figure 17 shows an example of the Broadcast Group summary display. Broadcast group number:

State: 1 2 3 4 5

Enabled Disabled Disabled Disabled Disabled

Figure 17 - Broadcast Group Summary Display

451-0310E

85

show clock Displays the day, date, time, and timezone for the LX unit. Syntax show clock Example show clock Figure 18 shows an example of the clock display. Mon, 08 Apr 2002 14:39:16 UTC

Figure 18 - Clock Display

86

451-0310E

show command log Displays the command log for a port or for a subscriber. Syntax show command log []|[] Examples show command log show command log 4 show command log mark Figure 19 shows an example of the command log display. Nov Nov Nov Nov Nov

11 11 11 11 11

12:47:30 12:47:33 12:49:21 12:49:29 12:49:39

demo demo demo demo demo

0 end 0 sho command log 23 modem 23 end 23 show command log demo

Figure 19 - Command Log Display

451-0310E

87

show configuration Displays the contents of the LX System configuration table or the configuration data from the Non-Volatile memory of the LX unit. Syntax show configuration Example show configuration Figure 20 shows an example of the Configuration Data display. Signature is :a1326c7cf50dd779086e0a90843fdke94398kj9 In-Reach Configuration version 0.0.34, Linux kernel version 2.4.10 System.SystemName.0 TYPE STRING System.SystemLocation.0 TYPE STRING System.TimeZone.0 TYPE STRING System.UseNtp.0 TYPE BOOL System.UseLpd.0 TYPE BOOL System.SnmpLocation.0 TYPE STRING System.SnmpPort.0 TYPE SHORT System.SnmpLog.0 TYPE BOOL System.SnmpTransport.0 TYPE OCTET System.SysLogAddr.0 TYPE IPADDR System.UseSsh.0 TYPE BOOL System.UseRad.0 TYPE BOOL System.UseRadAcct.0 TYPE BOOL System.RadPort.0 TYPE SHORT System.RadAcctPort.0 TYPE SHORT System.RadPrimAuth.0 TYPE IPADDR System.RadPrimSecret.0 TYPE STRING System.RadSecAuth.0 TYPE IPADDR System.RadSecSecret.0 TYPE STRING System.RadPrimAcct.0 TYPE IPADDR Type a key to continue, q to quit

VALUE VALUE VALUE VALUE VALUE VALUE VALUE VALUE VALUE VALUE VALUE VALUE VALUE VALUE VALUE VALUE VALUE VALUE VALUE VALUE

"InReach LX-1" "Middle of NoWhere" "UTC" "Disabled" "Disabled" "" "161" "Disabled" "0" "0.0.0.0" "Disabled" "Disabled" "Disabled" "1812" "1813" "1.1.1.1" "" "1.1.1.2" "" "1.1.1.1"

Figure 20 - Configuration Data Display

88

451-0310E

show configuration log Displays the commands that have been executed in the Configuration Command Mode and in any of the Command Modes nested in the Configuration Command Mode. (The Command Modes nested in the Configuration Command Mode include Broadcast Group, Interface, Menu, Menu Editing, Subscriber, Asynchronous, PPP, Modem, Ethernet, SNMP, and Notification.) Syntax show configuration log Example show configuration log Figure 21 shows an example of the configuration log display. Nov Nov Nov Nov Nov Nov Nov Nov Nov

20 20 20 20 20 20 20 20 20

20:59:03 20:59:12 20:59:46 21:00:17 21:00:24 21:00:29 21:00:34 21:00:47 21:01:01

InReach InReach InReach InReach InReach InReach InReach InReach InReach

/ttyGN0 /ttyGN0 /ttyGN0 /ttyGN0 /ttyGN0 /ttyGN0 /ttyGN0 /ttyGN0 /ttyGN0

0 0 0 0 0 0 0 0 0

save config to flash boot config file from flash subscriber 4 no password subscriber 4 access telnet enable subscriber 4 access ssh enable subscriber 4 access guiserver enable subscriber 4 access console enable subscriber 4 security level super save config to flash

Figure 21 - Configuration Log Display

451-0310E

89

show debug port async ppp Displays the debug data for PPP sessions on an asynchronous port of the LX unit. Syntax show debug port async NUMBER ppp Where

Means

NUMBER

The number of the port for which debug data is to be displayed.

Example show debug port async 5 ppp

90

451-0310E

show debug subscriber Displays the subscriber debug data for the LX unit. Syntax show debug subscriber NAME Where

Means

NAME

The name of the subscriber for which debug data is to be displayed.

Example show debug subscribers bill Figure 22 shows an example of the Subscriber Debug data display.

Bill_M:0 >>show debug subscriber billStamp : 1020858407 To Line 1b 5b 3f 32 35 6c .[?25l Stamp : 1020858407 To Line 1b 5b 39 30 30 3b 39 30 30 48 .[900;900H Stamp : 1020858407 To Line 1b 5b 36 6e .[6n Stamp : 1020858407 From Line 1b 5b 32 34 3b 38 30 52 6e e6 .[24;80Rn. Stamp : 1020858407 From Line 75 81 1b 5b 32 34 3b 38 30 52 u..[24;80R Stamp : 1020858407 To Line 1b 5b 3f 32 35 68 .[?25h Stamp : 1020858407 To Line 1b 5b 48 1b 5b 4a .[H.[J Stamp : 1020858407 To Line 1b 5b 30 3b 30 48 .[0;0H Stamp : 1020858407 To Line 42 69 6c 6c 5f 4d 3a 30 20 3e Bill_M:0.> Stamp : 1020858407 To Line 1b 5b 36 6e .[6n

Figure 22 - Subscriber Debug Data

451-0310E

91

show device status Displays information on devices connected to asynchronous ports configured as OUTLET or SENSOR on the LX unit. Syntax show device all| status Where

Means

all

Display information for all asynchronous ports configured as OUTLET or SENSOR.

port_number

The port number of an asynchronous port that is configured as OUTLET or SENSOR.

Example show device 5 status Figure 23 shows an example of the Device Display for an OUTLET port.

Time: Tue, 17 Sep 2002 20:05:47 Device Type: Model Name: Total Outlet Strip Load: Outlet Minimum Off Time: Outlet Name State 1 plug1 Off 2 plug2 Off 3 plug3 Off 4 plug4 Off 5 plug5 Off 6 plug6 Off 7 plug7 Off 8 plug8 Off 9 plug9 Off 10 plug10 Off 11 plug11 Off 12 plug12 Off 13 plug13 Off 14 plug14 Off 15 plug15 Off 16 plug16 Off

Device Number:

Load 0.0 0.0 0.0 0.0 0.0 0.0 0.0 0.0 0.0 0.0 0.0 0.0 0.0 0.0 0.0 0.0

4 IR5100 IR-5100-126 0.0 15 Assigned Groups 1 4 13 1 6 10 1 7 1 2 4 2 2 2 3 4 3 3 3 4 5 4 5 4 5 5

Figure 23 - Device Display for An OUTLET Port

92

451-0310E

show device status (continued) Figure 24 shows an example of the Device Display for a SENSOR port.

Time: 29 Aug 2002 17:35:17 US/EASTERN Device Type: Humidity Level(%): Temperature (Celsius): Temperature (Fahrenheit):

Device Number:

4 Sensor 39.00 26.00 78.80

Figure 24 - Device Display for A SENSOR Port

451-0310E

93

show device summary Displays summary information on the sensors, and power management devices, that are attached to asynchronous ports of the LX unit. Syntax show device summary Example show device summary Figure 25 shows an example of the Device summary display. Device Number 4 5

Device Type IR5100 IR5100

Model Name IR-5100-126 IR-5100-255

Figure 25 - Device Summary Display

94

451-0310E

show interface characteristics Displays the characteristics of an IP interface. Syntax show interface NUMBER|all characteristics Where

Means

NUMBER

Specifies the IP interface for which information is to be displayed.

all

Display information for all the IP interfaces on the LX unit.

Examples show interface 1 characteristics show interface all characteristics Figure 26 shows an example of the Interface Characteristics display. Time: Mon, 24 Feb 2003 16:14:27 Interface Name: Interface_1 Bound to : eth0 IP MTU Size: 1500 IP Address : 0.0.0.0 Learned IP Address : 102.19.169.191 IP Mask : 0.0.0.0 Learned IP Mask : 255.255.255.0 IP Broadcast : 0.0.0.0 Learned IP Broadcast: 102.19.169.255 Interface Status: In Use Learned IP Gateway : 102.19.169.1 Rotary Feature: Disabled Learned IP DNS : 0.0.0.0 Authentication: Local Radius Accounting: Disabled Authentication FallBack: Disabled Tacacs+ Accounting: Disabled SSH port: 22 Telnet port: 23 SSH Keepalive Interval: 0 SSH Keepalive Count: 3

Figure 26 - Interface Characteristics Display Field

Description

Time

The date and time that the show interface characteristics command was executed.

Interface Name

The name of the IP interface for which data is being displayed.

IP MTU Size

The Maximum Transmission Unit (MTU) size for an IP interface. The MTU size is the largest-size frame that can be transmitted on the IP interface.

IP Address

The IP Address of the IP interface.

IP Mask

The subnet mask of the IP interface.

IP Broadcast

The IP Broadcast Address of the IP interface.

451-0310E

95

show interface characteristics (continued)

Interface Status

The status of the IP interface. The possible values are In Use and N/A.

Rotary Feature

Indicates whether IP Rotary is Enabled or Disabled on this IP interface. If it is Enabled, you will be able to configure the rotary settings on this IP interface. If it is Disabled, you will not be able to configure the rotary settings on this IP interface.

Authentication

Indicates the type of authentication that is in effect for the IP interface.

Authentication Fallback

Indicates whether the Fallback Login Feature is Enabled or Disabled for the IP interface.

SSH port

The SSH port for the IP interface.

SSH Keepalive Interval

The length of time, in seconds, between attempts at making an SSH connection to the IP interface.

Bound to

The Ethernet port to which the interface is bound.

Learned IP Address

The IP Address learned from ppciboot.

Learned IP Mask

The subnet mask learned from ppciboot.

Learned IP Broadcast

The IP Broadcast Address learned from ppciboot.

Learned IP Gateway

The IP Gateway learned from ppciboot.

Learned IP DNS

The Domain Name Server (DNS) learned from ppciboot.

RADIUS Accounting

Indicates whether RADIUS Accounting is enabled or disabled for the IP interface.

Tacacs+ Accounting

Indicates whether Tacacs+ Accounting is enabled or disabled for the IP interface.

Telnet port

The Telnet port for the IP interface.

SSH Keepalive Count

The number of times that an SSH client will attempt to make an SSH connection to the IP interface.

96

451-0310E

show interface port mapping Displays the Telnet port number, and the SSH port number, associated with each serial port on an IP interface. Syntax show interface NUMBER|all port mapping Where

Means

NUMBER

Specifies the IP interface for which information is to be displayed.

all

Display information for all the IP interfaces on the LX unit.

Example show interface all port mapping

451-0310E

97

show interface port mapping (continued) Figure 27 on page 98 shows an example of the port mapping display. Serial Port 0 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33

Telnet Port 0 2100 2200 2300 2400 2500 2600 2700 2800 2900 3000 3100 3200 3300 3400 3500 3600 3700 3800 3900 4000 4100 4200 4300 4400 4500 4600 4700 4800 4900 5000 5100 5200 5300

SSH Port 0 2122 2222 2322 2422 2522 2622 2722 2822 2922 3022 3122 3222 3322 3422 3522 3622 3722 3822 3922 4022 4122 4222 4322 4422 4522 4622 4722 4822 4922 5022 5122 5222 5322

Figure 27 - Port Mapping Display

98

451-0310E

show interface rotary Displays the characteristics of a rotary. Syntax show interface NUMBER|all rotary Where

Means

NUMBER

Specifies the rotary for which information is to be displayed. The allowable rotary numbers are 1 through 5.

all

Display information for all the rotaries on the LX unit.

Examples show interface 3 rotary show interface all rotary Figure 28 shows an example of the Rotary Characteristics display. Rotary IP Address 147.132.145.16

TCP 1500

SSH 1522

Rotary Type Rotary State First Available Disabled

Serial Ports

Figure 28 - Rotary Characteristics Display Field

Description

Rotary IP Address

The IP Address of the rotary. (This is also the IP Address of the interface.)

TCP

The TCP socket number assigned to the rotary.

SSH

The SSH socket number assigned to the rotary.

Rotary Type

The rotary type (First Available or Round Robin).

Rotary State

Indicates whether the rotary is Enabled or Disabled.

Serial Ports

The serial ports included in the rotary.

451-0310E

99

show interface status Displays status information for an IP interface. Syntax show interface NUMBER|all status Where

Means

NUMBER

Specifies the IP interface for which information is to be displayed. The allowable IP interface numbers are 1 through 5.

all

Display information for all the IP interfaces on the LX unit.

Examples show interface 1 status show interface all status Figure 29 shows an example of the Interface status display. Time: Interface Name: IP Address: IP Broadcast Addr:

Interface_1 102.19.169.191 102.19.169.255

Mon 24 Apr 2003 16:19:34 Bound to : eth0 IP Mask: 255.255.255.0

Figure 29 - Interface Status Display Field

Description

Time

The date and time that the show interface status command was executed.

Interface Name

The name of the IP interface.

IP Address

The IP Address of the IP interface.

IP Broadcast Addr

The IP Broadcast Address of the IP interface.

Bound to

The Ethernet port to which the IP interface is bound.

IP Mask

The Subnet Mask of the IP interface.

100

451-0310E

show interface summary Displays summary information on all of the IP interfaces that are configured on the LX unit. Syntax show interface summary Example show interface summary Figure 30 shows an example of the Interfaces summary display. NOTE: Interface addresses that are learned are not displayed on the following screen. Name Interface_1 Interface_2 Interface_3 Interface_4 Interface_5

Address 0.0.0.0 0.0.0.0 0.0.0.0 0.0.0.0 0.0.0.0

Broadcast 0.0.0.0 0.0.0.0 0.0.0.0 0.0.0.0 0.0.0.0

Addr. Mask 0.0.0.0 0.0.0.0 0.0.0.0 0.0.0.0 0.0.0.0

Bound to eth0 eth0:1 eth0:2 eth0:3 eth0:4

Figure 30 - Interfaces Summary Display Field

Description

Name

The name of the IP interface.

Address

The IP Address configured for the IP interface.

Broadcast

The Broadcast Address configured for the IP interface.

Addr. Mask

The subnet mask configured for the IP interface.

Bound to

The Ethernet port to which the IP interface is bound.

451-0310E

101

show kernel log Displays a log of Linux kernel activity for the LX unit. Syntax show kernel log Example show kernel log Figure 31 shows an example of the Kernel Log display.

Jan Jan Jan

3 15:42:50 In-Reach kernel: klogd 1.4.1, log source = /proc/kmsg started. 3 15:42:50 In-Reach kernel: Cannot find map file. 3 15:42:50 In-Reach kernel: No module symbols loaded - kernel modules not enabled. Jan 3 15:42:50 In-Reach kernel: Linux version 2.4.19 (build@GenBuild) (gcc version 2.95.3 20010315 (release)) #1 Wed Feb 26 08:16:45 EST 2003 Jan 3 15:42:50 In-Reach kernel: On node 0 totalpages: 16384 Jan 3 15:42:50 In-Reach kernel: zone(0): 16384 pages. Jan 3 15:42:50 In-Reach kernel: zone(1): 0 pages. Jan 3 15:42:50 In-Reach kernel: zone(2): 0 pages. Jan 3 15:42:50 In-Reach kernel: Kernel command line: root=/dev/ram CONSOLE=/dev /console Jan 3 15:42:50 In-Reach kernel: Decrementer Frequency = 247500000/60 Jan 3 15:42:50 In-Reach kernel: Calibrating delay loop... 65.53 BogoMIPS Jan 3 15:42:50 In-Reach kernel: Memory: 57500k available (1440k kernel code, 49 2k data, 56k init, 0k highmem) Jan 3 15:42:50 In-Reach kernel: Dentry cache hash table entries: 8192 (order: 4 , 65536 bytes) Jan 3 15:42:50 In-Reach kernel: Inode cache hash table entries: 4096 (order: 3, 32768 bytes) Jan 3 15:42:50 In-Reach kernel: Mount-cache hash table entries: 1024 (order: 1, 8192 bytes) Jan 3 15:42:50 In-Reach kernel: Buffer-cache hash table entries: 4096 (order: 2 , 16384 bytes) Jan 3 15:42:50 In-Reach kernel: Page-cache hash table entries: 16384 (order: 4, 65536 bytes) Jan 3 15:42:50 In-Reach kernel: POSIX conformance testing by UNIFIX Jan 3 15:42:50 In-Reach kernel: Linux NET4.0 for Linux 2.4 Jan 3 15:42:50 In-Reach kernel: Based upon Swansea University Computer Society NET3.039 Jan 3 15:42:50 In-Reach kernel: Initializing RT netlink socket Jan 3 15:42:50 In-Reach kernel: Starting kswapd Jan 3 15:42:50 In-Reach kernel: i2c-core.o: i2c core module version 2.6.1 (2001 0830) Type a key to continue, q to quit

Figure 31 - Kernel Log Display

102

451-0310E

show log Displays the contents of syslogd for the LX unit. Syntax show log Example show log Figure 32 shows an example of the Log display. Dec 31 21:10:20 In-Reach syslogd 1.4.1: restart. Dec 31 21:10:20 In-Reach kernel: klogd 1.4.1, log source = /proc/kmsg started. Dec 31 21:10:21 In-Reach kernel: Cannot find map file. Dec 31 21:10:21 In-Reach kernel: No module symbols loaded - kernel modules not enabled. Dec 31 21:10:21 In-Reach kernel: Linux version 2.4.19 (build@GenBuild) (gcc vers ion 2.95.3 20010315 (release)) #1 Mon Feb 3 07:52:36 EST 2003 Dec 31 21:10:21 In-Reach kernel: On node 0 totalpages: 16384 Dec 31 21:10:21 In-Reach kernel: zone(0): 16384 pages. Dec 31 21:10:21 In-Reach kernel: zone(1): 0 pages. Dec 31 21:10:21 In-Reach kernel: zone(2): 0 pages. Dec 31 21:10:21 In-Reach kernel: Kernel command line: root=/dev/ram CONSOLE=/dev /console Dec 31 21:10:21 In-Reach kernel: Decrementer Frequency = 247500000/60 Dec 31 21:10:21 In-Reach kernel: Calibrating delay loop... 65.53 BogoMIPS Dec 31 21:10:21 In-Reach kernel: Memory: 58432k available (1292k kernel code, 43 2k data, 52k init, 0k highmem) Dec 31 21:10:21 In-Reach kernel: Dentry cache hash table entries: 8192 (order: 4 , 65536 bytes) Dec 31 21:10:21 In-Reach kernel: Inode cache hash table entries: 4096 (order: 3, 32768 bytes) Dec 31 21:10:21 In-Reach kernel: Mount-cache hash table entries: 1024 (order: 1, 8192 bytes) Dec 31 21:10:21 In-Reach kernel: Buffer-cache hash table entries: 4096 (order: 2 , 16384 bytes) Dec 31 21:10:21 In-Reach kernel: Page-cache hash table entries: 16384 (order: 4, 65536 bytes) Dec 31 21:10:21 In-Reach kernel: POSIX conformance testing by UNIFIX Dec 31 21:10:21 In-Reach kernel: Linux NET4.0 for Linux 2.4 Dec 31 21:10:21 In-Reach kernel: Based upon Swansea University Computer Society NET3.039 Dec 31 21:10:21 In-Reach kernel: Initializing RT netlink socket Dec 31 21:10:21 In-Reach kernel: Starting kswapd Type a key to continue, q to quit

Figure 32 - Log Display

451-0310E

103

show notification message Displays the ID number, string portion (message), facility, and priority of configurable syslogd messages. Syntax show notification message NUMBER|all Where

Means

NUMBER

The ID number of a configurable syslogd message.

all

Display all of the configurable syslogd messages on the LX unit.

Example show notification message 4 Figure 33 shows an example of the Message display. Message record 4: Message: The Shell has been exited by Facility: user Priority: notice

Figure 33 - Message Display

104

451-0310E

show notification serviceprofile Displays information on Service Profiles configured for the Notification Feature. Syntax show notification serviceprofile |all Where

Means

name

The Service Profile for which data is to be displayed.

all

Display the specified data for all Service Profiles on the LX unit.

Example show notification serviceprofile all Figure 34 shows an example of the Service Profile display.

ServiceProfile: syslog Protocol: localsyslog File: syslog ServiceProfile: messages Protocol: localsyslog File: messages ServiceProfile: debug Protocol: localsyslog File: debug ServiceProfile: mark1 Protocol: localsyslog File: ServiceProfile: jacklocal Protocol: localsyslog File: jacksyslog ServiceProfile: jackremote Protocol: remotesyslog Remote Host: ServiceProfile: jackasync Protocol: async Async Port: 5 ServiceProfile: jack Protocol: tap SMSC: 18668230501 Bits/Parity/StopBits:8N1 Modem Port(s): 33 ServiceProfile: webjack Protocol: web Driver: verizon_web

Figure 34 - Service Profile Display

451-0310E

105

show notification userprofile Displays information on User Profiles of the Notification Feature. Syntax show notification userprofile |all Where

Means

name

The User Profile for which data is to be displayed.

all

Display the specified data for all User Profiles on the LX unit.

Example show notification userprofile all Figure 35 shows an example of the User Profile display.

UserProfile: syslog ServiceProfile: syslog Contact: Facility: all Priority: err UserProfile: messages ServiceProfile: messages Contact: Facility: all Priority: notice UserProfile: debug ServiceProfile: debug Contact: Facility: all Priority: debug UserProfile: grogers@mrv ServiceProfile: N/A Contact: Facility: kern Priority: emerg UserProfile: mark ServiceProfile: N/A Contact: Facility: kern Priority: emerg UserProfile: jacklocal ServiceProfile: jacklocal Contact: Facility: user Priority: warning

Figure 35 - User Profile Display

106

451-0310E

show outlet group status Displays status information for outlet groups. Syntax show outlet group ||all status Where

Means

group_number

An integer number that specifies an existing outlet group.

group_name

The descriptive name of an existing outlet group.

all

Display the specified data for all outlet groups on the LX unit.

Example show outlet group all status Figure 36 shows an example of the Outlet Group Status display.

Time: Mon, 16 Sep 2002 17:55:19 Group Name: mypc Port Outlet State 2 1 Not configured 2 2 Not configured

Group Number: Group Off Time:

2 4

Figure 36 - Outlet Group Status Display Field

Description

Time

The date and time that the show outlet group status command was executed.

Group Name

The descriptive name of the outlet group.

Port

The LX Port from which the outlet is managed.

Outlet

The outlet number.

State

The state of the individual outlet.

Group Number

The group number of the outlet group.

Group Off Time

The length of time that outlets in the group must remain off after they have been turned off.

451-0310E

107

show port async apd Displays the APD settings of an asynchronous port. Syntax show port async all| apd Where

Means

all

Display information for all asynchronous ports.

port_number

The port number of an asynchronous port.

Example show port async 5 apd show port async all apd The port APD Settings screen contains the same fields as the port APD Settings screen that can be displayed in the User command mode. For more information refer to Figure 4 on page 46.

108

451-0310E

show port async characteristics Displays the characteristics of an asynchronous port. Syntax show port async all| characteristics Where

Means

all

Display information for all asynchronous ports.

port_number

The port number of an asynchronous port.

Example show port async 5 characteristics show port async all characteristics The display contains the same fields as the port characteristics screen that can be displayed in the User command mode. For more information refer to Figure 3 on page 43.

451-0310E

109

show port async modem Displays the modem settings for an asynchronous port. Syntax show port async all| modem Where

Means

all

Display information for all asynchronous ports.

port_number

The port number of an asynchronous port.

Example show port async 5 modem show port async all modem The display contains the same fields as the port modem screen that can be displayed in the User command mode. For more information refer to Figure 5 on page 47.

110

451-0310E

show port async pattern match characteristics Displays the match patterns and pattern-matching characteristics for an asynchronous port. Syntax show port async |all pattern match characteristics Where

Means

port_number

The port number of an asynchronous port. Note: The port must be configured for databuffer access.

all

Display the pattern-matching characteristics for all asynchronous ports on the LX unit.

Example show port async 5 pattern match characteristics Figure 37 shows an example of the Pattern Match Characteristics display.

Time: Banner: Port Number: Pattern Match: Pattern Pattern Pattern Pattern

1: 2: 3: 8:

Wed, 05 Feb 2003 07:05:52 Welcome to MRV Communications, In-Reach Product Division. 5 Enabled

SuperUser tes.t Unix Reboot abc*

Figure 37 - Pattern Match Characteristics Display

451-0310E

111

show port async ppp Displays the Point-to-Point Protocol (PPP) settings of an asynchronous port. Syntax show port async all| ppp Where

Means

all

Display information for all asynchronous ports.

port_number

The port number of an asynchronous port.

Example show port async 5 ppp show port async all ppp The display contains the same fields as the port PPP screen that can be displayed in the User command mode. For more information refer to Figure 6 on page 48.

112

451-0310E

show port async ppp status Displays the Point-to-Point Protocol (PPP) status of an asynchronous port. Syntax show port async all| ppp status Where

Means

all

Display information for all asynchronous ports.

port_number

The port number of an asynchronous port.

Example show port async 4 ppp status Figure 38 shows an example of the PPP status display. Time: Port Device: Learned Remote Addr.: Lcp Link Status: PPP Transmit Bytes: PPP Transmit Frames: PPP Transmit Errors:

/dev/ttyGN4 0.0.0.0 Closed N/A N/A N/A

Tue, 18 Mar 2003 20:21:58 UTC Port Number: 4 Ipcp Link Status: PPP Recieve Bytes: PPP Recieve Frames: PPP Recieve Errors:

Closed N/A N/A N/A

Figure 38 - PPP Status Display

451-0310E

113

show port async status Displays status information for asynchronous ports. Syntax show port async all| status Where

Means

all

Display information for all asynchronous ports.

port_number

The port number of an asynchronous port.

Example show port async 5 status show port async all status This display contains the same fields as the port Status screen that can be displayed in the User command mode. For more information refer to Figure 7 on page 50.

114

451-0310E

show port async summary Displays summary information for all of the asynchronous ports on the LX unit. Syntax show port async summary Example show port async summary Figure 39 shows an example of the summary information for LX asynchronous ports. Port 0 1 2 3 4 5 6 7 8

Port Name Port_0 Port_1 Port_2 Port_3 Port_4 Port_5 Port_6 Port_7 Port_8

Access Local Remote Remote Local Dynamic Sensor Databuffer IR5100 IR5150

Speed 9600 9600 9600 9600 9600 9600 9600 9600 9600

TCP Port 0 2100 2200 2300 2400 2500 2600 2700 2800

SSH port 0 2122 2222 2322 2422 2522 2622 2722 2822

Device /dev/ttyGN0 /dev/ttyGN1 /dev/ttyGN2 /dev/ttyGN3 /dev/ttyGN4 /dev/ttyGN5 /dev/ttyGN6 /dev/ttyGN7 /dev/ttyGN8

Figure 39 - Asynchronous Port Summary Data Field

Description

Port

The Port Number

Port Name

The Port Name

Access

The access method for the port

Speed

The port speed

TCP Port

The Telnet port number for the port

SSH Port

The SSH port number for the port

Device

The Linux Device Name for the port

451-0310E

115

show port ethernet characteristics Displays the characteristics of an Ethernet port. Syntax show port ethernet all| characteristics Where

Means

all

Display information for all Ethernet ports.

port_number

The port number of an Ethernet port.

Example show port ethernet 1 characteristics Figure 40 shows an example of Ethernet Port Characteristics. Time: Name: Link Speed: Description:

eth0 Auto

Mon, 24 Mar 2003 22:30:19 MAC Address: 00:a0:87:9c:00:50:e3 Duplex Mode: Auto

Figure 40 - Ethernet Port Characteristics Field

Description

Name

The name of the port.

Description

The description of the Ethernet port.

MAC Address

The Ethernet MAC Address for the port.

Link Speed

The Ethernet port speed. The possible values are auto, 10mb and 100mb.

Duplex Mode

The duplex mode of the Ethernet port. The possible values are auto, full, and half.

116

451-0310E

show port ethernet status Displays the statistical information for an ethernet port. Syntax show port ethernet all| status Where

Means

all

Display information for all ethernet ports.

port_number

The port number of an ethernet port.

Example show port ethernet 1 status Figure 41 shows an example of the statistical information for an Ethernet port. Name: Link State: Link Speed: Receive Bytes: Receive Packets: Receive Errors: Receive Drop Packet: Receive Overruns: Receive Compressed: Receive Frame Error: Receive Multicast:

eth0 Up 100 240061 2890 0 0 0 0 0 0

MAC Address: 00:a0:87:9c:00:50:e3 Duplex Mode: Half Auto Negotiation: Auto Transmit Bytes: 40115 Transmit Packets: 659 Transmit Errors: 0 Transmit Drop Packet: 0 Transmit Overruns: 0 Transmit Compressed: 0 Transmit Collisions: 0 Transmit Carrier: 0

Figure 41 - Ethernet Port Statistical Information Field

Description

Name

The Ethernet port name.

Link State

The state (Up or Down) of the Ethernet link.

Link Speed

The speed of the Ethernet link (in Megabytes per second).

Receive Bytes

The number of Bytes Received on the Ethernet port since the counters were last reset to zero.

Receive Packets

The number of Packets Received on the Ethernet port since the counters were last reset to zero.

Receive Errors

The number of Receive Errors on the Ethernet port since the counters were last reset to zero.

Receive Drop Packet

The number of Receive Packets that have been dropped by the Ethernet port since the counters were last reset to zero.

451-0310E

117

show port ethernet status (continued)

Receive Overruns

The number of Receive Overruns on the Ethernet port since the counters were last reset to zero.

Receive Compressed

The number of compressed packets received since the counters were last reset to zero.

Receive Frame Error

The number of Receive Frame Errors on the Ethernet port since the counters were last reset to zero.

Receive Multicast

The number of Multicasts received on the Ethernet port since the counters were last reset to zero.

MAC Address

The MAC Address of the LX unit.

Duplex Mode

The duplex mode (half or full) of the Ethernet link.

Auto Negotiation

Indicates whether or not auto negotiation is in effect on the Ethernet link.

Transmit Bytes

The number of bytes transmitted on the Ethernet port since the counters were last reset to zero.

Transmit Packets

The number of packets transmitted on the Ethernet port since the counters were last reset to zero.

Transmit Errors

The number of Transmit Errors on the Ethernet port since the counters were last reset to zero.

Transmit Drop Packet

The number of Transmit Packets dropped on the Ethernet port since the counters were last reset to zero.

Transmit Overruns

The number of Transmit Overruns on the Ethernet port since the counters were last reset to zero.

Transmit Compressed

The number of compressed packets transmitted since the counters were last reset to zero.

Transmit Collisions

The number of Transmit Collisions on the Ethernet port since the counters were last reset to zero.

Transmit Carrier

118

451-0310E

show port ethernet summary Displays summary information for the Ethernet ports on the LX unit. Syntax show port ethernet summary Example show port ethernet summary Figure 42 shows an example of the summary information for the LX Ethernet port. Name eth0

MAC-Address 00:a0:87:9c:00:50:e3

Figure 42 - Ethernet Summary Information Field

Description

Name

The name of the Ethernet port.

MAC Address

The MAC (physical) Address of the Ethernet port.

451-0310E

119

show radius characteristics Displays information about the RADIUS authentication and accounting servers for the LX unit. Syntax show radius characteristics Example show radius characteristics Figure 43 shows an example of the RADIUS Display. Time: Primary RADIUS Authentication Server: IP Address: 0.0.0.0 Secret: Not Configured Retry: 4

Wed, 10 Apr 2002 00:44:48 UTC RADIUS Auth. UDP Port: 1812 Timeout: 4

Secondary RADIUS Authentication Server: IP Address: 0.0.0.0 RADIUS Auth. UDP Port: 1812 Secret: Not Configured Timeout: 4 Retry: 4 Primary RADIUS Accounting Server: IP Address: 0.0.0.0 Secret: Not Configured Retry: 4

RADIUS Acct. UDP Port: 1813 Timeout: 4

Secondary RADIUS Accounting Server: IP Address: 0.0.0.0 Secret: Not Configured Retry: 4

RADIUS Acct. UDP Port: 1813 Timeout: 4

RADIUS Accounting Server Period: 5 Inbound RADIUS Enabled Serial Ports: Outbound RADIUS Enabled Serial Ports: RADIUS Enabled Interfaces:

Figure 43 - RADIUS Display Field

Description

IP Address

The IP Address for the applicable Authentication or Accounting Server.

Secret

The Radius secret shared between the LX unit and the Radius server used for encrypting communications between them.

Retry

The number of times the LX unit will attempt to connect to the Radius server.

120

451-0310E

show radius characteristics (continued)

RADIUS Auth. UDP Port

The UDP port that the LX unit and the applicable RADIUS authentication server will use for communication.

RADIUS Acct. UDP Port

The UDP port that the LX unit and the applicable RADIUS accounting server will use for communication.

Timeout

The time to wait for a RADIUS server to respond before retransmitting packets to the server.

RADIUS Accounting Server Period

The length of time, in seconds, that the RADIUS server waits for a reply from the RADIUS Accounting server.

Inbound RADIUS Enabled Serial Ports

The Inbound serial ports that are enabled for RADIUS.

Outbound RADIUS Enabled Serial Ports

The Outbound serial ports that are enabled for RADIUS.

RADIUS Enabled Interfaces

The LX interfaces that are enabled for RADIUS.

451-0310E

121

show radius status Displays statistical information on RADIUS authentication attempts. Syntax show radius status Example show radius status Figure 44 shows an example of the RADIUS Status Display.

Time: Wed, 08 May 2002 13:32:34 UTC Total RADIUS Authentication Message Exchange: Primary Secondary Successful attempts: 2 0 Failed attempts: 0 0 Total RADIUS Accounting Message Exchange: Successful attempts: Failed attempts:

Primary 0 6

Secondary 0 6

RADIUS Authentication Counter Summary: Successful Logins: Authentication Failures: Configuration Failures: Policy Failures:

Primary 2 0 0 0

Secondary 0 0 0 0

RADIUS Accounting Counter Summary: Successful Acct Entries: Failed Acct Entries: Requests Waiting:

Primary 0 0 0

Secondary 0 0 0

RADIUS Fallback Counter Summary: Total Fallback Logins:

0

Figure 44 - RADIUS Status Display Field

Description

Total RADIUS Authentication Message Exchange

Successful Attempts

The number of times the primary and secondary RADIUS authentication servers successfully exchanged messages with the LX unit.

Failed attempts

The number of times the primary and secondary RADIUS authentication servers failed to exchange messages with the LX unit.

122

451-0310E

show radius status (continued)

Total RADIUS Accounting Message Exchange

RADIUS Authentication Counter Summary

RADIUS Accounting Counter Summary

RADIUS Fallback Counter Summary

451-0310E

Successful Attempts

The number of times the primary and secondary RADIUS accounting servers successfully exchanged messages with the LX unit.

Failed attempts

The number of times the primary and secondary RADIUS accounting servers failed to exchange messages with the LX unit.

Successful Logins

The number of successful logins using RADIUS.

Authentication Failures

The number of unsuccessful logins using RADIUS.

Configuration Failures

The number of login failures that occurred due to configuration failures.

Policy Failures

The number of login failures that occurred due to policy failures.

Successful Acct Entries

The number of successful RADIUS accounting entries.

Failed Acct Entries

The number of failed RADIUS accounting entries.

Requests Waiting

The number of RADIUS Accounting requests that have not been processed yet.

Total Fallback Logins

The number of logins that have been done through the RADIUS Fallback Login feature.

123

show radius summary Displays summary data for the RADIUS authentication and accounting servers. Syntax show radius summary Example show radius summary Figure 45 shows an example of the RADIUS Summary Display. Radius Server Summary Primary Auth. Server: Secondary Auth. Server: Primary Acct. Server: Secondary Acct. Server:

0.0.0.0 0.0.0.0 0.0.0.0 0.0.0.0

Thu, 12 Sep 2002 20:47:18 Primary Auth. UDP Port: 1812 Secondary Auth. UDP Port: 1812 Primary Acct. UDP Port: 1813 Secondary Acct. UDP Port: 1813

Figure 45 - RADIUS Summary Display Field

Description

Primary Auth. Server

The IP Address of the Primary RADIUS Authentication server.

Secondary Auth. Server

The IP Address of the Secondary RADIUS Authentication server.

Primary Acct. Server

The IP Address of the Primary RADIUS Accounting server.

Secondary Acct. Server

The IP Address of the Secondary RADIUS Accounting server.

Primary Auth. UDP Port

The UDP port for the Primary RADIUS Authentication server.

Secondary Auth. UDP Port

The UDP port for the Secondary RADIUS Authentication server.

Primary Acct. UDP Port

The UDP port for the Primary RADIUS Accounting server.

Secondary Acct. UDP Port

The UDP port for the Secondary RADIUS Accounting server.

124

451-0310E

show route Displays the IP addresses of the default route, subnet mask, and gateway of the LX unit. Syntax show route Example show route Figure 46 shows an example of the Route Display. Route 192.168.10.0 192.168.11.0 192.168.12.0 192.168.13.0 192.168.14.0 192.168.15.0 192.168.16.0

Mask 255.255.255.0 255.255.255.0 255.255.255.0 255.255.255.0 255.255.255.0 255.255.255.0 255.255.255.0

Gateway 10.50.100.1 10.50.100.10 10.50.100.20 10.50.100.30 10.50.100.40 10.50.100.50 10.50.100.60

Figure 46 - Route Display

451-0310E

125

show securid characteristics Displays information about the SecurID authentication server for the LX unit. Syntax show securid characteristics Example show securid characteristics Figure 43 shows an example of the SecurID Characteristics Display. Time: Mon, 17 Mar 2003 18:09:34 UTC SecurID Configuration Settings Authentication Version: Version_5 Authentication Encryption: DES Authentication Timeout: 5 Authentication Retransmit: 3 Authentication Port: 5500 V5 Primary Server: 0.0.0.0 Primary Name: Legacy Master Server: 0.0.0.0 Master Name: Legacy Slave Server: 0.0.0.0 Slave Name: Inbound SecurID Enabled Serial Ports: Outbound SecurID Enabled Serial Ports: SecurID Enabled Interfaces:

Figure 47 - SecurID Characteristics Display Field

Description

Time

The date and time that the show securid characteristics command was executed.

Authentication Version

The version of SecurID that is running on the SecurID authentication server. The possible values are Legacy and Version_5.

Authentication Timeout

The time to wait for the SecurID authentication server to respond before retransmitting packets to the server.

Authentication Port

The UDP port that the LX unit and the SecurID authentication server will use for communication.

V5 Primary Server

The IP Address of the authentication server used for Version 5 of SecurID.

Legacy Master Server

The IP address of the Master server for the Legacy version of SecurID.

Legacy Slave Server

The IP address of the Slave server for the Legacy version of SecurID.

Inbound SecurID Enabled Serial Ports

The Inbound serial ports that use SecurID authentication.

126

451-0310E

show securid characteristics (continued)

Outbound SecurID Enabled Serial Ports

The Outbound serial ports that use SecurID authentication.

SecurID Enabled Interfaces

The IP interfaces that use SecurID authentication.

Authentication Encryption

The encryption method used by SecurID. The possible values are DES and SDI.

Authentication Retransmit

The maximum number of times the LX unit will retransmit packets to the SecurID authentication server after the expiration of an Authentication Timeout.

Primary Name

The name of the Version 5 authentication server.

Master Name

The name of the Master server for the Legacy version of SecurID.

Slave Name

The name of the Slave server for the Legacy version of SecurID.

451-0310E

127

show securid status Displays statistical information on SecurID authentication attempts. Syntax show securid status Example show securid status Figure 44 shows an example of the SecurID Status Display. Time: SecurID Status & Counters: Successful Logins: Failed Logins: Fallback Logins: Learned SecurID Node Secret: Learned SecurID Servers:

Mon, 24 Feb 2003 16:55:59 0 0 0 False

Figure 48 - SecurID Status Display Field

Description

Time

The date and time that the show securid status command was executed.

Successful Logins

The number of successful logins using SecurID.

Failed Logins

The number of unsuccessful logins using SecurID.

Fallback Logins

The number of logins that have been accomplished using SecurID Fallback.

Learned SecurID Node Secret

Indicates whether or not the LX unit has received the SecurID Secret from the SecurID Server. The possible values are True and False. A value of True means that the LX unit has received the SecurID Secret from the SecurID Server. A value of True means that the LX unit has not received the SecurID Secret from the SecurID Server.

Learned SecurID Servers

The IP addresses, or host names, of the Primary and Replica SecurID servers that the LX unit can use for authentication.

128

451-0310E

show securid summary Displays summary data for the SecurID authentication and accounting servers. Syntax show securid summary Example show securid summary Figure 45 shows an example of the SecurID Summary Display. Time: V5 Primary Server: Legacy Master Server: Authentication Version:

0.0.0.0 0.0.0.0 Version_5

Mon, 17 Mar 2003 18:17:27 UTC Primary Name: Master Name: Authentication Port: 5500

Figure 49 - SecurID Summary Display Field

Description

Time

The date and time that the show securid summary command was executed.

V5 Primary Server

The IP Address of the authentication server used for Version 5 of SecurID.

Legacy Master Server

The IP address of the Master server for the Legacy version of SecurID.

Authentication Version

The version of SecurID that is running on the SecurID authentication server. The possible values are Legacy and Version_5.

Primary Name

The name of the Version 5 Primary authentication server.

Master Name

The name of the Master server for the Legacy version of SecurID.

Authentication Port

The UDP port that the LX unit and the SecurID authentication server will use for communication.

451-0310E

129

show service Displays the name and IP Address of every service that is configured for the LX unit. Syntax show service Example show service Figure 50 shows an example of the Service screen. Wed, 10 Apr 2002 10:45:08 UTC Service Name IP Address dewey 123.123.1.1 huey 123.123.1.2

Figure 50 - Service Screen

130

451-0310E

show session Displays information about opened sessions on the LX unit. Syntax show session [] Where

Means

session_number

The session number of an opened connection.

Usage Guidelines If this command is executed without the argument (i.e., show session), it displays information for all opened sessions on the LX unit. Example show session 3 This display contains the same fields as the Session screen that can be displayed in the User command mode. For more information refer to Figure 10 on page 54.

451-0310E

131

show snmp characteristics Displays the system-level SNMP characteristics for the LX unit. Syntax show snmp characteristics Example show snmp characteristics Figure 52 shows an example of SNMP characteristics Display.

Time: Wed, 10 Apr 2002 10:45:08 UTC Name: InReach Logging: Disabled Port: 161 Contact: Henry Smith Location: Upstairs Lab V3 Engine Boots: 14 V3 Engine ID: 6537303330336565616365323932336100000000

Figure 51 - SNMP Characteristics Display Field

Description

Time

The date and time that the show snmp characteristics command was executed.

Logging

Indicates whether the SNMP Logging feature is Enabled or Disabled on the LX unit.

Contact

The contact for the LX unit.

V3 Engine Boots

The number of times the V3 engine has been rebooted.

V3 Engine ID

The V3 Engine ID for the LX unit.

Name

The system name for the LX unit.

Port

The SNMP UDP port for the LX unit.

Location

The location of the LX unit.

132

451-0310E

show snmp client Displays information on SNMP clients. Syntax show snmp client all| Where

Means

all

Display information for all SNMP clients on this LX unit.

client_number

The client number for an SNMP client

Example show snmp client 1 Figure 52 shows an example of SNMP Client Display. Get Client: Community:

1 public

Address: Version:

145.134.118.12 1

Set Client: Community:

1 public

Address: Version:

145.134.118.16 1

1 private

Address: Version:

145.134.118.18 1

Trap Client: Community:

Figure 52 - SNMP Client Display Field

Description

Get Client

The SNMP client (e.g., a Network Operations Center, or NOC) which is permitted to perform an SNMP get on the LX unit.

Set Client

The SNMP client (e.g., a Network Operations Center, or NOC) which is permitted to perform an SNMP set on the LX unit.

Trap Client

The SNMP client (e.g., a Network Operations Center, or NOC) which is permitted to trap SNMP characteristics from the LX unit.

Community

The name of the applicable SNMP Community to which the LX unit belongs. When an SNMP Community Name has been specified for the unit, only SNMP clients which belong to the same community are permitted to perform the applicable SNMP operation (Get, Set, or Trap) on the unit.

Address

The IP Address of the SNMP Get, Set, or Trap client.

Version

The SNMP Get, Set, or Trap Version for the client. The possible values are 1, 2, or 3.

451-0310E

133

show snmp v3 Displays V3 information for SNMP clients. Syntax show snmp v3 all| Where

Means

all

Display information for all SNMP clients on this LX unit.

client_number

The client number for an SNMP client

Example show snmp v3 3 Figure 53 shows an example of the V3 display for an SNMP client.

Client: Engine Boots: Engine ID: V3 View OID Subtree: V3 View OID Subtree Mask: V3 View Name: V3 View Type: V3 Access Group Name: V3 Access Security Model: V3 Access Read View: V3 Access Notify View: V3 Access Cont. Match: V3 Security Name: V3 Secur. Community: V3 Group Secur. Model: V3 Group Name:

4 8 e70303eeace2923a000000000000000000000000 0 8000000000000000000000000000000000000000 Allow 3 view view none public

V3 Access Context Prefix: V3 Access Security Level: V3 Access Write View:

V3 Source IP: V3 Source Mask: V3 Group Secur. Name:

1 view

0.0.0.0 0.0.0.0

Figure 53 - V3 Display Field

Description

Client

The SNMP client number.

Engine Boots

The number of times the SNMP v3 daemon has booted (i.e., used its shared secret).

Engine ID

The ID of the SNMP v3 daemon.

V3 View OID Subtree

The OID range that is accessible by this view.

V3 View OID Subtree Mask

The valid numbers in the subtree, specified as the individual bits of the digits.

134

451-0310E

show snmp v3 (continued)

V3 View Name

The name of the view entry.

V3 View Type

Indicates whether the v3 view type is allowed or denied. If the value of this field is Enabled, the view type is allowed. If the value of this field is Disabled, the view type is denied.

V3 Access Group Name

The name of a group to map to a view.

V3 Access Security Model

The version number of the group entry.

V3 Access Read View

The view to use for read requests.

V3 Access Notify View

The view to use for Notify requests.

V3 Access Cont. Match

Indicates whether the context prefix is a prefix of an exact value.

V3 Security Name

The user name to be used for the IP Address specified by the Source IP, Source Mask, and Community.

V3 Secur. Community

The Community Name used in a request to map to a Security Name.

V3 Group Secur. Model

The Version Number of a request to map to a Group Name.

V3 Group Name

The Name of the v3 Group.

V3 Access Context Prefix

The Access Context Prefix.

V3 Access Security Level

Indicates the v3 Access Security Level for the LX unit. The possible values are as follows: 1 - No authorization 2 - Authorization with no privileges 3 - Authorization with privileges 4 - The LX unit is non-v3

V3 Access Write View

The view to use with write requests.

V3 Source IP

The IP range that is mapped to the Security Name for non-v3 requests.

V3 Source Mask

The incoming IP Address is ANDed with this mask before it is compared with the Source IP Address.

451-0310E

135

show snmp v3 (continued)

V3 Group Secur. Name

136

The name of the user to map to a group.

451-0310E

show subscriber Displays the status or characteristics for selected subscribers. Syntax show subscriber |all characteristics|status|tcp Where

Means

subscriber_name

The subscriber for which data is to be displayed.

all

Display the specified data for all subscribers on the LX unit.

characteristics

Displays the characteristics for the specified subscribers. This option displays a screen that contains the same fields as the subscriber characteristics that are displayed in User Mode. For more information, refer to Figure 11 on page 56.

status

Displays the status information for the specified subscribers. This option displays a screen that contains the same fields as the subscriber status screen that is displayed in User Mode. For more information, refer to Figure 12 on page 59.

tcp

Displays the TCP information for the selected subscribers. This option displays a screen that contains the same fields as the subscriber TCP screen that is displayed in User Mode. For more information, refer to Figure 13 on page 60.

Examples show subscriber tim characteristics show subscriber tim status show subscriber all tcp

451-0310E

137

show subscriber summary Displays summary information for all of the subscribers configured on the LX unit. Syntax show subscriber summary Examples show subscriber summary Figure 54 shows an example of the Subscriber Summary Display.

Name InReach demo jack

Connections 0 1 0

Terminal Type Ansi Ansi Ansi

Figure 54 - Subscriber Summary Display

138

451-0310E

show system characteristics Displays the global system configuration for the LX unit. Syntax show system characteristics Example show system characteristics Figure 55 shows an example of the system display for an LX unit. Name: InReach Serial Number: 00:a0:9c:00:01:43 Location: Domain Name suffix: Maximum Number of Async Ports: 8 Maximum Number of Subscribers: 16 Maximum Number of Interfaces: 4 Primary Domain : 102.19.176.254 Gateway : 102.19.169.1 Timed Daemon: Disabled NTP Daemon: Disabled NTP Server: 0.0.0.0 Finger Daemon: Disabled Telnet Daemon: Enabled Web Server: Enabled

Time:

Wed, 10 Apr 2002 02:13:18 UTC

UpstairsLab yourcompany.com Internal Modem on Port: 0 Maximum Number of Virtual Ports: 32 Maximum Number of Ethernet Ports: 1 Secondary Domain : 102.19.128.17 Default TFTP Server : 102.19.169.182 TFTP Retries: 3 TFTP Timeout: 3 SNMP Feature: Disabled Logging Size : 64000 SSH Daemon: Enabled

Figure 55 - System Display Field

Description

Name

The host name of the LX unit.

Location

A text string that specifies the physical location of the LX unit.

Serial Number

The Serial Number of the LX unit.

Domain Name Suffix

The suffix for the LX-unit Domain Name.

Maximum Number of Async Ports

The maximum allowable number of asynchronous ports on the LX unit.

Maximum Number of Subscribers

The maximum number of subscribers on the LX unit.

Maximum Number of Interfaces

The maximum allowable number of IP interfaces on the LX unit.

Primary Domain

The IP Address of the Primary Domain Name Server (DNS) for the LX unit.

451-0310E

139

show system characteristics (continued)

Gateway

The IP Address for the gateway (default route) of the LX unit.

Timed Daemon

Indicates whether the Timed Daemon is Enabled or Disabled.

NTP Daemon

Indicates whether the Network Time Protocol (NTP) Daemon is Enabled or Disabled on the LX unit.

NTP Server

The IP Address of the NTP server for the LX unit.

Finger Daemon

Indicates whether the Finger Daemon (fingerd) is Enabled or Disabled on the LX unit.

Telnet Daemon

Indicates whether the Telnet Daemon is Enabled or Disabled on the LX unit.

Web Server

Indicates whether the WebServer feature (Browser Management) is Enabled or Disabled on the LX unit.

Time

The date and time that the show system characteristics command was executed.

Internal Modem on Port

Indicates whether or not the LX port has an internal modem.

Maximum Number of Virtual Ports

The maximum allowable number of virtual ports on the LX unit.

Maximum Number of Ethernet Ports

The maximum allowable number of Ethernet ports on the LX unit.

Secondary Domain

The IP Address of the Secondary Domain Name Server (DNS) for the LX unit.

Default TFTP server

The default network server for updating the software image, the iBoot file, and parameter files.

TFTP Retries

The number of times the TFTP server will attempt to communicate with the LX unit.

TFTP Timeout

If the LX unit can not load from the TFTP Server before the expiration of this timeout, the TFTP Server is considered dead.

SNMP Feature

Indicates whether SNMP is Enabled or Disabled for the LX unit.

Logging Size

Indicates the size of logging files on the unit.

SSH Daemon

Indicates whether the SSH Daemon is Enabled or Disabled on the LX unit.

140

451-0310E

show system ppciboot Displays the ppciboot configured load settings for the LX unit. Syntax show system ppciboot Example show system ppciboot Figure 56 shows an example of the ppciboot Configured Load Settings Display for an LX unit. Ppciboot Configured Load Settings Ppciboot Software Version Ppciboot Ethernet Network Link Software Load From Flash Software Load From Network Software Filename Configured IP Address Configured Network Mask Configured Gateway Address Configured TFTP Server Address IP Assignment Method #1 IP Assignment Method #2 IP Assignment Method #3 IP Assignment Method #4

: : : : : : : : : : : : :

0.9.3.26 auto no yes linuxito.img 145.189.121.19 255.255.255.0 145.177.123.1 145.177.169.208 User Defined BOOTP RARP DHCP

Figure 56 - ppciboot Configured Load Settings Display

451-0310E

141

show system status Displays system status information for the LX unit. Syntax show system status Example show system status Figure 57 shows an example of the System Status Display for an LX unit.

Time:

Mon, 24 Feb 2003 20:17:20 UTC

Software Load From Active System Gateway Configuration Load From Network file Name Configuration File to Boot From Configuration Settings to Boot From Configuration Status Configuration Version CPU usage (0.10 = 10%): 1 min. Avg usage : 5 min. Avg usage : 15 min. Avg usage :

: : : : : : : :

0.00 0.00 0.00

Temperature Status (degrees Celsius): Critical Temp. : 60.0 Low Temperature : 0.0 Current Temp. : 38.5 PowerFail Log:

System Uptime:

0 8:7:50 Local Flash Memory 102.19.169.1 Local Flash Memory /config/Config.prm Flash Configuration Saved 4

Memory usage (in KB): Total Memory : Cached Memory : Free Memory :

Hysteresis Temp. Threshold Temp.

: :

62760 6320 28488

5.0 55.0

Feb 24 21:54:33 2003

Figure 57 - System Status Display Field

Description

Software Load From

The IP Address of the Load Server for the LX software image.

Active System Gateway

The IP Address of the gateway that is currently being used by the LX unit.

Configuration Load From

The parameter server for the LX unit.

Network File Name

The filename of the network file from which the LX configuration is loaded.

Configuration File to Boot From

The filename of the file from which the LX unit is booted.

142

451-0310E

show system status (continued)

Configuration Settings to Boot From

Indicates whether the configuration of the LX unit is booted from the local flash or from the network.

Configuration Status

Indicates whether the current configuration of the LX unit has been saved with the save configuration command.

Configuration Version

The version number of the LX configuration. This number is incremented by 1 each time a modified version of the LX configuration is saved.

CPU usage (0.10 = 10%) 1 min. Avg usage

Average CPU usage over the last minute.

5 min. Avg usage

Average CPU usage over the last 5 minutes.

15 min. Avg usage

Average CPU usage over the last 15 minutes.

Memory usage (in KB) Total Memory

The total memory on the LX unit (in KB).

Cached Memory

The total cached memory in use (in KB).

Free Memory

The total free memory (in KB).

Temperature Status (degrees Celsius) Critical Temp.

The temperature level (in Celsius degrees) that is considered critical for the LX unit.

Low Temperature

The lowest supported operating temperature for the LX unit.

Current Temp.

The current temperature of the LX unit.

Hysteresis Temp.

The Hysteresis for temperature measurements on the LX unit.

Threshold Temp.

The highest supported operating temperature for the LX unit.

PowerFail Log

The dates and times when power failures have occurred on the LX unit. Note: This field also displays the date and time when the LX unit is unplugged.

451-0310E

143

show tacacs+ characteristics Displays information about the TACACS+ authentication and accounting servers for the LX unit. Syntax show tacacs+ characteristics Example show tacacs+ characteristics Figure 58 shows an example of the TACACS+ Display. Time: Wed, 10 Apr 2002 00:44:48 UTC Primary TACACS+ Authentication Server: IP Address: 0.0.0.0 TACACS+ Auth. TCP Port: 49 Secret: Not Configured Timeout: 4 Retry: 4 Secondary TACACS+ Authentication Server: IP Address: 0.0.0.0 TACACS+ Auth. TCP Port: Secret: Not Configured Timeout: Retry: 4

49 4

Primary TACACS+ Accounting Server: IP Address: 0.0.0.0 Secret: Not Configured Retry: 4

TACACS+ Acct. TCP Port: Timeout:

49 4

Secondary TACACS+ Accounting Server: IP Address: 0.0.0.0 Secret: Not Configured Retry: 4

TACACS+ Acct. TCP Port: Timeout:

49 4

TACACS+ Superuser Request: Disabled TACACS+ Accounting Server Period: 5 Inbound TACACS+ Enabled Serial Ports: Outbound TACACS+ Enabled Serial Ports: TACACS+ Enabled Interfaces:

Figure 58 - TACACS+ Display Field

Description

IP Address

The IP Address for the applicable Authentication or Accounting Server.

Secret

The TACACS+ secret shared between the LX unit and the TACACS+ server used for encrypting communications between them.

Retry

The number of times the LX unit will attempt to connect to the TACACS+ server.

144

451-0310E

show tacacs+ characteristics (continued)

TACACS+ Auth. TCP Port

The TCP port that the LX unit and the applicable TACACS+ authentication server will use for communication.

TACACS+ Acct. TCP Port

The TCP port that the LX unit and the applicable TACACS+ accounting server will use for communication.

Timeout

The time to wait for a TACACS+ server to respond before retransmitting packets to the server.

TACACS+ Superuser Request

Indicates whether or not the TACACS+ Superuser password is used to enter the Superuser Command Mode. The possible values of this field are Enabled and Disabled. If this field is Enabled, the TACACS+ Superuser password will be used to enter the Superuser Command Mode. If this field is Disabled, the Local Password will be used to enter the Superuser Command Mode. Note: Even if this field is Disabled, the logon authentication to the LX unit will be through TACACS+.

Inbound TACACS+ Enabled Serial Ports

The Inbound serial ports that are enabled for TACACS+.

Outbound TACACS+ Enabled Serial Ports

The Outbound serial ports that are enabled for TACACS+.

TACACS+ Enabled Interfaces

The LX IP interfaces that are enabled for TACACS+.

TACACS+ Accounting Server Period

The length of time, in seconds, that the TACACS+ server waits for a reply from the TACACS+ Accounting server.

451-0310E

145

show tacacs+ status Displays statistical information on TACACS+ authentication attempts. Syntax show tacacs+ status Example show tacacs+ status Figure 59 shows an example of the TACACS+ Status Display.

Time: Wed, 08 May 2002 13:32:34 UTC Total TACACS+ Authentication Message Exchange: Primary Secondary Successful attempts: 2 0 Failed attempts: 0 0 Total TACACS+ Accounting Message Exchange: Successful attempts: Failed attempts:

Primary 0 6

Secondary 0 6

TACACS+ Authentication Counter Summary: Successful Logins: Authentication Failures:

Primary 2 0

Secondary 0 0

TACACS+ Accounting Counter Summary: Successful Acct Entries: Failed Acct Entries:

Primary 0 0

Secondary 0 0

TACACS+ Superuser Enable Summary: Successful Enable Requests: Failed Enable Requests:

Primary 0 0

Secondary 0 0

TACACS+ Fallback Counter Summary: Total Fallback Logins:

0

Figure 59 - TACACS+ Status Display Field

Description

Total TACACS+ Authentication Message Exchange

Successful Attempts

The number of times the primary and secondary TACACS+ authentication servers successfully exchanged messages with the LX unit.

Failed attempts

The number of times the primary and secondary TACACS+ authentication servers failed to exchange messages with the LX unit.

146

451-0310E

show tacacs+ status (continued)

Total TACACS+ Accounting Message Exchange

TACACS+ Authentication Counter Summary

TACACS+ Accounting Counter Summary

TACACS+ Superuser Enable Summary

TACACS+ Fallback Counter Summary

451-0310E

Successful Attempts

The number of times the primary and secondary TACACS+ accounting servers successfully exchanged messages with the LX unit.

Failed attempts

The number of times the primary and secondary TACACS+ accounting servers failed to exchange messages with the LX unit.

Successful Logins

The number of successful logins using TACACS+.

Authentication Failures

The number of unsuccessful logins using TACACS+.

Successful Acct Entries

The number of successful TACACS+ accounting entries.

Failed Acct Entries

The number of failed TACACS+ accounting entries.

Successful Enable Requests

This field only contains a value if TACACS+ Superuser Request is enabled. If TACACS+ Superuser Request is enabled, this field indicates the number of successful logins to Superuser Mode.

Failed Enable Requests

This field only contains a value if TACACS+ Superuser Request is enabled. If TACACS+ Superuser Request is enabled, this field indicates the number of unsuccessful attempts at logging in to Superuser Mode.

Total Fallback Logins

The number of logins that have been done through the TACACS+ Fallback Login feature.

147

show tacacs+ summary Displays summary data for the TACACS+ authentication and accounting servers. Syntax show tacacs+ summary Example show tacacs+ summary Figure 60 shows an example of the TACACS+ Summary Display. TACACS+ Server Summary Primary Auth. Server: Secondary Auth. Server: Primary Acct. Server: Secondary Acct. Server:

0.0.0.0 0.0.0.0 0.0.0.0 0.0.0.0

Thu, 12 Sep 2002 20:47:18 Primary Auth. TCP Port: 49 Secondary Auth. TCP Port: 49 Primary Acct. TCP Port: 49 Secondary Acct. TCP Port: 49

Figure 60 - TACACS+ Summary Display Field

Description

Primary Auth. Server

The IP Address of the Primary TACACS+ Authentication server.

Secondary Auth. Server

The IP Address of the Secondary TACACS+ Authentication server.

Primary Acct. Server

The IP Address of the Primary TACACS+ Accounting server.

Secondary Acct. Server

The IP Address of the Secondary TACACS+ Accounting server.

Primary Auth. TCP Port

The TCP port for the Primary TACACS+ Authentication server.

Secondary Auth. TCP Port

The TCP port for the Secondary TACACS+ Authentication server.

Primary Acct. TCP Port

The TCP port for the Primary TACACS+ Accounting server.

Secondary Acct. TCP Port

The TCP port for the Secondary TACACS+ Accounting server.

148

451-0310E

show users Displays information about each user that is currently logged in to the LX unit. Syntax show users Example show users Figure 61 shows an example of the Users screen. Name InReach demo demo

Remote IP Address 0.0.0.0 0.0.0.0 0.0.0.0

Local Port 0 0 0

Protocol 0 0 0

Device /dev/pts/3 /dev/ttyGN1 /dev/pts/1

Figure 61 - Users Screen Field

Description

Name

The user name

Remote IP Address

If the user is logged in from a remote IP Address, the address is displayed in this field.

Local Port

If the user is logged on to a local port of the LX unit, the port number is displayed in this field.

Protocol

The protocol under which the user is connected to the LX unit.

Device

The Linux Device Number under which the user is logged in.

451-0310E

149

show version Displays the Linux OS version, Linux In-Reach version, LX software version, and ppciboot version for the LX unit. Syntax show version Example show version Figure 62 shows an example of the Version screen. Linux Kernel Version: Linux In-Reach Version: Software Version: Ppciboot Version:

2.4.9 15 2.2.0 0.9.3.26

Figure 62 - Version Screen Field

Description

Linux Kernel Version

The version of the Linux Operating System that is running on the LX unit.

Linux In-Reach Version

The version of the In-Reach implementation of Linux.

Software Version

The version of the LX software that is running on the LX unit.

Ppciboot Version

The version of ppciboot that the LX unit is using.

150

451-0310E

ssh Opens a Secure Shell (Triple-DES/BLOWFISH) connection. Syntax ssh [A.B.C.D [NUMBER]]|[NAME [NUMBER]] [LOGIN NAME] Where

Means

A.B.C.D

The IP Address of the SSH server to which the connection is being made. (See “Usage Guidelines” (below) for the default value of this field.)

NAME

The Domain Name of the SSH server to which the connection is being made. (See “Usage Guidelines” (below) for the default value of this field.)

NUMBER

The socket number to which the connection is being made.

LOGIN NAME

The name that you are using to log in to the SSH server.

Usage Guidelines The default SSH server is your Preferred Service. Refer to the preferred service command on page 399 for information on configuring a Preferred Service. If the ssh command is executed without an SSH server, and you do not have a Preferred Service configured, the following error message is displayed: No Preferred Service Configured Examples ssh 102.19.240.14 ssh 102.19.240.14 2322 ssh ssh 102.19.240.14 2322 henryh

451-0310E

151

telnet Opens a Telnet connection to a host. Syntax telnet [A.B.C.D [NUMBER]]|[NAME [NUMBER]] Where

Means

A.B.C.D

The IP Address of the Telnet host. (See “Usage Guidelines” (below) for the default value of this field.)

NAME

The Domain Name of the Telnet host. (See “Usage Guidelines” (below) for the default value of this field.)

NUMBER

The socket number to which the connection is being made.

Usage Guidelines The default Telnet host is your Preferred Service. Refer to the preferred service command on page 399 for information on configuring a Preferred Service. If the telnet command is executed without a Telnet host, and you do not have a Preferred Service configured, the following error message is displayed: No Preferred Service Configured Examples telnet 102.19.240.14 telnet 102.19.240.14 2500 telnet

152

451-0310E

terminal Sets the terminal type for the LX user. Syntax terminal Where

Means

terminal_type

The terminal type for the LX unit. The allowable terminal types are VT100 and ANSI.

Example terminal vt100 terminal ansi

451-0310E

153

update Updates the LX software or ppciboot file from a TFTP server on the network. Syntax update software|ppciboot [] Where

Means

software

Update the LX software from the specified TFTP server.

ppciboot

Update the LX ppciboot file from the specified TFTP server.

tftp_server

The IP Address or the Domain Name of the TFTP server from which the LX software or ppciboot file is to be copied. If this field is not specified, the default TFTP server is used. To display the default TFTP server, refer to “show system characteristics” on page 139.

Usage Guidelines In order for this command to take effect, you must restart the LX unit by executing the reload command. The reload command is described on page 79. If this command is executed without a TFTP server specified, and there is no default TFTP server configured, the following error message is displayed: No TFTP Host Download Failed Examples update ppciboot 102.19.169.141 update software 102.19.169.141 update ppciboot update software

154

451-0310E

zero all Erases the statistics data for the LX unit. Syntax zero all Example zero all

451-0310E

155

zero log Resets the log files for the LX unit. Syntax zero log Example zero log

156

451-0310E

zero securid secret Deletes from the LX unit the SecurID Secret that was sent from the SecurID server. Syntax zero securid secret Example zero securid secret

451-0310E

157

Chapter 3 Configuration Commands

The Configuration commands are executed in the Configuration command mode. When the LX unit is in the Configuration command mode, the Configuration command prompt (i.e., Config:0 >>) is displayed on the terminal screen. The format of the Configuration command prompt is as follows: Config: >> where

is the session number of the current connection.

To enter the Configuration command mode, do one of the following: •

If you are in the Superuser command mode, execute the configuration command. This displays the configuration prompt. Refer to page 67 for more information on the configuration command.

•

451-0310E

If you are in the Interface, Ethernet, Subscriber, Asynchronous, Menu, Menu Editing, Notification, or Broadcast Groups command mode, execute the exit command until the Configuration command prompt is displayed.

159

boot configuration from flash Configures the LX unit to boot the configuration from the local flash. Syntax boot configuration from flash Example boot configuration from flash

160

451-0310E

boot configuration from name Configures the LX unit to boot from a local file on the LX unit. Syntax boot configuration from name Where

Means

filename

The name of the local (LX-based) from which the LX unit will be booted. The filename may include a suffix. For example, the default filename is config.prm.

NOTE: You can use the show system status command to display the name of the boot file. The show system status command is described on page 142. Example boot configuration from name local.prm

451-0310E

161

boot configuration from network Configures the LX unit to boot from a TFTP server. Syntax boot configuration from network Where

Means

ip_address

Specifies the IP Address of the TFTP server from which the LX unit is to be booted.

filename

The file on the LX unit, or on the TFTP server, from which the LX unit will be booted. The filename must not include a suffix. For example, local is a valid filename, but local.img is not a valid filename.

Example boot configuration from network 119.25.42.37 new_image

162

451-0310E

broadcast group Creates a Broadcast Group or accesses a Broadcast Group that already exists. Syntax broadcast group Where

Means

group_number

The group number of the Broadcast Group. This can be any integer number between 1 and 5.

Usage Guidelines A Broadcast Group consists of Slave Ports and Master Ports. The Slave Ports receive data broadcasts from the Master Ports. The Slave Ports can be asynchronous ports or a TCP port. Users can receive data broadcasts by Telneting to a port that is configured as a Slave Port. A Master Port and its Slave Ports constitute a Broadcast Group, and a Slave Port can only receive data from its Master Port. Any console port or virtual port can be configured as a Master Port. Example broadcast group 4

451-0310E

163

broadcast group enable Enables a Broadcast Group. NOTE: In order to enable a Broadcast Group, the Broadcast Group must contain at least one Master Port and one Slave Port. Syntax broadcast group enable Where

Means

group_number

The group number of the Broadcast Group.

Example broadcast group 4 enable

164

451-0310E

clock Sets the time for the LX system clock. NOTE: Use the date command to set the date for the system calendar. For more information, refer to “date” on page 168. Syntax clock HH:MM[:SS] Where

Means

HH

The hour in 24-hour format; for example, 23.

MM

The minute; for example, 09.

SS

The second; for example, 02.

Examples clock 14:47 clock 04:29:11

451-0310E

165

copy port Copies the configuration of one LX port to another LX port, or to a range of LX ports. Syntax copy port to [] Where

Means

origin_port

The LX port from which the configuration is to be copied.

destination_port1

The first port in a range of LX ports to which the configuration is to be copied. (Note: If destination_portn is not specified, the configuration is copied only to destination_port1.)

destination_portn

The last port in a range of LX ports to which the configuration is to be copied.

Examples copy port 3 to 6 copy port 2 to 5 7

166

451-0310E

copy subscriber Copies the configuration of one LX subscriber to one, or several, LX subscribers. If the destination subscriber is not in the database, a new subscriber is created. Syntax copy subscriber to * Where

Means

origin_subscriber

The LX subscriber from which the configuration is to be copied.

destination_subscriber

The subscribers to which the configuration of origin_subscriber is to be copied. Note: If you specify an existing subscriber in this field, the origin_subscriber configuration overwrites the destination_subscriber.

Usage Guidelines The maximum number of subscribers on an LX unit is equal to double the number of ports on the unit. For example, the maximum number of subscribers is 16 on an 8-port unit, 32 on a 16port unit, 64 on a 32-port unit, and 96 on a 48-port unit. Examples copy subscriber benw to jimk billj edw susano emilyc copy subscriber mark to bill

451-0310E

167

date Sets the date for the LX system calendar. NOTE: Use the clock command to set the system clock for the LX unit. For more information, refer to “clock” on page 165. Syntax date MM/DD[/YYYY] Where

Means

MM/DD[/YYYY]

The date for the LX system calendar, where MM =

The month; for example, 03 for March.

DD =

The date; for example, 17 for the 17th.

YYYY =

The 4-digit year; for example, 2002.

Example date 03/17/2002 NOTE: In the above example, the date is set to March 17, 2002.

168

451-0310E

default boot Resets the boot file for the LX unit to the default boot file. When this command is entered the following message is displayed: File Saved Syntax default boot Example default boot

451-0310E

169

default configuration Resets the configuration of the LX unit to default values and then shuts down and re-starts the LX unit. Syntax default configuration Usage Guidelines When this command is entered, the following confirmation prompt is displayed: Do You Really want to default the unit? [y|n]

:

Entering "y" will reset the configuration. Entering "n" will abort the command. If you enter “y” to default the configuration, you must re-start the LX unit with the reload command to make the default configuration take effect. The reload command is described on page 79. Example default configuration

170

451-0310E

default log size Resets the sizes of log files on the LX unit to the default value. Syntax default log size Example default log size

451-0310E

171

default outlet group off time Resets the off time for an outlet group to the default value of 10 seconds. Syntax default outlet group | off time Where

Means

group_number

An integer number that identifies the group whose off time is being reset to the default value.

group_name

The name assigned to the outlet group.

Examples default outlet group 2 off time default outlet group rmlights off time

172

451-0310E

default tftp Resets the timeout or retry value for the TFTP server to its default value. Syntax default tftp timeout|retry Where

Means

timeout

Reset the TFTP server timeout to its default value.

retry

Reset the TFTP server retries to its default value.

Examples default tftp timeout default tftp retry

451-0310E

173

domain name Specifies the domain name of the LX unit. Syntax domain name NAME Where

Means

NAME

The domain name for the LX unit. The domain name should include a period (.) and a suffix.

Usage Guidelines The portion of the domain name that follows the period is the domain name suffix. For example, com is the suffix in the domain name boston_office.com. Example domain name boston_office.com

174

451-0310E

end When the end command is issued in the Configuration Command Mode, it returns the user to the Superuser command mode. Syntax end Usage Guidelines The end command can be issued in all of the LX command modes except for User and Superuser. Executing the end command always returns the user to the Superuser command mode. Example end

451-0310E

175

exit Returns the user to the previous command mode. For example, if the current command mode is Configuration, issuing this command will return the user to the Superuser command mode. Syntax exit Usage Guidelines The exit command can be issued in all of the LX command modes. However, the effect of the exit command varies, depending on the command mode from which it is issued. As noted above, issuing the exit command in the Configuration command mode returns the user to the previous command mode. The same goes for issuing the exit command in any command mode other than User. For example, issuing the exit command in the Interface command mode returns the user to the Configuration command mode; issuing the exit command in the Menu Editing command mode returns the user to the Menu command mode, and so on. Issuing the exit command in the User command mode exits the LX CLI and closes the connection to the LX unit. Example exit

176

451-0310E

fingerd enable Enables the finger daemon (fingerd) for exchanging information between hosts about users who are logged on to the LX unit. Syntax fingerd enable Example fingerd enable

451-0310E

177

gateway Configures the network gateway IP address for the LX unit. Syntax gateway A.B.C.D Where

Means

A.B.C.D

The IP Address of the router/gateway that is to be used as the default route for the LX unit.

Example gateway 119.20.112.47

178

451-0310E

hostname Configures a network name for the LX unit. Syntax hostname NAME Where

Means

NAME

A text string of up to 15 alphanumeric characters that specifies the network name for the LX unit.

Examples hostname boston_office hostname a123456

451-0310E

179

interface Enters the Interface command mode. In the Interface command mode, the user can create or change an interface record. For more information on the Interface command mode, refer to “Interface Commands” on page 275. Syntax interface NUMBER Where

Means

NUMBER

Specifies an interface number. In the Interface command mode, you can configure the characteristics of the IP interface that is associated with this interface number. The maximum number of IP interfaces is 4. If the IP interface does not exist, it is created when this command is executed.

Example interface 1

180

451-0310E

iptables Displays information that describes how to set up IP filtering with the iptables command. Syntax iptables Usage Guidelines When you execute this command, the following text is displayed: You must commands from the "shell". Commands

navigate to the Linux shell and use the iptables that are available in the kernel. You can run a shell Superuser Command Mode by launching the command For further details, please refer to the LX-Series Reference Guide.

Iptables are used to set up, maintain, and inspect the tables of IP packet filter rules in the Linux kernel. Iptables help manage IP traffic by creating filters known as chains. Each chain is a list of rules which can match a set of packets. Each rule specifies what to do with a packet that matches. The options are ACCEPT, DENY, or DROP. The INPUT chain filters packets coming from the LAN to the LX-Series and the OUTPUT chain filters packets leaving the LX-Series destined for the LAN. After making any changes, you should always run the command "/sbin/iptables-save -f /config/iptables.conf" to save the changes. To make the change permanent through reboots you must save the configuration change by running the command "save configuration" from the superuser command mode.

Example iptables

451-0310E

181

location Specifies the physical location of the LX unit. NOTE: To display this information, execute the show system characteristics command in the Superuser Command Mode. For more information, refer to “show system characteristics” on page 139. Syntax location STRING Where

Means

STRING

A text string that describes the physical location of the LX unit.

Example location UpstairsLab

182

451-0310E

log size Specifies the size of log files on the LX unit. Syntax log size NUMBER Where

Means

NUMBER

A whole number that specifies the size, in bytes, for the LX-unit log files. The number must be greater than 1023 and less than 128001.

Example log size 100000

451-0310E

183

menu Enters the Menu command mode. In the Menu command mode, you can create, delete, or merge menus and enter the Menu Editing command mode. For more information on the Menu command mode, refer to “Menu Commands” on page 479. Syntax menu Example menu

184

451-0310E

no Disables (negates) specific features and boolean parameters on the LX unit. Refer to “Usage Guidelines” (below) for more information about using the no command in the Configuration command mode. Syntax no Where

Means

feature_name

The name of the feature or boolean parameter that is to be disabled.

Usage Guidelines The allowable arguments for this command consist of only those features and boolean parameters that can be set in the Configuration command mode and are currently enabled. To view the features and boolean parameters that are currently enabled, type the no command followed by a question mark (?). Example no location

451-0310E

185

notification Enters the Notification command mode. In the Notification command mode, you can configure the sending of log messages to email addresses, pagers, remote syslogd, asynchronous ports, or local files. For more information on the Notification command mode, refer to “Notification Commands” on page 509. Syntax notification Example notification

186

451-0310E

ntp enable Enables the Network Time Protocol (NTP). Syntax ntp enable Usage Guidelines Before you can enable NTP, you must specify the IP Address of the NTP server. Refer to “ntp server address” on page 188 for more information on specifying the IP Address of the NTP server. Example ntp enable

451-0310E

187

ntp server address Specifies the IP address of the Network Time Protocol (NTP) server for the LX unit. Syntax ntp server address Where

Means

ip_address

Specifies the IP Address of the NTP server on the network.

Usage Guidelines After you have specified the NTP server, you can enable NTP. Refer to “ntp enable” on page 187 for more information on enabling NTP. Example ntp server address 119.20.110.87

188

451-0310E

outlet group Assigns outlets to an outlet group. Syntax outlet group | Where

Means

group_number

An integer number that identifies the group to which outlets are being assigned. The allowable values are 1 - 16.

group_name

The descriptive name of the group to which outlets are being assigned. (Refer to “outlet group name” on page 190 for information on assigning a descriptive name to an outlet group.)

outlet_list

Specifies the outlets that are being added to the outlet group. The Power Master number, combined with the outlet number, identifies each outlet. For example, 2:5 identifies outlet 5 on the device that is managed from port 2. If you specify more than one outlet in the outlet_list, the outlets must be separated by blank spaces; for example, 2:5 3:7 4:2 4:3 4:5. Up to 16 outlets can be included in an outlet group.

Usage Guidelines When outlets are assigned to an outlet group, they can be configured and managed as a group. This can be more efficient than configuring and managing outlet individually. Refer to the following commands for more information about configuring and managing outlet groups: •

“outlet group name” on page 190

•

“outlet group off time” on page 191

•

“show outlet group status” on page 107

Examples outlet group 2 2:5 3:7 4:2 4:3 4:5 outlet group Testoutlets 3:4 5:1 5:2 5:3 5:4 5:5 5:6 6:2 6:3

451-0310E

189

outlet group name Specifies a descriptive name for an outlet group. NOTE: Before you can specify a descriptive name for an outlet group, you must create the outlet group with the outlet group command (see page 189). Syntax outlet group name Where

Means

group_number

An integer number that specifies an existing outlet group.

group_name

Specifies a descriptive name for the outlet group. This can be a text string of up to 15 characters.

Example outlet group 5 name Testoutlets

190

451-0310E

outlet group off time Specifies the length of time, in seconds, that outlets must remain off before they can be turned back on. Syntax outlet group | off time NUMBER Where

Means

group_number

An integer number that specifies an existing outlet group.

group_name

The descriptive name of an existing outlet group.

NUMBER

An integer number that specifies the off time, in seconds, for the outlet group. After the outlets in the group have been turned off with the outlet command (see page 75), they must remain off for at least this length of time. The allowable values are 0 - 255. The default value is 10.

Example outlet group Testoutlets off time 10 outlet group 14 off time 20

451-0310E

191

password Allows you to set, or change, the Superuser password for the LX unit. (The default Superuser password for the LX unit is system.) Syntax password Usage Guidelines When you execute the password command, the following prompt is displayed: Enter your NEW password

:

Type the new Superuser password at the above prompt and press the Enter key. After you press the Enter key, the following prompt is displayed: Re-Enter your NEW password: Re-type the new Superuser password at the above prompt and press the Enter key. The Superuser password for the LX unit is now changed. Example password

192

451-0310E

password enable Sets the Superuser password for the LX unit to the default value. (The default Superuser password for the LX unit is system.) Syntax password enable Usage Guidelines When you execute the password enable command, the following informational message is displayed: Password was set to its default value Example password enable

451-0310E

193

port async Configures an LX asynchronous port, or a range of LX asynchronous ports. When this command is executed in the Configuration Command Mode, the LX CLI goes into the Asynchronous command mode for the port number, or range of ports. The Asynchronous command mode includes commands for configuring asynchronous ports. Refer to “Asynchronous Commands” on page 307 for more information on the Asynchronous command mode. Syntax port async [] Where

Means

first_port

The first port in a range of ports that are to be configured as asynchronous.

last_port

The last port in a range of ports that are to be configured as asynchronous. Note: If this argument is left out of the command, only the port specified in is configured as asynchronous.

Example port async 2 port async 3 7

194

451-0310E

port ethernet Enters the Ethernet Command Mode for an Ethernet port. Refer to “Ethernet Commands” on page 361 for more information on the Ethernet Command Mode. Syntax port ethernet NUMBER Where

Means

NUMBER

Specifies the Ethernet port to be configured. The only port that can be configured as an Ethernet port is port 1.

Example port ethernet 1

451-0310E

195

ppciboot address Specifies the ppciboot address for the LX unit. The ppciboot address is used as the IP Address of the LX unit when any of the ppciboot assignment options is selected as “User Defined”. Refer to “ppciboot address assignment option” on page 197 for more information on the ppciboot assignment options. Syntax ppciboot address Where

Means

ip_address

The ppciboot address

Example ppciboot address 117.23.79.81

196

451-0310E

ppciboot address assignment option Specifies the ppciboot assignment option for the LX unit. The ppciboot assignment option defines how the LX unit will obtain its IP information. Syntax ppciboot address assignment NUMBER option user|dhcp|rarp|bootp|none Where

Means

NUMBER

The priority for the ppciboot assignment options. The allowable values are 1, 2, 3, and 4. For more information, refer to “Usage Guidelines” (below).

user

Specifies that the ppciboot assignment option is user-defined. This means that the user must manually assign all of the IP information.

dhcp

The IP information will be assigned via a DHCP server.

rarp

The IP information will be assigned via a RARP server.

bootp

The IP information will be assigned via a BOOTP server.

none

Disables the ppciboot assignment option associated with the specified priority. For example, the command ppciboot ip assignment 2 option none disables the ppciboot assignment option associated with priority 2.

Usage Guidelines You can use this command to specify up to 4 ppciboot assignment options for the LX unit. You must specify a priority for each ppciboot assignment option that you specify with this command. The allowable values are 1, 2, 3, and 4. For example, if 1 is specified as the priority for DHCP, it means that the first attempt at loading an IP Address will be via DHCP; if 2 is specified as the priority for RARP, it means that the second attempt at loading an IP Address will be via RARP, and so on. Examples ppciboot address assignment 1 option dhcp ppciboot address assignment 2 option rarp ppciboot address assignment 3 option bootp ppciboot address assignment 4 option user ppciboot address assignment 3 option none

451-0310E

197

ppciboot ethernet network link Specifies the speed and duplex mode of the ppciboot Ethernet network link. Syntax ppciboot ethernet network link auto|10half|100half|10full|100full Where

Means

auto

The ppciboot Ethernet network link will auto-negotiate its port speed and duplex mode. This is the default setting.

10half

Sets a speed of 10 Megabytes per second, and a duplex mode of half duplex, for the Ethernet network link.

100half

Sets a speed of 100 Megabytes per second, and a duplex mode of half duplex, for the Ethernet network link.

10full

Sets a speed of 10 Megabytes per second, and a duplex mode of full duplex, for the Ethernet network link.

100full

Sets a speed of 100 Megabytes per second, and a duplex mode of full duplex, for the Ethernet network link.

Examples ppciboot ethernet network link auto ppciboot ethernet network link 10half ppciboot ethernet network link 100half ppciboot ethernet network link 10full ppciboot ethernet network link 100full

198

451-0310E

ppciboot gateway Specifies the ppciboot gateway. This gateway is used when any of the ppciboot assignment options is selected as “User Defined”. Refer to “ppciboot address assignment option” on page 197 for more information on ppciboot assignment options. Syntax ppciboot gateway Where

Means

ip_address

The IP address of the ppciboot gateway.

Example ppciboot gateway 119.20.110.7

451-0310E

199

ppciboot image filename Specifies the filename of the LX software image. Syntax ppciboot image filename Where

Means

filename

The filename of the LX software image.

Example ppciboot image filename new_linuxito.img

200

451-0310E

ppciboot image load from Specifies the source from which the LX software image will be loaded. NOTE: The ppciboot image file is specified using the ppciboot image filename command (see page 200). Syntax ppciboot image load from flash|network Where

Means

flash

Load the LX software image from the local flash.

network

Load the LX software image from the network TFTP server. (The TFTP server for loading the LX software image is defined using the ppciboot tftp command (see page 203).)

Examples ppciboot image load from flash ppciboot image load from network

451-0310E

201

ppciboot mask Specifies the ppciboot subnet mask for the LX unit. This is used as the subnet mask for the LX unit when any of the ppciboot assignment options is selected as “User Defined”. Refer to “ppciboot address assignment option” on page 197 for more information on ppciboot assignment options. Syntax ppciboot mask Where

Means

subnet_mask

The IP address that will be used as the ppciboot subnet mask.

Example ppciboot mask 255.255.255.0

202

451-0310E

ppciboot tftp server Specifies the TFTP server for the LX unit. This TFTP server is used when any of the ppciboot assignment options is selected as “User Defined”. Refer to “ppciboot address assignment option” on page 197 for more information on ppciboot assignment options. Syntax ppciboot tftp server Where

Means

ip_address

The IP address of the TFTP server from which the LX software image will be loaded.

Example ppciboot tftp server 118.23.109.18

451-0310E

203

primary dns Specifies the Primary Domain Name Server (DNS) for the LX unit. Syntax primary dns A.B.C.D Where

Means

A.B.C.D

The Primary DNS for the LX unit.

Example primary dns 119.20.112.3

204

451-0310E

radius period Specifies the interval at which the LX unit will update the RADIUS accounting server with the status of each RADIUS user. Syntax radius period NUMBER Where

Means

NUMBER

The interval, in minutes, at which the LX unit will update the RADIUS accounting server with the status of each RADIUS user. The default value is 5. The allowable values are 0 - 255.

Example radius period 10

451-0310E

205

radius primary accounting server address Specifies the IP Address of the RADIUS primary accounting server for the LX unit. Syntax radius primary accounting server address A.B.C.D Where

Means

A.B.C.D

The IP Address of the RADIUS primary accounting server for the LX unit.

Example radius primary accounting server address 152.34.65.33

206

451-0310E

radius primary accounting server port Specifies the RADIUS primary accounting server UDP port for the LX unit. (This is the UDP port to which the LX unit performs RADIUS accounting.) Syntax radius primary accounting server port NUMBER Where

Means

NUMBER

The UDP port, on the RADIUS primary accounting server, to which the LX unit performs RADIUS accounting. The allowable values are 0 - 65535. Note: If you do not specify a RADIUS primary accounting port with this command, the LX unit will use the default RADIUS primary accounting port of 1813.

Example radius primary accounting server port 1646

451-0310E

207

radius primary accounting server retransmit Specifies the maximum number of retries that the LX unit will have for transmitting an Accounting Request to the RADIUS primary accounting server when the LX unit receives no Accounting Response from the RADIUS primary accounting server. Syntax radius primary accounting server retransmit NUMBER Where

Means

NUMBER

The maximum number of times that the LX unit will attempt to contact the RADIUS primary accounting server. The allowable values are 0 - 255. The default value is 3.

Example radius primary accounting server retransmit 3

208

451-0310E

radius primary accounting server secret Specifies the RADIUS secret shared between the LX unit and the RADIUS primary accounting server used for encrypting communications between them. Syntax radius primary accounting server secret WORD Where

Means

WORD

A text string of up to 16 characters. The string is case sensitive.

Example radius primary accounting server secret AaBbCc

451-0310E

209

radius primary accounting server timeout Specifies the length of time that the LX unit will wait for the RADIUS primary accounting server to respond before retransmitting packets to the RADIUS primary accounting server. Syntax radius primary accounting server timeout NUMBER Where

Means

NUMBER

The length of time, in seconds, that the LX unit will wait for a RADIUS primary accounting server to respond before retransmitting Accounting Requests to the RADIUS primary accounting server. The default value is 5. The allowable values are 1 - 255.

Example radius primary accounting server timeout 3

210

451-0310E

radius primary authentication server address Specifies the RADIUS primary authentication server address for the LX unit. Syntax radius primary authentication server address A.B.C.D Where

Means

A.B.C.D

The IP Address of the RADIUS primary authentication server for the LX unit.

Example radius primary authentication server address 152.34.65.37

451-0310E

211

radius primary authentication server port Specifies UDP port for the RADIUS primary authentication server. Syntax radius primary authentication server port NUMBER Where

Means

NUMBER

The RADIUS primary authentication server UDP port for the LX unit. This value must match the primary accounting UDP port that is being used on the RADIUS primary authentication server. The allowable values are 0 - 65535. Note: If you do not specify a RADIUS primary authentication port with this command, the LX unit will use the default RADIUS primary authentication port of 1812.

Example radius primary authentication server port 1645

212

451-0310E

radius primary authentication server retransmit Specifies the maximum number of retries that the LX unit will have for transmitting an Access Request to the RADIUS primary authentication server when the LX unit receives no Access Accept or Reject messages from the RADIUS primary authentication server. Syntax radius primary authentication server retransmit NUMBER Where

Means

NUMBER

The maximum number of times that the LX unit will attempt to contact the RADIUS primary authentication server. The allowable values are 0 - 255. The default value is 3.

Example radius primary authentication server retransmit 3

451-0310E

213

radius primary authentication server secret Specifies the RADIUS secret shared between the LX unit and the RADIUS primary authentication server used for encrypting communications between them. Syntax radius primary authentication server secret WORD Where

Means

WORD

A text string of up to 16 characters. The string is case sensitive.

Example radius primary authentication server secret AaBbCc

214

451-0310E

radius primary authentication server timeout Specifies the length of time that the LX unit will wait for the RADIUS primary authentication server to respond before retransmitting packets to the RADIUS primary authentication server. Syntax radius primary authentication server timeout NUMBER Where

Means

NUMBER

The length of time, in seconds, that the LX unit will wait for a RADIUS primary authentication server to respond before retransmitting Access-Request messages to the RADIUS primary authentication server. The default value is 5. The allowable values are 1 - 255.

Example radius primary authentication server timeout 3

451-0310E

215

radius secondary accounting server address Specifies the IP Address of the RADIUS secondary accounting server for the LX unit. Syntax radius secondary accounting server address A.B.C.D Where

Means

A.B.C.D

The IP Address of the RADIUS secondary accounting server for the LX unit.

Example radius secondary accounting server address 152.34.65.33

216

451-0310E

radius secondary accounting server port Specifies the RADIUS secondary accounting server UDP port for the LX unit. (This is the UDP port to which the LX unit performs RADIUS accounting.) Syntax radius secondary accounting server port NUMBER Where

Means

NUMBER

The UDP port, on the RADIUS secondary accounting server, to which the LX unit performs RADIUS accounting. The allowable values are 0 - 65535. Note: If you do not specify a RADIUS secondary accounting port with this command, the LX unit will use the default RADIUS secondary accounting port of 1813.

Example radius secondary accounting server port 1813

451-0310E

217

radius secondary accounting server retransmit Specifies the maximum number of retries that the LX unit will have for transmitting an Accounting Request to the RADIUS secondary accounting server when the LX unit receives no Accounting Response from the RADIUS secondary accounting server. Syntax radius secondary accounting server retransmit NUMBER Where

Means

NUMBER

The maximum number of times that the LX unit will attempt to contact the RADIUS secondary accounting server. The allowable values are 0 - 255. The default value is 3.

Example radius secondary accounting server retransmit 3

218

451-0310E

radius secondary accounting server secret Specifies the RADIUS secret shared between the LX unit and the RADIUS secondary accounting server used for encrypting communications between them. Syntax radius secondary accounting server secret WORD Where

Means

WORD

A text string of up to 16 characters. The string is case sensitive.

Example radius secondary accounting server secret AaBbCc

451-0310E

219

radius secondary accounting server timeout Specifies the length of time that the LX unit will wait for the RADIUS secondary accounting server to respond before retransmitting packets to the RADIUS secondary accounting server. Syntax radius secondary accounting server timeout NUMBER Where

Means

NUMBER

The length of time, in seconds, that the LX unit will wait for a RADIUS secondary accounting server to respond before retransmitting Accounting Requests to the RADIUS secondary accounting server. The default value is 5. The allowable values are 1 - 255.

Example radius secondary accounting server timeout 3

220

451-0310E

radius secondary authentication server address Specifies the RADIUS secondary authentication server address for the LX unit. Syntax radius secondary authentication server address A.B.C.D Where

Means

A.B.C.D

The IP Address of the RADIUS secondary authentication server for the LX unit.

Example radius secondary authentication server address 152.34.65.37

451-0310E

221

radius secondary authentication server port Specifies the UDP port for the RADIUS secondary authentication server. Syntax radius secondary authentication server port NUMBER Where

Means

NUMBER

The RADIUS secondary authentication server UDP port for the LX unit. This value must match the secondary accounting UDP port that is being used on the RADIUS secondary authentication server. The allowable values are 0 - 65535. Note: If you do not specify a RADIUS secondary authentication port with this command, the LX unit will use the default RADIUS secondary authentication port of 1812.

Example radius secondary authentication server port 1812

222

451-0310E

radius secondary authentication server retransmit Specifies the maximum number of retries that the LX unit will have for transmitting an Access Request to the RADIUS secondary authentication server when the LX unit does not receive Access Accept or Reject messages from the RADIUS secondary authentication server. Syntax radius secondary authentication server retransmit NUMBER Where

Means

NUMBER

The maximum number of times that the LX unit will attempt to contact the RADIUS secondary authentication server. The allowable values are 0 - 255. The default value is 3.

Example radius secondary authentication server retransmit 3

451-0310E

223

radius secondary authentication server secret Specifies the RADIUS secret shared between the LX unit and the RADIUS secondary authentication server used for encrypting communications between them. Syntax radius secondary authentication server secret WORD Where

Means

WORD

A text string of up to 16 characters. The string is case sensitive.

Example radius secondary authentication server secret AaBbCc

224

451-0310E

radius secondary authentication server timeout Specifies the length of time that the LX unit will wait for the RADIUS secondary authentication server to respond before retransmitting packets to the RADIUS secondary authentication server. Syntax radius secondary authentication server timeout NUMBER Where

Means

NUMBER

The length of time, in seconds, that the LX unit will wait for a RADIUS secondary authentication server to respond before retransmitting Access-Request messages to the RADIUS secondary authentication server. The default value is 5. The allowable values are 1 - 255.

Example radius secondary authentication server timeout 3

451-0310E

225

route address Creates a static route for the LX unit. Syntax route address Where

Means

route_number

Specifies a route number for the static route.

destination_ip

Specifies the destination IP Address of the route.

Usage Guidelines To delete a route, use the no route command. For example, the command no route 3 deletes Route 3. Example route 3 address 119.20.112.39

226

451-0310E

route gateway Creates a gateway that a static route will use to reach its destination. Syntax route gateway Where

Means

route_number

Specifies the route number of a static route.

gateway_ip

Specifies the IP Address of the gateway by which the destination will be reached.

Example route 3 gateway 119.20.112.47

451-0310E

227

route mask Creates a subnet mask for a static route. Syntax route mask Where

Means

route_number

Specifies the route number of a static route.

subnet_mask

Specifies the subnet mask that will be used by the static route.

Example route 3 mask 255.255.255.0

228

451-0310E

secondary dns Specifies the Secondary Domain Name Server (DNS) for the LX unit. Syntax secondary dns A.B.C.D Where

Means

A.B.C.D

The Secondary DNS for the LX unit.

Example secondary dns 119.20.112.3

451-0310E

229

securid authentication encryption Specifies the encryption method for SecurID authentication on the LX unit. Syntax securid authentication encryption des|sdi Where

Means

des

Specifies DES as the SecurID encryption method.

sdi

Specifies SDI as the SecurID encryption method.

Example securid authentication encryption des securid authentication encryption sdi

230

451-0310E

securid authentication port Specifies the LX UDP port that the that the LX unit and the SecurID authentication server will use for communication. Syntax securid authentication port Where

Means

port_number

The port number of a UDP port on the LX unit. This can be any UDP port number that is not currently in use. The allowable values are 0 - 65535.

Example securid authentication port 5500

451-0310E

231

securid authentication retransmit Specifies the maximum number of retries that the LX unit will have for transmitting an Access Request to the SecurID authentication server when the LX unit receives no Access Accept or Reject messages from the SecurID primary authentication server. Syntax securid authentication retransmit NUMBER Where

Means

NUMBER

The maximum number of times that the LX unit will attempt to contact the SecurID authentication server. This can be any integer number from 0 through 255. The default value is 3.

Example securid authentication retransmit 7

232

451-0310E

securid authentication timeout Specifies the length of time that the LX unit will wait for the SecurID authentication server to respond before retransmitting packets to the SecurID authentication server. Syntax securid authentication timeout NUMBER Where

Means

NUMBER

The length of time, in seconds, that the LX unit will wait for the SecurID authentication server to respond before retransmitting Access-Request messages to the SecurID authentication server. This can be any integer number from 0 through 255. The default value is 3.

Example securid authentication timeout 3

451-0310E

233

securid authentication version Specifies the SecurID authentication version that will be used on the LX unit. Syntax securid authentication version legacy|version_5 Where

Means

legacy

The version of SecurID that will be used is older than Version 5.

version_5

Version 5 SecurID authentication will be used.

Example securid authentication version legacy securid authentication version version_5

234

451-0310E

securid master authentication server address Specifies the SecurID master authentication server address for the LX unit. NOTE: You can not specify a SecurID master authentication server for Version 5, or higher, or SecurID. Syntax securid master authentication server address A.B.C.D Where

Means

A.B.C.D

The IP Address of the SecurID master authentication server for the LX unit.

Example securid master authentication server address 192.16.65.38

451-0310E

235

securid master authentication server name Specifies the host name of the SecurID master authentication server for the LX unit. Syntax securid master authentication server name HOSTNAME Where

Means

HOSTNAME

The host name of the SecurID master authentication server for the LX unit.

Example securid master authentication server name bigsky22

236

451-0310E

securid primary authentication server address Specifies the SecurID primary authentication server address for the LX unit. Syntax securid primary authentication server address A.B.C.D Where

Means

A.B.C.D

The IP Address of the SecurID primary authentication server for the LX unit.

Example securid primary authentication server address 138.30.65.34

451-0310E

237

securid primary authentication server name Specifies the host name of the SecurID primary authentication server for the LX unit. Syntax securid primary authentication server name HOSTNAME Where

Means

HOSTNAME

The host name of the SecurID primary authentication server for the LX unit.

Example securid primary authentication server name bigsky1

238

451-0310E

securid slave authentication server address Specifies the SecurID slave authentication server address for the LX unit. NOTE: You can not specify a SecurID slave authentication server for Version 5, or higher, or SecurID. Syntax securid slave authentication server address A.B.C.D Where

Means

A.B.C.D

The IP Address of the SecurID slave authentication server for the LX unit.

Example securid slave authentication server address 192.16.23.115

451-0310E

239

securid slave authentication server name Specifies the host name of the SecurID slave authentication server for the LX unit. Syntax securid slave authentication server name HOSTNAME Where

Means

HOSTNAME

The host name of the SecurID slave authentication server for the LX unit.

Example securid slave authentication server name bigsky37

240

451-0310E

service Adds a host name and its address to a Service Table to provide the CLI user with a means for address resolution. Syntax service NAME A.B.C.D Where

Means

NAME

A text string that specifies the name of the IP device.

A.B.C.D

The address of the IP device.

Example service Finance_Server 119.20.112.3

451-0310E

241

snmp Enters the SNMP command mode. The SNMP command prompt (e.g., Snmp:0 >>) is displayed while you are in the SNMP command mode. For more information, refer to “SNMP Commands” on page 409. Syntax snmp Example snmp

242

451-0310E

snmp enable Enables the Simple Network Management Protocol (SNMP) for use in managing the LX unit. Syntax snmp enable Example snmp enable

451-0310E

243

ssh enable Enables the LX unit to function as an SSH server. This makes it possible for SSH clients to make connections to the LX unit. Syntax ssh enable Example ssh enable

244

451-0310E

ssh v1 Specifies that the LX unit will use Version 1 (V1) of SSH. Syntax ssh v1 Example ssh v1

451-0310E

245

ssh v2 Specifies that the LX unit will use Version 2 (V2) of SSH. Syntax ssh v2 Example ssh v2

246

451-0310E

subscriber Enters the Subscriber Command Mode. For more information on the Subscriber Command Mode, refer to “Subscriber Commands” on page 367. Syntax subscriber NAME Where

Means

NAME

The name of the subscriber that is to be configured. If the subscriber does not exist, a new subscriber record is created.

Usage Guidelines The maximum number of subscribers on an LX unit is equal to double the number of ports on the unit. For example, the maximum number of subscribers is 16 on an 8-port unit, 32 on a 16port unit, 64 on a 32-port unit, and 96 on a 48-port unit. Example subscriber mark

451-0310E

247

tacacs+ period Specifies the interval at which the LX unit will update the TACACS+ accounting server with the status of each TACACS+ user. Syntax tacacs+ period NUMBER Where

Means

NUMBER

The interval, in minutes, at which the LX unit will update the TACACS+ accounting server with the status of each TACACS+ user. The default value is 5. The allowable values are 0 - 255.

Example tacacs+ period 10

248

451-0310E

tacacs+ primary accounting server address Specifies the IP Address of the TACACS+ primary accounting server for the LX unit. Syntax tacacs+ primary accounting server address A.B.C.D Where

Means

A.B.C.D

The IP Address of the TACACS+ primary accounting server for the LX unit.

Example tacacs+ primary accounting server address 152.34.65.33

451-0310E

249

tacacs+ primary accounting server port Specifies the TACACS+ primary accounting server UDP port for the LX unit. (This is the UDP port to which the LX unit performs TACACS+ accounting.) Syntax tacacs+ primary accounting server port NUMBER Where

Means

NUMBER

The UDP port, on the TACACS+ primary accounting server, to which the LX unit performs TACACS+ accounting. The allowable values are 0 - 65535. Note: If you do not specify a TACACS+ primary accounting port with this command, the LX unit will use the default TACACS+ primary accounting port of 1813.

Example tacacs+ primary accounting server port 1646

250

451-0310E

tacacs+ primary accounting server retransmit Specifies the maximum number of retries that the LX unit will have for transmitting an Accounting Request to the TACACS+ primary accounting server when the LX unit does not receive an Accounting Response from the TACACS+ primary accounting server. Syntax tacacs+ primary accounting server retransmit NUMBER Where

Means

NUMBER

The maximum number of times that the LX unit will attempt to contact the TACACS+ primary accounting server. The allowable values are 0 - 255. The default value is 3.

Example tacacs+ primary accounting server retransmit 3

451-0310E

251

tacacs+ primary accounting server secret Specifies the TACACS+ secret shared between the LX unit and the TACACS+ primary accounting server used for encrypting communications between them. Syntax tacacs+ primary accounting server secret WORD Where

Means

WORD

A text string of up to 16 characters. The string is case sensitive.

Example tacacs+ primary accounting server secret AaBbCc

252

451-0310E

tacacs+ primary accounting server timeout Specifies the length of time that the LX unit will wait for the TACACS+ primary accounting server to respond before retransmitting packets to the TACACS+ primary accounting server. Syntax tacacs+ primary accounting server timeout NUMBER Where

Means

NUMBER

The length of time, in seconds, that the LX unit will wait for a TACACS+ primary accounting server to respond before retransmitting Accounting Requests to the TACACS+ primary accounting server. The default value is 5. The allowable values are 1 - 255.

Example tacacs+ primary accounting server timeout 3

451-0310E

253

tacacs+ primary authentication server address Specifies the TACACS+ primary authentication server address for the LX unit. Syntax tacacs+ primary authentication server address A.B.C.D Where

Means

A.B.C.D

The IP Address of the TACACS+ primary authentication server for the LX unit.

Example tacacs+ primary authentication server address 152.34.65.37

254

451-0310E

tacacs+ primary authentication server port Specifies UDP port for the TACACS+ primary authentication server. Syntax tacacs+ primary authentication server port NUMBER Where

Means

NUMBER

The TACACS+ primary authentication server UDP port for the LX unit. This value must match the primary accounting UDP port that is being used on the TACACS+ primary authentication server. The allowable values are 0 - 65535. Note: If you do not specify a TACACS+ primary authentication port with this command, the LX unit will use the default TACACS+ primary authentication port of 1812.

Example tacacs+ primary authentication server port 1645

451-0310E

255

tacacs+ primary authentication server retransmit Specifies the maximum number of retries that the LX unit will have for transmitting an Access Request to the TACACS+ primary authentication server when the LX unit does not receive an Access Accept or Reject messages from the TACACS+ primary authentication server. Syntax tacacs+ primary authentication server retransmit NUMBER Where

Means

NUMBER

The maximum number of times that the LX unit will attempt to contact the TACACS+ primary authentication server. The allowable values are 0 - 255. The default value is 3.

Example tacacs+ primary authentication server retransmit 3

256

451-0310E

tacacs+ primary authentication server secret Specifies the TACACS+ secret shared between the LX unit and the TACACS+ primary authentication server used for encrypting communications between them. Syntax tacacs+ primary authentication server secret WORD Where

Means

WORD

A text string of up to 16 characters. The string is case sensitive.

Example tacacs+ primary authentication server secret AaBbCc

451-0310E

257

tacacs+ primary authentication server timeout Specifies the length of time that the LX unit will wait for the TACACS+ primary authentication server to respond before retransmitting packets to the TACACS+ primary authentication server. Syntax tacacs+ primary authentication server timeout NUMBER Where

Means

NUMBER

The length of time, in seconds, that the LX unit will wait for a TACACS+ primary authentication server to respond before retransmitting Access-Request messages to the TACACS+ primary authentication server. The allowable values are 0 - 255. The default value is 5.

Example tacacs+ primary authentication server timeout 3

258

451-0310E

tacacs+ secondary accounting server address Specifies the IP Address of the TACACS+ secondary accounting server for the LX unit. Syntax tacacs+ secondary accounting server address A.B.C.D Where

Means

A.B.C.D

The IP Address of the TACACS+ secondary accounting server for the LX unit.

Example tacacs+ secondary accounting server address 152.34.65.33

451-0310E

259

tacacs+ secondary accounting server port Specifies the TACACS+ secondary accounting server UDP port for the LX unit. (This is the UDP port to which the LX unit performs TACACS+ accounting.) Syntax tacacs+ secondary accounting server port NUMBER Where

Means

NUMBER

The UDP port, on the TACACS+ secondary accounting server, to which the LX unit performs TACACS+ accounting. The allowable values are 0 - 65535. Note: If you do not specify a TACACS+ secondary accounting port with this command, the LX unit will use the default TACACS+ secondary accounting port of 1813.

Example tacacs+ secondary accounting server port 1646

260

451-0310E

tacacs+ secondary accounting server retransmit Specifies the maximum number of retries that the LX unit will have for transmitting an Accounting Request to the TACACS+ secondary accounting server when the LX unit does not receive an Accounting Response from the TACACS+ secondary accounting server. Syntax tacacs+ secondary accounting server retransmit NUMBER Where

Means

NUMBER

The maximum number of times that the LX unit will attempt to contact the TACACS+ secondary accounting server. The allowable values are 0 - 255. The default value is 3.

Example tacacs+ secondary accounting server retransmit 3

451-0310E

261

tacacs+ secondary accounting server secret Specifies the TACACS+ secret shared between the LX unit and the TACACS+ secondary accounting server used for encrypting communications between them. Syntax tacacs+ secondary accounting server secret WORD Where

Means

WORD

A text string of up to 16 characters. The string is case sensitive.

Example tacacs+ secondary accounting server secret AaBbCc

262

451-0310E

tacacs+ secondary accounting server timeout Specifies the length of time that the LX unit will wait for the TACACS+ secondary accounting server to respond before retransmitting packets to the TACACS+ secondary accounting server. Syntax tacacs+ secondary accounting server timeout NUMBER Where

Means

NUMBER

The length of time, in seconds, that the LX unit will wait for a TACACS+ secondary accounting server to respond before retransmitting Accounting Requests to the TACACS+ secondary accounting server. The allowable values are 0 - 255. The default value is 5.

Example tacacs+ secondary accounting server timeout 3

451-0310E

263

tacacs+ secondary authentication server address Specifies the TACACS+ secondary authentication server address for the LX unit. Syntax tacacs+ secondary authentication server address A.B.C.D Where

Means

A.B.C.D

The IP Address of the TACACS+ secondary authentication server for the LX unit.

Example tacacs+ secondary authentication server address 152.34.65.37

264

451-0310E

tacacs+ secondary authentication server port Specifies the UDP port for the TACACS+ secondary authentication server. Syntax tacacs+ secondary authentication server port NUMBER Where

Means

NUMBER

The TACACS+ secondary authentication server UDP port for the LX unit. This value must match the secondary accounting UDP port that is being used on the TACACS+ secondary authentication server. The allowable values are 0 - 65535. Note: If you do not specify a TACACS+ secondary authentication port with this command, the LX unit will use the default TACACS+ secondary authentication port of 1812.

Example tacacs+ secondary authentication server port 1645

451-0310E

265

tacacs+ secondary authentication server retransmit Specifies the maximum number of retries that the LX unit will have for transmitting an Access Request to the TACACS+ secondary authentication server when the LX unit does not receive an Access Accept or Reject message from the TACACS+ secondary authentication server. Syntax tacacs+ secondary authentication server retransmit NUMBER Where

Means

NUMBER

The maximum number of times that the LX unit will attempt to contact the TACACS+ secondary authentication server. The allowable values are 0 255. The default value is 3.

Example tacacs+ secondary authentication server retransmit 3

266

451-0310E

tacacs+ secondary authentication server secret Specifies the TACACS+ secret shared between the LX unit and the TACACS+ secondary authentication server used for encrypting communications between them. Syntax tacacs+ secondary authentication server secret WORD Where

Means

WORD

A text string of up to 16 characters. The string is case sensitive.

Example tacacs+ secondary authentication server secret AaBbCc

451-0310E

267

tacacs+ secondary authentication server timeout Specifies the length of time that the LX unit will wait for the TACACS+ secondary authentication server to respond before retransmitting packets to the TACACS+ secondary authentication server. Syntax tacacs+ secondary authentication server timeout NUMBER Where

Means

NUMBER

The length of time, in seconds, that the LX unit will wait for a TACACS+ secondary authentication server to respond before retransmitting Access-Request messages to the TACACS+ secondary authentication server. The allowable values are 0 - 255. The default value is 5.

Example tacacs+ secondary authentication server timeout 3

268

451-0310E

tacacs+ superuser password request enable Specifies that a Superuser password request will be sent to TACACS+. Syntax tacacs+ superuser password request enable Usage Guidelines When this setting is disabled, the local Superuser password (system) will be used to enter the Superuser Command Mode. Use the no tacacs+ superuser password request command to disable this setting. When this setting is enabled, the superuser password that resides on the TACACS+ authentication server will be used to enter the Superuser Command Mode. Example tacacs+ superuser password request enable

451-0310E

269

telnet enable Configures the LX unit to support inbound Telnet connections from remote clients. Syntax telnet enable Example telnet enable

270

451-0310E

tftp Specifies the timeout and retries for the TFTP server. Syntax tftp timeout |retry Where

Means

timeout

Set the TFTP server timeout value.

retry

Set the TFTP server retries value.

timeout_num

The TFTP server timeout value.

retries_num

The TFTP server retries value.

Examples tftp timeout 60 tftp retry 6

451-0310E

271

timed enable Configures the LX unit to use the Time Daemon (timed). Syntax timed enable Example timed enable

272

451-0310E

timezone Sets the timezone for the LX system clock. Syntax timezone GMT + |GMT - |UTC|US Where

Means

GMT +

Greenwich Mean Time, plus n hours. The value of n can be any integer from 1 to 12, inclusive. For example, the timezone for Paris is Greenwich Mean time, plus 1 hour (GMT+1). The default value of n is 0. GMT+0 is Greenwich Mean Time itself.

GMT -

Greenwich Mean Time, minus n hours. The value of n can be any integer from 1 to 12, inclusive. For example, the timezone for New York is Greenwich Mean time, minus 6 hours (GMT-6). The default value of n is 0. GMT-0 is Greenwich Mean Time itself.

UTC

Specifies that the LX unit will use Coordinated Universal Time.

US

Specifies that the LX unit will use the United States (US) timezone that is specified in the us_timezone field.

us_timezone

A US timezone. The allowable values are Alaska, Aleutian, Arizona, Central, Eastern, East-Indiana, Hawaii, Indiana-Starke, Michigan, Mountain, Pacific, and Samoa

Example timezone GMT + 3 timezone GMT - 7 timezone UTC timezone US Alaska timezone US East-Indiana timezone US Samoa timezone US Mountain

451-0310E

273

web_server enable Configures the LX unit to support Web Browser connections from remote clients. Syntax web_server enable Example web_server enable

274

451-0310E

Chapter 4 Interface Commands

The Interface commands are executed in the Interface command mode. When the LX unit is in the Interface command mode, the Interface command prompt (e.g., Intf 1-1:0 >>) is displayed on the terminal screen. The format of the Interface command prompt is as follows: Intf -: >> where

identifies the first IP interface in the range of interfaces under configuration. identifies the last IP interface in the range of interfaces under configuration. identifies the current session number.

For example, in the Interface command prompt Intf 1-1:0 >> the first IP interface is the IP interface under configuration, and the session number is 0. To enter the Interface command mode, execute the interface command in the Configuration command mode. The interface command is described on page 180.

451-0310E

275

address Specifies the IP Address and subnet mask for the IP interface. Syntax address [mask ] Where

Means

ip_address

The IP Address for the IP interface.

subnet_mask

The subnet mask for the IP interface.

Examples address 119.20.112.3 address 119.20.112.3 mask 255.0.0.0

276

451-0310E

authentication fallback enable Enables the Local Authentication feature on the IP interface under configuration. Syntax authentication fallback enable Usage Guidelines Fallback Login is a mechanism for logging in users when RADIUS authentication, or TACACS+ authentication, fails because the authentication server is unreachable. When you log in via Fallback, you are logged in to the IP interface as a nonprivileged user. The authentication challenge will be against the local subscriber database. When both RADIUS and TACACS+ are disabled on the IP interface, Fallback is also disabled. Example authentication fallback enable

451-0310E

277

authentication local enable Enables the Local Authentication feature on the IP interface under configuration. Syntax authentication local enable Example authentication local enable

278

451-0310E

authentication none Disables the Authentication feature on the IP interface under configuration. Syntax authentication none Example authentication none

451-0310E

279

authentication radius enable Enables the RADIUS authentication feature on the IP interface under configuration. Syntax authentication radius enable Example authentication radius enable

280

451-0310E

authentication securid enable Enables the SecurID authentication feature on the IP interface under configuration. Syntax authentication securid enable Example authentication securid enable

451-0310E

281

authentication tacacs+ enable Enables the TACACS+ authentication feature on the IP interface under configuration. Syntax authentication tacacs+ enable Example authentication tacacs+ enable

282

451-0310E

broadcast Sets the Broadcast Address for the IP interface. Syntax broadcast A.B.C.D Where

Means

A.B.C.D

The Broadcast Address for the IP interface.

Example broadcast 119.255.255.255

451-0310E

283

default mtu Resets the Maximum Transmission Unit (MTU) size for the IP interface to the factory default (1500). Frames that are larger than the designated MTU size are fragmented before transmission. (Note that the software fragments frames on the transmit side only.) Syntax default mtu Example default mtu

284

451-0310E

default rotary Resets any of three rotary parameters to their default values. Syntax default rotary [ssh port|tcp port|type] Where

Means

ssh port

Resets the SSH UDP port for the rotary to its default value. The default SSH UDP port for a rotary is 1522.

tcp port

Resets the TCP UDP port for the rotary to its default value. The default SSH TCP port for a rotary is 1500.

type

Resets the rotary type to the default value of First Available.

Usage Guidelines The modifiers (i.e., ssh port, tcp port, and type) are optional in this command. If this command is executed without a modifier (i.e., default rotary), it will reset the three rotary parameters (SSH port, TCP port, and type) to their default values. Example default rotary ssh port default rotary tcp port default rotary type default rotary

451-0310E

285

default ssh keepalive Resets the SSH Keepalive Count, or the SSH Keepalive Interval, to its default value. Syntax default ssh keepalive count|interval Where

Means

count

Reset the SSH Keepalive Count to its default value.

interval

Reset the SSH Keepalive Interval to its default value.

Example default ssh keepalive count default ssh keepalive interval

286

451-0310E

default ssh port Resets the SSH UDP port for the IP interface to its default value of 22. Syntax default ssh port Example default ssh port

451-0310E

287

default telnet port Resets the Telnet UDP port for the IP interface to its default value of 23. Syntax default telnet port Example default telnet port

288

451-0310E

end When the end command is issued in Interface command mode, it returns the user to the Superuser command mode. Syntax end Usage Guidelines The end command can be issued in all of the LX command codes except for User and Superuser. Executing the end command always returns the user to the Superuser command mode. Example end

451-0310E

289

exit Returns the user to the previous command mode. For example, if the current command mode is Interface, issuing this command will return the user to the Configuration command mode. Syntax exit Usage Guidelines The exit command can be issued in all of the LX Command Modes. However, the effect of the exit command varies, depending on the mode from which it is issued. As noted above, issuing the exit command in the Interface command mode returns the user to the previous command mode. The same goes for issuing the exit command in any command mode other than the User command mode. For example, issuing the exit command in the Menu command mode returns the user to the Configuration command mode; issuing the exit command in the Configuration command mode returns the user to the Superuser command mode, and so on. Issuing the exit command in the User command mode exits the LX CLI and closes the connection to the LX unit. Example exit

290

451-0310E

mask Sets the subnet mask for the IP interface. Syntax mask Where

Means

subnet_mask

The subnet mask for the IP interface.

Example mask 255.0.0.0

451-0310E

291

mtu Sets the Maximum Transmission Unit (MTU) size for an interface. Frames that are larger than the designated MTU size are fragmented before transmission. (Note that the software fragments frames on the transmit side only.) Syntax mtu NUMBER Where

Means

NUMBER

The MTU size for the interface. This can be any numerical value between 1000 and 1500. (It is recommended that you use a value of 1500 for Ethernet connections.) The default MTU size is 1500.

Examples mtu 1000 mtu 1200 mtu 1500

292

451-0310E

no Disables (negates) specific features and boolean parameters on the LX unit. Refer to “Usage Guidelines” (below) for more information about using the no command in the Interface command mode. Syntax no Where

Means

feature_name

The name of the feature or boolean parameter that is to be disabled.

Usage Guidelines The allowable arguments for this command consist of only those features and boolean parameters that can be set in the Interface command mode and are currently enabled. To view the features and boolean parameters that are currently enabled, type the no command followed by a question mark (?). Example no ssh keepalive interval

451-0310E

293

radius accounting enable Enables the RADIUS accounting feature on the IP interface under configuration. Syntax radius accounting enable Example radius accounting enable

294

451-0310E

rotary enable Enables you to create rotaries on the IP interface. The term "rotary" refers to the ability to assign the same Internet address or domain name to multiple ports that offer the same type of service. Syntax rotary enable Usage Guidelines In order for this command to take effect, the Telnet protocol must be enabled. Example rotary enable

451-0310E

295

rotary port Assigns ports on the LX unit to a rotary. The term "rotary" refers to the ability to assign the same Internet address or domain name to multiple ports that offer the same type of service. Syntax rotary port NUMBER|PORT LIST|all Where

Means

NUMBER

The port number of an LX port that is to be assigned to the rotary.

PORT LIST

A list of ports on the LX unit that are to be assigned to the rotary. The port numbers must be separated by blank spaces (e.g., 2 3 5 8).

all

Assigns all ports on the LX unit to the rotary.

Usage Guidelines When this command is used to assign ports to a rotary, the IP Address of the IP interface serves as the IP Address of the rotary. To create a rotary, do the following: 1. Create an IP interface (see the “interface” command on page 180). 2. Assign ports to the rotary using the “rotary port” command. 3. Configure the IP Address for the IP interface (see the “address” command on page 276). 4. Configure the Rotary SSH port for the IP interface (see the “rotary ssh port” command on page 297). 5. Configure the Rotary TCP port for the IP interface (see the “rotary tcp port” command on page 298). For example, you could create a rotary on interface 1 with a TCP port of 3500 and an SSH port of 3522. Then you could assign ports 2, 3, and 4 to it. You could connect (assuming all ports have dynamic or remote access) to ports 2, 3, or 4 via TCP port 3500 for telnet, and 3522 for SSH. You could connect to port 2 via TCP port 2200 for telnet or 2222 for SSH, or port 5 via TCP port 2500 for telnet or 2522 for SSH. A telnet connection to the IP address of the LX on TCP port 23 would get you to a virtual port, and an SSH connection to port 22 would also get you to a virtual port via SSH. NOTE: You cannot add the DIAG port (port 0) to a rotary. Examples rotary port 4 rotary port 2 3 5 8 rotary port all

296

451-0310E

rotary ssh port Assigns an SSH socket number to the rotary that was created with the rotary port command. (The rotary port command is described on page 296.) Syntax rotary ssh port NUMBER Where

Means

NUMBER

The SSH socket number that will be used to make SSH connections to the rotary that was created with the rotary port command. SSH will attempt to connect to the ports in the rotary on a First Available basis. The default SSH socket number is 1522.

Examples rotary ssh port 988

451-0310E

297

rotary tcp port Assigns a TCP socket number to the rotary that was created with the rotary port command. (The rotary port command is described on page 296.) Syntax rotary tcp port NUMBER Where

Means

NUMBER

The TCP socket number that will be used to make TCP connections to the rotary that was created with the rotary port command. The default TCP socket number is 1500.

Examples rotary tcp port 1497

298

451-0310E

rotary type Specifies the rotary type according to the port search method (Round Robin or First Available). Syntax rotary type round robin|first available Where

Means

round robin

The LX unit will search the rotary for an available port, starting with the lowest-numbered port in the rotary. Unlike “First Available”, Round Robin will always go the next available port. For example, if all ports on the rotary are available and a connection to port 3 goes away, the next connection is to port 4.

first available

An incoming call is connected to the First Available (non-busy) port in the rotary. For example, if ports 1 - 5 are connected in a rotary of ports 1 - 7, and the connection to port 3 went away (so that port 3 was now available), the next connection would be to port 3.

Examples rotary type round robin rotary type first available

451-0310E

299

serial Assigns user-defined Telnet, or SSH, socket numbers to an LX serial port. This is typically done to prevent hackers from accessing LX serial ports via default SSH socket numbers, or default Telnet socket numbers. Syntax serial ssh|telnet Where

Means

serial_port

The port number of an LX serial port. The valid values are 1 through 8.

ssh

Set the SSH socket number for the LX serial port specified in serial_port.

telnet

Set the Telnet socket number for the LX serial port specified in serial_port.

ssh/telnet_port

Specifies the Telnet socket number, or the SSH socket number, for the LX port specified in serial_port. Note: The default SSH and Telnet port numbers are as follows: LX Serial Port 0 1 2 3 4 5 6 7 8

Default Telnet Port 0 2100 2200 2300 2400 2500 2600 2700 2800

Default SSH Port 0 2122 2222 2322 2422 2522 2622 2722 2822

Example serial 4 ssh 983 serial 6 telnet 1297

300

451-0310E

ssh keepalive count Specifies the SSH Keepalive Count for the IP interface. The SSH Keepalive Count is the number of times that an SSH client will attempt to make an SSH connection to the IP interface. Syntax ssh keepalive count NUMBER Where

Means

NUMBER

The SSH Keepalive Count for the IP interface. This can be any integer value.

Example ssh keepalive count 8

451-0310E

301

ssh keepalive interval Specifies the SSH Keepalive Interval for the IP interface. The SSH Keepalive Interval is the length of time, in seconds, between attempts at making an SSH connection to the IP interface. Syntax ssh keepalive interval NUMBER Where

Means

NUMBER

The SSH Keepalive Interval for the IP interface. This can be any integer value.

Example ssh keepalive interval 30

302

451-0310E

ssh port Specifies the Virtual Port socket number for making an SSH connection to the IP interface. Syntax ssh port NUMBER Where

Means

NUMBER

The SSH Virtual Port socket number for the IP interface. The default value is 22.

Example ssh port 988

451-0310E

303

tacacs+ accounting enable Enables the TACACS+ accounting feature on the IP interface under configuration. Syntax tacacs+ accounting enable Example tacacs+ accounting enable

304

451-0310E

telnet port Specifies the Virtual Port socket number for making a Telnet connection to the IP interface. Syntax telnet port NUMBER Where

Means

NUMBER

The Telnet Virtual Port socket number for the IP interface. The default value is 23.

Example telnet port 1743

451-0310E

305

Chapter 5 Asynchronous Commands

The Asynchronous port commands are executed in the Asynchronous command mode. When the LX unit is in the Asynchronous command mode, the Asynchronous command prompt (e.g., Async 4-4:0 >>) is displayed on the terminal screen. The format of the Asynchronous command prompt is as follows: Async -: >> where

identifies the first port in the range of ports under configuration. identifies the last port in the range of ports under configuration. identifies the current session number.

To enter the Asynchronous command mode, execute the port async command in the Configuration command mode. The port async command is described on page 194.

451-0310E

307

access Specifies any access method, other than power management, for the asynchronous port(s) under configuration. (Refer to “access power model” on page 309 for information on specifying port(s) for power management.) The default access method is LOCAL on modem ports and on port 0. On all other non-modem ports, the default access method is REMOTE. Syntax access local|dynamic|remote|sensor|databuffer Where

Means

local

Specifies that the port(s) under configuration will use the LOCAL access method. The LOCAL access method is used to support inbound connections (i.e., when the user logs in to the port via a terminal or via a dialin connection).

dynamic

Specifies that the port(s) under configuration will use the DYNAMIC access method. Note: You cannot specify DYNAMIC as the access method for port 0.

remote

Specifies that the port(s) under configuration will use the REMOTE access method. The REMOTE access method is used to support outbound connections (i.e., connections from the LAN). Note: You cannot specify REMOTE as the access method for port 0.

sensor

Specifies that the port(s) under configuration will be used as a Temperature/ Humidity Sensor port(s). Refer to Getting Started with the LX Series for information on connecting a Temperature/Humidity Sensor to an LX port. Refer to “show device status” on page 92 to display the temperature and humidity recorded on a Temperature/Humidity Sensor attached to a SENSOR port. Note: You cannot configure port 0 as a SENSOR port.

databuffer

Specifies that the port(s) under configuration will be used for data buffering. Note: You cannot configure port 0 as a DATABUFFER port.

Usage Guidelines PPP can not be enabled on a port that has autobaud enabled. Examples access local access dynamic access remote

308

451-0310E

access power model Specifies that the asynchronous port(s) under configuration will be used as Power Master(s) for an IR-5100 or IR-5150. Syntax access power model ir5100|ir5150 Where

Means

ir5100

Specifies that the asynchronous port(s) under configuration will be Power Master(s) for an IR-5100.

ir5150

Specifies that the asynchronous port(s) under configuration will be Power Master(s) for an IR-5150.

Usage Guidelines Refer to the applicable Getting Started Guide for information on connecting an IR-5100 or an IR-5150 unit to an LX asynchronous port. NOTE: You cannot configure port 0 as a Power Master port. Examples access power model ir5100 access power model ir5150

451-0310E

309

apd enable Enables Automatic Protocol Detection (APD) on the port(s) under configuration. When APD is enabled, the port will automatically determine the protocol being used to make a connection and adjust port settings appropriately. On all ports except modem ports, APD is disabled by default. Syntax apd enable Usage Guidelines To use APD, the LX port must be configured with PORT ACCESS set to LOCAL or DYNAMIC. Refer to “access” on page 308 for information on setting PORT ACCESS to LOCAL or DYNAMIC. If you do not enable APD, ports can be dedicated for use by a single access serving protocol. An individual port can be configured to accept any connections made via PPP, SLIP (which includes CSLIP), and interactive protocols, as well as both, or neither of these. You cannot enable APD on port 0. If you execute the apd enable command on port 0, the following message will be displayed: Operation not permitted on diagnostic/management port Example apd enable

310

451-0310E

apd retry Specifies the number of times an APD-enabled port will attempt to determine the protocol of an incoming connection. NOTE: You cannot execute this command on port 0. Syntax apd retry NUMBER Where

Means

NUMBER

The number of times that the port will attempt to determine the protocol of an incoming connection. The allowable values are 0 - 255.

Example apd retry 6

451-0310E

311

apd signature Specifies the APD signature for the port(s) under configuration. NOTE: You cannot execute this command on port 0. Syntax apd signature WORD Where

Means

WORD

A text string.

Example apd signature FinancePort

312

451-0310E

apd timeout Specifies the APD timeout for the port(s) under configuration. The APD timeout is the length of time an APD port can spend attempting to determine which protocol is being used to make a connection. NOTE: You cannot execute this command on port 0. Syntax apd timeout NUMBER Where

Means

NUMBER

Specifies how much time the port can spend in an attempt to determine which protocol is being used to make a connection. Valid timeout values are from 1 to 255 seconds.

Example apd timeout 30

451-0310E

313

authentication enable Enables an authentication method (Local, RADIUS, SecurID, or TACACS+) as the inbound, or outbound, authentication method for the asynchronous port(s) under configuration. Syntax authentication inbound|outbound local|radius|securid|tacacs+ enable Where

Means

inbound

The specified authentication method (Local, RADIUS, SecurID, or TACACS+) will be enabled as the method of inbound authentication for the asynchronous port(s) under configuration. (Inbound authentication is used on ports that have an access method of LOCAL. For more information on LOCAL access, refer to “access” on page 308.)

outbound

The specified authentication method (Local, RADIUS, SecurID, or TACACS+) will be enabled as the method of outbound authentication for the asynchronous port(s) under configuration. (Outbound authentication is used on ports that have an access method of REMOTE. For more information on REMOTE access, refer to “access” on page 308.) Note: You cannot configure outbound authentication for the DIAG port (port 0).

local

Enables Local authentication for inbound (or outbound) connections on the asynchronous port(s) under configuration. Under local authentication, the subscriber’s username and password are checked against the subscriber database that resides on the LX.

radius

Enables RADIUS authentication for inbound (or outbound) connections on the asynchronous port(s) under configuration. Under RADIUS authentication, the authentication is validated by a network-based RADIUS server.

securid

Enables SecurID authentication for inbound (or outbound) connections on the asynchronous port(s) under configuration. Under SecurID authentication, the authentication is validated by a network-based SecurID server.

tacacs+

Enables TACACS+ authentication for inbound (or outbound) connections on the asynchronous port(s) under configuration. Under TACACS+ authentication, the authentication is validated by a network-based TACACS+ server.

Examples authentication inbound radius enable authentication outbound radius enable authentication inbound local enable authentication outbound local enable authentication inbound securid enable

314

451-0310E

authentication enable (continued) authentication outbound securid enable authentication inbound tacacs+ enable authentication outbound tacacs+ enable

451-0310E

315

authentication fallback enable Enables the Fallback Login feature on the asynchronous port(s) under configuration. Syntax authentication fallback enable Usage Guidelines Fallback Login is a mechanism for logging in users when RADIUS, SecurID, or TACACS+, fails because the authentication server is unreachable. When you log in via Fallback, you are logged in to the asynchronous port as a nonprivileged user. The authentication challenge will be against the local subscriber database. When RADIUS, SecurID, and TACACS+ are disabled on the asynchronous port, Fallback is effectively disabled on the port. Example authentication fallback enable

316

451-0310E

autobaud enable Specifies that the port(s) under configuration will determine the input port speed, parity, and character size for the device connected to the port, and automatically set the matching LX port settings. Autobaud is disabled by default, except on the last physical port. Syntax autobaud enable Usage Guidelines The LX unit uses the ASCII RETURN character to determine the port speed, parity, and character size. Normally, the user must press the RETURN key a few times until the LX unit determines the port speed, parity, and character size, and begins a logon sequence. When APD is enabled, the port will automatically determine the protocol being used to make a connection and adjust port settings appropriately. You can only enable AUTOBAUD where the attached device is configured with the following settings at a port set to LOCAL ACCESS and: •

CHARACTER SIZE 8, (7 if EVEN parity)

•

PARITY NONE (EVEN if character size is set to 7)

•

SPEED is set to 1200, 2400, 4800, 9600, 19200, or 38400.

PPP can not be enabled on a port that uses Remote for an access method. Example autobaud enable

451-0310E

317

autobaud retry Specifies the number of times an autobaud-enabled port will attempt to determine the input port speed, parity, and character size for the device connected to the port. Syntax autobaud retry NUMBER Where

Means

NUMBER

The number of times that the port will attempt to determine the input port speed, parity, and character size for the device connected to the port.

Usage Guidelines You cannot enable the Autobaud feature on port 0. If you execute the autobaud enable command on port 0, the following message will be displayed: Operation not permitted on diagnostic/management port Example autobaud retry 6

318

451-0310E

autodial enable Specifies that the port(s) under configuration will be automatically dialed. Syntax autodial enable Usage Guidelines You cannot enable the Autodial feature on port 0. If you execute the autodial enable command on port 0, the following message will be displayed: Operation not permitted on diagnostic/management port Example autodial enable

451-0310E

319

autohangup enable Specifies that the port(s) under configuration will automatically log out when the last connection closes. NOTE: The port will also be logged out when the attached equipment drops its signaling. NOTE: Autohangup cannot be enabled on port 0. Syntax autohangup enable Example autohangup enable

320

451-0310E

banner Specifies the banner that is displayed when the user logs in to the port. Syntax banner STRING Where

Means

STRING

A text string.

Example banner Welcome to Finance

451-0310E

321

bits Specifies the number of data bits per character for the port(s) under configuration. Syntax bits NUMBER Where

Means

NUMBER

The number of data bits per character for the port(s) under configuration. The allowable values are 5, 6, 7, or 8.

Example bits 6

322

451-0310E

break enable Specifies that the port(s) under configuration will send a break signal to the serial line when a break or a Telnet break signal is received, via Telnet or SSH, from a remote host. Syntax break enable Example break enable

451-0310E

323

break special Defines a unique break sequence for the port(s) under configuration. When a unique break sequence is defined, it is sent in an out-of-band mode in place of the standard break sequence when the user presses the Break key. Syntax break special Where

Means

break_sequence

Specifies the break sequence. This can be any combination of up to six characters.

Example break special 1234

324

451-0310E

connect command Specifies the connect command(s) for the asynchronous port(s) under configuration. The connect command(s) are executed when a connection to the port is made, or when the port detects assertion of DSR. This feature is also known as the “Dedicated Async Port Service”. Syntax connect command Where

Means

command_sequence

Specifies the connect command(s) for the port. The connect command(s) can be any of the Built-in Linux shell commands. If you specify more than one command, you must separate the commands with semi-colons (;). You can also specify an executable file or a batch file in this field.

Examples connect command telnet 10.1.2.3 connect command mew_startup.exe connect command ssh 10.1.2.3 -p 2022

451-0310E

325

databuffer display Specifies the display option for a databuffer port. Syntax databuffer display enable|prompt Where

Means

enable

The contents of the data buffer will be displayed for the user as soon as the user logs in to the port; the user will not be prompted for whether or not he wants to display the contents of the data buffer.

prompt

When the user logs in to the port, he will be prompted for whether or not he wants to display the contents of the data buffer. If the user enters a y response, the contents of the data buffer will be displayed at the user’s terminal. If the user enters an n response, the contents of the data buffer will not be displayed at the user’s terminal.

Usage Guidelines You can disable the databuffer display by executing the following command in the Asynchronous command mode: no databuffer display When you execute the no databuffer display command, the contents of the databuffer will not be displayed when you log in to the port. Example databuffer display enable databuffer display prompt

326

451-0310E

databuffer size Specifies the size, in bytes, of the data buffer on the port(s) under configuration. Syntax databuffer size NUMBER Where

Means

NUMBER

A whole number that specifies the size, in bytes, for the data buffer on the port(s) under configuration. This can be any number from 28 to 65535. The default databuffer size is 1024 bytes.

Example databuffer size 62000

451-0310E

327

databuffer syslog enable Specifies that the data received on the port(s) under configuration will be logged to the local syslogd. NOTE: This feature can only be enabled on asynchronous ports that are configured for data buffering. Refer to the access command on page 308 for information on configuring ports for data buffering. Syntax databuffer syslog enable Example databuffer syslog enable

328

451-0310E

databuffer timestamp enable Specifies that there will be a timestamp added to every entry of the data buffer for the port(s) under configuration. Syntax databuffer timestamp enable Example databuffer timestamp enable

451-0310E

329

default apd Resets the APD retries, APD signature, or APD timeout to the default value. Syntax default apd retry|signature|timeout Where

Means

retry

Resets the apd retry value of the port(s) under configuration to the factory default.

signature

Resets the apd signature of the port(s) under configuration to the factory default.

timeout

Resets the apd timeout value of the port(s) under configuration to the factory default.

Example default apd retry default apd signature default apd timeout

330

451-0310E

default databuffer size Resets the data buffer size on the port(s) under configuration to the factory-default value of 1024 bytes. Syntax default databuffer size Example default databuffer size

451-0310E

331

default port Resets all of the parameters of the port(s) under configuration to their factory-default values. Syntax default port Example default port

332

451-0310E

default power off time Resets the off time for the power outlets on the asynchronous port(s) to the default value of 10 seconds. Syntax default power off time Example default power off time

451-0310E

333

default speed Resets the speed of the port(s) under configuration to their factory-default values. The default port speed is 9600. Syntax default speed Example default speed

334

451-0310E

end When the end command is issued in the Asynchronous command mode, it returns the user to the Superuser command mode. Syntax end Usage Guidelines The end command can be issued in all of the LX command modes except for User and Superuser. Executing the end command always returns the user to the Superuser command mode. Example end

451-0310E

335

exit Returns the user to the previous command mode. For example, if the current command mode is the Asynchronous command mode, issuing this command will return the user to the Configuration command mode. Syntax exit Usage Guidelines The exit command can be issued in all of the LX Command Modes. However, the effect of the exit command varies, depending on the mode from which it is issued. As noted above, issuing the exit command in the Asynchronous command mode returns the user to the previous command mode. The same goes for issuing the exit command in any mode other than the User command mode. For example, issuing the exit command in the Menu Editing command mode returns the user to the Menu command mode; issuing the exit command in the Configuration command mode returns the user to the Superuser command mode, and so on. Issuing the exit command in the User command mode exits the LX CLI and closes the connection to the LX unit. Example exit

336

451-0310E

flowcontrol Specifies the type of flow control ("handshaking") that is used by the serial interface(s) of the port(s) under configuration. On all ports except modem ports, the default flow control is XON/XOFF; on modem ports, the default flow control is CTS. Syntax flowcontrol cts|xon Where

Means

cts

The LX unit will use CTS flow control for the specified port(s).

xon

The LX unit will use XON/XOFF flow control for the specified port(s).

Example flowcontrol cts flowcontrol xon

451-0310E

337

modem Enters the Modem command mode. For more information on the Modem command mode, refer to “Modem Commands” on page 437. Syntax modem Example modem

338

451-0310E

modem enable Specifies that the port(s) under configuration will have Modem Control enabled. Syntax modem enable Usage Guidelines You cannot enable Modem Control on port 0. If you execute the modem enable command on port 0, the following message will be displayed: Operation not permitted on diagnostic/management port Example modem enable

451-0310E

339

name Specifies a description of the port(s) under configuration. Syntax name STRING Where

Means

STRING

A text string that describes the port(s) under configuration. The text string can contain up to 60 characters.

Example name FieldOffice3

340

451-0310E

no Disables (negates) specific features and boolean parameters on the LX unit. Refer to “Usage Guidelines” (below) for more information about using the no command in the Asynchronous command mode. Syntax no Where

Means

feature_name

The name of the feature or boolean parameter that is to be disabled.

Usage Guidelines The allowable arguments for this command consist of only those features and boolean parameters that can be set in the Asynchronous command mode and are currently enabled. To view the features and boolean parameters that are currently enabled, type the no command followed by a question mark (?). Example no modem

451-0310E

341

outlet name Specifies a descriptive name for a Power Outlet that is connected to a Power Master port on the LX unit. Refer to “access power model” on page 309 for information on configuring an LX port as a Power Master. Syntax outlet name Where

Means

outlet_number

An integer number that specifies an outlet on the Power Control unit that is being managed via the asynchronous port under configuration. Note: This number consists of the Power Control Relay Number without the Power Master port number.

outlet_name

Specifies a descriptive name for the Power Control Relay. This can be a text string of up to 15 characters.

Example outlet 2 name Build5NTserver

342

451-0310E

parity Specifies whether or not the port(s) under configuration will provide a bit (parity bit) with each character for error checking. The value you set for this characteristic must match the value set at the device attached to the port. Syntax parity even|odd|none Where

Means

even

The port will ensure that each byte (character) that is transmitted or received contains an even number of 1's, including the parity bit. If the port receives a byte that contains an odd number of 1 bits, it indicates to the LX unit that an error occurred.

odd

The port will ensure that each byte (character) that is transmitted or received contains an odd number of 1's, including the parity bit. If the port receives a byte that contains an even number of 1 bits, it indicates to the LX unit that an error occurred.

none

A parity bit will not be provided. This is the default setting.

Examples parity even parity odd parity none

451-0310E

343

pattern match enable Specifies that the ports under configuration will use the Pattern Matching feature. Syntax pattern match enable Usage Guidelines The Pattern Matching feature can only be used on ports that are configured for databuffer access. Refer to the “access” command on page 308 to configure a port for databuffer access. You must create a match pattern before you can execute this command. To create a match pattern, refer to “pattern string” on page 345. Example pattern match enable

344

451-0310E

pattern string Specifies a match pattern for the databuffer port(s) under configuration. When data matching this pattern is received at the port, the data is put into a syslogd message. The syslogd message that contains the matching data can be forwarded to users of the Notification feature. Refer to “Usage Guidelines” (below) for more information. NOTE: Pattern matching must be disabled on the port(s) where this command is executed. To disable pattern matching, execute the no pattern match command in the Asynchronous command mode: Syntax pattern string Where

Means

pattern_number

A number that identifies the match pattern. This can be any integer number from 1 through 8.

match_pattern

A case-sensitive text string that is used as a match pattern for incoming data. This string can contain up to 15 characters, including wildcards. The allowable wildcards are the period (“.”) and the asterisk (“*”). The period represents a single character. For example, the pattern a.c.ef matches the strings abc3ef, azcxef, and a2cgef. The asterisk represents up to 16 iterations of the last character before the asterisk. For example, the pattern abc* matches the strings abccccccc and abccc. Note: The asterisk cannot be specified as the first character in a match pattern. Note: The string help is reserved and can not be specified in a match pattern.

Usage Guidelines When incoming data matching a specified pattern is received at the port, a syslogd message is generated at the facility LOG_USER, with the priority LOG_NOTICE: Pattern match found::Msg39 where

is the incoming data that matches the specified pattern.

For example, the following syslogd messages could be generated for incoming data that matched the pattern no *: Pattern match found:no broadcast group 4:Msg39 NOTE: The text Pattern match found is the default content of Message 39. This text can be changed. If it is changed, the text that precedes the colon (:) will be different from Pattern match found. Refer to “message string” on page 514 to change the text content of a configurable message.

451-0310E

345

pattern string (continued) The messages will be forwarded to Notification clients that have a facility of user and a priority of notice configured in their User Profiles. Refer to the LX-Series Configuration Guide for information on configuring User Profiles for the Notification feature. Examples pattern string 1 no * pattern string 2 number . pattern string 3 OK> pattern string 4 stuck* pattern string 5 1234B

346

451-0310E

power off time Specifies the length of time, in seconds, that outlets must remain off before they can be turned back on. Syntax power off time NUMBER Where

Means

NUMBER

An integer number that specifies the length of time, in seconds, that the outlets must remain off before they can be turned back on. After the outlets in the group have been turned off with the outlet command (see page 75), they must remain off for at least this length of time. The allowable values are 0 - 255. The default value is 10.

Example power off time 15

451-0310E

347

ppp Enters the PPP command mode. For more information on the PPP command mode, refer to “PPP Commands” on page 447. Syntax ppp Example ppp

348

451-0310E

ppp enable Specifies that the ports under configuration can be used for PPP links. Syntax ppp enable Usage Guidelines You cannot use port 0 for PPP links. If you execute the ppp enable command on port 0, the following message will be displayed: Operation not permitted on diagnostic/management port Example ppp enable

451-0310E

349

prompt Specifies the port prompt for remote connections. Syntax prompt Where

Means

prompt_string

The text string that will be used as the port prompt. The text string can contain up to 60 characters.

Example prompt Finance-Group

350

451-0310E

radius accounting enable Enables the RADIUS accounting feature on the port(s) under configuration. Syntax radius accounting enable Example radius accounting enable

451-0310E

351

signals syslog enable Specifies that a syslogd message will be sent when there is a state transition of the serial input signals CTS and DCD/DSR. Syntax signals syslog enable Example signals syslog enable

352

451-0310E

special break enable Specifies that the port(s) under configuration will send the special break string out the serial line of the port(s) when a break (or Telnet break string) is received, via Telnet or SSH, from a remote host. Refer to “special break string” on page 354 to specify the special break string. Syntax special break enable Example special break enable

451-0310E

353

special break string Specifies a unique break sequence that is sent out the serial line of the ports under configuration when a break is received, via Telnet or SSH, from a remote host. Syntax special break string Where

Means

break_sequence

Specifies the unique break sequence. This can be any string of up to six characters.

Example special break string gfeij

354

451-0310E

speed Specifies the speed of the port(s) under configuration. Syntax speed NUMBER Where

Means

NUMBER

The port speed, in bits per second, to which the port(s) under configuration will be set. The valid speeds are 134, 200, 300, 600, 1200, 2400, 4800, 9600, 19200, 38400, 57600, 115200 or 230400. The default port speed is 9600.

Example speed 57600

451-0310E

355

stopbits Specifies the number of stop bits to be used to maintain synchronization of data on the port(s) under configuration. Syntax stopbits NUMBER Where

Means

NUMBER

A whole number that maps to the number of stop bits to be used to maintain synchronization of data. The allowable values are 1 or 2.

Example stopbits 1 stopbits 2

356

451-0310E

tacacs+ accounting enable Enables the TACACS+ accounting feature on the port(s) under configuration. Syntax tacacs+ accounting enable Example tacacs+ accounting enable

451-0310E

357

telnet break string Specifies the Telnet break string for the ports under configuration. When it is received from a remote host in a Telnet or SSH session, the LX unit will send the enabled break feature (break signal or special break string) out the serial line. Refer to “break enable” on page 323 to enable the break signal. Refer to “special break enable” on page 353 to enable the special break string. Syntax telnet break string Where

Means

break_sequence

Specifies the Telnet break sequence. This can be any string of up to four characters.

Example telnet break string sfg

358

451-0310E

telnet negotiation enable Enables Telnet negotiation on the port(s) under configuration. When Telnet negotiation is enabled, the LX unit will begin negotiating Telnet parameters as soon as the session is started. NOTE: Telnet negotiation is enabled by default. This command is typically used to re-enable Telnet negotiation after it has been disabled. (To disable Telnet negotiation, execute the no telnet negotiation command in the Asynchronous Command Mode.) Syntax telnet negotiation enable Usage Guidelines Telnet Negotiation is used with transparency enabled when full transparency is needed within the telnet connection. Refer to the transparency enable command on page 360 to enable transparency. You can disable Telnet Negotiation on the LX to ensure operation with NT servers. Disabling Telnet negotiation on the LX effectively disables the negotiation of all telnet options in the TCP three-way handshaking process. Example telnet negotiation enable

451-0310E

359

transparency enable Sets the port(s) under configuration to transparent mode. Syntax transparency enable Usage Guidelines The use of transparent mode ensures that the LX can support applications that were designed for a point-to-point serial connection over an IP network. Examples of such applications include (but are not limited to) legacy serial applications and the downloading of an operating system to a switch or router via the serial port. Transparent mode is applicable to the serial-port side only. When transparent mode is enabled, common control characters are not interpreted. For example, some characters that would not be interpreted (and their Hex equivalents) are ^Q (11), ^S (13), and NULL (00). To disable transparent mode, execute the following command in the Asynchronous Command Mode: no transparency Example transparency enable

360

451-0310E

Chapter 6 Ethernet Commands

The Ethernet commands are executed in the Ethernet command mode. When the LX unit is in the Ethernet command mode, the Ethernet command prompt (e.g., Ether 1-1:0 >>) is displayed on the terminal screen. The format of the Ethernet command prompt is as follows: Ether -: >> where

identifies the first port in the range of ports under configuration. identifies the last port in the range of ports under configuration. identifies the current session number.

To enter the Ethernet command mode, execute the port ethernet command in the Configuration command mode. The port ethernet command is described on page 195.

451-0310E

361

description Specifies the description for the Ethernet port. Syntax description STRING Where

Means

STRING

A text string that describes the Ethernet port. The text string can contain up to 60 characters.

Example description Port 0 on the Lab Unit

362

451-0310E

end When the end command is issued in Ethernet Command Mode, it returns the user to the Superuser command mode. Syntax end Usage Guidelines The end command can be issued in all of the LX Command Modes except for User and Superuser. Executing the end command always returns the user to the Superuser command mode. Example end

451-0310E

363

exit Returns the user to the previous command mode. For example, if the current command mode is the Ethernet command mode, issuing this command will return the user to the Configuration command mode. Syntax exit Usage Guidelines The exit command can be issued in all of the LX command modes. However, the effect of the exit command varies, depending on the mode from which it is issued. As noted above, issuing the exit command in the Ethernet command mode returns the user to the previous command mode. The same goes for issuing the exit command in any mode other than the User command mode. For example, issuing the exit command in the Menu Editing command mode returns the user to the Menu command mode; issuing the exit command in the Configuration command mode returns the user to the Superuser command mode, and so on. Issuing the exit command in the User command mode exits the LX CLI and closes the connection to the LX unit. Example exit

364

451-0310E

no description Removes (deletes) the description field for the Ethernet port(s) under configuration. Refer to “description” on page 362 for more information on the description field. Syntax no description Example no description

451-0310E

365

speed Specifies the speed and duplex mode of the Ethernet port under configuration. Syntax speed auto|10mb|100mb duplex full|half Where

Means

auto

The Ethernet port under configuration will auto-negotiate its port speed and duplex mode. This is the default setting. Note: If the auto option is specified, you will not be able to specify full or half as the duplex mode for the port; the duplex mode will be auto-negotiated.

10mb

Sets a speed of 10 Megabytes per second for the Ethernet port under configuration.

100mb

Sets a speed of 100 Megabytes per second for the Ethernet port under configuration.

full

The Ethernet port under configuration will use full duplex.

half

The Ethernet port under configuration will use half duplex.

Examples speed auto speed 10mb duplex full speed 100mb duplex full speed 10mb duplex half speed 100mb duplex half

366

451-0310E

Chapter 7 Subscriber Commands

The Subscriber commands are executed in the Subscriber command mode. When the LX unit is in the Subscriber command mode, the Subscriber command prompt (e.g., Subs_mark >>) is displayed on the terminal screen. The format of the Subscriber command prompt is as follows: Subs_ >> where

is the name of the subscriber under configuration.

To enter the Subscriber command mode, execute the subscriber command in the Configuration command mode. The subscriber command is described on page 247.

451-0310E

367

access console enable Enables the subscriber to access the LX unit via a direct connection to the LX console port. Syntax access console enable Example access console enable

368

451-0310E

access port Specifies the LX asynchronous ports that the subscriber can access. Syntax access port Where

Means

port_list

Specifies the asynchronous port(s) that the user can access on the LX unit. If more than one asynchronous port is specified, they should be separated by blank spaces; for example, 2 3 5 6. In order to specify a range of ports, put a hyphen between the first port and the last port; for example: 3-7.

Example access port 2 access port 0 2 3 5 6 access port 3-7

451-0310E

369

access ssh enable Enables the subscriber to access the LX unit by an SSH connection. Syntax access ssh enable Example access ssh enable

370

451-0310E

access telnet enable Enables the subscriber to access the LX unit by a Telnet connection. Syntax access telnet enable Example access telnet enable

451-0310E

371

access web enable Enables the subscriber to access the LX unit from a web browser via an Internet connection. Syntax access web enable Example access web enable

372

451-0310E

audit log enable Enables the auditing of port activity for the subscriber. The auditing begins as soon as this command is executed. Syntax audit log enable Example audit log enable

451-0310E

373

backward_switch Specifies the Backward Switch character for the subscriber; when the subscriber enters the Backward Switch character, he is returned to the previous (lower-numbered) session without returning to the local command mode. Syntax backward_switch CHARACTER Where

Means

CHARACTER

A capital letter (A - Z) that the user will type to return to the previous session. It is recommended that you specify an unused CTRL character.

Usage Guidelines To specify that the Backward Switch character is a CTRL character, the character must be preceded by the caret symbol (^) in the backward_switch command. For example, the following command specifies that the Backward Switch character is CTRL/I: backward_switch ^I Be sure that there are no conflicting uses for the character you select (particularly with control characters that are used by applications programs, or with the character you set for the FORWARD SWITCH, the LOCAL SWITCH, or any Telnet command characters). If you specify a CTRL character, when the user types the character, it will be displayed as ^ (i.e., if the user types CTRL/I, the terminal will echo the characters: ^I). Example backward_switch ^I

374

451-0310E

command log enable Enables command logging for the subscriber. Syntax command log enable Usage Guidelines Command logging creates an audit trail of subscriber input in a subscriber session. The audit trail is sent to the accounting log and to syslogd. Use the show command log command to display the command log. The show command log command is described on page 87. Example command log enable

451-0310E

375

dedicated service Permanently assigns the subscriber to a dedicated service; whenever the subscriber logs into the LX unit, he will begin running the service that is specified in this command. Syntax dedicated service NAME Where

Means

NAME

The name of the service to which the subscriber is permanently assigned.

Usage Guidelines In order to use this command, the Telnet protocol must be enabled. Example dedicated service finance_server

376

451-0310E

default access port Resets the access ports for the subscriber to the factory default of all physical ports on the LX unit, including port 0. Syntax default access port Example default access port

451-0310E

377

default access remote Resets the subscriber’s remote access to the default value, which is no remote access. Syntax default access remote Example default access remote

378

451-0310E

default backward_switch Resets the Backward Switch character for the subscriber back to the factory default. NOTE: The factory-default Backward Switch character is Control-B (^B). Syntax default backward_switch Example default backward_switch

451-0310E

379

default dialback retry Resets the Dialback retries for the subscriber back to the factory default of 4. Syntax default dialback retry Example default dialback retry

380

451-0310E

default forward_switch Resets the Forward Switch character for the subscriber back to the factory default. NOTE: The factory-default Forward Switch character is Control-F (^F). Syntax default forward_switch Example default forward_switch

451-0310E

381

default idletime Resets the Inactivity timeout for the subscriber to the factory default of 0. A value of 0 means that the Inactivity Timer is effectively disabled. Syntax default idletime Example default idletime

382

451-0310E

default local_switch Resets the Local Switch character for the subscriber back to the factory default. NOTE: The factory-default Forward Switch character is Control-L (^L). Syntax default local_switch Example default local_switch

451-0310E

383

default ssh log level Resets the SSH log level to the factory-default level, which is INFO. Syntax default ssh log level Example default ssh log level

384

451-0310E

dialback enable Enables the Dialback feature for the subscriber. Syntax dialback enable Example dialback enable

451-0310E

385

dialback number Specifies the telephone number that the LX modem will dial when the subscriber makes a Dialback call to the LX unit. Syntax dialback number Where

Means

telephone_number

The telephone number that the LX modem will dial when the subscriber makes a Dialback call to the LX unit.

Example dialback number 19785551978

386

451-0310E

dialback retry Specifies the number of times that the modem on the LX unit can attempt to answer a dialback call. Syntax dialback retry NUMBER Where

Means

NUMBER

The number of times that the modem on the LX unit can attempt to answer a dialback call. The default value is 3. The allowable values are 1 through 255.

Example dialback retry 7

451-0310E

387

end When the end command is issued in the Subscriber command mode, it returns the user to the Superuser command mode. Syntax end Usage Guidelines The end command can be issued in all of the LX Command Modes except for User and Superuser. Executing the end command always returns the user to the Superuser command mode. Example end

388

451-0310E

exit Returns the user to the previous command mode. For example, if the current command mode is the Subscriber command mode, issuing this command will return the user to the Configuration command mode. Syntax exit Usage Guidelines The exit command can be issued in all of the LX command modes. However, the effect of the exit command varies, depending on the mode from which it is issued. As noted above, issuing the exit command in the Subscriber command mode returns the user to the previous command mode. The same goes for issuing the exit command in any mode other than the User command mode. For example, issuing the exit command in the Menu command mode returns the user to the Configuration command mode; issuing the exit command in the Configuration command mode returns the user to Superuser command mode, and so on. Issuing the exit command in the User command mode exits the LX CLI and closes the connection to the LX unit. Example exit

451-0310E

389

forward_switch Specifies the Forward Switch character for the subscriber; when the subscriber enters the Forward Switch character, he is switched to the next (higher-numbered) session without returning to the local command mode. Syntax forward_switch CHARACTER Where

Means

CHARACTER

A capital letter (A - Z) that the user will type to switch to the next session. It is recommended that you specify an unused CTRL character.

Usage Guidelines To specify that the Forward Switch character is a CTRL character, the character must be preceded by the caret symbol (^) in the forward_switch command. For example, the following command specifies that the Forward Switch character is CTRL/M: forward_switch ^M Be sure that there are no conflicting uses for the character you select (particularly with control characters that are used by applications programs, or with the character you set for the BACKWARD SWITCH, the LOCAL SWITCH, or any Telnet command characters). If you do specify a CTRL character, when the user types the character, it will be displayed as ^ (i.e., if the user types CTRL/M, the terminal will echo the characters: ^M). Example forward_switch ^M

390

451-0310E

idletime Sets the Inactivity Timeout for the subscriber. The subscriber is logged out if he does not enter keyboard data before the expiration of the Inactivity Timeout. Syntax idletime Where

Means

timeout_value

The length of the Inactivity Timeout, in seconds. The allowable values are 0 through 65535. The default value is 0. A value of 0 means that the Inactivity Timer is effectively disabled.

Syntax idletime 1200

451-0310E

391

local_switch Specifies the Local Switch character for the subscriber; when the subscriber enters the Local Switch character, he is returned to the local command mode. Syntax local_switch CHARACTER Where

Means

CHARACTER

A capital letter (A - Z) that the user will type to return to the local command mode. It is recommended that you specify an unused CTRL character.

Usage Guidelines To specify that the Local Switch character is a CTRL character, the character must be preceded by the caret symbol (^) in the local_switch command. For example, the following command specifies that the Local Switch character is CTRL/K: local_switch ^K Be sure that there are no conflicting uses for the character you select (particularly with control characters that are used by applications programs, or with the character you set for the BACKWARD SWITCH, the FORWARD SWITCH, or any Telnet command characters). If you do specify a CTRL character, when the user types the character, it will be displayed as ^ (i.e., if the user types CTRL/K, the terminal will echo the characters: ^K). Example local_switch ^K

392

451-0310E

maxsubscriber Sets the maximum simultaneous connections for the subscriber. Syntax maxsubscriber NUMBER Where

Means

NUMBER

The maximum simultaneous connections for the subscriber. The allowable values are 1 through 255. The default value is 5.

Syntax maxsubscriber 10

451-0310E

393

menu enable Assigns a log-in menu to the subscriber and enables the Menu feature for the subscriber. If the Menu feature is enabled, and a menu exists for the subscriber, a menu is displayed when the subscriber logs in to the LX unit. Refer to “Menu Commands” on page 479 for more information on creating menus. Syntax menu NAME enable Where

Means

NAME

The name of the menu that is to be displayed when the subscriber logs in to the LX unit. Refer to “Menu Commands” on page 479 for more information on creating menus.

Example menu tom enable

394

451-0310E

no Disables (negates) specific features and boolean parameters for the subscriber under configuration. Refer to “Usage Guidelines” (below) for more information about using the no command in the Subscriber mode. Syntax no Where

Means

feature_name

The name of the feature or boolean parameter that is to be disabled.

Usage Guidelines The allowable arguments for this command consist of only those features and boolean parameters that can be set in the Subscriber command mode and are currently enabled for this subscriber. To view the features and boolean parameters that are currently enabled, type the no command followed by a question mark (?). Example no pause

451-0310E

395

password Assigns a new login password to the subscriber’s account. Syntax password Usage Guidelines When this command is executed, the following prompts are displayed: Enter your NEW password : Re-enter your NEW password: Enter the new password at the Enter prompt, and re-enter it at the Re-enter prompt. The password string can be up to 16 characters in length, and it will be masked when you enter it at the above prompts. Example password

396

451-0310E

password enable Enables password login protection on the subscriber account and enables the subscriber to reset his password the next time he logs in. (The subscriber will be prompted to enter, and confirm, his new password the next time he logs in.) Syntax password enable Example password enable

451-0310E

397

pause enable Configures the screen pause feature for this subscriber. When this feature is enabled, the screen will pause after displaying the number of lines specified in the “lines/screen” value for the terminal. Syntax pause enable Example pause enable

398

451-0310E

preferred service Assigns a service to which the port will connect whenever a user makes a connect request without specifying a service. Syntax preferred service NAME Where

Means

NAME

The name of the preferred service.

Usage Guidelines After assigning a Preferred Service to a subscriber, you must log out the subscriber in order for the Preferred Service to take effect. Example preferred service finance_server

451-0310E

399

prompt Sets the portion of the subscriber’s user prompt. Refer to page 33 for more information on the format of the user prompt. Syntax prompt STRING Where

Means

STRING

A text string of up to 8 ASCII characters.

Example prompt BILL

400

451-0310E

security level superuser Allows the subscriber to log into the Superuser command mode with the Superuser password. The subscriber logs in to the Superuser command mode by executing the enable command (see page page 36). Syntax security level superuser Example security level superuser

451-0310E

401

session Sets the maximum number of sessions for a subscriber. Syntax session NUMBER Where

Means

NUMBER

The maximum number of sessions for the subscriber. The allowable values are 0 through 4, where a value of 0 disables the subscriber’s access to the LX unit.

Examples session 3

402

451-0310E

shell enable Configures the Subscriber Session Mode as Shell. When the Subscriber Session Mode is Shell, the subscriber is logged into the Linux shell when he accesses the LX unit. Syntax shell enable Usage Guidelines You can reset the Subscriber Session Mode to CLI by executing the no shell command in the Subscriber Command Mode. When the Subscriber Session Mode is CLI, the subscriber will be logged into the LX CLI (or his specified Login Menu) when he accesses the LX unit. Example shell enable

451-0310E

403

ssh cipher Specifies the SSH encryption type(s) that are supported for this subscriber. Syntax ssh cipher triple-des|any|blowfish Where

Means

triple-des

Specifies that the Triple Data Encryption Standard (Triple-DES) is the only SSH encryption type supported for this subscriber.

any

Specifies that any SSH encryption type is supported for this subscriber.

blowfish

Specifies that BLOWFISH is the only SSH encryption type supported for this subscriber. See “Usage Guidelines” (below) for more information on the BLOWFISH encryption type.

Usage Guidelines Blowfish is a variable-length key block cipher. It is only suitable for applications where the key does not change often, like a communications link or an automatic file encryptor. It is significantly faster than DES when implemented on 32-bit microprocessors with large data caches, such as the Pentium and the PowerPC. It takes a variable-length key, from 32 bits to 448 bits, making it ideal for both domestic and exportable use. Blowfish is unpatented and license-free, and is available free for all uses at the following website: http://www.counterpane.com/blowfish-download.html Examples ssh cipher triple-des ssh cipher any ssh cipher blowfish

404

451-0310E

ssh key Specifies a unique SSH key for this subscriber. When a subscriber has a unique SSH key, he can log on to the LX unit via SSH without entering a password. (The only requirement is that the user must log on from the host on which his SSH key was generated.) Syntax ssh key Usage Guidelines When this command is executed, the following prompt is displayed: Please enter your key: Type an SSH key at the above prompt. The SSH key can be any random string of characters. As an alternative to typing the SSH key, you can paste a generated SSH key at the above prompt. (The SSH key must be generated on the host from which the subscriber will make SSH connections to the LX unit. Refer to your Linux documentation for more information on generating an SSH key.) Example ssh key

451-0310E

405

ssh log level Specifies the class of SSH messages that will be logged to syslogd. Syntax ssh log level debug|error|fatal|info|quiet|verbose Where

Means

debug

Only debug messages will be sent to the SSH log.

error

Only error messages will be sent to the SSH log.

fatal

Only fatal error messages will be sent to the SSH log.

info

Only informational messages will be sent to the SSH log. This is the default.

quiet

Default account log information will be logged for SSH.

verbose

Verbose account log information will be logged for SSH.

Examples ssh log level debug ssh log level error ssh log level fatal ssh log level info ssh log level quiet ssh log level verbose

406

451-0310E

telnet mode Specifies the Telnet mode for the subscriber. Syntax telnet mode line|character Where

Means

line

The subscriber will use Telnet line mode.

character

The subscriber will use Telnet character mode.

Examples telnet mode line telnet mode character

451-0310E

407

terminal Sets the terminal type for the subscriber. Syntax terminal Where

Means

terminal_type

The terminal type for the subscriber. The allowable terminal types are VT100 and ANSI.

Example terminal vt100 terminal ansi

408

451-0310E

Chapter 8 SNMP Commands

The SNMP commands are executed in the SNMP command mode. When the LX unit is in the SNMP command mode, the SNMP command prompt (e.g., Snmp:0 >>) is displayed on the terminal screen. The format of the SNMP command prompt is as follows: Snmp: >> where

is the session number of the current connection.

To enter the SNMP command mode, execute the snmp command in the Configuration command mode. The snmp command is described on page 242.

451-0310E

409

contact Specifies the name of a system contact for the LX unit. Syntax contact STRING Where

Means

STRING

The name of a system contact for the LX unit. This information is available via an SNMP query (get) but is provided for administrative or informational purposes only. The MIB object is sysContact. The text string can contain up to 60 characters.

Example contact Henry Smith

410

451-0310E

default v3 client Specify the default SNMP V3 client for the LX unit Syntax default v3 client NUMBER Where

Means

NUMBER

The number of the default SNMP V3 client. Valid values are 3 - 7.

Example default v3 client 5

451-0310E

411

end When the end command is issued in SNMP Mode, it returns the user to the Superuser command mode. Syntax end Usage Guidelines The end command can be issued in all of the LX Command Modes except for User and Superuser. Executing the end command always returns the user to the Superuser command mode. Example end

412

451-0310E

exit Returns the user to the previous command mode. For example, if the current command mode is the SNMP command mode, issuing this command will return the user to the Configuration command mode. Syntax exit Usage Guidelines The exit command can be issued in all of the LX Command Modes. However, the effect of the exit command varies, depending on the mode from which it is issued. As noted above, issuing the exit command in the SNMP command mode returns the user to the previous command mode. The same goes for issuing the exit command in any mode other than the User command mode. For example, issuing the exit command in the Menu Editing command mode returns the user to the Menu command mode; issuing the exit command in the Configuration command mode returns the user to the Superuser command mode, and so on. Issuing the exit command in the User command mode exits the LX CLI and closes the connection to the LX unit. Example exit

451-0310E

413

get client Add, or change, an SNMP client (e.g., a Network Operations Center, or NOC) that has permission to view information about the LX unit (i.e., perform an SNMP get). Syntax get client NUMBER A.B.C.D Where

Means

NUMBER

The number of the SNMP client that has permission to perform an SNMP get on the LX unit. Valid values are 0 - 16.

A.B.C.D

The Internet address of an SNMP client that has permission to perform an SNMP get on the LX unit. The default value is 0.0.0.0. Specify the default value (0.0.0.0) to remove a client.

Example get client 4 119.20.112.3

414

451-0310E

get client community Specifies an SNMP Get client community for an SNMP get client of the LX unit. When an SNMP Get community has been specified with this command, any SNMP get clients must belong to the same SNMP Get community in order to perform an SNMP get on the unit. Syntax get client NUMBER community Where

Means

NUMBER

The number of the SNMP client that has permission to perform an SNMP get on the LX unit.

community_name

The name of the SNMP Get community. The name can be up to 32 characters long.

Example get client 3 community labunits

451-0310E

415

get client version Specifies the SNMP get client version for an SNMP get client of the LX unit. Syntax get client NUMBER version Where

Means

NUMBER

The number of the SNMP get client for which the SNMP get client version is to be set.

version_number

An SNMP get client version number. The allowable values are 1, 2, or 3. Note: Clients 0-2 are reserved for SNMP V1 clients and SNMP V2 clients. You cannot specify clients 0-2 as SNMP V3 clients.

Example get client 3 version 2

416

451-0310E

location Specifies the physical location of the LX unit. Syntax location STRING Where

Means

STRING

The physical location of the LX unit. This information is available via an SNMP query (get) but is provided for administrative or informational purposes only. The MIB object is sysLocation. The text string can contain up to 60 characters.

Example location Engineering Lab

451-0310E

417

log enable Enables the logging of all incoming SNMP packets to syslogd. Syntax log enable Example log enable

418

451-0310E

no Disables (negates) specific features and boolean parameters on the LX unit. Refer to “Usage Guidelines” (below) for more information about using the no command in the SNMP mode. Syntax no Where

Means

feature_name

The name of the feature or boolean parameter that is to be disabled.

Usage Guidelines The allowable arguments for this command consist of only those features and boolean parameters that can be set in the SNMP command mode and are currently enabled. To view the features and boolean parameters that are currently enabled, type the no command followed by a question mark (?). Example no pause

451-0310E

419

set client Add, or change, an SNMP client (e.g., a Network Operations Center, or NOC) that has permission to set characteristics (i.e., perform an SNMP set) on the LX unit. Syntax set client NUMBER A.B.C.D Where

Means

NUMBER

The number of the SNMP client that has permission to perform an SNMP set on the LX unit. Valid values are 0 - 16.

A.B.C.D

The Internet address of an SNMP client that has permission to perform an SNMP set on the LX unit. The default value is 0.0.0.0. Specify the default (0.0.0.0) value to remove a client.

Example set client 4 119.20.112.3

420

451-0310E

set client community Specifies an SNMP Set client community for an SNMP set client of the LX unit. When an SNMP Set community has been specified with this command, any SNMP set clients must belong to the same SNMP Set community in order to perform an SNMP set on the unit. Syntax set client NUMBER community Where

Means

NUMBER

The number of the SNMP client that has permission to perform an SNMP set on the LX unit.

community_name

The name of the SNMP Set community. The name can be up to 32 characters long.

Example set client 3 community labunits

451-0310E

421

set client version Specifies the SNMP set client version for an SNMP set client of the LX unit. Syntax set client NUMBER version Where

Means

NUMBER

The number of the SNMP set client for which the SNMP set client version is to be set.

version_number

An SNMP set client version number. The allowable values are 1, 2, or 3. Note: Clients 0-2 are reserved for SNMP V1 clients and SNMP V2 clients. You cannot specify clients 0-2 as SNMP V3 clients.

Example set client 3 version 2

422

451-0310E

trap client Add, or change, an SNMP client (e.g., a Network Operations Center, or NOC) that will receive SNMP traps generated by the LX unit. The LX unit sends an Enterprise-specific SNMP trap before a reboot and a Cold Start SNMP trap when the LX unit has rebooted. During normal operation of the LX unit, SNMP traps can be sent to trap clients via the Notification feature. Syntax trap client NUMBER A.B.C.D Where

Means

NUMBER

The number of the SNMP client that has permission to receive SNMP traps generated by the LX unit. Valid values are 0 - 16.

A.B.C.D

The Internet address of an SNMP client that has permission to receive SNMP traps from the LX unit. The default value is 0.0.0.0. Specify the default value (0.0.0.0) to remove a client.

Example trap client 4 119.20.112.3

451-0310E

423

trap client community Specifies an SNMP Trap community for an SNMP trap client of the LX unit. When an SNMP Trap community has been specified with this command, any SNMP trap clients must belong to the same SNMP Trap community in order to receive SNMP traps that are generated by the unit. The LX unit sends an Enterprise-specific SNMP trap before a reboot and a Cold Start SNMP trap when the LX unit has rebooted. During normal operation of the LX unit, SNMP traps can be sent to trap clients via the Notification feature. Syntax trap client NUMBER community Where

Means

NUMBER

The number of the SNMP client that has permission to receive SNMP traps that are generated by the LX unit.

community_name

The name of the SNMP Trap community. The name can be up to 32 characters long.

Example trap client 3 community labunits

424

451-0310E

trap client version Specifies the SNMP trap client version for an SNMP set client of the LX unit. The LX unit sends an Enterprise-specific SNMP trap before a reboot and a Cold Start SNMP trap when the LX unit has rebooted. During normal operation of the LX unit, SNMP traps can be sent to trap clients via the Notification feature. Syntax trap client NUMBER version Where

Means

NUMBER

The number of the SNMP trap client for which the SNMP trap client version is to be set.

version_number

An SNMP trap client version number. The allowable values are 1, 2 or 3. Note: Clients 0-2 are reserved for SNMP V1 clients and SNMP V2 clients. You cannot specify clients 0-2 as SNMP V3 clients.

Example trap client 5 version 2

451-0310E

425

v3 client access context match Specifies the access context match criteria for an SNMP V3 client. Syntax v3 client access context match exact|prefix Where

Means

client_number

The number of the SNMP V3 client for which the access context match criteria are being configured. Note: Clients 0-2 are reserved for SNMP V1 clients and SNMP V2 clients. You cannot specify clients 0-2 as SNMP V3 clients.

exact

The access context field of an incoming SNMP packet must be an exact match for the access context field that is specified for the group on the LX unit.

prefix

The prefix of an access context field of an incoming SNMP packet must match the prefix of the access context field that is specified for the group on the LX unit.

Examples v3 client 3 access context match exact v3 client 3 access context match prefix

426

451-0310E

v3 client access context prefix Specifies the access context prefix for an SNMP V3 client. Syntax v3 client access context prefix Where

Means

client_number

The number of the SNMP V3 client for which the access context prefix is being configured. Note: Clients 0-2 are reserved for SNMP V1 clients and SNMP V2 clients. You cannot specify clients 0-2 as SNMP V3 clients.

string

The access context prefix for the SNMP V3 client.

Examples v3 client 3 access context prefix lab

451-0310E

427

v3 client access read view Specifies the access read view for an SNMP V3 client. Syntax v3 client access read view Where

Means

client_number

The number of the SNMP V3 client for which the access read view is being configured. Note: Clients 0-2 are reserved for SNMP V1 clients and SNMP V2 clients. You cannot specify clients 0-2 as SNMP V3 clients.

word

The view that will be used as the read view for the SNMP V3 client. The read view is used for incoming SNMP Get Requests.

Example v3 client 3 access read view second_view

428

451-0310E

v3 client access security Specifies the access security settings for an SNMP V3 client. Syntax v3 client access security level model Where

Means

client_number

The number of the SNMP V3 client for which the access context settings are being configured. Note: Clients 0-2 are reserved for SNMP V1 clients and SNMP V2 clients. You cannot specify clients 0-2 as SNMP V3 clients.

level

Specify the access security level.

security_level

The access security level in an incoming SNMP packet must match this value in order for the packet to be allowed. The allowable values are 1, 2, or 3.

model

Specify the access security model.

model_number

The access security model in an incoming SNMP packet must match this value in order for the packet to be allowed. The allowable values are 1, 2, or 3.

Examples v3 client 3 access security level 1 v3 client 3 access security level 2 v3 client 3 access security level 3 v3 client 3 access security model 1 v3 client 3 access security model 2

451-0310E

429

v3 client access write view Specifies the access write view for an SNMP V3 client. Syntax v3 client access write view Where

Means

client_number

The number of the SNMP V3 client for which the access write view is being configured. Note: Clients 0-2 are reserved for SNMP V1 clients and SNMP V2 clients. You cannot specify clients 0-2 as SNMP V3 clients.

word

The view that will be used as the write view for the SNMP V3 client. The write view is used for incoming SNMP Set Requests.

Example v3 client 3 access write view third_view

430

451-0310E

v3 client group security model Specifies the group security model for an SNMP V3 client. Syntax v3 client group security model Where

Means

client_number

The number of the SNMP V3 client for which the security community setting is being configured. Note: Clients 0-2 are reserved for SNMP V1 clients and SNMP V2 clients. You cannot specify clients 0-2 as SNMP V3 clients.

model_number

The group security model in an incoming SNMP packet must match this value in order for the packet to be allowed. The allowable values are 1 or 2.

Examples v3 client 3 group security model 1 v3 client 3 group security model 2

451-0310E

431

v3 client name Specifies the name for an SNMP V3 client. Syntax v3 client name Where

Means

client_number

The number of the SNMP V3 client for which the client engine settings are being configured. Note: Clients 0-2 are reserved for SNMP V1 clients and SNMP V2 clients. You cannot specify clients 0-2 as SNMP V3 clients.

string

The name of the SNMP V3 client. This can be any text string.

Examples v3 client 3 name lab_unit

432

451-0310E

v3 client security community Specifies the security community for an SNMP V3 client. Syntax v3 client security community Where

Means

client_number

The number of the SNMP V3 client for which the security community setting is being configured. Note: Clients 0-2 are reserved for SNMP V1 clients and SNMP V2 clients. You cannot specify clients 0-2 as SNMP V3 clients.

word

The security community name for the SNMP V3 client. The LX unit will only accept SNMP Requests from this SNMP V3 client if the Request packet includes this community name. This is a text string of up to 60 characters.

Example v3 client 3 security community lab_group

451-0310E

433

v3 client security source Specifies the security source settings for an SNMP V3 client. Syntax v3 client security source mask Where

Means

client_number

The number of the SNMP V3 client for which the security source settings are being configured. Note: Clients 0-2 are reserved for SNMP V1 clients and SNMP V2 clients. You cannot specify clients 0-2 as SNMP V3 clients.

ip_address

The IP Address that will be used as the security source for the SNMP V3 client. The LX unit will only accept SNMP Requests from this SNMP V3 client if they have this IP Address specified as the security source.

mask

Requires both the IP Address, and subnet mask, of the security source to match.

subnet_mask

The subnet mask that will be used as the security source mask for the SNMP V3 client. If this mask is specified, both IP address and the subnet mask for the security source must match for the LX unit to accept SNMP Requests from the V3 client.

Examples v3 client 4 security source 143.32.87.23 v3 client 4 security source mask 255.255.255.0

434

451-0310E

v3 client view Specifies the view settings for an SNMP V3 client. Syntax v3 client view subtree mask type Where

Means

client_number

The number of the SNMP V3 client for which the view settings are being configured. Note: Clients 0-2 are reserved for SNMP V1 clients and SNMP V2 clients. You cannot specify clients 0-2 as SNMP V3 clients.

subtree

Specify the subtree for the V3 client.

object_id

An Object ID that will be used as a filter for incoming SNMP packets, as specified by the mask for the V3 client.

mask

Specify the view mask for the V3 client.

octet_string

A hexadecimal number that specifies the octets that must match those in the subtree. For example, hexadecimal F (which has a binary value of 1111) indicates that the first four octets in an incoming Object ID must match the first four octets in the subtree. If the subtree is 1.3.6.1.2.1.1.2, the Object IDs of incoming SNMP packets must have 1.3.6.1 as their first four octets.

type

Specify the type for the V3 view.

word

The type of the V3 view. The allowable values are: allow – Packets that match the mask and subtree in this view will be allowed to make requests on the LX unit. deny –

Packets that match the mask and subtree in this view will not be allowed to make requests on the LX unit.

Examples v3 client 4 view subtree 1.3.6.1.2.1.1.2 v3 client 4 view mask F v3 client 4 view type allow v3 client 4 view type deny

451-0310E

435

v3 engine Specifies the engine settings for an SNMP V3 client. Syntax v3 engine id boots NUMBER Where

Means

id

Specify the Engine ID for the LX unit.

octet_string

An hexadecimal value that uniquely identifies the LX unit.

boots

Specify the Engine boots for the LX unit.

NUMBER

An integer number that represents the number of times that the SNMP daemon running on the LX unit has rebooted. You can set this to any integer value. This is a counter that will be incremented each time the SNMP daemon is rebooted. This value is also a shared secret between the LX unit and the SNMP V3 client.

Examples v3 engine id 346248687 v3 engine boots 11

436

451-0310E

Chapter 9 Modem Commands

The Modem commands, which are used to configure modems for asynchronous ports, are executed in the Modem command mode. When the LX unit is in the Modem command mode, the Modem command prompt (e.g., Modem 4-4:0 >>) is displayed on the terminal screen. The format of the Modem command prompt is as follows: Modem -: >> where

identifies the first port in the range of ports under configuration. (This value is inherited from the Asynchronous command mode.) identifies the last port in the range of ports under configuration. (This value is inherited from the Asynchronous command mode.) identifies the current session number.

To enter the Modem command mode, execute the modem command in the Asynchronous command mode. The modem command is described on page 338.

451-0310E

437

default initstring Resets the modem initialization string to its default value. Syntax default initstring Example default initstring

438

451-0310E

dialout number Specifies the telephone number that the LX modem will dial for a dialout connection. Syntax dialout number Where

Means

telephone_number

The telephone number that the LX modem will dial for a dialout connection.

Usage Guidelines You cannot specify a dialout number for port 0. If you execute the dialout number command on port 0, the following message will be displayed: Operation not permitted on diagnostic/management port Example dialout number 19785558371

451-0310E

439

end When the end command is issued in the Modem command mode, it returns the user to the Superuser command mode. Syntax end Usage Guidelines The end command can be issued in all of the LX Command Modes except for User and Superuser. Executing the end command always returns the user to the Superuser command mode. Example end

440

451-0310E

exit Returns the user to the previous command mode. For example, if the current command mode is the Modem command mode, issuing this command will return the user to the Asynchronous command mode. Syntax exit Usage Guidelines The exit command can be issued in all of the LX command modes. However, the effect of the exit command varies, depending on the command mode from which it is issued. As noted above, issuing the exit command in the Modem command mode returns the user to the previous command mode. The same goes for issuing the exit command in any command mode other than the User command mode. For example, issuing the exit command in the Menu Editing command mode returns the user to the Menu command mode; issuing the exit command in the Configuration command mode returns the user to the Superuser command mode, and so on. Issuing the exit command in the User command mode exits the LX CLI and closes the connection to the LX unit. Example exit

451-0310E

441

initstring Specifies the Modem Initialization string that the port(s) under configuration will pass to the modem. Syntax initstring STRING Where

Means

STRING

The Modem Initialization string

Usage Guidelines You cannot specify a Modem Initialization string for port 0. If you execute the initstring command on port 0, the following message will be displayed: Operation not permitted on diagnostic/management port Example initstring AT S7=45 S0=1 L1 V1 X4 &C1 &1 Q0 &S1

442

451-0310E

no Disables (negates) specific features and boolean parameters on the LX unit. Refer to “Usage Guidelines” (below) for more information about using the no command in the Modem command mode. Syntax no Where

Means

feature_name

The name of the feature or boolean parameter that is to be disabled.

Usage Guidelines The allowable arguments for this command consist of only those features and boolean parameters that can be set in the Modem command mode and are currently enabled. To view the features and boolean parameters that are currently enabled, type the no command followed by a question mark (?). Example no dialout number

451-0310E

443

retry Specifies the number of times that the port(s) under configuration will attempt to make a dialout connection via a modem, after the initial attempt. Syntax retry NUMBER Where

Means

NUMBER

The number of times that the port(s) under configuration will attempt to make a dialout connection via a modem. The valid values are 0 - 255.

Usage Guidelines You cannot specify a retry value for port 0. If you execute the retry command on port 0, the following message will be displayed: Operation not permitted on diagnostic/management port Example retry 6

444

451-0310E

timeout Specifies the length of time that the port(s) under configuration can spend attempting to make a modem connection. Syntax timeout NUMBER Where

Means

NUMBER

Specifies how much time the port(s) under configuration can spend attempting to make a modem connection. Valid timeout values are from 1 to 255 seconds.

Usage Guidelines You cannot specify a modem timeout for port 0. If you execute the timeout command on port 0, the following message will be displayed: Operation not permitted on diagnostic/management port Example timeout 30

451-0310E

445

type Specifies the Modem type. Syntax type dialin|dialout Where

Means

dialin

The modem on the asynchronous port(s) under configuration can only be used for dialin connections.

dialout

The modem on the asynchronous port(s) under configuration can only be used for dialout connections.

Usage Guidelines You cannot specify a modem type for port 0. If you execute the type command on port 0, the following message will be displayed: Operation not permitted on diagnostic/management port Examples type dialin type dialout

446

451-0310E

Chapter 10 PPP Commands

The PPP commands, which are used to configure the Point-to-Point Protocol (PPP) for asynchronous ports, are executed in the PPP command mode. When the LX unit is in the PPP command mode, the PPP command prompt (e.g., PPP 4-4:0 >>) is displayed on the terminal screen. The format of the PPP command prompt is as follows: PPP -: >> where

identifies the first port in the range of ports under configuration. (This value is inherited from the Asynchronous command mode.) identifies the last port in the range of ports under configuration. (This value is inherited from the Asynchronous command mode.) identifies the current session number.

To enter the PPP command mode, execute the PPP command in the Asynchronous command mode. The PPP command is described on page 348.

451-0310E

447

accounting enable Enables the logging of PPP data for the asynchronous port(s) under configuration. NOTE: You cannot execute this command on port 0. Syntax accounting enable Example accounting enable

448

451-0310E

authentication Sets the PPP link authentication parameters for the port(s) under configuration. NOTE: You cannot execute this command on port 0. Syntax authentication chap|pap|retry |timeout Where

Means

chap

Enables CHAP authentication on the PPP link.

pap

Enables PAP authentication on the PPP link.

retry

Set the retry value for CHAP or PAP authentication.

retry_limit

The number of times that the LX unit will attempt to authenticate a PPP link.

timeout

Set the timeout value for CHAP or PAP authentication.

timeout_limit

The length of time that the LX unit has to perform CHAP or PAP authentication for a PPP link. If the link can not be authenticated within this time, the link is refused.

Examples authentication chap authentication pap authentication retry 5 authentication timeout 30

451-0310E

449

ccp enable Enables PPP Compression Control Protocol (CCP) negotiation on the asynchronous port(s) under configuration. NOTE: You cannot execute this command on port 0. Syntax ccp enable Example ccp enable

450

451-0310E

default authentication Resets the retry and timeout values for PPP authentication to the factory-default settings. NOTE: You cannot execute this command on port 0. Syntax default authentication retry|timeout Where

Means

retry

Resets the retry value for PPP authentication to the factory-default setting. Refer to “authentication” on page 449 for more information on the retry value for PPP authentication.

timeout

Resets the timeout value for PPP authentication to the factory-default setting. Refer to “authentication” on page 449 for more information on the timeout value for PPP authentication.

Example default authentication retry default authentication timeout

451-0310E

451

default ipcp Resets the negotiation options for the Internet Protocol Control Protocol (IPCP) to their factorydefault values. NOTE: You cannot execute this command on port 0. Syntax default ipcp compression|failure|timeout Where

Means

compression

Resets the compression option for IPCP to the factory-default value. Refer to “ipcp accept address enable” on page 462 for more information on the compression option for IPCP.

failure

Resets the failure option for IPCP to the factory-default value. Refer to “ipcp accept address enable” on page 462 for more information on the failure option for IPCP.

timeout

Resets the timeout option for IPCP to the factory-default value. Refer to “ipcp accept address enable” on page 462 for more information on the timeout option for IPCP.

Example default ipcp compression default ipcp failure default ipcp timeout

452

451-0310E

default lcp compression Resets the compression option for the Link Control Protocol (LCP) to the factory-default value. NOTE: You cannot execute this command on port 0. Refer to “lcp compression enable” on page 466 for more information on the compression option for LCP. Syntax default lcp compression Example default lcp compression

451-0310E

453

default lcp echo failure Resets the echo failure parameter for the Link Control Protocol (LCP) to the factory-default value. NOTE: You cannot execute this command on port 0. Refer to “lcp echo failure” on page 467 for more information on the echo failure parameter for LCP. Syntax default lcp echo failure Example default lcp echo failure

454

451-0310E

default lcp failure limit Resets the failure limit parameter for the Link Control Protocol (LCP) to the factory-default value. NOTE: You cannot execute this command on port 0. Refer to “lcp failure limit” on page 469 for more information on the failure limit parameter for LCP. Syntax default lcp failure limit Example default lcp failure limit

451-0310E

455

default lcp timeout Resets the Link Control Protocol (LCP) timeout for the port(s) under configuration to the factory-default value. NOTE: You cannot execute this command on port 0. Refer to “lcp timeout” on page 470 for more information on the LCP timeout. Syntax default lcp timeout Example default lcp timeout

456

451-0310E

default mode client username Resets the client-mode username to the factory-default value, which is InReach. NOTE: You cannot execute this command on port 0. Syntax default mode client username Example default mode client username

451-0310E

457

default mtu Resets the Maximum Transmission Unit (MTU) for the PPP link to the factory-default setting. The MTU is the maximum-sized packet that can be transmitted on the PPP link. NOTE: You cannot execute this command on port 0. Syntax default mtu Example default mtu

458

451-0310E

default remote address Resets the IP address of the remote system in the PPP link to the default value. NOTE: You cannot execute this command on port 0. Syntax default remote address Example default remote address

451-0310E

459

end When the end command is issued in the PPP command mode, it returns the user to the Superuser command mode. Syntax end Usage Guidelines The end command can be issued in all of the LX command modes except for User and Superuser. Executing the end command always returns the user to the Superuser command mode. Example end

460

451-0310E

exit Returns the user to the previous command mode. For example, if the current command mode is the PPP command mode, issuing this command will return the user to the Asynchronous command mode. Syntax exit Usage Guidelines The exit command can be issued in all of the LX command modes. However, the effect of the exit command varies, depending on the mode from which it is issued. As noted above, issuing the exit command in the PPP command mode returns the user to the previous command mode. The same goes for issuing the exit command in any command mode other than User. For example, issuing the exit command in the Menu Editing command mode command mode returns the user to the Menu command mode; issuing the exit command in the Configuration command mode returns the user to the Superuser command mode, and so on. Issuing the exit command in the User command mode exits the LX CLI and closes the connection to the LX unit. Example exit

451-0310E

461

ipcp accept address enable Configures the PPP link to accept negotiation of local addresses or remote addresses. NOTE: You cannot execute this command on port 0. Syntax ipcp accept local|remote address enable Where

Means

local

Specifies that the PPP link will only accept negotiation of local addresses.

remote

Specifies that the PPP link will only accept negotiation of remote addresses.

Examples ipcp accept local address enable ipcp accept remote address enable

462

451-0310E

ipcp compression enable Specifies that the port(s) under configuration will try to negotiate the use of Van Jacobson (VJ) compression over a PPP link. NOTE: You cannot execute this command on port 0. Syntax ipcp compression enable Usage Guidelines Data compression allows more data to be transferred over the link. The use of the VJ compression method can result in significant bandwidth savings, which can be important when PPP connections are made over telephone lines or when a PPP link is very heavily used. VJ compression is very memory intensive, however. The use of VJ compression is negotiated during PPP options negotiation. Compression can be used in one direction only. Example ipcp compression enable

451-0310E

463

ipcp failure limit Specifies the number of attempts at IPCP option negotiation that can be made by the port(s) under configuration. NOTE: You cannot execute this command on port 0. Syntax ipcp failure limit NUMBER Where

Means

NUMBER

A whole number that specifies the number of attempts at IPCP option negotiation that can be made by the port(s) under configuration. The attempt at making a PPP link will be aborted if the options are not successfully negotiated within this number of tries.

Example ipcp failure limit 6

464

451-0310E

ipcp timeout Specifies the length of time that the port(s) under configuration have for ipcp option negotiation. NOTE: You cannot execute this command on port 0. Syntax ipcp timeout NUMBER Where

Means

NUMBER

The length of time, in seconds, that the port(s) under configuration have for IPCP option negotiation. The attempt at making a PPP link will be aborted if the options are not successfully negotiated within this time limit.

Example ipcp timeout 30

451-0310E

465

lcp compression enable Specifies that the port(s) under configuration will try to negotiate the use of LCP compression over a PPP link. NOTE: You cannot execute this command on port 0. Syntax lcp compression enable Example lcp compression enable

466

451-0310E

lcp echo failure Specifies the number of times that the port(s) under configuration can send an LCP echo request. NOTE: You cannot execute this command on port 0. Syntax lcp echo failure NUMBER Where

Means

NUMBER

A whole number that specifies the number of times that the port(s) under configuration can send an LCP echo request. The attempt at making a PPP link will be aborted if the port does not receive an LCP echo after the last echo request is sent.

Example lcp echo failure 6

451-0310E

467

lcp echo interval Specifies the interval between the sending of LCP echo requests. NOTE: You cannot execute this command on port 0. Syntax lcp echo interval NUMBER Where

Means

NUMBER

A whole number that specifies the interval, in seconds, between the sending of LCP echo requests.

Example lcp echo interval 10

468

451-0310E

lcp failure limit Specifies the number of attempts at LCP option negotiation that can be made by the port(s) under configuration. NOTE: You cannot execute this command on port 0. Syntax lcp failure limit NUMBER Where

Means

NUMBER

A whole number that specifies the number of attempts at LCP option negotiation that can be made by the port(s) under configuration. The attempt at making a PPP link will be aborted if the options are not successfully negotiated within this number of tries.

Example lcp failure limit 6

451-0310E

469

lcp timeout Specifies the length of time that the port(s) under configuration have for LCP option negotiation. NOTE: You cannot execute this command on port 0. Syntax lcp timeout NUMBER Where

Means

NUMBER

The length of time, in seconds, that the port(s) under configuration have for LCP option negotiation. The attempt at making a PPP link will be aborted if the options are not successfully negotiated within this time limit.

Example lcp timeout 30

470

451-0310E

local address Specifies the PPP IP Local Address for the port(s) under configuration. NOTE: You cannot execute this command on port 0. Syntax local address A.B.C.D Where

Means

A.B.C.D

The PPP IP Local Address for the port(s) under configuration.

Example local address 119.20.112.3

451-0310E

471

mode client Specifies “client” as the PPP mode, and optionally specifies the CHAP or PAP secret, for the port(s) under configuration. NOTE: You cannot execute this command on port 0. Syntax mode client [chap|pap ] Where

Means

chap

Specify the CHAP secret for the port(s) under configuration.

pap

Specify the PAP secret for the port(s) under configuration.

secret

The CHAP or PAP secret for the port(s) under configuration.

Examples mode client mode client pap wtrrrgbbba mode client pap irtntobaalmwmtg

472

451-0310E

mode client username Specifies the username for the PPP client. NOTE: You cannot execute this command on port 0. Syntax mode client username Where

Means

name

The username for the PPP client. This can be any text string.

Examples mode client username jackc

451-0310E

473

mode server Specifies the PPP mode for the port(s) under configuration as Server Active or Server Passive. NOTE: You cannot execute this command on port 0. Syntax mode server active|passive Where

Means

active

Specifies that the port(s) under configuration will use PPP server active mode.

passive

Specifies that the port(s) under configuration will use PPP server passive mode.

Examples mode server active mode server passive

474

451-0310E

mtu Sets the Maximum Transmission Unit (MTU) size for the PPP link. Frames that are larger than the designated MTU size are fragmented before transmission. (Note that the software fragments frames on the transmit side only.) NOTE: You cannot execute this command on port 0. Syntax mtu NUMBER Where

Means

NUMBER

The MTU size for the PPP link. The allowable values are 1000 - 1500. The default value is 1400.

Example mtu 1300

451-0310E

475

no Disables (negates) specific features and boolean parameters on the LX unit. Refer to “Usage Guidelines” (below) for more information about using the no command in the PPP command mode. Syntax no Where

Means

feature_name

The name of the feature or boolean parameter that is to be disabled.

Usage Guidelines The allowable arguments for this command consist of only those features and boolean parameters that can be set in the PPP command mode and are currently enabled. To view the features and boolean parameters that are currently enabled, type the no command followed by a question mark (?). Example no authentication

476

451-0310E

remote address Identifies the remote system in the PPP link. NOTE: You cannot execute this command on port 0. Syntax remote address A.B.C.D Where

Means

A.B.C.D

The IP Address of the remote unit in the PPP link.

Example remote address 129.27.172.19

451-0310E

477

Chapter 11 Menu Commands

The Menu commands are executed in the Menu command mode. When the LX unit is in the Menu command mode, the Menu command prompt (e.g., Menu :0 >>) is displayed on the terminal screen. The format of the Menu command prompt is as follows: Menu : >> where

identifies the current session number.

To enter the Menu command mode, execute the menu command in the Configuration command mode, or execute the exit command in the Menu Editing command mode. The menu command is described on page 184.

451-0310E

479

delete Deletes a menu from the LX unit. Syntax delete NAME Where

Means

NAME

The name of the menu that is to be deleted from the database of menus on the LX unit.

Example delete finance_menu

480

451-0310E

end When the end command is issued in the Menu command mode, it returns the user to the Superuser command mode. Syntax end Usage Guidelines The end command can be issued in all of the LX command modes except for User and Superuser. Executing the end command always returns the user to the Superuser command mode. Example end

451-0310E

481

exit Returns the user to the previous command mode. For example, if the current command mode is Menu, issuing this command will return the user to the Configuration command mode. Syntax exit Usage Guidelines The exit command can be issued in all of the LX Command Modes. However, the effect of the exit command varies, depending on the command mode from which it is issued. For example, issuing the exit command in the Menu command mode returns the user to the Configuration command mode; issuing the exit command in Configuration command mode returns the user to the Superuser command mode, and so on. Issuing the exit command in the User command mode exits the LX CLI and closes the connection to the LX unit. Example exit

482

451-0310E

import Merges existing menus into one menu. Syntax import to Where

Means

menu_list

Specifies the menu files that are to be merged into the destination menu. Each menu filename must be separated by a blank space. The menu files in the menu_list are appended to the destination menu. Note: A maximum of 16 menu pages can be merged into a destination menu. Each menu or submenu counts as a separate menu page.

destination_menu

Specifies the filename of the menu to which the files in menu_list are to be merged.

Usage Guidelines If the destination menu already exists, the following prompt will be displayed when you execute the import command: The destination file already exists.

Do you want to overwrite it?

(yes/no)

Answering “yes” will overwrite the destination file. Answering “no” will abort the command. Examples import menu_1 menu_2 menu_3 menu_4 menu_5 to finance_menu import susans_menu jacks_menu henrys_menu_3 to group_menu

451-0310E

483

list Displays a list of the menus on the LX unit. NOTE: If this command is executed while a menu file is open, a list of the submenus in the menu will be displayed. Syntax list Example list

484

451-0310E

no Disables (negates) specific features and boolean parameters on the LX unit. Refer to “Usage Guidelines” (below) for more information about using the no command in the Menu command mode. Syntax no Where

Means

feature_name

The name of the feature or boolean parameter that is to be disabled.

Usage Guidelines The allowable arguments for this command consist of only those features and boolean parameters that can be set in the Menu Editing command mode and are currently enabled. To view the features and boolean parameters that are currently enabled, type the no command followed by a question mark (?). Example no entry 2

451-0310E

485

open Opens a new or existing menu in the Menu Editing command mode. For more information on the Menu Editing command mode, refer to “Menu Editing Commands” on page 487. Syntax open NAME Where

Means

NAME

The name of the menu that is to be opened for editing.

Example open finance_menu

486

451-0310E

Chapter 12 Menu Editing Commands

The Menu Editing commands are executed in the Menu Editing command mode. When the LX unit is in the Menu Editing command mode, the Menu Editing command prompt (e.g., mark-1:0 >>) is displayed on the terminal screen. The format of the Menu Editing command prompt is as follows: -: >> where

identifies the Menu name. identifies the submenu number of the menu. The top-level menu always has a submenu number of 1. identifies the current session number.

To enter the Menu Editing command mode, execute the open command in the Menu command mode. The open command is described on page 486.

451-0310E

487

control key Assigns control keys for the menu. Syntax control key logout|repaint|top|up Where

Means

logout

Assigns a function key that will log out the subscriber account.

repaint

Assigns a function key that will redisplay the menu.

top

Assigns a function key that will move to the top-level menu for the subscriber.

up

Assigns a function key that will move up to the next-higher menu level.

character

The keyboard character that performs the assigned function.

text

Message text that is displayed at the bottom of the menu. This text typically describes what happens when the specified control key is pressed. This message has a limit of 18 characters.

Examples control key logout W Log out of LX control key repaint Z Refresh screen control key top H Go to top level control key up G Go back menu level

488

451-0310E

display Displays the current menu, or a submenu associated with the current menu. The menu is displayed in the same form as it would be seen by an end user. Syntax display [menu ] Where

Means

menu_number

An integer number, from 1 through 16, that identifies an existing menu. Menu 1 is the top-level menu. The default value is the current menu.

Usage Guidelines When this command is executed without a submenu number, the current menu or submenu is displayed. Example display display menu 11

451-0310E

489

end When the end command is issued in the Menu Editing command mode, it returns the user to the Superuser command mode. Syntax end Usage Guidelines The end command can be issued in all of the LX Command Modes except for User and Superuser. Executing the end command always returns the user to the Superuser command mode. Example end

490

451-0310E

entry Display a menu entry as it appears in the menu file. NOTE: This command displays an entry as it appears in the menu file rather than as the end user will see it. The label and the associated command are listed. Syntax entry Where

Means

entry_number

An integer number, from 1 through 40, that identifies the menu entry that is to be displayed.

Example entry 12

451-0310E

491

entry command Creates or modifies a command entry. A Command entry executes a Linux command when the user selects it from the menu. Syntax entry command Where

Means

entry_number

An integer number, from 1 through 40, that identifies the menu entry that is to be created or modified.

command_text

The shell-level command that is to be executed when this menu entry is selected by the user. This field can contain any syntactically correct Linux command.

Example entry 3 command telnet 1.2.3.5.1

492

451-0310E

entry label Creates or modifies a label for a command entry or a menu entry. The label is displayed to the user in the menu. Syntax entry label Where

Means

entry_number

An integer number, from 1 through 40, that identifies the menu entry for which the label is to be created or modified.

label_text

A text string that describes the entry. The text string can contain any text characters, including spaces. If the menu or submenu has less than 21 entries, the text string can contain up to 52 characters. If the menu or submenu has 21 or more entries, the text string is limited to 36 characters.

Example entry 3 label List the log entries

451-0310E

493

entry menu Creates or modifies a menu entry. When a menu entry is selected from a menu, it switches to a submenu. NOTE: This command will create an entry with a label. The default label is the same as the command string itself. You can change the label with the entry label command. The entry label command is described on page 493. Syntax entry menu Where

Means

entry_number

An integer number, from 1 through 40, that identifies the menu entry that is to be created or modified.

menu_number

An integer number, from 1 through 16, that identifies the submenu that is to be displayed when the user selects this menu entry.

Example entry 11 menu 6

494

451-0310E

exit Returns the user to the previous command mode. For example, if the current command mode is Menu Editing, issuing this command will return the user to the Menu command mode. Syntax exit Usage Guidelines The exit command can be issued in all of the LX command modes. However, the effect of the exit command varies, depending on the command mode from which it is issued. For example, issuing the exit command in the Menu Editing command mode returns the user to the Menu command mode; issuing the exit command in the Menu command mode returns the user to the Configuration command mode, and so on. Issuing the exit command in the User command mode exits the LX CLI and closes the connection to the LX unit. Example exit

451-0310E

495

header Creates a header for the current submenu. NOTE: The list command is used to display the headers for all submenus. The list command is described on page 497. Syntax header [] Where

Means

header_text

The text string that will be used as the Menu header. The text string can contain up to 60 characters, including spaces.

Examples header header Finance Department

496

451-0310E

list Displays all of the configured submenus for the current menu, and their configured headers. An asterisk (*) indicates the menu that is currently under configuration. Syntax list Example list

451-0310E

497

menu Opens a new or existing submenu for editing. Syntax menu Where

Means

submenu_number

The menu number of the submenu that is to be opened for editing. This can be any integer number from 1 through 16.

Usage Guidelines After this command is executed, the field of the Menu Editing prompt changes to the Submenu number that is being edited. For example, the prompt mark-12:0 >> indicates that Submenu 12 is currently being edited. Example menu 12

498

451-0310E

menu continue string Specifies the continue string for the current menu. If a continue string is specified, the screen will pause after a command entry is executed; the user must press the ENTER key to re-display the menu from which the command entry was selected. If a continue string is not specified, the screen will pause after a command entry is executed, but no prompt string will be displayed. The continue string typically describes how to re-display the menu (e.g., Press ENTER to return). The continue string appears at the bottom of the screen when you display the menu using the display command. The display command is described on page 489. Syntax menu continue string Where

Means

continue_string

The continue string for the current menu or submenu. This is a text string of up to 60 characters.

Examples menu continue string Press ENTER to return

451-0310E

499

menu prompt Specifies the prompt string for the current menu. The prompt string is displayed at the bottom of the menu, and it typically describes how to select a menu option. The prompt string appears at the bottom of the screen when you display the menu using the display command. The display command is described on page 489. Syntax menu prompt Where

Means

prompt_string

The prompt string for the current menu or submenu. This is limited to 53 characters.

Examples menu prompt Highlight options with Arrow Keys and press RETURN

500

451-0310E

no control key Removes control keys from the current menu. Syntax no control key logout|repaint|top|up Where

Means

logout

Removes the logout control key from the current menu.

repaint

Removes the repaint control key from the current menu.

top

Removes the top control key from the current menu.

up

Removes the up control key from the current menu.

Examples no control key logout no control key repaint no control key top no control key up

451-0310E

501

no entry Resets (negates) an entry in the current menu. When this command is executed, the menu entry no longer has a command, or a menu entry, associated with it. Syntax no entry Where

Means

entry_number

An integer number, from 1 through 40, that identifies the menu entry that is to reset.

Example no entry 11

502

451-0310E

no header Removes the configured header from the current menu or submenu. (The configured header is specified with the header command, which is described on page 496.) Syntax no header Usage Guidelines After the no header command is executed, the default menu header will be used in the menu. The format of the default menu header is as follows: Menu LX Menu where

identifies the submenu number of the menu. The top-level menu always has a submenu number of 1.

For example, the default menu header for the top-level menu is Menu 1 LX Menu. Example no header

451-0310E

503

no menu continue string Removes (deletes) the continue string from the current menu or submenu. Syntax no menu continue string Example no menu continue string

504

451-0310E

no menu prompt Removes (deletes) the prompt from the current menu or submenu. Syntax no menu prompt Example no menu prompt

451-0310E

505

open Opens a new or existing menu file, and closes the current menu file. Syntax open NAME Where

Means

NAME

The name of the menu that is to be opened for editing.

Usage Guidelines If you have made any changes to the current menu, the following prompt will be displayed when you execute the open command: The Menu has been modified. Do you want to save your changes? (y/n) : Enter y to save your changes to the current menu. Enter n to abandon your changes to the current menu. Example open finance_menu

506

451-0310E

save Saves the current menu file. Syntax save [] Where

Means

filename

The filename under which the current menu file is to be saved. If no filename is specified, it will be saved to the filename of the current menu file.

Example save save finance_menu

451-0310E

507

Chapter 13 Notification Commands

The Notification commands are executed in the Notification command mode. When the LX unit is in the Notification command mode, the Notification command prompt (e.g., Notification:0 >>) is displayed on the terminal screen. The format of the Notification command prompt is as follows: Notification: >> where

identifies the current session number.

To enter the Notification command mode, execute the notification command in the Configuration command mode. The notification command is described on page 186.

451-0310E

509

end When the end command is issued in the Notification command mode, it returns the user to the Superuser command mode. Syntax end Usage Guidelines The end command can be issued in all of the LX command modes except for User and Superuser. Executing the end command always returns the user to the Superuser command mode. Example end

510

451-0310E

exit Returns the user to the previous command mode. For example, if the current command mode is Notification, issuing this command will return the user to the Configuration command mode. Syntax exit Usage Guidelines The exit command can be issued in all of the LX command modes. However, the effect of the exit command varies, depending on the command mode from which it is issued. For example, issuing the exit command in the Notification command mode returns the user to the Configuration command mode; issuing the exit command in the Configuration command mode returns the user to the Superuser command mode, and so on. Issuing the exit command in the User command mode exits the LX CLI and closes the connection to the LX unit. Example exit

451-0310E

511

message facility Specifies the facility of a configurable syslogd messages. To display the configurable messages, refer to “show notification message” on page 104. Syntax message NUMBER facility user|syslog|kern|daemon|authpriv Where

Means

NUMBER

The ID number of a configurable syslogd message. This can be any integer number from 1 through 40.

user

The message applies to the User processes.

syslog

The message applies to the syslog daemon (syslogd).

kern

The message applies to the Linux kernel.

daemon

The message applies to a system daemon, such as in.ftpd.

authpriv

The message applies to the Superuser authentication process.

Examples message 1 facility user message 2 facility syslog message 3 facility kern message 4 facility daemon message 5 facility authpriv

512

451-0310E

message priority Specifies the priority of a configurable syslogd messages. To display the configurable messages, refer to “show notification message” on page 104. Syntax message NUMBER priority emerg|alert|critical|error|notice|sigsnotice|info Where

Means

NUMBER

The ID number of a configurable syslogd message. This can be any integer number from 1 through 40.

emerg

The message indicates a severe condition. This is the kind of condition that can immediately affect the users’ ability to work on the LX.

alert

The message indicates a condition that the system administrator needs to correct immediately, such as a corrupted system database.

critical

The message indicates a critical condition, such as a hard device error.

error

The message indicates a software error condition.

notice

The message indicates a condition which is not an error, but which might require specific procedures to adjust it.

warning

This message indicates a warning condition.

info

The message is a normal, informational message.

Examples message 1 priority emerg message 2 priority alert message 3 priority critical message 4 priority error message 5 priority notice message 6 priority info

451-0310E

513

message string Specifies the string portion of a configurable syslogd messages. To display the configurable messages, refer to “show notification message” on page 104. Syntax message NUMBER string Where

Means

NUMBER

The ID number of a configurable syslogd message. This can be any integer number from 1 through 40.

text

The string portion of the configurable syslogd message. This string can contain up to 48 characters.

Example message 1 string New CLI mode entered by

514

451-0310E

no Deletes Service Profiles and User Profiles. (Service Profiles and User Profiles are used in the Notification Feature.) Syntax no serviceprofile|userprofile |all Where

Means

serviceprofile

Delete the Service Profile specified in this command.

userprofile

Delete the User Profile specified in this command.

name

The name of the Service Profile, or User Profile, that is to be deleted.

all

Delete all Service Profiles, or all User Profiles.

Examples no serviceprofile FinanceServerprof2 no serviceprofile all no userprofile Philpager no userprofile all

451-0310E

515

serviceprofile async port Specifies the asynchronous port(s) for a Service Profile of the ASYNC type. Syntax serviceprofile async port |all|none Where

Means

name

The name of a Service Profile of the ASYNC type. Refer to the serviceprofile protocol command on page 524 for more information on configuring a Service Profile as ASYNC.

async_list

Specifies the LX asynchronous port(s) to which syslogd will send the log messages. In order to specify asynchronous port(s) in this field, the Service Profile in the name field must be configured as ASYNC. Refer to the serviceprofile protocol command on page 524 for more information on configuring a Service Profile as ASYNC. If more than one asynchronous port is specified, they should be separated by blank spaces; for example, 2 3 5 6. Note: You cannot specify port 0 in this command.

all

Log messages will be sent to all asynchronous ports on the LX unit.

none

Log messages will not be sent to any asynchronous ports on the LX unit.

Examples serviceprofile Lab3port2 async port 2 serviceprofile Lab3port2-5 async port 2 3 4 5 serviceprofile Lab3port2 async port all serviceprofile Lab3port2 async port none

516

451-0310E

serviceprofile bits Specifies the bits-per-byte setting for a Service Profile of the TAP type. Syntax serviceprofile bits NUMBER Where

Means

name

A Service Profile of the TAP type. Refer to the serviceprofile protocol command on page 524 for more information on configuring a Service Profile as TAP.

NUMBER

Specifies the number of bits per byte that must be supported on any modem port that is included in this Service Profile. The allowable values are 5 - 8. The default value is 8.

Example serviceprofile Center10 bits 6

451-0310E

517

serviceprofile driver Specifies the web driver for a Service Profile of the WEB type. Syntax serviceprofile driver Where

Means

name

A Service Profile of the WEB type. Refer to the serviceprofile protocol command on page 524 for more information on configuring a Service Profile of the WEB type.

drivername

Specifies the web driver that will be used to send a log message through a web interface. The allowable values are ATT_WEB, CELLNET_WEB, CINGULAR_WEB, ORANGE_WEB, PAGENET_WEB, PROXIMUS_WEB, and VERIZON_WEB.

Usage Guidelines The date and time should be set for the LX unit. (If the date and the time are not set, some wireless providers will reject the message.) The date and time are set with the date and clock commands in the Configuration Command Mode. For more information, see the date command on page 168 and the clock command on page 165. Examples serviceprofile InternetATT driver ATT_WEB serviceprofile InternetORANGE driver ORANGE_WEB

518

451-0310E

serviceprofile file Specifies the file to which log messages are to be sent for a Service Profile of the Localsyslog type. Syntax serviceprofile file Where

Means

name

A Service Profile of the Localsyslog type. Refer to the serviceprofile protocol command on page 524 for more information on configuring a Service Profile as Localsyslog.

filename

Specifies the name of the file to which the log messages are to be sent. This file resides in the /var/log directory of the LX unit.

Example serviceprofile LabUnit3 file ricklog.txt

451-0310E

519

serviceprofile host Specifies the destination host for a Service Protocol of the Remotesyslog type. Syntax serviceprofile host Where

Means

name

A Service Profile of the Remotesyslog type. Refer to the serviceprofile protocol command on page 524 for more information on configuring a Service Profile as Remotesyslog.

hostname

Specifies the host to which the log messages are to be forwarded. The host can be specified as an IP Address or as any symbolic name that can be resolved by DNS.

Usage Guidelines After you have specified the remote host with the serviceprofile host command, you must configure the remote host to serve as a destination host for log messages. Do the following: 1. Add the following entry to the /etc/syslog.conf file on the remote host: user.warning

/tftpboot/test/user.warning.log

2. Create an empty log file on the remote host: #touch /tftpboot/test/user.warning.log #chmod 777 /tftpboot/test/user.warning.log 3. Restart the syslog daemon on the remote host: # ps –ef|grep syslog # kill –HUP pid# Example serviceprofile Mapleprof host 140.76.45.123

520

451-0310E

serviceprofile modem port Specifies the modem ports for a Service Profile of the TAP type. Syntax serviceprofile modem port |all|none Where

Means

name

A Service Profile of the TAP type. Refer to the serviceprofile protocol command on page 524 for more information on configuring a Service Profile as TAP.

port_list

Specifies the modem port(s) that syslogd can dial out to send a log message via TAP. If more than one asynchronous port is specified, they should be separated by blank spaces; for example, 2 3 5 6. The modem ports that are specified in this field must support the bits-per-byte setting of the Service Profile. Refer to serviceprofile bits on page 517 for information on specifying the bits-per-byte setting for a Service Profile. Refer to the serviceprofile bits command on page 517 for information on setting the bits-per-byte setting for a modem port.

all

All modem ports on the LX unit can be dialed to send a message via TAP.

none

None of the modem ports on the LX unit can be dialed to send a message via TAP.

Examples serviceprofile Center10 modem port 4 serviceprofile Centers11and12 modem port 2 3 5 6

451-0310E

521

serviceprofile parity Specifies the bit parity characteristic for a Service Profile of the TAP type. Syntax serviceprofile parity Where

Means

name

A Service Profile of the TAP type. Refer to the serviceprofile protocol command on page 524 for more information on configuring a Service Profile as TAP.

priority_setting

Specifies the bit parity that must be used by a modem port in order to send log messages with the TAP protocol. The allowable values are odd, even, and none. The default value is none. Refer to the parity command on page 343 for information on specifying the bit parity of a port.

Examples serviceprofile Center10 parity odd serviceprofile Center11 parity even serviceprofile Center12 parity none

522

451-0310E

serviceprofile port Specifies an optional TCP port for a Service Profile of the SNPP type. Syntax serviceprofile port Where

Means

name

A Service Profile of the SNPP type. Refer to the serviceprofile protocol command on page 524 for more information on configuring a Service Profile as SNPP.

tcp_port

Specifies a TCP port on the provider’s SNPP server. The LX syslogd will send log messages to this TCP port. The Service Profile in the name field must be configured as SNPP. Refer to the serviceprofile protocol command on page 524 for more information on configuring a Service Profile as SNPP.

Examples serviceprofile FinanceServerprof2 port 7777

451-0310E

523

serviceprofile protocol Creates a new Service Profile. A Service Profile specifies the method and means for sending log messages to a destination. Syntax serviceprofile protocol snpp|web|tap|snmp|localsyslog|remotesyslog |async|smtp Where

Means

name

Specifies the name of the Service Profile. The name can be any text string of up to 20 characters.

snpp

Specifies that the Service Profile will use the Simple Network Pager Protocol (SNPP) as the method for sending log messages.

web

Specifies that the Service Profile will use the Web protocol as the method for sending log messages.

tap

Specifies that the Service Profile will use the Telocator Alphanumeric Protocol (TAP) as the method for sending log messages.

snmp

Specifies that the Service Profile will use the Simple Network Management Protocol (SNMP) as the method for sending log messages.

localsyslog

Specifies that the Service Profile will send log messages to a local file on the LX unit.

remotesyslog

Specifies that the Service Profile will send log messages to syslogd on a remote host.

async

Specifies that the Service Profile will send log messages to an outbound asynchronous ports on the LX unit.

smtp

Specifies that the Service Profile will use the Simple Mail Transfer Protocol (SMTP) to send log messages to an email address.

Usage Guidelines This command defines a method (i.e., SNPP, Web protocol, TAP etc.) that will be used to send messages. However, a Service Profile is not fully defined until its means for sending messages have been specified. After you have created a Service Profile with the serviceprofile protocol command, do the following to specify the means that it will use to send the messages: •

For Service Profiles of the SNPP type: 1. Execute the serviceprofile server command (see page 527) to specify the SNPP server that will be used to send messages to the destination. 2. Execute the serviceprofile port command (see page 523) to specify the LX TCP port that will be used to send messages to the SNPP server.

524

451-0310E

serviceprofile protocol (continued) •

For Service Profiles of the Web type, execute the serviceprofile driver command (see page 518) to specify the web driver that is used to send the message through a web interface.

•

For Service Profiles of the TAP type: 1. Execute the serviceprofile smsc command (see page 528) to specify the Short Message Service Center (SMSC) that will be used to send the log messages to the user. 2. Execute the serviceprofile bits command (see page 517) to specify the bits per byte that must be supported by the provider’s application that is specified in a User Profile based on this Service Profile. 3. Execute the serviceprofile stopbits command (see page 530) to specify the stopbits that must be supported by the provider’s application that is specified in a User Profile based on this Service Profile. 4. Execute the serviceprofile parity command (see page 522) to specify the bit parity that must be used by the provider’s application that is specified in a User Profile based on this Service Profile.

•

For Service Profiles of the SMTP type, execute the serviceprofile server command (see page 527) to specify the SMTP server that will be used to send messages to the destination.

•

For Service Profiles of the SNMP type, create an SNMP trap client for the LX unit. The log messages will be sent to all of the SNMP trap clients of the LX unit. To create an SNMP trap client, execute the following commands in the SNMP Command Mode: •

trap client (see page 423)

•

trap client community (see page 424)

•

trap client version (see page 425)

•

For Service Profiles of the Localsyslog type, execute the serviceprofile file command (see page 519) to specify the local file to which messages will be sent.

•

For Service Profiles of the Async type, execute the serviceprofile async port command (see page 516) to specify the outbound asynchronous port to which messages will be sent.

•

For Service Profiles of the Remotesyslog type, execute the serviceprofile host command (see page 520) to specify the remote host to which the log messages are sent.

451-0310E

525

serviceprofile protocol (continued) Examples serviceprofile skytel protocol snpp serviceprofile labunit protocol local serviceprofile port4 protocol async serviceprofile internetATT protocol web serviceprofile Center10 protocol tap serviceprofile Lab3snmp protocol snmp serviceprofile Lab3billtxt protocol localsyslog serviceprofile Mapleprof protocol remotesyslog serviceprofile emailprof protocol smtp

526

451-0310E

serviceprofile server Specifies the server for a Service Profile of the SMTP or SNPP type. NOTE: In order to execute this command, you must have already configured the Domain Name suffix, Local DNS Address, and IP parameters for the LX unit. Syntax serviceprofile server Where

Means

name

A Service Profile of the SMTP or SNPP type. Refer to the serviceprofile protocol command on page 524 for more information on configuring a Service Profile as SMTP or SNPP.

server_name

Specifies the server to which syslogd will send the log messages. The messages will be forwarded from the server to the user. The server can be specified as an IP Address or as any symbolic name that can be resolved by DNS.

Examples serviceprofile emailprof server 118.28.118.34 serviceprofile newsnpp1 server snpp.skytel.com

451-0310E

527

serviceprofile smsc Specifies the Short Message Service Center (SMSC) for a Service Profile of the TAP type. Syntax serviceprofile smsc Where

Means

name

A Service Profile of the TAP type. Refer to the serviceprofile protocol command on page 524 for more information on configuring a Service Profile as TAP.

tel_num

Specifies the telephone number of the SMSC to which the notification is to be sent. The telephone number must contain at least 10 digits. The maximum length of the telephone number is 20 digits. Note: Your modem settings for bits-per-second, stopbits, and parity are not required to match those of your SMSC provider.

Usage Guidelines Now configure the LX modem port that will be used for sending messages. In the following example, the required settings are specified on port 17: Config>>port async 17 Async 17>>no apd Async 17>>access remote Async 17>>modem Modem>>modem enable Modem>>type dialout A list of wireless SMSC phone numbers is provided here for your convenience: Carrier

SMSC Number

Email Address SMSC Phone#@

AT&T 7, 1, e

800-841-8837

@mobile.att.net

Cingular 7, 1, e

800-909-4602

@Cingular.com

Nextel 7, 1, e

801-301-6683

@messaging.nextel.com

Sprint 7, 1, e

888-656-1727

@sprintpcs.com

Verizon 7, 1, e, 8, 1, n

866-823-0501

@vtext.com

Skytel 8, 1, n

800-679-2778

[email protected]

NOTE: MRV Communications is not responsible for these SMSC phone numbers and cannot guarantee their service. Please contact your provider for a number near you.

528

451-0310E

serviceprofile smsc (continued) Example userprofile servicecenter3 smsc 3776809977

451-0310E

529

serviceprofile stopbits Specifies the stop bits characteristic for a Service Profile of the TAP type. Syntax serviceprofile stopbits NUMBER Where

Means

name

A Service Profile of the TAP type. Refer to the serviceprofile protocol command on page 524 for more information on configuring a Service Profile as TAP.

NUMBER

Specifies the number of stop bits for the Service Profile. The allowable values are 1 or 2. The default value is 1. Refer to the stopbits on page 356 for information on setting the stop bits for a port.

Example serviceprofile Center10 stopbits 2

530

451-0310E

userprofile contact Specifies the contact information for a User Profile. Contact information must be specified for any User Profile that is associated with a Service Profile of the Web, SNPP, SMTP, or TAP type. Syntax userprofile contact Where

Means

name

Specifies the name of a User Profile. (The User Profile must be one that is associated with a Service Profile of the Web, SNPP, or TAP type.)

contact_name

Specifies the contact information for the User Profile. (The contact information is the telephone number, pager ID, or email address to which the log messages will be sent.) The content of this field depends on the type of the Service Profile that is associated with the User Profile. If the associated Service Profile is of the SMTP type, this field must contain an email address. If the associated Service Profile is of the Web, SNPP, or TAP type, this field can contain a pager ID or a telephone number. The pager ID must consist of between 1 and 35 digits.

Examples userprofile PhilWilliams contact 167451 userprofile JohnSmith contact 3995987642 userprofile JaneWalton contact 3996541276 userprofile NormanWillis contact [email protected]

451-0310E

531

userprofile facility Specifies the facility characteristic for a User Profile. Only those log messages that originate from a Linux facility that matches this characteristic will be sent to the user. Syntax userprofile facility Where

Means

name

Specifies the name of a User Profile.

facility_char

Specifies the facility characteristic for the User Profile. The allowable values are authpriv, daemon, kern, syslog, user, and all.

Examples userprofile PhilWilliams facility all userprofile JohnSmith facility authpriv userprofile JaneWalton facility daemon userprofile NormanWillis facility kern

532

451-0310E

userprofile priority Specifies the priority characteristic for a User Profile. Only those log messages that match this priority level will be sent to the user. Syntax userprofile priority emerg|alert|critical|error|notice|info |warning|sigsnotice Where

Means

name

Specifies the name of a User Profile.

emerg

Only messages with a priority of emerg will be sent to the user. Messages with this priority indicate a condition that can immediately affect the users’ ability to work on the LX.

alert

Only messages with a priority of alert will be sent to the user. Messages with this priority indicate a condition that the system administrator needs to correct immediately, such as a corrupted system database.

critical

Only messages with a priority of critical will be sent to the user. Messages with this priority indicate a critical condition, such as a hard device error.

error

Only messages with a priority of error will be sent to the user. Messages with this priority indicate a software error condition.

notice

Only messages with a priority of notice will be sent to the user. Messages with this priority indicate a condition which is not an error, but which might require specific procedures to adjust it.

info

Only messages with a priority of info will be sent to the user. These are normal, informational messages.

warning

Only messages with a priority of warning will be sent to the user.

sigsnotice

Only messages with a priority of sigsnotice will be sent to the user. Messages with this priority indicate a state transition of the serial input signals CTS or DCD/DSR. Note: When this priority is specified, the facility for the User Profile must be set to kern. Refer to “userprofile facility” on page 532 to set the facility for a User Profile to kern.

Examples userprofile JohnSmith priority info userprofile JaneWalton priority notice userprofile NormanWillis priority warning

451-0310E

533

userprofile serviceprofile Creates a new User Profile or changes the Service Profile associated with an existing User Profile. Syntax userprofile serviceprofile Where

Means

name

Specifies the name of a new or existing User Profile. The name can be any text string of up to 20 characters. Note: The LX unit supports a maximum of 20 User Profiles.

service_profile_name

Specifies the name of a fully defined Service Profile. For information on creating a fully defined Service Profile, refer to the “Usage Guidelines” for the userprofile contact command (see page 531).

Usage Guidelines After a User Profile has been created, a facility characteristic and a priority characteristic can be specified for it. For more information, refer to userprofile facility on page 532 and userprofile priority on page 533. You must define a contact field for a User Profile that is based on a Service Profile of the SNPP, SMTP, TAP, or WEB type. For more information, refer to the userprofile contact command on page 531. Examples userprofile PhilWilliams serviceprofile internetATT userprofile JohnSmith serviceprofile Center10 userprofile JaneWalton serviceprofile emailprof

534

451-0310E

Chapter 14 Broadcast Group Commands

The Broadcast Group commands are executed in the Broadcast Group command mode. When the LX unit is in the Broadcast Group command mode, the Broadcast Group command prompt (e.g., BrGroups 6:0 >>) is displayed on the terminal screen. The format of the Broadcast Group command prompt is as follows: BrGroups : >> where

identifies the Broadcast Group under configuration. identifies the current session number.

To enter the Broadcast Group command mode, execute the broadcast group command in the Configuration command mode. The broadcast group command is described on page 163.

451-0310E

535

end When the end command is issued in Broadcast Group Mode, it returns the user to the Superuser command mode. Syntax end Usage Guidelines The end command can be issued in all of the LX Command Modes except for User and Superuser. Executing the end command always returns the user to the Superuser command mode. Example end

536

451-0310E

exit Returns the user to the previous command mode. For example, if the current command mode is the Broadcast Group Command Mode, issuing this command will return the user to the Configuration command mode. Syntax exit Usage Guidelines The exit command can be issued in all of the LX Command Modes. However, the effect of the exit command varies, depending on the mode from which it is issued. As noted above, issuing the exit command in the Broadcast Group command mode returns the user to the previous command mode. The same goes for issuing the exit command in any command mode other than User. For example, issuing the exit command in the Menu Editing command mode returns the user to the Menu command mode; issuing the exit command in the Configuration command mode returns the user to the Superuser command mode, and so on. Issuing the exit command in the User command mode exits the LX CLI and closes the connection to the LX unit. Example exit

451-0310E

537

master port Specifies the asynchronous port(s), or TCP port(s), that are to be used as Master Port(s) for the Broadcast Group under configuration. The Master Port is the port from which all input for a Broadcast Group is sent to the Slave Ports. NOTE: To prevent data overruns, it is recommended that the Master Port(s) and Slave Port(s) in a Broadcast Group be set to the same port speed. Syntax master port async|tcp [timestamp] Where

Means

async

An asynchronous port, or asynchronous ports, will be specified as the Master Port(s) for the Broadcast Group under configuration.

tcp

A TCP port, or TCP port(s), will be specified as the Master Port(s) of the Broadcast Group under configuration. The allowable values are 1024 65535.

port_list

Specifies the asynchronous port(s), or TCP port(s), that will be used as the Master Port(s) for the Broadcast Group under configuration. If more than one port is specified, they should be separated by blank spaces; for example, 2 3 5 6. Note: You cannot specify the DIAG port (port 0) as a Master Port. A maximum of 20 ports, including Masters and Slaves, can be configured for a Broadcast Group. A maximum of two TCP ports can be configured for a Broadcast Group.

timestamp

Specifies that a timestamp will be appended at the beginning of each new line of data. This option can only be applied after the Master Port has been created.

Usage Guidelines The following cannot be specified as Master Ports: •

Any port that belongs to another Broadcast Group

•

A TCP port that is already in use

•

A port that is configured as a Slave Port in any Broadcast Group

At most, one TCP socket may be open on a single TCP port. Examples master port async 5 6 8 master port tcp 1500

538

451-0310E

mode Specifies the Telnet mode for the Broadcast Group under configuration. Syntax mode line|character Where

Means

line

The Broadcast Group will use Telnet line mode.

character

The Broadcast Group will use Telnet character mode.

Examples mode line mode character

451-0310E

539

no master port Removes a Master Port, or Master Ports, from the Broadcast Group under configuration. Syntax no master port async|tcp Where

Means

async

Remove asynchronous Master Port(s) from the Broadcast Group under configuration.

tcp

Remove TCP Master Port(s) from the Broadcast Group under configuration. The allowable values are 1024 - 65535.

port_list

Specifies the asynchronous port(s), or TCP port(s), that are being removed from the Broadcast Group under configuration. If more than one port is specified, they should be separated by blank spaces; for example, 2 3 5 6.

Examples no master port async 5 no master port async 5 6 8 no master port tcp 1500 2500 no master port tcp 1500 2500

540

451-0310E

no slave port Removes a Slave Port, or Slave Ports, from the Broadcast Group under configuration. Syntax no slave port async|tcp Where

Means

async

Remove asynchronous Slave Port(s) from the Broadcast Group under configuration.

tcp

Remove TCP Slave Port(s) from the Broadcast Group under configuration.

port_list

Specifies the asynchronous port(s), or TCP port(s), that are being removed from the Broadcast Group under configuration. If more than one port is specified, they should be separated by blank spaces; for example, 2 3 5 6.

Examples no slave port async 5 no slave port async 2 5 6 7 no slave port tcp 1500 no slave port tcp 1500 2500

451-0310E

541

no slave port discard Removes the discard setting from a Slave Port, or Slave Ports, in the Broadcast Group under configuration. Syntax no slave port async|tcp discard Where

Means

async

Remove the discard setting from asynchronous Slave Ports.

tcp

Remove the discard setting from TCP Slave Ports.

port_list

Specifies the asynchronous port(s), or TCP port(s), for which the discard setting is being removed. If more than one port is specified, they should be separated by blank spaces; for example, 2 3 5 6.

Examples no slave port async 5 discard no slave port async 2 5 6 7 discard no slave port tcp 1500 discard no slave port tcp 1500 2500 discard

542

451-0310E

no slave port localecho Removes the localecho setting from a Slave Port, or Slave Ports, in the Broadcast Group under configuration. Syntax no slave port async|tcp localecho Where

Means

async

Remove the localecho setting from asynchronous Slave Ports.

tcp

Remove the localecho setting from TCP Slave Ports.

port_list

Specifies the asynchronous port(s), or TCP port(s), for which the localecho setting is being removed. If more than one port is specified, they should be separated by blank spaces; for example, 2 3 5 6.

Examples no slave port async 5 localecho no slave port async 2 5 6 7 localecho no slave port tcp 1500 localecho no slave port tcp 1500 2500 localecho

451-0310E

543

slave port Specifies the asynchronous port(s), or TCP port(s), that are to be used as Slave Port(s) for the Broadcast Group under configuration. The Slave Ports receive data from the Master Port and send all of their data to the Master Port. NOTE: To prevent data overruns, it is recommended that the Slave Port(s) and Master Port(s) in a Broadcast Group be set to the same port speed. Syntax slave port async|tcp discard|localecho Where

Means

async

An asynchronous port, or asynchronous ports, will be specified as the Slave Port(s) for the Broadcast Group under configuration.

tcp

A TCP port, or TCP port(s), will be specified as the Slave Port(s) of the Broadcast Group under configuration. The allowable values are 1024 65535.

port_list

Specifies the asynchronous port(s), or TCP port(s), that will be used as the Slave Port(s) for the Broadcast Group under configuration. If more than one port is specified, they should be separated by blank spaces; for example, 2 3 5 6. Note: You cannot specify the DIAG port (port 0) as a Slave Port. A maximum of 20 ports, including Masters and Slaves, can be configured for a Broadcast Group. A maximum of two TCP ports can be configured for a Broadcast Group.

discard

The port(s) specified in this command will discard any data that comes into them.

localecho

The port(s) specified in this command will echo any data that comes into them.

Usage Guidelines The following cannot be specified as Slave Ports: •

Any port that belongs to another Broadcast Group

•

A TCP port that is already in use

•

A port that is configured as a Master Port in any Broadcast Group

At most, one TCP socket may be open on a single TCP port. Examples slave port async 5 discard

544

451-0310E

slave port (continued) slave port async 2 5 6 7 discard slave port async 5 localecho slave port async 2 5 6 7 localecho slave port tcp 1500 discard slave port tcp 1500 2500 discard slave port tcp 1500 localecho slave port tcp 1500 2500 localecho

451-0310E

545

INDEX

A access command 308 access console enable command 368 access port command 369 access power model command 309 access ssh enable command 370 access telnet enable command 371 access web enable command 372 accounting enable command 448 address command 276 apd enable command 310 apd retry command 311 apd signature command 312 apd timeout command 313 Async command mode 307 Async command prompt 307 Async mode exiting from Async mode 335, 336 asynchronous ports APD settings, defaulting 330 Asynchronous Protocol Detection (APD), enabling 310 autobaud, enabling 317 autodial, enabling 319 autohangup, enabling 320 bits per character, configuring 322 break enabling 323 break sequence, defining 324 configuring APD retries 311 configuring authentication 314 configuring autobaud retries 318 configuring the access method 308, 309 configuring the APD signature 312 configuring the APD timeout 313 connect commands, specifying 325 data buffer display options 326 data buffer size, configuring 327 data buffer size, defaulting 331 databuffer syslog, enabling 328 databuffer timestamp, enabling 329 description, specifying 340 flow control, specifying 337

451-0310E

login banners, creating 321 Modem Control, enabling 339 parity bit, specifying 343 port prompt, specifying 350 port speed, defaulting 334 port speed, specifying 355 settings, defaulting 332 stop bits, specifying 356 audit log enable command 373 authentication command 314, 449 authentication fallback enable command 277, 316 authentication local enable command 278 authentication none command 279 authentication radius enable command 280 authentication securid enable command 281 authentication tacacs+ enable command 282 Authentication, disabling 279 autobaud enable command 317 autobaud retry command 318 autodial enable command 319 autohangup enable command 320 B backward_switch command 374 banner command 321 bits command 322 boot configuration from flash command 160 boot configuration from name command 161 boot configuration from network command 162 break enable command 323 break special command 324 broadcast command 283 broadcast group command 163 Broadcast Group command mode 535 Broadcast Group command prompt 535 broadcast group enable command 164 Broadcast Group mode, exiting from Broadcast Group mode 536, 537 Broadcast Group settings Telnet mode, specifying 539 Broadcast Groups

547

discard setting, removing from a slave port 542 localecho setting, removing from a slave port 543 master port, removing 540 master port, specifying 538 slave port, removing 541 slave ports, specifying 544 C ccp enable command 450 clear command 34, 66 clock command 165 Clock. See System clock. Command Editing mode exiting from Command Editing mode 495 command log enable command 375 command syntax 22 configuration command 67 Configuration command mode 159 Configuration command mode, entering 67 Configuration command prompt 159 Configuration mode exiting from Configuration mode 175, 176 configuration, saving the 80 connect command command 325 contact command 410 control key command 488 copy port command 166 copy subscriber command 167 D databuffer display command 326 databuffer size command 327 databuffer syslog enable command 328 databuffer timestamp enable command 329 date command 168 Debug information displaying for ports 83, 90 displaying for subscribers 91 generating for asynchronous ports 68 generating for SNMP 69 generating for subscribers 70 debug port async ppp command 68 debug snmp command 69 debug subscriber command 70 dedicated service command 376 default access port command 377

548

default access remote command 378 default apd command 330 default authentication command 451 default backward_switch command 379 default boot command 169 default configuration command 170 default databuffer size command 331 default dialback retry command 380 default forward_switch command 381 default idletime command 382 default initstring command 438 default ipcp command 452 default lcp compression command 453 default lcp echo failure command 454 default lcp failure limit command 455 default lcp timeout command 456 default local_switch command 383 default log size command 171 default mode client username command 457 default mtu command 284, 458 default outlet group off time command 172 default port command 332 default power off time command 333 default remote address command 459 default rotary command 285 default speed command 334 default ssh keepalive command 286 default ssh log level command 384 default ssh port command 287 default telnet port command 288 default tftp command 173 default v3 client command 411 Defaulting the LX unit 170 delete command 480 description command 362 Device information displaying 92 dialback enable command 385 Dialback feature. See Subscriber settings, dialback. dialback number command 386 dialback retry command 387 dialout number command 439 disconnect command 35, 71 display command 489 Displays broadcast group information 85 command log 87

451-0310E

configuration log 89 date and time 41, 86 device 92 device information 94 global system configuration 139 interface information 95, 97, 99, 100, 101 IP information 125 logged-in users 149 pattern-matching characteristics 111 port debug 90 ppciboot configured load settings 141 Radius information 120, 122, 124 SecurID information 126, 128, 129 SNMP information 132, 133 subscriber debug 91 Superuser-mode broadcast groups 84 Superuser-mode port 108, 109, 110, 112, 113, 114, 115, 116, 117, 119 Superuser-mode services display 130 Superuser-mode session display 131 Superuser-mode subscriber displays 137, 138 System configuration table 88 system status 142 User-mode port displays 42, 55, 137, 138 User-mode services display 53 User-mode session display 54 User-mode subscriber displays 55 User-mode versions display 61, 150 domain name command 174 domain name, specifying the 174 E enable command 36 end command 175, 289, 335, 363, 388, 412, 440, 460, 481, 490, 510, 536 entry command 491 entry command command 492 entry label command 493 entry menu command 494 Ethernet command mode 361 Ethernet command mode, entering 195 Ethernet command prompt 361 Ethernet mode, exiting from Ethernet mode 363, 364 Ethernet port description, removing 365 Ethernet ports duplex mode, specifying 366

451-0310E

port description, specifying 362 speed, specifying 366 exit command 37, 72, 176, 290, 336, 364, 389, 413, 441, 461, 482, 495, 511, 537 F Fallback feature, enabling 277, 316 Features, disabling Async Port command mode 341 in Superuser mode 74 Menu command mode 485 Modem command mode 443 PPP command mode 476, 515 Subscriber command mode 395 features, disabling Configuration command mode 185 Interface command mode 293 SNMP command mode 419 User-mode features 38 finger daemon. See fingerd. fingerd enable command 177 fingerd, enabling 177 flowcontrol command 337 forward_switch command 390 G gateway command 178 get client command 414 get client community command 415 get client version command 416 H header command 496 Help. See Online help. host name, configuring the 179 hostname command 179 how port async ppp command 112 I iboot file changing 160, 161, 162 resetting to default 169 idletime command 391 import command 483 initstring command 442 interface command 180 Interface command mode 275 Interface command prompt 275

549

Interface mode entering 180 exiting from Interface mode 289, 290 Interface parameters, setting Broadcast Address 283 Maximum Transmission Unit (MTU) size 292 MTU size 284 rotary parameters 285 SSH UDP port 287 subnet mask 291 Telnet UDP port 288 Interface parameters, setting IP Address 276 Interface parameters, SSH keepalive count, specifying 301 Interface parameters, SSH keepalive interval, specifying 302 Interface parameters, SSH keepalive settings, defaulting 286 IP parameters, setting gateway 227 gateway (default route) 178 Primary Domain Name Server (DNS) 204 Secondary DNS 229 static route 226 subnet mask 228 ipcp accept address enable command 462 ipcp compression enable command 463 ipcp failure limit command 464 ipcp timeout command 465 iptables command 181 L lcp compression enable command 466 lcp echo failure command 467 lcp echo interval command 468 lcp failure limit command 469 lcp timeout command 470 Linux shell, entering the 82 list command 484, 497 local address command 471 Local authentication, enabling 278 local_switch command 392 location command 182, 417 log enable command 418 log file sizes resetting to default 171 specifying 183

550

log size command 183 Logging out a device 73 Logging out a subscriber 73 Logging out an LX port 73 logout command 73 logs, resetting the 156 LX CLI, exiting the 37 LX software, updating 154 M mask command 291 master port command 538 maxsubscriber command 393 menu command 184, 498 Menu command mode 479 Menu command prompt 479 menu continue string command 499 Menu Editing command prompt 487 Menu Editing mode 487 exiting from Menu Editing mode 490 menu enable command 394 Menu mode exiting from Menu mode 481, 482 Menu mode, entering 184 menu prompt command 500 Menus accessing submenus 498 control keys, assigning 488 control keys, removing 501 creating a Menu header 496 creating entries 492, 493, 494 deleting 480 displaying 489 displaying an entry 491 listing the menus 484 listing the submenus 497 merging menus 483 modifying entries 491, 492, 493, 494 opening a menu 486, 506 removing continue strings 504 removing headers 503 removing prompts 505 resetting entries 502 saving menus 507 message facility command 512 message priority command 513 message string command 514 mode client command 472

451-0310E

mode client username command 473 mode command 539 mode server command 474 modem command 338 Modem command mode 437 Modem command prompt 437 modem enable command 339 Modem mode exiting from Modem mode 440, 441 Modem mode, entering 338 Modem settings, configuring dialout retries, specifying 444 initialization string, specifying 442 timeout, specifying 445 type, specifying 446 mtu command 292, 475 N name command 340 Network Time Protocol (NTP) enabling 187 NTP server specifying 188 no command 38, 74, 185, 293, 341, 395, 419, 443, 476, 485, 515 no control key command 501 no description command 365 no entry command 502 no header command 503 no master port command 540 no menu continue string command 504 no menu prompt command 505 no slave port command 541 no slave port discard command 542 no slave port localecho command 543 notification command 186 Notification command mode 509 Notification command mode, entering 186 Notification command prompt 509 Notification mode exiting from Notification mode 510, 511 ntp enable command 187 ntp server address command 188 O off time resetting to default 172, 333 Online help, displaying 30 open command 486, 506

451-0310E

outlet command 75 outlet group command 76, 189 outlet group name command 190 outlet group off time command 191 outlet name command 342 P parity command 343 password command 192, 396 password enable command 193, 397 pattern match enable command 344 Pattern matching enabling 344 pattern string command 345 pause enable command 39, 77, 398 ping command 40, 78 pinging a host in Superuser mode 78 in User mode 40 Point-to-Point Protocol (PPP), configuring accounting, enabling 448 authentication retries, defaulting 451 authentication timeout, defaulting 451 authentication, enabling 449 CCP negotiation, enabling 450 CHAP secret, specifying 472 client mode 472 client mode username 473 IPCP address negotiation 462 IPCP compression, enabling 463 IPCP failure limit, specifying 464 IPCP options, defaulting 452 IPCP timeout, specifying 465 LCP compression, enabling 466 LCP echo failure, specifying 467 LCP echo interval, specifying 468 LCP failure limit, specifying 469 LCP options, defaulting 453, 454, 455, 456 LCP timeout, specifying 470 Local Address, specifying 471 Maximum Transmission Unit (MTU), defaulting 458 MTU size, specifying 475 PAP secret, specifying 472 PPP mode, specifying 474 remote address, specifying 477 port async command 194 Port Async mode, entering 194

551

port configuration, copying the 166 port ethernet command 195 power off time command 347 ppciboot address assignment option command 197 ppciboot address command 196 ppciboot Ethernet network link duplex mode, specifying 198 speed, specifying 198 ppciboot ethernet network link command 198 ppciboot file, updating 154 ppciboot gateway command 199 ppciboot image filename command 200 ppciboot image load from command 201 ppciboot mask command 202 ppciboot tftp server command 203 ppp command 348 PPP command mode 447 PPP command prompt 447 ppp enable command 349 PPP mode enabling 349 entering 348 exiting from PPP mode 460, 461 preferred service command 399 primary dns command 204 prompt command 350, 400 Q Quick Start Configurator. Se setup utility. R Radius Radius accounting, enabling 294, 351 Radius authentication, enabling 280 radius accounting enable command 294, 351 Radius parameters, setting primary accounting server parameters 206, 207, 208, 209, 210 primary authentication server parameters 211, 212, 213, 214, 215 secondary accounting server parameters 216, 217, 218, 219, 220 secondary authentication server parameters 221, 222, 223, 224, 225 Radius parameters, setting the Radius period 205 radius period command 205 radius primary accounting address command 206

552

radius primary accounting port command 207 radius primary accounting retransmit command 208 radius primary accounting secret command 209 radius primary accounting timeout command 210 radius primary server address command 211 radius primary server port command 212 radius primary server retransmit command 213 radius primary server secret command 214 radius primary server timeout command 215 radius secondary accounting address command 216 radius secondary accounting port command 217 radius secondary accounting retransmit command 218 radius secondary accounting secret command 219 radius secondary accounting timeout command 220 radius secondary server address command 221 radius secondary server port command 222 radius secondary server retransmit command 223 radius secondary server secret command 224 radius secondary server timeout command 225 Rebooting the LX. See Re-starting the LX. Related documents 31 reload command 79 remote address command 477 Restarting the LX 79 retry command 444 Rotaries assigning rotary ports 296 assigning SSH sockets 297 assigning TCP sockets 298 enabling 295 port-search method 299 rotary enable command 295 rotary port command 296 rotary ssh port command 297 rotary tcp port command 298 rotary type command 299 route address command 226 route gateway command 227 route mask command 228 S save command 507 save configuration command 80

451-0310E

screen pause enabling in Superuser mode 77 enabling in User mode 39 screen, clearing the in Superuser mode 66 in User mode 34 secondary dns command 229 SecurID SecurID authentication, enabling 281 securid authentication encryption command 230 securid authentication port command 231 securid authentication retransmit command 232 securid authentication timeout command 233 securid authentication version command 234 securid master authentication server address command 235 securid master authentication server name command 236 SecurID parameters, setting authentication port 231 authentication version 234 encryption method 230 master authentication server parameters 235, 236 primary authentication server parameters 237, 238 retries 232 slave authentication server parameters 239, 240 timeout 233 securid primary authentication server address command 237 securid primary authentication server name command 238 securid slave authentication server address command 239 securid slave authentication server name command 240 security level superuser command 401 serial command 300 service command 241 serviceprofile async port command 516 serviceprofile bits command 517 serviceprofile driver command 518 serviceprofile file command 519 serviceprofile host command 520 serviceprofile modem port command 521 serviceprofile parity command 522

451-0310E

serviceprofile port command 523 serviceprofile protocol command 524, 527 serviceprofile smsc command 528 serviceprofile stopbits command 530 session disconnecting in Superuser mode 71 disconnecting in User mode 35 session command 402 set client command 420 set client community command 421 set client version command 422 setup command 81 Setup utility, entering the 81 shell command 82 shell enable command 403 show audit log command 83 show broadcast group characteristics command 84 show broadcast group summary command 85 show clock command 41, 86 show command log command 87 show config command 88 show configuration log command 89 show debug port async ppp command 90 show debug subscriber command 91 show device command 92 show device summary command 94 show interface characteristics command 95 show interface port mapping command 97 show interface rotary command 99 show interface status command 100 show interface summary command 101 show kernel log command 102 show log command 103 show notification message command 104 show notification serviceprofile command 105 show notification userprofile command 106 show outlet group status command 107 show port async apd command 108 show port async characteristics command 109 show port async modem command 110 show port async pattern match characteristics command 111 show port async ppp status command 113 show port async status command 114 show port async summary command 115 show port command 42 show port ethernet characteristics command 116

553

show port ethernet status command 117 show port ethernet summary command 119 show radius characteristics command 120 show radius status command 122 show radius summary command 124 show route command 125 show securid characteristics command 126 show securid status command 128 show securid summary command 129 show service command 53, 130 show session command 54, 131 show snmp characteristics command 132 show snmp client command 133 show snmp v3 command 134 show subscriber command 55, 137 show subscriber summary command 138 show system characteristics command 139 show system ppciboot command 141 show system status command 142 show users command 149 show version command 61, 150 signals syslog enable command 352 slave port command 544 snmp command 242 SNMP command mode 409 SNMP command prompt 409 snmp enable command 243 SNMP mode exiting from SNMP mode 412, 413 SNMP parameters, setting default v3 client 411 SNMP contact 410 SNMP get client 414 SNMP get client community 415 SNMP get client version 416 SNMP location 417 SNMP set client 420 SNMP set client community 421 SNMP set client version 422 SNMP trap client 423 SNMP trap client community 424 SNMP trap client version 425 special break enable command 353 special break string command 354 speed command 355, 366 ssh cipher command 404 ssh command 62, 151 SSH connection

554

from Superuser Mode 151 from User Mode 62 ssh enable command 244 ssh keepalive count command 301 ssh keepalive interval command 302 ssh key command 405 ssh log level command 406 ssh port command 303 SSH sockets assigning to an interface 303 ssh v1 command 245 ssh v2 command 246 statistics data, zeroing the 155 stopbits command 356 subscriber command 247 Subscriber command mode 367 Subscriber command prompt 367 subscriber configuration, copying the 167 Subscriber mode entering 247 exiting from Subscriber mode 388, 389 Subscriber settings access method, specifying a 368, 369, 370, 371, 372 access port, defaulting 377 Backward Switch character, defaulting 379 Backward Switch character, specifying 374 command log, enabling 375 dedicated service, assigning a 376 Dialback retries, defaulting 380 dialback retries, specifying 387 dialback telephone number, specifying 386 dialback, enabling 385 dialout telephone number, specifying 439 Forward Switch character, defaulting 381 Forward Switch character, specifying 390 Inactivity Timeout, defaulting 382 Inactivity timeout, specifying 391 Local Switch character, defaulting 383 Local Switch character, specifying 392 maximum sessions, specifying 402 maximum simultaneous connections, specifying 393 Menu feature, enabling 394 password protection, enabling 397 password, specifying 396 port auditing, enabling 373 preferred service, specifying 399

451-0310E

prompt, specifying 400 screen pause, enabling 398 shell mode, enabling 403 ssh encryption type, specifying 404 ssh key, specifying 405 SSH log level, defaulting 384 ssh log level, specifying 406 Superuser privileges, configuring 401 Telnet mode, specifying 407 terminal type, specifying 408 Superuser command mode 65 Superuser command prompt 65 Superuser mode entering 36 Superuser Mode, exiting 72 Superuser password, specifying 192, 193 System calendar setting the date 168 System clock setting the date and time 273 setting the time 165 T TACACS+ TACACS+ accounting, enabling 304, 357 TACACS+ authentication, enabling 282 tacacs+ accounting enable command 304, 357 TACACS+ parameters, setting primary accounting server parameters 249, 250, 251, 252, 253 primary authentication server parameters 254, 255, 256, 257, 258 secondary accounting server parameters 259, 260, 261, 262, 263 secondary authentication server parameters 264, 265, 266, 267, 268 superuser password request enable 269 TACACS+ parameters, setting the TACACS+ period 248 tacacs+ period command 248 tacacs+ primary accounting address command 249 tacacs+ primary accounting port command 250 tacacs+ primary accounting retransmit command 251 tacacs+ primary accounting secret command 252 tacacs+ primary accounting timeout command 253

451-0310E

tacacs+ primary server address command 254 tacacs+ primary server port command 255 tacacs+ primary server retransmit command 256 tacacs+ primary server secret command 257 tacacs+ primary server timeout command 258 tacacs+ secondary accounting address command 259 tacacs+ secondary accounting port command 260 tacacs+ secondary accounting retransmit command 261 tacacs+ secondary accounting secret command 262 tacacs+ secondary accounting timeout command 263 tacacs+ secondary server address command 264 tacacs+ secondary server port command 265 tacacs+ secondary server retransmit command 266 tacacs+ secondary server secret command 267 tacacs+ secondary server timeout command 268 tacacs+ superuser password request enable command 269 telnet break string command 358 telnet command 63, 152 Telnet connection from Superuser Mode 152 from User Mode 63 telnet enable command 270 telnet mode command 407 telnet negotiation enable command 359 telnet port command 305 Telnet sockets assigning to an interface 305 terminal command 64, 153, 408 Terminal type setting in Superuser mode 153 setting in User mode 64 tftp command 271 tftp retry resetting to default 173 tftp timeout resetting to default 173 Time Daemon. See timed timed enable command 272 timed, enabling 272 timeout command 445 timezone command 273 transparency enable command 360

555

trap client command 423 trap client community command 424 trap client version command 425 type command 446 typographical conventions 22 U update command 154 User command mode 33 User command prompt 33 userprofile contact command 531 userprofile facility command 532 userprofile priority command 533 userprofile serviceprofile command 534 V v3 client access context match command 426 v3 client access context prefix command 427 v3 client access read view command 428 v3 client access security command 429 v3 client access write view command 430 v3 client group security model command 431 v3 client name command 432 v3 client security community command 433 v3 client security source command 434 v3 client view command 435 v3 engine command 436 W web_server enable command 274 Z zero all command 155 zero log command 156 zero securid secret command 157

556

451-0310E