INI files

In versiondog certain settings can be done via the INI files.

The entries of the INI files are divided into sections and have the format <key>=<value> in the section.

server sided: this means you can edit the INI files for all clients in the module INI files. This is located in the AdminClient.

client sided: this means you need to make direct changes to the settings in the individual files. You can create and edit the files using an editor, such as Notepad, in the appropriate folder (i.e. vdClientArchive or vdAgentArchive).

Editing INI files

  1. Start the AdminClient, click on the Help tab and then select the option INI files.
  2. The window Edit ini files will then open.
  3. Select the appropriate INI file and click on the button Edit.
  4. In the case that the required INI file in the module is not available, you can create this with the file manager in the server archive.

  5. In the INI file, select the section for the device type for which you want to make settings. If the section is not present, create it.
  6. Create the desired setting using the format <Key>=<Value>.
  7. Example:

    [Common]
    5543=N
    5508=
    5509=D:\\vdServerArchive\vdog client setup
    5521=D:\\vdServerArchive\vdog agent setup
    5501=de
    5539=Y
    5502=Y
    5601=Y

  8. The settings, that you have undertaken in the INI files in AdminClient, will be automatically applied by the versiondog client applications as soon as a user logs on to the server or the client application has been updated with the server.

Available additional settings

General settings

Path:

<Drive: >\vdServerArchive\VD$A\Configuration

File:

Server.ini

Search for the section [Common]

Key

Description

Possible values

5500

Directory for temporary files

[TEMP_DIR_OS] (Temporary Window's directory)

[RootDirAdmin] (Temporary versiondog directory)

<Drive>:\directory name

5501

Language

e.g. DE/EN/CZ/DE/IT

5516

Only open one editor simultaneously

Y/N

5517

Client's login history

Y/N

5519

Update interval of background processes

1-1440 (Minutes)

5520

Update all components

Y/N

5523

File manager option

Path to the exe-file of the file manager

5524

Comment basis version

Y/N

5532 Authenticate clients via versiondog Server Y/N
EnableOldBeforeEditBehavior Script BeforeEdit is called only once after the selection dialog is displayed Y/N

Settings for the section [CheckInCheckOut]

Key

Description

Possible values

5620

Carry out detailed comparison during Check-In

Y/N

5621

Performing a rollback, if the Check-Out process fails

Y/N

5623

Delete component locally after Check-In

Y/N

5624

Maximum number of local archives after Check-In

{0,1…n} (At 0 no archives will be deleted)

5625

Default mode upon Check-Out

0 (no default)

1 (under development)

2 (lock for other users)

Can be changed by the user

5626

Force mode upon Check-Out

0 (no default)

1 (under development)

2 (lock for other users)

Can NOT be changed by the user

Examples for the file ClientConfigUpdate.ini

By deleting the entry in the file ClientConfigUpdate.ini, this will not delete it from the client's INI files. In order to deactivate an entry from an INI file, the selected entry has to be entered into the file ClientConfigUpdate.ini ein "-".

Please keep in mind that entries in the file ClientConfigUpdate.ini are correct! If this is not the case, this can have limit the client's function! Please check the resulting changes.

Device-specific upload types

Device-specific settings are also still available for the individual upload classes. These settings can be found in the tutorial for the corresponding device. It contains the name and path to the INI file that needs to be edited, the section, the key, possible values and default values.

FAQ: I have changed the settings in the INI files. versiondog is no longer working. What should I do?

If versiondog no longer works when settings have been added to the INI files, the files were most likely saved with the coding UTF-8 using BOM. In order to make version workable again, you will need to save the INI files using another coding. (In order to save INI files using the coding UTF-16 with BOM, you will need to edit the file using an edition to enable this setting, e.g. Notepad ++).

To FAQ list

FAQ: Is it possible to change the configuration of a client computer using the versiondog server?

Client computers can be configured in the versiondog AdminClient. In the AdminClient, open the module INI Files then the file ClientConfigUpdate.ini. Here, you can select the settings for one or all client computers (See Examples). For example, you have the option to adapt certain work-flows to schedules at your company.

Example: you want that to delete components after every Check-In on client computers.

Add the following entry under [Configuration\Client.ini|[ClientConfigUpdate.ini]:

5623=Y

To FAQ list