Actions

Difference between revisions of "ICX-AlphaCom Core in Hyper-V"

From Zenitel Wiki

(Created page with "{{I}}This article describes how to install ICX-Core in a Hyper-V environment. ==Prerequisites== * Windows Server or Windows 10 with the Hyper-V feature installed. * Operating...")
 
(2 intermediate revisions by the same user not shown)
Line 2: Line 2:
  
 
==Prerequisites==
 
==Prerequisites==
* Windows Server or Windows 10 with the Hyper-V feature installed.
+
 
* Operating System: Ubuntu 18.04.x LTS Server (Mandatory): http://releases.ubuntu.com/18.04/  
+
*Windows Server or Windows 10 with the Hyper-V feature installed.
 +
*Operating System: Ubuntu 18.04.x LTS Server (Mandatory): http://releases.ubuntu.com/18.04/
 +
*File transfer software: WinSCP (version 5.15.3 used in this guide): WinSCP https://winscp.net/eng/index.php
 +
*ICX-Core software: [[Downloads#ICX%20System|ICX System]]
  
 
{{Note|The virtual machine must have an internet connection during the installation process}}
 
{{Note|The virtual machine must have an internet connection during the installation process}}
  
==Hyper-V==
+
==Hyper-V Manager==
After downloading and installing VirtualBox, run the software and create the virtual machine by clicking "'''New'''":
+
Run the Hyper-V Manager:
[[File:ICX VB1.png|thumb|left|500px]]
+
[[File:Hyper V Manager.png|left|frameless|697x697px]]
 +
 
 +
 
 +
<br style="clear:both;" />
 +
 
 +
First, we need to create an External Network Adapter.  From the '''Actions''' tab, choose '''Virtual Switch Manager:'''
 +
 
 +
Select External and press Create Virtual Switch
 +
[[File:New Virtual Switch 1.png|left|frameless|464x464px]]
 
<br style="clear:both;" />
 
<br style="clear:both;" />
  
Give your machine a name, set '''Type''' = Linux,  and set '''Version''' = Ubuntu:
+
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.
[[File:ICX VB2.png|thumb|left|500px]]
+
[[File:New Virtual Switch 2.png|left|frameless|465x465px]]
 
<br style="clear:both;" />
 
<br style="clear:both;" />
  
The memory must be at least 1GB:
+
Now, we can create a New Virtual Machine.  Click New and select Virtual Machine from the Actions tab.
[[File:ICX VB3.png|thumb|left|500px]]
+
[[File:New Virtual Machine 1.png|left|frameless]]
 
<br style="clear:both;" />
 
<br style="clear:both;" />
  
Create the virtual HDD:
+
Click Next.
[[File:ICX VB4.png|thumb|left|500px]]
+
[[File:New Virtual Machine 2.png|left|frameless|582x582px]]
 
<br style="clear:both;" />
 
<br style="clear:both;" />
  
Select the HDD type:
+
Give the new Virtual Machine a name, and choose where you should store this VM. 
[[File:ICX VB5.png|thumb|left|500px]]
+
[[File:New Virtual Machine 3.png|left|frameless|587x587px]]
 
<br style="clear:both;" />
 
<br style="clear:both;" />
  
Physical HDD storage:
+
Select Generation 2 as the Generation of the Virtual Machine
[[File:ICX VB6.png|thumb|left|500px]]
+
[[File:New Virtual Machine 4.png|left|frameless|585x585px]]
 
<br style="clear:both;" />
 
<br style="clear:both;" />
  
The HDD must be minimum 15GB:
+
Specify 1028MB as the RAM required for the Virtual Machine, and disable Dynamic Memory
[[File:ICX VB7.png|thumb|left|500px]]
+
[[File:New Virtual Machine 5.png|left|frameless|587x587px]]
 
<br style="clear:both;" />
 
<br style="clear:both;" />
  
After the creation of the virtual machine is finished, select and set some '''Settings''' before starting:
+
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.
[[File:ICX VB8.png|thumb|left|500px]]
+
[[File:New Virtual Machine 6.png|left|frameless|586x586px]]
 
<br style="clear:both;" />
 
<br style="clear:both;" />
  
In '''Storage''', browse for the OS .iso file (Ubuntu 18.04.x LTS Server) and mount it:
+
Create a new Virtual Hard Disk and give it a size of 15GB
[[File:ICX VB9.png|thumb|left|500px]]
+
[[File:New Virtual Machine 7.png|left|frameless|589x589px]]
 
<br style="clear:both;" />
 
<br style="clear:both;" />
  
Set up the '''Network''' connection:
+
Attach the Ubuntu .ISO installation media to the Virtual Machine for it's first boot.
* Choose '''Bridged Adapter''', and select which interface to use for the ICX-Core
+
[[File:New Virtual Machine 8.png|left|frameless|591x591px]]
[[File:ICX VB10.png|thumb|left|500px]]
 
 
<br style="clear:both;" />
 
<br style="clear:both;" />
  
Now '''Start''' the machine:
+
Check the summary of options and click Finish.
[[File:ICX VB11.png|thumb|left|500px]]
+
[[File:New Virtual Machine 9.png|left|frameless|589x589px]]
 +
<br style="clear:both;" />
 +
 
 +
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.
 +
[[File:New Virtual Machine 10.png|left|frameless|586x586px]]
 +
<br style="clear:both;" />
 +
 
 +
Under Security, disable '''Enable Secure Boot'''
 +
[[File:Disable Secure Boot.png|left|frameless|589x589px]]
 +
<br style="clear:both;" />
 +
 
 +
Click Add Hardware, and select Network Adapter and press Add
 +
[[File:Add Ethernet.png|left|frameless|588x588px]]
 +
<br style="clear:both;" />
 +
 
 +
Choose the External Network Virtual Switch created in the first steps and click OK.
 +
[[File:Add Ethernet 2.png|left|frameless]]
 +
<br style="clear:both;" />
 +
 
 +
Time to start your Virtual Machine.  Double-Click on your new Virtual Machine, and press start in the window.
 +
[[File:Start VM.png|left|frameless|446x446px]]
 
<br style="clear:both;" />
 
<br style="clear:both;" />
  
 
==Ubuntu==
 
==Ubuntu==
The Ubuntu installation will automatically launch after '''Start''' in the previous section. Choose your language:
+
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:
 
[[File:ICX VB12.png|thumb|left|500px]]
 
[[File:ICX VB12.png|thumb|left|500px]]
 
<br style="clear:both;" />
 
<br style="clear:both;" />
Line 113: Line 145:
 
The virtual machine reboots and starts up with Ubuntu running in terminal mode.
 
The virtual machine reboots and starts up with Ubuntu running in terminal mode.
  
==ICX-Core==
+
==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:
 
Log in with the username and password defined earlier. Use command "'''ip a'''" to see the IP address that the virtual machine has:
 
[[File:ICX VB26.png|thumb|left|500px]]
 
[[File:ICX VB26.png|thumb|left|500px]]
Line 122: Line 154:
 
<br style="clear:both;" />
 
<br style="clear:both;" />
  
... and copy the ICX-Core installation file from your computer to the virtual machine:
+
... and copy the ICX-AlphaCom Core installation file from your computer to the virtual machine:
 
[[File:ICX VB28.png|thumb|left|500px]]
 
[[File:ICX VB28.png|thumb|left|500px]]
 
<br style="clear:both;" />
 
<br style="clear:both;" />
Line 130: Line 162:
 
Close WinSCP.
 
Close WinSCP.
  
Install ICX-Core using the command (case sensitive):
+
Install ICX-AlphaCom Core using the command (case sensitive):
 
{{code|sudo tar -xf ICX-Core-01.00-bionic-1.0.3.0.apt.tar install.sh --to-command /bin/sh}}
 
{{code|sudo tar -xf ICX-Core-01.00-bionic-1.0.3.0.apt.tar install.sh --to-command /bin/sh}}
 
Where ''ICX-Core-01.00-bionic-1.0.3.0.apt.tar'' is the ICX-Core file name.
 
Where ''ICX-Core-01.00-bionic-1.0.3.0.apt.tar'' is the ICX-Core file name.
Line 136: Line 168:
 
<br style="clear:both;" />
 
<br style="clear:both;" />
  
After installation, you can access the [[ICX Web]] from any PC in the network by using the IP address of the virtual machine.  
+
After installation, you can access the [[ICX Web]] from the Host PC by using the eth0 IP address of the virtual machine.  
 
[[File:ICX VB30.png|thumb|left|500px]]
 
[[File:ICX VB30.png|thumb|left|500px]]
<br style="clear:both;" />
+
<br style="clear:both;" />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.{{code|sudo iptables -A INPUT -i eth1 -p tcp -m tcp --dport 80 -j ACCEPT}}
 
 
 
[[Category: ICX-AlphaCom Platform]]
 
[[Category: ICX-AlphaCom Platform]]

Revision as of 04:07, 10 February 2020

Icx icon.png

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

Prerequisites

Note icon The virtual machine must have an internet connection 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 1028MB 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


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

Start VM.png


Ubuntu

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


Filesystem:

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


Skip:

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-1.0.3.0.apt.tar install.sh --to-command /bin/sh


Where ICX-Core-01.00-bionic-1.0.3.0.apt.tar 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