---
title: Virtual Machine Installation (ESXi)
slug: bhdm/virtual-machine-installation-esxi
createdAt: 2022-06-29T16:18:45.000Z
---

You can install the Belden Horizon Data Manager on a virtual machine using VMWare ESXi.

The virtual machine that runs Belden Horizon Data Manager uses the system time of the host environment. To ensure that timestamps of collected data are as universal as possible, we recommend setting the system time of the host environment to the UTC timezone.

The virtual machine that runs Belden Horizon Data Manager uses the same physical network card as the host environment. To ensure that the Belden Horizon Data Manager can communicate with data sources (edge devices) and are accessed through the Web UI, we recommend that you consolidate your network to ensure that communication can be established.

A typical Belden Horizon Data Manager virtual file for ESXi deployment adheres to the following naming convention: `<product-2.2.2>.ova`.&#x20;

Login information is as follows:

- admin
  https\://\<your-ip-address>:8446
  username: admin
  password: admin
-  application
  https\://\<your-ip-address>
  username: demo
  password: demo
- key-cloak
  https\://\<your-ip-address>/auth/admin
  username: kadmin
  password: kadmin

# Before You Begin

- Configure the docker bridge network. By default, this installation allocates the subnet `172.17.0.0/16`. Make sure that this does not conflict with your host environment network configuration.

