server
server=192.168.1.1 server=ts1.local server=ts3.local:4000
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
server=192.168.1.6;192.168.1.7; server=xpu:tsxpu1.local,tsxpu2.local,192.168.1.11:5000
server=--new--
server=192.168.1.1,--new--
application
application = chromeChromium requires 1024MB RAM. Video driver should be from (U) package. Here's the manual about local Chromium.
application = vlcHere's the manual about local VLC.
application = shutdownKeyword for creating special menu item to reboot terminal:
application = rebootExample 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
user
user
and domain
are used: user = vasyapupkin domain = MYDOMAINAlso you can specify password:
user = petja:password
DOMAIN\user[display_name]:password DOMAIN\user:password user[display_name]:password user:password DOMAIN\user[display_name] DOMAIN\user userdisplay_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.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--
domain
domain
will be set in login window when terminal connects to terminal server. shell
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.exestarts 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.
shell = ||RMySuperRemoteApp
directory
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
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-imeAlso if you need to use keyboard, not listed in the layouts list, you may specify keyboard layout code:
keyboard = 0xb0060409All keyboard layouts codes, installed on your server, are listed in the registry key:
HKEY_LOCAL_MACHINE\SYSTEM\ControlSet001\Control\Keyboard Layouts
numlock
numlock = off
graphic
graphic
parameter. Parameter value is a line containing one or more of these symbols: a
- Desktop backgroundb
- Show window contents while draggingc
- Menu and window animation, scroll documents in MS Officed
- Themese
- Display cursor shadowf
- Font smoothingg
- Desktop compositiongraphic = abcdefgTo 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.
loadbalanceinfo
loadbalanceinfo=
parameter. In Windows .rdp file, that is used for connecting, is specified: loadbalanceinfo:s:tsv://MS Terminal Services Plugin.1.NameSCInstead of NameSC is the name of your Session Collection. In WTware configuration file you should specify:
loadbalanceinfo = tsv://MS Terminal Services Plugin.1.NameSC
chrome_url
chrome_url=http://wtware.com/doc.html
chrome_mode
chrome_mode = windowKiosk mode without address line is used for users that don't view other sites:
chrome_mode = kioskWithout mouse pointer:
chrome_mode = kiosk-nopointer
chrome_language
chrome_language = nlIf user needs to enter text in some language other than english, specify parameter
language=
chrome_profile
chrome_pac
chrome_pac=http://192.168.1.1/proxy.pac
chrome_proxy
chrome_proxy=192.168.1.1:3128 chrome_proxy="https=proxy1:80;http=socks4://baz:1080"
chrome_share
chrome_share=\\10.1.2.3\sharenameWith username and password:
chrome_share=\\10.1.2.3\sharename, user vasja, password 123To connect folder read-only, so that user could not store file from Internet:
chrome_share=\\10.1.2.3\sharename, roComplicated magic for working with old Windows:
chrome_share=\\10.1.2.3\sharename, vers 1.0
chrome_camera
chrome_camera=on
vlc_cmdline
vlc_cmdline=-I dummy rtsp://10.1.1.32:8556/6For more details about VLC usage see manual.
vlc_files
/vlc_files
directory on disk or to terminal RAM. It may be background images, videofiles or vlm configuration script: vlc_files=background.jpg,vlm.txtFor more details about VLC usage see manual.
vlc_restart
vlc_restart=4By default VLC will restart each 12 hours, value
=off
turns off autmatic restart.vlc_timeout
vlc_timeout=off
disk
disk
or shared_disk
value. The difference between using these parameters is in disk redirection way.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".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.
disk = cdromTo access terminal USB_flash disks specify:
disk = usbUSB-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.
shared_disk
disk
or shared_disk
value. The difference between using these parameters is in disk redirection way.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.shared_disk = cdromTo access terminal USB_flash disks specify:
shared_disk = usbUSB-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.
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.
Ifprinter
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 = lpt1one-way data communication with printer (only from server to printer), lpt parallel port driver configured to work with 378 port, irq 7.
printer = usbone-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 = com1one-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:
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.
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 1020You 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:2b17If 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=autoSupported printers connected via RS232 to COM-port:
rdp_printer=TSC TDP-225:com1You 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:9100You 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
vhusb
usb
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.
sound
sound = onYou can specify sound device:
sound = on, hw:1:0For terminals released before 2013 year you can test another sound card drivers library:
sound = ossNext line leaves sound on server, i.e. sound will be played by server sound card:
sound = remoteBy default redirected one channel of compressed ADPCM sound.To turn on second channel and play stereo sound specify:
sound = on, stereoTo turn off compression and redirect two channels of uncompressed sound (then traffic will be about 170 KB/s) specify:
sound = on, rawIf 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
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
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
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
sound_buffer
sound_buffer = 300
Possible values - from 50 (minimal) to 500 (maximum).
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
microphone_level
Terminal microphone sound level:
microphone_level = 50
Possible values - from 0 (microphone muted) to 100 (maximum level).
serial
serial = com1To redirect COM2 and COM2:
serial = com1;com2USB 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\Serial1It 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.
ser2net
ser2net = com1 115200 ser2net = usb 9600 ser2net = com1 115200, usb 0c2e:0720 9600 NONE 1STOPBIT 8DATABITS XONXOFF LOCAL -RTSCTS, usb 0c2e:0722 57600
scanner
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.
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 readeretoken
- eToken 32K, eToken 64K, eToken 72K Javajacarta
- JaCarta (24dc:0101), JaCarta LT (24dc:0102)rutoken
- Rutoken S, ECP, lite, iBank2 Aacr122
- 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, EZ100PUgempctwin
- 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, 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.
clienthostname
clienthostname
parameter: clienthostname = terminal1Terminal can generate name using template:
clienthostname = ca*MACThis 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*IP1Terminal with IP-address 192.168.1.123 will have the name
wt-123
. And this value: clienthostname = wt*IP3will name the terminal with the same IP-address 192.168.1.123 as
wt-168-1-123
.clienthostname
parameter value underlies received from DHCP-server name. clienthostname
default value is wtwXXXXXXXXXXXX
, where XXXXXXXXXXXX
- terminal MAC-address.turnoffmenu
turnoffmenu = onthen 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."always
: turnoffmenu = alwaysthen 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.turnoffmenu = on,msg:Turn it off NOW!To make terminal turn off automatically after log off specify:
turnoffmenu = poweroff
autoshutdown
autoshutdown = 5
sleep
sleep = 10 sleep = 20,standby
infobox
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".skin
parameter and create popup.png with your company logo.displayName
parameter.infobox = nomacOr do not show MAC, IP and terminal hostname just not to scare users:
infobox = noinfoBy combining both of these flags, this window appears only when right Alt button is pressed and no addresses are shown:
infobox = ralt,noinfoIf you need terminal power off button in popup window specify:
infobox = shutdownIf you need reboot terminal button in popup window specify:
infobox = reboot
screenswitch
screenswitch = Win-Ctrl-N
screenswitch = none
onerror
onerror = 60Or event not to scare user with error messages (errors will be stored only in terminal log):
onerror = quiet
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 = 50When 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.
rdpcompression
rdpcompression
parameter enables RDP packets compression: rdpcompression = onUse this option only for lower-bit-rate channels. Compression decreases terminal performance in local networks. Disabled by default.
scale_factor
scale_factor = 125
The scale factor (as a percentage) applied to Windows Desktop Applications. Possible values: 100 (default), 125, 150.
connect_timeout
connect_timeout
parameter specifies the period in seconds, during which terminal attempts to connect to server: connect_timeout = 5..60This line means that terminal will be trying to connect to server for at least 5 seconds and no more than 60 seconds.
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
extra
Load and launch external files.
CLID
language
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
keyswitch
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
clipboard
clipboard = onIf common clipboard is needed not in all sessions specify
clipboard
parameter only in needed connections of needed.ask_password
ask_password = onThen user will input password in WTware dialog and this password will be automatically used in Session Broker session redirection.
ask_password = nopin
animation_speed
Animation speed during switching screens:
animation_speed = 3
0 - no animation, 1 - slow, 9 - fast.
timezone
timezone
parameter won't change anything.timezone = hawaii
Timezone | In configuration file |
---|---|
(UTC-12:00) International Date Line West | timezone = Dateline Standard Time |
(UTC-11:00) Coordinated Universal Time-11 | timezone = UTC-11 |
(UTC-10:00) Aleutian Islands | timezone = Aleutian Standard Time |
(UTC-10:00) Hawaii | timezone = Hawaiian Standard Time |
(UTC-09:30) Marquesas Islands | timezone = Marquesas Standard Time |
(UTC-09:00) Alaska | timezone = Alaskan Standard Time |
(UTC-09:00) Coordinated Universal Time-09 | timezone = UTC-09 |
(UTC-08:00) Baja California | timezone = Pacific Standard Time (Mexico) |
(UTC-08:00) Coordinated Universal Time-08 | timezone = UTC-08 |
(UTC-08:00) Pacific Time (US & Canada) | timezone = Pacific Standard Time |
(UTC-07:00) Arizona | timezone = US Mountain Standard Time |
(UTC-07:00) Chihuahua, La Paz, Mazatlan | timezone = Mountain Standard Time (Mexico) |
(UTC-07:00) Mountain Time (US & Canada) | timezone = Mountain Standard Time |
(UTC-06:00) Central America | timezone = Central America Standard Time |
(UTC-06:00) Central Time (US & Canada) | timezone = Central Standard Time |
(UTC-06:00) Easter Island | timezone = Easter Island Standard Time |
(UTC-06:00) Guadalajara, Mexico City, Monterrey | timezone = Central Standard Time (Mexico) |
(UTC-06:00) Saskatchewan | timezone = Canada Central Standard Time |
(UTC-05:00) Bogota, Lima, Quito, Rio Branco | timezone = SA Pacific Standard Time |
(UTC-05:00) Chetumal | timezone = Eastern Standard Time (Mexico) |
(UTC-05:00) Eastern Time (US & Canada) | timezone = Eastern Standard Time |
(UTC-05:00) Haiti | timezone = Haiti Standard Time |
(UTC-05:00) Havana | timezone = Cuba Standard Time |
(UTC-05:00) Indiana (East) | timezone = US Eastern Standard Time |
(UTC-04:00) Asuncion | timezone = Paraguay Standard Time |
(UTC-04:00) Atlantic Time (Canada) | timezone = Atlantic Standard Time |
(UTC-04:00) Caracas | timezone = Venezuela Standard Time |
(UTC-04:00) Cuiaba | timezone = Central Brazilian Standard Time |
(UTC-04:00) Georgetown, La Paz, Manaus, San Juan | timezone = SA Western Standard Time |
(UTC-04:00) Santiago | timezone = Pacific SA Standard Time |
(UTC-04:00) Turks and Caicos | timezone = Turks And Caicos Standard Time |
(UTC-03:30) Newfoundland | timezone = Newfoundland Standard Time |
(UTC-03:00) Araguaina | timezone = Tocantins Standard Time |
(UTC-03:00) Brasilia | timezone = E. South America Standard Time |
(UTC-03:00) Cayenne, Fortaleza | timezone = SA Eastern Standard Time |
(UTC-03:00) City of Buenos Aires | timezone = Argentina Standard Time |
(UTC-03:00) Greenland | timezone = Greenland Standard Time |
(UTC-03:00) Montevideo | timezone = Montevideo Standard Time |
(UTC-03:00) Punta Arenas | timezone = Magallanes Standard Time |
(UTC-03:00) Saint Pierre and Miquelon | timezone = Saint Pierre Standard Time |
(UTC-03:00) Salvador | timezone = Bahia Standard Time |
(UTC-02:00) Coordinated Universal Time-02 | timezone = UTC-02 |
(UTC-02:00) Mid-Atlantic - Old | timezone = Mid-Atlantic Standard Time |
(UTC-01:00) Azores | timezone = Azores Standard Time |
(UTC-01:00) Cabo Verde Is. | timezone = Cape Verde Standard Time |
(UTC) Coordinated Universal Time | timezone = UTC |
(UTC+00:00) Casablanca | timezone = Morocco Standard Time |
(UTC+00:00) Dublin, Edinburgh, Lisbon, London | timezone = GMT Standard Time |
(UTC+00:00) Monrovia, Reykjavik | timezone = Greenwich Standard Time |
(UTC+01:00) Amsterdam, Berlin, Bern, Rome, Stockholm, Vienna | timezone = W. Europe Standard Time |
(UTC+01:00) Belgrade, Bratislava, Budapest, Ljubljana, Prague | timezone = Central Europe Standard Time |
(UTC+01:00) Brussels, Copenhagen, Madrid, Paris | timezone = Romance Standard Time |
(UTC+01:00) Sarajevo, Skopje, Warsaw, Zagreb | timezone = Central European Standard Time |
(UTC+01:00) West Central Africa | timezone = W. Central Africa Standard Time |
(UTC+01:00) Windhoek | timezone = Namibia Standard Time |
(UTC+02:00) Amman | timezone = Jordan Standard Time |
(UTC+02:00) Athens, Bucharest | timezone = GTB Standard Time |
(UTC+02:00) Beirut | timezone = Middle East Standard Time |
(UTC+02:00) Cairo | timezone = Egypt Standard Time |
(UTC+02:00) Chisinau | timezone = E. Europe Standard Time |
(UTC+02:00) Damascus | timezone = Syria Standard Time |
(UTC+02:00) Gaza, Hebron | timezone = West Bank Standard Time |
(UTC+02:00) Harare, Pretoria | timezone = South Africa Standard Time |
(UTC+02:00) Helsinki, Kyiv, Riga, Sofia, Tallinn, Vilnius | timezone = FLE Standard Time |
(UTC+02:00) Jerusalem | timezone = Israel Standard Time |
(UTC+02:00) Kaliningrad | timezone = Kaliningrad Standard Time |
(UTC+02:00) Tripoli | timezone = Libya Standard Time |
(UTC+03:00) Baghdad | timezone = Arabic Standard Time |
(UTC+03:00) Istanbul | timezone = Turkey Standard Time |
(UTC+03:00) Kuwait, Riyadh | timezone = Arab Standard Time |
(UTC+03:00) Minsk | timezone = Belarus Standard Time |
(UTC+03:00) Moscow, St. Petersburg, Volgograd | timezone = Russian Standard Time |
(UTC+03:00) Nairobi | timezone = E. Africa Standard Time |
(UTC+03:30) Tehran | timezone = Iran Standard Time |
(UTC+04:00) Abu Dhabi, Muscat | timezone = Arabian Standard Time |
(UTC+04:00) Astrakhan, Ulyanovsk | timezone = Astrakhan Standard Time |
(UTC+04:00) Baku | timezone = Azerbaijan Standard Time |
(UTC+04:00) Izhevsk, Samara | timezone = Russia Time Zone 3 |
(UTC+04:00) Port Louis | timezone = Mauritius Standard Time |
(UTC+04:00) Saratov | timezone = Saratov Standard Time |
(UTC+04:00) Tbilisi | timezone = Georgian Standard Time |
(UTC+04:00) Yerevan | timezone = Caucasus Standard Time |
(UTC+04:30) Kabul | timezone = Afghanistan Standard Time |
(UTC+05:00) Ashgabat, Tashkent | timezone = West Asia Standard Time |
(UTC+05:00) Ekaterinburg | timezone = Ekaterinburg Standard Time |
(UTC+05:00) Islamabad, Karachi | timezone = Pakistan Standard Time |
(UTC+05:30) Chennai, Kolkata, Mumbai, New Delhi | timezone = India Standard Time |
(UTC+05:30) Sri Jayawardenepura | timezone = Sri Lanka Standard Time |
(UTC+05:45) Kathmandu | timezone = Nepal Standard Time |
(UTC+06:00) Astana | timezone = Central Asia Standard Time |
(UTC+06:00) Dhaka | timezone = Bangladesh Standard Time |
(UTC+06:00) Omsk | timezone = Omsk Standard Time |
(UTC+06:30) Yangon (Rangoon) | timezone = Myanmar Standard Time |
(UTC+07:00) Bangkok, Hanoi, Jakarta | timezone = SE Asia Standard Time |
(UTC+07:00) Barnaul, Gorno-Altaysk | timezone = Altai Standard Time |
(UTC+07:00) Hovd | timezone = W. Mongolia Standard Time |
(UTC+07:00) Krasnoyarsk | timezone = North Asia Standard Time |
(UTC+07:00) Novosibirsk | timezone = N. Central Asia Standard Time |
(UTC+07:00) Tomsk | timezone = Tomsk Standard Time |
(UTC+08:00) Beijing, Chongqing, Hong Kong, Urumqi | timezone = China Standard Time |
(UTC+08:00) Irkutsk | timezone = North Asia East Standard Time |
(UTC+08:00) Kuala Lumpur, Singapore | timezone = Singapore Standard Time |
(UTC+08:00) Perth | timezone = W. Australia Standard Time |
(UTC+08:00) Taipei | timezone = Taipei Standard Time |
(UTC+08:00) Ulaanbaatar | timezone = Ulaanbaatar Standard Time |
(UTC+08:30) Pyongyang | timezone = North Korea Standard Time |
(UTC+08:45) Eucla | timezone = Aus Central W. Standard Time |
(UTC+09:00) Chita | timezone = Transbaikal Standard Time |
(UTC+09:00) Osaka, Sapporo, Tokyo | timezone = Tokyo Standard Time |
(UTC+09:00) Seoul | timezone = Korea Standard Time |
(UTC+09:00) Yakutsk | timezone = Yakutsk Standard Time |
(UTC+09:30) Adelaide | timezone = Cen. Australia Standard Time |
(UTC+09:30) Darwin | timezone = AUS Central Standard Time |
(UTC+10:00) Brisbane | timezone = E. Australia Standard Time |
(UTC+10:00) Canberra, Melbourne, Sydney | timezone = AUS Eastern Standard Time |
(UTC+10:00) Guam, Port Moresby | timezone = West Pacific Standard Time |
(UTC+10:00) Hobart | timezone = Tasmania Standard Time |
(UTC+10:00) Vladivostok | timezone = Vladivostok Standard Time |
(UTC+10:30) Lord Howe Island | timezone = Lord Howe Standard Time |
(UTC+11:00) Bougainville Island | timezone = Bougainville Standard Time |
(UTC+11:00) Chokurdakh | timezone = Russia Time Zone 10 |
(UTC+11:00) Magadan | timezone = Magadan Standard Time |
(UTC+11:00) Norfolk Island | timezone = Norfolk Standard Time |
(UTC+11:00) Sakhalin | timezone = Sakhalin Standard Time |
(UTC+11:00) Solomon Is., New Caledonia | timezone = Central Pacific Standard Time |
(UTC+12:00) Anadyr, Petropavlovsk-Kamchatsky | timezone = Russia Time Zone 11 |
(UTC+12:00) Auckland, Wellington | timezone = New Zealand Standard Time |
(UTC+12:00) Coordinated Universal Time+12 | timezone = UTC+12 |
(UTC+12:00) Fiji | timezone = Fiji Standard Time |
(UTC+12:00) Petropavlovsk-Kamchatsky - Old | timezone = Kamchatka Standard Time |
(UTC+12:45) Chatham Islands | timezone = Chatham Islands Standard Time |
(UTC+13:00) Coordinated Universal Time+13 | timezone = UTC+13 |
(UTC+13:00) Nuku'alofa | timezone = Tonga Standard Time |
(UTC+13:00) Samoa | timezone = Samoa Standard Time |
timezone = local:America/Sao_PauloTime in computer BIOS should be set as UTC, not local time!
timezone = hawaii, local:Pacific/Honolulu
ntp
=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.orgTo disable NTP even if there's 042 DHCP parameter, specify in configuration file:
ntp = disable
skin
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.
background
background=ff0000,00ff00,3a6ea5,0000ffdefines backgound on first screen menu as red, on second screen - as green, on third screen - as default color, on fourth - as blue.
viterminal_licensing
SIP
SIP = user:password@sip.linphone.orgFor 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:0For more details about sound devices read this manual: wtware.com/docs5/sound.html
SIP = user:password@sip.linphone.org, nolockTo enable auto answering for incoming calls on terminal specify:
SIP = user:password@sip.linphone.org, auto-answerIf SIP server port differs from default 5060 for UDP and 5061 for TLS:
SIP = user:password@sip.linphone.org, port:55555You 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, nocertYou 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.wtcTurn on linphone logging into log. Possible values - from 1 to 6:
SIP = user:password@sip.linphone.org, debug:2Contact 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.txtTo change ring sound (WAV file should be stored in
Everyone
folder) specify:SIP = user:password@sip.linphone.org, wav:local.wav
SIP_usb_sound_level
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 = 100Volume of all microphone is configured only by
microphone_level
parameter. You may show volume control in popup window:SIP_usb_sound_level = 75, infobox
display
display = 1920x1080
display = 1920x1080, hdmi
display = 1920x1080, 42%
display = 1920x1080, hdmi, noddc
display = 1920x1080, hdmi, noddc, 75Hz
display = 1680х1050, "146.3 1680 1960 2136 2240 1050 1053 1059 1089"
M2_display
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
doubleclick
touchscreen
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
Autodetectvideo = VESA(F)
VESA, no widescreen modes!video = amd(F)
AMD GPUvideo = nouveau(F)
nVidia newvideo = i915(F)
Intel i915..newestvideo = radeon(F)
ATI newvideo = gma(F)
Intel GMA500/600/3600/3650video = aty128fb(F)
ATI Rage128video = atyfb(F)
ATIvideo = cirrusfb(F)
Cirrus Logicvideo = gxfb(F)
Geode GXvideo = gx1fb(F)
Geode GX1video = i810fb(F)
Intel i810, i815video = intelfb(F)
Intel i830..i945video = lxfb(F)
Geode LXvideo = hyperv_fb(F)
Microsoft Hyper-Vvideo = nvidiafb(F)
nVidiavideo = matroxfb_base(F)
Matroxvideo = radeonfb(F)
ATI Radeonvideo = rivafb(F)
nVidia RIVA 128/TNT/TNT2video = s3fb(F)
S3 Trio/Virgevideo = savagefb(F)
S3 Savagevideo = sisfb(F)
SIS/XGIvideo = tdfxfb(F)
tdfx voodoovideo = tridentfb(F)
Trident, VIAvideo = viafb(F)
VIA, S3 Unichromevideo = vt8623fb(F)
VIA VT8623 [CLE266]video = xgifb(F)
XGIvideo = ati(U)
ATIvideo = intel(U)
Intelvideo = modesetting(U)
Kernel modesettingvideo = nouveau(U)
Nvidiavideo = openchrome(U)
Openchrome for VIAvideo = sis(U)
SISvideo = vesa(U)
VESA, no widescreen modes!video = apm(X)
APM, Alliance Technologyvideo = ark(X)
ARK Logicvideo = chips(X)
Chips & Technologiesvideo = cirrus(X)
Cirrus Logicvideo = geode(X)
Geodevideo = glint(X)
GLINT/Permediavideo = i810(X)
Intel i8xx/i9xxvideo = mga(X)
Matroxvideo = nsc(X)
NSCvideo = rdc(X)
RDCvideo = rdcm12(X)
RDC M2012video = rendition(X)
Rendition/Micronvideo = s3(X)
S3video = s3virge(X)
S3 Virgevideo = savage(X)
S3 Savagevideo = sis(X)
SISvideo = tdfx(X)
3Dfxvideo = trident(X)
Tridentvideo = tseng(X)
Tseng Labsvideo = unichrome(X)
Unichrome for VIAvideo = xgi(X)
XGIvideo = vesa(X)
VESA Universal driverbpp
bpp
parameter determines color depth.bpp = 16 bpp = 32
kbdrate
kbdrate = 30,250And this line makes slow keyboard (2 repeats per second, 1000 milliseconds repeat delay):
kbdrate = 2,1000Possible 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.managed
managed = onAnd 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/24Terminals 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 rebootIf 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 updateTo turn off terminal run:
rsh.exe 192.168.10.50 shutdownInstead 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
httpd
httpd = 192.168.1.1, 192.168.1.2, 192.168.2.0/24Or turn off terminal http server:
httpd = offAt 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.
syslog
syslog = 192.168.1.1Or another port:
syslog = 192.168.1.1:9099
discover
discover = 192.168.1.1
keyboard_log
=off
keyboard_log = on
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 = onNext 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/24Popup 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=4to1This 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 timeoutterminal 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 timeoutwill show the same request, but if user won't react, in this case connection will be rejected.
vnc_password
vnc_password = 12345Password length is from 1 to 8 symbols. Allowed latin letters and digits.
vnc_password=hex:a0987527920893f174515708320c7fe3