AXEL Platine Terminal AX3000 Models 65, 70 and 75 USER'S MANUAL March 2008 - 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 related to firmware 0632b in this document is subject to change without notice. AXEL assumes no responsibility for any errors that may appear in this document.
TABLE OF CONTENT INTRODUCTION ................................................................................................. 1 1 - INTRODUCTION TO THE AX3000................................................................ 5 1.1 - TERMINAL MODELS ............................................................................... 6 1.2 - MAIN FUNCTIONS................................................................................... 6 1.2.1 - Network Functions.................................................
a) DNS Servers .......................................................................................29 b) DNS Domains .....................................................................................30 c) Publishing the Terminal Name ............................................................30 3.1.3 - Server Management ........................................................................30 3.1.4 - Router Management........................................................................31 3.
3.4.11 - Listing Connected USB Devices ................................................... 49 3.5 - SETTING AUXILIARY AND LOGICAL PORTS ...................................... 50 3.5.1 - Setting Up the Ports ........................................................................ 50 a) Setting Serial Ports ............................................................................. 50 b) Setting the Parallel Port ......................................................................
5.1.2 - Protocols: telnet, tty, ssh or aux1/aux2 ...........................................77 a) The TELNET Protocol.........................................................................77 b) The TTY Protocol ................................................................................77 c) The SSH Protocol ...............................................................................78 d) The Serial Ports (Aux1, Aux2…).........................................................79 5.1.
5.4.1 - Overview........................................................................................ 106 5.4.2 - Installing an AXEL tty server ......................................................... 107 5.4.3 - Using an AXEL tty server .............................................................. 108 a) Overview ........................................................................................... 108 b) Running the Axel Tty Server.............................................................
d) Examples ..........................................................................................129 e) Handling DTR and RTS Signals .......................................................130 6.3 - 5250 PRINTER .....................................................................................130 6.3.1 - Setting-Up and Using a Prt5250 Printer ........................................131 a) General Settings ...............................................................................
8.1.1 - Setting-Up an RDP Session .......................................................... 157 8.1.2 - RDP Additional Parameters .......................................................... 158 8.1.3 - Automatic Logon and Auto-Run .................................................... 159 8.1.4 - Redirected Resources................................................................... 160 a) Declaring a Redirected Printer .........................................................
8.5 - USING THE AX3000.............................................................................192 8.5.1 - Opening a Windows Session ........................................................192 8.5.2 - Information about a Windows Session ..........................................192 8.5.3 - Closing a Windows Session ..........................................................193 a) Log Off from the Desktop..................................................................193 b) Disconnect from the Desktop..
a) The Horizontal General Menu........................................................... 221 b) Vertical Menus .................................................................................. 222 c) Dialog Boxes ..................................................................................... 222 A.1.3 - Enter Data ..................................................................................... 222 A.1.4 - Special Notation .........................................................................
A.6.1 - Overview .......................................................................................255 A.6.2 - Adding an Axel option with the Microsoft DHCP Server ...............256 A.6.3 - 'axrmserv' option: auto-configuration ............................................257 A.7 - SETTING THE IP ADDRESS BY A PING COMMAND.........................258 A.8 - RSH ADMINISTRATION COMMAND LIST..........................................259 A.9 - FIRMWARE DOWNLOADING (BOOTP AND TFTP)...........................
d) The 'Time to Live' Parameter............................................................ 275 e) The 'TCP port Assignment' Parameter ............................................. 275 f) The 'Nagle's Algorithm' Parameter .................................................... 276 g) The 'Keepalive' Parameter................................................................ 276 h) The 'Telnet Break Code' Parameter ................................................. 277 i) The 'Telnet NAWS' Parameter...............
Introduction INTRODUCTION AX3000 - User's Manual 1
Introduction This manual provides details on terminal operation, maintenance and set-up. The manual is organized into the following chapters and appendices: Chapter 1: Introduction to the AX3000 Introduction to the AX3000’s main features. Chapter 2: First Boot Time When the terminal is powered-up for the first time, the Quick Set-Up provides a fast and easy method to configure the AX3000. In addition the Auto-Configuration service is started.
Introduction Chapter 8: Installing under Windows Description of Windows specific features. Chapter 9: Tools and Statistics Description of the embedded AX3000 tools (ping, statistics, etc). Chapter 10: Remote set-up Description of configuring terminals remotely via ‘telnet’ Description of remotely sending a configuration text file to one or multiple terminals. Appendices: The following appendices give more detailed information: A.1 - Using the AX3000 interactive set-up A.
Introduction to the AX3000 CHAPTER 1 --INTRODUCTION TO THE AX3000 AX3000 - User's Manual 5
Introduction to the AX3000 This chapter introduces the main features of the AXEL TCP/IP terminal. 1.1 - TERMINAL MODELS The manual describes the configuration and the use of all the Axel terminal models. The following table lists the main differences between models: M65C M70W M70F M75, M75E & M75B M75C USB Ports --yes yes --yes Parallel & Aux.
Introduction to the AX3000 1.2.2 - Terminal Function Each TCP/IP AXEL terminal can support up to six concurrent and independent sessions. This multi-session capability provides multiple connections across a network. Each session can: - Connect to any TCP/IP networked server, - Use different protocols (ica, vnc, rdp, telnet, ssh and tty), - Have independent parameters (resolution, emulation, function keys, colour video attributes, etc). Programmable keystrokes are used to open or hotkey between sessions.
Initial Power-On CHAPTER 2 --INITIAL POWER-ON AX3000 - User's Manual 9
Initial Power-On This chapter describes the 'Quick Set-Up' feature and the 'Auto-Configuration' service. When the terminal is switched on up for the very first time two configuration methods are available: - Quick Set-Up: a wizard allows the terminal to be set-up in few seconds for typical use. - Auto-Configuration: used in conjunction with AxRM, this function allows the terminal to automatically receive new firmware and/or a configuration. 2.
Initial Power-On The dialog box structure (referred to as a Wizard) is shown below: First Screen Serial Connection Network Connection (RS232 session) (TCP/IP session) Reboot Citrix Desktop Printer Graphical Citrix display & (published printer application 3270 (TSE, VNC or server ) sessions) (text 5250 or or Citrix with local server list) Summarize Note: the following keystrokes are available in the set-up (for more information see Appendix A.
Initial Power-On 2.1.1 - First Screen This first screen allows the session type to be selected: These parameters are: - Keyboard: keyboard nationality. The value given is immediately selected. - Screen Type: possible values are CRT Monitor or TFT Flat Screen. - Terminal Name: this parameter (see appendix A.4) allows the AX3000 to be identified by this name if both a DHCP server and a Dynamic DNS server are available. (The default value is ‘axel’ followed by the last 3 bytes of the MAC address).
Initial Power-On 2.1.2 - Network Connection The Network dialog box is the following: These parameters are: - Enable DHCP: two possible values: - Yes: the DHCP protocol is run when the set-up is exited and automatically obtains an IP address and various other DHCP options (netmask, default router, etc). - No: a Static IP address is required - IP address: mandatory if DHCP is disabled. - Default router: optional router IP address.
Initial Power-On 2.1.3 - Graphical Display and Printer This box is displayed for the following session types TSE, VNC, Citrix (local server), 5250, 3270 and Text Emulations: These parameters are: - Resolution (only for TSE and VNC): screen size and frequency. - Bits per Pixel (only for TSE and VNC): number of colours. - Printer Connected: auxiliary port where printer is attached (none, aux1, aux2 or parallel). - Protocol: LPD, TSE, Prt5250 or Prt3270.
Initial Power-On 2.1.4 - Citrix Desktop For session type 'Citrix (ica)' with the connection type 'Citrix Desktop', the following box is displayed: These parameters are: - Username: default value for logon authentication. - Password: press to enter the logon password. - Domain: default value for logon authentication. - IP Address or DNS Name: location of a farm's server - Port TCP: used by the exploration (browser) protocol - Resolution: screen size and frequency.
Initial Power-On 2.1.5 - Citrix (Published Application or Server) For the session type 'Citrix (ica)' with the connection type 'Published Application or Server', the following box is displayed (after the terminal reboots): These parameters are: - Connection Type: value of the last dialog box.
Initial Power-On 2.1.6 - Serial Connection Where the session type is 'Text Emulation' and connection type is 'aux1' the following box is displayed: These parameters are: - Speed: press to select the baud rate - Format: press to select the data format - Handshake for reception: press to select the handshake - Default Port: auxiliary port used for local printings.
Initial Power-On 2.1.7 - Set-Up Summarize At the end of the wizard process, a summary of the selected settings is displayed. For example: Press the [ACCEPT] button to use these settings. After an automatic reboot the terminal is ready to be used. The [Advanced] button enters the interactive setup where further configuring is possible. For example adding different session types. The [BACK] button allows these settings to be changed. 2.
Initial Power-On Auto-configuration is supported by the M65c and all M75 based products. Note: the auto-configuration mechanism requires minimum version 2.0.2 of AxRM (available free from www.axel.com). For more information on AxRM’s action in the auto-configuration process, see the manual "Axel Remote Management - Version 2", available from www.axel.com.
Initial Power-On 2.2.3 - Stage 3: Sending requests to AxRM After obtaining an IP address via DHCP negotiation the terminal must start communicating with the AxRM server. This presents a challenge because the terminal must determine both the IP address and the TCP port of the AxRM server. The recommended way is to configure the DHCP server to send this information in addition to the AX3000 IP address.
Initial Power-On Method 3: If "axrmserv" cannot be resolved, as a final attempt the terminal assumes AxRM resides on the same PC as the DHCP server. Method 4: Only used when the location (IP address or name) and the TCP port of the AxRM machine are specified within the AX3000 Set-Up. See Chapter 3.7.2. The IP address of the AxRM server and the location method used is shown on the status line: Auto-Conf. / DHCP: aaa.bbb.ccc.ddd / AxRM (1): www.xxx.yyy.zzz:nnnn.......
Initial Power-On The dialog box is as shown: AUTO-CONFIGURATION Network detection...................100BT-FD IP Address..........................a.b.c.d DHCP Server.........................e.f.g.h AxRM Server.........................i.j.k.l:n Firmware update.....................in progress Config update....................... Reboot.............................. After having received the firmware the terminal reboots automatically and reruns stages 1, 2 and 3 before passing on to stage 5. 2.2.
Initial Power-On Note: if the firmware is updated the new version is displayed. After the configuration file is received the terminal reboots: AUTO-CONFIGURATION Network detection...................100BT-FD IP Address..........................a.b.c.d DHCP Server.........................e.f.g.h AxRM Server.........................i.j.k.l:n Firmware update.....................TCP.XX.0632b.STD Config update.......................OK Reboot..............................
Interactive Set-Up CHAPTER 3 --INTERACTIVE SET-UP AX3000 - User's Manual 25
Interactive Set-Up This chapter describes AX3000 installation using the interactive set-up procedure. The following can be used to enter the AX3000 interactive set-up: - Using from the terminal - Using Telnet from another terminal/PC. (See Chapter 10.2) Note: the set-up can be password-protected, in which case the password must be entered to access the quick set-up dialog box. For more information, see Chapter 3.7.1.
Interactive Set-Up - Appendix A.2: Ethernet addresses, IP addresses, net masks and routers, - Appendix A.3: DHCP protocol, - Appendix A.4: DNS protocol. 3.1.1 - AX3000 Interface To set the AX3000 interface select the [Configuration]-[TCP/IP]-[Interface] menu. The dialog box below is displayed: This dialog box changes depending on whether the DHCP protocol is enabled. a) The DHCP Protocol The DHCP protocol allows the terminal’s IP address (and other parameters) to be obtained at the boot time.
Interactive Set-Up below is displayed: The parameters of the DHCP Enhanced Box are: - Lease Time (minutes): lease time value requested by the AX3000 from the DHCP server. Depending on the DHCP server settings this parameter may be ignored. The AX3000 automatically renews the lease when it expires. - Client Identifier: when a static IP address is needed (i.e. for the AX3000’s print server), the AX3000 Ethernet address is generally used to identify the AX3000.
Interactive Set-Up is empty, the name won't be registered. The name registration can be performed by the DHCP server or by the terminal itself. For more information see the next chapter and the appendix A.4.3. c) The Terminal Comment This character string allows a terminal description to be entered. This description will be obtained by the Axel Remote Management software (AxRM) during the 'discover' operation. This comment will allow the terminal to be easily located within the database. 3.1.
Interactive Set-Up b) DNS Domains A DNS domain can be used to resolve a server name or to register the terminal name (see Chapter 3.1.3 and Appendix A.4). Note: if the 'Default DNS Domain' is enabled in the AX3000 Interface box (see Chapter 3.1.1) the 'Default Domain' parameter is automatically set and cannot be accessed here.
Interactive Set-Up To configure the server table, select the [Configuration]-[TCP/IP]-[Servers] menu. A dialog box as shown below is displayed: The server definition depends on whether or not DNS is enabled (see Chapter 3.1.2): - No DNS: a server is identified by both an alphanumeric character string beginning with a letter AND an IP address. - With DNS: a server is defined only by its name. This name can be either a full name (www.axel.com) or an incomplete name (as400). Its IP address is resolved later.
Interactive Set-Up which enables data to be sent across two or more distinct physical networks. One router can be nominated as the 'default router' and then used to access any network. Use of a default router simplifies site network administration. The default router is only identified by its IP address. However additional routers can also be declared, to reach specific destination servers or networks.
Interactive Set-Up 3.2 - GENERAL SETTINGS 3.2.1 - The Keyboard Select the [Configuration]-[General]-[Keyboard] menu to access the following dialog box: Keyboard parameters (PS/2 or USB): - Nationality: select the nationality from a list - 'NUM' Led Initialization: this led lights when the AX3000 is switched on - 'CAPS' Led Initialization: this led lights when the AX3000 is switched on - Beep: set and set the duration of the bell sound (values: no, short or long).
Interactive Set-Up 3.2.2 - The Screen Select the [Configuration]-[General]-[Screen] menu to access the following dialog box: Screen parameters: - Screen Type: the available values are: - CRT Standard Monitor: colour VGA/SVGA monitor, - TFT Flat Screen. - Screen Saver: this function automatically either blacks out the monitor display (after a certain time of inactivity) or allows the screen to be locked during the AX3000 use: - No: function disabled. - Yes: function enabled.
Interactive Set-Up 3.2.3 - The Display Select the [Configuration]-[General]-[Display] menu to access the following dialog box: a) Set-up The set-up (and all associated screens (shutdown, free host session...) may be displayed: - Either in text mode, - Or in graphical mode. In this case, the resolution and the VGA frequency must be selected. Using the graphical mode permits the mouse cursor to be displayed as an arrow (instead of a block as in the text mode).
Interactive Set-Up 3.2.4 - RDP/ICA Select the [Configuration]-[General]-[RDP/ICA] menu to access settings specific to RDP/ICA environment. The following dialog box is displayed: b) USB Drives External USB mass storage devices (memory sticks, hard drives, CD/DVD readers…) are redirected to the Windows/Citrix server and are seen as local drives Note: this function is only available the MSC firmware option.
Interactive Set-Up b) Time Redirection The terminal negotiates its own local time zone. This allows different ‘local times’ to be displayed on terminals in different geographic regions? Note: the time zone redirection function must be enabled on the Windows 2003 server. See Chapter 8.4.6. The time zone parameters are: - Time Zone GMT: positive or negative offset from GMT. - Time Zone Name: a non-empty character string (Greenwich by default). - Daylight Saving: enabling daylight saving function.
Interactive Set-Up The RDP/ICA Keyboard parameters are: - Nationality: two possible values: - Default: the keyboard nationality is given by the [Configuration][General]-[Keyboard] menu. This setting is used by default for Windows sessions, and if listed and selected no further action is required. (This same nationality is used for character based sessions and terminal setup menus) - Custom: for nationalities not listed a custom keyboard nationality can be entered.
Interactive Set-Up b) Touch Screens "Touch screen events" are automatically remapped into "mouse events". No additional drivers or settings are required on the server (Windows, Unix/Linux, AS/400...). Touch screen parameters: - Port: serial touch screen port (Aux1, Aux2...) For a USB touch screen this parameter is disabled - Settings: press .
Interactive Set-Up Double Touch Accuracy Range (pixels): this parameter defines a zone size which allows double-click to be emulated. A double-click event will be sent when the screen is touched twice (in a period less than 0.5 seconds) and when the two impacts are located in the same zone (less than X pixels). Note: the touch screen functions properly only after the calibration has been performed.
Interactive Set-Up 3.3.1 - "TSE (rdp)" or "Citrix (Ica)" Session Type Graphical mode session for connections to Windows NT4 TSE, 2000 or 2003. For more information refer to Chapter 8. 3.3.2 - "VNC" Session Type Graphical mode session for connections to Unix/Linux. For more information refer to Chapter 5.2. 3.3.3 - "5250" Session Type Text mode session for connections to AS/400. For more information refer to Chapter 6. 3.3.4 - "3270" Session Type Text mode session for connections to OS/390.
Interactive Set-Up In the [Configuration]-[Sessions] menu, select the source session and press . Then select the destination session and press . After confirmation, the source session settings are applied to the destination session. 3.4 - USB MANAGEMENT 3.4.
Interactive Set-Up Maximum number of connected USB devices: - Two keyboards and barcode readers, - Two mice, - Two HUBs, - Four printers or USB-RS232 adaptors, - One touch screen. - One mass storage device, - Four smartcard readers. 3.4.2 - Connecting a USB Keyboard The USB keyboard is automatically detected by the Axel terminal. The USB keyboard settings (nationality, LED initialisation...) are displayed and can be changed in the AX3000’s General Parameters. For more information see Chapter 3.2.1.
Interactive Set-Up 3.4.6 - Connecting a Printer a) Logical Port Attachment When a USB printer is connected for the first time to the Axel terminal a logical port is associated. Four logical ports are available: Usb1, Usb2, Usb3 and Usb4. The associated logical ports are listed in the menu [Configuration]-[Ports][USB Logical Ports]. To get information of a USB printer, select its logical port and press .
Interactive Set-Up In the menu [Configuration]-[Ports]-[USB Logical Ports] select the logical port and press . The following box is displayed: Select the [DELETE] button to release the logical port. The released logical port is removed from the list of the associated ports and is now available for the next USB device. 3.4.
Interactive Set-Up b) Configuration A logical USB port is allocated to the USB-RS232 adaptor. (See attaching and releasing operations in the Chapter 3.4.6). For example: This USB logical port allows the adaptor to be configured: line parameters (baud rate, format...), service and RDP/ICA redirection. For more information see Chapter 3.5.1. 3.4.8 - Connecting a Touch Screen A USB touch screen may be seen by the terminal: - Either as a pointer device - Or as an USB-RS232 adaptor.
Interactive Set-Up Most USB mass storage devices fall in one of the categories below: - memory sticks, - hard drives, - CD/DVD readers, - memory card readers, - digital cameras. The main difference between these devices is the type of file system (i.e the format in which the data is stored).
Interactive Set-Up This function is designed for PC/SC-compliant smartcard readers. Two readers are supported by the Axel terminal: - CCID readers, - Aladdin eToken. Note: Some "non-PC/SC" readers are also supported. This is achieved with the RDP/ICA COM port redirection (or by the tty protocol for Unix/Linux). In this case RS232 devices or USB-RS232 devices must be used (see Chapter 3.4.7). For the PC/SC devices, a "reader store" is maintained by the terminal.
Interactive Set-Up - IFD Type: character string sent back by the terminal when a SCardGetAttrib (option SCARD_ATTR_VENDOR_IDF_TYPE) command is issued by a Windows PC/SC application. - Smartcard Reader Registration: generally a reader must be attached to the terminal to be enumerated by a PC/SC application (SCardListReaders command). Some readers have to be listed even when they are not attached (for example a token - reader and smartcard are integrated in a memory stick).
Interactive Set-Up 3.5 - SETTING AUXILIARY AND LOGICAL PORTS Three types of ports are available for peripheral devices: - Auxiliary ports: one parallel port, two native serial ports (Aux1 and Aux2) and USB-serial devices (Aux3...). - USB logical ports: a USB logical port is automatically created when a USB printer is connected. Four USB logical ports are available (see Chapter 3.4.6.
Interactive Set-Up Select the [Configuration]-[Ports]-[Auxiliary Ports]-[AuxX] dialog box to configure each auxiliary serial port: These parameters are: - Operating Mode: four modes are available: - Printer: data flow takes place one way only (from the AX3000 to the serial peripheral device). However handshaking between the peripheral and the AX3000 is performed.
Interactive Set-Up - Speed: selected from a list (from 300 to 115,200 bits per second). - Format: data format is selected from a list: data length (7 or 8 bits), stop bit and parity (none, odd or even). - Test Device Presence: the CTS signal can be used by the AX3000 to detect the peripheral’s presence. - DTR Initial State: select 'high' or 'low'. - RTS Initial State: select 'high' or 'low'. - Handshake for Transmission: handshake used by the peripheral to control the AX3000’s data flow.
Interactive Set-Up adaptor. Example of a dialog box for a USB printer: Example of a dialog box for a USB-RS232 adaptor: The dialog box parameters are: - Line Parameters (USB-RS232 adaptor only): see the serial ports Chapter. - Associated Service (ldp, prt5250, tty...): see Chapter 3.5.2 and below. - RDP/ICA Redirection: see Chapter 8.
Interactive Set-Up d) Setting TCP Logical Ports Select the [Configuration]-[Ports]-[TCP Logical Ports]-[NetX] dialog box to configure TCP logical ports: The following parameters can be set: - Connection Type: always 'raw' - Server: press to select the server from a list. - TCP Port: numeric identifier of the connection. The default value is 2048. - Inactivity Time-out (sec): the session is automatically disconnected after this inactivity delay. - Associated Service (ldp, prt5250, tty...
Interactive Set-Up The embedded LPD print server allows the remote printer to be accessed as a standard system printer. An LPD printer requires three parameters: - The AX3000’s IP address or FQDN name if DHCP/DNS is used, - An identifier for the auxiliary port (user selectable character string), - An optional filter to pre-process the file before printing (but generally this processing is done by the operating system level).
Interactive Set-Up 3.5.3 - Connecting a Serial Terminal Two serial terminals can be attached to the AX3000’s serial ports. These serial terminals communicate with the target server(s) using the AX3000’s embedded telnet service. To configure the telnet service for the chosen serial auxiliary port, select the [Configuration]-[Ports]-[Auxiliary Ports]-[AuxX] dialog and enter the following parameters: - Service: select telnet.
Interactive Set-Up 3.5.4 - Connecting other Peripherals The Unix/Linux tty service provides bi-directional control of the device. Note: only the two serial auxiliary ports are bidirectional. For other ports (parallel and logical ports) the tty service acts as a unidirectional service. To set the tty service on the port, enter the following parameters in the [Configuration]-[Ports]-[xxx]-[yyy] dialog box: - Service: select tty.
Interactive Set-Up 3.5.6 - Other Uses a) Using rtty With the rtty service, the AX3000 acts as a server. The AX3000 "listens" on a given TCP port. Then, a connection can be established from a Windows or Unix box to send or received data. Note: the rtty service can also be used with the Axel daemon (axttyd) under UNIX (see Chapter 5.4). To set the rtty service on the port, enter the following parameters in the [Configuration]-[Ports]-[xxx]-[yyy] dialog box: - Service: select rtty.
Interactive Set-Up b) Using the rsh Command to Print The embedded rcmd service allows printing with the rsh command (or rcmd command, according to the operating system used). To set the rcmd service on the required auxiliary port, select the rcmd service from the [Configuration]-[Ports]-[xxx]-[yyy] dialog box. Then enter the name of the associated printer port. For more information about the rsh command, refer to Chapter 5.3.3.
Interactive Set-Up 3.6.1 - Multi-Session Keystroke The keystrokes to move from one session to another can be customized: A session keystroke is composed by: - An introducer: this combination is selected through a list: SHIFT ALT+SHIFT ALT CTRL+SHIFT CTRL CTRL+ALT CTRL+ALT+SHIFT - A session key: this key must different session per session. 3.6.2 - Status Line A label on the status line (at the bottom of the screen) can be used to name each session.
Interactive Set-Up Note about mass storage devices: - When a mass storage device is currently in use, a colored indicator is displayed on the right (green: read in progress, red: write in progress). It's strictly forbidden to remove a USB device when currently in use. - When the mode "Read/Write" is selected (see Chapter 3.2.4), the status line can't be disabled. 3.7.1 - OTHER FUNCTIONS 3.7.1 - Password Access to the set-up menus can be controlled by a password.
Interactive Set-Up b) Entering Set-Up If the set-up is password protected, the following dialog box will be displayed the next time access is attempted: Three operations are permitted: - enter the password to access the set-up - press or select the [CANCEL] button to exit set-up mode - select the [CONSULTATION] button to access the set-up without using the password. All set-up operations will be permitted but it will not be possible to save the modifications in non-volatile memory.
Interactive Set-Up The 'time-out' parameter is the maximum number of seconds allowed for the terminal to load a new firmware/configuration. If nothing is received in this time the terminal boots up using existing current settings.
Using the AX3000 CHAPTER 4 --USING THE AX3000 AX3000 - User's Manual 65
Using the AX3000 This chapter covers use of the AX3000. 4.1 - TURNING ON THE AX3000 The following operations are performed when the terminal is turned-on: - Boot: initialisation, network detection... - Auto-configuration (optional): checks over the network if a new firmware/configuration is available. If yes the terminal reboots again for the new firmware/configuration to take effect (for more information see Chapter 2.
Using the AX3000 4.1.1 - Session Manager: Classic Mode This is the appearance of the classic mode: The following information is displayed for each session: - The associated keystroke. For example - The session label. For example "1 TSE" or "2 5250". - The server. To open a session the user presses the associated keystrokes.
Using the AX3000 4.1.2 - Session Manager: Desktop Mode This is the appearance of the Desktop Mode: The following information is displayed for each session: - An icon - The session label. For example "1 TSE" or "2 5250". - The associated keystroke the server (when the mouse moves over the icon). To open a session the user has simply to press the associated keystroke. Possible actions: - Click the icon to open a session. (The associated keystroke is also available.
Using the AX3000 The session icons are displayed below: TSE ICA Citrix Desktop VNC 5250 3270 Text Emulation 4.2 - USING MULTIPLE SESSIONS AXEL TCP/IP terminals provide multiple and concurrent connections. This feature allows simultaneous access to multiple hosts and applications. 4.2.1 - Opening and Switching Sessions Opening or switching sessions can be done through: - The keyboard: press . These default keystrokes can be changed (see Chapter 3.6.1).
Using the AX3000 If the user closes the current session ( on UNIX) the behaviour of the AX3000 depends on how the 'auto-reconnection' parameter is set for the current session. If this parameter is set to 'yes', a new connection is immediately and automatically established within the current session. If this parameter is set to 'no', the AX3000 displays the first of the remaining active sessions.
Using the AX3000 - Resetting the AX3000. If the password is forgotten, the only way is selecting the [Shutdown] button. After power-cycling it, the AX3000 administrator will be able to modify or remove the screen saver password. Note: For the highest level of security we recommend setting the terminals ‘SetUP’ password. (See Chapter 3.7.1) 4.4 - ADJUSTING THE TFT SCREEN TFT screens offer an auto-adjust function. This function correctly sets up the screen for best viewing in character-based mode.
Using the AX3000 a) Copy From a Windows Session (RDP or ICA): Use the standard 'Copy' function. For example From a VNC Session: The 'vncconfig' tool must be run. The copy is simply done by selecting a text zone. From a Text Session (5250, 3270, ANSI, VT...): Press (with 5250 and 3270 emulations) or (with other emulations) to enter the Copy mode. Use the mouse to select the copy data. Pressing validates the selection and the text is copied into a local clipboard.
Using the AX3000 is turned-off, so the current TCP/IP connections remain active as far as the server is concerned - resulting in various potential issues. Under Unix it is advisable not to turn off the TCP/IP AX3000 when a login prompt is displayed (something which is commonly done with serial UNIX terminals). This is because a telnet connection has been opened and will then become an orphan process.
Using the AX3000 4.7 - AX3000 HOT-KEYS The AX3000 hot-keys are listed in the following table. (These hot-keys are locally processed by the AX3000. They are independent of emulation).
Installing under UNIX/LINUX CHAPTER 5 --INSTALLING UNDER UNIX/LINUX AX3000 - User's Manual 75
Installing under UNIX/LINUX This chapter covers AX3000 installation under Unix/Linux. 5.1 - TEXT MODE SESSION (TCP/IP OR SERIAL MODE) 5.1.1 - Setting a Session Profile To set the profile of a session, enter the AX3000 Set-Up and select the [Configuration]-[Sessions]-[Session X] menu (where X is the session number to be configured). The following box is displayed: These parameters are: - Session Type: select 'Text Emulations'. - Emulation: see Chapter 5.1.
Installing under UNIX/LINUX - Connection Properties: pressing displays a dialog box which allows certain connection parameters to be changed. (See Chapter 5.1.7) - General Parameters: pressing displays a dialog box which allows certain emulation parameters to be changed. (See Chapter 5.1.4) - User-defined Keys: pressing displays a dialog box which allows certain keys to be remapped. (See Chapter 5.1.
Installing under UNIX/LINUX Main characteristics of a tty session: - Pre-defined allocation of pseudo-terminals (ptty), - UNIX access is controlled by a 'login', which is generated by the init daemon (controlled by the /etc/inittab file). The Unix/Linux host must run the AXEL tty server daemon (axttyd). The configuration file axttyd must contain a list of AX3000 sessions and the pttys associated with each.
Installing under UNIX/LINUX The Axel SSH client is compliant with OpenSSH 1.5. To accept Axel SSH connections, the SSH server must first accept connections from SSH V1 clients and support the password authentication mechanism. These two functions are indicated in sshd_config file by: Protocol 2,1 PasswordAuthentication yes d) The Serial Ports (Aux1, Aux2…) The Axel terminal supports both TCP/IP and serial (RS232) connections.
Installing under UNIX/LINUX 5.1.3 - Selecting the Emulation The available emulations are: ANSI SCO OPENSERVER UNIX SVR4 ANSI RS 6000 UNIXWARE 7 LINUX VT100/220 VT52 WYSE 50/60/120 ADDS VP-A2 Enhanced ADDS VP-60 Enhanced 3151 Others... ANSI DOS UNIX SCO 3.2.2 UNIX SCO 3.2.
Installing under UNIX/LINUX 5.1.4 - Customising the Emulation Various emulation parameters can be modified but generally the default values are the most suitable. Three groups of parameters control emulation settings: - General Parameters: emulation behaviour. - Programmable Keys: associating character strings to certain keyboard keys. - Programmable Sequences: associating character strings to any keyboard keys.
Installing under UNIX/LINUX - Wrap: behaviour of the AX3000 when the cursor reaches the last column of the screen: - Yes: the next characters wrap round onto the start of the next line - No: each new character overwrites the last character on the line. - CR=CR+LF: AX3000 behaviour when 0x0Dh is received: - Yes: 0x0D is mapped to 0x0D and 0x0A - No: no specific processing is done - Cursor Shape: three aspects are available (line, half-block and block).
Installing under UNIX/LINUX - Custom: any character can be replaced by the Euro symbol within the current character set (use the decimal notation to enter the Euro ASCII code). - & : enable or disable these two keys - End Sequence: to stop transparent printing mode - Init String: this character string is sent when the session (telnet or tty) is established. - Answer Back: session identifier (10 character max.).
Installing under UNIX/LINUX Within the 'Session Profile' box, select 'User-Defined Keys' and press . The following box is displayed: There are three groups of programmable keys: - From F1 to F48: function keys used singly or with a modifier key. Example for ANSI emulations: F1 to F12: F13 to F24: F25 to F36: F37 to F48: - Numeric pad with Number Lock off - Special keys: Esc, Backspace and the ‘dot’ of the numeric pad.
Installing under UNIX/LINUX Note: for the 'Backspace' key and the numeric pad dot, a toggle is only available (two possible values for each key). Memory usage is limited to 256 bytes maximum per key. c) Programmable Sequences This function allows any key to be remapped into any value (only available for ASCII keyboard mode) Within the 'Session Profile' box, select 'User-Defined Sequences' and press . The following box is displayed: Up to 20 keys can be remapped (from #1 to #20).
Installing under UNIX/LINUX To program a new key (or to modify an existing one) select the sequence number and press . The following dialog box is displayed: Key(s) Sequence: press to enter the keystroke to be remapped. Associated String: enter the value associated with the key sequence. ASCII codes lower than 20h can be entered as '\xx' (where xx is the hexadecimal value of the ASCII code).
Installing under UNIX/LINUX a) Standard Colouring Mode The dialog box for the standard colouring mode is: The available colouring attributes are normal, reverse video, underline, semigraphics and blink (optional). To set a colouring attribute, select and press . The following dialog box appears: Note: the blink and underline parameters are disabled in standard colouring mode.
Installing under UNIX/LINUX The dialog box for enhanced colouring mode is: Colouring mode parameters: - Blink allowed: if this parameter is set to 'no', 16 background colours are available. Otherwise, only 8 background colours are allowed. - Underline allowed: if this parameter (which requires enhanced screen mode) is set to 'yes', the underline attribute can be displayed but only 8 foreground colours are available. Otherwise, there is no underline attribute but 16 foreground colours.
Installing under UNIX/LINUX To set a colouring attribute, select and press . The following dialog box appears: Depending on the Blink allowed and Underline allowed parameters, 8 or 16 foreground and background colours are available and the Blink and Underline parameters are either enabled or disabled. 5.1.6 - Underline Attribute Management The reverse video attribute, the bold attribute and the blinking attribute are supported by all VGA monitors.
Installing under UNIX/LINUX The benefit of this method is that the colouring mode is specific to a single session. Sessions with different colours, or with the native colours of a software package, can be run on the same AX3000. For more information about colouring mode, see Chapter 5.1.5. c) Using Underline Attribute in Colour Mode An AX3000 set-up parameter allows the underline attribute to be displayed in colour mode, but this disables the bold attribute.
Installing under UNIX/LINUX These parameters are: - TERM Value (telnet and ssh protocols). The value of this environment variable is 'negotiated', between the host and the AX3000. The following table shows the default values according to the emulations: Emulation TERM Emulation TERM ANSI SCO OPENSERVER UNIX SVR4 ANSI RS6000 UNIXWARE 7 LINUX VT100/VT220 VT52 WYSE 60 ADDS VP-A2 Enhanced ADDS VP-60 3151 ANSI DOS UNIX SCO 3.2.2 UNIX SCO 3.2.
Installing under UNIX/LINUX ‘Connection Properties’ box, select the "Login Script" parameter. The login script is a character string with the following characteristics: - Maximum 60 characters. - The string is composed of tokens. The NULL character (encoded by \00) is used as a token-separator. A string must contain an even number of tokens. - Any character except a NULL can compose a token. - A string can contain as many tokens as needed. - Odd tokens are characters expected by the AX3000.
Installing under UNIX/LINUX running the AXEL tcpmsh program from a UNIX shell. This supports up to eight duplicated sessions. Operating example: you could run four multi-shell sessions (or «views») across each of two telnet connections to different hosts. Function keystroke combinations could be used to hot-key between the different telnet connections () and different multi-shell views (). a) Installation Copy to /usr/bin and rename as ‘tcpmsh’ the appropriate binary.
Installing under UNIX/LINUX - b 2: using ttypx, ttyqx, ttyrx and ttysx (x is any hexadecimal value from 0 to F). - c: a different overscan colour is associated with each view - f file: initial commands. This command file has a maximum of eight lines. Each line lists the command associated with one view.
Installing under UNIX/LINUX 5.2 - GRAPHICAL MODE SESSION (VNC) The VNC protocol enables a remote graphical display on the Axel-VNCviewer. The image is constructed, maintained and updated within the Unix server’s frame buffer, and transmitted across the TCP/IP network. Note: this protocol is public and the associated software is free. For more information please see http://www.realvnc.com/ The following is a summary of the VNC terminal declaration.
Installing under UNIX/LINUX - Session Type: select 'VNC' - Server: the server name on which the Xvnc daemon is run - TCP Port: numeric value associated with the display (see Chapter 5.2.2). - Connection Properties: pressing displays a dialog box which lets certain connection parameters be changed. See sub-section a. - Password: this allows the optional VNC connection password to be stored (Note: this is the VNC password - not the user password).
Installing under UNIX/LINUX These parameters are: - Auto-Connection: if this parameter is set to 'yes', the connection will be automatically established when the AX3000 is powered. Otherwise, the user can press to establish the connection. - Auto-Reconnection: if this parameter is set to 'yes', a new connection is automatically established after a disconnection. Otherwise, the user can press to establish a new connection. - Session Label: this character string (11 characters max.
Installing under UNIX/LINUX - ZRLE: newer and higher performing encoding but is only supported by a RealVNC server V4. In addition, ZRLE graphical data may be compressed. - Hextile Cache: when this parameter is disabled, display updates are directly done on the screen itself. Else a display update is first built in memory and then displayed. The global performance is the same whatever the method. But the terminal is more comfortable to be used when the 'Cache Hextile' is enabled.
Installing under UNIX/LINUX - ASCII: keyboard events are the same than the top row keys (above QWERTY). With this mode an application can't distinguish is the pressed key belong or not to the numpad. This mode may be required for some JAVE-based applications. - . (numpad): the two available values are the dot (.) and the comma (,).
Installing under UNIX/LINUX folder. b) Analyzing Linux After being launched AxGVNC automatically checks the Linux settings and allows (or not) VNC terminals to be configured: Problems are indicated by red indicators and an attempt to rectify is made by double clicking. When all indicators are green, click the [Next] button.
Installing under UNIX/LINUX c) Configuring VNC Terminals The following dialog box is displayed: Two methods are available: - One VNC Server per Terminal: when Linux is started, one Xvnc daemon per terminal is run. Each terminal will establish a connection to 'its' Xvnc daemon (identified by a different TCP port). The main benefit is after an incident (network or other), the terminal will retrieve the lost session.
Installing under UNIX/LINUX Click the tab corresponding to the preferred method and add VNC terminals. (The Linux server will be rebooted for modifications take effect) 5.3 - CONTROLLING PRINTERS Auxiliary ports (2 serial and 1 parallel) and logical ports (USB and TCP) are provided by the AX3000. These ports are independently controlled so multiple printers can be attached to the AX3000. A printer is generally controlled by a network service: - tty protocol: this is an Axel proprietary protocol.
Installing under UNIX/LINUX Each auxiliary port using the tty protocol (see Chapter 3.5.4) is identified by the name of the AX3000 (from the /etc/hosts file) and a special keyword. For example: axel1 aux1 /dev/ptyp12 axel1 aux2 /dev/ptyp13 /dev/ttyp12 /dev/ttyp13 axel2 parallel /dev/ptyp2 /dev/ttyp2 An auxiliary port controlled by the tty server is seen as a Unix/Linux local port (like a multi I/O board).
Installing under UNIX/LINUX a) Using lpd under IBM AIX V3.x Enter the SMIT fast path smit mkrque. Four 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 AX3000 (refer to /etc/hosts) - Name of Queue on Remote Printer: ⇒ 'Printer Port Name' associated with the AX3000's port - Name of Device to Add: ⇒ device name of printer on AIX b) Using lpd under IBM AIX V4.
Installing under UNIX/LINUX c) Using lpd under SCO UNIX Run scoadmin and select [Printer]-[Printer Manager]. Then select [Printer][Add Remote...]-[UNIX]. A dialog box is displayed. Two parameters are required: - Host: hostname of the AX3000 (refer to /etc/hosts) - Printer: this is the 'Printer Port Name' associated with the AX3000's port Note: an AX3000 filter may be needed. 5.3.3 - The rsh Command The rsh command (or rcmd on SCO OpenServer) can be used to print a file.
Installing under UNIX/LINUX Note: the default printer port is also used to perform local printing of the screen using the key. 5.4 - THE AXEL TTY SERVER 5.4.1 - Overview The TTY server emulates a multi i/o board connection over a TCP/IP connection. For example using this service a remote printer attached to an Axel terminal is accessed by Unix as a local printer via /dev/ttyp4, which may be preferable over using LPD in certain circumstances.
Installing under UNIX/LINUX The following drawing shows the Unix/Linux mechanisms: UNIX Software ttypx Software Software ptypx (slave) (master) ttypy AXEL tty server ptypy (slave) (master) ttypz ptypz Socket (slave) (master) TCP Stack AX3000 TCP/IP Terminal 5.4.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.
Installing under UNIX/LINUX 5.4.3 - Using an AXEL tty server a) Overview The AXEL tty server uses a configuration file which lists all authorised associations between AX3000 resources and UNIX pttys. Each entry in this file contains four parameters: - AX3000 hostname (see /etc/hosts) - The AX3000 resource, which depends on which network service is used: - tty on terminal session: sess1, sess2, ...
Installing under UNIX/LINUX b) Running the Axel Tty Server The command to start the AXEL tty server is: /etc/axttyd [-f file] [-l log] [-n port] [-hbFUk] & -b: use a buffer for received data. -f: configuration file (default: /etc/axfile). -F: ttyp buffers are flushed when the tty connection is established. -h: on-line help. -l: log file (default: /tmp/axttylog). -n: TCP port (default: 2048) for connections using the tty service. -U: only unidirectional dataflow is supported.
Installing under UNIX/LINUX 5.4.5 - Uninstalling Remove the AXEL files and kill the AXEL tty server process (signal TERM): # kill -TERM pid where pid is the process ID of the AXEL tty server. 5.4.6 - In Event of Problems... In event of difficulties please consult the logfile (/tmp/axttylog) and to read the last messages. a) Message "Can not bind TCP port" The message indicates the axtty TCP port (2048 by default) is currently in use. This port must be released.
Installing under UNIX/LINUX is available free on the Axel Web site. See Chapter 8.8.2. The following rsh commands allow an AX3000 to be controlled over the network. (On SCO OpenServer the rsh command is called rcmd). a) Rebooting the AX3000 To reboot an AX3000 over the network, invoke the following command: # rsh axname ax_reboot password Where: - axname : AX3000 name (/etc/hosts) or IP address, - ax_reboot : command for AX3000 reboot, - password : specify the set-up password if set.
Installing under UNIX/LINUX or a partial set-up can also be obtained (only used set-up parameters are sent): # rsh axname setup_get_lite > /tmp/axel Where: - axname : AX3000 name (/etc/hosts) or IP address, - setup_get : command for getting the whole set-up, - setup_get_lite : command for getting the partial set-up. For more information about these commands, refer to Chapter 10.
Installing under UNIX/LINUX Messages are displayed on the target AX3000 (See Chapter 11.4). f) Viewing AX3000 Statistics Some AX3000 statistics can be obtained by invoking the following command: # rsh axname ax_getstat Where: - axname : AX3000 name (/etc/hosts) or IP address, - ax_getstat : command for getting statistics.
Installing under OS/400 CHAPTER 6 --INSTALLING UNDER OS/400 AX3000 - User's Manual 115
Installing under OS/400 This chapter covers AX3000 installation under OS/400. This chapter describes the operation of the AX3000 in an OS/400 environment. For more general information about the AX3000 (network and session settings, etc) please refer to the previous chapters. The AX3000 is able to handle both 5250 screen sessions (tn5250 emulation) and printers (protocols Prt5250 and LPD). 6.1 - 5250 SCREEN SESSION The IBM 5250 emulation type developed by Axel is IBM-3477-FC.
Installing under OS/400 [Configuration]-[Advanced]-[Tuning] menu. Set the "Keyboard Type" to "PC" or "AS400 (F24)" in the displayed box Press to enter the AX3000 Set-Up with an AS400 keyboard. b) In event of problems If the AX3000 setting is not consistent (a PC keyboard is attached but a 5250 keyboard is declared, or vice versa), the keyboard won’t work. A specific keystroke allows the keyboard type to be dynamically toggled.
Installing under OS/400 - Auto-Logon: press to set the Auto-Signon function (see Chapter 6.1.4). - Terminal Name (DEVNAME): if this name is left blank, the OS/400 will associate a dynamic name to this terminal (i.e.: QPADEV001). - General Parameters: pressing displays a dialog box which lets certain emulation parameters be changed. See the next chapter for more information. - User-defined Sequences: pressing displays a dialog box which lets any keys be remapped.
Installing under OS/400 a) 5250 Emulation General Parameters Within the 'Session Profile' box, select 'General Parameters' and press . The following box is displayed: These parameters are: - Character Set: the two possible values are: - National (some characters are keyboard nationality dependent), - Multinational. - Cursor Shape: three possible values: underline, half-block or block. Note: to change the cursor shape from a 5250 session press (or with a PC keyboard).
Installing under OS/400 - Caps Lock +: same as 'Shift Lock'. But in addition ALL the keys supported (including , function keys...). - Euro Coding: Euro symbol support. The three possible values are: - No: no specific processing is done - Standard: the Euro symbol replaces the international currency symbol '¤' within the current character set. - Custom: any character can be replaced by the Euro symbol within the current character set (use the decimal notation).
Installing under OS/400 - Yes, hexa: data is encoded only in hexadecimal notation. - On/Off ASCII Sequence: start and stop transparent mode sequence. For more information see Chapter 6.2.5. b) Remapping 5250 Functions to any PC Keyboard keys Select "User Defined Sequences" within the 'Session Profile' box and press to display the following box: Up to 20 sequences can be remapped (from #1 to #20). To program a new sequence (or to modify an existing one) select the sequence number and press .
Installing under OS/400 6.1.4 - Setting-Up the Auto-Signon Function Within the 'Session Profile' box, select 'Auto Signon' and press . The following box is displayed: This box allows a value to be entered for each parameter displayed within an AS/400 Signon Screen: - Username - Password (available only if 'Username' is not empty): press to enter the password. - Program/Procedure (available only if 'Username' is not empty). - Menu (available only if 'Username' is not empty).
Installing under OS/400 These parameters are: - TERM Value: terminal capabilities. Default value is IBM-3477-FC. - Auto-Connection: if this parameter is set to 'yes', the connection will be automatically established when the AX3000 is powered. Otherwise, the user can press to establish the connection. - Auto-Reconnection: if this parameter is set to 'yes', a new connection is automatically established after a disconnection. Otherwise, the user can press to establish a new connection.
Installing under OS/400 The status symbols are described in the following table. Symbol ] ( X © A ^ ð R P LL/CC 124 Name System Available Message(s) Waiting Input Inhibit Meaning The host system is operating and available This symbol, and a beep, indicate the host system has one or more messages for the terminal.
Installing under OS/400 6.2.2 - Using the Keyboard Two types of keyboard can be used with the AX3000: a PC/AT (102/105-key) or a 5250 (122-key) keyboard. The following tables list the 5250 functions and the Axel functions (entering the set-up, etc) accessed from these keyboard. 5250 Functions: 5250 Functions Attention Back tabulation Clear end of field Clear all fields Cursor shape (Ch. 6.1.3) Duplication Enter Euro symbol Execute macro F1...F12 F13...
Installing under OS/400 Axel Functions: Axel Function AX3000 Shutdown AX3000 Set-Up Disconnecting the session Sending data to the aux. port 5250 Keyboard PC/AT Keyboard 6.2.3 - Programming Function Keys (Macro Feature) The Axel 5250 emulation allows function keys to be programmed.
Installing under OS/400 Example: 1 - Press to set the Record mode. The 5250 status line is set in reverse video mode and the following information is displayed: - Maximum recordable keystrokes for the terminal - The 24 boxes are the 24 function keys, a solid box means that data is recorded) 127 MEMOR 17/21 2 - Press one of the function keys ( to or to ).
Installing under OS/400 6.2.4 - The Mouse Note: the mouse must be enabled. See Chapter 6.1.3. Four mouse actions are possible: - Left-click, two possible actions are possible depending on the character string under the mouse cursor: - If the character string is a function key label, this function key is sent (keystroke emulation). - Otherwise the text cursor is moved to the mouse cursor location.
Installing under OS/400 a) Start and Stop Sequence Enable the transparent mode and select the start and stop sequence (default value: @%@) b) Operating Mode Rules The transparent mode is driven by the following rules: • For a screen session, enable the transparent mode by sending the transparent sequence (@%@) followed by the port number: 0: default port. 1 to 3: native auxiliary ports (Aux1, Aux2 and parallel) 4 to 5: TCP logical ports (Net1 and Net2).
Installing under OS/400 Example 1: Screen session, character mode When this EBCDIC data is received: @%@1/1Bat/2F@%@ (44 6C 44 F1 61 F1 C2 81 A3 61 F2 C6 44 6C 44) This ASCII data is sent to the AUX1 port: at/ (1B 61 74 2F) Example 2: Printer Session, character mode When this EBCDIC data is received: @%@/1Bat/2F@%@ (44 6C 44 F1 61 F1 C2 81 A3 61 F2 C6 44 6C 44) This ASCII data is sent to the auxiliary port of this printer session: at/ (1B 61 74 2F) e) Handling DTR and RTS Signals The transparent
Installing under OS/400 These printers can be controlled by one of two protocols: - Prt5250: this service (RFC 2877) is OS/400 oriented. A printer controlled by this service is seen as a standard spooled system printer device. - LPD: this service (RFCs 1048 and related) is provided as a standard feature by major operating systems (Unix/Linux, NT, etc.). The main benefit of this protocol is an LPD printer can be shared by different operating systems.
Installing under OS/400 These parameters are: - Server: the server to which the AX3000 opens a printer connection (press to get a list of available servers). This parameter must be entered. - Enhanced Parameters: access to a group of parameters. The default values of these parameters are suitable for most of the use. See next sub-chapter. - Printer Name (DEVNAME): printer device name.
Installing under OS/400 b) Advanced Settings Within the Prt5250 box select "Enhanced Parameters" and press . The following dialog box is displayed: These parameters are: - TCP Port: OS/400 telnet port. Generally 23. - TERM Value: terminal capabilities. Default value is IBM-3477-FC. - Auto-Connection: if this parameter is set to 'yes', the connection will be automatically established when the AX3000 is powered. Otherwise, the user can press to establish the connection.
Installing under OS/400 A printer handled through the Prt5250 service is seen as a standard spooled OS/400 printer and is managed through standard system commands: ===> GO PRINTER d) In Event of Problems Nothing is printed: this is a quick test to check the hardware (AX3000 parallel/serial port, cable and printer): - In the AX3000 Set-Up, select [Configuration]-[Ports]-[xxx]. Within the displayed box, select the [TEST] button. - A test banner should be printed.
Installing under OS/400 - 8928 (Change of device failed): during the printer modification operation (reconnection with different parameters), at least one parameter is detected wrong (ex.: non-existing printer model). - 8930 (Message queue does not exist.): the message queue or its library doesn't exist. - AX01 (Terminal type not recognized): the TERM variable (by default IBM3812-1) associated with the AX3000 auxiliary port is not correct. Note: all possible errors are listed in the RFC 2877. 6.3.
Installing under OS/400 6.4 - REMOTE ADMINISTRATION 6.4.1 - Remote Control This functionality allows an administrator to remotely take control of a terminal. The administrator can passively watch the users screen or actively take control with his own keyboard for various support or administration purposes. For more information refer to Chapter 10.1. 6.4.2 - Other Functions ☺: A Windows administration utility (AxRM or Axel Remote Management) is available free on the Axel Web site. See Chapter 8.8.2.
Installing under OS/400 The supported resources are: - Screen sessions: SESS1, SESS2... - Auxiliary ports: AUX1, AUX2, PARALLEL, NETx and USBx. Use the following command to reset a resource: ===> RUNRMTCMD CMD('AX_SINIT password RESS') RMTLOCNAME('192.1.1.241' *IP) Where: - AX_REBOOT : Command for AX3000 resource reset, - password : Specify the set-up password if set, - 192.1.1.241 : AX3000 IP address. - RESS : Resource name (ex: SESS1).
Installing under OS/400 For more information about this command, refer to Chapter 10. e) Downloading a Firmware To download an AX3000 firmware through TFTP: ===> RUNRMTCMD CMD('AX_DOWNLOAD password /axfirm/ax3000 192.168.1.180') RMTLOCNAME('192.168.1.241' *IP) To download an AX3000 firmware through BOOTP and TFTP: ===> RUNRMTCMD CMD('AX_DOWNLOAD password /axfirm/ax3000 192.168.1.
Installing under OS/400 6.5.2 - Reconnection Problem If an AX3000 5250 session is set with a specific DEVNAME, problems can occur if it is not cleanly shutdown before being switched off. If the terminal is powered off without signing off first the As/400 will be unaware the connection is broken and will still consider the connection to be valid and in use. If the terminal then tries to sign on with the same devname the As/400 will refuse connection.
Installing under OS/390 CHAPTER 7 --INSTALLING UNDER OS/390 AX3000 - User's Manual 141
Installing under OS/390 This chapter covers AX3000 installation under OS/390 zSeries. This chapter is dedicated to the operation of the AX3000 in the OS/390 environment. For more general information about the AX3000 (network and session settings, instructions for users, etc) please refer to the previous chapters. 7.1 - 3270 SCREEN SESSION The IBM 3270 emulation type developed by Axel provides all the features of an IBM 3270 terminal.
Installing under OS/390 7.1.1 - Setting a Session To set a profile session, enter the AX3000 Set-Up and select the [Configuration]-[Sessions]-[Session X] menu (where X is the session number to be configured). The following box is displayed: These parameters are: - Type: select "3270" - Server: press to select the server from a list - Connection Properties: pressing displays a dialog box which lets certain connection parameters be changed. See Chapter 7.1.
Installing under OS/390 of parameters control 3270 emulation settings: - General Parameters: 3270 emulation behaviour, - User-defined Sequences: mapping 3270 functions to any PC keyboard keys. a) 3270 Emulation General Parameters Within the 'Session Profile' box, select 'General Parameters' and press . The following box is displayed: These parameters are: - Character Set: the two possible values are: - National (some characters are keyboard nationality dependent), - Multinational.
Installing under OS/390 - Rulers Palette: pressing displays a dialog box which lets rule colours be remapped. - Mouse Allowed: enable/disable the mouse within this session - CAPS Key Mode: set the CAPS LOCK to behave in either of two ways: - Caps Lock: only alphabetical keys are affected. To unlock this mode press the key. - Shift Lock: each key sends either the corresponding upper case letter or the shifted (upper) character. To unlock this mode press the key.
Installing under OS/390 b) Remapping 3270 Functions to any PC Keyboard keys Select "User Defined Sequences" within the 'Session Profile' box and press to display the following box: Up to 20 sequences can be remapped (from #1 to #20). To program a new sequence (or to modify an existing one) select the sequence number and press . The following dialog box is displayed: Press to enter the keystroke to be remapped. Then press to select through a list the associated 3270 function.
Installing under OS/390 7.1.3 - Connection Properties Within the 'Session Profile' box, select 'Connection Properties' and press . The following box is displayed: These parameters are: - TERM Value: terminal capabilities. Default value is IBM-3278-2-E. - Auto-Connection: if this parameter is set to 'yes', the connection will be automatically established when the AX3000 is powered. Otherwise, the user can press to establish the connection.
Installing under OS/390 The 3270 status line is displayed at the bottom of the screen and gives the following information: Connection status Shift/Caps Keyboard indicators SA] © ^ X () Connection type: ] (application) ? (system) Function key Assignment Insert R 64 LL/CC Available Keystrokes Mode: R (Record) Cursor Locator P (Process) The status symbols are described in the following tables.
Installing under OS/390 Mode Symbols Symbol © ^ R P LL/CC Meaning is currently pressed or the keyboard is in Caps Lock mode The insert mode is enabled ( key) The "Record" mode is set (see Chapter 6.2.3) The "Process" mode is set (see Chapter 6.2.3) LL and CC indicate the row and column where the cursor is located 7.2.2 - Using a PC/AT Keyboard (102/105 keys) The IBM 3270 emulation enables a PC/AT keyboard to be used for operation as a 3270 terminal.
Installing under OS/390 The following table lists the other useful keys: 3270 Functions PC/AT keyboard Fast cursor move to right Fast cursor move to left Backspace Tab BackTab Home Newline EOF Erase Input Insert mode Delete Duplicate Field Mark System Attention Reset Clear PA1 PA2 PA3 PF1 PF13 Enter or or
Installing under OS/390 The recorded data is stored in non-volatile memory so is not affected by switching off. Recorded keystrokes can be assigned to any of the twelve function keys ( to ). a) Programming a Function Key To record a series of keystrokes proceed as follows: - Press to set the record mode, - Press any of the 12 function keys to which you want to assign, - Type the key sequence you want to save, - Press to exit the record mode.
Installing under OS/390 b) Processing a Key Sequence To execute a series of keystrokes that have been recorded: - Press to set the Process mode, - Press the recorded function key, - The key sequence is processed. Example: 1 - Press to set the Process mode.
Installing under OS/390 To set the Prt3270 service, enter the AX3000 Set-Up and select [Configuration]-[Aux. Ports]-[xxx]. In the displayed box, set the "Associated Service" to "Prt3270", then select "Net Service Parameters" and press . The following box is displayed: These parameters are: - Server: the server to which the AX3000 opens a printer connection (press to get a list of available servers). This parameter must be entered. - TCP PORT: telnet port of the S/390 server. Default is 23.
Installing under OS/390 The administrator can passively watch the users screen or actively take control with his own keyboard for various support or administration purposes. For more information refer to Chapter 10.1. 7.4.2 - Other Functions The remote administration command is rsh (or rexec). This command is available with most of operating systems. ☺: a Windows administration utility (AxRM or Axel Remote Management) is available free on the Axel Web site. See Chapter 8.8.2.
Installing under Windows CHAPTER 8 --INSTALLING UNDER WINDOWS AX3000 - User's Manual 155
Installing under Windows This chapter covers AX3000 installation under Windows This chapter describes the operation of the AX3000 in a Windows environment. For more general information about the AX3000 (network and session settings, instructions for users, etc) please refer to the previous chapters. The connection to a Windows server can be done either via: - Microsoft's RDP protocol. See Chapter 8.1. - Citrix's ICA protocol. Two connection types are available: - To a published server or application.
Installing under Windows 8.1.1 - Setting-Up an RDP Session To set an RDP session, enter the AX3000 Set-Up and select the [Configuration]-[Sessions]-[Session X] menu (where X is the session number to be configured).
Installing under Windows - Additional Parameters: pressing displays a dialog box, which lets certain RDP parameters be changed. For more information, see Chapter 8.1.2. - Redirected Resources: press to set redirected printers and COM ports. For more information, see Chapter 8.1.4. - Bandwidth: pressing displays a dialog box, which lets certain parameters be changed. For more information, see Chapter 8.1.5. Note: after saving changes power-cycle the AX3000. 8.1.
Installing under Windows - Mouse Accelerator: if 'yes', the AX3000 speeds up the mouse cursor. - Server Remote Control: when set to 'yes', the RDP connection will take remote control of the Windows Server main console. - : the two modes for this keystroke are: - Local: the keystroke is handled by the AX3000 and is used for shutdown the terminal (see Chapter 4.6) - Remote: the keystroke is handled by the Windows server (for example opening the task manager).
Installing under Windows Example: %SystemRoot%\system32\cmd.exe - Working Directory (available only if 'Auto-Run' is set to 'yes'): sets program working directory. Example: D:\ 8.1.4 - Redirected Resources The redirected resources mechanism allows one or more local resources to be 'published' to the Windows server. These resources are available only for the terminal's user. They are created on the Windows server when the connection is established and removed when the session is disconnected.
Installing under Windows Select the dialog box of the 'Connection port' (menu [Configuration]-[Ports][xxx]). For example, the Aux1 port: Set the 'Active' parameter to 'As Printer' or 'As Printer and COM'. Then select 'Printer Parameters' and press . The following box is displayed: These parameters are: - Printer Name: name of the Windows printer. (User definable) - Windows TSE Driver: printer driver name.
Installing under Windows sub-section c). b) Declaring a Redirected COM Port On RDP/ICA connection a redirected COM port will be automatically added to the Windows server resources. It will be removed on disconnection. Before being redirected an RDP/ICA COM Port must be declared at the 'physical port' level. The available ports are: auxiliary ports (parallel, Aux1 and Aux2), USB and network logical ports. Select the dialog box of the 'Connection port' (menu [Configuration]-[Ports][xxx]).
Installing under Windows These parameters are: - Port Name: redirect COM port name (from COM1 to COM255). - DSR Signal (only for Aux1 and Aux2): the DSR signal is not supported by the AX3000 native auxiliary ports. This parameter allows the incoming DSR value to be emulated. The possible values are: "Always Low", "Always Up", "Follows CTS" or "Follows CD". The COM port declaration is completed. For the redirection procedure, consult the next sub-section.
Installing under Windows - None - COMx (port): these are the COM port name(s). This allows the selection of only one COM port to be redirected. - Redirected USB Drive: enable/disable the mass storage device redirection. The 'Access Permission' value reminds the selected mode (see Chapter 3.2.4). - Redirected Smartcards: enable/disable the smartcard redirection. - Auto-Connection: when set to yes, the option allows the ICA session to be automatically established when a smartcard is inserted in the reader.
Installing under Windows - Mouse Events Reported: the options are: - All (default): all mouse events (clicks and position) are sent to the server. - Click: only the click events are sent to the server. This reduces the data flow. But the mouse cursor is not updated in real time. This mode can significantly reduce bandwidth. The following parameters are only supported when the terminal is connected to a Windows 2003 server. By default, all these features are disabled.
Installing under Windows These parameters are: - Auto-Connection: if this parameter is set to 'yes', the connection will be automatically established when the AX3000 is powered. Otherwise, the user can press to establish the connection. - Auto-Reconnection: if this parameter is set to 'yes', a new connection is automatically established after a disconnection. Otherwise, the user can press to establish a new connection. - Session Label: this character string (11 characters max.
Installing under Windows Note: for "Citrix Desktop" see Chapter 8.3. - ICA Browser Settings (only for "ICA Server" or "Published Application" target type): pressing displays a dialog box which allows certain ICA Browsing parameters be changed. For more information, see Chapter 8.2.2. - Host or Published Application: the option for this setting depends on the selected Target Type. See Chapter 8.2.2.
Installing under Windows - Server (local list): this is a server previously entered through the menu [Configuration]-[TCP/IP]-[Hosts]. Select the "Server" parameter and press to display the server list. - ICA Server: this is a server from the Citrix server farm. Select the "Server" parameter and manually enter the server name or press to browse the Citrix server farm. - Published Application: this is a published application from the Citrix server farm.
Installing under Windows - TCP Port: with "HTTP + TCP/IP" mode, the default value is 80 and can be modified. With "TCP/IP" mode the value is 1604 and can't be modified. - IP Address or DNS Name: depending on the exploration protocol, the ICA browsing behaviour differs: - TCP/IP + HTTP: when this parameter is left blank, the ICA request is sent to the DNS name 'ica'. Otherwise it is sent to the entered DNS name or IP address. - TCP/IP: when this parameter is left blank, the ICA request is broadcasted.
Installing under Windows 8.2.3 - ICA Additional Parameters Within the 'Session Profile' box, select 'Additional Parameters' and press . The following box is displayed: These parameters are: - Encryption: the supported encryption protocols are: - Basic Level: default encryption protocol of Metaframe.
Installing under Windows 8.2.4 - Automatic Logon and Auto-Run Within the 'Session Profile' box, select 'Login Script' and press . The following box is displayed: These parameters are: - Username: this is the default value for the username field of the Login screen. - Automatic Logon: set this parameter to 'Yes' to get an automatic logon. For more information about the auto-login, see Chapter 8.1.2.
Installing under Windows terminal's user. They are created on the Windows server when the connection is established and removed when the session is disconnected. The following local resources are supported: - Printers: before being redirected each printer must be declared at the 'physical connection port' level. See first sub-section a) then c). - COM ports before being redirected each port must be declared at the physical port level. See first sub-section b) then c) and d).
Installing under Windows Set the 'Active' parameter to 'As Printer' or 'As Printer and COM'. Then select 'Printer Parameters' and press . The following box is displayed: These parameters are: - Printer Name: name of the Windows printer. (User definable) - Windows TSE Driver: printer driver name. It is ESSENTIAL that the value entered here matches the printer driver name exactly as installed on the server.
Installing under Windows Select the dialog box of the 'Connection port' (menu [Configuration]-[Ports][xxx]). For example, the Aux1 port: Set the 'Active' parameter to 'As COM port' or 'As Printer and COM'. Then select 'COM Port Parameters' and press . The following box is displayed: These parameters are: - Port Name: redirect COM port name (from COM1 to COM255). - DSR Signal (only for Aux1 and Aux2): the DSR signal is not supported by the AX3000 native auxiliary ports.
Installing under Windows c) Redirecting Resources within the ICA session To redirect resources within a session select the session profile box (menu [Configuration]-[Sessions]-[Session X]). Within this box, select 'Redirected Resources' and press . The following box is displayed: These parameters are: - Redirected Printer: printer(s) are selected through a list. This list is composed by the following items: - All - None - Printer Name (port): these are the RDP/ICA printer name(s).
Installing under Windows d) Remapping a COM port Terminal COM ports must be remapped to server COM ports. The remapping commands are "change client" or "net use". These commands may be issued from a command prompt from the terminal’s Citrix session. Example: the Windows COM4 port is remapped to the terminal COM1 port net use com4: \\client\com1: or change client com4: com1: Note: this remapped resource is only for the terminal. In this example COM4 is not seen by other users.
Installing under Windows - Mouse Sensitivity: This setting varies the sample rate of the mouse. If the sensitivity is increased the mouse movement will be more fluid, but also network activity is increased. - Mouse Events Reported: the options are: - All (default): all mouse events (clicks and position) are sent to the server. - Click: only the click events are sent to the server. This reduces the data flow. But the mouse cursor is not updated in real time. This mode can significantly improve bandwidth. 8.
Installing under Windows The Citrix Desktop session is comparable in functionality to the Citrix product Nfuse, WEB Interface or Program Neighborhood. 8.3.1 – General Configuration of the Citrix Desktop session The M75c terminal supports a maximum of 6 sessions. When Citrix Desktop is used one session is taken by the desktop itself. After the user has been authenticated by the Citrix Server, the Citrix Server sends user specific data through this session to configure the user’s individual desktop, i.e.
Installing under Windows - Within the Citrix Desktop dialogue box the number of Citrix published applications is set (1 to 5). If 5 is selected all sessions are reserved for Citrix – if however 3 are selected 2 sessions are available for non-Citrix connections. The total cannot exceed 5.
Installing under Windows To configure the Citrix Desktop session, enter (), select the [Configuration]-[Sessions]-[Session X] menu (where X is the number of the session. The dialogue box below is displayed: Enter the following values - Session Type: select "Citrix (ica)" - Connection Type: select "CITRIX Desktop" - ICA Browser Settings: press the spacebar to select browser settings (see chapter 8.2.
Installing under Windows - Logon Authentication: press spacebar to show a dialogue box permitting the user’s name, password and domain to be entered. This removes the need to enter these details for every logon. - Number of Sessions: this sets the number of sessions reserved for published applications on the Citrix Desktop session. - Label: by default the desktop is labelled ‘Applications’.
Installing under Windows 8.3.2 - Using the Citrix Desktop a) Connection On establishing the Citrix Desktop, authentication is requested. (Username, password and domain). A local dialogue box requests this information as below: These authentication parameters are sent to the Citrix servers which permit or deny the user access. The user name (and password) can be entered in the terminal’s setup to remove the need to re-enter on every login.
Installing under Windows b) Using the Desktop After authentication the user is given a standard graphical interface for launching applications: Notes: - The screen is slightly different for different screen resolutions 1280x1024 – the screen displayed is as above 1024x768 – the upper banner is not displayed 800x600 – neither upper nor lower banner are displayed - The ‘Refresh’ icon (top right corner) refreshes the desktop - The ‘Folder’ icon is a standard Citrix offering and can be used to contain and org
Installing under Windows General ICA Session Information: - A new ICA connection becomes the current session. - The Metaframe server hosting this session is localised with the browser parameters. - The ICA session uses the general operational parameters specified in the set-up (encoding, bandwidth...). - The screen resolution and number of colours for all published applications is set by the Citrix server for that application.
Installing under Windows When this utility is run the dialog box below is displayed: Select 'Connections' in the left panel. On the right panel, double-click the line 'RDP-Tcp' or ('ICA-Tcp') to configure the RDP server (or ICA server). Another dialog box is displayed. It allows setting: - The encryption level, - The automatic logon, - The idle session limit. 8.4.1 - Encryption Level The data flow between the RDP or ICA server and the client is generally encrypted.
Installing under Windows Note: despite its name low encryption level is a satisfactory security level in most cases. Within Server¥Terminal communication, only data sent by the terminal is critical (password, confidential code, etc). The unencrypted data sent from the server is the physical screen display, i.e. coloured pixels and not text. To modify the encryption level, within the 'RDP-Tcp Properties' box, click on the 'General' tab.
Installing under Windows 'General' tab. The same dialog box than RDP protocol is displayed. Set the 'Encryption level' parameter to 'None' or 'Basic'. 8.4.2 - Automatic Logon Information required for logon (username, domain name and password) can be provided by the terminal. This saves manually entering this information at every login. This feature must be enabled at the Windows server level (by default an automatic password is not accepted by the server).
Installing under Windows 8.4.3 - Idle Session Limit When the AX3000 is powered off without logging out, the current TCP/IP connections remain active on the server side (see Chapter 8.5.3). To avoid these 'phantom' sessions, an automatic clean-up mechanism is offered. This shuts down the idle sessions after a certain time. The idle session disconnection can be set either at the user settings level (see the User Properties dialog box) or at a global level.
Installing under Windows over lunch time). Take care to set an appropriate delay for the terminal’s use. 8.4.4 - Desktop Background with Windows 2003 By default, with a Windows 2003 server, it is impossible to select a desktop background for an RDP terminal. To allow a desktop background, run the "Group Policy Object Editor" (GPEDIT.MSC): Expand the tree to [Computer Configuration]-[Administrative Templates][Windows Components]-[Terminal Services].
Installing under Windows 8.4.5 - Allowing Blank Passwords with Windows 2003 By default, with a Windows 2003 server, it's impossible to set a blank password for a remote user. To allow blank passwords run the "Local Security Policy" utility (in [Start][Program]-[Administrative Tools]): Expand the tree to [Security Setting]-[Local Policies]-[Security Options]. Set the parameters "Accounts: Limit local accounts use of blank password to console logon only" to "Disabled". 8.4.
Installing under Windows a) On Windows TSE By default, with a Windows 2003 server, the time zone redirection is disabled. To enable it run the "Group Policy Object Editor" (GPEDIT.MSC). See screen shot in sub section d. Expand the tree to [Computer Configuration]-[Administrative Templates][Windows Components]-[Terminal Services]-[Data Client/Server Redirection]. Set the parameter "Enabling Time Zone Redirection" to "Enabled".
Installing under Windows When this utility is run, a dialog box as shown below is displayed: On the left panel, select the session to be killed, then right-click. Within the displayed menu, select 'Disconnect' command. After confirmation, the selected session will be closed and removed from the session list. 8.5 - USING THE AX3000 8.5.1 - Opening a Windows Session On successful connection, the AX3000 displays the graphical login screen or the desktop if the automatic-logon function is set. 8.5.
Installing under Windows session. When the session is established, the value of certain parameters can be renegotiated by the server (for example the number of colours). This information box gives the values actually used: Server IP Address Server Version License Connection Name Encryption Number of colors Resolution Compression Required Screen Printer and Aux. Redirected Printer Redirected COM Port : : : : : : : : : : : : a.b.c.
Installing under Windows c) Disconnect by the AX3000 The keystroke (locally processed by the AX3000) allows the current session to be disconnected and works regardless the protocol or emulation. As above, the session is disconnected (at the TCP/IP level) but the current environment (desktop and running applications) is not closed. The user will be able to retrieve this environment the next time the connection is opened. 8.5.
Installing under Windows 3. The Windows server doesn't convert a temporary license to a 'standard' license. The server must be updated: - For Windows 2003, install Service Pack 1. - For Windows 2000, please consult http://support.microsoft.com/default.aspx?scid=kb;en-us;827355 8.6 - MANAGING PRINTERS Auxiliary ports (2 serial and 1 parallel) and logical ports (USB and TCP) are provided by the AX3000. These ports are independently controlled so multiple printers can be attached to the AX3000.
Installing under Windows - The printer dataflow can be compressed. - The display and printer data flows are multiplexed by TSE. The following applies only with LPD printer configuration. For an RDP printer see Chapter 8.1.4 and for an ICA see Chapter 8.2.5. 8.6.1 - Setting-Up the AX3000 To set the LPD service on the terminal port, select the [Configuration]-[Ports aux.]-[xxx] dialog and enter the following parameters: - Associated Service: select lpd.
Installing under Windows Click on 'Next'. Note: if 'LPR Port' is not available, you need to install 'Print Services for Unix' from the Windows CD-Rom. Finally within the next dialog box, enter the two parameters requested: - Name or address of the server providing LPD: AX3000 IP address - Name of printer or print queue of that server: this is the 'Printer Port Name' AX3000 Set-Up parameter (see Chapter 2.2).
Installing under Windows Example of 'Menu': the menu is displayed in the centre of the screen. Example of 'Toolbar': the tool-bar displayed along the top of the screen Example of 'Desktop': a task bar is displayed at the bottom of the screen For more information about the AxMenu utility, read the manual "Axel Menu Publishing Applications and Securing the Desktop for Windows TSE". 8.8 - REMOTE ADMINISTRATION 8.8.
Installing under Windows various support or administration purposes. The following diagram clarifies the concept of remote control with RDP protocol (the same principles apply for ICA connections): The procedure to take control of a remote terminal is as follows: - Open an administrator RDP connection to the Windows server - Launch ‘Terminal Services Manager’ from ‘Administrative Tools’. - All connected terminals are listed – select target for remote control.
Installing under Windows - Obtaining network and device statistics - Obtaining set-up configuration - Rebooting the peripheral - Remotely configuring a peripheral - Downloading firmware, - Entering the interactive set-up via a telnet client. It is also possible: - To build and manage a terminal database, - To compile a list (batch) of commands to run consecutively, - To download a firmware though BOOTP, - To set IP addresses by using the device MAC address.
Tools and Statistics CHAPTER 9 --TOOLS AND STATISTICS AX3000 - User's Manual 201
Tools and Statistics This chapter describes the embedded AX3000 tools. The AX3000 provides the following features: - Ping command - Connection management - Statistics environment Note: these functions are accessed from the AX3000 interactive set-up. 9.1 - THE PING COMMAND The ping command is used to check for the presence of a live TPC/IP device. Select the [Diagnostics]-[Ping] dialog from the AX3000 set-up, then enter the IP address or the name of the TCP/IP peripheral.
Tools and Statistics Select the [Diagnostics]-[Connections] dialog to check the status of all defined connections: Note: 'outside' the set-up, use displays this box. For each session, the following information is displayed: - No: session number. - Type: main values are TSE, ica, telnet, tty, vnc... - State: the possible values are: - Established: the session is connected, - Closed: the session has ended, - Syn sent: connection request in progress, - Time Wait: connection close in progress.
Tools and Statistics For each auxiliary port, the following information is displayed: - Port: the name of the port: Aux1, Aux2, PARA (parallel), Usb1, ...
Tools and Statistics 9.3.1 - Ethernet Statistics The following information is displayed: Correct Frames: "Output" and "Input" are the number of correct frames (transmitted and received) Errors: this section gives the type and the number of errors. No errors should be shown in a good working environment/healthy network. Other information: - "Hardware Interrupts" gives information about the terminals Ethernet controller. - "Unknown Frame Type" is the number of non-TCP frames received. (Example IPX frames.
Tools and Statistics 9.3.2 - Interface Statistics The following information is displayed: In the above dialog box, the following information is given: - FQDN: terminal full name (if given) - State: the current DHCP state.
Tools and Statistics - Status: the possible update values are: - None: no update (not requested) - Done: update succeeded - Failed: update failed - Pending: update in progress - Dhcp: update done by the DHCP server (the terminal had been informed to forgive the update) Note: to refresh this information, select the [REFRESH] button. 9.3.3 - TCP Server and TCP Client Statistics The TCP server statistics contain information about connections where the AX3000 is acting as a server (lpd, rtty and rcmd).
Tools and Statistics Description of the information given within this box: - Who: AX3000 resource involved in the connection: S1 (session 1), ..., S8 (session 8), Aux1, Aux2, PARA (parallel), Usb1, ..., Usb4, Net1 and Net2. - Type: network service being used (telnet, tty, etc). - State: the possible values are: - Established: the session is connected, - Closed: the session has ended, - Syn sent: connection request in progress, - Time Wait: connection close in progress.
Remote Administration CHAPTER 10 --REMOTE ADMINISTRATION AX3000 - User's Manual 209
Remote Administration This chapter covers remote administration of the TCP/IP AX3000. Three types of operations are provided by the remote administration: - The remote control, - The interactive telnet setup, - The batch set-up (getting and sending a set-up file) ☺: A Windows administration utility (AxRM or Axel Remote Management) is available free on the Axel Web site. These three operations are covered by this utility. See Chapter 8.8.2. 10.
Remote Administration 10.1.1 - Configuring To set-up the remote control function, select the menu [Configuration][Advanced]-[Tuning]. Within the displayed dialog box select 'Remote Control' and press . The following dialog box is displayed: The parameters are: - User's Authorization Required: when this parameter is set the remote control must be allowed by the current user of the terminal.
Remote Administration - Screen size: 80x25 - Scrolling mode disabled Notes: - To disable the telnet set-up, set the TCP port to 0. - When the telnet set-up is running, the set-up is also displayed on the target terminal. The keyboard of the target terminal is locked. - The AX3000 server telnet supports the keepalive mechanism (value 3 minutes). In event of network incident, the set-up will be automatically ended and the keyboard of the target terminal will be unlocked.
Remote Administration AX3000 must already have been set 10.3.1 - AX3000 Remote Set-Up To set-up an AX3000 remotely, use the 'setup_send' command. Example for Unix/Linux: # rsh axname setup_send password < conf_file Notes: - The next chapter explains how to create the configuration file conf_file, either using a text editor or using the 'setup_get' command on an existing terminal. Appendix A.5 contains a detailed description of the configuration file.
Remote Administration 'setup_get' command (or 'setup_get_lite' command). This command sends a list of all AX3000 parameters to standard output. Example for Unix/Linux: # rsh axname setup_get > /tmp/file The message 'Load set-up in progress...' is displayed on the operator’s console when the rsh command is processing. If a connection problem occurs a time-out error message is displayed. When the set-up parameters have been loaded, the message 'OK, set-up sent' is displayed on the operator’s console.
Remote Administration ERR 103: trailer label not found. Default factory set-up reloaded Command: Cause: setup_send the trailer label (END_AX_SETUP) is not found. (Either this label is not included in the configuration file or the connection failed). Consequence: the default factory set-up is reloaded (to replace the inconsistent configuration caused by the missing trailer label). Solution: add this label to the end of file and run the command again.
Remote Administration ERR 113: password required Command: Cause: setup_send, ax_reboot and ax_download the AX3000 Interactive Set-Up is password-protected. This password hasn't be specified within the command. Consequence: no effect. Solution: use the right password. ERR 114: invalid password Command: Cause: setup_send, ax_reboot and ax_download the AX3000 Interactive Set-Up is password-protected. This right password hasn't be specified within the command. Consequence: no effect.
Remote Administration ERR 203: xxx: no place to store udk value. Command: Cause: setup_send not enough memory to store the udk_xxx parameter (udk stands for User-Defined Key; a function key for example). Consequence: the default value of this udk parameter is restored. ERR 204: line(s) after the trailer label ignored. Command: setup_send Cause: END_AX_SETUP is not the last line of the file. Consequence: the lines after the trailer label are ignored. The AX3000 setup is updated.
Remote Administration Solution: check the number of sessions and pages. ERR 214: Associate host not found. Association reset. Command: setup_send Cause: a session is associated with a non existing host. Consequence: to get a consistent configuration, this session is not associated with a host. Solution: check the host configuration. ERR 215: s%_udk_xxx and following: no place to store udk value. Command: setup_send Cause: not enough memory to store a group of programmable keys.
Appendix APPENDIX AX3000 - User's Manual 219
Appendix The following appendices give information about: A.1 - Using the AX3000 interactive set-up A.2 - Network overview (Ethernet address, IP address and routers) A.3 - DHCP protocol A.4 - DNS protocol A.5 - Remote set-up configuration file format A.7 - Setting the IP address by a ping command A.8 - Administration command list A.9 - Firmware downloading A.10 - Going further... A.11 - Hardware and firmware information A.1 - USING THE INTERACTIVE SET-UP A.1.
Appendix Note: the set-up can be password-protected, in which case the password must be entered to access the quick set-up dialog box. For more information, see Chapter 3.7.1. A.1.2 - Navigation The AX3000 set-up comprises a horizontal general menu, with drop down vertical menus. The mouse cannot be used within the telnet session. A help line is located in the bottom of the screen. The AX3000 set-up screen appears as follows: a) The Horizontal General Menu Move through the menu with horizontal arrow keys.
Appendix b) Vertical Menus Move through vertical menus with vertical arrow keys. Confirm the selected command by pressing . Note: the symbol '>', beside a vertical menu item, indicates that it is a submenu. Expand the sub-menu with the key, then move through it with vertical arrow keys. c) Dialog Boxes Move through dialog boxes with vertical arrow keys. Two types of fields are distinguished in a dialog box: - Button: press to perform the associated action.
Appendix During this mode the following keys are enabled: - : confirmation - : abandon your changes - move the cursor within the character string - and : move the cursor directly to the beginning or the end of the string - : delete the character at the cursor position - : delete the character before the cursor position - : one of two editing modes: - Insertion (default): the cursor takes the form of a blinking line or - Overwrite: the cursor
Appendix A.2 - NETWORK OVERVIEW A.2.1 - Ethernet Addresses AX3000 terminals (like other devices equipped for Ethernet networking) have a unique hardware address which is issued by the manufacturer and cannot be modified. This address is in the form of six hexadecimal bytes, separated by colons: AX3000 Ethernet address format: 00:A0:34:xx:xx:xx Select the '?' command in the horizontal menu of the AX3000 set-up to see the AX3000 Ethernet address. A.2.
Appendix For example: an AX3000 connected, over a network, to a host with an IP address 192.1.168.40 (class C: three bytes for the Network address) must have the three first bytes of its address set to 192.1.168. The fourth byte cannot be equal to 40. A.2.3 - Router Depending on the network topology, the AX3000 and the host may be installed on different physical networks and linked through one or several routers.
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 AX3000 192.168.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 AX3000 192.168.1.10 The AX3000 route table is: A.3 - THE DHCP PROTOCOL DHCP (Dynamic Host Configuration Protocol) is an industry standard protocol that lets a DHCP server (Unix, Windows, AS/400, etc.
Appendix addresses and other network parameters to terminals and PCs when they are powered on. This can greatly simplify managing large networks. A.3.1 - Overview Here is a brief description of Axel’s implementation DHCP: - At boot time the AX3000 broadcasts DHCP requests to find the DHCP server. - If a DHCP server is found and correctly set-up, an IP address, and subsequently other parameters are given to the AX3000.
Appendix A.3.3 - Using the AX3000 If the DHCP protocol is enabled the AX3000 automatically requests an IP address on boot and the following dialog box is displayed: DHCP: searching, please wait Note: the search can be aborted by entering the set-up. If a DHCP (or BOOTP) server is available an IP address is given after a few seconds.
Appendix b) Re-negotiation Failure The lease time must be regularly re-negotiated (except if the IP address has been offered by a BOOTP server).
Appendix A.4.1 - Overview A domain (computer network) can be considered as a tree, with branches (nodes) such as hubs, switches, routers, print servers etc, and leafs, for example PCs, terminals and printers. The domain system makes no distinction between the use of interior nodes and the leafs, and this documentation uses the term "nodes" to refer to both. (I.e. any network resource).
Appendix A.4.2 - Resolving a Name a) Resolution Strategy To resolve a name, a DNS request is sent by the AX3000. A DNS request contains the destination DNS server IP address and the name to be resolved. To resolve a name possibly more than one DNS request is needed (if one or more default DNS domains are defined).
Appendix - linux: an IP address is associated. No DNS resolution. - www.axel.com: this is a full name. The resolution is first made with the name itself (www.axel.com). Then, in event of failure, the resolution is made with the first DNS domain (www.axel.com.servers.axel.com). Then, in event of failure, with the second DNS domain (www.axel.com.terminals.axel.com). b) Resolution Method To resolve a name, the AX3000 sends DNS requests to the DNS server(s).
Appendix Two DNS Servers: 1 - A DNS request is sent to the server 1. 2 - In event of no response from server 1, this request is sent to the server 2. 3 - In event of no response from server 2, go back to step 1 (4 times max.). 4 - In event of negative answer from any server, the resolution is aborted. 5 - If other requests can be sent (using default DNS domains are defined), go back to step 1. Example: looking at the screen shots of the Chapter 3.
Appendix In the event of a problem, the "Resolved: a.b.c.d" message is replaced by an error message. For example: Connecting to as400.servers.axel.com:23 (Telnet)... Session number 1 Resolving... Srv: domain not found Press to close this session Error messages: error messages reported by the DNS server begins with Srv. Error messages from the terminal begin with "Loc". The main messages are: - Srv: domain not found: the name doesn't exist within this domain.
Appendix the type ("direct" or "direct / reverse") and the result (success or failure) of the DNS update is not returned to the terminal. b) By the terminal For the terminal to register itself, set "DNS Server Update" to "by the terminal" (in [Configuration]-[TCP/IP]-[DNS]) Note: the DNS server will be updated only if the terminal name is a full name: ended by a DNS domain (i.e. FQDN). By default the terminal updates "direct" and "reverse" DNS server entries.
Appendix A.5 - REMOTE SET-UP CONFIGURATION FILE FORMAT A configuration file can list some or all AX3000 set-up parameters. The configuration file begins with the header label (BEGIN_AX_SETUP) and ends with the trailer label (END_AX_SETUP). Example: BEGIN_AX_SETUP V1.1 # this is a comment tcp_host1_name=vangogh ... END_AX_SETUP Note: lines beginning with '#' are treated as comments and ignored.
Appendix 8-colour format: 16-colour format: Resolution: the 8 available colours are black, red, green, brown, blue, magenta, cyan and white. the 8 additional available colours are grey, lt-magenta, lt-green, hi-white, lt-blue, lt-red, lt-cyan and yellow. the available resolutions are 800x600-60Hz, 800x600-72Hz, 800x600-75Hz, 800x600-85Hz, 1024x768-60hz, 1024x768-70hz, 1024x768-75hz, 1024x768-85hz, 1280x1024-60hz, 1280x102475hz, 1440x900-60hz and 1440x900-75hz.
Appendix Substitution Commands axname_encoding_string= (yes | no) Enabling "axname_encoding_string" allows some set-up parameters to contain 'substitution commands'. This allows variables such as the terminal name and the session number. The substitution is done when a set-up file is sent to the terminal. ☺: this function is useful when multiple terminals are configured with the same set-up file, but each terminal requires certain unique parameters.
Appendix Ethernet Parameters ethernet_link= (Auto-sense | 10BT HD | 10BT FD | 100BT HD | 100BT FD) ethernet_network_discover=no (yes | no) ethernet_dhcp_used=no (yes | no) ethernet_dhcp_netmask= (yes | no) ethernet_dhcp_defrouter= (yes | no) ethernet_dhcp_DNSserver= (yes | no) ethernet_dhcp_srchdomain= (yes | no) ethernet_dhcp_leasetime= (number) ethernet_dhcp_clientid= (character string, 10 char max.) ethernet_dhcp_tracemode= (yes | no) ethernet_dhcp_checkipaddr= (yes | no) #ethernet_ipaddr=192.168.1.
Appendix tcp_remoteCtrl_password= tcp_remoteCtrl_see=no (character string, 5 char max.) (no | colors | overscan | statline) Note: if a configuration file is obtained from an AX3000, undefined hosts and routers are commented out. Router explanation: - The "tcp_router%_ip" parameter is the router IP address, the "tcp_router%_target" parameter is the target host (or network) IP address and the "tcp_router%_mask" parameter is an optional network mask used to reach the target network.
Appendix aux%_associate_msgqlib=*LIBL aux%_associate_font=11 aux%_associate_mfrtypmdl=*NONE aux%_associate_pprsrc1= aux%_associate_pprsrc2=*NONE aux%_associate_envelope=*NONE aux%_associate_ascii899=no aux%_associate_wscstname= aux%_associate_wscstlib= aux%_associate_transp= aux%_associate_transp-seq= aux%_associate_prn= aux%_associate_prnname= aux%_associate_prndriver= aux%_associate_prntimer=15 aux%_associate_com=yes aux%_associate_comname= aux%_associate_comdsr= aux%_tcp_window=1024 aux%_tcp_mss=512 aux
Appendix aux%_dtr_init aux%_rts_init aux%_tx_fifo=yes aux%_seq= (high | low) (high | low) (yes | no) (character string, 19 char max.) b) Parallel Port parallel_service=none (none | rtty | printd | lpd | rcmd Prt5250 | Prt3270 | tty) parallel_service_name=parallel (character string, 8 char max.) parallel_associate_host=vangogh (character string, 64 char max.) parallel_associate_term=ansi (character string, 8 char max.
Appendix parallel_operating_mode= parallel_sup_signals= (optimised |standard) (none | select | paper | both) c) USB Logical Ports In the following section of the file, for ease of reading the USB logical port number (1 to 4) has been represented by the '%' character. In a real configuration file, the parameters for each port would, of course, be listed.
Appendix usb%_associate_pprsrc2= usb%_associate_envelope= usb%_associate_ascii899=no usb%_associate_wscstname= usb%_associate_wscstlib= usb%_associate_transp= usb%_associate_transp-seq= usb%_tcp_window=1024 usb%_tcp_mss=512 usb%_tcp_ttl=64 usb%_tcp_setport=random usb%_tcp_nagle=disable usb%_tcp_keepalive=no usb%_tcp_keepaliveval=120 (character string, (character string, (yes | no) (character string, (character string, (yes | yes-hexa) (character string, (number) (number) (number) (ramdom | fixed) (disable
Appendix net%_associate_font=11 net%_associate_mfrtypmdl= net%_associate_pprsrc1= net%_associate_pprsrc2= net%_associate_envelope= net%_associate_ascii899=no net%_associate_wscstname= net%_associate_wscstlib= net%_associate_transp= net%_associate_transp-seq= net%_tcp_window=1024 net%_tcp_mss=512 net%_tcp_ttl=64 net%_tcp_setport=random net%_tcp_nagle=disable net%_tcp_keepalive=no net%_tcp_keepaliveval=120 246 (character string, (character string, (character string, (character string, (character string, (y
Appendix e) Service Table Note: Depending on the associated service, some parameters can be inactive.
Appendix #term_operating_mode=tcp/ip term_language=french term_screen=CRT-standard term_screensaver=yes term_screensaver_energystar=no term_screensaver_delay=2 term_screensaver_enpassword= term_screensaver_password= term_keyboard=french term_numlock=on term_capslock=on term_beep=long term_keydelay=mediun term_keyspeed=low term_defaultport=aux1 term_preprint_string= term_postprint_string= term_touchscr_type=ELO term_touchscr_port=usb1 term_touchscr_xlow=0 term_touchscr_xhigh=0 term_touchscr_ylow=0 term_tou
Appendix term_autoconf_port= term_gmt=+00:00 term_gmt_name=Greenwich term_daylight=yes term_summer_day=last term_summer_dayofweek=sunday term_summer_month=march term_summer_hour=2 term_winter_day=last term_winter_dayofweek=sunday term_winter_month=october term_winter_hour=3 term_win_kbcode=409 term_comment_string= term_usbdriveredir= term_driveletter= term_ScardReader%_Id= term_ScardReader%_vendor= term_ScardReader%_ifd= term_ScardReader%_force= (number) (GMT format +-hh:mm) (character string, 32 char max
Appendix Session Parameters In the following section of the file, for ease of reading the session number (1 to 6) has been represented by the '%' character. In a real configuration file, the parameters for each session would, of course, be listed.
Appendix s%_tcp_window=1024 s%_tcp_mss=512 s%_tcp_ttl=64 s%_tcp_setport=random s%_tcp_nagle=disable s%_tcp_keepalive=no s%_tcp_keepaliveval=120 s%_telnet_break= s%_telnet_naws=yes s%_initstring= s%_answerback= s%_screen_overscan=09 s%_screen_codepage=437 s%_screen_column=80 s%_screen_line=25 s%_screen_scroll=yes s%_screen_wrap=yes s%_screen_crlf=yes s%_screen_cursor=block s%_screen_enhanced=no s%_screen_attbmode= s%_ignore_blank=no s%_kbd_code=scancode s%_kbd_capsmode=caps-lock s%_kbd_localcompose=no s%_k
Appendix s%_fctn_transp= s%_fctn_transp-seq= s%_fctn_typeahead=yes s%_mouse_enable=yes s%_remote_cad=yes s%_ScrlLockPause=enabled s%_vnc_enpassword= s%_vnc_password= s%_vnc_geometry= s%_vnc_depth= s%_vnc_prefencod= s%_vnc_cachehextile= s%_vnc_doublescreen= s%_vnc_shared=no s%_vnc_noinput=no s%_vnc_localmouse=yes s%_vnc_emulbutton=yes s%_vnc_msesensitivity=medium s%_vnc_mouseaccel=yes s%_vnc_numpad=standard s%_vnc_AltGr= s%_rdp_username= s%_rdp_autologon=no #s%_rdp_enpassword= #s%_rdp_password= s%_rdp_domai
Appendix s%_rdp_bckg= s%_rdp_wincontent= s%_rdp_animation= s%_rdp_theme= s%_dsk_nbsession= s%_dsklabel_applic= s%_dsklabel_close= s%_ica_target= s%_ica_icasrv= s%_ica_published= s%_ica_protobr= s%_ica_portbr= s%_ica_masterbr= s%_ica_brtrace=no s%_ica_braltip=no s%_ica_username= s%_ica_autologon=no #s%_ica_enpassword= #s%_ica_password= s%_ica_domain= s%_ica_autorun=no s%_ica_progname= s%_ica_pathname= s%_ica_geometry= s%_ica_depth=16bpp s%_ica_encryption= s%_ica_connectionname= s%_ica_mouseaccel=no s%_ica_c
Appendix s%_graphics_foregrnd=hi-white s%_graphics_backgrnd=magenta #s%_enhanced_foregrndxxx=white #s%_enhanced_backgrndxxx=blue #s%_enhanced_blinkxxx=no #s%_enhanced_underlxxx=no s%_palette%= s%_black= s%_grey= s%_white= s%_tab= X X X s%_udk_f%= s%_udk_ins= s%_udk_end= s%_udk_dn= s%_udk_pgdn= s%_udk_left= s%_udk_five= s%_udk_right= s%_udk_home= s%_udk_up= s%_udk_pgup= s%_udk_minus= s%_udk_plus= s%_udk_del= s%_udk_esc= s%_udk_dot= s%_udk_backspace= s%_idk_backspace=Standard s%_seq_modifier%= s%_seq_scan%=
Appendix - When the configuration file is obtained from an already configured AX3000, non significant parameters are commented out. End of File The configuration file must be ended with the following trailer label: END_AX_SETUP If this trailer label is missing, from the configuration file used to set-up an AX3000, the fatal error message ERR 103 will be issued in response to the rsh command and the default factory set-up will be reloaded. A.
Appendix conflicting number in this range can be used. For more information on the Axel options see chapter A.6.3. A.6.2 - Adding an Axel option with the Microsoft DHCP Server To add an Axel DHCP option with Microsoft’s DHCP server see below: 1 - Launch the DHCP utility.
Appendix Click ‘OK’ to exit this box and 'OK' again to exit the former box. 3 - In the left panel select 'Server Options’ then right click ‘Configure Options’ Within the available options ‘tick’ the new Axel entry and enter IP and TCP port details as below as ‘string value’. For example: Note: the changes take immediately effect. A.6.3 - 'axrmserv' option: auto-configuration The axrmserv option always the network location of the AxRM server to be broadcast.
Appendix The parameters are: - The IP address or DNS name of the AxRM server - The TCP port AxRM is listening on Having two parameters is not mandatory nor is the order important. For example you may only need to enter the IP address if the default port 80 is being used. The table below gives examples: AxRM Network Location IP address TCP port "mypc" DNS resolution 82 axrmserv:mypc:82 The IP address will be given by 82 axrmserv:82 the method 2 or 3 (see chapter 2.1). 80 axrmserv:192.168.0.1 192.168.0.1 A.
Appendix table): # arp -s a.b.c.d xx:xx:xx:xx:xx:xx Run a ping command: $ ping a.b.c.d The first ping requests are not acknowledged. But after few seconds the AX3000 is rebooted and replies the ping requests. The AX3000 is now set with the a.b.c.d IP address. Using under Windows: ☺: Windows administration s/w (AxRM or Axel Remote Management) is available free on the Axel Web site. See Chapter 8.8.2.
Appendix The following table lists the available AX3000 administration commands: Command ax_reboot ax_sinit setup_get setup_send ax_download ax_version ax_getstat Description Rebooting the AX3000. Example: rsh ax3000 ax_reboot [password] More information: chapter 10.3 Resetting an AX3000 resource (screen session or aux. port) Example: rsh ax3000 ax_sinit [password] sess1 Requesting the AX3000 Set-Up. Example: rsh ax3000 setup_get > file More information: chapter 10.
Appendix 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 a bootp server. Whichever method is used, the firmware file is downloaded from a host (called the tftp host). Following this the AX3000 is automatically reset and the new firmware is enabled.
Appendix tftp dgram udp nowait nobody /usr/sbin/tftpd tftpd -n UNIXWARE 7 tftp dgram udp wait nobody /usr/sbin/in.tftpd in.tftpd b) Linux First, check the tftp package is already installed. The tftp protocol works through the xinetd daemon. Check if xinetd is running. If not, enable xinetd. A file ‘tftp’ should be present in /etc/xinetd.d. This file contains the tftp server settings.
Appendix 4 - Change the file "/axfirm/ax3000" QTFTP user's rights: ===> CHGAUT OBJ('/axfirm/ax3000') USER(QTFTP) DTAAUT(*RX) OBJAUT(*NONE) 5 - User's right can be checked by invoking: ===> WRKLNK OBJ('/axfirm') ===> WRKLNK OBJ('/axfirm/ax3000') 6 - Change the default TFTP directory: ===> CHGTFTPA ALTSRCDIR('/axfirm') 7 - Stop and restart the TFTP server ===> ENDTCPSVR(*TFTP) ===> STRTCPSVR(*TFTP) Then download the firmware from the AX3000 interactive set-up (see next chapter).
Appendix Example for Unix/Linux: # rsh ax3001 ax_download password /usr/firm 192.168.1.249 The message 'Download in progress...' is displayed on the operator’s console if the download runs correctly. Possible errors (displayed on the operator’s console): - ERR 105: invalid rcmd command: incorrect keyword (check the syntax and spelling). - ERR 108: invalid number of parameters: bad parameter number (2 or 3 parameters are required after the keyword).
Appendix Enter the following parameters: - Protocol: select tftp, - Filename: path and name of the firmware file, back-slashes for this character string must be doubled. For example: C:\\AXEL\\FIRM. - AX3000 IP: this is an IP address only used during the downloading operation. It can differ from the current IP address, - tftp Host IP: name or IP address of the tftp host, - tftp Router IP (optional): name or IP address of a router via which the tftp host can be reached.
Appendix The main capabilities of the bootpd configuration file are as follows: - tc: network description - ht: network type - sa: IP address of tftp host - gw: optional router - ha: Ethernet address of the AX3000 - ip: IP address of the AX3000 (this address is only used during the downloading operation) - bf: full firmware file name (path included) Examples of bootp configuration files: a) When the AX3000 and the tftp host are on the same network net:hn:df=/etc/btdump:ht=ethernet:sa=192.168.1.
Appendix The message 'Download in progress...' will be displayed on the operator’s console if downloading can be performed (AX3000 and tftp host reachable, firmware file found, etc). Note: error messages can also be displayed (connection timed-out for example). For explanations refer to UNIX manuals. For more information about the download process, see Chapter A.9.4 b) Downloading Through Set-Up Enter AX3000 Set-Up () and select the [Download] menu. Set the Protocol parameter to bootp.
Appendix Next, an automatic connection to the tftp host will then be made, in order to download the firmware file. b) The tftp Stage AX TFTP V1.1a Flash Key 3 If the download can be performed, the current firmware is erased and the following message is displayed on the AX3000 monitor: Erasing code... Then, the selected firmware file is downloaded (each dot represents 512 bytes): Loading code ......................................................................... ........................................
Appendix a) The bootp Stage If an error occurs, the following message is displayed on the AX3000 monitor: Bootp errno: xxx - xxx is the error number. Possible errors: 0: Ethernet board not responding. 1: no response to the bootp broadcast request (the bootp host is unreachable or not correctly set-up). b) The tftp Stage A tftp error message can originate from either the tftp host or the AX3000. Depending on the error, the AX3000 firmware may be erased.
Appendix Tftp AX3000 Errors: tftp errno: xxx - xxx is the error number. Possible errors: 10: Ethernet board not responding. 11: no response to the tftp broadcast request (the tftp host is unreachable or not correctly set-up). 12: network error. 13: the firmware file does not correspond to AX3000 firmware or is not compatible with the AX3000 model. 14: the firmware file size is less than 256 bytes. This indicates that the file is not an AX3000 firmware file. 15: checksum error on the firmware file.
Appendix A.10.2 - General Level: Advanced Parameters This chapter describes special AX3000 operating parameters. Usually the default values are suitable. All these general parameters are located in a specific dialog box in menu [Configuration]-[Advanced]-[Tuning]: a) The 'TCP/IP Interface Enabled' Parameter This parameter allows or disables the AX3000 network interface. For example the network interface is not needed when the terminal is used in serial mode. Note: a new value takes immediately effect.
Appendix c) The 'Link' Parameter The AX3000 10/100 network port is set by default as auto-sense. But it can also be set as 10Mb or 100Mb. The possible values are: - Auto-sense, - 10BT HalfDuplex, - 10BT FullDuplex, - 100BT HalfDuplex, - 100BT FullDuplex. Note: this operating mode modification takes immediately effect. d) The 'Telnet Set-up TCP Port' Parameter The AX3000 interactive set-up can be accessed via a telnet connection. The associated TCP port default value is 4096. This value can be modified.
Appendix g) The 'Administrator Hot-Keys disabled' Parameter This parameter allows certain AX3000 hot-keys to be disabled, possibly useful if the terminal is installed in public places. For example, this prevents a user from invoking function. For more information, see Chapter 4.7. Note: when this parameter is set to 'yes', the "consultation mode" and the "super password" don't allow the set-up to be entered.
Appendix disabled. Note: the FIFO modification takes immediately effect. k) The 'Number of Sessions" Parameter This parameter is the maximum number of concurrent connections. Its value is from 1 to 6. l) The 'Number of Pages per Session" Parameter This parameter allows multi-page support. This may be used by legacy text application under Unix/Linux. Important: the 'Number of Sessions' multiplied per the "Number of Pages per Session" must not exceed 6. A.10.
Appendix Notes: - The available parameters depend on both the connection type (screen or auxiliary port) and the associated protocol. - New values are used for the next TCP/IP connection (no need to powercycle the AX3000). a) The 'Secondary Host' Parameter A secondary server allows the user to select on which server the session is connected to. The server is chosen when the session is established. A minimenu is displayed.
Appendix The TCP port assignment can be either random or fixed. The default value depends on the current network service. The random method means the AX3000 TCP ports are different after every reboot. On booting the AX3000 generates a new base value. This value (x) is between 1024 and 3072. For each session a range of 8 TCP ports is given: session 1 = (x...x+7), session 2 = (x+8…x+15)... When a connection is established the next port of the associated range is used.
Appendix In event of network incident, the AX3000 is able to detect this incident and to close the related TCP/IP connections. This mechanism is also useful when DSL connections are used (the AX3000 IP address is reset on time per day). By default the keepalive function is disabled. The keepalive function is set in minutes Note: with ISDN routers (which automatically drop the phone line) this regular data flow will prevent the router from hanging-up.
Appendix Arabic - United Arab Emirates Arabic - Bahrain Arabic - Algeria Arabic - Egypt Arabic - Iraq Arabic - Jordan Arabic - Kuwait Arabic - Lebanon Arabic - Libya Arabic - Morocco Arabic - Oman Arabic - Qatar Arabic - Saudi Arabia Arabic - Syria Arabic - Tunisia Arabic - Yemen Armenian Azeri - Latin Azeri - Cyrillic Basque Belarusian Bulgarian Catalan Chinese - China Chinese - Hong Kong SAR Chinese - Macau SAR Chinese - Singapore Chinese - Taiwan Croatian Czech Danish Dutch - Netherlands Dutch - Belgium
Appendix English - Ireland English - Jamaica English - New Zealand English - Philippines English - South Africa English - Trinidad English - United Kingdom English - United States Estonian Farsi Finnish Faroese French - France French - Belgium French - Canada French - Luxembourg French - Switzerland Gaelic - Ireland Gaelic - Scotland German - Germany German - Austria German - Liechtenstein German - Luxembourg German - Switzerland Greek Hebrew Hindi Hungarian 1809 2009 1409 3409 1C09 2C09 0809 0409 0425 04
Appendix following: 1. Use the AxRM utility - "Get Terminal Information" command, 2. Enter the AX3000 interactive set-up, and select '?', 3. Get the AX3000 set-up by issuing the setup_get remote command (the revision is included in the text file banner): Example: rsh axname setup_get > file 4. Use the following ax_version remote command to get the revision directly: Example: rsh axname ax_version A.11.
Appendix A.11.2 - Firmware Information The firmware version is FCT.NA.yywwi:STD - FCT is the AX3000 operating mode (always TCP) - NA is the firmware nationality (code is ISO compliant).
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.