AXEL Office Server AX4000 --- Communication Server 4 and 8 serial ports User's Manual June 2002 - Ref.
The reproduction of this material, in part or whole, is strictly prohibited. For additional information, please contact: 14 Avenue du Québec Bât. K2 EVOLIC - BP 728 91962 Courtabœuf cedex - FRANCE Tel.: 33 1.69.28.27.27 Fax: 33 1.69.28.82.04 Email: info@axel.com The information in this document is subject to change without notice. AXEL accepts no responsibility for any errors that may occur in this document. All trademarks and registered trademarks are the property of their respective holders.
INTRODUCTION ...............................................................................................1 1 - PRESENTATION..........................................................................................5 1.1 - REAR PANEL AND FRONT PANEL .....................................................6 1.2 - MAIN FEATURES ..................................................................................7 1.3 - EXAMPLE CONFIGURATION...............................................................
3 - TOOLS AND STATISTICS.........................................................................33 3.1 - PING.....................................................................................................34 3.2 - REBOOTING THE OFFICE SERVER .................................................34 3.3 - RESETTING A SERIAL LINE ..............................................................35 3.4 - CONNECTION MANAGEMENT ..........................................................35 3.5 - STATISTICS............
A.3 – UNIX/LINUX AXEL TTY SERVER......................................................68 A.3.1 - Introduction ...................................................................................68 A.3.2 - Installing an AXEL tty server.........................................................69 A.3.3 - Using an AXEL tty server..............................................................70 A.3.4 -The axttyd Mechanism...................................................................71 A.3.5 - Uninstalling.....
Introduction INTRODUCTION AXEL Office Server 1
Introduction This manual provides the information needed to operate and maintain the Office Server. The manual is organised into the following chapters and appendices: Chapter 1: Presentation Description of the front and rear panels of the Office Server and introduction to the main features. Chapter 2: Setting up the Office Server in interactive mode. Description of the embedded interactive set-up (accessed from a serial terminal or a telnet session).
Introduction Appendices: The following appendices give more detailed information: A.1 - Network overview (Ethernet address, IP address and routers) A.2 - Adding a LPD printer on an operating system A.3 - Installing the AXEL tty server on UNIX A.4 - Virtual COMs on Windows A.5 - Managing locally a modem A.6 - Giving the Office Server IP address by the Ethernet address A.7 - Office Server configuration script A.8 - Keepalive Function A.9 - Description of the Office Server leds A.
Introduction CHAPTER 1 --PRESENTATION AXEL Office Server 5
Introduction This chapter provides a description of the front and the rear panels of the Office Server and introduces you to its main features. The Office Server can be regarded as a gateway between network equipment (Ethernet TCP/IP) and RS-232 devices. 1.
Introduction The following leds (light emitting diodes) are located on the front panel: - ON/OFF: power indicator, - LNK: good link indicator, - ACT: network activity indicator, - conf.: set-up indicator (according to the model, - RX and TX: one per serial port, serial activity indicator. AX4010 Front Panel ON/OFF NET. LNK. ACT. CH.4 RX TX CH.3 RX TX CH.2 RX TX CH.1 RX TX AXEL Office Server AX4020 Front Panel ON/OFF NET. LNK. ACT. conf. CH.8 RX TX CH.7 RX TX CH.6 RX TX CH.5 RX TX CH.
Introduction Available network services (associated with serial ports): - telnet client: dedicated to serial terminals (user-defined telnet port) - lpd and rcmd: dedicated to printers (user-defined identifier) - tty client: to handle bi-directional peripherals (bar code readers, scanners, scales, etc.) via a UNIX device (pseudo-terminal). - telnet server: two possible uses: - full control of port signals (RFC 2217) by using dedicated drivers according to the operating system.
Introduction The Ch2 port is associated with the telnet client service. The serial terminal is automatically connected to whichever host is selected on the Office Server SetUp. The Ch3 port is associated with the tty client service. The badge reader in this example would be handled by UNIX via a pseudo-terminal. It would be seen by an application just like a badge reader directly connected via a local serial port. The Ch4 port is associated with the telnet server.
Setting-Up the Office Server in Interactive Mode CHAPTER 2 --- SETTING-UP THE OFFICE SERVER IN INTERACTIVE MODE AXEL Office Server 11
Setting-Up the Office Server in Interactive Mode This chapter deals with the Office Server interactive set-up. The Office Server provides an embedded interactive set-up. This interactive set-up allows the network environment (IP address, host table, etc.), the serial line parameters (data transfer rate, handshake, etc.), and the network services associated with the serial lines (telnet, lpd, etc.), to be set. 2.
Setting-Up the Office Server in Interactive Mode An administrator switch is located on the Office Server rear panel. To enable set-up mode press then release this switch. The set-up main menu is displayed on the character terminal. The following section describes the use of set-up mode. When the set-up session has been completed, the admin port can be used for other network services. Note: during set-up mode, the two leds of the admin port remain lit. For the AX4020, the "conf." led is also lit. 2.1.
Setting-Up the Office Server in Interactive Mode 2.2 - SET-UP OVERVIEW The Office Server set-up interface provides menus and sub-menus. Its number may select each menu item. A menu item may either lead to a sub-menu or run a command. 2.2.1 - Navigation To select a menu item, enter the item number and press (Carriage Return Key). To go back to the previous menu, enter then . To go back to the main menu, enter then . 2.2.
Setting-Up the Office Server in Interactive Mode 2.2.3 - Special Notation The set-up is a sequence of menus and sub-menus. Define an action by the path followed through the set-up tree (hierarchy), using the following notation: [command1]→[command2]→[action] For example, to perform the above action, select command1 in the main menu, then select command2 in the sub-menu. 2.2.
Setting-Up the Office Server in Interactive Mode 2.2.5 - Exiting Set-up Mode To save the modifications and exit set-up mode, select [Exit]→[Save and exit]. The Office Server settings are stored in NVRAM and the set-up session is ended. Note: to abandon your changes and exit set-up mode, select [Exit]→[Exit without Saving]. 2.
Setting-Up the Office Server in Interactive Mode 2.3.2 - Host Table A host is any machine equipped with an Ethernet interface (UNIX, AS/400, NT, etc): - the Office Server can open TCP/IP connections to a host (telnet client and tty client), - a host can open TCP/IP connections to the Office Server (lpd/rcmd, telnet server and tty server) To add a new host, select [Network]→[Hosts]→[Add Host] and enter the following parameters: - Name: this is only a local name (not available to a DNS server), - IP address.
Setting-Up the Office Server in Interactive Mode 2.4 - SETTING UP THE SERIAL PORTS The [Serial] menu allows an administrator: - to set line parameters (data transfer rate, handshake, etc.) for the serial ports, - to associate a network service with each serial port (telnet, lpd, etc.). 2.4.1 - Line Parameters To modify the line parameters of port X, select [Serial Lines]→[Line X]→[Line Parameters].
Setting-Up the Office Server in Interactive Mode Parameters needed for all three types of lines (direct, dedicated and telecom): - Data Transfer Rate: speed in bps Values: 300, 600, 1200, 2400, 4800, 9600, 19200, 38400, 57600 or 115200. - Data Format: size of data, number of stop bits and parity. A slash (/) is used to separate the 3 values. Size of data: 7 or 8 bits Stop bits: 1 or 2 bits Parity: none, even or odd Example: 8/1/none.
Setting-Up the Office Server in Interactive Mode Parameters needed for a modem or dedicated line: - Hang-Up Type: signal used by the Office Server to terminate the call. Values: soft, rts or dtr. - Modem Esc. (requested only if HANG-UP TYPE is soft): HAYES sequence to return to command mode. - Modem Hang-Up Seq. (requested only if HANG-UP TYPE is soft): HAYES sequence to terminate the call. - Hang-Up on Net Close: if yes (y), the Office Server terminates the call when the network connection is closed.
Setting-Up the Office Server in Interactive Mode The new serial line settings are effective: - when the Office Server is rebooted, - the next time the associated network service opens a connection, - when the serial line is reset. 2.5 - SERIAL LINE USING The Office Server offers many network services. The suitable network service depends on: - the used device (printer, dumb terminal, modem...) - and the operating system (Unix, AS/400, NT...
Setting-Up the Office Server in Interactive Mode Dumb Terminal Unix AS/400 Office Server client telnet client tty client telnet Additional Software --axttyd --- See Chapter... 2.5.2 2.5.3 2.5.2 Additional Software axttyd DialOut/IP DialOut/IP See Chapter... 2.5.3 2.5.4 2.5.4 Additional Software axttyd DialOut/IP DialOut/IP See Chapter... 2.5.3 2.5.4 2.5.
Setting-Up the Office Server in Interactive Mode Then, the LPD/RCMD service must be configured for the Office Server serial port. Select [Serial Lines]→[Line X]→[Network Service] and enter the following parameters: - Service Mode: enter the keyword ‘server’, - Service Type: enter the keyword ‘lpdrcmd’ (a lpd port can also be accessed by a rsh/rcmd command), - Queue Name: the name of the serial port. Each LPD port on the Office Server must have a separate name. - LPD before Print Seq.
Setting-Up the Office Server in Interactive Mode c - Using a RSH/RCMD Printer The rsh (or rcmd) system command allows data to be sent to an Office Server serial port. Example under Unix/Linux: $ cat file | rsh axname portname Note: axname is the name listed in /etc/hosts and portname is the name associated with the Office Server serial port through the Office Server Set-Up. This command can be launched from any application or can be added to the printer script. 2.5.
Setting-Up the Office Server in Interactive Mode Then, the telnet client service must be configured for the Office Server serial port. Select [Serial Lines]→[Line X]→[Network Service] and enter the following parameters: - Service Mode: enter the keyword ‘client', - Service Type: enter the keyword ‘telnet', - TCP Port: numeric value associated with the telnet service on the target host (generally 23), - Host Name / IP Address: host name (or IP address) to which the serial terminal will be connected.
Setting-Up the Office Server in Interactive Mode Note: the two tty services need a UNIX tty server from AXEL. This software (axttyd) is not available for operating systems other than UNIX. For more information, see appendix A.3. The first step is to set the line parameters of the selected Office Server serial line, as described in chapter 2.4. Set-up the Office Server according to the required tty service.
Setting-Up the Office Server in Interactive Mode Note: to use the axttyd Unix daemon, set the service as follow: - ID string: y - Auto Connection: yes - time-out: 0 b - Server Tty Select [Serial Lines]→[Line X]→[Network Service] and enter the following parameters: - Service Mode: enter the keyword ‘server', - Service Type: enter the keyword ‘tty', - TCP Port: numeric value associated with this Office Server serial line.
Setting-Up the Office Server in Interactive Mode b) Setting the Office Server To set the selected Office Server serial line, select [Serial Lines]→[Line X]→[Line Parameters] and enter the following parameters: - Line Type: enter the keyword 'direct' (even if a modem is connected to!), - The other parameter values (Baud Rate, Data Format, etc) are not important. The software during the virtual port use will set them.
Setting-Up the Office Server in Interactive Mode To establish a connection, the TCP/IP terminal must open a telnet session into the Office Server. The Office Server's IP address and the TCP port of the Office Server serial line are given as arguments to the telnet command. For example: telnet axname 2048 2.5.6 - TCP/IP¥RS232 Converter Two Office Servers can be used to link 2 devices through a network. This allows long distance connection.
Setting-Up the Office Server in Interactive Mode Answer 'y' to set-up a backup host. The following parameters are asked: - Backup Host Name / IP Address: name or IP address - TCP Port: numeric value associated with the service. - Timeout to Enable Backup: maximum delay allowed (in seconds) to open a connection to the primary host. If the connection fails, the Office Server opens a connection the backup host. - Backup Host Priority: two answers: - 'n': backup host has not priority.
Setting-Up the Office Server in Interactive Mode 2.7.3 - Changing the Office Server IP Address The Office Server IP address can be changed by using the arp and ping commands (see Appendix A.6.2). This feature can be disabled by selecting [Advanced Set-Up]→[Tunings] and setting 'Ping change IP addr.' to 'n'.
Tools and Statistics CHAPTER 3 --- TOOLS AND STATISTICS AXEL Office Server 33
Tools and Statistics This chapter describes the embedded Office Server tools (ping, serial line resetting, statistics, etc.). 3.1 - PING The ping command is used to check for the presence of a live TPC/IP device. Failure of ping can indicate that the device has an incorrect IP address, is not powered up, etc.). Select [Tools]→[Ping] menu and enter the IP address or the name of the TCP/IP peripheral.
Tools and Statistics - ax_reboot : command for AX4000 reboot, - password : specify the set-up password if set. 3.3 - RESETTING A SERIAL LINE The serial line reset feature allows a line to be reset without rebooting the Office Server. This feature can be used: - to stop and restart the associated network service - to apply new serial line settings (data transfer rate, handshake, etc.).
Tools and Statistics This set-up screen displays the following information: - No: connection number - Chan: serial port number (from 1 to 4). An asterisk (*), displayed alongside this number, indicates that there is current connection via this port. This arrangement can help prevent multiple connections (lpd for example) from attempting to use the same serial port. Should this occur, only one connection would be able to access the port, while the others would hang, waiting for the resource.
Tools and Statistics 3.5.1 - Network Statistics To show network statistics, select [Tools]→[Network Statistics] then select the group you want to examine: - Ethernet statistics - ARP statistics - IP statistics - ICMP statistics - TCP statistics Once statistics are displayed, press to refresh the information or press to go back.
Tools and Statistics b - ARP Statistics An ARP or RARP request is a request to determine the Ethernet number of a host, whose IP address has been given for a terminal-to-host connection The first part of the ARP and RARP statistics displays requests, which have been sent to, or received from, the Office Server: RARP: - received: number of received RARP frames. - bad-type: wrong frames. - bad-len: frame length errors. - replies-in: responses to RARP requests sent from the Office Server.
Tools and Statistics d - ICMP Statistics The first part of these statistics displays errors relating to ICMP messages: - chksum-err: checksum errors - nomem: number of dropped frames (because of shortage of memory). - icmp-err: number of inconsistent ICMP responses received. - bdcsts: number of not-accepted broadcast ICMP messages received. Next are listed ICMP messages sent to, or received from, the Office Server: - type: ICMP message type (echo reply, destination unreachable, etc.
Tools and Statistics This option provides statistics relating to each Office Server serial line: - rxintr: number of interrupts received by the Office Server.
Using a Script to Set-Up the Office Server CHAPTER 4 --- USING A SCRIPT TO SET-UP THE OFFICE SERVER AXEL Office Server 41
Using a Script to Set-Up the Office Server The Office Server can also be set up with a script. This allows Office Server settings to be archived, or several Office Servers to be set up with the same script. 4.1 - OVERVIEW This method of Office Server set-up is performed using the rsh command. A script (whose file-name is given as an argument to the rsh command) contains the value of each set-up parameter. The script may contain some or all the Office Server set-up parameters.
Using a Script to Set-Up the Office Server To access set-up from a telnet session, the IP address of the Office Server must already be set. This can be done either: - with a serial terminal, connected to the admin. port (see chapter 2.1.1), or - by specific embedded protocols using the Ethernet address (see appendix A.6). 4.2 - SETTING-UP AN OFFICE SERVER To set-up an Office Server, use the rsh command, with the setup_send option.
Using a Script to Set-Up the Office Server The message 'Reboot in progress...' is then displayed on the operator console, the Office Server is reset and the new set-up is implemented. If a connection problem occurs, a time-out error message is displayed. 4.3 - OBTAINING A CONFIGURATION To obtain an Office Server configuration, use the rsh command together with the setup_get option.
Using a Script to Set-Up the Office Server 4.4.1 - Fatal Errors Fatal errors stop the rsh command. The following fatal errors may occur: ERR 101: header label expected. Setup not updated Command: Cause: setup_send BEGIN_AX4010_SETUP or BEGIN_AX4020_SETUP is not the first line of the configuration file. Consequence: the Office Server set-up is not modified. Solution: check the file. Replace it with a correct AXEL configuration file. ERR 102: bad header label protocol version.
Using a Script to Set-Up the Office Server ERR 105: invalid rcmd command. Command: Cause: Consequence: Solution: any command the remote command is unknown. no effect. valid commands are listed in Appendix A.10 ERR 106: cmos busy. Command: Cause: setup_send another rsh command (setup_get or setup_send) is running, or another user has entered set-up, on the target Office Server. Consequence: no effect.
Using a Script to Set-Up the Office Server ERR 201: xxx: unknown parameter name. Command: Cause: setup_send this set-up parameter (xxx) is unknown. (e.g.: tcphost1name instead of tcp_host1_name). Consequence: the set-up parameter is ignored. The current value of this parameter is retained. Solution: check the syntax of the set-up parameter (appendix A.7). ERR 202: xxx: inconsistent parameter name.
Using a Script to Set-Up the Office Server ERR 205: xxx: invalid parameter value. Ignored Command: Cause: setup_send the value given for this set-up parameter (xxx) is not valid (For example: ch1_service_type=tel). Consequence: the set-up parameter is ignored. The current value of this parameter is retained. Solution: check the possible values of this parameter (appendix A.7). 4.4.
Using a Script to Set-Up the Office Server ERR 214: Duplicated host. Duplicate host(s) reset. Command: setup_send Cause: two (or more) host names are identical. Consequence: to get a consistent configuration, only one of these hosts is retained Solution: check the host table. ERR 215: Incomplete host(s) info. host(s) reset. Command: setup_send Cause: host parameters are missing. Consequence: to get a consistent configuration, some hosts have been removed. Solution: check the host table.
Downloading Firmware CHAPTER 5 --- DOWNLOADING FIRMWARE AXEL Office Server 51
Downloading Firmware This feature may be used to upgrade the Office Server firmware over a network. Firmware can be downloaded, for example to add or improve features. 5.1 - OVERVIEW 5.1.1 - Downloading Protocols Firmware can be downloaded in one of two ways: - tftp protocol: the operator must enter the location of the firmware file. - bootp and tftp protocol: this is an automatic procedure. The necessary parameters will already be available from the UNIX configuration.
Downloading Firmware Under Unix, these 2 protocols are included, but the default configuration does not launch the tftp and bootp daemons. To enable these protocols perform the following: - modify the file /etc/inetd.conf by removing the '#' comment character, from the beginning of the line(s) associated with tftp and/or bootps Note: for tftp, take care to use the 'public' mode (example: for SCO Unix the tftpd daemon must be launched without the '-s /tftpboot' parameter).
Downloading Firmware The Office Server hardware version is included in the general Office Server firmware revision (ex.: FK24-BV1.2a/TCP.XX.0029d.STD).
Downloading Firmware Possible errors (displayed on the operator’s console): - ERR 105: invalid rcmd command: incorrect command option (check the syntax). - ERR 108: invalid number of parameters: bad parameter number (2 or 3 parameters are required after the command option). - ERR 109: invalid file length: the filename is too long (more than 31 characters). - ERR 110: invalid server: the tftp host name is unknown (not listed in the Office Server set-up).
Downloading Firmware The bootp protocol is used to get the IP address of the tftp host and the firmware filename. This information is returned in response to a broadcast. The Unix/Linux bootp host, selected for this function, must have been configured with information concerning this firmware file. Note: the bootp host and the tftp host can be different machines. Prerequisites for bootp: - the bootpd process must be run on the bootp host.
Downloading Firmware b) The Office Server accesses the tftp host via a router net:hn:df=/etc/btdump:ht=ethernet:sa=192.1.1.243:to=auto: net1:tc=net:sm=255.255.255.000:gw=192.168.1.252: axel1:tc=net1:ht=ethernet:vm=rfc1048:ha=00A034100001:ip=192.168.1.242:bf= /usr/axel/firm9801: IMPORTANT: if a problem occurred during a previous download operation (whatever method was used), the firmware of the target Office Server may have been erased.
Downloading Firmware 5.4 - DOWNLOAD PROCESSING The download operation comprises 4 stages, which are signalled by the 8 leds dedicated to the 4 serial ports: - bootp stage: the Ch4 leds flash for 1 second - beginning of tftp stage: the Ch3 leds flash for 1 second - firmware downloading: the 8 leds alternatively light during the file transfer → → → → → - firmware is downloaded: the 8 leds light for 1 second The Office Server is then automatically reset and the new firmware is enabled.
Appendix APPENDIX AXEL Office Server 59
Appendix The following appendices give information about: - network overview (Ethernet addresses, IP addresses and routers), - adding an LPD printer within an operating system, - installing the AXEL tty server under UNIX, - virtual ports on SCO Unix, - virtual COMs on Windows, - managing locally a modem, - using the Ethernet address to provide an IP address, - keepalive Function, - Office Server configuration script, - description of the Office Server leds. A.1 - NETWORK OVERVIEW A.1.
Appendix A.1.2 - IP Address Every device connected to an Ethernet network must have a single 32-bit address, which encodes network and host ID. Internet addresses (sometimes called «IP addresses») are usually written as four decimal numbers separated by decimal points ('.' character).
Appendix To declare a router, use the 'Add Route' option and enter the following three parameters: - Gateway Address: router IP address. This router must be connected to the same network as the Office Server. - Host IP Address: IP address of the host to be reached. - Mask: logical mask on the host IP address. The default value of this mask distinguishes the host segment from the network segment of the IP address.
Appendix Example 1: router 1 is used to reach the 192.168.2.xxx network and router 2 is used to reach the 192.1.1.xxx network: 192.168.2.xxx 192.1.1.xxx Router 1 Router 2 192.168.1.11 192.168.1.12 Office Server 192.168.1.10 The Office Server route table is: router 1 router 2 Route IP address 192.168.1.11 192.168.1.12 AXEL Office Server Dest. IP address 192.168.2.0 192.1.1.
Appendix Example 2: router 1 is used to reach both networks (192.168.2.xxx and 192.1.1.xxx): 192.1.1.xxx 192.168.2.xxx Router 1 192.168.1.11 Office Server 192.168.1.10 The Office Server route table is: router 1 Route IP address 192.168.1.11 Dest. IP address default type net A.2 - LPD PRINTERS This appendix gives the information needed to add an LPD printer under your operating system. For more information, refer to your system manuals.
Appendix A.2.1 - UNIX Use the UNIX System Management Tool to add a remote printer. At least, two parameters are required: - the name of the remote host: enter the Office Server's hostname (refer to /etc/hosts), - the name of the printer: this is the Queue Name entered when the Office Server was set up. Run the lp command to use this printer. Note: some options of the lp command (number of copies, banner, etc.
Appendix Printers can be added using either of two methods: - Standard Processing: AIX sends a raw file to the Office Server. Three parameters are required: - Name of Queue to Add: name of the printer accessed by the lp command - Destination Host for Remote Jobs: hostname of the Office Server (refer to /etc/hosts) - Name of Queue on Remote Printer: Queue Name associated with the Office Server's port - Local Filter: AIX passes the file to the printer through a formatting filter.
Appendix Within the next dialog box, select 'Create a new port' and select 'LPR Port'. Click on 'Next'. Note: if 'LPR Port' is not available, you need to install 'Print Services for Unix'. Finally within the next dialog box, enter the two requested parameters: - name or address of the server providing LPD: AX4000 IP address. - name of printer or print queue of that server: This is the 'Printer Port Name' AX4000 Set-Up parameter.
Appendix A.3 – UNIX/LINUX AXEL TTY SERVER A.3.1 - Introduction The AXEL tty server is a Unix/Linux daemon (axttyd). The axttyd daemon must be used with the Office Server tty client or tty server network services. The AXEL tty server associates a device on the Unix/Linux host with an Office Server resource: - the device is a pseudo-terminal (see below), - the Office Server resource is a serial port (ex.: ch1, ch2, etc).
Appendix The following drawing shows the UNIX mechanisms: UNIX Software ttypx Software ptypx (slave) (master) ttypy AXEL tty server Software ptypy (slave) (master) ttypz ptypz Socket (slave) (master) TCP Stack Office Server A.3.2 - Installing an AXEL tty server Copy to /etc and rename as axttyd the appropriate binary. Example for IBM AIX: # cp axttyd.AIX /etc/axttyd Note: the source file and the makefile are also provided.
Appendix A.3.3 - Using an AXEL tty server a – Overview The AXEL tty server uses a configuration file, which lists all authorised associations between Office Server ports and UNIX pttys. Each entry in this file contains four parameters: - Office Server hostname (see /etc/hosts) - Office Server resource depends on the used tty service - tty client: a keyword (lowercase characters): ch1, ch2, ch3, ch4 (and ch5, ch6, ch7, ch8 with the AX4020).
Appendix -f: configuration file (default: /etc/axfile). -l: log file (default: /tmp/axttylog). -n: TCP port (default: 2048) for connections using the tty client service. -b: using a buffer for the data reception. The AXEL tty server can be started either from the UNIX command line or from the AXEL boot. Note: if the server is started from the command line, take care to add the '&' character at the end of line, so the command will be run in the background and the UNIX prompt will return.
Appendix A.4 - VIRTUAL COMS ON WINDOWS The virtual COM feature allows the Windows operating system to control the Axel Office Server serial ports as standard local serial ports. Any software can use standard O.S. commands: - to set serial line parameters (baud rate, parity, etc), - to set serial output signals (DTR and RTS), - to get serial input signal status (DSR, CTS and CD). Accordingly any serial device (modem for instance) can be connected either to a 'real' COM or to a 'virtual' COM.
Appendix Once the driver is installed, a specific icon is displayed on the task bar (near the clock). This icon is used to set-up virtual COMs. A.4.3 - Adding Virtual COMs Two steps are needed to create a virtual COM: - Creating the COM, - Setting the COM. a - Creating a COM At the end of the driver installation a dialog box dedicated to COM Creation is displayed (see below). To create virtual COMs, tick entries in this list.
Appendix Note: please reboot the computer after any modification to this COM list. b - Setting-Up a Virtual COM To enter the dialog box controlling the COM settings, double click on the driver icon. This box allows the set-up for virtual COMs (i.e.
Appendix c - Testing a COM Click on the 'Configuration Wizard' button (on the previous dialog box) to test a virtual COM. If needed, enter the 'IP address' and 'Port Number' values. Then click the 'start' button. After few seconds the results are shown: Note: after testing, recommended settings can be kept by clicking the 'Use Settings' button.
Appendix A.4.4 - Using a Virtual COM Under Windows 95 and 98, virtual COMs are seen as standard Windows resources. In this case a printer can be attached immediately to COM6. Under Windows NT and 2000, the virtual COM must be added through the Control Panel (i.e. add the port 'COM6:' to provide COM6 to Windows NT). Note: This operation is only needed to see a virtual COM as a standard Windows resource (to attach a printer for example).
Appendix 1 - If no carrier is detected (CD signal is down), the HAYES reset and init sequences are sent to the modem in the following cases: - the Office Server is powered up when the modem is already switched on, - the modem is power-cycled, - the call is terminated, - the serial line is reset when the modem is already switched on. 2 - The HAYES init sequence is sent 2 seconds after the HAYES reset sequence.
Appendix A.5.
Appendix A.5.4 - Setting-Up the Modem The HAYES reset and init sequences are used to set-up the modem. Reset sequence: load factory settings (generally AT&F, but check with your modem handbook). Init sequence: this sequence must set-up the following features: - local echo OFF, - results codes suppressed, - CD signal when it connects, - dropping DTR terminates a call, - RTS/CTS handshake used, - set disconnect inactivity timer (if supported), - save modification in NVRAM.
Appendix The following operations are performed to get a valid IP address: - 3 RARP requests are broadcast. If a RARP server sends a valid answer, the Office Server IP address is updated. To signal that this operation is occurring, the Ch4 and Ch3 leds flash: - if no RARP answer is received, 3 BOOTP requests are broadcast. If a BOOTP server sends a valid answer, the Office Server IP address is updated.
Appendix The following diagram illustrates RARP and BOOTP processing: Powered Up no IP Address yes 0.0.0.
Appendix A.6.2 – If the Office Server IP Address is Unknown If the Office Server IP address is unknown, it is impossible to use the interactive set-up (except with a serial terminal connected to the admin. port). The procedure used overwrites the current (unknown) IP address with a new (known) one. The Office Server has a special protocol built in: if 8 ping requests are received, with an IP address different from the current one, the Office Server IP is updated and the Office Server is rebooted.
Appendix For example: BEGIN_AX4010_SETUP V1.1 # this is a comment tcp_host1_name=vangogh ... END_AX4010_SETUP Note: lines beginning with '#' are treated as comments and ignored.
Appendix A configuration file can either be created using a text editor, or obtained from an already configured Office Server (by using rsh setup_get). When a configuration file is obtained from an Office Server, the inactive parameters (undefined hosts, network service unused, etc.) are commented out. The sample configuration file, shown in the following pages, is typical of a file obtained from an already configured Office Server.
Appendix TCP/IP Parameters tcp_host1_name=vangogh tcp_host1_ip=192.168.1.252 tcp_host2_name=picasso tcp_host2_ip=192.168.1.248 tcp_host3_name=pablo tcp_host3_ip=192.168.1.249 tcp_host4_name=vincent tcp_host4_ip=192.168.1.250 #tcp_host5_name= #tcp_host5_ip= #tcp_host6_name= #tcp_host6_ip= #tcp_host7_name= #tcp_host7_ip= #tcp_host8_name= #tcp_host8_ip= tcp_defrouter_ip=192.168.1.252 tcp_router1_ip=192.168.1.252 tcp_router1_target=192.1.1.252 tcp_router1_type=net tcp_router2_ip=192.168.1.
Appendix #tcp_router7_target= #tcp_router7_type= #tcp_router8_ip= #tcp_router8_target= #tcp_router8_type= (IP address format | default) (net | host) (IP address format) (IP address format | default) (net | host) Note: if a configuration file is obtained from an Office Server, undefined hosts and routers are commented out.
Appendix ch%_backup_prioritary= ch%_line_type=direct ch%_speed=38400 ch%_data ch%_fifo=dtr ch%_input_hdsk=dtr ch%_iflow_passthru= ch%_output_hdsk=dtr ch%_detect=dtr ch%_hangup=dtr ch%_do_hangup= ch%_do_netclose= ch%_hayes_escape= ch%_hayes_hangup= ch%_hayes_reset= ch%_hayes_init= ch%_phone_number= ch%_modem_inactivity= (yes | no) (direct | telecom | dedicated) (300 | 600 | 1200 | 2400 | 4800 9600 | 19200 | 38400 | 57600 115200) (7-1-none | 7-1-odd | 7-1-even 8-1-none | 8-1-odd | 8-1-even 7-2-none | 7-2-
Appendix ch%_service_mode ch%_service_type ch% service qname ch%_service_tcpport tty Available services server client telnet lpdrcmd tty telnet ch%_associate_host ch%_associate_term ch%_associate_autoconn ch%_associate_idstring ch%_associate_inactivity ch%_associate_befprint ch%_associate_aftprint ch%_associate_crnlconv ch%_associate_keepalive ch%_associate_backup ch%_backup_xxx Tunings tun_setup_tcpport=4096 tun_ping_cha
Appendix A.8 - KEEPALIVE FUNCTION The keepalive is a mechanism that allows a TCP/IP device to regularly check its TCP/IP connection status. A.8.1 - Why a Keepalive Function is Needed? A TCP/IP device is not able to detect in real time a network problem (remote host down, cable problem, etc). A network problem can only be detected when data is sent and the destination host acknowledgement is not received.
Appendix To check a connection, the Office Server performs the following operations: - if the connection is idle during a certain delay (i.e. no incoming network frame), a 'keepalive probe' is sent by the Office Server, - if no response is received after 4 seconds, another 'keepalive probe' is sent, - if no response is received after 8 'keepalive probes', the device is considered to be 'unreachable' (the associated connection is closed and the channel is released).
Appendix flow on the phone line. But the Office Server never detects a network incident on the remote site. A.9 - OFFICE SERVER LED MEANINGS The Office Server provides leds on the front panel. These leds show the Office Server’s activity (network and serial ports) at a glance. They also signify special behaviour or errors. ON/OFF NET. LNK. ACT. CH.4 RX TX CH.3 RX TX CH.2 RX TX CH.1 RX TX AX4010 Leds ON/OFF NET. LNK. ACT. STP CH.8 RX TX CH.7 RX TX CH.6 RX TX CH.5 RX TX CH.4 RX TX CH.
Appendix A.9.1 - Standard Processing The standard behaviour of these 8 leds is to record serial port activity (see above). But for the two following event the led meanings are: 1 - No IP address is assigned to the Office Server : The 8 leds remain lighted until an IP address is set. 2 - The Office Server Set-Up is used: the 2 leds corresponding to the admin. Port remain lighted and flash to indicate the data traffic A.9.
Appendix c) Tftp protocol errors : No response to the tftp broadcast request (the tftp host is unreachable or not correctly set-up) : File not found : Access violation (secure tftp or file access) : Disk full or allocation exceeded : Illegal TFTP operation : Unknown Transaction Identifier : File already exists : No such user : Other errors d) Firmware File : The firmware file does not correspond to Office Server firmware : The firmware file size is less than 256 bytes.
Appendix A.10 - ADMINISTRATION COMMAND LIST The Office Server offers several administration commands. Using the rsh system command (available as standard features from most major operating systems) launches these commands. The following table lists the available Office Server administration commands: Command ax_reboot ax_sinit setup_get setup_send ax_download ax_version ax_getstat Description Resetting the Office Server. Example: rsh axname ax_reboot [password] More information: chapter 3.
PERSONAL NOTES
14 Avenue du Québec Bât. K2 EVOLIC - BP 728 91962 Courtabœuf cedex - FRANCE Tel.: 33 1.69.28.27.27 - Fax: 33 1.69.28.82.04 - Email: info@axel.