Multiuser configuration

In standard Tovek Tools installation it is assumed that only one user uses the computer and so all the the user's settings are stored in one location within the tovek tools installation, in the <tt>\user folder, and this location cannot be changed.

This standard mode can be changed in order to allow more user to share one machine and also to allow one user to work from any computer on the network, preserving all user's settings from one session to another or according to the policy set by the administrator. All settings are stored in folders on the network and not in the system registry. This is called multiuser configuration and it is controlled by the file _multi_u.cfg in the user folder of the installation; for a typical default setup it is:
C:\Program Files\TvkTools\User\_multi_u.cfg

This file controls two things: where is the folder with user's settings, and what to do with this folder when Tovek Tools starts.

Example of the _multi_u.cfg file with explanation below:

[Multiuser] ConfigType = 1 [Type1] UserDir = U:\settings\tt CopyOption = 1

First option is the type of configuration and there is only one mode for now, the mode number one. The rest is in the section [Type1]. UserDir says where is the folder with the user's settings and CopyOption controls the action to be performed when Tovek Tools is launched. The path should be entered as drive:\folder(s) and it is assumed that the drive is "home" drive of the user, ie that the U: drive in the example above points for every user to a different folder on a file server.

Value for CopyOption can be 0 to 4, default is 0. Description of each value is following:

0	When Tovek Tools is starting it checks whether the UserDir exists. If it does not exist an error message will be shown and the program will not start; otherwise no further action is performed and the user folder is left intact.

Actions for values 1 to 4 have the same first step: if the folder UserDir does not exist it will be created, possibly including subdirs (ie the full path will be created, not only one folder at one level). If this action fails, Tovek Tools will display an error message and will not start. Then the next action depends on the CopyOption:

1	If the UserDir is empty - without one single file - the contents of the <tt>\user folder will be copied into it, without the _multi_u.cfg file. This way the user dir will be initialized for the first time for a given user; during subsequent program launches, if the UserDir is not empty, no changes will be made to this folder. This option is called one-time init.
2	Action is the same as for the previous value but the copying is performed every time Tovek Tools starts. However, no replace is allowed, so the existing files do remain the same.
3	Similar to value 2, but the existing files will be replaced.
4	This setting specifies that the UserDir will be purged before copying; copying is then the same as for the other options.

There might be a reason to use options 3 and 4 but when these are specified it should be clearly understood what is their effect.