Ehorus: Documentation: Installing eHorus on Windows

De eHorus Wiki
Saltar a: navegación, buscar

Go back to eHorus documentation index

1 Installing eHorus on Windows

Download the Windows agent (32 or 64 bit) from our webpage:

You’ll need to provide administrator permissions in order to install the eHorus agent. Once downloaded, run the installer. This agent has been tested on all available versions of Windows (from Windows XP to Windows 10). Since the installer is unsigned, you may get an installation warning. It’s normal, ignore it and proceed with the installation.


Accept the prompted dialogue box and proceed with the installation.



Click on Typical to make a normal installation. To change the default install folder, click on Custom.


This dialog is displayed only on Custom installations.


On this screen you’ll need to introduce the username that you have on the eHorus platform so that the agent can provision and be used correctly.

More importantly, you can set an agent password for this installation. This password can be added or modified afterwards. To establish a password at this point, introduce it on the textbox at the end of the page.


The installation is almost complete. You’ll be asked if you’d like to start up the eHorus agent on that device and add an icon to the desktop. If you’ve correctly configured the agent (by inserting the provisioning user) and the agent has an Internet connection, you can now boot and begin to use eHorus.



Successfull installation


When launching the agent for the first time, it’ll take a few seconds to load. Internally the agent will launch some command line windows (black screens) which will close by themselves in a matter of seconds. When this is over, you can see it on the installer itself.

You should be able to see the eHorus status icon on the Windows notification deck:


The green icon means that the agent is running and is provisioned. If it's red it means that it could not be provisioned. Right click on the icon to view some options:


You will only be able to stop/reset eHorus subcomponents if you’ve launched the eHorus manager (Ehorus Agent Menu) with Administrator privileges. A user without these privileges will NOT be able to stop eHorus or change its configuration. If “show EKID” is pressed, you’ll be able to see the EKID corresponding to that device. The EKID is a unique number for each host managed by eHorus.


This device, already provisioned and connected, has to be visible on your eHorus portal, ready to be externally managed.


The eHorus agent has been installed as a service. This means that the device, even if reset, will pull up eHorus’ services again, and will continue to remain available.

1.1 Optional: Installing the Mirror driver

The mirror driver is a third party software application that can be installed on the host to accelerate data viewing. It improves performance by approximately 25%.

It isn’t installed with eHorus by default because it is a third party tool, although its use is free and open. To use it, you only need to install it and reset the device. You can download it here:

This driver is compatible with the following versions of Windows:

  • Windows 2008 R2
  • Windows 7
  • Windows 2008
  • Windows Vista
  • Windows 2003
  • Windows XP
  • Windows 2000

Other untested versions (windows 10)

1.2 Unattended install on Windows

You need to execute the installer as administrator from the command line:

msiexec /i ehorus_agent_installer.msi /q PARAM1="value2" PARAM2="value2" ...

There are various optional parameters, e.g.

msiexec /i ehorus_agent_installer.msi /q EHUSER="userXXX" 
EHPASS="5555" EHORUSINSTALLFOLDER="C:\path\to\install"


  • EHUSER: eHorus user
  • EHKEY: unique key
  • EHPASSWORD: agent password
  • EHPASS: agent password.
  • EHORUSINSTALLFOLDER: the file where the agent will be installed (by default: C\Program Files\ehorus_agent)
  • STARTEHORUSSERVICE: Launch the agent when the installation ends (1 by default).
  • DESKTOPSHORTCUT: Create a desktop shortcut (1 by default).


eHorus silent installation requires Administrator privileges.

Hyphens and dashes are special characters reserved for MSI installers, and must be escaped. In the example EHKEY they are escaped, because in order to run the string literally it is necessary to include double quotation marks.

EHORUSINSTALLFOLDER should not include single quotation marks except the ones already there. The spaces should only be respected in regards to double quotation marks, which are always necessary.

.NET framework 4.0 is required on Windows XP and Windows Server 2003.

1.3 Update Windows agent

As with other platforms (Linux, Mac) the Windows agent can be updated centrally from the WEB console. If you wish to update it manually it can be done with the installation package. The system detects the software update and won't overwrite the configuration files, automatically updating only the code.

1.4 Updating the Windows agent

Just like with the rest of platforms (Mac OS/Linux), the Windows agent can be updated in a centrally from the WEB console, but if you wish to update it manually, you can do so with the same installation package. The system will detect that you’re updating the software and won’t overwrite configuration files, automatically updating only the code.

1.5 Using agents in stand-alone mode in Windows

Windows supports a mode that does not require you to install any software in order to control the Windows system in question. Using stand-alone mode you can control the client's machine by simply following these steps:

1. Download the stand-alone agent for Windows (32 or 64) at It is a .ZIP file containing an executable and a directory.


2. Execute the "eHorus Standalone".


3. Introduce the "username" of the user who has access to eHorus and is going to connect to your computer (you).


The program won't be installed, only executed. It generates an individual EKID (an IDfor each execution and a randomly generated password. These two steps (ID and password) give you access to your computer:



Click on "Disconnect" when you finish and the agent will stop and no-one else can connect. The agent is not installed on the system and can be deleted from the file. No data will be saved.