> For the complete documentation index, see [llms.txt](https://docs.cloudbrink.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.cloudbrink.com/configuration/connector-deployment/connector-installation-hyper-v.md).

# Connector Installation - Hyper-V

#### Introduction&#x20;

This document will guide you to create a Cloudbrink Connector (either single or active-standby pair) in Hyper-V. Steps 9 through 18 must be completed twice in order to create two instances for the active-standby pair. <br>

#### Prerequisites &#x20;

1. Hyper-V console account with privilege to upload disk images and create virtual machines&#x20;
2. Create a Connector on the Cloudbrink Admin Portal, create Connector instance(s) and download the installation\_script for each of these instance(s)&#x20;
3. Run the installation\_script from the endpoint from where Hyper-V console will be managed&#x20;
4. By running the installation\_script, you can download the VM files (ex: VHDX) and the ISO file needed for the Connector bring-up step.&#x20;
5. Please refer to “Connector Configuration for On-Premises “ guide for details on these steps&#x20;

#### Connector VM Requirements&#x20;

1. Compute: 4 CPU and 8GB RAM&#x20;
2. Storage: 50 GB Disk&#x20;
3. Networking: Outbound ports 443 (TCP), 9090 (TCP) and 9993-4 (UDP) to Cloudbrink SaaS and Edges

#### Connector VM – High Level Instructions&#x20;

1. Deploy 1 (non-HA) or 2 (HA) Connector VMs OVA&#x20;
2. Edit the following settings of the deployed VM(s):&#x20;

&#x20;     Hard disk 1 size: 50 GB&#x20;

&#x20;     Attach CD/DVD drive with provided ISO (*unique* per VM) file&#x20;

3. Set forged transmits to Accept on the attached vSwitch&#x20;

#### Deploy Connector VM on Hyper-V&#x20;

1. From Hyper-V Manager, select Active -> New -> Virtual Machine.&#x20;

NOTE: The VHDX and ISO files could be downloaded to the laptop from where Hyper-V Manager is being accessed using the script given from the Cloudbrink admin portal <br>

2. Name the virtual machine appropriately and click next.&#x20;

<figure><img src="https://2520794396-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FsONIa4VvrnRrQWBte3ns%2Fuploads%2FxspQdn2rL9hCb9MXIp7j%2Fimage.png?alt=media&amp;token=f2684f44-d784-4605-9cf1-570f2a8595ef" alt=""><figcaption></figcaption></figure>

3. Select Generation-1, and click next.&#x20;

<figure><img src="https://2520794396-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FsONIa4VvrnRrQWBte3ns%2Fuploads%2FoMdHrkKxw4EZuQb5UFS3%2Fimage.png?alt=media&amp;token=284e30bf-5a7e-4676-b82a-62ed8a6e05e5" alt=""><figcaption></figcaption></figure>

4. Configure the desired memory based on the expected performance. (4GB RAM for up to 2Gbps throughput, 8GB RAM for 3Gbps throughput and 16GB RAM for \~4Gbps throughput).&#x20;

<figure><img src="https://2520794396-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FsONIa4VvrnRrQWBte3ns%2Fuploads%2FCh0QaqWqiZ9X8nc2AOVJ%2Fimage.png?alt=media&amp;token=16e8cdd8-b3ad-4a17-a78a-8f74bb7f1470" alt=""><figcaption></figcaption></figure>

\
5\. Select desired network for outbound connectivity (to Cloudbrink SaaS and Edges over Internet).&#x20;

<figure><img src="https://2520794396-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FsONIa4VvrnRrQWBte3ns%2Fuploads%2FKZnaWV4jmRYUYSQHLzhu%2Fimage.png?alt=media&amp;token=b68f79c5-f2ba-49c8-88d0-f49f95ce3f21" alt=""><figcaption></figcaption></figure>

\
6\. Select “Use an existing virtual hard disk” option and select the VHD disk image that was downloaded by running the installation\_script from the admin portal.&#x20;

<figure><img src="https://2520794396-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FsONIa4VvrnRrQWBte3ns%2Fuploads%2FVC334WOu1Ry0CpTzMRuu%2Fimage.png?alt=media&amp;token=7b0e655c-fd42-4e89-a1d7-8b23876ec051" alt=""><figcaption></figcaption></figure>

\
&#x20;7\. Proceed to the summary page and hit finish to deploy the VM.&#x20;

8. Before powering on the VM, right-click the deployed VM and select Settings.&#x20;

<figure><img src="https://2520794396-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FsONIa4VvrnRrQWBte3ns%2Fuploads%2FQmG42T8GlsxNz1Zkpew2%2Fimage.png?alt=media&amp;token=8fbe036a-ddb8-4c4d-b2fb-f587c70739fd" alt=""><figcaption></figcaption></figure>

<br>

9. Select the Hard Drive option, and click edit on the right hand window.

<figure><img src="https://2520794396-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FsONIa4VvrnRrQWBte3ns%2Fuploads%2FCvPB5UXBfwsNJpHTlMCW%2Fimage.png?alt=media&amp;token=6eec91af-1fe8-4b5b-9b71-f8f78c93e0a5" alt=""><figcaption></figcaption></figure>

<br>

10. On the select hard disk, click next, and expand&#x20;

<figure><img src="https://2520794396-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FsONIa4VvrnRrQWBte3ns%2Fuploads%2FwdWFf82xsmdRS8bkB96V%2Fimage.png?alt=media&amp;token=c8f339c3-3638-4920-88af-b7df9136ffba" alt=""><figcaption></figcaption></figure>

<br>

11. Ensure that the disk is set to 50GB. Click next and finish.&#x20;

<figure><img src="https://2520794396-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FsONIa4VvrnRrQWBte3ns%2Fuploads%2FhFpVK09p1Oydm2a46SnL%2Fimage.png?alt=media&amp;token=1f02c620-a30a-49dc-b1a4-cab0f31498b8" alt=""><figcaption></figcaption></figure>

<br>

12. Under DVD Drive, mount the ISO file downloaded by running the installation\_script from the admin portal. <br>
13. Once the VM is deployed, navigate to VMs and Templates, select the recently deployed VM, click Actions, and then Edit Settings.&#x20;

<figure><img src="https://2520794396-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FsONIa4VvrnRrQWBte3ns%2Fuploads%2FGx0piXdBMyzXJiedrWAW%2Fimage.png?alt=media&amp;token=fa51b769-7dfd-4eaa-a049-21386638a8aa" alt=""><figcaption></figcaption></figure>

14. Start the connector VM.&#x20;


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://docs.cloudbrink.com/configuration/connector-deployment/connector-installation-hyper-v.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
