-> WTware in Russia

Terminal tuning

This manual describes next step after selecting terminal boot way. If you've not selected WTware boot way yet and haven't started the terminal read the manual about WTware boot.


Configuration file

Terminal settings are stored in configuration files. These files are ordinary text files, they can be edited by any text editor, Notepad will do. All possible parameters and their values are listed in the configuration file parameters manual.

Full terminal configuration is the union of parameters from:

  • Common configuration file all.wtc
  • Included files listed in list.wtc
  • Terminal configuration file

If terminal finds its MAC-address in list.wtc or its configuration file it tries to connect to terminal server. Otherwise terminal configuration wizard starts.


Common configuration file

Common configuration file name is all.wtc. Terminal searches for it from configs directory to tftp root. Parameters with common for all terminals values should be placed in all.wtc file. For example win2kip parameter.


Included files list

Included files list is stored in configs/list.wtc file. Syntax:

01.02.03.04.05.06[([username@][terminalname])] [file [file ...]]] [# comments]
For example:
02.03.04.05.06.07 file1
Terminal with MAC-address 02.03.04.05.06.07 reads parameters from configs/file1 file.
03.04.05.06.07.08(john@) file2
Terminal with MAC-address 03.04.05.06.07.08 reads parameters from configs/file2 file and sets username "john" in Windows login window.
04.05.06.07.08.09(term5) file6 file7 # Chief computer.
Terminal with MAC-address 04.05.06.07.08.09 is named term5 (similar to clienthostname parameter). It reads configuration from configs/file6 and configs/file7 files.


Terminal configuration file

Terminal configuration files are stored in configs directory corresponding to current WTware version and build. If you installed WTware with the help of setup then, for example, WTware PRO version 4.1.32 configuration files are located in C:\Program Files\WTware\TFTPDROOT\PRO\4.1.32\configs\

Each terminal configuration is usually stored in two files. Pay attention to include option that helps to include additional configuration files with common contents for a group of terminals.

  1. When terminal amount is not very large (up to 100) and you can identify computer, its location and configuration by its name, it's very convenient to name configuration files as - terminalname.wtc. Terminal name is set by DHCP-server. For more details about DHCP configuration see DHCP Reservations, 012 parameter value. For example, if terminal name is set to:

    or in Unix DHCP:

    option host-name "fold/term22";

    then the terminal searches for its configuration in the file C:\Program Files\WTware\TFTPDROOT\PRO\4.1.32\configs\fold\term21.wtc. If terminal name is not set by DHCP-server (i.e. 012 parameter value is not specified), then the terminal doesn't search for its configuration if such file.

  2. MA.CA.DD.RE.SS.TE.wtc - classic naming way used in previous WTware versions. It's should be used when there are a lot of terminals and for their identification external database is used. For example, to the terminal with network card MAC-address 00:01:02:aa:bc:8e corresponds configuration file 00.01.02.AA.BC.8E.wtc. Pay attention to letter case if your TFTP-server is located on a Unix-computer!


File reading order, parameter values priority

Terminal reads configuration files in this order:

  1. all.wtc
  2. Files listed in list.wtc
  3. Files included by include directory in terminal configuration file
  4. Terminal configuration file

Parameter value is overwritten as new value becomes available. I.e. if win2kip parameter value is specified both in all.wtc and in terminal configuration file, value from terminal configuration file is used.


Terminal configuration wizard, WTwizard

When you:

(1) used setup to install WTware,
(2) specified DHCP 074 parameter (or specified WTwizard parameter either in "CD Image generator" for terminal boot from CD-ROM or in "Terminal configuration" menu for terminal boot from IDE and USB-flash),
(3) haven't created configuration file yet,
then the first terminal screen will be:



It means that the terminal connected to WTwizard service. This service helps to configure the terminal. "Terminal configuration wizard" main screen:


WTwizard, main screen

When there's at least one successfull test, "F10 Generate configuration" item appears. Failed tests are marked red. Successfull tests are green, number value is test execution time. Successfull test ends with such screen:



The smaller value the faster terminal works with selected driver in selected mode.

Configuration wizard creates configuration file when you press F10. Configuration file is generated for the best result values. Wizard automatically generates two files Standart MA.CA.DD.RE.SS.TE.wtc file contains single line:

include MA.CA.DD.RE.SS.TE.graphic. This line makes the terminal include MA.CA.DD.RE.SS.TE.graphic file parameters.

>MA.CA.DD.RE.SS.TE.graphic file contains all generated parameters. Now wizard is able to store only console parameters (video driver, screen mode, mouse). All other parameters (at least, required win2kIP) parameter value - terminal server address) should be set in MA.CA.DD.RE.SS.TE.wtc file as usual. File .graphic is needed to prevent the parameters in MA.CA.DD.RE.SS.TE.wtc file from overwriting during next wizard configuration regenerations.

To be continued

Configuration file parameters are responsible for terminal disks and printers using, login menu configuration, desktop background etc. Full parameter list and their descriptions are available at the next article.



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