PremierWave XN User Guide Part Number 900-606 ReRevision B January 2013
Copyright & Trademark © 2013 Lantronix, Inc. 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® and PremierWave are registered trademarks and DeviceInstaller™ is a trademark of Lantronix, Inc. Windows® and Internet Explorer® are registered trademarks of Microsoft Corporation. Mozilla® and Firefox® are registered trademarks of the Mozilla Foundation. Chrome™ is a trademark of Google.
Table of Contents List of Figures _____________________________________________________________ 9 List of Tables _____________________________________________________________ 10 1: Using This Guide 12 Purpose and Audience _____________________________________________________ 12 Summary of Chapters ______________________________________________________ 12 Additional Documentation ___________________________________________________ 12 2: Introduction 14 Key Features _____________________________________
5: Configuration Using Web Manager 27 Accessing Web Manager ___________________________________________________ 27 Device Status Page ____________________________________________________ 28 Web Manager Components _________________________________________________ 29 Navigating Web Manager ___________________________________________________ 30 6: Network Settings 32 Network Interface Settings __________________________________________________ 32 To Configure Network Interface Settings ___________________
To Configure Tunnel Disconnect Mode Settings ______________________________ 54 Modem Emulation ______________________________________________________ 55 To Configure Tunnel Modem Emulation Settings ______________________________ 56 Statistics _____________________________________________________________ 56 To View Tunnel Statistics ________________________________________________ 56 8: Terminal and Host Settings 57 Terminal Settings _________________________________________________________ 57 To Configur
11: Maintenance and Diagnostics Settings 73 Filesystem Settings ________________________________________________________ 73 File Display ___________________________________________________________ 73 To Display Files _______________________________________________________ 73 File Modification _______________________________________________________ 74 File Transfer __________________________________________________________ 74 To Transfer or Modify Filesystem Files ______________________________________ 75
12: Advanced Settings 83 Email Settings ____________________________________________________________ 83 To View, Configure and Send Email ________________________________________ 83 Command Line Interface Settings _____________________________________________ 84 Basic CLI Settings _____________________________________________________ 84 To View and Configure Basic CLI Settings ___________________________________ 84 Include in your file: Telnet Settings ______________ 85 To Configur
15: Updating Firmware 95 Obtaining Firmware ________________________________________________________ 95 Loading New Firmware through FTP __________________________________________ 95 16: VIP Settings 96 Virtual IP (VIP) Configuration ________________________________________________ 96 To Configure VIP Settings _______________________________________________96 Virtual IP (VIP) Status ______________________________________________________ 96 To View VIP Status ____________________________________________
List of Figures Figure 2-1 PremierWave XN Product Label ____________________________________________ 16 Figure 3-1 PremierWave XN Top/Front View ___________________________________________ 18 Figure 3-2 PremierWave XN Male DB9 DTE Serial Ports _________________________________ 18 Figure 3-3 PremierWave XN Pinout Configuration for RS-232 ______________________________ 18 Figure 3-4 PremierWave XN Pinout Configuration for Full Duplex RS-422/485 (4-wire) __________ 19 Figure 3-5 PremierWave XNXC Pinout Configu
List of Tables Table 3-6 PremierWave XN LEDs and Descriptions _____________________________________ 19 Table 3-7 WLAN Signal Strength Indicator at 5 GHz _____________________________________ 20 Table 3-8 WLAN Signal Strength Indicator at 2.
Table 10-3 SSH Server Authorized Users _____________________________________________ 68 Table 10-4 SSH Client Users _______________________________________________________ 68 Table 10-5 Certificate and Key Generation Settings _____________________________________ 70 Table 10-6 Upload Certificate Settings _______________________________________________71 Table 10-7 Trusted Authority Settings ________________________________________________ 72 Table 11-1 File Display Settings _________________________________
1: Using This Guide Purpose and Audience This guide provides the information needed to configure, use, and update the PremierWave XN. It is intended for software developers and system integrators who are installing this product into their designs. Summary of Chapters The remaining chapters in this guide include: Chapter Description 2: Introduction Main features of the product and the protocols it supports. Includes technical specifications.
1: Using This Guide Additional Documentation Visit the Lantronix Web site at www.lantronix.com/support/documentation for the latest documentation and the following additional documentation. Document Description PremierWave XN Command Reference Instructions for accessing Command Mode (the command line interface) using a Telnet connection, SSH connection or through the serial port. Detailed information about the commands. Also provides details for XML configuration and status.
2: Introduction PremierWave XN is a multi-port device server offering high performance, Ethernet-to-wireless bridging connectivity that allows remote access and easy management of machines or equipment over the network and across the internet. PremierWave XN provides bullet-proof security by offering robust data encryption and authentication options including AES, SSH and SSL. Remote configuration over a network is possible using Telnet, SSH, or web browser (HTTP and HTTPS).
2: Introduction TCP, UDP, SSH, SSL and telnet tunneling to the serial port. TFTP for uploading/downloading files. FTP and HTTP for firmware upgrades and uploading/downloading files. Troubleshooting Capabilities The PremierWave XN offers a comprehensive diagnostic toolset that lets you troubleshoot problems quickly and easily. Available from the CLI or Web Manager, the diagnostic tools let you: View memory and IP socket information. Perform ping and traceroute operations.
2: Introduction IP Address Every device connected to an IP network must have a unique IP address. This address references the specific unit. Port Numbers Every TCP connection and every UDP datagram is defined by a destination and source IP address, and a destination and source port number. For example, a Telnet server commonly uses TCP port number 23.
3: Installation of PremierWave XN This chapter describes how to install the PremierWave XN device server.
3: Installation of PremierWave XN Figure 3-1 PremierWave XN Top View Signal Strength LEDs WPS Button (pin hole) The PremierWave XN has two male DB9 serial ports that support RS-232/422/485. Figure 3-2 shows the front view of the device. The default serial port settings are 9600 baud, 8 bits, no parity, 1 stop bit, no flow control.
3: Installation of PremierWave XN Figure 3-4 PremierWave XN Pinout Configuration for Full Duplex RS-422/485 (4-wire) Figure 3-5 PremierWave XN Pinout Configuration for Half Duplex RS-422/485 (2-wire) Ethernet LEDs The Ethernet Port has two LEDs that indicate the status of the connection as follows: Left LED Green ON 100Mbps Link Green Blink 100Mbps Activity Amber ON 10Mbps Link Amber Blink 10Mbps Activity Right LED Green ON Full Duplex OFF Half Duplex The Ethernet port can connect
3: Installation of PremierWave XN LED (continued) Description USB 1 USB 2 GREEN - displays a solid light when a USB device is connected to USB 1 Host port and is functioning properly. OFF- when no USB device is connected to USB 1 Host port. GREEN - displays a solid light when a USB device is connected to USB 2 Host port and is functioning properly. OFF- when no USB device is connected to USB 2 Host port. Fault/Diagnostic See Table 3-10 for diagnostic indications.
3: Installation of PremierWave XN Table 3-10 Diagnostic LED Indications Fault Conditions Blink Pattern No Ethernet link when eth0 is enabled Long, long, short, short, 2 seconds off, continuous No WLAN link (no BSSID detected) when wlan0 is enabled Long, long, long, short, short, 2 seconds off, continuous No IP obtained from WLAN when wlan0 is enabled and the bridge mode is disabled.
3: Installation of PremierWave XN Figure 3-11 PremierWave XN Bottom/Back Panel View VV+ Antenna Terminal Block Power (3-pin) Barrel Plug Power Ethernet Antenna Wi-Fi Protected Setup (WPS) Using WPS, you have the option of connecting to PremierWave devices with a router or access point in a single operation instead of manually creating a profile with a network name (SSID), setting up wireless security parameters and updating the choice list.
3: Installation of PremierWave XN Using the CLI To enter the command level: enable -> config -> if 2 -> link To Cancel WPS Using the CLI To enter the command level: enable -> config -> if 2 -> link To Show WPS Status Using the CLI To enter the command level: enable -> config -> if 2 -> link Installing the PremierWave XN Be sure to place or mount the device securely on a flat horizontal or vertical surface.
3: Installation of PremierWave XN Figure 3-13 PremierWave XN Dimensions in Millimeters (mm) PremierWave XN User Guide 24
4: Using DeviceInstaller This chapter covers the steps for locating a PremierWave XN unit and viewing its properties and device details. DeviceInstaller is a free utility program provided by Lantronix that discovers, configures, upgrades and manages Lantronix Device Servers. Notes: For instructions on using DeviceInstaller to configure the IP address and related settings or for more advanced features, see the DeviceInstaller Online Help. Auto IP generates a random IP address in the range of 169.254.
4: Using DeviceInstaller Current Settings (continued) Description Group Configurable field. Enter a group to categorize the PremierWave. Double-click the field, type in the value, and press Enter to complete. This group name is local to this PC and is not visible on other PCs or laptops using DeviceInstaller. Comments Configurable field. Enter comments for the PremierWave. Double-click the field, type in the value, and press Enter to complete.
5: Configuration Using Web Manager This chapter describes how to configure PremierWave XN using Web Manager, the Lantronix browser-based configuration tool. The unit’s configuration is stored in nonvolatile memory and is retained without power. All changes take effect immediately, unless otherwise noted.
5: Configuration Using Web Manager Device Status Page The page is the first page that appears after you log into Web Manager. The Device Status page appears when you click Status in the Main Menu in Web Manager.
5: Configuration Using Web Manager Web Manager Components The layout of a typical Web Manager page is below. Figure 5-1 Components of the Web Manager Page Items to configure Links to subpages Header Menu Bar Footer Configuration and/or Status Area Information and Help Area Web Manager pages have these sections: The menu bar always appears at the left side of the page, regardless of the page shown. The menu bar lists the names of the pages available in the Web Manager.
5: Configuration Using Web Manager In the middle of many pages, you can select or enter new configuration settings. Some pages show status or statistics in this area rather than allow you to enter settings. At the bottom of most pages, the current configuration is displayed. In some cases, you can reset or clear a setting. The information or help area shows information or instructions associated with the page. A Logout link is available at the upper right corner of every page.
5: Configuration Using Web Manager Web Manager Page (continued) Description See Page Protocol Stack Lets you perform lower level network stack-specific activities. 75 Query Port Lets you change configuration settings for the query port. 77 RSS Lets you change current Really Simple Syndication (RSS) settings. 64 SmartRoam Lets you configure SmartRoam options through Network Link Settings.
6: Network Settings The Network Settings show the status of the Ethernet or WLAN interface/link and let you configure the settings on the device. Interface settings are related to the configuration of the IP and related protocols. Link settings are related to the physical link connection, which carries the IP traffic. The PremierWave XN contains two network interfaces.
6: Network Settings Network Interface Settings (continued) Description IP Address Enter the static IP address to use for the interface. You may enter it alone or in CIDR format. Note: This setting will be used if Static IP is active (both DHCP and BOOTP are Disabled). Changing this value requires you to reboot the device. When DHCP or BOOTP is enabled, the PremierWave XN tries to obtain an IP address from a DHCP or BOOTP server.
6: Network Settings Using XML Include in your file: Include in your file: To View Network Interface Status Using Web Manager In Network Interface Status, you can view both the current operational settings as well as the settings that would take affect upon a device reboot. To view Ethernet (eth0) Status, click Network on the menu and select Network 1 -> Interface -> Status.
6: Network Settings SmartRoam periodically scans for access points which belong to the current ESS (having the same SSID and security settings at the currently associated AP.) The results are then searched for an AP with a 'stronger' signal (higher RSSI) than the current AP. If the search is successful, SmartRoam triggers a disconnection from the current AP and a connection to the one selected from the scan results.
6: Network Settings To Configure Network Link Settings Using Web Manager To modify Ethernet (eth0) Link information, click Network on the menu and select Network 1 -> Link. To modify Wireless (wlan0) Link information, click Network on the menu and select Network 2 -> Link -> Configuration.
6: Network Settings WLAN Link Scan Results Field Description RSSI The instantaneous Received Signal Strength Indicator (RSSI) of the device measured in dBm. Note: RSSI reported in scan results is a single sampling, while the RSSI reported in the 'status' command (showing the signal strength of the currently connected AP) is averaged over time. Security Suite Indicates the security suite in use by the device as well as whether it is operating in Adhoc (IBSS) mode.
6: Network Settings Using the CLI To enter the wlan0 Link command level: enable -> config -> if 2 -> link Using XML Include in your file: and WLAN Profiles A WLAN profile defines all of the settings necessary to establish a wireless connection with either an access point (in infrastructure mode) or another wireless client (in Adhoc mode.) A maximum of eight profiles can exist on the PremierWave XN at a time.
6: Network Settings WLAN Profile Basic Settings Description Delete (checkbox) Click the Delete checkbox beside the profile(s) to be deleted. Three buttons will appear: Enabled (checkbox) Click the Submit button to permanently delete profile(s). Click the Apply button to delete the profile for testing purposes. If the device reboots, this change will not be applied. Click the Cancel button to cancel this action, as desired. Click the Enabled checkbox beside the profile(s) to be enabled.
6: Network Settings Using the CLI To enter the wlan0 Profile command level: enable -> config -> wlan profiles -> edit or enable -> config -> wlan profiles -> edit Using XML Include in your file: and Table 6-9 WLAN Profile Advanced Settings WLAN Profile Advanced Settings Description TX Data Rate Maximum Specify the rate for data transmission.
6: Network Settings Using XML Include in your file: and WLAN Profile Security Settings The PremierWave XN supports WEP, WPA, and WPA2/IEEE 802.11i to secure all wireless communication. WPA and WPA2/IEEE 802.11i are not available for Adhoc topology. The WPA2/IEEE 802.11i mode is compliant with the Robust Secure Network specified in the IEEE standard 802.11i.
6: Network Settings Using XML Include in your file: and > WLAN Profile WEP Settings WEP security is available in both Infrastructure and AdHoc modes. WEP is a simple and efficient security mode encrypting the data via the RC4 algorithm. However, WEP has become more vulnerable due to advances in hacking technology. State of the art equipment can find WEP keys in five minutes.
6: Network Settings and WLAN Profile WPA and WPA2/IEEE802.11i Settings WPA and WPA2/IEEE802.11i security suites are available for Infrastructure mode only. WPA is a security standard specified by the WiFi Alliance and is a close derivative of an early draft of the IEEE802.11i specification. WEP was becoming vulnerable and finalizing the IEEE802.11i standard was still far away. WPA2 is WiFi’s subset of the broad IEEE802.
6: Network Settings WLAN Profile WPA & WPA2 Settings EAP-TTLS Option Description Select the inner authentication method to be used with EAP-TTLS (if configured). PEAP Option EAP-MSCHAPv2 MSCHAPv2 MSCHAP CHAP PAP EAP-MD5 Select the inner authentication method to be used with EAP-PEAP (if configured).
6: Network Settings WLAN Quick Connect WLAN QuickConnect allows users to add a WLAN profile from a list of available networks autorefreshed every 15 seconds. Details of the selected network are pre-populated, so little or no configuration is required by the user. Users can test the network connection before adding it to the pool of WLAN profiles. Table 6-13 WLAN Quick Connect WLAN Quick Connect Settings Description Network Name (search field) Enter a network name and click Scan to search for a network.
7: Line and Tunnel Settings The PremierWave XN The two lines . All lines use standard RS232/RS485 serial ports. All lines can be configured to operate in the following modes: RS232 RS485 Full Duplex (also compatible with RS-422) RS485 Half Duplex, with and without termination impedance All serial settings such as Baud Rate, Parity, Data Bits, etc, apply to these Lines. Line Settings The Line Settings allow configuration of the serial lines (ports).
7: Line and Tunnel Settings Line Settings (continued) Description Xon Char Set Xon Char to be used when Flow Control is set to Software. Prefix decimal with \ or prefix hexadecimal with 0x or prefix a single control character . Xoff Char Set Xoff Char to be used when Flow Control is set to Software. Prefix decimal with \ or prefix hexadecimal with 0x or prefix a single control character .
7: Line and Tunnel Settings To configure a specific line in Command Mode, click Line in the menu and select Line 1 -> Command Mode (Table 7-2). Using the CLI To enter Line 1 command level: enable -> line 1 Using XML Include in your file: Include in your file: To View Line Statistics Using Web Manager To view statistics for a specific line, click Line in the menu and select Line 1 -> Statistics.
7: Line and Tunnel Settings Tunnel Serial Settings (continued) Description Protocol Protocol information here is display only. Go to the section, To Configure Line Settings to modify these settings. DTR Select the conditions in which the Data Terminal Ready (DTR) control signal on the serial line are asserted.
7: Line and Tunnel Settings Tunnel Packing Mode Settings (continued) Send Character Description Enter Control Characters in any of the following forms: J 0xA (hexadecimal) \10 (decimal) If used, the Send Character is a single printable character or a control character that, when read on the Serial Line, forces the queued data to be sent on the network immediately. Trailing Character Enter Control Characters in any of the following forms: J 0xA (hexadecimal) \10 (decimal).
7: Line and Tunnel Settings Table 7-5 Tunnel Accept Mode Settings Tunnel Accept Mode Settings Mode Description Set the method used to start a tunnel in Accept mode. Choices are: Local Port Set the port number for use as the network local port. The default local port number for each supported serial line number progresses sequentially in equal value so that Tunnel X : 1000X. For example: Protocol Disable = do not accept an incoming connection.
7: Line and Tunnel Settings Tunnel Accept Mode Settings (continued) Block Network Description Set whether Block Network is enabled for debugging purposes. Choices are: Password Enabled = if Enabled, incoming characters from the network will not be forwarded to the Serial Line. Instead, they will be buffered and will eventually flow off the network side. Disabled = this is the default setting; incoming characters from the network are sent on into the Serial Line.
7: Line and Tunnel Settings For Connect Mode using UDP, the PremierWave XCPremierWave XNPremierWave ENEDSMD4/8/16 accepts packets from any device on the network. It will send packets to the last device that sent it packets. Note: The Port in Connect Mode is not the same port configured in Accept Mode. The TCP keepalive time is the time in which probes are periodically sent to the other end of the connection. This ensures the other side is still connected.
7: Line and Tunnel Settings Tunnel Connect Mode Settings (continued) Description Email on Connect Select an email profile number to which an email notification will be sent upon the establishment of an accept mode tunnel. Email on Disconnect Select an email profile number to which an email notification will be sent upon the disconnection of an accept mode tunnel.
7: Line and Tunnel Settings To Configure Tunnel Disconnect Mode Settings Using Web Manager To configure the Disconnect Mode for a specific tunnel, click Tunnel in the menu and select Tunnel 1 -> Disconnect Mode.
7: Line and Tunnel Settings Tunnel Modem Emulation Settings Description Connect String Enter the customized Connect String sent to the Serial Line with the Connect Modem Response Code. Display Remote IP Set whether the Display Remote IP is enabled so that the incoming RING sent on the Serial Line is followed by the IP address of the caller.
8: Terminal and Host Settings Predefined connections are available via telnet, ssh, or a serial port. A user can choose one of the presented options and the device automatically makes the predefined connection. Either the Telnet, SSH, or serial port connection can present the CLI or the Login Connect Menu. By default, the CLI is presented when the device is accessed. When configured to present the Login Connect Menu, the hosts configured via the Host selections, and named serial lines are presented.
8: Terminal and Host Settings To Configure the Terminal Network Connection Using Web Manager To configure the Terminal on Network, click Terminal on the menu and select Network -> Configuration.
8: Terminal and Host Settings Host Settings (continued) Description SSH Username Enter a username to select a pre-configured Username/Password/ Key (configured on the SSH: Client Users), or leave it blank to be prompted for a username and password at connect time. Note: This field appears if you selected SSH as the protocol. Remote Address Enter an IP address for the host to which the device will connect. Remote Port Enter the port on the host to which the device will connect.
9: Services Settings DNS Settings This section describes the active run-time settings for the domain name system (DNS) protocol. The primary and secondary DNS addresses come from the active interface. The static addresses from the Network Interface configuration settings may be overridden by DHCP. Note: The blue text in the XML command strings of this chapter are to be replaced with a user-specified name.
9: Services Settings FTP Settings The FTP protocol can be used to upload and download user files, and upgrade the PremierWave XN firmware. A configurable option is provided to enable or disable access via this protocol. Table 9-2 FTP Settings FTP Settings Description State Select to enable or disable the FTP server: Enabled (default) Disabled To Configure FTP Settings Using Web Manager To configure FTP, gclick FTP in the menu.
9: Services Settings Syslog Settings (continued) Severity Log Level Description Specify the minimum level of system message the PremierWave should log. This setting applies to all syslog facilities. The drop-down list in the Web Manager is in descending order of severity (e.g., Emergency is more severe than Alert.) To View or Configure Syslog Settings: Using Web Manager To configure the Syslog, gclick Syslog in the menu.
9: Services Settings HTTP Settings (continued) Description Max Timeout Enter the maximum time for the HTTP server to wait when receiving a request. This prevents Denial-of-Service (DoS) attacks. The default is 10 seconds. Max Bytes Enter the maximum number of bytes the HTTP server accepts when receiving a request. The default is 40 KB (this prevents DoS attacks).
9: Services Settings Table 9-5 HTTP Authentication Settings HTTP Authentication Description Settings URI Enter the Uniform Resource Identifier (URI). Note: The URI must begin with ‘/’ to refer to the filesystem. Auth Type Select the authentication type: None = no authentication is necessary. Basic = encodes passwords using Base64. Digest = encodes passwords using MD5. SSL = can only be accessed over SSL (no password is required).
9: Services Settings RSS Settings Description Clear Click the button to clear RSS feed data.. To Configure RSS Settings Using Web Manager To configure RSS, gclick RSS in the menu.
10: Security Settings The PremierWave XN device supports Secure Shell (SSH) and Secure Sockets Layer (SSL). SSH is a network protocol for securely accessing a remote device. SSH provides a secure, encrypted communication channel between two hosts over a network. It provides authentication and message integrity services. Secure Sockets Layer (SSL) is a protocol that manages data transmission security over the Internet.
10: Security Settings RSS Settings (continued) Description Public Key Enter the path and name of the existing public key you want to upload. In WebManager, you can also browse to the public key to be uploaded. Key Type Select a key type to use for the new key: Bit Size RSA DSA Select a bit length for the new key: 512 768 1024 Note: SSH Keys from other programs may be converted to the required PremierWave format. Use Open SSH to perform the conversion.
10: Security Settings Table 10-3 SSH Server Authorized Users RSS Settings Description Username Enter a new username or edit an existing one. Password Enter a new password or edit an existing one. Public RSA Key Enter the path and name of the existing public RSA key you want to use with this user. In WebManager, you can also browse to the public RSA key to be uploaded. If authentication is successful with the key, no password is required.
10: Security Settings RSS Settings (continued) Bit Size Description Select the bit length of the new key: 512 768 1024 Using a larger Bit Size takes more time to generate the key. Approximate times are: 1 second for a 512 bit RSA key 1 second for a 768 bit RSA key 1 second for a 1024 bit RSA key 2 seconds for a 512 bit DSA key 2 seconds for a 768 bit DSA key 20 seconds for a 1024 bit DSA key Note: Some SSH clients require RSA host keys to be at least 1024 bits long.
10: Security Settings Certificate and Key Generation The PremierWave XN can generate self signed certificates and their corresponding keys. This can be done for both the rsa and dsa certificate formats. Certificates can be identified on the PremierWave XN by a name provided at generation time. Table 10-5 Certificate and Key Generation Settings Certificate Generation Settings Description Country (2 Letter Code) Enter the 2-letter country code to be assigned to the new self-signed certificate.
10: Security Settings Using XML Not applicable. Certificate Upload Settings SSL certificates identify the PremierWave XN to peers, and can be used with some methods of wireless authentication. Certificate and key pairs can be uploaded to the PremierWave XN through either the CLI or XML import mechanisms. Certificates can be identified on the PremierWave XN by a name provided at upload time.
10: Security Settings Trusted Authorities One or more authority certificates are needed to verify a peer's identity. Authority certificates are used with some wireless authentication methods. These certificates do not require a private key. Table 10-7 Trusted Authority Settings Trusted Authorities Settings Description Authority SSL authority certificate. RSA or DSA certificates are allowed. The format of the authority certificate can be PEM or PKCS7.
11: Maintenance and Diagnostics Settings Filesystem Settings Use the file system to list, view, add, remove, and transfer files. The PremierWave XN uses a flash file system to store. File Display It is possible to view the list of existing files, and to view their contents in the ASCII or hexadecimal formats. Table 11-1 File Display Settings File Display Commands Description ls Displays a list of files on the PremierWave, and their respective sizes. cat Displays the specified file in ASCII format.
11: Maintenance and Diagnostics Settings File Modification The PremierWave XN allows for the creation and removal of files on its filesystem. Table 11-2 File Modification Settings File Modification Commands Description rm Removes the specified file from the file system. touch Creates the specified file as an empty file. cp Creates a copy of a file. mkdir Creates a directory on the file system. rmdir Removes a directory from the file system. format Format the file system and remove all data.
11: Maintenance and Diagnostics Settings To Transfer or Modify Filesystem Files Using Web Manager To create a new file or directory, upload an existing file, copy or move a file, click Filesystem in the menu and select Browse. Using the CLI To enter the Filesystem command level: enable -> filesystem Using XML Not applicable. Protocol Stack Settings There are various low level network stack specific items that are available for configuration.
11: Maintenance and Diagnostics Settings ICMP Settings Table 11-5 ICMP Network Stack Settings Protocol Stack ICMP Settings Description State The State selection is used to turn on/off processing of ICMP messages. This includes both incoming and outgoing messages. Choose Enabled or Disabled. To Configure ICMP Network Stack Settings Using Web Manager To configure ICMP protocol settings, gclick Protocol Stack in the menu and select ICMP.
11: Maintenance and Diagnostics Settings SMTP Settings Table 11-7 SMTP Network Stack Settings Protocol Stack SMTP Settings Description Relay Address Address of all outbound email messages through a mail server. Can contain either a hostname or an IP address. Relay Port Port utilized for the delivery of outbound email messages. To Configure SMTP Network Stack Settings Using Web Manager To configure SMTP protocol settings, gclick Protocol Stack in the menu and select SMTP.
11: Maintenance and Diagnostics Settings Using XML Include in your file: and Diagnostics The PremierWave XN has several tools for diagnostics and statistics. Various options allow for the configuration or viewing of IP socket information, ping, traceroute, memory, and processes. Hardware To View Hardware Information Using Web Manager To view hardware information, gclick Diagnostics in the menu and select Hardware.
11: Maintenance and Diagnostics Settings Table 11-9 Ping Settings Diagnostics: Ping Settings Description Host Enter the IP address or host name for the PremierWave to ping. Count Enter the number of ping packets PremierWave should attempt to send to the Host. The default is 5. Timeout Enter the time, in seconds, for the PremierWave to wait for a response from the host before timing out. The default is 5 seconds.
11: Maintenance and Diagnostics Settings Log Table 11-11 Log Settings Diagnostics: Log Output Description Select a diagnostic log output type: Max Length Disable - Turn off the login feature. Filesystem - Directs logging to /log.txt. Line (1 or 2 ) - Directs logging to the selected serial line. Set the maximum length of the log.txt file. Note: This setting becomes available when Filesystem is selected.
11: Maintenance and Diagnostics Settings Processes The PremierWave XN Processes information shows all the processes currently running on the system. It shows the Process ID (PID), Parent Process ID (PPID), user, CPU percentage, percentage of total CPU cycles, and process command line information. To View Process Information Using Web Manager To view process information, gclick Diagnostics in the menu and select Processes.
11: Maintenance and Diagnostics Settings System Settings The PremierWave XN System settings allow for rebooting the device, restoring factory defaults, uploading new firmware and updating a system’s short and long name. Note: Anytime you reboot the unit, this operation will take some time to complete. Please wait a minimum of 10-20 seconds after rebooting the unit before attempting to make any subsequent connections.
12: Advanced Settings Email Settings View and configure email alerts relating to events occurring within the system. Table 12-1 Email Configuration Email – Configuration Settings Description To Enter the email address to which the email alerts will be sent. Multiple addresses are separated by semicolon (;). Required field if an email is to be sent. CC Enter the email address to which the email alerts will be copied. Multiple addresses are separated by semicolon (;).
12: Advanced Settings Using the CLI To enter Email command level: enable -> email 1 Using XML Include in your file: Command Line Interface Settings The Command Line Interface settings allow you to control how users connect to and interact with the PremierWave XN's command line. It is possible to configure access via the Telnet and SSH protocols, in addition to general CLI options.
12: Advanced Settings Using XML Include in your file: Telnet Settings The telnet settings control CLI access to the PremierWave XN over the Telnet protocol. Table 12-3 Telnet Settings Telnet Settings Description Telnet State Enable or Disable CLI access via telnet Telnet Port Enter an alternative Telnet Port to override the default used by the CLI server. Blank the field to restore the default.
12: Advanced Settings To Configure SSH Settings Using Web Manager To configure SSH settings, gclick CLI in the menu and select Configuration. Using the CLI To enter the SSH command level: enable -> config -> cli -> ssh Using XML Include in your file: and XML Settings The PremierWave XN allows for the configuration of units using an XML configuration record (XCR).
12: Advanced Settings XML Export Configuration Settings (continued) Description Lines to Export Select instances to be exported in the line, serial, tunnel and terminal groups. Groups to Export Check the configuration groups that are to be exported to the XML configuration record. The group list should be comma delimited and encased in double quotes. The list of available groups can be viewed with the “xcr list” command.
12: Advanced Settings Using XML Not applicable. XML: Import Configuration Here you can import a system configuration from an XML file. The XML data can be imported from a file on the file system or pasted into a CLI session. The groups to import can be specified at the command line, the default is all groups. Import Configuration from External File This import option requires entering the path and file name of the external XCR file you want to import.
13: Bridging PremierWave XN supports bridging of traffic between a single external Ethernet device and the wireless network. When bridging is enabled and active, the MAC address of the external device is used as the MAC address for the WLAN interface. The PremierWave XN then bridges traffic between the two interfaces. The external Ethernet device appears as a wireless node on the network. When bridging is enabled, the concept of the Primary Interface is introduced.
13: Bridging Bridging Operation During initialization, both eth0 and wlan0 are enabled and controlled by the bridging subsystem. Important aspects to keep in mind: If eth0 physical link is down, wlan0 is the Primary Interface. If eth0 physical link is up, eth0 is the Primary Interface. When eth0 link is up, wlan0 link is established, and the Bridging MAC Address is acquired (via preconfiguration or auto-detection), Bridging enters the Active state.
13: Bridging Using the CLI To enter the Bridge command level: enable -> config -> bridge 1 > config -> bridge br0 or enable - Using XML Include in your file: PremierWave XN User Guide 91
14: Security in Detail Public Key Infrastructure Public key infrastructure (PKI) is based on an encryption technique that uses two keys: a public key and private key. Public keys can be used to encrypt messages which can only be decrypted using the private key. This technique is referred to as asymmetric encryption, as opposed to symmetric encryption, in which a single secret key is used by both parties.
14: Security in Detail the exception of the root CA. This way, trust is transferred along the chain, from the root CA through any number of intermediate authorities, ultimately to the agent that needs to prove its authenticity. Obtaining Certificates Signed certificates are typically obtained from well-known CAs, such as VeriSign. This is done by submitting a certificate request for a CA, typically for a fee.
14: Security in Detail Steel Belted RADIUS Steel Belted RADIUS is a commercial RADIUS server from Juniper Networks that provides a GUI administration interface. It also provides a certificate request and self-signed certificate generator. The self-signed certificate has extension .sbrpvk and is in the PKCS12 format. OpenSSL can convert this into a PEM format certificate and key: openssl pkcs12 -in sbr_certkey.sbrpvk -nodes -out sbr_certkey.pem The sbr_certkey.pem file contains both certificate and key.
15: Updating Firmware Obtaining Firmware Obtain the most up-to-date firmware and release notes for the unit from the Lantronix Web site (www.lantronix.com/support/downloads/) or by using anonymous FTP (ftp://ftp.lantronix.com/). Loading New Firmware through FTP Firmware may be updated by sending the file to the PremierWave XN over an FTP connection. The destination file name on the PremierWave XN must be "firmware.rom". The device will reboot upon successful completion of the firmware upgrade.
16: VIP Settings Virtual IP (VIP) Configuration Configuring Connect Mode tunnels to use VIP is a simple matter of configuring a tunnel as is normally done, but also enabling VIP in the Tunnel Host settings, and using a VIP Name for the address. VIP Accept Mode tunnels do not require special configuration. If VIP access is enabled (in VIP configuration), then VIP Accept Mode requests from a ManageLinx device will be accepted.
16: VIP Settings Using XML Include in your file: Virtual IP (VIP) Counters Table 16-2 VIP Counters VIP Counters Description Data Bytes Total bytes in the TCP packets (not the UDP packets) UDP Packet Queue The number of packets queued for transmission. UDP Packets The number of packets transmitted. Note: UDP counts are packet based, and do not record the number of data bytes. To View VIP Counters Using Web Manager Click VIP on the menu and select Counters.
17: Branding the PremierWave XN This chapter describes how to brand your PremierWave XN by using Web Manager and Command Line Interface (CLI). It contains the following sections on customization: Web Manager Customization Short and Long Name Customization Web Manager Customization Customize the Web Manager's appearance by modifying index.html, style.css, and the product logo. The style (fonts, colors, and spacing) of the Web Manager is controlled with style.css.
17: Branding the PremierWave XN Short and Long Name Customization You can customize the short and long names in your PremierWave XN. The names display in the CLI show command and in the System web page in the Current Configuration table. The short name is used for the show command. Both names display in the CLI Product Type field. Table 17-1 Short and Long Name Settings Name Settings Description Short Name Enter a short name for the system name. A maximum of 32 characters are allowed.
Appendix A: Technical Support If you are unable to resolve an issue using the information in this documentation, please contact Technical Support: Technical Support US Check our online knowledge base or send a question to Technical Support at http://www.lantronix.com/support. Technical Support Europe, Middle East, Africa Phone: +33 13 930 4172 Email: eu_techsupp@lantronix.com or eu_support@lantronix.com Firmware downloads, FAQs, and the most up-to-date documentation are available at http://www.lantronix.
Appendix B: Binary to Hexadecimal Conversions Many of the unit's configuration procedures require you to assemble a series of options (represented as bits) into a complete command (represented as a byte). The resulting binary value must be converted to a hexadecimal representation. Use this chapter to learn to convert binary values to hexadecimals or to look up hexadecimal values in the tables of configuration options.
Appendix B: Binary to Hexadecimal Conversions Figure B-2 Windows Scientific Calculator 4. Click Hex. The hexadecimal value appears.
Appendix C: Compliance (According to ISO/IEC Guide 17050-1, 17050-2 and EN 45014) Manufacturer's Name & Address: Lantronix, Inc. 167 Technology Drive, Irvine, CA 92618 USA Product Name Model: PremierWave XN Device Server Conforms to the following standards or other normative documents: Emissions FCC Part 15 Subpart B Industry Canada ICES-003 Issue 4 February 2004 CISPR 22: 2005 + A1: 2005 + A2: 2006 Information Technology Equipment VCCI V-3/2010.
Appendix C: Compliance Manufacturer's Contact: Lantronix, Inc.
