WTware terminal configuration file. Terminal features, parameters and their descriptions.

List of parameters:

Server and session parameters



  • Parameter server
    server parameter determines terminal server that terminal connects to. Server address, used protocol and server port can be specified. Specify terminal server IP address or DNS-name if DNS server works in the network: 
    server=192.168.1.1
server=ts1.local
server=ts3.local:4000

    Possible protocol values are: rdp:; vi: for ViTerminal; vnc: for connection to VNC server (terminal color depth should be equal to server color depth); xpu: for connection to XP Unlimited and AADS Load Balancing. Default protocol is rdp. Examples: 
    server=vi:192.168.1.5
server=xpu:tsxpu3.local:5000

    List of servers can be specified. Then terminal will try to connect to each server from the list. If failes terminal connects to the next one. And only when it failes to connect to all listed servers, terminal returns an error. It's the easiest way to increase fault tolerance. Protocol is specified only once. Examples: 
    server=192.168.1.6;192.168.1.7;
server=xpu:tsxpu1.local,tsxpu2.local,192.168.1.11:5000

    User can enter server address manually. Specify: 
    server=--new--

    Next line means: connect to 192.168.1.1 server, and if won't respond (out of order) - ask user to enter address: 
    server=192.168.1.1,--new--



    • Application



  • Parameter application
    By default RDP, XPUnlimited\AADS or VNC terminal server client runs. To run Chromium on terminal without connection to terminal server specify in configuration file: 
    application = chrome
    Chromium requires 1024MB RAM. Video driver should be from (U) package. Here's the manual about local Chromium.
    Also on terminal may be started local VLC mediaplayer: 
    application = vlc
    Here's the manual about local VLC.
    Keyword for creating special menu item to turn off terminal: 
    application = shutdown
    Keyword for creating special menu item to reboot terminal: 
    application = reboot
    Example of menu with two items, one to connect to RDP server, second to turn off terminal:
    connection
server=192.168.1.1
displayName=RDP Connection
connection
application=shutdown
displayName=Turn off the computer


    • Session parameters



  • Parameter user
    By default terminal user should specify login, password and domain (if terminal server is included into domain) in "Windows login" window when terminal connects to terminal server. Set these values in configuration file to simplify user life. There are two possible ways to specify these values:

    1. Definite values. The values you won't set user will have to specify in login window. Parameters user and domain are used: 
      user = vasyapupkin
domain = MYDOMAIN
      Also you can specify password: 
      user = petja:password
    2. Selection from menu.User can select login parameters from menu. Possible values for login parameters: 
      DOMAIN\user[display_name]:password
DOMAIN\user:password
user[display_name]:password
user:password
DOMAIN\user[display_name]
DOMAIN\user
user
      display_name - is the to display in menu. When display_name is not specified user name is displayed in menu. These blocks are separated by semicolons. For example, this line creates menu with 5 items (users vasja and peter from DOMAIN2, basil's password is 'joke', john's password is '1'): 
      user = DOMAIN2asil[Basil Washington]:joke;DOMAIN2\peter;john:1;july;Guest;--new--
      Keyword --new-- tells terminal to leave username empty. You can create as many items as can be placed on the screen. Terminal automatically shows them in columns.
    If server doesn't accept password - check off checkbox "Always prompt for password" in Control Panel - Administrative Tools - Terminal Services Configuration - RDP-Tcp - Logon Settings.
    You may tell terminal to allow connection only to the users, listed in parameter user=. If terminal manually enters another login and correct password, terminal stops session. To turn on this mode specify --only-listed--:
    user = vasya; peter; john; --only-listed--


  • Parameter domain
    If specified domain will be set in login window when terminal connects to terminal server.



  • Parameter shell
    Usually terminal server starts explorer when user connects. So user sees usual Windows desktop. If you need any other program to start instead of desktop, use shell parameter. Thus Citrix Metaframe Seamless Windows mode can be easily emulated. Of course shell parameter won't prevent advanced user from running any other program from "Windows Task manager". Use Windows group policy or special software for such restrictions. Examples of shell usage:
    shell = c:\windows\system32\cmd.exe
    starts command prompt console;
    shell = C:\Program Files\Microsoft Office\Office10\winword.exe "c:\temp\document 1.doc"
    runs Microsoft Word and opens document (it should be one line in configuration file).On Windows 2008 server and windows 7 you may add needed program to RemoteApp Manager (remoteprograms.msc) list.In policies you can allow start of any program: run gpedit.msc, Computer Configuration, Administrative Templates, Windows Components, Remote Desktop Services, Remote Desktop Session Host, Connections, Allow remote start of unlisted programs.

    To run published application (RemoteApp), specify: 
    shell = ||RMySuperRemoteApp


  • Parameter directory
    When using shell parameter you may need to set current working directory. Then use directory parameter. For example, if shell parameter starts command prompt console, then this line opens command prompt and sets current directory to c:\windows\temp instead of user home directory:
    directory = c:\windows\temp




  • Parameter keyboard

    keyboard parameter determines default keyboard language in "Windows login" window and keyboard layout in RDP session. This parameter works only inside RDP session in Windows interface. Keyboard for login and password dialogs in WTware interface, for local Chrome, for VNC client is determined by language parameter. Default value is english layout ("en-us"), also you can set german:

    keyboard = de

    Or any other from listed below:

    af (Afrikaans), sq (Albanian), ar (Arabic), ar-sa (Arabic (Saudi Arabia)), ar-iq (Arabic (Iraq)), ar-eg (Arabic (Egypt)), ar-ly (Arabic (Libya)), ar-dz (Arabic (Algeria)), ar-ma (Arabic (Morocco)), ar-tn (Arabic (Tunisia)), ar-om (Arabic (Oman)), ar-ye (Arabic (Yemen)), ar-sy (Arabic (Syria)), ar-jo (Arabic (Jordan)), ar-lb (Arabic (Lebanon)), ar-kw (Arabic (Kuwait)), ar-ae (Arabic (U.A.E.)), ar-bh (Arabic (Bahrain)), ar-qa (Arabic (Qatar)), eu (Basque), bg (Bulgarian), be (Belarusian), ca (Catalan), zh (Chinese), zh-tw (Chinese (Taiwan)), zh-cn (Chinese (China)), zh-hk (Chinese (Hong Kong SAR)), zh-sg (Chinese (Singapore)), hr (Croatian), cs (Czech), da (Danish), nl (Dutch (Netherlands)), nl-be (Dutch (Belgium)), en (English), en-us (English (United States)), en-gb (English (United Kingdom)), en-au (English (Australia)), en-ca (English (Canada)), en-nz (English (New Zealand)), en-ie (English (Ireland)), en-za (English (South Africa)), en-jm (English (Jamaica)), en-bz (English (Belize)), en-tt (English (Trinidad)), et (Estonian), fo (Faeroese), fa (Farsi), fi (Finnish), fr (French (France)), fr-be (French (Belgium)), fr-ca (French (Canada)), fr-ch (French (Switzerland)), fr-lu (French (Luxembourg)), gd (Gaelic), de (German (Germany)), de-ch (German (Switzerland)), de-at (German (Austria)), de-lu (German (Luxembourg)), de-li (German (Liechtenstein)), el (Greek), he (Hebrew), hi (Hindi), hu (Hungarian), is (Icelandic), in (Indonesian), it Italian ((Italy)), it-ch (Italian (Switzerland)), ja (Japanese), ko (Korean), lv (Latvian), lv-qwerty (Latvian QWERTY), lt (Lithuanian), mk (FYRO Macedonian), ms (Malay (Malaysia)), mt (Maltese), no (Norwegian (Bokmal)), no (Norwegian (Nynorsk)), pl (Polish), pt-br (Portuguese (Brazil)), pt (Portuguese (Portugal)), rm (Rhaeto-Romanic), ro (Romanian), ro-mo (Romanian (Moldova)), ru (Russian), ru-mo (Russian (Moldova)), sr-cyrillic (Serbian (Cyrillic)), sr-latin (Serbian (Latin)), sk (Slovak), sl (Slovenian), sb (Sorbian), es (Spanish (Traditional Sort)), es-mx (Spanish (Mexico)), es (Spanish (International Sort)), es-gt (Spanish (Guatemala)), es-cr (Spanish (Costa Rica)), es-pa (Spanish (Panama)), es-do (Spanish (Dominican Republic)), es-ve (Spanish (Venezuela)), es-co (Spanish (Colombia)), es-pe (Spanish (Peru)), es-ar (Spanish (Argentina)), es-ec (Spanish (Ecuador)), es-cl (Spanish (Chile)), es-uy (Spanish (Uruguay)), es-py (Spanish (Paraguay)), es-bo (Spanish (Bolivia)), es-sv (Spanish (El Salvador)), es-hn (Spanish (Honduras)), es-ni (Spanish (Nicaragua)), es-pr (Spanish (Puerto Rico)), sx (Sutu), sv (Swedish), sv-fi (Swedish (Finland)), th (Thai), ts (Tsonga), tn (Tswana), tr (Turkish), tr-f (Turkish F), uk (Ukrainian), ur (Urdu), vi (Vietnamese), xh (Xhosa), ji (Yiddish), zu (Zulu)

    Also US International layboard layout may be specified, it grave in a different way:

    keyboard = en-us-int
    keyboard = pt-br-int

    To turn on Japan IME layout set in configuration file:

    keyboard = ja-ime
    Also if you need to use keyboard, not listed in the layouts list, you may specify keyboard layout code: 
    keyboard = 0xb0060409
    All keyboard layouts codes, installed on your server, are listed in the registry key: 
    HKEY_LOCAL_MACHINE\SYSTEM\ControlSet001\Control\Keyboard Layouts




  • Parameter numlock
    By default NumLock indicator is on when terminal connects to terminal server. To turn off NumLock set in configuration file: 
    numlock = off




  • Parameter graphic
    By default additional graphic options turned off to increase operating speed and lower network load. To turn them on use graphic parameter. Parameter value is a line containing one or more of these symbols: a - Desktop background
    b - Show window contents while dragging
    c - Menu and window animation
    d - Themes
    e - Display cursor shadow
    f - Font smoothing
    g - Desktop composition
    Set parameter value as a sequence of symbols corresponding to the options you want to turn on. For example, to turn on all options specify: 
    graphic = abcdefg
    To show only desktop wallpaper: 
    graphic = a
    Windows 2003 Server shows desktop wallpaper only if you set to "Disabled": Start > Run > gpedit.msc > Computer configuration > Administrative templates > Windows components > Terminal services > Enforce removal of remote desktop wallpaper.




  • Parameter loadbalanceinfo
    To connect to load-balanced RD Session Host server farm or to VDI pool via Remote Desktop Connection Broker use loadbalanceinfo= parameter. In Windows .rdp file, that is used for connecting, is specified: 
    loadbalanceinfo:s:tsv://MS Terminal Services Plugin.1.NameSC
    Instead of NameSC is the name of your Session Collection. In WTware configuration file you should specify:
    loadbalanceinfo = tsv://MS Terminal Services Plugin.1.NameSC


    • Google Chrome parameters



  • Parameter chrome_url
    When Chrome starts show specified URL. Read wtware docs:
    chrome_url=http://wtware.com/doc.html




  • Parameter chrome_mode
    Windows frames are used to show sites that create new windows:
    chrome_mode = window
    Kiosk mode without address line is used for users that don't view other sites:
    chrome_mode = kiosk
    Without mouse pointer:
    chrome_mode = kiosk-nopointer




  • Parameter chrome_language
    Language of embedded Google Chrome interface. Messages and menu items in Chrome will be written in this language: 
    chrome_language = nl
    If user needs to enter text in some language other than english, specify parameter language=



  • Parameter chrome_profile
    All Chromium settings are stored in profile. If you need to add plug-in, save user password or specify another Chromium setting, not added to WTware config, you are to create your own profile and use it instead of deafult profile.
    If terminal boots from local disk, SD card or USB flash, Chromium profile may be stored on local disk. Open terminal web-interface, press "Save custom Chromium profile on disk" and follow the instructions. Here's video-tutorial.
    If terminal downloads configuration from TFTP or HTTP server, Chromium profile may be loaded from the same server. In terminal web-interface press "Download custom Chromium profile" and follow the instructions.



  • Parameter chrome_pac
    Proxy auto-config: 
    chrome_pac=http://192.168.1.1/proxy.pac




  • Parameter chrome_proxy
    Proxy server address:
    chrome_proxy=192.168.1.1:3128
