PremierWave® XC User Guide Part Number 500-598 Revision B Oct 2011
Copyright & Trademark © 2011 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 is a trademark of XEROX Corporation. Windows is a trademark of Microsoft Corporation. Linux is a registered trademark of Linus Torvalds. Warranty For details on the Lantronix warranty replacement policy, please go to our web site at www.lantronix.
FCC Part 15.21 Statement Changes or modifications made to this equipment not expressly approved by the party responsible for compliance could void the user's authority to operate the equipment. FCC RF Radiation Exposure Statement This equipment complies with FCC radiation exposure limits set forth for an uncontrolled environment. End users must follow the specific operating instructions for satisfying RF exposure compliance.
Table of Contents Copyright & Trademark __________________________________________________________2 Warranty _____________________________________________________________________2 Contacts _____________________________________________________________________2 Disclaimer ____________________________________________________________________2 Revision History _______________________________________________________________3 1: Using This Guide 11 Purpose and Audience __________________________________________
Side Panel_________________________________________________________________22 Bottom Panel_______________________________________________________________23 Installing The PremierWave XC___________________________________________________23 4: Using DeviceInstaller 26 Accessing PremierWave XC using DeviceInstaller_____________________________________26 Device Detail Summary__________________________________________________________27 5: Configuration Using Web Manager 29 Accessing Web Manager____________
To Configure Network 2 Carrier Connection Settings 7: Line and Tunnel Settings 44 45 Line Settings__________________________________________________________________45 To View Line Statistics________________________________________________________47 To View Line Statistics________________________________________________________47 Tunnel Settings________________________________________________________________47 Serial Settings__________________________________________________________________48 To Configur
To Configure FTP Settings_____________________________________________________61 Syslog Settings________________________________________________________________62 To View or Configure Syslog Settings____________________________________________62 HTTP Settings_________________________________________________________________63 To Configure HTTP Settings____________________________________________________64 To Configure HTTP Authentication_______________________________________________65 RSS Settings__________
To View Hardware Information_________________________________________________ 76 IP Sockets_________________________________________________________________ 77 To View the List of IP Sockets_______________________________________________ 77 Ping______________________________________________________________________77 To Ping a Remote Host_____________________________________________________ 78 Traceroute_________________________________________________________________ 78 To Perform a Traceroute______________
Import Configuration from External File________________________________________87 Import Configuration from the Filesystem_______________________________________87 To Import Configuration in XML Format________________________________________87 Fail Over Settings_____________________________________________________________ 88 To Configure Fail Over Settings_________________________________________________88 WAN Connection Settings_______________________________________________________89 To Configure WAN Conn
Obtaining Firmware_____________________________________________________________99 Loading New Firmware__________________________________________________________99 16: VIP Settings 100 Virtual IP (VIP) Configuration____________________________________________________100 To Configure VIP Settings____________________________________________________100 Virtual IP (VIP) Status__________________________________________________________100 To View VIP Status_______________________________________________________
1: Using This Guide Purpose and Audience This guide provides the information needed to configure, use, and update the PremierWave XC. It is intended for software developers and system integrators who are deploying PremierWave in 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.
Chapter Description 15: Updating Firmware Instructions for obtaining the latest firmware and updating the PremierWave XC. 16: VIP Settings Information about Virtual IP (VIP) features available on the device and instructions on configuring settings. 17: Branding the PremierWave XC Instructions on how to brand your device. 18: Troubleshooting Describes common problems and error messages. Appendix A: Technical Support Instructions for contacting Lantronix Technical Support.
2: Introduction The PremierWave™ XC is a unique, hybrid Ethernet and GSM/GPRS terminal/multiport device server which allows remote access to and management of virtually any IT/networking equipment or device connected via Ethernet or GPRS through ‘Serial-tunneling’. Applications include medical equipment, POS terminals or security equipment. Key Features Power Supply: Regulated 9 - 30 Vdc input required. There is a step-down converter to 1.5 volts for the processor core.
Applications The PremierWave XC device server connects serial devices such as those listed below to Ethernet networks using the IP protocol family.
Configuration Methods After installation, the PremierWave XC requires configuration. For the unit to operate correctly on a network, it must have a unique IP address on the network. There are four basic methods for logging into the PremierWave XC and assigning IP addresses and other configurable settings: Web Manager: View and configure all settings easily through a web browser using the Lantronix Web Manager. (See “Configuration Using Web Manager” on page 29.
TCP Port 21: FTP UDP Port 69: TFTP UDP Port 30718: LDP (Lantronix Discovery Protocol) port TCP/UDP Port 10001: Tunnel 1 TCP/UDP Port 10002: Tunnel 2 Product Information Label The product information label on the unit contains the following information about the specific unit: Bar code Product Revision Part number Hardware Address (MAC Address) Manufacturing Date Code Figure 2-1 Product Label PremierWave XC User
3: Installation of PremierWave XC This chapter describes how to install the PremierWave XC device server. It contains the following sections: Package Contents User-Supplied Items Hardware Components Installing the PremierWave XC Package Contents The PremierWave XC package includes the following items: One PremierWave XC device One 3 Pin Terminal Mating Connector One 6 Pin Terminal Mating Connector One Power Supply 12VDC with International adapters One External Antenna, 1.
Hardware Components The PremierWave XC has two male DB9 serial ports that support RS-232/422/485. Figure 3-1 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. Figure 3-1 PremierWave XC Male DB9 DTE Serial Ports The RS-232 pinout configuration is shown in Figure 3-2. Figure 3-2 PremierWave XC Pinout Configuration for RS-232 The Full Duplex RS-422/485 pinout configuration is shown in Figure 3-3.
The Half Duplex RS-422/485 pinout configuration is shown in Figure 3-4. Figure 3-4 PremierWave XC Pinout Configuration for Half Duplex RS-422/485(2-wire) Back Panel On the PremierWave XC back panel, there is a Power 1 Plug, 3 Pin Terminal Connector for Backup Power, USB 1, USB 2, RJ-45 Ethernet port and reset button as shown in Figure 3-5.
Reset Button You can reset the PremierWave XC to factory defaults, including clearing the network settings. The IP address, gateway, and netmask are set to 00s. To reset the unit to factory defaults, perform the following steps. 1. Place the end of a paper clip or similar object into the reset opening and press and hold down micro switch during a power cycle for a minimum of 10-15 seconds. 2. Remove the paper clip to release the button.
Figure 3-6 PremierWave XC Top View Table 3-7 PremierWave XC LEDs and Descriptions LED Description Power GREEN – when power is properly supplied OFF – no power supplied GSM/GPRS GREEN - GPRS is connected. AMBER - GSM is connected. Once the radio connection has been established with the cellular carrier (e.g. after an APN has been properly configured). OFF – no connection.
LED Description Serial 2 GREEN – when Serial port 2 is transmitting data AMBER – when Serial port 2 is receiving data. OFF – when no data is being transmitted or received through Serial port 2. USB 1 GREEN - 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. USB 2 GREEN - 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.
Bottom Panel On the PremierWave XC Bottom panel, there is the SIM cover for the SIM card as shown in Figure 3-9. Figure 3-9 PremierWave XC bottom View Installing The PremierWave XC Be sure to place or mount the device securely on a flat horizontal or vertical surface. The device comes with mounting brackets for mounting the device vertically, for example on a wall. If using AC power, avoid outlets controlled by a wall switch.
2. Connect a RJ-45 Ethernet cable between the unit and your Ethernet network. 3. Remove SIM compartment door, secured by two screws. Open SIM slot fastener (sliding top fastener towards Power connector) and Insert the SIM Card in SIM slot (with contacts facing toward main board). Close and lock SIM slot fastener (sliding top fastener away from Power connector). Secure SIM compartment door accordingly and secure with screws provided. Connect the Antenna to the SMA connector on the side.
Figure 3-11 PremierWave XC SIM Insertion PremierWave XC User Guide 25
4: Using DeviceInstaller This chapter covers the steps for locating a PremierWave XC 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.
Device Detail Summary Notes:The settings are Display Only in this table unless otherwise noted Current Settings Description Name Name identifying the PremierWave XC. DHCP Device Name The name associated with the PremierWave XC module’s current IP address, if the IP address was obtained dynamically. Group Configurable field. Enter a group to categorize the PremierWave XC. Double-click the field, type in the value, and press Enter to complete.
Current Settings Description Supports Configurable Pins Shows False, indicating configurable pins are not available on the PremierWave XC. Supports Email Triggers Shows False, indicating email triggers are available on the PremierWave XC. Telnet Enabled Indicates whether Telnet is enabled on this PremierWave XC. Telnet Port Shows the PremierWave XC port for Telnet sessions. Web Enabled Indicates whether Web Manager access is enabled on this PremierWave XC.
5: Configuration Using Web Manager This chapter describes how to configure the PremierWave XC 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.
Device Status Page The Device Status page is the first page that appears after you log into the Web Manager. It also appears when you click Status in the Main Menu.
Web Manager Page Components The layout of a typical Web Manager page is below. Figure 5-1 Components of the Web Manager Page 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. To bring up a page, click it in the menu bar. The main area of the page has these additional sections: At the very top, many pages, such as the one in the example above, enable you to link to sub pages.
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 web page. In Chrome or Safari, it is necessary to close out of the browser to completely logout. If necessary, reopen the browser to log back in. The footer appears at the very bottom of the page.
Navigating the Web Manager The Web Manager provides an intuitive point-and-click interface. A menu bar on the left side of each page provides links you can click to navigate from one page to another. Some pages are read-only, while others let you change configuration settings. Note: There may be times when you must reboot the PremierWave XC for the new configuration settings to take effect. The chapters that follow indicate when a change requires a reboot.
Web Manager Page Description See Page Relay Output Lets you change the Initiation State, and customise the Relay output SMS command to open, close Relay Output. 89 RSS Lets you change current Really Simple Syndication (RSS) settings. 66 SSH Lets you change the configuration settings for SSH server host keys, SSH server authorized users, SSH client known hosts, and SSH client users. 84 SSL Lets you upload an existing certificate or create a new self-signed certificate.
6: Network Settings The Network Settings show the status of the Ethernet or Cellular 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 XC contains two network interfaces. The Ethernet interface is also called Network 1 or eth0, and the Cellular interface is called Network 2 or wwan0.
Default Gateway Enter the IP address of the router for this network. Note: This setting will be used if Static IP is active (both DHCP and BOOTP are Disable). Hostname Enter the hostname for the interface. It must begin with a letter or number, continue with a sequence of letters, numbers, or hyphens, and end with a letter or number. Note: This setting will take effect immediately, but will not register the hostname with a DNS server until the next reboot.
To View Network 1 Interface Status Using Web Manager On the Network Interface Status page, you can view both the current operational settings as well as the settings that would take effect upon a device reboot. To view the Ethernet (eth0) Status page, click Network on the menu and select Network 1 -> Interface -> Status. Network 1 Link Settings Physical link parameters can be configured for an Ethernet (eth0) Network Interface (see Table 62).
Using XML Include in your file: Network 2 Interface Status To View Network 2 Interface Status On the Network 2 Interface Status page, you can view the GSM/GPRS status of the device. To view the Network 2 (wwan0) Status page, click Network on the menu bar and select Network 2 -> Status. Network 2 SMS Outbound Settings Table 6-3 shows the settings for SMS Outbound, and Test Send Message.
Test Phone Number Input the Test recipient's phone number. Test Message Body Input the Test Message Body. Note: SMS Format is to be accordingly to the Message Body. When Text ASCII is selected -7 bit characters and typically limited to 160 characters per message. When Binary is selected -8 bit characters and typically limited to 140 characters per message. When Unicode is selected -16 bit characters and typically limited to 70 characters per message.
Received Number Input the Received Number 1 to 5. Note: Please input the Received Number to be included in device's White List.
Using XML Include in your file: Network 2 GSM/GPRS Bands Settings Table 6-6 shows the settings for GSM/GPRS Bands settings. Table 6-6 Network 2 (wwan0) GSM/GPRS Bands Settings Network 2 (wwan0) GSM/GPRS Settings Description GSM/GPRS Bands Select the GSM/GPRS Bands if needed Auto (Default) GSM-900 GSM-1800 GSM-850 GSM-1900 Note: These bands are the cellular frequencies designated by the ITU of the operation of GSM mobile phones.
Network 2 SIM Pin Settings Table 6-7 shows the settings for SIM Pin settings. Table 6-7 Network 2 (wwan0) SIM Pin Settings Network 2 (wwan0) SIM Pin Settings Description SIM Pin Input the SIM pin if required Note: The SIM PIN is a 4 digit numeric code used to unlock the SIM Card. This allows mobile devices to gain access network specific access information stored on the SIM.
APN Configuration The APN is a Network Identifier used by the Carrier to determine the type of Network Service you requested for your mobile device. You Service Provide will provide the APN information along with your SIM Card. Note: Do make sure that the APN, User Name, Password and Dialup Number is entered correctly, if not, GPRS attachment would fail. This typically refers to the Data Network Access (GPRS). GSM (Text SMS) functionality is typically does not require APN to operate.
To Configure Network 2 Carrier Connection Settings Using Web Manager To modify Network 2 Carrier Connection settings, click Network and select Network 2 → Configuration → Carrier Connection Using the CLI To enter the Network 2 Carrier Connection command level: enable -> config -> if 2 -> link -> carrier Using XML Include in your file: PremierWave XC User Guide 44
7: Line and Tunnel Settings The PremierWave XC contains two Lines. Lines 1 and 2 are standard RS232/RS485 serial ports. RS232/RS422/RS485 Lines 1 and 2 can be configured to operate in the following modes: RS232 RS422/RS485 Full Duplex RS422/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).
Parity Sets the Parity of the Line. The default is None. Data Bits Sets the number of data bits for the Line. The default is 8. Stop Bits Sets the number of stop bits for the Line. The default is 1. Flow Control Sets the flow control for the Line. The default is None. 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 .
To Configure Line Settings Note: The following section describes the steps to view and configure Line 1 settings; these steps apply to other line instances of the device. Using Web Manager To configure a specific line, click Line in the menu bar and select Line 1 -> Configuration (Table 7-1). To configure a specific line in Command Mode, click Line in the menu bar and select Line 1 > Command Mode (Table 7-2).
This page shows the settings for the tunnel selected at the top of the page and lets you change the settings. The Line Settings and Protocol are displayed for informational purposes and must be configured from the Line pages. Table 7-3 Tunnel Serial Settings Tunnel Serial Settings Description Line Settings Line Settings information here is display only. Go to the section, To Configure Line Settings to modify these settings. Protocol Protocol information here is display only.
Table 7-4 Tunnel Packing Mode Settings Tunnel Packing Mode Settings Description Mode Configure the Tunnel Packing Mode. Choices are: Disable = Data not packed. Timeout = data sent after timeout occurs. Send Character = data sent when the Send Character is read on the Serial Line. Threshold Sets the threshold (byte count). If the received serial data reaches this threshold, then the data will be sent on the network. Valid range is 100 to 1450 bytes. Default is 512.
In Accept Mode, the PremierWave XC listens (waits) for incoming connections from the network. A remove node on the network initiates the connection. The configurable local port is the port the remote device connects to for this connection. There is no remote port or address. The default local port is 10001 for serial line 1 and 10002 for serial line 2. Serial data can still be received while waiting for a network connection, keeping in mind serial data buffer limitations.
Block Serial Set whether Block Serial is enabled for debugging purposes. Choices are: Enabled = if Enabled, incoming characters from the Serial Line will not be forwarded to the network. Instead, they will be buffered and will eventually flow off the Serial Line if hardware or software flow control is configured. Disabled = this is the default setting; incoming characters from the Serial Line are sent on into the network. Any buffered characters are sent first.
Connect Mode In Connect Mode, the PremierWave XC continues to attempt an outgoing connection on the network, until established. If the connection attempt fails or the connection drops, then it retries after a timeout. The remote node on the network must listen for the Connect Mode’s connection. For Connect Mode to function, it must be enabled, have a remote station (node) configured, and a remote port configured (TCP or UDP). When established, Connect Mode is always on.
Block Serial Set whether Block Serial is enabled for debugging purposes. Choices are: Enabled = If Enabled, incoming characters from the Serial Line will not be forwarded to the network. Instead, they will be buffered and will eventually flow off the Serial Line if hardware or software flow control is configured. Disabled = this is the default setting; incoming characters from the Serial Line are sent on into the network. Any buffered characters are sent first.
Table 7-7 Tunnel Disconnect Mode Settings Tunnel Disconnect Mode Settings Description Stop Character Enter the Stop Character which when received on the Serial Line, disconnects the tunnel. The Stop Character may be designated as a single printable character or as a control character. Control characters may be input in any of the following forms: J or 0xA(hexadercimal) or \10 (decimal). Disable the Stop Character by blanking the field to set it to .
Echo Pluses Set whether the pluses will be echoed back during a “pause +++ pause” escape sequence on the Serial Line. Choices are: Enabled Disabled (default) Echo Commands Set whether characters read on the Serial Line will be echoed, while the Line is in Modem Command Mode. Choices are: Enabled Disabled (default) Verbose Response Set whether Modem Response Codes are sent out on the Serial Line.
Using XML Include in your file: Statistics Tunnel statistics contains data counters, error counters, connection time and connection information. Statistics are available at each individual connection and aggregated across all connections. To View Tunnel Statistics Using Web Manager To view statistics for a specific tunnel, click Tunnel in the menu bar and select the Tunnel 1 > Statistics.
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.
To Configure the Terminal Network Connection Using Web Manager To configure the Terminal on Network, click Terminal on the menu bar and select Network > Configuration.
SSH Username Appears if you selected SSH as the protocol. Enter a username to select a pre-configured Username/Password/Key (configured on the SSH: Client Users page), or leave it blank to be prompted for a username and password at connect time. 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 or BOOTP. Note: The blue text in the XML command strings of this chapter are to be replaced with a user-specified name.
DDNS Settings This section describes the needed Configurations for DDNS. You would need an account with DynDns.com. This would allows the device to connect to a sub-domain with regularly changing IP address. Table 9-2 DDNS Settings Setting / Field Configuration Description Enter the Account information Enabled / Disabled User Name Password Domain Note: A valid account with DynDNS.com is necessary for this service to work.
Using the CLI To enter the FTP command level: enable -> config -> ftp Using XML Include in your file: Syslog Settings The Syslog information shows the current configuration and statistics of the syslog. Here you can configure the syslog host and the severity of the events to log. Note: The system log is always saved to local storage, but it is not retained through reboots unless diagnostics logging to the filesystem is enabled.
HTTP Settings Hypertext Transfer Protocol (HTTP) is the transport protocol for communicating hypertext documents on the Internet. HTTP defines how messages are formatted and transmitted. It also defines the actions web servers and browsers should take in response to different commands. HTTP Authentication enables the requirement of usernames and passwords for access to the device. Table 9-5 HTTP Settings HTTP Settings Description State Enable or disable the HTTP server.
Log Format Set the log format string for the HTTP server.
Auth Type Select the authentication type: None = no authentication is necessary. Basic = encodes passwords using Base64. Digest = encodes passwords using MD5. SSL = the page can only be accessed over SSL (no password is required). SSL/Basic = the page is accessible only over SSL and encodes passwords using Base64. SSL/Digest = the page is accessible only over SSL and encodes passwords using MD5.
RSS Feed Select On to enable RSS feeds to an RSS publisher. Persistent Select On to enable the RSS feed to be written to a file (cfg_log.txt) and to be available across reboots. Max Entries Sets the maximum number of log entries. Only the last Max Entries are cached and viewable. To Configure RSS Settings Using Web Manager To configure RSS, click RSS in the menu bar.
10: Security Settings SSL Settings Secure Sockets Layer (SSL) is a protocol for managing the security of data transmission over the Internet. It provides encryption, authentication, and message integrity services. SSL is widely used for secure communication to a web server, and also for wireless authentication. Certificate/Private key combinations can be obtained from an external Certificate Authority (CA) and uploaded into the unit.
Key length Select the bit size of the new self-signed certificate. Choices are: 512 bits 768 bits 1024 bits 2048 bits The larger the bit size, the longer it takes to generate the key. Type Select the type of key: RSA = Public-Key Cryptography algorithm based on large prime numbers, invented by Rivest Shamir and Adleman. Used for encryption and signing. DSA = Digital Signature Algorithm also based on large prime numbers, but can only be used for signing.
New Private Key The key needs to belong to the certificate entered above. The format of the file must be PEM. It must start with “-----BEGIN RSA PRIVATE KEY-----” and end with “-----END RSA PRIVATE KEY-----”. Read DSA instead of RSA in case of a DSA key. Some Certificate Authorities add comments before and/or after these lines. Those need to be deleted before upload.
To Upload an Authority Certificate Using Web Manager To upload an Authority Certificate, click SSL in the menu bar and select Trusted Authorities.
11: Maintenance and Diagnostics Settings Filesystem Settings The PremierWave XC uses a flash file system to store files. Use the filesystem to list, view, add, remove, and transfer files. 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.
File Modification The PremierWave XC 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.
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 bar and select Browse. Using the CLI To enter the Filesystem command level: enable -> filesystem Using XML Not applicable. IP Network Stack Settings There are various low level network stack specific items that are available for configuration.
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, click Protocol Stack in the menu bar and select ICMP.
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, click Protocol Stack in the menu bar and select SMTP.
Using XML Include in your file: Query Port The query port (UDP port 0x77FE) is used for the automatic discovery of the device by the DeviceInstaller utility. Only 0x77FE discover messages from DeviceInstaller are supported. For more information on DeviceInstaller, see Chapter 4: Using DeviceInstaller on page 26. Table 11-9 Query Port Settings Query Port Settings Description Query Port Server Enables or disables listening and responding to query port messages.
Using Web Manager To view hardware information, click Diagnostics in the menu bar and select Hardware. Using the CLI To enter the command level: enable -> device, show hardware information Using XML Include in your file: IP Sockets You can view the list of listening and connected IP sockets. To View the List of IP Sockets Using Web Manager To view IP Sockets, click Diagnostics in the menu bar and select IP Sockets.
To Ping a Remote Host Using Web Manager To ping a Remote Host, click Diagnostics in the menu bar and select Ping. Using the CLI To enter the command level: enable Using XML Not applicable. Traceroute Here you can trace a packet from the PremierWave XC to an Internet host, showing how many hops the packet requires to reach the host and how long each hop takes. If you visit a web site whose pages appear slowly, you can use traceroute to determine where the longest delays are occurring.
Using the CLI To enter the command level: enable -> config -> diagnostics -> log Using XML Include in your file: and Memory The memory information shows the total, used, and available memory (in kilobytes). To View Memory Usage Using Web Manager To view memory information, click Diagnostics in the menu bar and select Memory.
Using XML Include in your file: Route The PremierWave XC Route information shows the system's routing table. It shows Destination, Gateway, Genmask, Flag, Metric, Ref, Use and Interface. To View Route Information Using Web Manager To view process information, click Diagnostics in the menu bar and select Route.
System Settings The PremierWave XC System settings allow for rebooting the device, restoring factory defaults, uploading new firmware and updating a system’s short and long name. Table 11-12 System Settings System Settings Description Reboot Device This reboots the device. Restore Factory Defaults This restores the device to the original factory settings. All configuration will be lost. The PremierWave XC automatically reboots upon setting back to the defaults.
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 (;).
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's command line. It is possible to configure access via the Telnet and SSH protocols, in addition to general CLI options. Basic CLI Settings The basic CLI settings control general CLI access and usability options.
Telnet Settings The telnet settings control CLI access to the PremierWave XC over the Telnet protocol. Table 12-4 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. Telnet Max Sessions Specify the maximum number of concurrent Telnet sessions that will be allowed.
To Configure SSH Settings Using Web Manager To configure SSH settings, click CLI in the menu bar 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 XC allows for the configuration of units using an XML configuration record (XCR). Export a current configuration for use on other PremierWave XCs or import a saved configuration file.
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. To Export Configuration in XML Format Using Web Manager To export configuration format, click XML in the menu bar and select Export Configuration. Using the CLI To enter the XML command level: enable -> xml Using XML Not applicable.
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.
Fail Over Settings Fail Over is the process of allowing a second Network interface to backup the Primary (Wan Connection) configured interface. It uses a Dead Remote Host reachability (Ping) mechanism to determine when it should Fail Over to the second interface. Fail Over automatically uses the Primary Network configured DNS Servers as the Remote Host, if one is not configured. Table 12-9 Fail Over Settings Fail Over Settings Description State Enable or Disable the Fail Over.
Using the CLI To enter the XML command level: enable -> config → failover mode Using XML Include in your file: WAN Connection Settings To configure the default WAN Connection to be Ethernet or Cellular. Table 12-10 WAN Connection Settings WAN Connection Settings Description Network Select Ethernet or Cellular to be default connection.
SMS Close CMD Customize: SMS controls relay output to be close state command To Configure Relay Output Settings Using Web Manager To configure Relay Output settings, click Relay Output on the menu.
13: Events Event Overview The Premier Wave XC support configuration of several Alerts for specific Events detected. The supported Alerts are SMS Text Messaging, SNMP Traps and Premier Waves built in Relay Output Control. The supported Events are; Main and Backup Power Failure - Premier Wave Monitors both input power states and triggers one or more configurable Alerts.
Send SNMP Trap Enable or disable the SNMP Trap Note: must be configured beforehand. To Configure Input 1 Settings Using Web Manager To configure Input 1 settings, click Events on the menu bar, and click Input 1.
To Configure Main Power Fail Settings Using Web Manager To configure Main Power Fail settings, click Events on the menu bar, and click Main Power Fail.
To Configure Wwan0 Link Down Settings Using Web Manager To configure Cellular Link Down settings, click Events on the menu bar, and click Wwan0 Link Down.
After resolving the events, you would need to clear events. To Clear Events Using Web Manager To clear Events, click Events on the menu bar , and click Clear Event button. Using the CLI To enter the XML command level: clear events Using the XML Not applicable.
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.
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.
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/documentation) or by using anonymous FTP (ftp://ftp.lantronix.com/). Loading New Firmware Firmware may be updated by sending the file to the PremierWave XC over a FTP connection. The destination file name on the PremierWave XC 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.
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 bar and select Counters.
17: Branding the PremierWave XC This chapter describes how to brand your PremierWave XC 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.
Short and Long Name Customization You can customize the short and long names in your PremierWave XC. 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. Long Name Enter a long name for the system name.
18: Troubleshooting This chapter discusses how you can diagnose and fix errors quickly without having to contact a dealer or Lantronix. When troubleshooting, always ensure that the physical connections (power cable, network cable, serial cable, antenna, SIM card) are secure.
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.
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 167 Technology Drive, Irvine, CA 92618 USA Product Name Model: PremierWave XC Embedded Device Server Conforms to the following standards or other normative documents: FCC Part 15.247/15.407 Class B RSS-210 RSS-Gen Issue 2 ICES-003 Issue 4 ETSI EN 301 489-1 V1.8.1 ETSI EN 301 489-17 V1.3.2 ETSI EN 300 328 V1.7.1 ETSI EN 301 893 V1.5.
Warning: Please keep a safety distance of 23cm from Antenna due to RF exposure.
RoHS Notice All Lantronix products in the following families are China RoHS-compliant and free of the following hazardous substances and elements: ¾ ¾ Lead (Pb) Cadmium (Cd) Product Family Name ¾ ¾ Mercury (Hg) Hexavalent Chromium (Cr (VI)) ¾ ¾ Polybrominated biphenyls (PBB) Polybrominated diphenyl ethers (PBDE) Toxic or hazardous Substances and Elements Lead (Pb) Mercury (Hg) Cadmium Hexavalent Chromium Polybrominated (Cd) (Cr (VI)) biphenyls (PBB) Polybrominated diphenyl ethers (PBDE) UDS1100
