e DATA TT1000 Badge Reader User Manual configuration

e-DATA GmbH Badge Reader configuration

Contents

configuration user manual

Terminal Configuration Manual TT1000 Series06.2009 Version 1.1 1-1Terminal Configuration ManualTT1000 SeriesVersion 1.1e-DATA GmbH
Terminal Configuration Manual TT1000 Series1-2 06.2009 Version 1.1e-DATA GmbHMollenbachstrasse 19D-71229 LeonbergGermanywww.e-data.comPhone +49 7152 93979-0Fax +49 7152 93979-50Terminal Configuration ManualTT1000 SeriesVersion 1.1Copyright 2009 e-DATA GmbHThis manual is protected. Reproduction or translation of themanual or its transmission on other electronic media, even inextract form, is only allowed with the express written permissionof e-DATA GmbH.e-DATA GmbH reserves the right to make changes to the In-stallation and Maintenance manual without prior notice.e-DATA GmbH does not accept any liability whatever for directand indirect damage, especially loss of data, that result from theusage of the TT1000 Series terminal, the software or the man-ual!
Terminal Configuration Manual TT1000 Series06.2009 Version 1.1 1-3
Terminal Configuration Manual TT1000 Series1-4 06.2009 Version 1.11 Content1Content 1-42Terminal specification 2-62.1 Feature overview .................................................................. 2-63Setting up the TT1000 Series terminal 3-84Keyboard assignment 4-104.1 Key assignment - reduced keyboard (11 keys).................... 4-105Terminal start-up 5-115.1 Using the start-up prompts.................................................. 5-115.2 Changing the start-up prompts............................................ 5-136Parameter description 6-156.1 General parameter description............................................ 6-156.1.1 How to display the web interface......................................... 6-156.1.2 Configuration parameters.................................................... 6-166.1.3 Configuration parameter groups – overview........................ 6-176.2 Detailed parameter description ........................................... 6-176.2.1 System configuration........................................................... 6-186.2.2 Linux parameters ................................................................ 6-266.2.3 Network parameters............................................................ 6-286.2.4 Readers.............................................................................. 6-306.2.5 Peripheral devices .............................................................. 6-336.2.6 Communications parameters .............................................. 6-366.3 Application parameters ....................................................... 6-426.3.1 Application parameter groups - overview ............................ 6-426.3.2 Resend bookings parameters ............................................. 6-436.3.3 Reports parameters ............................................................ 6-44
Terminal Configuration Manual TT1000 Series06.2009 Version 1.1 1-57Fingerprint terminals in practice 7-467.1 Introduction..........................................................................7-467.2 Enrollment process..............................................................7-467.2.1 Calling the main menu .........................................................7-467.2.2 Enroll...................................................................................7-477.2.3 Delete user ..........................................................................7-477.2.4 Delete all..............................................................................7-478Appendix for Developers 8-488.1 Linux commands..................................................................8-488.1.1 Connecting to the terminal...................................................8-488.1.2 Basic Linux commands........................................................8-488.2 Web interface page Database..............................................8-538.3 Web interface page Java Statistics ......................................8-55
Terminal Configuration Manual TT1000 Series2-6 06.2009 Version 1.12 Terminal specification2.1 Feature overview400 / 600 MHz Xscale CPU with Linux OS and JAVA VMMonochrome graphics LCD with 128x64 pixels / 8x20 char-acters, adjustable brightnessCustom keyboard layout with 11 keys3kHz / 94dB Buzzer for acoustic feedback, two volumesLight bar with 6 RGB-LEDs, eight base colors, adjustablebrightnessPower-supply: mains operated 100 to 230 VAC. Optionallyavailable PoE 802.3af or 10 to 26 VDC socketEthernet (TCP/IP) 100 MbpsOptional integrated modemSupport of all leading reader technologies (Legic, HID, Mi-fare, I-Code, EM, Hitag and ISO 15693, Magnetic stripe andBarcode, Fingerprint)Two optical sensors for sabotage detectionPassive Infrared (PIR) motion sensorUSB 1.1 Full speed
Terminal Configuration Manual TT1000 Series06.2009 Version 1.1 2-7FCC NotesThis equipment complies with Part 15 of the FCC rules.Any changes ormodifications not expressly approved by the manufacturercould void the user's authority to operate the equipment.This device complies with Part 15 of the FCC rules subject to thefollowing two conditions:This device may not cause harmful interferenceThis device must accept all interference received, includinginterference that may cause undesired operation.NOTE:This equipment has been tested and found to comply with the limits for a Class A digitaldevice, pursuant to part 15 of the FCC Rules. These limits are designed to providereasonable protection against harmful interference when the equipment is operatedin a commercial environment.This equipment generates, uses, and can radiate radio frequency energy and, if not installedand used in accordance with the instruction manual, may cause harmful interference to radiocommunications. Operation of this equipment in a residential area is likely to cause harmfulinterference in which case the user will be required to correct the interference at his own ex-pense.
Terminal Configuration Manual TT1000 Series3-8 06.2009 Version 1.13 Setting up the TT1000 Series terminalConnecting Connect the terminal to the power supply and (if using Ethernet)to a networking switch. The access from a PC to the terminal isthen possible via HTTP, SSH and FTP (SFTP).Accessing •HTTPAccessing the web server on the terminal via HTTP is nec-essary if the administrator wants to change the configurationdata.•SSHFor remote administration using an SSH client.•FTP/SFTPFor transferring data to an FTP client (also SFTP possible).HTTP Open a browser of your choice and enter the following URL:http://terminal-ip-address:9999Example: http://192.168.50.77:9999The terminal web interface is displayed. Login with the pass-word admin. From here you can change the configuration data.
Terminal Configuration Manual TT1000 Series06.2009 Version 1.1 3-9SSH Start an SSH client and open a session to the terminal’s as-signed IP address. Log in as the user admin with the passwordadmin (default).FTP Start an FTP client, e. g. WS_FTP.In the field Hostname/Address enter the terminal IP address.Log in with the User ID admin and the Password admin andpress OK.The initial directory displayed is /mnt/hda1/admin.
Terminal Configuration Manual TT1000 Series4-10 06.2009 Version 1.14 Keyboard assignment4.1 Key assignment - reduced keyboard (11 keys)The TT1000 series does not provide a numeric keypad, but only11 keys.For reduced keyboards 7 keys are assigned for the terminalstart-up dialogs (for defining the IP address and differentmodes) OK, Cancel, Cursor left, Cursor right, NUM and bothscroll keys. The terminal is being delivered with the followingassignment:
Terminal Configuration Manual TT1000 Series06.2009 Version 1.1 5-115 Terminal start-up5.1 Using the start-up promptsWith the key configuration shown above, the following se-quence applies for the terminal start-up, if you e. g. want tochange the IP address of the terminal manually (i. e. without aDHCP server):The terminal beeps five times and prompts for the PIN code.Press four times the key assigned as the NUM key (the defaultPIN), usually .Then press the key assigned as OK key, usually .For the following prompts „Define keyboard“, „Activate Ser-vicemode“, „Activate Test“ und „Interface“ always press theOK key to keep the settings.To change a setting, it is possible to toggle between the choicesusing one of the scroll keys or and to con-firm a choice with the OK key.You can then change the logical terminal IDThe current ID is displayed, by default 01FF.Using the cursor right key you can position the cursorat the digit to be changed.To change the value press the NUM key , thuschanging the digit to 0 (Null). Then press the NUM key as oftenas necessary to change the digit to the desired value. Note thatthe cursor might be moved to the right when the timeout occurs.
Terminal Configuration Manual TT1000 Series5-12 06.2009 Version 1.1With the cursor left keyyou can move the cursor to theleft at any time.Confirm the value with the OK key.After that the prompt „Interface“ is displayed where you wouldpress the OK key to confirm the value „eth0“.If for the prompt „Use DHCP“ the setting „YES “is active, theterminal requests its IP address, router address and gatewaythrough a DHCP server.If you want to change the IP address manually, the value for„Use DHCP” should be set to „NO“.Then you can change the terminal IP address:The current IP address is shown.Using the cursor right key you can position the cursorat the digit to be changed.To change the value press the NUM key , thuschanging the digit to 0 (Null). Then press the NUM key as oftenas necessary to change the digit to the desired value. Note thatthe cursor might be moved to the right when the timeout occurs.With the cursor left keyyou can move the cursor to theleft at any time.Define the IP address and confirm the value with the OK key.Define the gateway and subnet mask the same way. To finallystore the values you have to confirm the following prompt withall three values with the OK key.If you terminate the IP configuration dialog with the Cancel key any value you changed will not be saved.
Terminal Configuration Manual TT1000 Series06.2009 Version 1.1 5-135.2 Changing the start-up promptsYou can configure which prompts will appear in the start-updialog and in which sequence they appear.On the terminal, in the directory /java/vm/vame there is a sys-tem.prop file. The entries starting with “ipconf” are responsiblefor the start-up dialog. For example the entry ip-conf10=serviceMode determines that the prompt “ActivateServicemode” is displayed with the scroll list options “Yes” and“No”. If you put an # sign in front of an entry it is inactivated.With the number following ifpconfig you define the order numberof the entry. The start-up dialog will start with the entry with thelowest number.
Terminal Configuration Manual TT1000 Series5-14 06.2009 Version 1.1Following is a list of possible ipconf terms: ipconfn=keyboard – for the dialog “Define keyboard” ipconfn=serviceMode – for the dialog “Activate servicemode” ipconfn=test – for the dialog “Activate test” ipconfn=deviceId – for the dialog “Logical device ID” ipconfn=networkIF – for the dialog “Interface” with thechoices “eth0” and “wlan” ipconfn=dhcp – for the dialog “Use DHCP” ipconfn=ipAddress – for the dialog “TCP/IP address” ipconfn=gateway – for the dialog “Gateway address” ipconfn=subnetMask – for the dialog “Subnet mask” ipconfn=dns1 – for the dialog “DNS 1” ipconfn=dns2 – for the dialog “DNS 2” ipconfn=proxy – for the dialog “Proxy Server” ipconfn=proxyPort – for the dialog “Proxy Port” ipconfn=hostAddress – for the dialog “Host Address” ipconfn=hostPort – for the dialog “Host Port” ipconfn=rasHW – for the dialog “RAS Hardware” with thechoices “Modem” and “ISDN” ipconfn=rasNumber – for the dialog “RAS Number” ipconfn=rasUser – for the dialog “RAS User” ipconfn=rasPwd – for the dialog “RAS Password” ipconfn=rasDomain – for the dialog “RAS Domain” ipconfn=rasOption – for the dialog “RAS Option” ipconfn=rasTest – for the dialog “Test RAS Connection” ipconfn=timeSync – for the dialog “Time Sync Mode” ipconfn=timeZone – for the Time zone dialogs ipconfn=com.timelink.biometrics.fingerprint.IpSettingsTemplatesErasure – for the dialog “Erase all templates?” ipconfn=com.timelink.connection.webservice.ssl.GetCertificate – for the dialog „Use HTTPS?“ and if yesis chosen starting the certificate request.
Terminal Configuration Manual TT1000 Series06.2009 Version 1.1 6-156 Parameter description6.1 General parameter descriptionAll general framework parameters can be defined through theweb interface supported by the terminal.6.1.1 How to display the web interfaceTo connect to the web interface on an TT1000 Series terminalyou must enter the terminal URL in a standard web browser:Example: http://terminal_ip_address where the “terminal ip ad-dress” is that of your TT1000 Series terminal.Enter the password admin and click on Enter.
Terminal Configuration Manual TT1000 Series6-16 06.2009 Version 1.1The Overview page is opened.With a click on 1000 next to TLT in the upper left corneryou canreturn to the Overview page any time.6.1.2 Configuration parametersTo open the configuration parameter group list, click on Con-figuration in the left frame.
Terminal Configuration Manual TT1000 Series06.2009 Version 1.1 6-176.1.3 Configuration parameter groups – overviewSystem Terminal, Date/Time, Trace, Status, Java Statistics, Firmware.(See chapter 6.2.1)Linux Parameters for the Linux operating system.(See chapter 6.2.2)Network TCP/IP, DHCP/BOOTP and RAS parameters.(See chapter 6.2.3 )Readers Parameters for the available readers, barcode scanner andfingerprint reader(See chapter 6.2.4)Peripheral devices Display, Keyboard(See chapter 6.2.5)Communications Upload, download(See chapter 6.2.5.4)Database (See chapter 8.2)Logoff No matter what parameter page is opened in the right frameyou can always log off by clicking on Logoff in the left frame.6.2 Detailed parameter descriptionTo display the individual parameter group pages click on thetext link in the menu bar in the upper part of the right frame.On all the parameter pages you will find the buttons Save andHelp.Save This button will store your changes on the terminal.Help This button will display basic help text displayed in the right col-umn. The button text changes to Help off when selected.
Terminal Configuration Manual TT1000 Series6-18 06.2009 Version 1.16.2.1 System configurationTo open the System configuration pages click on Systemin theConfiguration menu in the left frame.
Terminal Configuration Manual TT1000 Series06.2009 Version 1.1 6-196.2.1.1 Terminal parametersThe terminal parameter page is the default page in the systemparameter group.Local terminal address The terminal address (logical ID) that is sent to the host system.(Default 01FF).Default language The preferred language for the web interface. English and Ger-man are available, default English.Application Class The application to be started on the terminal. There has to be avalue defined for proper terminal operation.Console Mode The definition of the console mode. Choices are COM1, COM4or Unused, default COM1.Terminal version Read-only field for the terminal board version information.Polling settings Sleep time (ms) setting for the internal polling of the Mainboardand Power-supply Board, default 100.Display switch-offIf this mode is active, the display is turned off automatically if for30 seconds no motion has been detected by the motion sensor.If after that a motion is sensed the display is turned on again.Default No.Service mode If this mode is active the terminal is not automatically switchedoff in case of sabotage alarm (case opened). Default No.Test application If this mode is active the test application will be invoked and theoriginal one will be saved. With the help of the test applicationyou can test the communication between the hardware and thesoftware: keys, display, acoustic signal, LEDs, badge reader.Default No.Alarm mode If this mode is active, CBM alarm messages are being sent tothe host system. Also these messages are stored in a protocolfile, if defined in the application.xml file. Default No.
Terminal Configuration Manual TT1000 Series6-20 06.2009 Version 1.1Terminal description Input field for a description for the terminal, e. g. the location.USB Stick Update If this mode is active, updates can be performed via USB stick,e. g. a new application.xml file, orparameter changes through asystemParameters.xml file. Default No.
Terminal Configuration Manual TT1000 Series06.2009 Version 1.1 6-216.2.1.2 Date/TimeTo open the Date/Time parameter page click on Date/Time inthe menu bar in the upper part of the right frame.orTime zone The time zone definition of the terminal. Available choices arethe standard time zones of America and Europe plus severalexplicit towns in America and Europe. (Default CET CentralEuropean Time.)Actual datetime Read-only field of the actual date and time of the terminal in thetime zone defined on the terminal.Set datetime Here you can set the new date and time for the terminal. Followthe syntax shown in the Actual datetime field.Time synchronization Time synchronization mode. Choices are No,Interval,Host.(Default No.) Interval mode uses an NTP Server for the timesynchronization, Host mode uses the data connection server.Time Server Address If Interval mode is used, the TCP/IP address of the NTP server.Request Interval Interval of time requests in minutes, minimum 10 minutes, de-fault 60.
Terminal Configuration Manual TT1000 Series6-22 06.2009 Version 1.16.2.1.3 Trace parametersTo open the Trace parameter page click on Trace in the menubar in the upper part of the right frame.Trace destination Destination for trace messages. Choices are Console or UDP(default Console).IP address for UDP logs If UDP is used, the host TCP/IP address for the UDP logs.Port for UDP logs If UDP is used, the port number for the UDP logs.Trace levels The symbols for the different trace levels used in the list below.Red for Error, yellow for Warning, green for Debug, and bluefor Info.For Application logs, TCP/IP logs, RS232 logs, System logs,Subsystem logs, RXTX logs, RS485 logs, Badge Reader logs,Validation logs, RAS logs, Display logs, I/O logs, Keyboardlogs, Timer logs, Webserver logs, and FileManager logs youcan define the level of logs to be sent to the trace destination.Choices are Error,Warning,Debug, and Info. Default Error,Warning.Logging to a file If this value is set to Yes, trace messages are written into a filenamed terminal.log on the terminal. Default No.The file terminal.log might become quite big depending on thelog levels chosen. A file that requires almost all flash diskspace available might prevent the terminal from running. There-fore there is a limit of 10 MB for this file. If this limit is beingreached the file will be re-written.
Terminal Configuration Manual TT1000 Series06.2009 Version 1.1 6-236.2.1.4 StatusTo display the Status page of the terminal click on Status inthemenu bar in the upper part of the right frameGeneral informationIn the upper part of the page you will find general informationabout the terminal, like Linux version, display, rechargeablebattery, keyboard and reader type.
Terminal Configuration Manual TT1000 Series6-24 06.2009 Version 1.1Condition based MaintenanceThe terminal provides Condition Based Maintenance Services,i. e. different subsystem components are being monitored and ifa state is reached where the intervention of a service technicianis required, this is shown in the Info column.Jar FilesOn the Status page you also find a summary of the softwareinstalled, with all the jar files and their version numbers
Terminal Configuration Manual TT1000 Series06.2009 Version 1.1 6-256.2.1.5 FirmwareThe PIC software (firmware) on the motherboards (main boardand subsystem) may now be updated through the web inter-face.To open the Firmware Update parameter page click on Firm-ware in the menu bar in the upper part of the right frame.The loadable firmware file has to be in the terminal directory/home/admin. The following names are fix:V_bt_us_01.hex for the main board firmwareVbt+us.hex for the subsystem firmwareMain board firmwareupdate If you set this parameter to YES, the terminal checks whether aloadable update file for the main board firmware exists (seenote above) and if this is the case it reboots. During the rebootthe new firmware is installed and activated by a further reboot.Subsystem firmwareupdate If you set this parameter to YES, the terminal checks whether aloadable update file for the subsystem firmware exists (see noteabove) and if this is the case it reboots. During the reboot thenew firmware is installed and activated by a further reboot.Main board firmwareversion Read-only field for the current firmware version of the mainboard.Subsystem firmwareversion Read-only field for the current firmware version of the subsys-tem.Mainboard ID Read-only field for the unique ID of the main board. For bettertracking all boards have a unique ID which is also part of theversion string (terminal parameter page)Subsystem ID Read-only field for the unique ID of the subsystem For bettertracking all boards have a unique ID which is also part of theversion string (terminal parameter page).
Terminal Configuration Manual TT1000 Series6-26 06.2009 Version 1.16.2.2 Linux parametersTo open the Linux configuration pages click on Linux in theConfiguration menu in the left frame.6.2.2.1 SettingsNetwork config By selecting Activate, the network configuration in the operat-ing system is activated. This is required after changing a net-work parameter.Restart/Shutdown By selecting Shutdown linux,Reboot linux or Stop applica-tion, the operating system or the application is restarted orstopped.Application start Value Auto, can not be changed. The application will be auto-matically started at system startup.
Terminal Configuration Manual TT1000 Series06.2009 Version 1.1 6-276.2.2.2 Usersroot password The password of the user 'root' (default: root).Confirm root password Re-enter the new root password.admin password The password of the user ‘admin’ (default admin).Confirm admin pass-wordRe-enter the new admin password.When you are logged in with the admin password, you are onlyauthorized to change the admin password. To be able tochange the root password, you have to log in with the rootpassword.
Terminal Configuration Manual TT1000 Series6-28 06.2009 Version 1.16.2.3 Network parametersTo open the Network configuration page click on Network in theConfiguration menu in the left frame.Hostname The host name for the terminal. (Default is the MAC address.)Domain The domain name for the terminal.TCP/IP address The TCP/IP address of the terminal.TCP/IP subnet mask The TCP/IP subnet mask of the terminal(default is 255.255.255.0).TCP/IP default Gateway The TCP/IP address of the default gateway. With the value setto NO, the default route to eth0 is used.TCP/IP address of thename server The TCP/IP address of the name server, if used.Activate DHCP/BOOTPrequest Allow or disallow the use of a DHCP/BOOTP Server for IP con-figuration. If this parameter is set to Yes, the four parametersabove are disabled.The PIN for startup IPconfiguration The PIN to be entered at terminal startup to change the IP con-figuration for the terminal. The default for this terminal’sreducedkeyboard is four times the NUM key, i. e. 49;49;49;49) Leaveblank to disable the start-up dialog.Activate Network Inter-faceThe network interface to be used, currently RJ45 only.
Terminal Configuration Manual TT1000 Series06.2009 Version 1.1 6-29DHCP parameter forServer IP In the DHCP configuration the DHCP parameter containing thehost IP address which was sent by the DHCP server.RAS mode Activate or deactivate a pppd deamon as a client or in servermode. Default Inactive.If you change the setting of the RAS mode parameter to RASClient, further parameters become visible:RAS Debug Activate or deactivate the pppd daemon debug. Default Active.RAS COM port Sets the port the modem or ISDN device is connected to. De-fault COM4.RAS on demand Activates automatic dial-in (option Yes) or manual usage (optionNo). Default No.RAS idle time Defines the time (in seconds) to disconnect, when data traffic isidle. Default 120.RAS Hardware Defines whether you have an ISDN or a Modem device. DefaultISDN.RAS ISDN MSN Number Define your ISDN MSN Number.RAS Number The number that has to be dialed for the RAS connection.RAS User The authorized user for the RAS connection.RAS Password The password for the RAS User.RAS DomainThe domain name to be used as prefix for the login user name.RAS Option Optional field for the RAS connection.RAS Dialtone If the telephone system does not send a dial tone, set this pa-rameter to Yes to send ATX1 to the modem.(Thus “busy” is nottreated as error, as it would be the case when sending ATX3.)Default No (ATX4 = no carrier, no dialtone,busy lead to an er-ror).
Terminal Configuration Manual TT1000 Series6-30 06.2009 Version 1.16.2.4 ReadersTo open the Reader configuration pages click on Readers inthe Configuration menu in the left frame.6.2.4.1 Badge readerThe Badge reader parameter page is the default page in thereader’s parameter group.
Terminal Configuration Manual TT1000 Series06.2009 Version 1.1 6-31Reader type Type of badge reader installed in the terminal. Choices for thereader type:Offset instance number The offset of the instance number in the instance data string.Length instance number The length of the instance number.Offset badge number The offset of the badge number in the badge data string.Length badge number The length of the badge number.
Terminal Configuration Manual TT1000 Series6-32 06.2009 Version 1.1Number of data bits (HID-Wiegand only) Number of data bits on the badge. Avail-able choices:Offset data bits The index of the first valid data bit, starting with 0.Number of data bits The number of valid data bits.Data conversionmethod The method to convert the data received (format: pack-age.class.method).Offset number (Casi-Rusco only) The value to manipulate the badge numberwill be subtracted from the fetched number.Activate parity check (Casi-Rusco only) Activate the standard Parity Check (LengthParity of 40 Bit). Choices: Yes and No (default Yes).Send raw data (HID and Barcode only) Sends the data received from thereader as raw data. Default No.There are additional parameters for the reader type Legic-Advant-Module, which are self-explanatory after clicking on theHelp button.6.2.4.2 Fingerprint parametersTo open the Fingerprint parameter page click on Fingerprint inthe menu bar in the upper part of the right frame.
Terminal Configuration Manual TT1000 Series06.2009 Version 1.1 6-33Fingerprint API The choice of Fingerprint APIs may vary, depending on the fin-gerprint.jar files on the terminal. If there are no fingerprint.jarfiles on the terminal, only the choice none is available.Delete all Templates (Sagem only) With this parameter you can delete all existingtemplates in the Sagem internal database.Size of Sagem data-base (Sagem only) The current size of the internal database on theSagem module. If this size is changed, all existing templates willbe deleted.Free rows in Sagemdatabase (Sagem only) Shows the number of free datasets in the Sageminternal database.Process async mes-sages If this parameter is set to NO, the dialog messages from theSagem module such as “Press harder”, “Finger up” etc. aresuppressed. The default is Yes.Process matchingscore messages If you need the matching score for the finger as a return valuefor your application, you can set this parameter to Yes. Thedefault is No.6.2.5 Peripheral devicesTo open the configuration pages for peripheral devices click onPeripheral devices in the Configuration menu in the left frame.
Terminal Configuration Manual TT1000 Series6-34 06.2009 Version 1.16.2.5.1 DisplayThe Display parameter page is the default page in the parame-ter group for peripheral devices.Display Contrast With this parameter you can change the display contrast of theterminal’s display.Graphical DisplayDriver If you want to use Unicode characters for your display texts youhave to switch to the graphical display driver. If you change thisparameter to Yes, the terminal first verifies if the required librar-ies are installed. You have to reboot in order to load these li-braries.6.2.5.2 Keyboard parametersTo open the Keyboard parameter page click on Keyboard inthe menu bar in the upper part of the right frame.
Terminal Configuration Manual TT1000 Series06.2009 Version 1.1 6-35
Terminal Configuration Manual TT1000 Series6-36 06.2009 Version 1.1Keyboard type The type of keyboard used on the terminal.For the TT1000 with 11 keys only TLT1 Reduced 11 is a validchoice.OK button … SCROLLDOWN button With the keyboard type Reduced you have to define at least 5keys valid for the start-up procedure: OK, CANCEL, LEFT,NUMBER, and one of the SCROLL keys. Since your keyboardhas more than 5 keys you can also define the RIGHT key andthe second SCROLL key.NUM button By default this button is used as the reduced keyboard PIN but-ton for entering the start-up dialog. Instead of pressing the nu-meric buttons 1234 on a full keyboard you have to press 4 timesthe NUM button defined here.Set default keysIf set to YES, the keys defined on this page are set, in particularthe NUM button is set as PIN code (compare with Network pa-rameter page).6.2.5.3 PrinterTo open the Printer parameter page click on Printer in the menubar in the upper part of the right frame.You may connect a printer to the COM1 port of the terminal.The choice of Printer types may vary. If there is no printer.jar fileon the terminal, only the choice none is available.6.2.5.4 SoundTo open the Sound parameter page click on Soundin the menubar in the upper part of the right frame.Sound mode If you want to deactivate all acoustic signals, set the soundmode to NO (default YES).6.2.6 Communications parameters
Terminal Configuration Manual TT1000 Series06.2009 Version 1.1 6-37To open the Communications configuration pages click onCommunications in the Configuration menu in the left frame.With the Communications parameters you configure your hostconnection.6.2.6.1 UploadThe Upload parameter page is the default page in Communica-tions parameter group. It describes the communication from theterminal to the host.
Terminal Configuration Manual TT1000 Series6-38 06.2009 Version 1.1Connection type The protocol to be used for sending messages to the host.Choices are FTP,TCP-Client,TCP-Server, TN3270 and WebService. (A TCP-Server is waiting for a connection request anda TCP-Client is trying to open the connection.) Default TCP-Client.TCP/IP address The TCP/IP address used for the host data connection.TCP/IP port The TCP/IP port used for the host data connection, default1089.Server alive check The interval in seconds between the server alive check, default180.Time-out for host reac-tion [ms] Time-out interval for a confirmation message from the host(ms). Default 10000.Use time intervals forupload? Currently only for the connection type FTP. If this option is setto Yes, the connection to the FTP server will be establishedevery nminutes, where n is the connection interval you specifyin the next field. Default No.Upload connection in-tervalThe time interval in minutes you want the connection to the FTPserver to be established. Choose an interval not less than 10.Use time slots for up-load? By using online time slots you can restrict the permanent hostconnection to the specified periods of time. If you set this pa-rameter to Yes you have to at least define one start-end-pair,during which the connection to the host is to be established.You can define up to 10 time slots. Default No.Interval n Start [HH:MI] The time to go online in the format hh:mi.Interval n End [HH:MI] The time to go offline in the format hh:mi. If lower than the starttime, the next day is assumed.Note that for the connection typeFTP only the start time applies.Message format Defines the format in which the messages are to be sent to thehost. Default XML.After choosing and saving the Connection Type option FTP, thefollowing parameters are added to the page:
Terminal Configuration Manual TT1000 Series06.2009 Version 1.1 6-39FTP host IP address The IP address of the FTP server.FTP user name The name of the authorized user on the FTP server. Defaultadmin.FTP password The password for the FTP user. Default admin.FTP directory The directory on the FTP server to which the file transfer shouldtake place. If this parameter is left empty, the connection will beestablished to the default directory set up for the user.FTP file name The name of the FTP file. Default bookings.dat.Change file nameThe rule for changing the file name on the FTP server. Either nochange or change by adding a timestamp to the file name. De-fault No.FTP send timeout The waiting time in case the previous version of the specifiedfile has not been removed from the server. During this time thefile will be resent. Default 120000 (ms).Use SFTP If you set this parameter to Yes, all transfers are executed withSecure FTP. Default No.In order to activate the FTP connection either the parameterUse time intervals? or Use time slots? has to be set to Yes.When using time slots only the start time is considered, not theend time.
Terminal Configuration Manual TT1000 Series6-40 06.2009 Version 1.1After choosing and saving the Connection Type option WebService, the page content changes to the following:Special web service parameters:Use HTTPS? If this mode is active, a secure communication is used. Theterminal first has to request a certificate from the web serverthough. Default No.Server Address The IP address or the hostname of the server.Server Port The port of the server to connect to. Default 8080 for http.User The authenticated user for the web service.Password The password of the web service user.Web Service Implemen-tation The class name of the web service implementation, defaultcom.timelink.connection.webservice.WSServerConnectionTL.(For USA more often used: …WSServerConnectionTLUS)Servlet name forTransactions The servlet (complete path) for receiving the transactions.Servlet name for DeviceManager The servlet (complete path) for processes other device mes-sages such as the heart beat.Id to use for requests The ID used for server requests. This can be either the logicalID (the field Local terminal address on the terminal parameterpage) or the name (the field Hostname on the network parame-ter page, by default the MAC address).Heartbeat Interval The interval between heart beat messages in minutes, minimum
Terminal Configuration Manual TT1000 Series06.2009 Version 1.1 6-415 minutes, default 10 minutes.Heartbeat ReconnectInterval For the offline case: the interval between reconnection tries inseconds, minimum 10 seconds, default 60 seconds.Startup Connect Inter-val For the offline case at startup: the interval between reconnec-tion tries in seconds, minimum 10 seconds, default 30 seconds.It is recommended to set the parameter Timeout for host reac-tion to 45 seconds (value 45000).Also it is recommended to set the parameter Server alivecheck to 0, because the alive check with Web service is doneby heartbeats.
Terminal Configuration Manual TT1000 Series6-42 06.2009 Version 1.16.3 Application parametersTo open the application parameter group list, click on Applica-tion in the left frame.6.3.1 Application parameter groups - overviewBookings If you want to resend bookings to the host system, that havealready been transferred before.Reports To show certain transaction according to your selection criteria.
Terminal Configuration Manual TT1000 Series06.2009 Version 1.1 6-436.3.2 Resend bookings parametersIf the transactions that are stored in the transaction booking fileon the terminal are to be sent again to the host system, the de-sired period of time and/or the badge number can be specified.According to this value the transactions are extracted from thebookings files and resent to the host.Transfer Punches From The start date/time for the retransmission of bookings. The for-mat is DDMMYYYYHHMISS, e. g. 15052005120000.Transfer Punches Until The end date/time for the retransmission of bookings. The for-mat is DDMMYYYYHHMISS, e. g. 15052005235959.Source file The name of the file, from which the punches should be se-lected and sent again (as defined in the application.xml file, e.g.bookings.dat). Default bookings.dat.Badge Number The badge number for which the bookings should be resent. Ifno badge number is entered, the transactions for all badgenumbers are resent.
Terminal Configuration Manual TT1000 Series6-44 06.2009 Version 1.16.3.3 Reports parametersTo open the Reports parameter page click on Reports in theApplication menu in the left frame.Report type Currently Transactions only.Select filter 1 | 2 The field in the transaction record by which the records will befiltered. The fields depend on the definition in the applica-tion.xml file. By default the fields timestamp (format DDMMY-YYYHHSS), badgeNo (badge number), deviceId (local terminaladdress), function (booking type) are defined.Filter expression 1 | 2 The value for the filter 1 | 2.Timestamp from The start date for the list of transactions (format DDMMYYY-YHHMISS).Timestamp until The end date for the list of transactions (format DDMMYYY-YHHMISS).Name of storage The name of the transaction storage file (as defined in the ap-plication.xml file, e.g. bookings.dat). Default bookings.dat.Status of Transactions The status of the transactions to be selected.After clicking on Save the report will be shown in the bottompart of the page:
Terminal Configuration Manual TT1000 Series06.2009 Version 1.1 6-45In the general part of the report the total amounts of processed,unprocessed and dirty bookings is listed, no matter what statusof transaction has been chosen.In the lower part the transactions meeting the selection criteriaare shown.
Terminal Configuration Manual TT1000 Series7-46 06.2009 Version 1.17 Fingerprint terminals in practice7.1 IntroductionBefore performing transactions with a fingerprint terminal you have to collect (enroll) thetemplates of all users. The templates are stored in the Sagem fingerprint module.If the internal data base of the module is empty and a user presses the key for e.g. Clock In,immediately the message “Invalid ID” is displayed. This is no error but a hint, that so far nouser has been enrolled.7.2 Enrollment processThe exact flow of the enrollment process is defined in the application.xml configuration file. Inany case it is required to read 2 finger prints three times each, of which the best one for eachfinger is stored. Also it is required to specify an ID, under which the templates are stored andwhich is provided as the answer to a successful identify.The dialog for the enrollment process is protected by a PIN code and should only be calledby an administrator. Typically the key with the flag is assigned for calling this dialog.7.2.1 Calling the main menuAfter pressing the key with the flag symbol you are requested to enter the PIN code. It is thesame PIN code as for the startup dialog, by default press 4 times the key with the questionmark. (For information how to change this PIN code, see below.) After entering the correctPIN code and pressing the OK button the main menu is displayed:Please select option:(flag) Enroll admin?Enroll userF1 Delete userF2 Delete ALLFor selecting an option press the key listed in the left column.With the options Enroll admin and Enroll user new user are enrolled (depending on theapplication there may be an admin user with more privileges.). With the option Delete useryou delete the templates for a single user ID, with the option Delete ALL the whole data baseof the Sagem module, i. e. all templates enrolled.
Terminal Configuration Manual TT1000 Series06.2009 Version 1.1 7-477.2.2 EnrollAfter pressing the key for Enroll admin or Enroll user you are requested to enter the ID forthe enrollment. Press the key with the question mark to change the first digit to 0. Then pressthe ? key as often as necessary to change the digit to the desired value. The cursor is auto-matically moved right by a timeout. Furthermore you can control the cursor with the greenand red button. Confirm the ID by pressing the OK button.The fingerprint module is being activated; i. e. shows the red light. The user has to follow thedialog that instructs him to place one finger three times on the reader and afterwards a sec-ond finger three times. In doing so the red light turns off for a short time after each successfulread. In case of a successful enroll a message is displayed. Otherwise an error message isdisplayed and the enrollment step must be repeated.7.2.3 Delete userAfter pressing the key for Delete user the administrator can delete the templates for a cer-tain user, more precisely for a certain ID.After entering the ID (again with the ? key) a confirmation screen is displayed. When confirm-ing this screen with OK the templates for this ID are deleted from the Sagem module.7.2.4 Delete allWith the option Delete all the administrator can delete all templates in the Sagem module.Use this option with care because after that all users have to re-enroll. Therefore the admin-istrator is asked twice to confirm the delete request, before the templates are really deleted.
Terminal Configuration Manual TT1000 Series8-48 06.2009 Version 1.18 Appendix for Developers8.1 Linux commands8.1.1 Connecting to the terminalSSH Start an SSH client (e. g. putty) and log in as the user adminwith the password admin (default).At this prompt you can enter basic Linux commands as de-scribed in the following. Note that different from other standardLinux distributions you can not call any help for the commands.8.1.2 Basic Linux commandsDisplay the networkconfigurationCommand ifconfig. Shows the IP address, the MAC addressand the subnet mask.Output:Command route. Shows routing information. Output:
Terminal Configuration Manual TT1000 Series06.2009 Version 1.1 8-49
Terminal Configuration Manual TT1000 Series8-50 06.2009 Version 1.1Display free disk space Command df. Shows the partitions on the “Filesystem” and theirusage.Output:Display active proc-esses Command ps. Shows all active processes.Output:Relevant for the terminal application are the start process andthe j9 processes.Stop application proc-esses Command killall start start2 j9. Stops all processes with thename start, start2, and j9. After that e. g. the software can beupdated and the terminal can be restarted with the commandreboot.
Terminal Configuration Manual TT1000 Series06.2009 Version 1.1 8-51Display the currentprocess activitiesCommand top.Shows the processes at runtime and the systemload.Output:The command top will continue until you terminate it withCtrl+C.Restart the terminal Command reboot. The running application will be terminatedand then restarted.Halt the Linux system Command halt.With this command the operating system will bestopped. The terminal can then be switched off. In contrast tostopping the application processes (kill) you can not access theterminal (via ftp or ssh) after issuing this command.Delete files and directo-riesCommand rm. Deletes (with the option–rf even recursively) filesand directories.Example for deleting the database with terminal parameters.Enter these commands from the directory /java/apps:rm –rf database*rm –rf http*rm –rf rxtx*
Terminal Configuration Manual TT1000 Series8-52 06.2009 Version 1.1Check the CompactFlash for errorsFirst use the command df to get the partition names. Then log inas user root with the correct password (default root).After stopping the application issue the command badblocksfor the existing partitions.Example: badblocks /dev/hda1 and badblocks /dev/mtdblock2Important: This command does not return any message if nobad blocks are found.Check the memoryusage A simple way to query the memory usage, is to show the con-tent of the file meminfo, entering the commandcat/proc/meminfo
Terminal Configuration Manual TT1000 Series06.2009 Version 1.1 8-538.2 Web interface page DatabaseWith the option Database of the Configuration menu you canopen a window in which SQL command can be passed directlyto the terminal database.The table TERMINAL_PARAM_DEFS contains defaultparameter definitions depending on the terminal type, here theterminal type is TLT3.The table TERMINAL_PARAMS contains the actual values forthe terminal-type-based parameters.Use the percentage sign (%) as a wildcard instead of the aster-isk (*) in your queries.Example Select the default value for the Date/Time parameter TimeSynchronisation.Select the actual value for the Date/Time parameter Time Syn-chronisation.
Terminal Configuration Manual TT1000 Series8-54 06.2009 Version 1.1Note that the default value is NO, whereas the actual value isHOST.
Terminal Configuration Manual TT1000 Series06.2009 Version 1.1 8-558.3 Web interface page Java StatisticsWith the menu option Java statistics in the System menu barin the upper part of the right frame you can open a window inwhich the status of the virtual machine is displayed. All theactive threads as well as the memory values are shown. TheGarbage Collector can be activated manually using the buttonat the bottom.

Navigation menu