:::hint{type="success"}
**Tip**: To reconfigure the docker bridge network, please refer to this [docker guide](https://docs.docker.com/network/bridge/).
:::

- Set up proxies to access Belden Horizon Data Manager behind the company firewall.
- Install ESXi v6.7 or higher. See [VMware](https://www.vmware.com/worldwide.html) for more information.
- Obtain a valid `.ova` file from Belden.&#x20;

To use ESXi to install Belden Horizon Data Manager, you will need to do the following.&#x20;

- Step 1: Install the Virtual Machine (ESXi)
- Step 2: Log in to the Belden Horizon Data Manager (BHDM) UI
- Step 3: Verify Post-Installation Checklist

To jump to a specific section, refer to the Table of Contents on the right side and click the corresponding step.&#x20;

# Step 1: Install the Virtual Machine (ESXi)

You will first need to install the virtual machine that will run Belden Horizon Data Manager.

**To install the virtual machine:**

1\. Start the **VMWare application** and log in.

::Image[]{src="https://api.archbee.com/api/optimize/SSUUxKZUk9bFTEPNn_6Zo/wigVeNBr1kxSWBpqliIRF_vmware-esxi-login.png" size="80" width="632" height="401" caption="EsXI Login Page" position="center" showCaption="true"}

2\. From the *VMWare Navigator&#x20;*&#x70;ane, click **Virtual Machines**, and then click **Create / Register**.

::Image[]{src="https://api.archbee.com/api/optimize/SSUUxKZUk9bFTEPNn_6Zo/WnhW1dLDIFuju7jC3PFgy_vmware-esxi-create.png" size="80" width="1345" height="333" caption="Create/Register VM using EsXi VM Navigator pane" position="center" showCaption="true"}

The *New virtual machine* dialog box appears.

3\. Select **Deploy a virtual machine from an OVF or OVA file**.

::Image[]{src="https://api.archbee.com/api/optimize/SSUUxKZUk9bFTEPNn_6Zo/-GyahbwhkuvAUfeH3_GJ4_vmware-esxi-deploy.png" size="80" width="840" height="535" caption="Select creation type panel" position="center" showCaption="true"}

4\. From the *Select OVF and VMDK files* screen, do the following:

&#x20;    a. Enter a name in the **Enter a name for the virtual machine** field.

&#x20;    b. Click the **Click to select files or drag/drop** box, navigate to an OVA file on your hard drive, and     then click **Open**.&#x20;

::Image[]{src="https://api.archbee.com/api/optimize/SSUUxKZUk9bFTEPNn_6Zo/eaO45Xux4cWcB606ic72r_vmware-esxi-select.png" size="80" width="839" height="533" caption="Select OVF/VDMK file panel" position="center" showCaption="true"}

&#x20;    c. Click **Next**.

5\. From the **Select storage** screen, view the information. Select the available datastore and then click **Next**.
In this example, the available datastore is `datastore1`.

::Image[]{src="https://api.archbee.com/api/optimize/SSUUxKZUk9bFTEPNn_6Zo/T_WVhbLLLQu2c9NuLPZlo_vmware-esxi-storage.png" size="80" width="837" height="532" caption="Select storage panel" position="center" showCaption="true"}

6\. From the **Deployment options** screen, review the options, and then click **Next**.

::Image[]{src="https://api.archbee.com/api/optimize/SSUUxKZUk9bFTEPNn_6Zo/puyci0FO5l747WSSAQhsh_vmware-esxi-options.png" size="80" width="840" height="534" caption="Deployment option panel" position="center" showCaption="true"}

7\. From the **Ready to complete** screen, click **Finish**.

::Image[]{src="https://api.archbee.com/api/optimize/SSUUxKZUk9bFTEPNn_6Zo/7YyEMdAX3-oCSjfKBBvPp_vmware-esxi-ready.png" size="80" width="837" height="534" caption="Ready to complete panel" position="center" showCaption="true"}

The *VMWare ESXi browse*r includes the new virtual machine.

This will begin the import of the OVA file from Step 4b and then the virtual machine creation. Progress can be viewed in the *Recent Tasks bar*. A successfully imported message will be shown once complete.

8\. Check the **Result** column in the *Recent tasks* pane for a **Completed successfully** link.

9\. Double-click the new virtual machine name.

The *Navigator* pane displays the selected virtual machine name and th&#x65;*&#x20;Browser* pane displays details for the new virtual machine.

::Image[]{src="https://api.archbee.com/api/optimize/SSUUxKZUk9bFTEPNn_6Zo/kaBGzrszQEofA2hp0y4wY_vmware-esxi-details.png" size="80" width="1342" height="634" caption="Succesfully generated virtual machine " position="center" showCaption="true"}

10\. (Optional) Click **Actions** to open a dropdown menu and click **Edit settings**.

::Image[]{src="https://api.archbee.com/api/optimize/SSUUxKZUk9bFTEPNn_6Zo/UmXmOoFWWEjVvO6SFVSts_vmware-esxi-action-edit-settings.png" size="80" width="1158" height="620" caption="Actions > Edit Settings option" position="center" showCaption="true"}

Configure `Memory` / `Hard disk 1` / `Network Adapter 1` as needed for your particular use case.

::Image[]{src="https://api.archbee.com/api/optimize/SSUUxKZUk9bFTEPNn_6Zo/gmmUrbFcwnUtlDF3TAzYX_vmware-esxi-action-edit-settings-options.png" size="80" width="979" height="634" caption="Customizing LEM memory/hard disk/network adapter" position="center" showCaption="true"}

Click **Save** when you have finished configuring your ESXi Virtual Machine.

11\. Click the **Terminal** window.
The *Terminal* window opens.

:::hint{type="success"}
**Tip**:
You can change your settings using the Terminal User interface (TUI).

To log in using the Terminal window, use the following credentials:

username: `em_setup`

password: `edgemanager`
:::

12\. Copy the IP address.

# Step 2: Log in to the Belden Horizon Data Manager (BHDM) UI

After installing the virtual machine, you can then log in to Belden Horizon Data Manager with a browser.

**To log in to BHDM UI:**

1\. Open a new incognito browser window and paste the IP address into the **URL** field.
The application initializes, and then the *Log In* screen appears.

2\. Log in with the following credentials:

-  **Username**: `demo`
- **Password**: `demo  `


3\. Change your password to activate your account, and then clic&#x6B;**&#xA0;Submit**.
The *Belden Horizon Data Manager* application opens.

:::hint{type="info"}
**Note**: You must change your password after the first log in.
:::

# Step 3: Verify Post-Installation Checklist

Verify the contents within the [Post-Installation Checklist](https://public-docs.litmus.io/bhdm/post-installation-checklist).

