Lantronix EDS16PR Reference Manual

Other manuals for EDS16PR: User Manual, User Manual, User Manual, User Manual
Manual is about: EDS Device Servers/Terminal Servers

Summary of EDS16PR

  • Page 1

    Part number 900-455 revision b january 2007 eds device servers command reference eds4100 eds8pr eds16pr eds32pr.

  • Page 2

    Eds device servers command reference 2 copyright & trademark © 2006, 2007 lantronix. All rights reserved. No part of the contents of this book may be transmitted or reproduced in any form or by any means without the written permission of lantronix. Printed in the united states of america. Ethernet i...

  • Page 3: Contents

    Eds device servers command reference 3 contents 1: introduction 4 2: configuration using telnet or serial port 5 using telnet________________________________________________________ 5 using a serial port ___________________________________________________ 5 navigating the command line interface ____...

  • Page 4: 1: Introduction

    Eds device servers command reference 4 1: introduction eds device servers (eds4100, eds8pr, eds16pr, and eds32pr) contain all the components necessary to deliver full network connectivity to virtually any kind of serial device, a reliable tcp/ip protocol stack, and a variety of remote management cap...

  • Page 5: Using Telnet

    Eds device servers command reference 5 2: configuration using telnet or serial port as an alternative to using web manager, you can configure the eds using a series of commands. You can access this command-line interface (cli) with a telnet session or through a serial port connection to the eds. Thi...

  • Page 6

    2: configuration using telnet or serial port eds device servers command reference 6 navigating the command line interface guidelines commands at the root level (top level) of the cli do not affect current configuration settings. Commands within the enable menu (and its sub-menus) modify the eds’s co...

  • Page 7

    2: configuration using telnet or serial port eds device servers command reference 7 to view the current configuration at any level: type show. The configuration for that menu level displays. To view the list of commands available at the current menu level: at the command prompt, type ?. The list of ...

  • Page 8: 3: Summary of Cli Commands

    Eds device servers command reference 8 3: summary of cli commands the following sections describe the cli commands. The commands are organized as follows: root menu: page 9 enable menu: page 10 chem menu: page 14 configure menu: page 16 interface 1 level menu: page 24 device menu: page 26 filesystem...

  • Page 9: Root Menu

    3: summary of cli commands eds device servers command reference 9 root menu the following parameters are top-level root commands. These commands do not alter the configuration of the eds. You can issue these commands from any level. Root configuration command description clrscrn clears the screen. E...

  • Page 10: Enable Menu

    3: summary of cli commands eds device servers command reference 10 enable menu the following configurable parameters reside in the enable configuration menu enable menu command description auto show interfaces displays interface statistics. Auto show processes continuously displays thread runtime in...

  • Page 11

    3: summary of cli commands eds device servers command reference 11 enable menu command description kill ssh closes an ssh session. = session number in the index displayed by the show sessions command. Kill telnet closes a telnet ssh session. = session number in the index displayed by the show sessio...

  • Page 12

    3: summary of cli commands eds device servers command reference 12 enable menu command description show history displays previously entered commands. Show hosts displays the domain settings. Show interfaces displays network-interface statistics. Show ip sockets displays tcp and udp state information...

  • Page 13

    3: summary of cli commands eds device servers command reference 13 enable menu command description xcr import imports a specific xml configuration to the eds. File> = name of the file to be imported. Group list> = name of the xml configuration to be imported. Xcr list lists xml configuration record ...

  • Page 14: Chem Level Commands

    3: summary of cli commands eds device servers command reference 14 chem level commands the following is a list of commands available in the chem (configurable host email) level. Chem level command description auto show statistics continuously displays email statistics = a semi-colon separated list o...

  • Page 15

    3: summary of cli commands eds device servers command reference 15 chem level command description overriding domain sets a domain name that will be used when connecting to an smtp server to send an email alert instead of the device’s domain name in ehlo. = domain name to override the current domain ...

  • Page 16: Configure Menu

    3: summary of cli commands eds device servers command reference 16 configure menu the following configurable parameters reside in the configure menu. Configure menu command description arp ip address> mac address> maps an ip address to a device’s mac address. Ip address> = ip address to be mapped. M...

  • Page 17

    3: summary of cli commands eds device servers command reference 17 configure menu command description clear udp counters sets the udp counters to zero. Clock set (hh:mm:ss)> 31)> sets the system clock. = time in hours, minutes, and seconds = day of the month = month of the year (in text) = year (4 d...

  • Page 18

    3: summary of cli commands eds device servers command reference 18 configure menu command description ip ftp username string> sets the administrative username for the ftp server. String> = administrative username. Ip http auth uri> realm> creates a new http server authentication directive. Uri> = ur...

  • Page 19

    3: summary of cli commands eds device servers command reference 19 configure menu command description ip http max bytes bytes> sets the maximum number of bytes the http server accepts when receiving a request. Bytes> = maximum number of bytes. Ip http max timeout seconds> sets the maximum timeout th...

  • Page 20

    3: summary of cli commands eds device servers command reference 20 configure menu command description no arp clears the arp table. No clear ftp counters restores the ftp counters to the last aggregate value. No clear http counters restores the http counters to the last aggregate value. No clear icmp...

  • Page 21

    3: summary of cli commands eds device servers command reference 21 configure menu command description no ip name-server removes the name server. No ip ssh enable disables and stops the ssh server. No ip tcp resets enable prohibits tcp rsts from sending on connect to unused ports. No ip telnet enable...

  • Page 22

    3: summary of cli commands eds device servers command reference 22 configure menu command description no snmp-server name clears the snmp server name. No syslog enable disables syslog logging. No syslog host removes the address of the syslog recipient. No syslog level disables logging of all events....

  • Page 23

    3: summary of cli commands eds device servers command reference 23 configure menu command description show ssh displays the ip ssh configuration. Show syslog displays syslog information. Show tcp displays tcp configuration information and statistics. Show telnet displays the telnet configuration. Sh...

  • Page 24: Interface 1 Level Menu

    3: summary of cli commands eds device servers command reference 24 configure menu command description syslog host address> sets the address of the syslog recipient. Syslog level sets the minimum severity of events that will be logged. Write stores and applies the current configuration into permanent...

  • Page 25

    3: summary of cli commands eds device servers command reference 25 interface 1 level command description ip address filter ip address> netmask> adds a filter to the ip filter table. Ip address> = ip address. Netmask> = netmask in dotted notation. Ip default-gateway ip address> sets the ip address fo...

  • Page 26: Device Menu

    3: summary of cli commands eds device servers command reference 26 interface 1 level command description speed auto sets the ethernet link speed to auto-negotiation. Write stores and applies the current configuration into permanent memory. Device menu the following configurable parameters reside in ...

  • Page 27

    3: summary of cli commands eds device servers command reference 27 device configuration command description show ixp shows various debug information about the ixp. Show ixp db shows information about the ixp ethernet db layer show ixp ethernet shows information about the ixp ethernet access layer sh...

  • Page 28: Filesystem Menu

    3: summary of cli commands eds device servers command reference 28 filesystem menu the following commands are configurable parameters within the filesystem menu. This level allows for the management of files in the eds. Filesystem menu command description cat file> displays the contents of a specifi...

  • Page 29

    3: summary of cli commands eds device servers command reference 29 filesystem menu command description rmdir directory> removes a specified directory from the filesystem. File> = name of the directory to be removed from the filesystem. Show displays filesystem statistics. Show history displays previ...

  • Page 30

    3: summary of cli commands eds device servers command reference 30 filesystem menu command description tftp put ascii source file> destination file> host> port> sends an ascii file using tftp. Source file> = name of the file to be to a remote location. Destination file> = name of the file when it is...

  • Page 31: Line Menu

    3: summary of cli commands eds device servers command reference 31 line menu the following configurable parameters reside in the line 1, line 2, line 3, line 4 (and so forth) configuration menus. These commands configure the corresponding serial ports. Line menu command description auto show statist...

  • Page 32

    3: summary of cli commands eds device servers command reference 32 line menu command description flowcontrol none sets flow control to none. Flowcontrol software sets flow control to software. No clear line counters restores the serial counters to the last aggregate value. Line n displays the line n...

  • Page 33: Ssh Menu

    3: summary of cli commands eds device servers command reference 33 line menu command description tunnel n displays the tunnel n menu level, where n = 1, 2, 3, 4, and so forth (up to 32 for the eds32pr). Write stores and applies the current configuration into permanent memory. Xoff character definiti...

  • Page 34

    3: summary of cli commands eds device servers command reference 34 ssh menu command description client user user> command> sets the client user, command, and rsa or dsa keys. Client user user> password> command> sets the client user, password, command, and rsa or dsa keys (optional). User> = client ...

  • Page 35

    3: summary of cli commands eds device servers command reference 35 ssh menu command description host public> private> sets rsa or dsa public and private keys. Public> = public key to be set. Private> = private key to be set. Host generate dsa 1024 generates dsa public and private keys. Host generate...

  • Page 36: Ssl Menu

    3: summary of cli commands eds device servers command reference 36 ssh menu command description no client user user> dsa removes the client user dsa key. User> = name of client user whose dsa key is to be removed. No client user user> rsa removes the client user rsa key. User> = name of client user ...

  • Page 37: Tunnel Menu

    3: summary of cli commands eds device servers command reference 37 ssl menu command description no ssl removes the ssl certificate. Show history displays previously-entered commands. Show ssl displays the ssl certificate information. Ssl adds a ssl certificate and private key. Ssl certificate> priva...

  • Page 38

    3: summary of cli commands eds device servers command reference 38 tunnel menu command description accept keep alive milliseconds> enables tcp keepalives and sets the timer in milliseconds. Milliseconds> = timer value, in milliseconds. Accept port number> sets a specific port to use as the local por...

  • Page 39

    3: summary of cli commands eds device servers command reference 39 tunnel menu command description connect keep alive number> enables tcp keepalives and the sets timer in milliseconds. Number> = number of milliseconds to which the timer is set. Connect modem control active enable connect mode when t...

  • Page 40

    3: summary of cli commands eds device servers command reference 40 tunnel menu command description disconnect stop character enables disconnect mode to disconnect when a stop character is received. Disconnect timeout enables disconnect mode to disconnect on a timeout. Disconnect timeout number> sets...

  • Page 41

    3: summary of cli commands eds device servers command reference 41 tunnel menu command description no accept flush serial data do not flush serial data buffer on connection. No accept keep alive disables tcp keepalives. No accept port uses a random port number as the local port. No clear accept coun...

  • Page 42

    3: summary of cli commands eds device servers command reference 42 tunnel menu command description no modem echo pluses do not echo the +++ characters when entering modem command mode. No modem verbose uses decimal status codes. No packing mode disables packing mode. No packing send character remove...

  • Page 43

    3: summary of cli commands eds device servers command reference 43 tunnel menu command description show displays tunneling configuration. Show history displays previously entered commands. Show statistics show connection statistics. Start character string> sets the start character (string format: c,...

  • Page 44: 4: Configuration Using Xml

    Eds device servers command reference 44 4: configuration using xml the eds provides an extensible markup language (xml) interface that can be used to configure eds devices. Every configuration setting that can be issued from the eds web manager or command mode can also be specified using xml. Using ...

  • Page 45: Quick Syntax Tour For Xcrs

    4: configuration using xml eds device servers command reference 45 each configuration group must have one or more element. The configuration item is a specific group of configurable parameters relevant to the parent group. It accepts the “name” attribute. A must have at least one . This element spec...

  • Page 46

    4: configuration using xml eds device servers command reference 46 the element's content is everything that appears between the start tag and end tag, including text and other (child) elements. In addition to content, an element can contain attributes — name-value pairs included in the start tag aft...

  • Page 47

    4: configuration using xml eds device servers command reference 47 figure 4-4. Xml example with multiple items john.Doe@somewhere.Com evolution@xportar.Com figure 4-5. Xml example with multiple groups enable admin enable disable importing and exporting an xml configuration file an xml configuration ...

  • Page 48: Best Practices

    4: configuration using xml eds device servers command reference 48 best practices testing the xml configuration file the group name and item name allow the xml configuration file to be tested for accuracy before processing the file. During testing, the file is checked for configuration errors, such ...

  • Page 49

    4: configuration using xml eds device servers command reference 49 the following example exports only the tunnel 1 settings to the file “tunnel_1.Xcr” on the eds filesystem: xcr export tunnel_1.Xcr “tunnel:1” the following example exports only tunnel settings for all ports to the file “tunnel_all.Xc...

  • Page 50

    4: configuration using xml eds device servers command reference 50 special xcr groups the following xcr groups are used to delete settings, control how the xml is processed, or control the device. They are not used for configuration purposes. For example, the reboot group, which causes the eds to re...

  • Page 51: Xml Groups

    4: configuration using xml eds device servers command reference 51 xml groups table 4-1 lists the eds xml import and export groups in alphabetical order. This table also indicates whether the group can be imported and/or exported. Table 4-1. Eds import and export groups group name item name value na...

  • Page 52

    4: configuration using xml eds device servers command reference 52 group name item name value name value import/export additional information very low import and export low import and export normal import and export high import and export priority urgent import and export overriding domain import an...

  • Page 53

    4: configuration using xml eds device servers command reference 53 group name item name value name value import/export additional information enable import and export state disable import and export port import and export secure port import and export max timeout import and export max bytes import a...

  • Page 54

    4: configuration using xml eds device servers command reference 54 group name item name value name value import/export additional information system import this group specifies the passwords to use when importing an xcr using the cli capture feature. The system value specifies the root password used...

  • Page 55

    4: configuration using xml eds device servers command reference 55 group name item name value name value import/export additional information xon char import and export set the x-on character. Enter as a hexadecimal byte. Xoff char import and export set the x-off character. Enter as a hexadecimal by...

  • Page 56

    4: configuration using xml eds device servers command reference 56 group name item name value name value import/export additional information max entries import and export disable import and export always import and export mode serial string import and export enable import and export echo serial str...

  • Page 57

    4: configuration using xml eds device servers command reference 57 group name item name value name value import/export additional information known host delete import and export specify the server host for deletion. Client users delete import and export specify the username for deletion. Client rsa ...

  • Page 58

    4: configuration using xml eds device servers command reference 58 group name item name value name value import/export additional information disable import and export any character import and export start character import and export modem control asserted import and export modem import and export l...

  • Page 59

    4: configuration using xml eds device servers command reference 59 group name item name value name value import/export additional information remote address import and export remote port import and export tcp import and export udp import and export ssh import and export tcp aes import and export pro...

  • Page 60

    4: configuration using xml eds device servers command reference 60 group name item name value name value import/export additional information disable import and export text import and export response type numeric import and export enable import and export error unknown commands disable import and ex...

  • Page 61: Xsr Groups and Items

    4: configuration using xml eds device servers command reference 61 xsr groups and items table 4-2 lists the supported xml status record (xsr) groups and items. These groups and items show the status of the device in xml form and can only be exported. The xsr schema differs slightly from the xcr grou...

  • Page 62

    4: configuration using xml eds device servers command reference 62 group name item name value name valid values lock count share count bank a begin bank a end bank a erase cycles bank b begin bank b end banks bank b erase cycles status admin username rejected connections accepted ip address ftp last...

  • Page 63

    4: configuration using xml eds device servers command reference 63 group name item name value name valid values address mask replies status ip address ethernet mac address auto negotiate speed phy duplex encapsulation type arp timeout mtu octets unicast non unicast discards errors broadcasts packets...

  • Page 64

    4: configuration using xml eds device servers command reference 64 group name item name value name valid values failure success protocol rx queue tx queue local address remote address local port remote port ip socket state protocol rx queue tx queue local address remote address local port remote por...

  • Page 65

    4: configuration using xml eds device servers command reference 65 group name item name value name valid values cluster size total free used cluster pool max used bytes breaks parity errors framing errors overrun errors number buffers receive allocated bytes bytes breaks transmit queued bytes assert...

  • Page 66

    4: configuration using xml eds device servers command reference 66 group name item name value name valid values entries data bytes interface baud parity data bits stop bits line flow control local port remote ip address remote port sessions telnet duration state local port uptime bytes in ssh totals...

  • Page 67

    4: configuration using xml eds device servers command reference 67 group name item name value name valid values accept dns address invalids local ip address local port remote ip address remote port uptime octets from serial octets from network connect dns address changes current connect connections ...

  • Page 68: Index

    Eds device servers command reference 68 index best practices, xml, 48 cli configure menu, 16 device menu, 26 enable menu, 10 filesystem menu, 28 interface 1 level menu, 24 line menu, 31 navigating through, 6 root menu, 9 serial port configuration, 5 ssh menu, 33 ssl menu, 36 summary of commands, 8 t...