chrome_proxy="https=proxy1:80;http=socks4://baz:1080"




  • Parameter chrome_share
    You may use shared folder from Windows-server to store files, downloaded from Internet, or attach files from nework share to e-mails. You should specify server IP-address, server names are not supported now. To connect Windows directory, shared for full access without password, specify: 
    chrome_share=\\10.1.2.3\sharename
    With username and password: 
    chrome_share=\\10.1.2.3\sharename, user vasja, password 123
    To connect folder read-only, so that user could not store file from Internet: 
    chrome_share=\\10.1.2.3\sharename, ro
    Complicated magic for working with old Windows: 
    chrome_share=\\10.1.2.3\sharename, vers 1.0




  • Parameter chrome_camera
    Load Web-camera drivers: 
    chrome_camera=on


    • VLC parameters



  • Parameter vlc_cmdline
    VLC command line. The easiest way to start video playback from active stream: 
    vlc_cmdline=-I dummy rtsp://10.1.1.32:8556/6
    For more details about VLC usage see manual.



  • Parameter vlc_files
    During boot terminal may download one or several files from VLC directory on TFTP or HTTP server and save them to /vlc_files directory on disk or to terminal RAM. It may be background images, videofiles or vlm configuration script: 
    vlc_files=background.jpg,vlm.txt
    For more details about VLC usage see manual.



  • Parameter vlc_restart
    When VLC works for 24х7 it may work slowly. This parameter specifies number of hours till next automatic VLC restart. 
    vlc_restart=4
    By default VLC will restart each 12 hours, value =off turns off autmatic restart.



  • Parameter vlc_timeout
    Timeout determines for how long VLC player will work in background when user switches to another virtual screen. Default timeout value is 0, possible values from 0 to 300. This line tells terminal not to turn off VLC working in background: 
    vlc_timeout=off


    • Using terminal periphery



  • Parameter disk
    You can access terminal USB-disks and CDROM. To enable device redirection set corresponding parameter disk or shared_disk value. The difference between using these parameters is in disk redirection way.
    While using disk parameter RDP protocol is used for redirection. We recommend to use this value. In current terminal session disk is available at: \\tsclient\{cdrom|usbN}. Sometimes (not always, reasons not revealed) disk automatically appears in "My computer".
    If you've set proper parameter in configuration file, but can't see any disk icon - please, make sure that terminal server settings allow client disk redirection. Try to access Windows-computer disks using standart Microsoft terminal services client (Start > Programs > Accessories > Communications > Remote desktop connection).
    One of terminal server settings: in group policy (Start -> Run -> gpedit.msc) goto Computer Configuration -> Administrative Templates -> Windows Components -> Remote Desktop Services -> Remote Desktop Session Host -> Device and Resource Redirection and specify policy "Do not allow drive redirection" to "Disabled".
    While using terminal floppies and CD-s user should connect and disconnect disks manually. After inserting CD user should place mouse to bottom right screen corner. Then window with buttons appears. Press "connect" button to make terminal read disk contents. It's necessary to press "disconnect" BEFORE disk ejecting, otherwise disk data can be damaged. As our practice shows this is the only safe way of working with terminal disks.
    USB flash-disks connect automatically without pressing any buttons. Before ejecting USB flash wait till light stops blinking and eject disk in several minutes.
    By default all disk redirections are disabled. Don't allow users to access terminal disks without extreme necessity. It threatens your computer infrastructure security. Having the opportunity to read\write information to disks, user can bring virus or steal important information.
    To access terminal CDROM specify: 
    disk = cdrom
    To access terminal USB_flash disks specify: 
    disk = usb
    USB-disks can be protected from writing, just specify:
    disk = usb(r/o)
    For example this line:
    disk = cdrom;usb(r/o)
    means that user can access terminal CD-ROM and USB-disks, and USB-disks will be redirected read-only.



  • Parameter shared_disk
    You can access terminal USB-disks and CDROM. To enable device redirection set corresponding parameter disk or shared_disk value. The difference between using these parameters is in disk redirection way.
    While using shared_disk parameter terminal is told to run "Microsoft networks" support service. It means, that any user is able to access disk from any computer in network. Disk is available at: \terminal_IP_address\{cdrom|usbN}.By default all disk redirections are disabled. Don't allow users to access terminal disks without extreme necessity. Firstly, it threatens your computer infrastructure security. Having the opportunity to read\write information to disks, user can bring virus or steal important information. Secondly, redirection uses terminal resources, most of all memory, that could be used for cache.
    To access terminal CDROM specify: 
    shared_disk = cdrom
    To access terminal USB_flash disks specify: 
    shared_disk = usb
    USB-disks can be protected from writing, just specify:
    shared_disk = usb(r/o)
    For example this line:
    shared_disk = cdrom;usb(r/o)
    means that user can access terminal CD-ROM and USB-disks, and USB-disks will be redirected read-only.



  • Parameter printer

    There are three ways of using printer that is connected to terminal. They are managed by printer, rdp_printer and shared_usb parameters. Select the most suitable for you and use it. For more details read article about printers.

    If printer parameter is specified correctly, printer can be attached to terminal, and all computers in the network, including terminal server, can use it.

    Possible parameter values: 

    printer = lpt1
    one-way data communication with printer (only from server to printer), lpt parallel port driver configured to work with 378 port, irq 7. 
    printer = usb
    one-way data communication with printer, USB printer. 

    printer = usb(1234:abcd), usb(5678:cdef)
    binds printer USB ID to port number. The first printer will be available on 9100 port, the second printer - 9101 port. USB ID tells terminal, which of physical printers it should determine as the first and which as the second.

    printer = usb(delay 300)
    specifies delay. It is used only for USB-LPT adapters.

    printer = com1
    one-way data communication with connected to com1 port printer, 9600 bps speed, 8 bit capacity, no parity check, one stop-bit (9600-8-N-1, common com-port hardware configuration). Expanded parameter syntax: 
    printer = com1(38400)
    specifies 38400 bps speed.

    Terminal with attached printer should have fixed IP address. For more details about how to make Microsoft DHCP to give fixed terminals addresses see this article. About printer drivers installation on the server read at this article.

    How to print from DOS on terminal read here

    WTware terminal emulates HP JetDirect hardware print-server (hardware print-server is a small box, that connects computer network and printer). With WTware terminal:

    • work all printers able to work with hardware print-server HP JetDirect (as well as with any other print-server, all hardware print-servers are HP JetDirect copies),
    • work all printers which drivers are included into Window distributive,
    • work all printers able to print from DOS without additional drivers,
    • don't work so called Win-printers. Some of win-printers: HP 700c, 820c, 1000c, 3300c, 3400c, DJ 820cxi, LJ 3100; Canon LBP-250/810/1110/1120/1210/2410; Epson LP1300,EPL 5800/2050+/6200L, C900; Lexmark X5150;Dell A920/940/960, J740; Minolta 1350W/1250W/2300W.
    .

    Up to 4 printers can work on the terminal. Blocks containing each printer data are separated by semicolons. 2nd printer uses port 9101, 3rd printer uses port 9102 and 4th printer uses port 9103. If you connect more than one printers of the same type (lpt1 and lpt2, or usb and usb), then check experimentally physical naming order by printing test pages. 

    printer  = lpt1;lpt2;usb;com1(38400)

    If server_only is specified after printer type, terminal ignores all other parameters and simply works as print-server, without graphic interface and connection to terminal server. For example, printer = usb;lpt1,server_only.

    To turn on printer debug information logging specify in configuration file:

    printer = usb, debug

    Send full terminal log to support@wtware.com. In this mode a lot of debug messages will be saved into terminal log. Turn on only when needed.





  • Parameter rdp_printer

    There are three ways of using printer that is connected to terminal. They are managed by printer, rdp_printer and shared_usb parameters. Select the most suitable for you and use it. For more details read article about printers.

    rdp_printer parameter redirects connected to terminal printer using RDP. The same as mstsc.exe does. Parameter value is correct printer name without any other symbols. In this article is described where to find this name. For example: 
    rdp_printer=HP LaserJet 1020
    You can specify which printer to use. Connect to working terminal by http to determine printer USB ID. For example: 
    rdp_printer=HP LaserJet 1020:usb 03f0:2b17
    If you have many similar printers, write their USB ID and names to the file "Everyone\printers-local.wtc". Then specify in configuration file: 
    rdp_printer=auto
    Supported printers connected via RS232 to COM-port: 
    rdp_printer=TSC TDP-225:com1
    You can print to network printer. That is especially important for remote offices without VPN: 
    rdp_printer=HP LaserJet 400 MFP M425dn:tcp 192.168.1.50:9100
    You can redirect several (not more than four) printers. For each printer specify how it connected to terminal. In one line: 
    rdp_printer=HP LaserJet 1020:usb 03f0:2b17, HP LaserJet 1022:usb 03f0:2c17, TSC TDP-225:com1, HP LaserJet 400 MFP M425dn:tcp 192.168.1.50:9100





  • Parameter vhusb
    Перенаправление USB устройств через VirtualHere. Подробнее на форуме.



  • Parameter usb
    USB redirection for Windows 2012R2 server. Not all devices work. For more details see forum.

    To turn on debug information logging specify in configuration file:

    usb=0403:6001, debug

    Send full terminal log to support@wtware.com. In this mode a lot of debug messages will be saved into terminal log. Turn on only when needed.





  • Parameter sound
    It's possible to redirect sound from server to terminal sound card. In order to redirect sound to terminal specify in configuration file: 
    sound = on
    You can specify sound device: 
    sound = on, hw:1:0
    For terminals released before 2013 year you can test another sound card drivers library:
    sound = oss
    Next line leaves sound on server, i.e. sound will be played by server sound card: 
    sound = remote
    By default redirected one channel of compressed ADPCM sound.To turn on second channel and play stereo sound specify:
    sound = on, stereo
    To turn off compression and redirect two channels of uncompressed sound (then traffic will be about 170 KB/s) specify:
    sound = on, raw
    If there's no sound and if you are using Raspberry Pi 2 or 3 please read full manual about sound configuration: wtware.com/docs5/sound.html

  • Parameter sound_level

    Terminal sound level:

    sound_level = 50

    Possible values - from 0 (sound muted) to 100 (maximum level).

    You may show volume control in popup window:

    sound_level = 75, infobox


  • Parameter sound_control

    Drivers for some sound cards can't manage hardware sound level. In such cases you can use software sound level control:

    sound_control = sw


  • Parameter sound_rate

    Some drivers for some sound cards set sound speed incorrectly. For example old AMD Geode GX1 (Cyrix Kahlua). As a result sound is much faster then it should be. To correct it we added parameter sound_rate. Specify one of the next values in configuration file: 

    sound_rate = 32000
