Web Console Integration for Hyper-V in MachPanel


Summary

This article provides information about integration of Myrtille web console for Hyper-V in MachPanel.

Applies to

Applies to MachPanel build v 7 and above

Details

MachPanel utilizes and supports Myrtille as the web-based console for Virtual Machines (VMs). Myrtille enables users to access their Windows VMs directly through a standard web browser using RDP over VM Bus (Hyper-V) allowing access without network configuration on the guest OS.

MachPanel integrates with Myrtille to provide browser-based VM console access, making it easier for users to connect to and manage their VMs remotely. The Myrtille component handles the connection, while MachPanel manages the VM and user access within the platform.

Key Feature:

  • Network Independence Access.
  • No RDP or SSH required on Guest.
  • Cross-Platform compatibility for Guest OS.
  • Hyper-V Enhanced Mode Support.
Pre-Requisites
  • Ensure that “Allow enhanced session mode” is enabled on each Hyper-V Server under “Hyper-V Server Settings”.

  • Make Sure default site under IIS is running on MachPanel Server on port 8080, before starting installation

Download and Install
  • Download the supported version of Myrtille
  • Start the installation and proceed the installation with default settings (Just click Next of all interfaces) and complete the installation

 

Verification of Myrtille
  • First, make sure the Myrtille connection is working directly by supplying information of your Server and VM using RDP over VM Bus (Hyper-V) method.
  • Make sure TCP Port 2179 is open between the Myrtille Server and your Hyper-V server.

 

Integration in MachPanel
  • Replace DLL:  After you have verified that Console Access is working for your VM using Myrtille, please download the DLL file on the server where Myrtille is installed.
    • Unblock the Zip file (if blocked) by going to file properties
    • Extract the DLL from within
    • Replace this in bin folder under Myrtille Installation i.e C:\Program Files (x86)\Myrtille\bin
    • After doing so, the Myrtille page will not work anymore and it will only work via the Web Console button in MachPanel VM Management.
  • Create a Service Account:  Create a user with Administrative Privileges for MachPanel Web Console on your Hyper-V Servers. If you have Cluster Setup of Hyper-V you can create a Domain User.
    • Add user details in web.config at (C:\Program Files (x86)\Myrtille) under <appSettings> and change username/password/domain as per your settings

      <add key="AdminUser" value="Administrator" />
      <add key="AdminPass" value="P@ssw0rd#@!123" />
      <add key="AdminDomain" value="LabDomain2019" /> //this line can be skipped if you have standalone hyper-v servers

  •   ​Add URL in MachPanel:  Add below URL in MachPanel Web Console Configuration for each server:
    • http://'IP/URL of Myrtill here':8080/Myrtille/Default.aspx/?__EVENTTARGET=&__EVENTARGUMENT=&connect=Connect%21&server=
    • Replace 'IP/URL of Myrtille Web Console here' in above URL with IP according to your Server IP or URL.
    • Navigate to Service Director > Virtual Machine Hosting > Server Group and click the Server Group Name, then Edit your Hyper-V Hosts one by one and for each Hyper-V Host/Server, add the updated URL in the field called "Web Console Access URL:" then update/save configuration.

  • Once its done you will be able to see 'Web Console' button under the Virtual Machine Management interface hosted on the respective Hyper-V host.

  • When you pass over this button, you will get two options. Click your desired option to connect to the VM:

​​

  • It will open a new tab for web console to this VM.

​​