Skip to content

Installing and updating agents

Agents are installed through a separate setup process. Each versiondog software package includes the agent setup file by default. You can find the AgentSetup.exe file in the server’s installation directory.

Installation requirements

  • The agent is licensed.
  • The agent setup file is available.

  • Do not install agents on a computer running a versiondog server.

  • Starting with versiondog 9.0, agents cannot be installed on Windows XP.

  • The user or account running the installation has administrative rights.

Info

If the user running the agent lacks sufficient permissions for the default program directory, you can install the agent in an alternative location. For example, instead of C:\Program Files\vdAgents, use a path such as D:\vdAgentArchive\vdAgents or D:\vdAgents.

Procedure

  1. Run the AgentSetup.exe file as an administrator on the target computer.
  2. In the installation wizard that opens, choose the language. English and German are currently available.
  3. On the welcome page, select Next.

  4. Specify the directories for the agent program files and the agent archive.
    You can either enter the paths manually or select the ... button to browse and select a path.
    We recommend using the default paths suggested by the installation wizard:

    • C:\Program Files\vdAgents
    • D:\vdAgentArchive

  5. Select Next.

  6. Choose the user account that will run the versiondog services.
    You can select either Local system account or Username.
    We recommend selecting Username and specifying an account with administrative rights on the client PC.

    Info

    The installation must be performed using an account with administrative rights.
    The local system account may not have the necessary permissions.

  7. Select Next.

  8. Review the summary and verify your entries. If everything is correct, select Next to begin the setup.
    A confirmation message appears when the installation is complete.
  9. Select 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 change the account for VDog CompareAgent and VDog UploadAgent?

Uploads for some devices (e.g., Atlas Copco tightening system controllers or SIEMENS TIA Portal) may fail if the VDog UploadAgent and VDog CompareAgent services are running under the Local System account.

To change the user account for a service:

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

  2. In the Services window, locate VDog UploadAgent and VDog CompareAgent to check which account they use. If either is running under Local System, uploads will not work.

    Figure: VDog MasterService, Account

  3. Right-click VDog UploadAgent or VDog CompareAgent, and select Properties.

  4. Go to the Log On tab and choose This account.

    Figure: Properties of VDogMasterService, Login tab

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

  6. Select OK.
  7. In the Services window, select VDog UploadAgent or VDog CompareAgent.
  8. Select Restart to apply the new settings.