List of parameters

• Terminal debugging
     syslog
• Selecting server and session parameters
     win2kIP, win2kIP2, win2kIP3, win2kIP4
• Session parameters
     user, password, domain
     shell, directory
     keyboard
     numlock
     graphic
• Using terminal periphery
     floppy, cdrom, usb1..usb10
     printer
     sound
     com1, com2
• Others
     clienthostname
     include
     turnoffmenu
     redraw_delay
• Terminal console parameters
     usbkeyboard
     mouse, mouse_wheel, mouse_accel_mult
     video
     resolution
     bpp
     refresh

Terminal debugging

• There's no programs without errors. If you think, that WTware terminal works incorrectly or you've found an error - create report for WTware techsupport. With your help we can make WTware better. In order to create report:
  
  
  1. Start WTware event viewer on any Windows-computer. Run "Start - Programs - WTware - Event viewer" (file wtcenter.exe from WTware zip-distribution utils directory).
  2. Set syslog parameter value in terminal cofiguration file (or in wizard.wtc file, if the error occured in "Terminal configuration wizard"). Parameter value should be IP-address of the computer where wtcenter.exe is working:

     syslog = 10.100.50.2

  3. Reboot terminal and try to reproduce the error. Terminal sends event log to wtcenter.exe and wtcenter.exe shows it on the screen. When you reproduce the error, press "Save to file".
  4. Send this event log file and description of the error to WTware techsupport.
  
  Using of syslog parameter slows down terminal work. So we don't recommend to use it without need.

Selecting server and session parameters

1. Connection to specified terminal server. Specify terminal server IP-address (or DNS-name if dhcp-server returns dns-server address):

   win2kIP = 10.100.50.2

2. [Only in WTware PRO] Search for the first available server. Terminal sequentially pings all the servers listed and connects to the first respondent. Server list is specified by these parameters:

   win2kIP = 10.100.50.2
win2kIP2 = 10.100.50.3
win2kIP3 = 10.100.50.4
win2kIP4 = 10.100.50.7

3. Connection to WTware cluster of terminal servers. For more details about cluster see this article:
   1. Autosearch of all the servers from common cluster:

      win2kIP = name:common

   2. Connect to acc cluster by scanning all the servers listed in file acc.iplist (acc.iplist text file should be in the same directory as all configuration files on tftp-server. This file should contain list of ip-addresses, one by line):

      win2kIP = name:acc, list:acc.iplist

4. [Only in WTware PRO] Selection from menu. Address can be both definite server (ip-address or DNS-name) and cluster. Its syntax is similar to 1, 2, 3 items. After address can be keyword opt: and configuration file name. This configuration file settings are used when user selects corresponding menu item. So different terminal settings can be specified for different servers. For more details about configuration file inclusion see include option. Unlike include parameter, settings from files, included by opt: keyword, underlie settings in main configuration file. After comma should be comment, that user sees in menu. It's obligatory to specify comments.

   win2kIP = name:acc, list:acc.iplist, opt:acc.cfg, Accounts department
win2kIP2 = name:finance, Finance department
win2kIP3 = 10.100.50.4, opt:inet.cfg, Internet server
win2kIP4 = 10.100.50.7, Workplace
   

Session parameters

• By default user should specify login, password and domain (if terminal server is included into domain) in "Windows login" window when terminal starts. Set these values in configuration file to simplify user life. Possible values:
  
  
  1. Definite values. Specified parameters are set automatically in login window. You can specify any of these parameters - user, password and domain:

     user = vasyapupkin
domain = MYDOMAIN
password = coolpassword

  2. Selection from menu. User can select login parameters from menu. Possible values for login parameters:

     DOMAIN\user:password
user:password
DOMAIN\user
user

     These blocks are separated by semicolons. For example, this line creates menu with 5 items (users vasja and peter from DOMAIN2, vasja's password is 'joke', john's password is '1'):

     user = DOMAIN2\vasja:joke;DOMAIN2\peter;john:1;july;Guest

     You can create as many items as can be placed on the screen. Terminal automatically shows them in columns.



• [Only in WTware PRO] 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).



• [Only in WTware PRO] 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




• keyboard parameter determines default keyboard layout in "Windows login" window. Default value is english layout, also you can set german:

  keyboard = de




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

  numlock = off