sound_rate = 44100
sound_rate = 48000


  • Parameter sound_buffer
    sound_buffer = 300

    Possible values - from 50 (minimal) to 500 (maximum).





  • Parameter microphone

    Microphone redirection. Supported only by Windows 7 Ultimate, Windows Server 2008r2 and newer:

    microphone = on

    USB microphone (only microphone without headphones):

    microphone = on, hw:1:0


  • Parameter microphone_level

    Terminal microphone sound level:

    microphone_level = 50

    Possible values - from 0 (microphone muted) to 100 (maximum level).





  • Parameter serial
    In order to redirect serial port COM1 to terminal specify in configuration file: 
    serial = com1
    To redirect COM2 and COM2: 
    serial = com1;com2
    USB bar code scanners, check printers and other devices with COM and USB interfaces also should be connected using serial= parameter. Then on the terminal server such device is available as COM-port device. Such devices have USB to Serial converter, and terminal makes reconversion. Like Windows-driver terminal creates virtual COM-port. To redirect such device with USB interface specify in configuration file: 
    serial = com1(usb)

    If you need to redirect two or more devices with USB to Serial converter, you should specify USB ID (unique USB device model ID, it's common for similar USB to Serial adapters) or bus ID (physical USB connector address on computer) for each of these devices. Terminal needs to determine corresponding port for each device. Connect all needed devices to terminal. Boot terminal. On another windows-computer in network open web-browser and enter terminal IP in address line. In "USB Bus" section you'll see list of all devices, USB ID (marked green) and bus ID (marked orange) of each device. Syntax of serial= parameter in such case is:

    serial = com2(usb 0403:6001), com3(usb 0c2e:0720), com6(usb 11ca:0207)

    Or for bus ID (Do not mix! Specify either USB IDs of all devices or bus IDs of all devices):

    serial = com1(usb 2-1.1), com3(usb 1-1)

    Some USB devices represent two COM ports. It is configured so:

    serial = com1(usb), com2(usb second)

    Some advanced programs require COM-ports' names for different terminals to be unique. To work with these programs specify in configuration file:

    serial = com25(com1),eklmn10(com2),com45(usb)

    This line redirects com1 port from terminal, it will be named com25 on server. com2 terminal port on server will be named eklmn10 (yes, it's possible). Connected to USB device with com-usb interface (barcode scanner, receipt printer, scales etc.) on server will be named com45.

    Not to cause confusion with physical server ports we recommend to rename physical ports. It's not obligatory, but otherwise there will be two COM1 ports in terminal session. If applications have to deal with these two variants, it can cause errors. To configure ports: rightclick on "My Computer" > Manage > Device manager > Ports (COM & LPT) > Communications port (COM1) > Properties > Port settings > Advanced > COM-port number. For example, set COM11. Just the same rename COM2 to COM12. Reboot server.

    Redirected by RDP COM ports are not displayed in Device Manager! To make sure, that everything is right: connect to terminal server, start command line prompt and execute change port command. Correct result is (redirected COM1 port): 

    COM1 = \Device\RdpDrPort\;COM1:1\\tsclient\COM1
COM11 = \Device\Serial0
COM12 = \Device\Serial1
    It means, that there are three serial ports available in session. COM11 and COM12 ports are physical server ports. COM1 is physical terminal COM1 port. In this session any application, that works with COM1 device, in fact works with terminal COM1 port.

    To turn on debug information logging specify in configuration file:

    serial = com1, debug

    Send full terminal log to support@wtware.com. In this mode a lot of debug messages

    In this mode a lot of debug messages will be saved into terminal log. Turn on only when needed.





  • Parameter ser2net
    COM-ports can be redirected through ser2net utility. TCP/IP ports start from 2001. For Windows client side you can use Tibbo or com0com. Examples: 
    ser2net = com1 115200
ser2net = usb 9600
ser2net = com1 115200, usb 0c2e:0720 9600 NONE 1STOPBIT 8DATABITS XONXOFF LOCAL -RTSCTS, usb 0c2e:0722 57600

    Please, use only one way of access to port. If you specify both serial=com1 and ser2net=com1, none of them will work.



  • Parameter scanner
    USB-scanners are redirected with the help of SANE project. All devices from this list are supported. You should setup and configure on terminal server SaneTwain. To redirect scanner specify in configuration file: 
    scanner = on

    To turn on debug information logging specify in configuration file:

    scanner = on, debug

    Send full terminal log to support@wtware.com. In this mode a lot of debug messages

    In this mode a lot of debug messages will be saved into terminal log. Turn on only when needed.





  • Parameter smartcard

    To redirect smartcards to terminal in configuration file specify:

    smartcard = etoken

    Terminal can understand 2 or three (not more than three) card types:

    smartcard = etoken, rutoken, omnikey

    Next devices are supported:

    • auto - Autodetect connected reader
    • etoken - eToken 32K, eToken 64K, eToken 72K Java
    • jacarta - JaCarta (24dc:0101), JaCarta LT (24dc:0102)
    • rutoken - Rutoken S, ECP, lite, iBank2 A
    • acr122 - ACR122 (072f:2200)
    • acs - ASC CCID USB (072f:90cc)
    • acr128u - ACR1281U (072f:2224)
    • acr3901u - ACR3901U (072f:b000)
    • acr39u - ACR39U (072f:b100, some devices are not supported)
    • acr38u - ACR38U (072f:9000)
    • ezzccid - EZCCID, EZ100PU
    • gempctwin - Gemplus (08e6:3437)
    • gempckey - Gemplus (08e6:3438)
    • ibank2_blue - iBank2Key blue token (23A0:0002, 23A0:0004)
    • omnikey - OMNIKEY (076b:5321)
    • omni3021 - OMNIKEY (076b:3021, 076b:3022)
    • omni3x21 - OMNIKEY (076b:3031)
    • asedrive - ASEDrive (0dc3:0802, 0dc3:1004)
    • multisoft - MultiSoft SCR2 (2a0c:0001)
    • trustscreen - BIFIT Trustscreen (23A0:0005)
    • watchdata - Watchdata (163c:0407, 163c:0417)
    • cryptomate64 - ACS CryptoMate64 (072f:90db)
    • esmart - ESMART Token (2ce4:7479)
    • safetouch - SafeTouch (24a2:0102)
    • cyberjack - REINER SCT cyberJack (0c4b:0501)
    • cj_secoder - REINER SCT cyberJack Secoder (0c4b:0400)
    • identive_5710 - Identive CLOUD 2700 F (04e6:5710)
    • angara - BIFIT ANGARA (23a0:0008)
    • starsign - Giesecke & Devrient StarSign (1059:0017)
    • vdtoken - vdToken (2bb1:0f10)
    • avtor - Avtor (15cf:0019)
    • ezio - Gemalto Ezio Shield (08e6:34c0)
    • ezio_pro - Gemalto Ezio Shield Pro (08e6:34c1)
    • dell - Dell Keyboard (413c:2101)
    • kobil - Kobil Smart Token (0d46:3014)
    • minilector - Bit4id miniLector EVO (25dd:3111)
    • avbign - AVEST AvBign (28a1:0601)
    • scr3311 - SCM SCR3311 (04e6:511d)
    • au9540 - Alcor AU9540 (058f:9540)

    Terminal may autodetect smartcard reader, if it's from the list of supported readers and is connected before terminal turned on:

    smartcard = auto

    Only one smartcard can be redirected, two cards at once can't be redirected.

    To turn on debug information logging specify in configuration file:

    smartcard = etoken, debug

    Send full terminal log to support@wtware.com. In this mode a lot of debug messages will be saved into terminal log. Turn on only when needed.



    • Others



  • Parameter clienthostname
    Terminal name, that is shown in "Terminal Services Manager" and is used for licensing access to Microsoft terminal services, is determined by clienthostname parameter: 
    clienthostname = terminal1
    Terminal can generate name using template: 
    clienthostname = ca*MAC
    This value tells terminal with MAC-address 01:02:03:ab:cd to generate the name ca010203ABCD. Also it may use one, two or three numbers from IP-address: 
    clienthostname = wt*IP1
    Terminal with IP-address 192.168.1.123 will have the name wt-123. And this value: 
    clienthostname = wt*IP3
    will name the terminal with the same IP-address 192.168.1.123 as wt-168-1-123.

    Name length must be not more than 15 symbols!

    It's better to use different names for different terminals. Also terminal name can be received from DHCP-server (in this case it can be used as a name for configuration file, for more details see this article). But clienthostname parameter value underlies received from DHCP-server name. clienthostname default value is wtwXXXXXXXXXXXX, where XXXXXXXXXXXX - terminal MAC-address.



  • Parameter turnoffmenu
    After disconnecting from terminal server terminal automatically connects to server again. Sometimes users don't understand: when are they to shut down computer if there's always Windows on the screen? When you set parameter value to: 
    turnoffmenu = on
    then if parameters server and user create start menu, terminal adds new menu item "Turn off computer". Otherwise after disconnect on the screen appears screen saver with the text "Turn off computer or press Enter to continue."

    If parameter value is always: 
    turnoffmenu = always
    then after disconnect terminal shows screen saver with the text "Turn off computer or press Enter to continue." AND adds item "Turn off computer" to server and user selection menus, if they are created by server and user parameters.

    Press Esc, Sleep, Power when you see screen saver "Turn off computer..." to turn off terminal.

    To change text message specify: 
    turnoffmenu = on,msg:Turn it off NOW!
    To make terminal turn off automatically after log off specify: 
    turnoffmenu = poweroff





  • Parameter autoshutdown
    This parameter is used to make terminal shut down when it is not connected to server during specified time. Timeout is specified in minutes: 
    autoshutdown = 5




  • Parameter sleep
    This parameter is used to put the monitor to sleep when it is not used during specified time. Energy saving mode can be Poweroff, Stand-by, Suspend. Wikipedia knows the difference between these modes. Timeout is specified in minutes. Default mode is Poweroff.
    sleep = 10
sleep = 20,standby




  • Parameter infobox
    When moving mouse to right-bottom screen corner - WTware window appears. It contains technical information: WTware version, terminal server IP, terminal MAC-address. Also when disk=cdrom parameter are specified in configuration file connect or disconnect button for disk are placed in this window. When this window makes you nervous, terminal can show it only if you press one of the control buttons and move mouse to right-bottom corner. Specify one these lines: 
    infobox = lctrl
infobox = rctrl
infobox = lalt
infobox = ralt
infobox = lshift
infobox = rshift
infobox = never
    lctrl means "left Ctrl button", rshift means "right Shift button".

    You may remove WTware logo and version number from this window. Specify skin parameter and create popup.png with your company logo.

    WTware may show connection name. Specify name in connection displayName parameter.

    You may turn off showing terminal MAC address in this window: 
    infobox = nomac
    Or do not show MAC, IP and terminal hostname just not to scare users: 
    infobox = noinfo
    By combining both of these flags, this window appears only when right Alt button is pressed and no addresses are shown: 
    infobox = ralt,noinfo
    If you need terminal power off button in popup window specify:
    infobox = shutdown
    If you need reboot terminal button in popup window specify:
    infobox = reboot




  • Parameter screenswitch
    You may switch between virtual screens using buttons in popup windows or using keyboard. By default Win-1..Win-4 key sequences are used.To set another key sequence specify in configuration file: 
    screenswitch = Win-Ctrl-N

    Or you may deprecate switching from keyboard:
    screenswitch = none




  • Parameter onerror
    If terminal session fails with error, terminal shows error info window and waits until user presses the button "OK". You may tell terminal to wait no longer than the specified number of seconds (possible values from 5 to 300), after that automatically remove error window and continue to work: 
    onerror = 60
    Or event not to scare user with error messages (errors will be stored only in terminal log): 
    onerror = quiet




  • Parameter redraw_delay
    redraw_delay parameter determines maximal screen refresh interval. It is specified in milliseconds. Possible values - from 50 to 3000, default value is 300. 
    redraw_delay = 50
    When server sends data to screen too fast and terminal can't cope with such data amount - terminal stops screen refreshing and draws image only to frame buffer, in RAM. To see this effect run some console application, for example, execute command 'type longtextfile' from command prompt. For there's no output to slow video memory terminal can calculate each frame faster and thus cope with redraw amount faster. But people don't like when image freezes and screen stops refreshing. Small parameter values make image more alive. High values cause refresh delays but help to increase the speed of large data amounts redraw.



  • Parameter rdpcompression
    rdpcompression parameter enables RDP packets compression: 
    rdpcompression = on
    Use this option only for lower-bit-rate channels. Compression decreases terminal performance in local networks. Disabled by default.



  • Parameter scale_factor
    scale_factor = 125

    The scale factor (as a percentage) applied to Windows Desktop Applications. Possible values: 100 (default), 125, 150.





  • Parameter connect_timeout
    connect_timeout parameter specifies the period in seconds, during which terminal attempts to connect to server: 
    connect_timeout = 5..60
    This line means that terminal will be trying to connect to server for at least 5 seconds and no more than 60 seconds.



  • Parameter keepalive

    TCP keepalive timer configuration, it determines when to drop connection if network link broke:

    keepalive = 10,3,5

    Better not to change this parameter. Numebers - TCP_KEEPIDLE, TCP_KEEPINTVL, TCP_KEEPCNT - are described in TCP/IP documentation. By default =on, is the same as =10,3,5. With these settings terminal will show that link is broken in 10 + 3 * 5 = 25 seconds. To turn off this timer specify:

    keepalive = off




  • Parameter extra

    Load and launch external files.





  • Parameter CLID
    Concurrent licenses identificator. To determine it go to WTware license generator. For more details see this manual.



  • Parameter language
    Parameter language sets the language for login and password input in WTware interface. Also this parameter sets the language for Google Chrome and VNC client. English is default language, any other language or keyboard layout (QWERTZ, AZERTY etc.) should be added by such line: 
    language = de, default




  • Parameter keyswitch
    Parameter keyswitch sets key sequence to change keyboard layout. This parameter is used for domain, login, password input in WTware interface and only when language parameter specified. Also it works for Google Chrome. Default key sequence is Ctrl-Shift. To change it specify:
    keyswitch = alt-shift




  • Parameter clipboard
    You can use clipboard to transfer data between several simultaneously working sessions. Specify on configuration file: 
    clipboard = on
    If common clipboard is needed not in all sessions specify clipboard parameter only in needed connections of needed.
    For example, no need to specify clipboard parameter if there's only one screen on terminal.



  • Parameter ask_password
    Session Broker in Windows 2008/2012 Server doesn't pass password to terminal when tells it to connect to another server. Therefore user has to enter password or PIN second time. In order to avoid password reentering specify in configuration file:
    ask_password = on
    Then user will input password in WTware dialog and this password will be automatically used in Session Broker session redirection.

    You may tell terminal not to ask for smartcard PIN, if smartcard is not used for login: 
    ask_password = nopin




  • Parameter animation_speed

    Animation speed during switching screens:

    animation_speed = 3

    • 0 - no animation, 1 - slow, 9 - fast.





  • Parameter timezone
    By default in all Windows servers timezone redirection is turned off. It means that all users work in server timezone and timezone parameter won't change anything.
    To connect terminal from another timezone set to "Enabled" policy "Allow time zone redirection" in Administrative Templates - Windows components - Remote Desktop Services - Remote Desktop Session Host - Devices and Resources Redirection. Then on all terminals should be specified timezone.
    To specify terminal timezone use parameter:

    timezone = hawaii

    In this line hawaii - it's several first letters from Hawaiian Standard Time, name of timezone (GMT-10:00) Hawaii. Full list of timezones and names:

    TimezoneIn configuration file
    (UTC-12:00) International Date Line Westtimezone = Dateline Standard Time
    (UTC-11:00) Coordinated Universal Time-11timezone = UTC-11
    (UTC-10:00) Aleutian Islandstimezone = Aleutian Standard Time
    (UTC-10:00) Hawaiitimezone = Hawaiian Standard Time
    (UTC-09:30) Marquesas Islandstimezone = Marquesas Standard Time
    (UTC-09:00) Alaskatimezone = Alaskan Standard Time
    (UTC-09:00) Coordinated Universal Time-09timezone = UTC-09
    (UTC-08:00) Baja Californiatimezone = Pacific Standard Time (Mexico)
    (UTC-08:00) Coordinated Universal Time-08timezone = UTC-08
    (UTC-08:00) Pacific Time (US & Canada)timezone = Pacific Standard Time
    (UTC-07:00) Arizonatimezone = US Mountain Standard Time
    (UTC-07:00) Chihuahua, La Paz, Mazatlantimezone = Mountain Standard Time (Mexico)
    (UTC-07:00) Mountain Time (US & Canada)timezone = Mountain Standard Time
    (UTC-06:00) Central Americatimezone = Central America Standard Time
    (UTC-06:00) Central Time (US & Canada)timezone = Central Standard Time
    (UTC-06:00) Easter Islandtimezone = Easter Island Standard Time
    (UTC-06:00) Guadalajara, Mexico City, Monterreytimezone = Central Standard Time (Mexico)
    (UTC-06:00) Saskatchewantimezone = Canada Central Standard Time
    (UTC-05:00) Bogota, Lima, Quito, Rio Brancotimezone = SA Pacific Standard Time
    (UTC-05:00) Chetumaltimezone = Eastern Standard Time (Mexico)
    (UTC-05:00) Eastern Time (US & Canada)timezone = Eastern Standard Time
    (UTC-05:00) Haititimezone = Haiti Standard Time
    (UTC-05:00) Havanatimezone = Cuba Standard Time
    (UTC-05:00) Indiana (East)timezone = US Eastern Standard Time
    (UTC-04:00) Asunciontimezone = Paraguay Standard Time
    (UTC-04:00) Atlantic Time (Canada)timezone = Atlantic Standard Time
    (UTC-04:00) Caracastimezone = Venezuela Standard Time
    (UTC-04:00) Cuiabatimezone = Central Brazilian Standard Time
    (UTC-04:00) Georgetown, La Paz, Manaus, San Juantimezone = SA Western Standard Time
    (UTC-04:00) Santiagotimezone = Pacific SA Standard Time
    (UTC-04:00) Turks and Caicostimezone = Turks And Caicos Standard Time
    (UTC-03:30) Newfoundlandtimezone = Newfoundland Standard Time
    (UTC-03:00) Araguainatimezone = Tocantins Standard Time
    (UTC-03:00) Brasiliatimezone = E. South America Standard Time
    (UTC-03:00) Cayenne, Fortalezatimezone = SA Eastern Standard Time
    (UTC-03:00) City of Buenos Airestimezone = Argentina Standard Time
    (UTC-03:00) Greenlandtimezone = Greenland Standard Time
    (UTC-03:00) Montevideotimezone = Montevideo Standard Time
    (UTC-03:00) Punta Arenastimezone = Magallanes Standard Time
    (UTC-03:00) Saint Pierre and Miquelontimezone = Saint Pierre Standard Time
    (UTC-03:00) Salvadortimezone = Bahia Standard Time
    (UTC-02:00) Coordinated Universal Time-02timezone = UTC-02
    (UTC-02:00) Mid-Atlantic - Oldtimezone = Mid-Atlantic Standard Time
    (UTC-01:00) Azorestimezone = Azores Standard Time
    (UTC-01:00) Cabo Verde Is.timezone = Cape Verde Standard Time
    (UTC) Coordinated Universal Timetimezone = UTC
    (UTC+00:00) Casablancatimezone = Morocco Standard Time
    (UTC+00:00) Dublin, Edinburgh, Lisbon, Londontimezone = GMT Standard Time
    (UTC+00:00) Monrovia, Reykjaviktimezone = Greenwich Standard Time
    (UTC+01:00) Amsterdam, Berlin, Bern, Rome, Stockholm, Viennatimezone = W. Europe Standard Time
    (UTC+01:00) Belgrade, Bratislava, Budapest, Ljubljana, Praguetimezone = Central Europe Standard Time
    (UTC+01:00) Brussels, Copenhagen, Madrid, Paristimezone = Romance Standard Time
    (UTC+01:00) Sarajevo, Skopje, Warsaw, Zagrebtimezone = Central European Standard Time
    (UTC+01:00) West Central Africatimezone = W. Central Africa Standard Time
    (UTC+01:00) Windhoektimezone = Namibia Standard Time
    (UTC+02:00) Ammantimezone = Jordan Standard Time
    (UTC+02:00) Athens, Bucharesttimezone = GTB Standard Time
    (UTC+02:00) Beiruttimezone = Middle East Standard Time
    (UTC+02:00) Cairotimezone = Egypt Standard Time
    (UTC+02:00) Chisinautimezone = E. Europe Standard Time
    (UTC+02:00) Damascustimezone = Syria Standard Time
    (UTC+02:00) Gaza, Hebrontimezone = West Bank Standard Time
    (UTC+02:00) Harare, Pretoriatimezone = South Africa Standard Time
    (UTC+02:00) Helsinki, Kyiv, Riga, Sofia, Tallinn, Vilniustimezone = FLE Standard Time
    (UTC+02:00) Jerusalemtimezone = Israel Standard Time
    (UTC+02:00) Kaliningradtimezone = Kaliningrad Standard Time
    (UTC+02:00) Tripolitimezone = Libya Standard Time
    (UTC+03:00) Baghdadtimezone = Arabic Standard Time
    (UTC+03:00) Istanbultimezone = Turkey Standard Time
    (UTC+03:00) Kuwait, Riyadhtimezone = Arab Standard Time
    (UTC+03:00) Minsktimezone = Belarus Standard Time
    (UTC+03:00) Moscow, St. Petersburg, Volgogradtimezone = Russian Standard Time
    (UTC+03:00) Nairobitimezone = E. Africa Standard Time
    (UTC+03:30) Tehrantimezone = Iran Standard Time
    (UTC+04:00) Abu Dhabi, Muscattimezone = Arabian Standard Time
    (UTC+04:00) Astrakhan, Ulyanovsktimezone = Astrakhan Standard Time
    (UTC+04:00) Bakutimezone = Azerbaijan Standard Time
    (UTC+04:00) Izhevsk, Samaratimezone = Russia Time Zone 3
    (UTC+04:00) Port Louistimezone = Mauritius Standard Time
    (UTC+04:00) Saratovtimezone = Saratov Standard Time
    (UTC+04:00) Tbilisitimezone = Georgian Standard Time
    (UTC+04:00) Yerevantimezone = Caucasus Standard Time
    (UTC+04:30) Kabultimezone = Afghanistan Standard Time
    (UTC+05:00) Ashgabat, Tashkenttimezone = West Asia Standard Time
    (UTC+05:00) Ekaterinburgtimezone = Ekaterinburg Standard Time
    (UTC+05:00) Islamabad, Karachitimezone = Pakistan Standard Time
    (UTC+05:30) Chennai, Kolkata, Mumbai, New Delhitimezone = India Standard Time
    (UTC+05:30) Sri Jayawardenepuratimezone = Sri Lanka Standard Time
    (UTC+05:45) Kathmandutimezone = Nepal Standard Time
    (UTC+06:00) Astanatimezone = Central Asia Standard Time
    (UTC+06:00) Dhakatimezone = Bangladesh Standard Time
    (UTC+06:00) Omsktimezone = Omsk Standard Time
    (UTC+06:30) Yangon (Rangoon)timezone = Myanmar Standard Time
    (UTC+07:00) Bangkok, Hanoi, Jakartatimezone = SE Asia Standard Time
    (UTC+07:00) Barnaul, Gorno-Altaysktimezone = Altai Standard Time
    (UTC+07:00) Hovdtimezone = W. Mongolia Standard Time
    (UTC+07:00) Krasnoyarsktimezone = North Asia Standard Time
    (UTC+07:00) Novosibirsktimezone = N. Central Asia Standard Time
    (UTC+07:00) Tomsktimezone = Tomsk Standard Time
    (UTC+08:00) Beijing, Chongqing, Hong Kong, Urumqitimezone = China Standard Time
    (UTC+08:00) Irkutsktimezone = North Asia East Standard Time
    (UTC+08:00) Kuala Lumpur, Singaporetimezone = Singapore Standard Time
    (UTC+08:00) Perthtimezone = W. Australia Standard Time
    (UTC+08:00) Taipeitimezone = Taipei Standard Time
    (UTC+08:00) Ulaanbaatartimezone = Ulaanbaatar Standard Time
    (UTC+08:30) Pyongyangtimezone = North Korea Standard Time
    (UTC+08:45) Euclatimezone = Aus Central W. Standard Time
    (UTC+09:00) Chitatimezone = Transbaikal Standard Time
    (UTC+09:00) Osaka, Sapporo, Tokyotimezone = Tokyo Standard Time
    (UTC+09:00) Seoultimezone = Korea Standard Time
    (UTC+09:00) Yakutsktimezone = Yakutsk Standard Time
    (UTC+09:30) Adelaidetimezone = Cen. Australia Standard Time
    (UTC+09:30) Darwintimezone = AUS Central Standard Time
    (UTC+10:00) Brisbanetimezone = E. Australia Standard Time
    (UTC+10:00) Canberra, Melbourne, Sydneytimezone = AUS Eastern Standard Time
    (UTC+10:00) Guam, Port Moresbytimezone = West Pacific Standard Time
    (UTC+10:00) Hobarttimezone = Tasmania Standard Time
    (UTC+10:00) Vladivostoktimezone = Vladivostok Standard Time
    (UTC+10:30) Lord Howe Islandtimezone = Lord Howe Standard Time
    (UTC+11:00) Bougainville Islandtimezone = Bougainville Standard Time
    (UTC+11:00) Chokurdakhtimezone = Russia Time Zone 10
    (UTC+11:00) Magadantimezone = Magadan Standard Time
    (UTC+11:00) Norfolk Islandtimezone = Norfolk Standard Time
    (UTC+11:00) Sakhalintimezone = Sakhalin Standard Time
    (UTC+11:00) Solomon Is., New Caledoniatimezone = Central Pacific Standard Time
    (UTC+12:00) Anadyr, Petropavlovsk-Kamchatskytimezone = Russia Time Zone 11
    (UTC+12:00) Auckland, Wellingtontimezone = New Zealand Standard Time
    (UTC+12:00) Coordinated Universal Time+12timezone = UTC+12
    (UTC+12:00) Fijitimezone = Fiji Standard Time
    (UTC+12:00) Petropavlovsk-Kamchatsky - Oldtimezone = Kamchatka Standard Time
    (UTC+12:45) Chatham Islandstimezone = Chatham Islands Standard Time
    (UTC+13:00) Coordinated Universal Time+13timezone = UTC+13
    (UTC+13:00) Nuku'alofatimezone = Tonga Standard Time
    (UTC+13:00) Samoatimezone = Samoa Standard Time


    For local, running on terminal Google Chrome you may set local timezone. Correct POSIX timezone naming you may find in wikipedia, see TZ column in this table. In configuration file specify: 
    timezone = local:America/Sao_Paulo
    Time in computer BIOS should be set as UTC, not local time!
    If you need timezones both for Windows session and for local Google Chrome specify: 
    timezone = hawaii, local:Pacific/Honolulu




  • Parameter ntp
    Terminal mey request correct time from NTP server. Default value is =dhcp. Means, that terminal requests time only if NTP server address is specified in 042 DHCP parameter. Also NTP server may be specified manually:
    ntp = pool.ntp.org
    To disable NTP even if there's 042 DHCP parameter, specify in configuration file: 
    ntp = disable




  • Parameter skin
    Choose directory with custom images. Directory can contain four files:
    • menu.png - background for user and server select menu. Size no more than selected terminal screen resolution.
    • wait.png - image to show instead of black screen with the text "Please, wait...". Size no more than selcted terminal screen resolution. Shown centered.
    • saver.png - background for screen saver. Size no more than selected terminal screen resolution.
    • popup.png - logo for popup window in the right bottom screen corner. If specified, WTware logo and version are not shown. Size should be no more than 280x38.

    If terminal boots from local media (IDE hard disk, USB flash-disk, MMC, CD) and is configured to store configuration files on local disk, copy these images to boot disk's configs\ directory. You may copy images using terminal web-interface. There's no need to speicfy skin= parameter, terminal will find and apply stored images.





  • Parameter background
    You can specify different background colors for menus of different screens. It will make easier for users to tell technical support, on what screen they have difficulties. Each color is defined as six hexadecimal digits. For example this line:
    background=ff0000,00ff00,3a6ea5,0000ff
    defines backgound on first screen menu as red, on second screen - as green, on third screen - as default color, on fourth - as blue.



  • Parameter viterminal_licensing
    ViTerminal licensing server address. Used only for work with ViTerminal servers.



  • Parameter SIP
    Settings for connection to SIP server. Username, password and server address: 
    SIP = user:password@sip.linphone.org
    For work with SIP we use linphone. For testing and tuning there's linphonec command line. It's available from terminal web-interface, i.e. http-access to terminal by IP from another computer browser.You can specify sound devices for ringing and talking:
    SIP = user:password@sip.linphone.org, ring:1:0, talk:3:0
    For more details about sound devices read this manual: wtware.com/docs5/sound.html
    When terminal receives incoming call it shows popup window and blocks mouse, until user accepts or rejects the call. Terminal will show only call icon and won't block mouse when it receives call, if you specify:
    SIP = user:password@sip.linphone.org, nolock
    To enable auto answering for incoming calls on terminal specify:
    SIP = user:password@sip.linphone.org, auto-answer
    If SIP server port differs from default 5060 for UDP and 5061 for TLS:
    SIP = user:password@sip.linphone.org, port:55555
    You may turn on TLS encryption (that SIP server supports). With turned on TLS encryption you may turn off server certificates check:
    SIP = user:password@sip.linphone.org, tls
SIP = user:password@sip.linphone.org, tls, nocert
    You may use your own configuration file for linphone instead of our's. do not use it if you're unsure. Last section in configuration file must be [sound]. At the end of file will be automatically added lines ringer_dev_id, playback_dev_id and capture_dev_id. Terminal searches for configuration file in Everyone directory:
    SIP = user:password@sip.linphone.org, config:my_enterprise_sip.wtc
    Turn on linphone logging into log. Possible values - from 1 to 6:
    SIP = user:password@sip.linphone.org, debug:2
    Contact list terminal reads from Everyone/contacts.txt file. You may add more contects for some terminals. File with additional contacts should have the same structure as contacts.txt and should also be in Everyone directory:
    SIP = user:password@sip.linphone.org, contacts:morecontactsforreception.txt
    To change ring sound (WAV file should be stored in Everyone folder) specify:
    SIP = user:password@sip.linphone.org, wav:local.wav




  • Parameter SIP_usb_sound_level
    If SIP phone uses the only one connected to terminal sound card (no matter USB, PCI or onboard sound card, the main thing is that it's the only one), then volume is configured by sound_level parameter. If on terminal is also connected USB headset, then headset sound volume is configured by SIP_usb_sound_level parameter. By default it is 50, to make it louder specify: 
    SIP_usb_sound_level = 100
    Volume of all microphone is configured only by microphone_level parameter. You may show volume control in popup window:

    SIP_usb_sound_level = 75, infobox


    • Terminal console parameters

    Terminal configuration wizard helps to determine and check parameters from this group. It's easier to use wizard than to select values manually.

  • Parameter display
    Display description. Includes several parameters separated by commas. To configure video it's better to use video configuration wizard. For more details read: videocard configuration.
    You should specify real screen resolution, the same as specified in monitor documentation: 
    display = 1920x1080

    Video output is required for some drivers. Possible values: VGA, DVI, HDMI, LVDS, DP, VGA2, DVI2, HDMI2, LVDS2, DP2. Some drivers ignore specified video output and determine monitor on their own. Sometimes drivers mix HDMI and DVI, when connectors are specified incorrectly in videocard BIOS. In terminal web-interface you will find the list of video outputs, determined by driver on terminal. Terminal web-interface is available even when videocard driver failed to work and there's only black image on terminal screen. Example of specifying video output:
    display = 1920x1080, hdmi

    For some displays you may correct display brightness. Specify brightness as a percentage of the maximum value:
    display = 1920x1080, 42%

    Magic word noddc forbids driver to ask monitor about preferred mode. Use it when image fails to center:
    display = 1920x1080, hdmi, noddc

    You can specify display refresh rate. Almost always there's no need to specify it for LCD monitors: 
    display = 1920x1080, hdmi, noddc, 75Hz

    Instead of refresh you can specify full line of timings. It can be useful in very difficult cases, for monitors connected via 15-contact VGA D-SUB: 
    display = 1680х1050, "146.3 1680 1960 2136 2240 1050 1053 1059 1089"


  • Parameter M2_display
    Description of second monitor. Syntax is the same as in display parameter. Use this parameter only when second monitor is connected to terminal.



  • Parameter mouse_accel_mult
    mouse_accel_mult parameter changes mouse pointer speed. Possible values - from 0.01 to 16. To make a very low mouse speed set: 
    mouse_accel_mult = 0.05


  • Parameter doubleclick
    Only for ViTerminal client. Double-click interval in milliseconds. Possible values - from 100 to 1000.



  • Parameter touchscreen
    Touchscreen calibration. See the touchscreen configuration manual.



  • Parameter video
    video parameter determines video card driver. All possible values are listed below. We insist on using terminal configuration wizard to select video card driver.
    • video = auto          Autodetect
    • Linux kernel Framebuffer drivers, suffix (F)
      • video = VESA(F)          VESA, no widescreen modes!
      • video = amd(F)           AMD GPU
      • video = nouveau(F)       nVidia new
      • video = i915(F)          Intel i915..newest
      • video = radeon(F)        ATI new
      • video = gma(F)           Intel GMA500/600/3600/3650
      • video = aty128fb(F)      ATI Rage128
      • video = atyfb(F)         ATI
      • video = cirrusfb(F)      Cirrus Logic
      • video = gxfb(F)          Geode GX
      • video = gx1fb(F)         Geode GX1
      • video = i810fb(F)        Intel i810, i815
      • video = intelfb(F)       Intel i830..i945
      • video = lxfb(F)          Geode LX
      • video = hyperv_fb(F)     Microsoft Hyper-V
      • video = nvidiafb(F)      nVidia
      • video = matroxfb_base(F) Matrox
      • video = radeonfb(F)      ATI Radeon
      • video = rivafb(F)        nVidia RIVA 128/TNT/TNT2
      • video = s3fb(F)          S3 Trio/Virge
      • video = savagefb(F)      S3 Savage
      • video = sisfb(F)         SIS/XGI
      • video = tdfxfb(F)        tdfx voodoo
      • video = tridentfb(F)     Trident, VIA
      • video = viafb(F)         VIA, S3 Unichrome
      • video = vt8623fb(F)      VIA VT8623 [CLE266]
      • video = xgifb(F)         XGI
    • The newest X.org graphic library drivers, suffix (U)
      • video = ati(U)           ATI
      • video = intel(U)         Intel
      • video = modesetting(U)   Kernel modesetting
      • video = nouveau(U)       Nvidia
      • video = openchrome(U)    Openchrome for VIA
      • video = sis(U)           SIS
      • video = vesa(U)          VESA, no widescreen modes!
    • X.org 1.5.3 graphic library drivers, suffix (X)
      • video = apm(X)           APM, Alliance Technology
      • video = ark(X)           ARK Logic
      • video = chips(X)         Chips & Technologies
      • video = cirrus(X)        Cirrus Logic
      • video = geode(X)         Geode
      • video = glint(X)         GLINT/Permedia
      • video = i810(X)          Intel i8xx/i9xx
      • video = mga(X)           Matrox
      • video = nsc(X)           NSC
      • video = rdc(X)           RDC
      • video = rdcm12(X)        RDC M2012
      • video = rendition(X)     Rendition/Micron
      • video = s3(X)            S3
      • video = s3virge(X)       S3 Virge
      • video = savage(X)        S3 Savage
      • video = sis(X)           SIS
      • video = tdfx(X)          3Dfx
      • video = trident(X)       Trident
      • video = tseng(X)         Tseng Labs
      • video = unichrome(X)     Unichrome for VIA
      • video = xgi(X)           XGI
      • video = vesa(X)          VESA Universal driver




  • Parameter bpp
    bpp parameter determines color depth.
    bpp = 16
bpp = 32




  • Parameter kbdrate
    This parameter specifies keyboard character repeat settings - repeat delay and repeat rate. This line sets common settings (30 repeats per second, 250 milliseconds repeat delay): 
    kbdrate = 30,250
    And this line makes slow keyboard (2 repeats per second, 1000 milliseconds repeat delay): 
    kbdrate = 2,1000
    Possible values: from 2 to 100 repeats per second, repeat delay from 100 to 1000 milliseconds.If parameter kbdrate is not specified BIOS settings are used.



    • Remote terminal management



  • Parameter managed
    You can turn off or restart terminals remotely. It can be useful, for example, when you changed configuration files and need to apply these changes immediately. Such line in configuration file allows to manage terminal from any other computer: 
    managed = on
    And this line allows to manage terminal only from computers with addresses 192.168.10.15, 192.168.10.16 and subnet 192.168.1.0/24: 
    managed = 192.168.10.15, 192.168.10.16, 192.168.1.0/24
    Terminals are managed by command line tool rsh.exe included into Windows Server distribution. To restart terminal 192.168.10.50 immediately run: 
    rsh.exe 192.168.10.50 reboot
    If you changed configuration file and want terminal to re-read it, terminal should be restarted. You can tell terminal to restart as soon as possible, i.e. when user will exit current session: 
    rsh.exe 192.168.10.50 update
    To turn off terminal run: 
    rsh.exe 192.168.10.50	shutdown
    Instead of rsh in Linux and other *nix you can use echo and nc: 
    echo -en "0\0\0\0reboot\0" | nc 192.168.1.50 514




  • Parameter httpd
    For diagnostics and management on every terminal is working micro-web-server. If you know terminal IP, you can connect to it by browser and see settings, configuration file, log and other terminal information. By default access to it is granted to all. You can allow access only from selected IPs:
    httpd = 192.168.1.1, 192.168.1.2, 192.168.2.0/24
    Or turn off terminal http server:
    httpd = off
    At boot start http-server always runs available for all. If error won't allow terminal to read it's configuration, boot will fail with error. But http-server will work to help diagnose the problem remotely.



  • Parameter syslog
    Terminal can send all log events to syslog server by UDP to port 514:
    syslog = 192.168.1.1
    Or another port:
    syslog = 192.168.1.1:9099




  • Parameter discover
    By default during boot terminals send broadcast requests, that contain WTware version, IP, MAC, hostname and IP address of the DHCP server, that has just told download addresses. If WTware configurator works in the same network, it receives broadcast messages and saves or updates terminal information.

    If WTware configurator works over the router and is unable to receive broadcast packet, you may tell terminal to send additional message to IP of the computer woth working configurator: 
    discover = 192.168.1.1




  • Parameter keyboard_log
    Send every key you press on terminal to log. DO NOT USE this option unless you prepare log for WTware technical support. Default value is =off
    keyboard_log = on




  • Parameter vnc

    You can connect to terminal by VNC protocol to view terminal screen and to help user with his problem. It became more important when Microsoft removed Remote Desktop Connection from Windows 2012 Server.

    Next configuration file line allows connection to terminal by VNC from any computer: 

    vnc = on
    Next line allows connection only from computers with IP 192.168.10.15, 192.168.10.16 and subnet 192.168.1.0/24: 
    vnc = 192.168.10.15, 192.168.10.16, 192.168.1.0/24
    Popup window in right bottom corner is not shown by VNC. Local Google Chrome is not shown by VNC.

    If terminal uses two monitors, then to view second monitor by VNC connection specify while connecting 5901 port.


    If terminal is over slow channel, specify in configuration file:

    vnc=4to1
    This setting will reduce terminal screen by four times. Due to such image decrease show speed will noticeably increase.


    By default user knows nothing about VNC-connection.You may ask user for permission. With such line:

    vnc=allow after timeout
    terminal will show window with request for VNC connection. If in 30 seconds user won't react, VNC connection will be established.

    Another line:

    vnc=reject after timeout
    will show the same request, but if user won't react, in this case connection will be rejected.



  • Parameter vnc_password
    Password for connection to WTware VNC server:
    vnc_password = 12345
    Password length is from 1 to 8 symbols. Allowed latin letters and digits.
    Specified in configuration file password is available to everone - from TFTP configuration file or terminal log.More secure to store in configuration file password hash. It won't protect from serious hack, but at least it'll force to spend some time. To generate password hash use WTware graphic configurator. For example: 
    vnc_password=hex:a0987527920893f174515708320c7fe3



    • If you have any comments or remarks to this article, please, let us know!