Installing the HEIMDAL Agent (Windows) – Heimdal Assistance and Support

In this article, you will find the steps that you need to perform in order to install the HEIMDAL Agent on a Windows machine using the Full Installer, the Delivery Launcher (online installer), the silent installation method, and the silent installation method if your computer is configured to use a proxy.

1. Installing the HEIMDAL Agent
2. Installing the HEIMDAL Agent using the Delivery Launcher (online installer)
3. Installing the HEIMDAL Agent silently
4. Installing the HEIMDAL Agent silently with Proxy configuration

Installing the HEIMDAL Agent

1. Log in to the HEIMDAL Dashboard (Production or RC) and download the HEIMDAL Agent (full installer, ~16 MB in size) from the Guide section -> Download and Install tab:

2. Locate the HeimdalLatestVersion.msi file on your computer.
3. Run the HeimdalLatestVersion.msi file with Administrator permissions.
4. Select the desired language of the HEIMDAL Agent and press Next.

5. In the installation wizard, scroll down and read the Terms and Conditions, then press the I agree button (which will become available after you scroll down).

6. Choose the install location and choose whether to add a shortcut to the Desktop or not. Press Next.

7. Insert the HEIMDAL license key provided by your Account Manager and press Next.

8. If your HEIMDAL license key is correct, you will receive the Almost there... message, and get information about the type of license you have and its corresponding expiration date. Click on Install to finish the installation process.

9. Once the installation process is completed, click Finish to start the HEIMDAL Agent.

When the HEIMDAL Agent starts, the HEIMDAL icon will be displayed in the System Tray.

Installing the HEIMDAL Agent using the HEIMDAL Delivery Launcher (online installer)

1. Download the HEIMDAL Delivery Launcher (online installer) from our Heimdal Dashboard (Guide section -> Download and Install tab) or from our server: MSI or EXE.
2. Locate the Heimdal_Thor_Launcher.msi (if you downloaded the MSI file) / Heimdal.SetupLauncher.exe (if you downloaded the EXE file).

3. Run the Heimdal_Thor_Launcher.msi / Heimdal.SetupLauncher.exe file. Windows will prompt the UAC (User Account Control) security warning and you have to click on YES to proceed to the next step.

4. Once you accept, HEIMDAL Delivery Launcher will initiate the installation process and will display the following window:

*If the .NET Framework 4.8 is not already installed, the HEIMDAL Delivery Launcher will automatically download and install it. Sometimes, the .NET Framework 4.8 requires a computer reboot. If the .NET Framework 4.8 is already installed, the HEIMDAL Delivery Launcher will proceed with the download of the HEIMDAL Agent MSI Installer (full installer) and run it. This does NOT apply to the full agent .MSI-based installation.

5. Select the desired language of the HEIMDAL Agent and press Next.

6. Scroll down and read the Terms and Conditions, then press the I agree button (will become available after you scroll down).

7. Choose the install location and choose whether to add a shortcut to the Desktop or not. Press Next.

8. Insert the HEIMDAL license key provided by your Account Manager and press Next.

9. If your HEIMDAL license key is correct, you will receive the Almost there... message, and get information about the type of license you have and its corresponding expiration date. Click on Install to finish the installation process.

10. Once the installation process is completed, click Finish to start the HEIMDAL Agent.

When the HEIMDAL Agent starts, the HEIMDAL icon will be displayed in the System Tray.

Installing the HEIMDAL Agent silently

1. Log in to the HEIMDAL Dashboard (Production or RC) and download the HEIMDAL Agent (full installer) from the Guide section -> Download and Install tab:

2. Open Command Prompt (cmd in Start) as an Administrator and change your path to where the HEIMDAL MSI Installer is located. After this step, run:

msiexec /i Heimdal.msi heimdalkey="2aaaa-2asaac-aaaaaa2-2aaaa" /qn

msiexec /qn /i Heimdal.msi heimdalkey="2aaaa-2asaac-aaaaaa2-2aaaa"

depending on the build of Windows used.

Note: The 2aaaa-2asaac-aaaaaa2-2aaaa license key needs to be replaced with your HEIMDAL license key.

3. After the installation process finishes, you should be able to see the HEIMDAL processes starting in Task Manager:

*Note: A reboot of the machine is recommended after the installation is completed

Installing the HEIMDAL Agent with Proxy configuration

Before downloading and installing the HEIMDAL Agent, you need to configure the Proxy settings on the Group Policy that will be assigned to the computer that is configured to use Proxy. Follow the steps below to set up the Proxy configuration in the HEIMDAL Dashboard and install the HEIMDAL Agent.

1. Log in to the HEIMDAL Dashboard (Production or RC), click on Endpoint Settings, and select the Group Policy that follows to be configured. From the Group Policy page, in the General tab, you can configure your Proxy settings as shown below:

*The Domain input should be the internal proxy domain.
**The above picture is an example, you should write there your own proxy information and not copy them from the picture
The Proxy settings are usually found in the Internet Explorer properties:

Use system default - the HEIMDAL Agent will automatically pick up the Proxy settings from the computer's Internet Settings. If this option is enabled, the HEIMDAL Agent will impersonate the user that is currently logged in on the computer to pick up the Proxy configuration. If no user is logged in, the HEIMDAL Agent will not be able to collect the Proxy information.
No Proxy - the user does not use a Proxy or the user uses an NTLM Proxy with the HEIMDAL domains added to the Proxy whitelist;
Manual Proxy - the user needs to manually add the Proxy information for the Host, Port, Domain, Username, and Password.

2. After you've set up the Proxy configuration, update the Group Policy settings by scrolling down and pressing the Update GP button.
3. The next step is to download the HEIMDAL Agent from the Guide section (left menu) -> Download and Install tab:

4. In order to install the HEIMDAL Agent on a computer using a Proxy Server, you need to use additional installation parameters that will allow the HEIMDAL Agent Wizard to communicate through the Proxy Server. Open Command Prompt (cmd in Start) as an Administrator and change your path to where the HEIMDAL MSI Installer is located. After that, run the following command line to install the HEIMDAL Agent:

A. Installing the HEIMDAL Agent with Manual Proxy configuration

msiexec /qn /i Heimdal.msi heimdalkey="keygoeshere" proxy="Address=x.x.x.x Port=xy Username=xxxxx Password=xxxxx Domain=your_domain.com"

You need to replace the Address and Port parameters with the exact IP Address and Port of the Proxy Server. These arguments are mandatory, while the Username, Password, and Domain arguments are optional and you need to replace them with your proxy credentials (if the Proxy Server's authentication requires such authentication).

*Note: A reboot of the machine is recommended after the installation is completed

B. Installing the HEIMDAL Agent with no proxy configuration

This option is designed to be used when the user does not use a proxy or when the user uses an NTLM Proxy (a user authentication-based proxy) where the HEIMDAL IP Addresses and domains need to be whitelisted (because an http/https call will not use the proxy when reaching a whitelisted IP Address/Domain).

msiexec /qn /i Heimdal.msi heimdalkey="keygoeshere" proxy="none"

After the installation process finishes, you should be able to see the HEIMDAL processes starting in Task Manager:

*Note: A reboot of the machine is recommended after the installation is completed

IMPORTANT
Please whitelist the following domains/IP Addresses to be sure that the HEIMDAL Agent is able to communicate with the HEIMDAL servers otherwise the installation will not complete and the Agent will not be able to run correctly:

Articles in this section