PremierWave XC User Guide Part Number 900-598 Revision A June 2012
Copyright & Trademark © 2012 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. Lantronix® and PremierWave® are registered trademarks, and DeviceInstaller™ is a trademark of Lantronix, Inc. Ethernet is a trademark of XEROX Corporation. Windows is a trademark of Microsoft Corporation. Linux is a registered trademark of Linus Torvalds.
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 FCC Part 15.
Table of Contents 4: Using DeviceInstaller 26 Accessing PremierWave XC using DeviceInstaller ________________________________ 26 5: Configuration Using Web Manager Accessing Web Manager ____________________________________________________ Device Status Page_____________________________________________________ Web Manager Page Components _____________________________________________ Navigating the Web Manager ________________________________________________ 6: Network Settings WAN Connection Settings __
Table of Contents To Configure Line Settings _______________________________________________ Statistics _____________________________________________________________ To View Line Statistics __________________________________________________ Tunnel Settings ___________________________________________________________ Serial Settings _________________________________________________________ To Configure Tunnel Serial Settings ________________________________________ Packing Mode _______________________________
Table of Contents To Configure an Existing SSL Credential ____________________________________ 69 Trusted Authorities _____________________________________________________ 70 To Upload an Authority Certificate__________________________________________ 70 11: Maintenance and Diagnostics Settings Filesystem Settings ________________________________________________________ File Display ___________________________________________________________ To Display Files ______________________________________________
Table of Contents To View and Configure Basic CLI Settings ___________________________________ Telnet Settings _________________________________________________________ To Configure Telnet Settings ______________________________________________ SSH Settings __________________________________________________________ To Configure SSH Settings _______________________________________________ XML Settings _____________________________________________________________ XML: Export Configuration ____________________
Table of Contents 17: Troubleshooting 102 Diagnostic LED States _____________________________________________________ 102 Problems and Error Messages ______________________________________________ 102 Appendix A: Technical Support 104 Appendix B: Binary to Hexadecimal Conversions 105 Converting Binary to Hexadecimal ___________________________________________ 105 Conversion Table _____________________________________________________ 105 Scientific Calculator ________________________________________
List of Figures List of Figures Figure 2-1 Product Label ____________________________________________________ 17 Figure 3-1 PremierWave XC Male DB9 DTE Serial Ports ___________________________ 19 Figure 3-2 PremierWave XC Pinout Configuration for RS-232 _______________________ 19 Figure 3-3 PremierWave XC Pinout Configuration for Full Duplex RS-422/485 (4-wire) ___ 19 Figure 3-4 PremierWave XC Pinout Configuration for Half Duplex RS-485 (2-wire) ______ 19 Figure 3-5 PremierWave XC Back Panel View _________
List of Tables Table 7-7 Tunnel Disconnect Mode Settings _____________________________________ 55 Table 7-8 Tunnel Modem Emulation Settings ____________________________________ 56 Table 8-1 Terminal on Network and Line Settings _________________________________ 58 Table 8-2 Host Configuration _________________________________________________ 59 Table 9-1 DNS Settings _____________________________________________________ 61 Table 9-2 FTP Settings _____________________________________________________ 62 Table
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.
1: Using This Guide Chapter Description 15: Updating Firmware Instructions for obtaining the latest firmware and updating the PremierWave XC. 16: Branding the PremierWave XC Instructions on how to brand your device. 17: Troubleshooting Describes common problems and error messages. Appendix A: Technical Support Instructions for contacting Lantronix Technical Support. Appendix B: Binary to Hexadecimal Conversions Instructions for converting binary values to hexadecimals.
2: Introduction The PremierWave XC is a unique, hybrid Ethernet and GSM/GPRS dual port serial 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.
2: Introduction Protocol Support The PremierWave XC device server contains a full-featured IP stack.
2: Introduction Addresses and Port Numbers Hardware Address The hardware address is also referred to as the Ethernet address or MAC address. The first three bytes of the Ethernet address are fixed and identify the unit as a Lantronix product. The fourth, fifth, and sixth bytes are unique numbers assigned to each unit. Sample Hardware Address: 00-80-A3-14-01-18 00:80:A3:14:01:18 IP Address Every device connected to an IP network must have a unique IP address.
2: Introduction Figure 2-1 Product Label Part Number International Mobile Equipment Identity Number MAC Address Country of Origin PremierWave XC User Guide Revision Manufacturing Date Code 17
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: PremierWave XC device 3-pin Terminal Mating Connector 6-pin Terminal Mating Connector RJ-45 Ethernet Straight Cat5 Cable, 1.
3: Installation of PremierWave XC Hardware Components The PremierWave XC has two male DB9 serial ports that support RS-232/422/485. Figure 3-1 shows the front panel 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 XC Back Panel On the PremierWave XC back panel, there is a Barrel Connector for Primary Power (Power 1), 3Pin Terminal Connector for Secondary Power (Power 2), USB 1, USB 2, RJ-45 Ethernet Port and Reset button as shown in Figure 3-5.
3: Installation of PremierWave XC Top Panel Figure 3-6 shows the top panel view of the PremierWave XC. Table 3-1 list and describes the LEDs. Figure 3-6 PremierWave XC Top View Table 3-1 PremierWave XC LEDs and Descriptions LED Description Power GREEN – power is properly supplied OFF – no power supplied GSM/GPRS GREEN - GPRS is connected (e.g. after an APN has been properly configured) AMBER - GSM is connected. Once the radio connection has been established with the cellular provider.
3: Installation of PremierWave XC LED Description USB 1 GREEN - a USB device is connected to USB 1 Host port and is functioning properly OFF- no USB device is connected to USB 1 Host port USB 2 GREEN - a USB device is connected to USB 2 Host port and is functioning properly OFF- no USB device is connected to USB 2 Host port Fault RED- blinking when Events or Errors occurred OFF - system functioning normally GSM Signal Strength GREEN – 3 to 5 LEDs lighted.
3: Installation of PremierWave XC Bottom Panel On the PremierWave XC bottom panel, there is a SIM cover as shown in Figure 3-8. Figure 3-8 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.
3: Installation of PremierWave XC 3. Connect serial devices to the serial port of the unit. 4. Connect an RJ-45 Ethernet cable between the unit and your Ethernet network. 5. Plug the PremierWave XC into the power outlet by using the power supply that was included in the packaging. 6. Power up Serial Devices.
3: Installation of PremierWave XC Figure 3-11 PremierWave XC Dimensions 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.
4: Using DeviceInstaller Current Settings Description Group Configurable field. Enter a group to categorize the PremierWave XC. 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 XC. Doubleclick the field, type in the value, and press Enter to complete.
4: Using DeviceInstaller Current Settings Description Telnet Supported Shows True, indicating telnet is supported on this PremierWave XC. Telnet Port Shows the PremierWave XC port for Telnet sessions. Web Port Shows the PremierWave XC port for Web Manager configuration. Firmware Upgradable Shows True, indicating the PremierWave XC firmware is upgradable as newer versions become available.
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.
5: Configuration Using Web Manager 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.
5: Configuration Using Web Manager Web Manager Page Components The layout of a typical Web Manager page is below. Figure 5-2 Components of the Web Manager Page Items to Configure Links to Subpages Logout Button Header Menu Bar Footer Configuration and/or Status Area Information and Help Area 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.
5: Configuration Using Web Manager 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. It contains copyright information and a link to the Lantronix home page. Navigating the Web Manager The Web Manager provides an intuitive point-and-click interface.
5: Configuration Using Web Manager Web Manager Page Description See Page Network Shows status and lets you configure the network interface, WAN connection, and DDNS. 34 Protocol Stack Lets you perform lower level network stack-specific activities. 73 Query Port Lets you change configuration settings for the query port. 76 Relay Output Lets you change the Initiation State, and customise the Relay output SMS command to open, close Relay Output.
6: Network Settings 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. 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 respective network traffic.
6: Network Settings Table 6-2 DDNS Settings Note: A valid account with DynDNS.com is necessary for this service to work. Setting / Field Description State Select Enabled or Disabled. User Name Enter or modify DDNS account user name. Password Enter or modify DDNS account password. Domain Enter or modify DDNS account host domain. To View or Configure DDNS Settings Using Web Manager To configure DDNS settings, click Network in the menu bar and select DDNS.
6: Network Settings Network Interface Settings Description DHCP Client Select On or Off. At boot up, after the physical link is up, the PremierWave XC will attempt to obtain IP settings from a DHCP server and will periodically renew these settings with the server. Note: Overrides BOOTP, the configured IP address/mask, gateway, hostname, and domain. Changing this value requires you to reboot the device. Note: Within WebManager, click Renew to renew the DHCP lease.
6: Network Settings To Configure Network 1 Interface Settings Using Web Manager To modify Ethernet (eth0) settings, click Network on the menu and select Network 1 -> Interface -> Configuration.
6: Network Settings To Configure Network 1 Link Settings Using Web Manager To modify Ethernet (eth0) Link information, click Network on the menu and select Network 1 -> Link. Using the CLI To enter the eth0 Link command level: enable -> config -> if 1 -> link 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.
6: Network Settings Network 2 (wwan0) SMS Outbound Settings Description 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.
6: Network Settings Table 6-6 Network 2 (wwan0) SMS Inbound Settings Network 2 (wwan0) SMS Inbound Settings Description State Select Enabled or Disabled. When Enabled and the number matches an entry in the whitelist, the device will handle the SMS. When Disabled, any received SMS will be discarded. Received Number Input the Received Number . At least 1 Received Number must be configured for an SMS to be processed. A maximum of 5 Received Number entries are allowed.
6: Network Settings To Configure Network 2 Roam Settings Using Web Manager To modify Network 2 GSM/GPRS band settings, click Network on the menu bar and select Network 2 → Configuration → Roam Using the CLI To enter the Network 2 GSM/GPRS command level: enable -> config -> if 2 ->link -> roam Using XML Include in your file: Network 2 GSM/GPRS Bands Settings The table below shows the settings for GSM/GPRS Bands settings.
6: Network Settings Using XML Include in your file: Network 2 SIM Pin Settings The SIM PIN is a 4 digit numeric code used to unlock the SIM card. This allows mobile devices to gain access to network specific information stored on the SIM. If the SIM PIN functionality is enabled on the SIM card, Network Registration will not start until after a valid PIN number has been configured. This is for both the GSM and and GPRS networks.
6: Network Settings Network 2 APN Configuration Settings The APN is a Network Identifier used by the carrier to determine the type of network service you requested for your mobile device. Your service provider will provide the APN information along with your SIM card. Note: 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).
6: Network Settings Network 2 Carrier Connection Settings The Carrier Connection is the identity of the carrier(s) supported by the SIM card provider. The table below shows the settings for Carrier Connection configuration. Table 6-11 Network 2 (wwan0) Carrier Connection Settings Network 2 (wwan0) Carrier Connection Settings Description Carrier Connection This identifies the carriers supported by the SIM card provider.
6: Network Settings Network 2 (wwan0) SMS Statistics Description Timestamp Displays the timestamp information for the wwan0 module. Content Displays the current content of the wwan0 module.
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).
7: Line and Tunnel Settings Line Settings Description Baud Rate Sets the Baud Rate (speed) of the Line. The default is 9600. Any set speed between 300 and 921600 may be selected: 300, 600, 1200, 2400, 4800, 9600, 19200, 38400, 57600, 115200, 230400, 460800, 921600. When selecting Custom baud rate (available for line 1 and line 2 only), you may manually enter any value between 300 and 5000000. Parity Sets the Parity of the Line. The default is None.
7: Line and Tunnel Settings Line Command Mode Settings Description Serial String Enter the Text or Binary string of bytes that must be read on the Serial Line during boot time in order to enable Command Mode. It may contain a time element to specify a required delay in milliseconds x, formed as {x}. Applies only if mode is “Use Serial String”. It may contain a binary character(s) of the form [x]. For example, use decimal [12] or hex [0xc].
7: Line and Tunnel Settings Using XML Include in your file: Tunnel Settings Tunneling allows serial devices to communicate over a network, without “being aware” of the devices which establish the network connection between them. Tunneling parameters are configured using the Tunnel menu and submenus. The Tunnel settings allow you to configure how the Serial-Network tunneling operates. Tunneling is available on all serial Lines.
7: Line and Tunnel Settings To Configure Tunnel Serial Settings Using Web Manager To configure the Serial Settings for a specific tunnel, click Tunnel in the menu bar and select Tunnel 1 -> Serial Settings. Using the CLI To enter Tunnel 1 command level: enable -> tunnel 1 -> serial Using XML Include in your file: Packing Mode With Packing, data from the serial Line is not sent over the network immediately.
7: Line and Tunnel Settings To Configure Tunnel Packing Mode Settings Using Web Manager To configure the Packing Mode for a specific tunnel, click Tunnel in the menu bar and select Tunnel 1 -> Packing Mode. Using the CLI To enter the Tunnel 1 Packing command level: enable -> tunnel 1 -> packing Using XML Include in your file: Accept Mode In Accept Mode, the PremierWave XC listens (waits) for incoming connections from the network.
7: Line and Tunnel Settings Tunnel Accept Mode Description Settings Telnet TCP Keep Alive Enter the time, in milliseconds, the PremierWave XC waits during a silent connection before checking if the currently connected network device is still on the network. If the unit then gets no response after 8 attempt, it drops the connection. Enter 0 to disable. Flush Serial Sets whether the serial Line data buffer is flushed upon a new network connection.
7: Line and Tunnel Settings Using the CLI To enter Tunnel 1 Accept Mode command level: enable -> tunnel 1 -> accept Using XML Include in your file: 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.
7: Line and Tunnel Settings Tunnel Connect Mode Settings Description Flush Serial Data Sets whether the serial Line data buffer is flushed upon a new network connection. Choices are: Enabled = serial data buffer is flushed on network connection Disabled = serial data buffer is not flushed on network connection (default) Block Serial Set whether Block Serial is enabled for debugging purposes.
7: Line and Tunnel Settings Disconnect Mode Specifies the optional conditions for disconnecting any Accept Mode or Connect Mode connection that may be established. If any of these conditions are selected but do not occur and the network disconnects to the device, a Connect Mode connection will attempt to reconnect. However, if none of these conditions are selected, a closure from the network is taken as a disconnect.
7: Line and Tunnel Settings Modem Emulation Some older equipment is designed to attach to a serial port and dial into a network with a modem. This equipment uses AT commands to control the connection. For compatibility with these older devices on modern networks, our product mimics the behavior of the modem.
7: Line and Tunnel Settings To Configure Tunnel Modem Emulation Settings Using Web Manager To configure the Modem Emulation for a specific tunnel, click Tunnel in the menu bar and select Tunnel 1 -> Modem Emulation. Using the CLI To enter the Tunnel 1 Modem command level: enable -> tunnel 1 -> modem Using XML Include in your file: Statistics Tunnel statistics contains data counters, error counters, connection time and connection information.
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 bar and select Network -> Configuration.
8: Terminal and Host Settings Host Settings Description 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.
9: Services Settings FTP Settings The FTP protocol can be used to upload and download user files, and upgrade the PremierWave firmware. A configurable option is provided to enable or disable access via this protocol. Table 9-2 FTP Settings FTP Settings Description State Select Enabled or Disabled for the state of the FTP server. To Configure FTP Settings Using Web Manager To configure FTP, click FTP in the menu bar.
9: Services Settings To View or Configure Syslog Settings Using Web Manager To configure the Syslog, click Syslog in the menu bar. Using the CLI To enter the Syslog command level: enable -> config -> syslog Using XML Include in your file: 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.
9: Services Settings HTTP Settings Description Logging State Select Enabled or Disabled for the state of the HTTP server logging. Max Log Entries Sets the maximum number of HTTP server log entries. Only the last Max Log Entries are cached and viewable. Log Format Set the log format string for the HTTP server.
9: Services Settings HTTP Authentication Settings Description 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.
9: Services Settings RSS Settings Really Simple Syndication (RSS) (sometimes referred to as Rich Site Summary) is a method of feeding online content to Web users. Instead of actively searching for configuration changes, RSS feeds permit viewing only relevant and new information regarding changes made to the via an RSS publisher. The RSS feeds may also be stored to the file system cfg_log.txt file.
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.
10: Security Settings Certificate Generation Settings Description 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.
10: Security Settings Certificate Upload Settings SSL certificates identify the PremierWave XC to peers, and can be used with some methods of wireless authentication. Certificate and key pairs can be uploaded to the PremierWave through either the CLI or XML import mechanisms. Certificates can be identified on the PremierWave by a name provided at upload time. Table 10-2 Upload Certificate Settings Upload Certificate Description Settings New Certificate SSL certificate to be uploaded.
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-3 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 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.
11: Maintenance and Diagnostics Settings 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.
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 bar 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 IP network stack specific items that are available for configuration.
11: Maintenance and Diagnostics Settings Table 11-5 ICMP Network Stack Settings Protocol Stack ICMP Settings Description State Select Enabled or Disabled. The State selection is used to turn on/off processing of ICMP messages. This includes both incoming and outgoing messages. To Configure ICMP Network Stack Settings Using Web Manager To configure ICMP protocol settings, click Protocol Stack in the menu bar and select ICMP.
11: Maintenance and Diagnostics Settings Table 11-7 SMTP Network Stack Settings Protocol Stack SMTP Settings Description Relay Address Address of all outbound 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.
11: Maintenance and Diagnostics Settings Using the CLI To enter the command level: enable -> config -> snmp 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.
11: Maintenance and Diagnostics Settings Diagnostics The PremierWave XC has several tools for diagnostics and statistics. Various options allow for the configuration or viewing of IP socket information, ping, traceroute, memory, processes, log, route and threads. Hardware To View Hardware Information Using Web Manager To view hardware information, click Diagnostics in the menu bar and select Hardware.
11: Maintenance and Diagnostics Settings Diagnostics: Ping Settings Description Timeout Enter the time, in seconds, for the PremierWave XC to wait for a response from the host before timing out. The default is 5 seconds. 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.
11: Maintenance and Diagnostics Settings Log Table 11-12 Log Settings Diagnostics: Log Settings Description Output Select a diagnostic log output type: Disable Filesystem Line 1 Line 2 Max Length Set the maximum length of the log.txt file. Note: This setting becomes available when Filesystem is selected. To Configure the Diagnostic Log Output Using Web Manager To configure the Diagnostic Log output, click Diagnostics in the menu bar and select Log.
11: Maintenance and Diagnostics Settings Processes The PremierWave XC 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, click Diagnostics in the menu bar and select Processes.
11: Maintenance and Diagnostics Settings 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-13 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.
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'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 XC over the Telnet protocol. Table 12-3 Telnet Settings Telnet Settings Description Telnet State Select Enabled or Disabled to 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 SSH Settings The SSH settings control CLI access to the PremierWave XC over the SSH protocol. Table 12-4 SSH Settings SSH Settings Description SSH State Select Enabled or Disabled to enable or disable CLI access via SSH. SSH Port Specify the SSH Port and override the default, as needed. Blank the field to restore the default. SSH Max Sessions Specify the maximum number of concurrent SSH sessions that will be allowed.
12: Advanced Settings Table 12-5 XML Exporting Configuration XML Export Configuration Settings Description Export to browser Select this option to export the XCR data in the selected fields to the browser. Use the “xcr dump” command to export the data to the browser. Export to local file Select this option to export the XCR data to a file on the device. If you select this option, enter a file name for the XML configuration record. Use the “xcr export” command to export the data to a local file.
12: Advanced Settings XML: Export Status You can export the current status in XML format. By default, all groups are exported. You may also select a subset of groups to export. Table 12-6 Exporting Status XML Export Status Settings Description Export to browser Select this option to export the XCR data in the selected fields to the browser. Use the “xcr dump” command to export the data to the browser. Export to local file Select this option to export the XCR data to a file on the device.
12: Advanced Settings Import Configuration from the Filesystem This import option picks up settings from a file and your import selections of groups, lines, and instances. The list of files can be viewed from the filesystem level of the CLI. Table 12-7 Import Configuration from Filesystem Settings Import Configuration from Filesystem Settings Description Filename Enter the name of the file on the PremierWave XC (local to its filesystem) that contains XCR data.
12: Advanced Settings Failover Settings Description Ping Timeout Interval Enter the value for the Ping Timeout Interval. Maximum duration of executing one Ping command. Note: Default value is 30. Ping Interval Enter the value for the Ping Interval. Device will ping Remote host every defined seconds. Note: Default value is 3. Max. Failed Pings (before Failover) Enter the number for Max. Failed Pings If device fails to connect after defined attempts, device will failover to secondary connection.
12: Advanced Settings Relay Output Settings The PremierWave XC allows Relay Output state to be controlled by events, user commands and SMS inbound messaging. Configuration of the Relay Output settings allow you to configure the initial state for the Relay Output after boot up, test the Open and Close state of the relay, and configure the SMS inbound message to control the Open and Close state of the Relay output.
13: Events Event Overview The PremierWave XC supports configuration of several alerts for specific events detected. The supported alerts are SMS text messaging, SNMP traps and PremierWave’s built in Relay Output control. Different events such as Input 1, Input 2, Main Power Fail, Backup Power Fail, Wwan0 Link Down and Ethernet Link Down could be configured to generate alerts. Main and Backup Power Failure - PremierWave monitors both input power states and triggers one or more configurable alerts.
13: Events To Configure Input 1 Settings Using Web Manager To configure Input 1 settings, click Events on the menu bar, and click Input 1.
13: Events Using XML Include in your file: for Main Power Fail Relay Output Include in your file: for Main Power Fail Send SMS Include in your file: for Main Power Fail Send SNMP Trap To Configure Backup Power Fail Settings Using Web Manager To configure Backup Power Fail settings, click Events on the menu bar, and click Backup Power Fail.
13: Events To Configure Ethernet Link Down Settings Using Web Manager To configure Ethernet Link Down settings, click Events on the menu bar, and click Ethernet Link Down.
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/documentation) or by using anonymous FTP (ftp://ftp.lantronix.com/). Loading New Firmware through Web Manager Reload the firmware using the device web manager Filesystem page. To upload new firmware: 1. Select Filesystem in the menu bar. The Filesystem > Statistics page appears. 2.
15: Updating Firmware Loading New Firmware through FTP 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. Example FTP session: $ ftp 192.168.10.127 Connected to 192.168.10.127. 220 (vsFTPd 2.0.7) Name (192.168.10.127:user): admin 331 Please specify the password. Password: 230 Login successful. Remote system type is UNIX.
16: 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.
16: Branding the PremierWave XC Table 16-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. A maximum of 64 characters are allowed. To Customize Short or Long Names Using Web Manager To access the area with options to customize the short name and the long name of the product, or to view the current configuration, click System in the menu bar.
17: 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.
17: Troubleshooting Problem/Message Reason Solution APN/user name/password is blank. APN, user name or password that is required, are missing. Verify APN settings with Network Operator. Do ensure that SIM has GPRSenabled. Open GSM/GPRS tunnel failed Unable to open GSM/GPRS tunnel. Verify if device is on the GSM/GPRS network. Verify APN settings with Network Operator. Do ensure that SIM has GPRSenabled. DDNS no username/password/domain name Required field missing. Verify Login detail is entered.
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. Phone: (800) 422-7044 (US Only) (949) 453-7198 Technical Support Europe, Middle East, Africa Phone: +33 13 930 4172 +49 (0) 180 500 13 53 (Germany Only) Email: eu_techsupp@lantronix.com or eu_support@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-1 Hexadecimal Values in the 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 XC External Device Server Conforms to the following standards or other normative documents: FCC Part 15 Class B FCC Part 22H, Part 24E CE 1588 AS/NZS EN 301 511 V9.02 EN 301 489-1 V1.8.1 EN 301 489-7 V1.3.
Appendix C: Compliance Device Label with CE Mark and FCC ID WARNING: Please keep a safety distance of 23cm from antenna due to RF exposure. Manufacturer's Contact: Lantronix, Inc.
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 DSC EDS IntelliBox MatchPort Micro MSS100 PremierWave SCS SecureBox SLB SLC SLP Spider and Spider Duo UBox UDS1100 and 2100 WiBox WiPort xDirect xPico XPort XPress DR & XPress-DR+ xPrintServer xSenso • • Mercury (Hg) Hexavalent Chromium (Cr (VI)) Polybrominated biphenyls (PBB) Polybrominated diphenyl ether