• [Only in WTware PRO] 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 some of these symbols:

  a - desktop wallpaper
  b - show window contents while moving
  c - visual effects for menus and windows
  d - themes

  Set parameter value as a sequence of symbols corresponding to the options you want to turn on. For example, to add all options:

  graphic = abcd

  To show 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.

Using terminal periphery

• [Only in WTware PRO] You can access terminal floppy-disk, USB-disks and CD-ROM. To enable device redirection set corresponding parameter to on or samba. This value determines disk redirection way.
  
  
  • Value on means, that RDP protocol is used for redirection. We recommend to use this value. Windows 2000 Server doesn't support this way of redirection. Use samba value. In current terminal session disk is available at: \\tsclient\{floppy|cdrom|usbN}. Sometimes (not always, reasons not established) 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).
    
    While using terminal disks user should connect and disconnect disks manually. After inserting disk, floppy or USB-disk 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. This is the only safe way of working with terminal disks. In two years of experiments with automatic disk connection we decided to give up using different automatic ways. Any automatics always leads to some problem.
    
    
  • Value samba makes terminal 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\{floppy|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 floppy-disk set:

  floppy = on

  or

  floppy = samba

  To access terminal CD-ROM set:

  cdrom = on

  or

  cdrom = samba

  If you use no more than one flash-card at once, set only usb1 = on or usb1 = samba. All other parameters are needed for card-readers, that work with various cards, or to work with several cards at once:

  usb1 = on or usb1 = samba
usb2 = on or usb2 = samba
usb3 = on or usb3 = samba
usb4 = on or usb4 = samba
usb5 = on or usb5 = samba
usb6 = on or usb6 = samba
usb7 = on or usb7 = samba
usb8 = on or usb8 = samba
usb9 = on or usb9 = samba
usb10 = on or usb10 = samba




• 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 = on

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

  printer = lpt

  one-way data communication with printer, lpt parameters autodetection.

  printer = lpt-bi

  two-way data communication with printer, lpt parameters autodetection.

  printer = usb

  [Only in WTware PRO] one-way data communication with printer, USB printer.

  printer = usb-bi

  [Only in WTware PRO] two-way data communication with printer, USB printer.
  
  Mode -bi use only if it is really necessary.
  
  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.
  
  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. For example, Canon LBP810 and HP1005.
  .
  
  If server_only is specified after printer type, terminal ignores all other parameters and simply works as print-server. For example, printer = lpt,server_only.



• [Only in WTware PRO] Windows 2003 Server or Windows XP can redirect sound from server to terminal sound card. Keep in mind, that playing Winamp takes up to 500KBps, i.e. up to half of 10Mbit network bandwidth. Unfortunately, 1-3 seconds delays while playing sound are unavoidable.

  Windows 2000 Server doesn't support sound redirection.

  In order to redirect sound to terminal set:

  sound = on

  Next line leaves sound on server, i.e. makes server sound card to reproduce sound:

  sound = remote

  By default sound redirection is turned off. If you set proper parameter in configuration file, but an error occures while playing sound or sound is not reproduced - please, make sure, that terminal server settings allow client sound redirection. Try to redirect sound to Windows-computer using standart Microsoft terminal services client (Start > Programs > Accessories > Communications > Remote desktop connection).

  Windows 2003 Server redirects sound only if you set to "Enabled": Start > Run > gpedit.msc > Computer configuration > Administrative templates > Windows components > Terminal services > Client/Server data redirection > Allow audio redirection.




• [Only in WTware PRO] Serial port redirection is far from perfection in Windows 2003 Server. For example, available redirection doesn't allow to connect to Internet via COM-port modem on terminal. But for some tasks it will do.

  Windows 2000 Server doesn't support serial port redirection.

  Better test your device on Windows-computer using standart Microsoft terminal services client before attaching it to WTware terminal COM-port.
  
  In order to redirect serial port COM1 to terminal set:

  com1 = on

  To redirect COM2:

  com2 = on

  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. Similarly rename COM2 to COM12. Reboot server.
  
  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's 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.

Others

• 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

  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.



• include option helps to move all duplicated parameters into one (two, three...) common files:

  include common.wtc

  Terminal requests TFTP-server for specified file (that should be in configs directory, containing all configuration files) and includes all parameters in this file. Included file format should be similar to main configuration file format. Any parameter can be moved to included files. The amount of includes in main configuration file is optional. Include can't be used in included files. Main configuration file parameters always underlie parameters in included files.



• 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 win2kIP 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 win2kIP and user parameters.


• 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.