Lantronix ION x4110 CLI Reference Contents Introduction..............................4 General ..............................4 Related Manuals and Online Help ......................4 For More Information ..........................4 Documentation Conventions ........................5 Managing Slide-In and Remote Modules via CLI Commands ..............5 Managing Standalone Modules Using CLI Commands ................7 Reboot and Reset Command Notes ......................
Lantronix site. Note that this manual provides links to third party web sites for which Lantronix is not responsible. Other ION system and related device manuals are listed below. Product Documentation Postcard, 33504 •...
Lantronix ION x4110 CLI Reference Documentation Conventions The conventions used within this manual for commands/input entries are described in the table below. Table 1: Documentation Conventions Convention Meaning Indicates the entry must be made as shown. For example: ipaddr=<addr> Boldface text...
Page 6
Lantronix ION x4110 CLI Reference A representation of the hierarchy is shown in the figure below. Figure 1: CLI Location Hierarchy In the above figure, there are three levels of devices: L1D, or level one device, refers to devices (IONMM and other chassis-resident devices) that are •...
Lantronix ION x4110 CLI Reference Example 2 In the CLI location hierarchy, to go to device L2D in the network topology shown in Figure 1, you would enter the following command from the base prompt. C1|S1|L1D>go s=5 l1ap=2 l2d=1 The resulting command line prompt would be: C1|S5|L1AP1|L2D>...
Lantronix ION x4110 CLI Reference Reboot and Reset Command Notes IMPORTANT: Certain CLI commands affect important stored files. Doing a reboot, restart or upgrade of the IONMM, a power restart of the chassis, or a reset to factory removes temporary files (e.g.
Lantronix ION x4110 CLI Reference Keystroke Commands The table below shows the optional keystrokes available to edit command lines (*indicates HyperTerm support, ** indicates command prompt support, *** indicates both HT and command prompt support by this keystroke). Table 2: Editing Commands...
Lantronix ION x4110 CLI Reference System Commands The following are basic system level commands. These commands are used to show configuration / mode, show help, reboot the system, reset the configuration, and other basic functions. Password for Login / Access...
Page 11
Lantronix ION x4110 CLI Reference Clear the Screen Syntax: Description: Clears the screen and returns to the location of the IONMM card. Go Back to IONMM home Syntax: Description: Sets the command prompt back to the location of the IONMM card.
Page 12
Lantronix ION x4110 CLI Reference Go to Another Location Syntax: go [c=<0-16>] [s=<0-32>] [l1ap=<1-15>] [l2ap=<1-15>] (l1p=<1-5>|l2p=<1-15>|l3p=<1-15>|l1d|l2d|l3d) Description: Sets the location (device or port) where subsequent commands are destined for. This information will appear on the command prompt line as the location where the command will be executed.
Page 13
Lantronix ION x4110 CLI Reference Example 2: The following would cause all subsequent commands to be executed for port 2 on the device in slot 5. C1|S5|L1D>go l1p=2 The new command prompt would be: C1|S5|L1P2> Example 3: The following would cause all subsequent commands to be executed for a remote device connected to port 2 of a chassis-resident module in slot 5.
Page 14
Lantronix ION x4110 CLI Reference Help (?) Syntax: Description: Display help for CLI commands by typing a question mark (?). Typing a ? at the command line prompt displays a list of base commands (show, set, etc.). To display a list of the options for a particular command or parameter, type the command/parameter then a space and then ?.
Page 15
Lantronix ION x4110 CLI Reference List Syntax: list Description: Display all available command line commands. Example (partial list): Agent III C1|S0|L1D>list add acl condition type=(srcmacaddr|ipv4addr|ipv4addrrange|ipv4network|tcpport| tcpportrange|udpport|udpportrange|icmp) srcdst=(src|dst) oper=(equal|notequal) value=VAL add acl rule position=(head|tail) table=(raw|filter|nat|mangle) chain=(prerout ing|input|forward|output|postrouting) policy=(accept|drop|trap) [traprate=TRAPRATE] [condition=CONDLIST] add fwddb mac=MAC [conn-port=PORT] [priority=PRIO] [type=(static|staticNRL|staticPA)]...
Page 16
Lantronix ION x4110 CLI Reference Process Snapshot Syntax: Description: Displays a snapshot of the current memory processes. For example: 1 root 312 S init 2 root SWN [ksoftirqd/0] 3 root [watchdog/0] 4 root SW< [events/0] 5 root SW< [khelper] 6 root SW<...
Page 17
Lantronix ION x4110 CLI Reference Show Current Directory Syntax Description Displays the current directory. Example Agent III C1|S17|L1D>pwd Agent III C1|S17|L1D> Change Modes (Quit) Syntax quit Description Exit the current mode and return to the previous mode (i.e., the CLI command line prompt).
Page 18
Lantronix ION x4110 CLI Reference Reboot Procedure At times you may have to reboot (restart) the ION system. This operation can be accomplished by either the CLI or Web UI. Note: this operation can take several minutes. The amount of time for the reboot to complete depends on the ION system configuration.
Page 19
Lantronix ION x4110 CLI Reference Reset Factory Configuration Syntax: reset factory Description: Resets a card to its factory default configuration. Example Agent III C1|S17|L1D>reset factory Warning: this command will restart the specified card, connection will be lost! Agent III C1|S17|L1D>...
Page 20
Lantronix ION x4110 CLI Reference Reset Device Uptime Syntax reset uptime Description Resets the x4110 Up Time counter to zero, and immediately begins to increment. Example Agent III C1|S17|L1D>reset uptime Agent III C1|S17|L1D> Use the show card info command to display the current system uptime.
Page 21
Lantronix ION x4110 CLI Reference Show Card Information Syntax: show card info Description: Displays the system information for the IONMM or slide-in module. The system information can be alphabetic, numeric or a combination. Example (C4110 in slot 2): Agent III C1|S2|L1D>show card info...
Page 22
Lantronix ION x4110 CLI Reference Show Card Type Syntax: show cardtype Description: Displays the device’s card type (model number). Example: (C4110 slot Agent III C1|S1|L1D>show cardtype Card type: IONMM Agent III C1|S1|L1D>go c=1 s=2 l1d Agent III C1|S2|L1D>show cardtype Card type: C4110-4848 Agent III C1|S2|L1D>...
Page 23
Lantronix ION x4110 CLI Reference Show Slot Information Syntax: show slot info Description: Displays information about the ION chassis backplane, slide-in modules installed in the chassis, and related status. This command is only valid on an IONMM. Example Display the current slot information.
Page 24
Lantronix ION x4110 CLI Reference Set Circuit ID set circuit-ID=<xx> Syntax: Lets you define an ASCII text string up to 63 bytes and override the default Circuit ID, Description: which is vlan-module-port in binary format, for a device and/or device ports. Use the show circuit-ID command to display the Circuit ID information for a device or port.
Page 25
Lantronix ION x4110 CLI Reference Circuit ID Config Procedure 1. Access the x4110 through either a USB connection or a Telnet session. 2. At the device’s command prompt type: set circuit-ID=<xx> where: xx = the Circuit ID to be used for this device or port.
Page 26
Lantronix ION x4110 CLI Reference Set Device Description set device description=<xx> Syntax: Lets you configure an ASCII text string up to 63 bytes and override the default Description: information, which is vlan-module-port in binary format. 1. Access the x4110 through either a USB connection or a Telnet session.
Page 27
Lantronix ION x4110 CLI Reference Data Rate Timing Commands The C4110 can be used in applications where links supporting data rates from 1Gig to 10Gig require fiber extension or where 10Gig links require an interface between two fiber networks. It performs 3R (re- amplify, re-shape, re-time) signal regeneration.
Page 28
Lantronix ION x4110 CLI Reference Show Data Rate Timing Syntax show dataRateTiming Description Display the current x4110 data rate timing setting. The settings are described above. Example Show the data rate set in the command example above. Agent III C1|S4|L1D>show dataRateTiming Data Rate Timing/Retiming: rate10GE Agent III C1|S4|L1D>...
Lantronix x4110 CLI Reference DMI Commands The following commands are used for Diagnostic Monitoring Interface (DMI) operations. Note: These commands can only be entered for a fiber port that supports DMI. Not all x4110 models or SFP models support DMI. The SFP models that support DMI have a “D” at the end of the model number.
Page 30
Lantronix x4110 CLI Reference Example Display the current DMI configuration for port 2. Agent III C1|S2|L1P1>go l1p=2 Agent III C1|S2|L1P2>show dmi info Diagnostic monitoring interface information: ------------------------------------------------------------------------ DMI connector type: DMI indentifier: SFP/SFP+/SFP28 DMI Nominal bit rate: 10500*Mbps DMI 9/125u Singlemode Fiber (k):...
Page 31
Lantronix x4110 CLI Reference Set DMI Receive Power Preset Level Syntax: set dmi rx–power–preset–level=<xx> Description : Defines the lowAlarm threshold for RxPowerAlarm. If a non-zero value (in microwatts) is specified, the module will stop passing traffic when the receive power drops below the new threshold.
Page 32
Lantronix x4110 CLI Reference DMI Config Procedure The DMI (Diagnostic Maintenance Interface) function displays x4110 diagnostic / maintenance information such as fiber interface characteristics, diagnostic monitoring parameters, and supported fiber media lengths. DMI can be configured in the x4110 via the CLI as follows.
Page 33
Lantronix x4110 CLI Reference DMI Parameters The DMI tab parameters are described in the table below. Table 3: DMI Parameters Parameter Description Interface Characteristics The external optical or electrical cable connector provided as the interface. For example: LC, SC, Dual BNC coax connectors, DB9 for RS232 and RS485,...
Page 34
Lantronix x4110 CLI Reference Parameter Description Not Supported - 2, Low Warn - 3, High Warn - 4, Low Alarm - 6 High Alarm - 7 DMI transmit bias Measured transmit bias current on local fiber interface, in uA (microamperes).
Page 35
Lantronix x4110 CLI Reference Parameter Description A 4-byte field that contains ASCII characters, defining the vendor product DMI Vendor revision number. A value of all zeroes in the 4-byte field indicates that the revision vendor revision is unspecified. For example e.g., 2.0.
Transition Networks ION x4110 CLI Reference Ethernet Port Commands The following commands are used for Ethernet port operations. The functions of some of the Ethernet port commands below depend on the type of port or SFP. Note: These commands can only be entered at the port level - when the last part of the command line prompt indicates the location is a port (e.g., L1P1>).
A description of any action(s) already taken to resolve the problem (e.g., changing switch mode, rebooting, etc.): ______________________________________________________________________ ____________________________________________________________________________________ ____________________________________________________________________________________ The serial and revision numbers of all involved Lantronix products in the network: ____________________________________________________________________________________ ____________________________________________________________________________________ A description of your network environment (layout, cable type, etc.): _____________________________...
C. The system was unable to resolve the desired command based on the portion of the command entered. For example, you entered the following: C1|S7|L1D>set dot1 1. Verify the command syntax. 2. Retry the CLI command syntax. See Appendix A. 3. If the problem persists, contact Technical Support. 33575 Rev. C https://www.lantronix.com...
Page 39
1. Use the go command to change location of where the command operates. The go command format is: go [c=CHASSIS] [s=SLOT] [l1ap=PORT] [l2ap=PORT] (l1p=PORT|l2p=PORT|l3p=PORT|l1d|l2d|l3d) 2. Retry the operation. For a complete list of the available commands, see the ION System CLI Reference Manual, 33473. 3. If the problem persists, contact Technical Support. 33575 Rev. C https://www.lantronix.com...
Page 40
1. Use the go command to change location of where the command operates. The go command format is: go [c=CHASSIS] [s=SLOT] [l1ap=PORT] [l2ap=PORT] (l1p=PORT|l2p=PORT|l3p=PORT|l1d|l2d|l3d) 2. Retry the operation. 3. If the problem persists, contact Technical Support. 33575 Rev. C https://www.lantronix.com...
Page 41
This message indicates that a port level command was entered for the IONMM but the command is only valid for the other types of slide-in modules. 1. Use the go command to change location of where the command operates. 2. Retry the operation. 3. If the problem persists, contact Technical Support. 33575 Rev. C https://www.lantronix.com...
Page 42
4. Cycle power for the module in question. Note: for slide-in modules pull the module out so it is no longer connected to the backplane, then slide the module back in, ensuring that it is firmly seated. 5. Retry the operation. 6. If the problem persists, contact Technical Support. 33575 Rev. C https://www.lantronix.com...
Page 43
3. If the problem persists, contact Technical Support. There is no matched command This message indicates that there is no such command available on this system. 1. Verify the command syntax. 2. Retry the operation. 3. If the problem persists, contact Technical Support. 33575 Rev. C https://www.lantronix.com...
Page 44
4. In the HyperTerminal window, select File>Properties. 5. Check that the correct port is listed in the Connect using field. 6. Restart the management station. 7. Reboot the IONMM. 8. If the problem persists, contact Technical Support. 33575 Rev. C https://www.lantronix.com...
Page 45
CLI is receiving continuous error message "system is initializing..." 1. Wait for a few minutes for the message to clear. 2. Cycle power to the IONMM. 3. Retry the operation. 4. If the problem persists, contact Technical Support. See Contact Us on page 40. 33575 Rev. C https://www.lantronix.com...
Page 46
The command you entered is not supported, or you entered the wrong command format / syntax. 1. Verify the CLI command syntax. 2. Retry the operation. 3. For a complete list of the available commands, see Appendix A. 4. If the problem persists, contact Technical Support. 33575 Rev. C https://www.lantronix.com...
Page 47
Remote fault detect state is set to notSupported. If either is set to notSupported, change the setting to enable (e.g., type set rfd state enable and press Enter). 4. Retry the operation. 5. If the problem persists, contact Technical Support. 33575 Rev. C https://www.lantronix.com...
Page 48
The attempted show dot1bridge aging-time command failed to complete. 1. Verify the dot1bridge aging-time command syntax. See the IONMM User Guide manual. 2. Retry the operation. See the dot1bridge aging-time command 3. If the problem persists, contact Technical Support. 33575 Rev. C https://www.lantronix.com...
Page 49
1. Verify if the card supports DMI. 2. Use the go command to switch to a different card port supporting Fiber. 3. Verify the command entry. See “DMI Commands” section above. 4. If the problem persists, contact Technical Support. 33575 Rev. C https://www.lantronix.com...
Page 50
No tdm loopback supported on this card! No Time-domain reflectometer support on this card! Syslog is not supported on this card! TAOS status setting is not supported on this card! TNDP is not supported on this card! 33575 Rev. C https://www.lantronix.com...
Page 51
2. Use the stat command to show the chassis configuration. For example: [ 22] IONPS-A Temperature Sensor Volatage Sensor Power Sensor Fan-1 Fan-2 3. Use the go command to switch to the power sensor or fan. 4. If the problem persists, contact Technical Support. 33575 Rev. C https://www.lantronix.com...
Page 52
Can not set speed on this port! C1|S5|L1P2> 1. Verify the x4110 supports this speed. 2. Verify the command syntax. 3. Re-enter the set ether speed= command with a speed supported by the card. 4. If the problem persists, contact Technical Support. 33575 Rev. C https://www.lantronix.com...
Page 53
Error frame seconds summary threshold is out of range, its range is 0 - 268435455! A parameter entered in the "Event Configuration" has exceeded the range limitation. 1. Enter a parameter within the valid range displayed. 2. If the problem persists, contact Technical Support. 33575 Rev. C https://www.lantronix.com...
Page 54
Error: This card is in hardware mode and no setting allowed! You tried to enter a CLI command with the x4110 in Hardware mode. 1. Change the x4110 to Software mode. See the x4110 Install Guide manual for information. 33575 Rev. C https://www.lantronix.com...
Page 55
Recovery: 1) Check if some extra files ended up in the zip folder – some repeated – 6 FW files total. 2) Remove some of the files from the zip folder and try the upload again. 3) Send the remaining files in a separate file. 4) Check the TFTP Server’s online helps for suggestions. 33575 Rev. C https://www.lantronix.com...
Lantronix x4110 CLI Reference Appendix B: Linux Commands ION supports certain standard Linux file system commands such as cat, cd, ls, more, pwd, and rm. These commands are restricted to the user directories; internal Linux file systems are not accessible.
Page 57
Lantronix x4110 CLI Reference ls Command Command: ls Description: Unix and Unix-like operating systems maintain the concept of a current working directory, (i.e., where you are currently positioned in the hierarchy of directories). When invoked without any arguments, ls lists the files in the current working directory. This command is restricted to the IONMM user directories;...
Page 58
Lantronix x4110 CLI Reference -d shows information about a symbolic link or directory, rather than about the link's target or listing the contents of a directory. -t sort the list of files by modification time. -h print sizes in human readable format. (e.g., 1K, 234M, 2G, etc.) Example C1|S3|L1D>ls etc...
Page 59
Lantronix x4110 CLI Reference more Command Command: more Description: A filter for paging through text one screenful at a time. Example: C1|S7|L1D>more [OPTION] Options: Refer to the BSD 4 documentation for options and Interactive commands for the more command. pwd Command Command: pwd Description: Show current directory.
Lantronix x4110 CLI Reference Appendix C: Warranty and Compliance Information For Warranty, Returns, Electrical Safety Warnings, and Compliance Information see the related Install Guide. Appendix D: SNMP MIBs and Traps Support See the IONMM SNMP User Guide for information on SNMP traps supported, supported MIBs, private MIB objects tree example, Downloading, Compiling and Integrating MIBs, Trap service and functions, the Trap Server Log, and an example of ION SNMP operation.
Page 61
Irvine, CA 92618, USA Toll Free: 800-526-8766 Phone: 949-453-3990 Fax: 949-453-3995 Technical Support Online: https://www.lantronix.com/technical-support/ Sales Offices For a current list of our domestic and international sales offices, go to the Lantronix web site at www.lantronix.com/about/contact. 33575 Rev. C https://www.lantronix.com...
Need help?
Do you have a question about the 4110 Series and is the answer not in the manual?
Questions and answers