Skip to content

Installing and updating agents

Agents are installed via a separate setup. The setup file for agents is included as standard in every versiondog software package. The AgentSetup.exe file can be found in the installation directory of the server.

Requirements for the installation

  • Licensing of the agent has been completed.
  • The agent setup file is accessible.

  • Agents must not be installed on the same computer on which a versiondog server is already running.

  • As of versiondog 9.0, no agents may be installed on Windows XP operating systems.

  • The user or the user account from which the installation is carried out has administrative rights.

Info

If the user under which the agent will run does not have sufficient rights in the program directory, the program directory of the agent can also be stored in another directory instead of C:\Program Files\vdAgents, e.g. D:\vdAgentArchive\vdAgents or D:\vdAgents.

Procedure

  1. Execute the AgentSetup.exe file on the computer intended for the installation as administrator.
  2. The installation wizard opens.
  3. Select a language version. English and German are currently available.
  4. On the welcome page of the installation wizard, select Next.

  5. Specify a directory for the agent program files and a directory for the agent archive. The directory can be entered directly or selected via selection ....

    Figure: Installation wizard, specifying paths for program files and AgentArchive

    We recommend keeping the paths suggested in the installation wizard: - C:\Program Files\vdAgents - D:\vdAgentArchive

  6. Select Next.

  7. Specify the user account from which the versiondog services will be started. You have the choice between the options Local system account and Username. We recommend selecting the Username option and specifying an account with administrative rights on the client PC.

    Figure: Installation wizard, user account specification

    Info

    The installation can only be carried out using a user account with administrative rights. The system account may not have the necessary rights.

  8. Select Next.

  9. A summary is displayed.

    Figure: Installation wizard, summary

  10. Check your entries. If everything is correct, select Next. The setup is executed. A message is displayed when the installation process is complete.

  11. Click Finish to close the wizard.

Updating agents

If the agent service has read and write access to its program directory, the agents are automatically updated as soon as the server is updated, e.g. when a job is executed.

FAQ

How do I create an administrator account for the VDog MasterService?

The upload for some devices (for example: Atlas Copco tightening system controllers or SIEMENS TIA Portal) may not work if the VDog MasterService, VDog UploadAgent and VDog CompareAgent services are running under the Local System user account.

To change the user account that runs a service:

  1. Open Windows Services by pressing the Windows key + R and then enter services.msc in the dialog Run.

  2. Search for the VDog MasterService and check under which account it is running. If it is running under Local System, the upload will not work.

    Figure: VDog MasterService, Account

  3. Right-click on the VDog MasterService and select Properties to modify the account.

  4. Open the tab Log On and select the option This account.

    Figure: Properties of VDogMasterService, Login tab

  5. Enter account name and password, and then confirm the password.

  6. Click on OK.
  7. In the dialog Services, click on the VDog MasterService and then click on Restart to execute the service with the new settings.