Skip to main content

Install a Legacy Frends Agent on Windows

How to install a Legacy Frends Agent in Windows (Frends 5.6)

Ossi Galkin avatar
Written by Ossi Galkin
Updated over 2 years ago

Before you can install an Agent, you need to configure it, as well as the Environment and Agent Group in the Frends UI. Also, if you are installing the Agent in a HA Environment the Agent needs a working connection string given to it in the settings and possibly a load balancer.

Install a Legacy Frends Agent on Windows

  • Download the Agent from the Environment View by clicking the download icon on the Agent

  • After downloading the Agent copy the Agent installer package to your chosen server and un-zip the installer package to a temporary location. It's a good practice to archive the Agent installer packaged on the server if you might want to re-install the Agent later, though you can also always download the installer from the Frends Environment View.

  • The un-zipped installer package should have two files: a config file and the Frends.Agent.Installer.Bundle. Double click the Frends.Agent.Installer.Bundle to start the installation.

  • In the installer you can set the installation location through the options menu. By default, the installer installs under C:\Program Files\HiQ Finland\FRENDS Agent.

  • After accepting the Terms and Conditions click the "Install" button to start the installation

  • If the installation was successful, you are now done! You have a working Frends Agent installed on your server and you can start deploying and executing integrations with it.

  • You should now be able to see the Agent appear online in the Environment View:

  • You are able to view the current status of the Agent and read an Event Stream from the Agent to detect or debug any issues remotely through the Frends UI.

Debugging Installation Problems

Wrong username or password

If you get the following error: Failed to create user. ({error reference code} {Your Agent username}, there is most likely something wrong with the user account you provided the Agent with. To solve this, go through the following list:

  • Confirm that the username and password are both correct

  • Check that the Agent user is part of the local "Administrators" group.

  • Make sure that in the Windows "Local Security Policy" settings under "User Rights Assignment" the Agent user has the following rights set: Log on as a service and Log on as a batch job

Did this answer your question?