ICX-AlphaCom Core in Hyper-V

From Zenitel Wiki

Icx icon.png

This article describes how to install ICX-AlphaCom Core in a Hyper-V environment.


Note icon The virtual machine must have an internet connection and valid DNS server during the installation process

Hyper-V Manager

Run the Hyper-V Manager:

Hyper V Manager.png

First, we need to create an External Network Adapter. From the Actions tab, choose Virtual Switch Manager:

Select External and press Create Virtual Switch

New Virtual Switch 1.png

Connect this new Virtual Switch to the External Network by choosing the correct network adapter and giving it a name. If you have more than one network adapter, be sure to identify the correct one and click OK.

New Virtual Switch 2.png

Now, we can create a New Virtual Machine. Click New and select Virtual Machine from the Actions tab.

New Virtual Machine 1.png

Click Next.

New Virtual Machine 2.png

Give the new Virtual Machine a name, and choose where you should store this VM.

New Virtual Machine 3.png

Select Generation 2 as the Generation of the Virtual Machine

New Virtual Machine 4.png

Specify 1024MB as the RAM required for the Virtual Machine, and disable Dynamic Memory

New Virtual Machine 5.png

Connect your new Virtual Machine to the Default Switch for Hyper V. We will add the new External Network to the Virtual Machine in a later step.

New Virtual Machine 6.png

Create a new Virtual Hard Disk and give it a size of 15GB

New Virtual Machine 7.png

Attach the Ubuntu .ISO installation media to the Virtual Machine for it's first boot.

New Virtual Machine 8.png

Check the summary of options and click Finish.

New Virtual Machine 9.png

Now we need to configure the final options prior to booting the Virtual Machine. Right-Click on your newly created Virtual Machine and choose Settings.

New Virtual Machine 10.png

Under Security, disable Enable Secure Boot

Disable Secure Boot.png

Click Add Hardware, and select Network Adapter and press Add

Add Ethernet.png

Choose the External Network Virtual Switch created in the first steps and click OK.

Add Ethernet 2.png

Note icon Before starting the virtual machine, delete the Network Adapter named "Default Switch". You must use only the network adapter you created

Time to start your Virtual Machine. Double-Click on your new Virtual Machine, and press Start in the window.

Start VM.png


The Ubuntu installation will automatically launch after Start in the previous section. Note that while the screen captures are from VirtualBox, the process remains the same for Hyper-V

Choose your language:

ICX VB12.png

Define your keyboard:

ICX VB13.png

Confirm the network adapter:

ICX VB14.png

Enter Proxy if needed:

ICX VB15.png

Confirm mirror:

ICX VB16.png


ICX VB17.png

Select HDD:

ICX VB18.png

Confirm partition:

ICX VB19.png

Confirm installation:

ICX VB20.png

Enter profile and credentials. VERY important to not forget this. Write it down!:

ICX VB21.png

Note icon The selected Username will also name the host folder for the ICX-Core

Select Install OpenSSH server:

ICX VB22.png


ICX VB23.png

The installation is now running:

ICX VB24.png

Installation complete! Hit Enter key to reboot:

ICX VB25.png

The virtual machine reboots and starts up with Ubuntu running in terminal mode.

ICX-AlphaCom Core

Log in with the username and password defined earlier. Use command "ip a" to see the IP address that the virtual machine has:

ICX VB26.png

Connect to the virtual machine with WinSCP ...

ICX VB27.png

... and copy the ICX-AlphaCom Core installation file from your computer to the virtual machine:

ICX VB28.png

Note icon the target folder must be /home/[Username]/

Close WinSCP.

Install ICX-AlphaCom Core using the command (case sensitive):

sudo tar -xf ICX-Core-01.00-bionic- --to-command /bin/sh

Where ICX-Core-01.00-bionic- is the ICX-Core file name.

ICX VB29.png

After installation, you can access the ICX Web from the Host PC by using the eth0 IP address of the virtual machine.

ICX VB30.png

If your Hyper-V system is Headless, and you cannot access the Web Interface from the Default Network Adapter, use the following command to enable port 80 on eth1. Don't forget to enable the correct filters in the AlphaWeb once you login as this setting will be overwritten by the ICX-AlphaCom Core system on reboot.

sudo iptables -A INPUT -i eth1 -p tcp -m tcp --dport 80 -j ACCEPT