Table of Contents CHAPTER 1: INTRODUCTION...................3 CHAPTER 2: CONFIGURATION................5 Device Server Configuration ..................5 Setting the IP Address ....................5 DHCP/BOOTP......................5 NativeCOM ........................5 Assigning a Temporary IP Address via the Network ............. 6 How to Use the Serial Ports ................... 7 Configuring NativeCOM Ports for Windows ..............
Page 4
Online Update......................36 CHAPTER 3: EXAMPLE APPLICATIONS ...............39 Connect Peripherals to a Windows Host..............39 Connect Peripherals to a Unix Host................39 Setup a Terminal or Modem to Connect to a Host............40 Ethernet-based Serial Multiplexer................40 Ethernet-based Console Server ................... 41 Replacing a Dial-Up Modem Connection..............
Chapter 1: Introduction The IEPS-1000 Device Server family provides communication between peripheral devices and computers connected to a network. When a device server is connected to your LAN and to one or more peripherals, it manages peripheral traffic over the network, routing it to the correct device.
Chapter 2: Configuration Device Server Configuration Before configuring the device server, you must assign it an IP address as described below. After it has an IP address, the device server is configured primarily through the web browser interface. If you are using NativeCOM to access the serial ports, no other configuration is necessary beyond setting the IP address and potentially the network mask and gateway.
Utility always use the default subnet mask for the given IP address class. If you are subnetting your network, the NCCTool allows you to override the default subnet mask. Assigning a Temporary IP Address via the Network If your device server has booted without an IP address, you can assign it a temporary IP address using another TCP/IP system on your network.
How to Use the Serial Ports The device server serial port(s) can be used in several different ways: • As Windows COM ports via NativeCOM • As network printer ports via LPR/LPD • They can initiate TCP/IP network connections to remote hosts (outgoing connections) optionally using SSL security •...
When configuring an LPD printer, you must provide two pieces of information to the host: the IP address of the device server and the name of the LPD print queue. The name of the print queue for serial port 1 should usually be port1 (or portN for serial port N). If you are printing simple text and want to enable extra character formatting for carriage-returns and new-lines, use fport1 (or fportN for port N).
should be used by applications that support simple TCP connections and do not implement the telnet protocol. There is no protocol involved beyond TCP/IP. The 9000-series port (9001 for port 1, or 900N for port N) implements the telnet protocol and supports the following telnet options: SUPPRESS GOAHEAD, BINARY, ECHO, COM- PORT-OPTION and TIMING MARK.
Configuration via the Web Browser Interface Once the device server has an IP address, you can use a web browser to monitor and configure it. Simply specify the IP address of the device server as the address or URL in your browser and you will see a web page that is similar to the following: Page 10...
Select the section you wish to access from the menu of links on the left side. The following pages discuss each of these sections. Serial Settings The Serial Settings page allows you to specify the baud rate, character size, parity, stop bits, and flow control behavior for each serial port: NOTE: NativeCOM, (or any RFC-2217 Telnet client with COM-PORT-OPTION support) overrides the baud rate, size, parity, stop bits and flow control parameters.
Page 14
Port Services By default, all ports are configured to accept incoming TCP connections from TCP/telnet clients and no outgoing service is configured. You may configure the ports to initiate outgoing raw TCP or telnet connections to remote servers. In addition, the modem emulation feature may be enabled to allow a serial port to mimic a modem interface.
Service Types No Outgoing Service Selecting this option disables outgoing port services on the specified port. Incoming connections are still allowed. All port services options will reset to defaults. Modem Service Selecting this option will enable modem emulation on both the incoming and outgoing network connections.
Page 17
Outgoing Network Connection Selecting this option enables an outgoing connection to the specified host. The Network Connection Options (below) identify the host. Outgoing Telnet Connection Selecting this option enables an outgoing telnet connection to the specified host. The Network Connection Options identify the host and the Telnet Options (below) configure the specific type of telnet connection.
Page 18
Wait for Keyboard Hit You may configure the TCP connection to wait for a “keyboard hit” before starting the TCP session. Enabling this mode will display a message on the serial port (after DCD is present if DCD is required to use the port) asking the user to type a character to begin the TCP session. Telnet Options The following options apply only if an Outgoing Telnet Connection is configured.
Phone Number Translation This table can be used to translate phone numbers into IP addresses or Hostnames. If an attached device dials one of the specified telephone numbers, the corresponding IP address and port are used to make the TCP connection. Note that all non-numeric characters except the “,”...
Page 20
The translation table screen allows you to add up to 5 new entries at a time. A total of 64 entries may be configured including the default entry. In the example above, if the attached device dials 18005551212, the port will be connected to the host at 192.168.1.100 on TCP port 5004.
Network Translation The device server is capable of accepting incoming TCP connections and redirecting them to remote TCP hosts. This functionality is called network translation and behaves much like a TCP "pipe" between two systems. It is also possible to modify the network protocol traveling through the TCP pipe by using the Protocol Settings page to define the remote host's protocol requirements.
Protocol Settings For each host (peer) you will make an outgoing connection to, you need to specify the protocol options used for that host. For each host, select the Host from the “Edit settings for a different peer” selection box. Select “Add a new peer definition” link to add a new host. The hosts are identified by their IP address or Hostname and TCP port.
For each host, select the protocol to use for the connection and the options for that connection. The available options vary depending on the protocol chosen. You may select either: • Non-Secure Protocols for Private Networks - The options in this column are only for use with Private Network connections such as Satellite, Frame Relay or VPN.
However, many network hosts don't provide ENQ/EOT/ACK/NAK synchronization and use packet protocols that are slightly different from those used by POS terminals. The device server is capable of converting standard POS terminal packets into network packets that are suitable for use with several types of network transaction authorization protocols.
SSL Options When SSL is configured on an outgoing connection, you must also specify the SSL connection parameters for each SSL peer. An SSL peer is the remote system that will be on the other end of the secure SSL connection. Type of Peer For an outgoing connection the SSL Peer is normally an SSL Server.
2) The certificate must be signed by a trusted certification authority (CA). Certification authorities, or CAs, are organizations that issue and sign digital certificates. To verify the integrity of a remote peer's certificate, its digital signature is compared with the signatures of the CAs that are trusted by your application. All trusted CAs must be pre-configured in the /usr/local/ssl/cert.pem file found in the device server’s local filesystem.
Page 27
ADH: Anonymous Diffie-Hellman Ciphers kRSA: RSA Public Key Exchange aRSA: RSA Authentication 3DES: Triple DES Encryption DES: DES Encryption RC4: RC4™ Encryption RC2: RC2™ Encryption MD5: MD5 128-bit Message Digest SHA1: SHA1/DSS1 160-bit Message Digest Each cipher may also be prefixed with one of the following operators: -: Exclude cipher from list (may be re-added by later options) +: Move cipher to the end of the list !: Permanently exclude cipher from this list...
Network Settings The Network Settings page allows you to set the IP address, the IP netmask, and the TCP keep-alive settings: IP Address You may permanently assign the IP address of the device server by specifying it in this field. Doing so will disable BOOTP/DHCP.
IP Netmask Every IP address contains two pieces of information: the network number and the host number. A network number is assigned to each local area network and is shared by all the network devices on that network. Each network device, or “host”, is assigned a unique host number.
TCP Keep-Alive TCP keep-alive is a standard feature of TCP/IP that can be configured to automatically monitor the state of TCP connections. If one end of an idle TCP connection is severed (like by a network or power failure), it is possible for the other end to remain open indefinitely. If a network host fails while it has an open TCP connection to one of the device server’s serial ports, that serial port might remain unavailable until it is manually reset.
DNS Settings The DNS Settings page allows you to specify a DNS name for your unit, specify the addresses of DNS servers to resolve names, and to pre-define some host names. The DNS name and servers can also be derived from a DHCP server. Page 29...
Page 32
If the device server is configured to use DHCP, it will try to get DNS configuration information from the DHCP server. You may also manually set up static DNS entries on this page. Having DNS configured allows you to specify names in place of IP addresses in your configuration.
IP Routing The IP Routing page lets you configure network routes for accessing remote networks: If the device server is configured to use DHCP, it will try to get IP configuration information from the DHCP server. You may also manually set up static routes on this page. Each IP route consists of a destination IP address, a netmask, and a gateway IP address.
Page 34
The special destination IP address of 0.0.0.0 specifies a default route, which is used whenever a more specific route does not exist. This is all summarized by the examples in Table 2-3. Destination IP Netmask Gateway Meaning 192.168.2.100 255.255.255.255 192.168.2.1 Host route: Send all packets destined for IP address 192.168.2.100 to the router at 192.168.2.1...
Time Settings The Time Settings page allows you to configure NTP or HTTP time-servers to get the system time from. If you are using SSL for peer verification, the device server must obtain a valid time from an external time-server to verify the peer. If the device server is configured to use DHCP, it will try to get NTP server information from the DHCP server.
Security Settings The security settings link includes settings for the System Password and Network Isolation as defined in the following sections. System Password The device server’s administrative functions can be protected by a system password: By default, no system password is configured. Once a password is set, your web browser will prompt you for the system password whenever you try to access sensitive configuration pages.
Network Isolation Configuration By default, all network services are enabled. However, for security, any or all listening services may be disabled. Unselect any services that you wish to disable. These changes will not take effect until the next reboot. Page 35...
Online Update You may configure your device server to make a connection to an update server and obtain updated software or configuration information from the server or send information to the server. If your device server supports SSL, this update will be over a secure SSL connection. You may schedule the updates to happen periodically, or on every startup, or only when manually selected.
Page 39
Then select when and what to update. Select “Perform update at startup” to have the device server check for updates every time it is booted. (Note: this will cause the startup to take longer than normal. Do NOT interrupt the unit when it is updating or flash memory may be corrupted.
Page 40
Then configure which items to send to the server or update from the server. Items to send: • Product Data – manufacturing configuration data, error records • Configuration Database – current settings on the unit • System Log – trace activity Items to Upload: •...
Chapter 3: Example Applications The device server may be used in a number of ways to provide Ethernet-to-serial connectivity. The following examples show how you might set up the device server for various applications. Connect Peripherals to a Windows Host Using Systech's NativeCOM software in conjunction with the device server allows Windows applications to access these serial ports via the standard Windows COM port interface.
(the default value). Refer to the RTN documentation from Systech for information on setting up RTN on the host computer. Setup a Terminal or Modem to Connect to a Host You can setup the device server to automatically connect a terminal or dial-in modem to a host on your network.
Ethernet-based Console Server You can use one or more device servers to give virtual access to devices that have serial consoles, such as routers, Unix servers, etc. This allows you to monitor multiple consoles from a single terminal or from a remote location. To set up a device server to attach to a serial console, give it an IP address, and optionally set the netmask and gateways.
Accessing the Device Server from a Remote Network When attaching TCP/IP devices to a local Ethernet network, all that is required for basic communication is to assign an IP address to the network device. However, if your network devices need to communicate with remote networks, you must also configure IP routing information to tell TCP/IP where to send these remote network packets.
Chapter 4: Troubleshooting and Updating There are a number of tools built into the device server to facilitate troubleshooting problems and managing the unit. These are accessible via the web browser interface under the menu sections Status and Logs and Commands. •...
System Log By default, the device server stores informational and error messages in the system log. You can also configure the device server to record debug trace data in this system log buffer (see the section entitled Log/Debug Settings). To display the system log and trace information in your browser window, select the System Log link in the menu: This will open a connection to the device server that will display the current contents of the system log buffer.
You can select the text data in the system log display with your mouse and copy it to a file or email message. Usually, you will want to send this data, along with a description of the problem, to Systech support (support@systech.com) for analysis. You can also view and save the system log using a telnet client.
Port Status The Port Status page shows the current state of the serial port(s): The DCD, RTS, CTS, DTR, DSR, and RI columns indicate the status of the modem signals for the specified port. If the modem signal is present (either asserted if it is an outgoing signal, or detected if it is an incoming signal) its name will appear in the corresponding column.
Page 49
NOTE: The Serial Parameters column reflect the actual, real-time serial settings in use by the port. The settings that are specified via the serial configuration pages are applied each time the port is opened. If the port is closed, the serial parameters reported by Port Status may not necessarily match the settings you configured until the port is re-opened.
Network Information The Network Information page displays the status of network services and current connections. The TCP Sockets section shows current connections and TCP listeners. The UDP Listeners section shows UDP ports that are active. Page 49...
Network Interfaces The Network Interfaces page displays the status of the currently active interfaces on the unit. This is similar to the “ipconfig” command on a Windows machine or the “ifconfig” command on a Unix machine. Page 50...
Log/Debug Settings By default, the device server stores informational and warning messages in the system log. You can also configure the device server to save trace data in this system log buffer: Tracing is generally used for troubleshooting problems. You can enable tracing on individual ports –...
Page 54
From the Log/Debug page you can also configure the unit to save a dump of system memory under some circumstances. Scroll the page down to the dump configuration: A memory dump may be obtained either manually using the Initiate Dump button on this page or pressing the reset button or automatically when the unit encounters a catastrophic error that causes it to reboot.
Ping You can use the Ping command to test a network connection: Enter the IP address to Ping or a Hostname and the Number of Pings then press the Ping button. The command will display the results as follows: Sending 10 PINGs to 209.75.217.6... Response from 209.75.217.6: icmp_seq=0, time=10.0 ms Response from 209.75.217.6: icmp_seq=1, time=10.0 ms Response from 209.75.217.6: icmp_seq=2, time=10.0 ms...
Reset/Reboot The Reset/Reboot page lets you reset individual ports, or the entire device server: You can reset an individual serial port or ports by selecting the desired port(s) and pressing the Reset Port(s) button. This will kill whatever service was on the port and reset it back to the current configuration settings.
Flash Management The Flash Management page allows you to maintain your device server’s software, configuration information, and error history: Page 55...
Flash Update The Flash Update command allows you to update the device server’s software or configuration segment across the network. You can determine the device server’s software revision by looking at the Welcome page, or by using any of the NativeCOM host utilities (NativeCOM Configuration Utility or Port Server Utility).
Restore Factory Defaults Clicking the Restore Defaults button will set the configuration back to the factory default values. You can also restore the device server’s factory default configuration by pressing and holding the "Reset" button for a little over 5 seconds. The device server will initially blink the status LED red and yellow to notify you that the configuration is about to be restored.
support. The flash used by the PDA is independent of the rest of system memory, and has no effect on system performance or resources. If you select Total Compaction, you should save the PDA to a host file before compacting. The error records may be useful to Systech support personnel for debugging hardware and software problems on your device server.
Chapter 5: Modem Emulation The device server can be configured to allow legacy devices that interact with a Hayes compatible modem to function over a TCP/IP network. When modem emulation is enabled, the device server will respond to AT commands generated by the attached device. After receiving the dial command, the device server will make a TCP connection to the specified host.
Outgoing and Incoming Calls After automatically accepting an incoming connection, the device server will begin generating "RING" response codes to the device at 6-second intervals. Incoming network data is buffered until the device completes the connection by entering data mode. The device may enter data mode either manually by issuing the "ATA"...
Supported Commands Repeat last command Varies Note: command executes upon "/" character. CR not needed. < > If suffixed with ";" character, will return to command mode upon connection. Echo Mode OK(0) 0=Turn command echo off 1=Turn command echo on (default) Hangup OK(0) Terminate connection.
Page 64
(default) &Dn DTR Control OK(0) 0=ignore 1=loss of DTR switches to command mode and leaves connection open 2=loss of DTR switches to command mode and closes connection (default) &F Load factory default settings OK(0) &Fn Equivalent to ATZ without dropping the connection.
S-Registers S Registers are 1 byte, volatile registers used to store configuration data. They are reset to the default state whenever modem emulation is enabled, or the ATZ/AT&F command is received. They can be saved to flash memory with the AT&W command. When the port is opened, the saved parameters are applied to the port.
CONNECT 38400 Connected – Serial Port Speed is 38400 baud CONNECT 57600 Connected – Serial Port Speed is 57600 baud CONNECT 115200 Connected – Serial Port Speed is 115200 baud CONNECT 230400 Connected – Serial Port Speed is 28800 baud Modem Signal Behavior The device server is not a modem (a DCE device), but is a terminal (DTE) device.
Phone Numbers The "phone number" used in an outgoing connection for an "ATD" command may be a real phone number that is translated to an IP/port pair (see Phone Number Translation) or it consists of an IP address and optional port number. All leading non-numeric characters (such as the T or P dial modifiers) are ignored.
Chapter 6: License Information This product incorporates software from "eCos, the Embedded Configurable Operating System, Copyright (C) 1998, 1999, 2000, 2001, 2002, 2003 Red Hat, Inc." The eCos software used by this product is licensed under "The eCos license version 2.0". As such, certain portions of this product's software are covered by the GNU General Public License and are available from Systech Corporation upon request.
Page 69
* IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR * PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE OpenSSL PROJECT OR * ITS CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, * SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT * NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES;...
Page 70
IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE AUTHOR OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES;...
Need help?
Do you have a question about the IEPS 1000 Series and is the answer not in the manual?
Questions and answers