# Apptimized TO GO Hypervisor User Guide

# Apptimized TO GO Hypervisor Integration

#### Enable Apptimized TO GO hypervisor connector

The one-time configuration is available for project administrators under **Settings** in the project menu > **Virtualization providers** option > **To** **Go** switch.

[![to_go_hyp_04.png](https://docs.apptimized.com/uploads/images/gallery/2020-06/scaled-1680-/K6BJjfNYXChpTteo-to_go_hyp_04.png)](https://docs.apptimized.com/uploads/images/gallery/2020-06/K6BJjfNYXChpTteo-to_go_hyp_04.png)

Apptimized shows the following screen when successful:

[![to_go_hyp_05.png](https://docs.apptimized.com/uploads/images/gallery/2020-06/scaled-1680-/JBqQ242KrjeJVktF-to_go_hyp_05.png)](https://docs.apptimized.com/uploads/images/gallery/2020-06/JBqQ242KrjeJVktF-to_go_hyp_05.png)

The **To Go** switch enables the TO GO hypervisor connector implementation within the project.

[![project_settings_26.png](https://docs.apptimized.com/uploads/images/gallery/2020-04/scaled-1680-/IhTLseYiKg2RFe1y-project_settings_26.png)](https://docs.apptimized.com/uploads/images/gallery/2020-04/IhTLseYiKg2RFe1y-project_settings_26.png)

The option to specify within what workflow step the TO GO hypervisor connector will be implemented enables when the switch is activated in front of the step name.

<span style="font-family: -apple-system, BlinkMacSystemFont, 'Segoe UI', Oxygen, Ubuntu, Roboto, Cantarell, 'Fira Sans', 'Droid Sans', 'Helvetica Neue', sans-serif; font-size: 14px; font-style: normal; font-variant-ligatures: normal; font-variant-caps: normal; font-weight: 400;">The </span>**User name**<span style="font-family: -apple-system, BlinkMacSystemFont, 'Segoe UI', Oxygen, Ubuntu, Roboto, Cantarell, 'Fira Sans', 'Droid Sans', 'Helvetica Neue', sans-serif; font-size: 14px; font-style: normal; font-variant-ligatures: normal; font-variant-caps: normal; font-weight: 400;"> and </span>**Password**<span style="font-family: -apple-system, BlinkMacSystemFont, 'Segoe UI', Oxygen, Ubuntu, Roboto, Cantarell, 'Fira Sans', 'Droid Sans', 'Helvetica Neue', sans-serif; font-size: 14px; font-style: normal; font-variant-ligatures: normal; font-variant-caps: normal; font-weight: 400;"> fields come prefilled. </span>

The **Host** field defines the IP address or DNS name of a resource that contains Virtual Machines (i.e., **10.159.11.2:1233** or **somesite.hive.com**).

When the value to the **Host** field is added, the **Create new image** button appears.

[![to_go_hyp_01.png](https://docs.apptimized.com/uploads/images/gallery/2020-06/scaled-1680-/6unDZyjSEWaghabG-to_go_hyp_01.png)](https://docs.apptimized.com/uploads/images/gallery/2020-06/6unDZyjSEWaghabG-to_go_hyp_01.png)

The option to create a custom operating system image is available under the **Create new image** button. Apptimized shows the following modal window (all required fields are marked with an asterisk <span style="color: #ff0000;">\*</span>):

[![to_go_hyp_03.png](https://docs.apptimized.com/uploads/images/gallery/2020-06/scaled-1680-/F1h8TZFFg3J2AT9c-to_go_hyp_03.png)](https://docs.apptimized.com/uploads/images/gallery/2020-06/F1h8TZFFg3J2AT9c-to_go_hyp_03.png)

The created custom operating system image must contain the installed **TO GO agent**. Otherwise, the VM will not be available via a virtual desktop environment using the RDP proxy server. The VM becomes in the ready status when TO GO agent sends a request to the Apptimized Portal to receive the manifest.

Table 2. Image settings

<table border="1" id="bkmrk-setting-description-" style="width: 800px; height: 712px;"><tbody><tr style="height: 33px;"><td style="width: 245.333px; height: 33px;">**Setting**

</td><td style="width: 553.6px; height: 33px;">**Description**

</td></tr><tr style="height: 54px;"><td style="width: 245.333px; height: 54px;">Name

</td><td style="width: 553.6px; height: 54px;">This setting defines the name for a new Azure image.

The naming is a user preference.

This field is required.

</td></tr><tr style="height: 32px;"><td style="width: 245.333px; height: 32px;">Platform

</td><td style="width: 553.6px; height: 32px;">This setting defines the name of the Windows platform (i.e., **Windows 10**).

</td></tr><tr style="height: 97px;"><td style="width: 245.333px; height: 97px;">OS Build

</td><td style="width: 553.6px; height: 97px;">This setting defines the operating system build that will be used (i.e., **18363.753** – is an OS build for Windows 10, version 1909).

OS build is a timeline of minor build releases in between the major version number releases.

</td></tr><tr style="height: 148px;"><td style="width: 245.333px; height: 148px;">OS Version

</td><td style="width: 553.6px; height: 148px;">This setting defines the operation system version that will be used.

The following options available:

- Windows 7;
- Windows 8;
- Windows 10.

The default value is **Windows 10**.

</td></tr><tr style="height: 132px;"><td style="width: 245.333px; height: 132px;">OS Language

</td><td style="width: 553.6px; height: 132px;">This setting defines the operating system language mode.

The following options available:

- EN;
- DE.

The default value is **EN**.

</td></tr><tr style="height: 132px;"><td style="width: 245.333px; height: 132px;">OS type

</td><td style="width: 553.6px; height: 132px;">This setting defines the operating system type mode.

The following options available:

- Windows Server;
- Desktop Windows.

The default value is **Windows**. **Server**.

</td></tr><tr style="height: 33px;"><td style="width: 245.333px; height: 33px;">Enabled

</td><td style="width: 553.6px; height: 33px;">This setting indicates that the current image is enabled for use.

</td></tr><tr style="height: 33px;"><td style="width: 245.333px; height: 33px;">Base snapshot</td><td style="width: 553.6px; height: 33px;">This setting defines the name of the snapshot (a captured state of a system in a particular time point). It is usually used as a back-up copy or as a basis to troubleshoot issues.

This field is required.

</td></tr><tr style="height: 97px;"><td style="width: 245.333px; height: 18px;">Base image</td><td style="width: 553.6px; height: 18px;">This setting defines the name of the existed operating system image which can be used as a basis for this image.

This field is required.

</td></tr></tbody></table>

The custom operating system image settings apply when clicking on the **Create** button. Apptimized shows the following screen when successful:

[![to_go_hyp_02.png](https://docs.apptimized.com/uploads/images/gallery/2020-06/scaled-1680-/VPiuoiFAfuEBsm8g-to_go_hyp_02.png)](https://docs.apptimized.com/uploads/images/gallery/2020-06/VPiuoiFAfuEBsm8g-to_go_hyp_02.png)

The option to modify the custom operating system image settings is available under the **Edit image** button.

<p class="callout info">**Note**. When the TO GO hypervisor connector option is implemented for the project, a customer receives the full scope of the Apptimized [discovery ](https://docs.apptimized.com/books/apptimized-platform-user-manual/page/discovery)and [<span style="font-family: -apple-system, BlinkMacSystemFont, 'Segoe UI', Oxygen, Ubuntu, Roboto, Cantarell, 'Fira Sans', 'Droid Sans', 'Helvetica Neue', sans-serif; font-size: 14px; font-style: normal; font-variant-ligatures: normal; font-variant-caps: normal; font-weight: 400;">testing</span> ](https://docs.apptimized.com/books/apptimized-platform-user-manual/page/testing)functionality on VMs with the custom operating system image.</p>