Difference between revisions of "ICX-AlphaCom Core in Hyper-V"
From Zenitel Wiki
ZenitelAus (talk | contribs) |
m |
||
(8 intermediate revisions by 4 users not shown) | |||
Line 1: | Line 1: | ||
− | {{I}}This article describes how to install ICX-Core in a Hyper-V environment. | + | {{I}}This article describes how to install ICX-AlphaCom Core in a Hyper-V environment. |
==Prerequisites== | ==Prerequisites== | ||
*Windows Server or Windows 10 with the Hyper-V feature installed. | *Windows Server or Windows 10 with the Hyper-V feature installed. | ||
− | *Operating System: Ubuntu | + | * Operating System: |
+ | **Ubuntu 22.04.x LTS Server for ICX-AlphaCom version 1.2.3.9 and later (Mandatory): http://releases.ubuntu.com/22.04/ | ||
+ | **Ubuntu 18.04.x LTS Server for ICX-AlphaCom version 1.2.3.8 and earlier - note that there is no support for Ubuntu 18.04 anymore | ||
*File transfer software: WinSCP (version 5.15.3 used in this guide): WinSCP https://winscp.net/eng/index.php | *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]] | *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 and valid DNS server during the installation process}} |
==Hyper-V Manager== | ==Hyper-V Manager== | ||
− | Run the Hyper-V Manager: | + | Run the '''Hyper-V Manager''': |
[[File:Hyper V Manager.png|left|frameless|697x697px]] | [[File:Hyper V Manager.png|left|frameless|697x697px]] | ||
Line 17: | Line 19: | ||
<br style="clear:both;" /> | <br style="clear:both;" /> | ||
− | First, we need to create an External Network Adapter. From the '''Actions''' tab, choose '''Virtual Switch Manager:''' | + | First, we need to create an '''External Network Adapter'''. From the '''Actions''' tab, choose '''Virtual Switch Manager:''' |
− | Select External and press Create Virtual Switch | + | Select '''External''' and press '''Create Virtual Switch''' |
[[File:New Virtual Switch 1.png|left|frameless|464x464px]] | [[File:New Virtual Switch 1.png|left|frameless|464x464px]] | ||
<br style="clear:both;" /> | <br style="clear:both;" /> | ||
− | 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. | + | 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:New Virtual Switch 2.png|left|frameless|465x465px]] | [[File:New Virtual Switch 2.png|left|frameless|465x465px]] | ||
<br style="clear:both;" /> | <br style="clear:both;" /> | ||
− | Now, we can create a New Virtual Machine. Click New and select Virtual Machine from the Actions tab. | + | Now, we can create a New Virtual Machine. Click '''New''' and select '''Virtual Machine''' from the '''Actions''' tab. |
[[File:New Virtual Machine 1.png|left|frameless]] | [[File:New Virtual Machine 1.png|left|frameless]] | ||
<br style="clear:both;" /> | <br style="clear:both;" /> | ||
− | Click Next. | + | Click '''Next.''' |
[[File:New Virtual Machine 2.png|left|frameless|582x582px]] | [[File:New Virtual Machine 2.png|left|frameless|582x582px]] | ||
<br style="clear:both;" /> | <br style="clear:both;" /> | ||
Line 39: | Line 41: | ||
<br style="clear:both;" /> | <br style="clear:both;" /> | ||
− | Select Generation 2 as the Generation of the Virtual Machine | + | Select Generation 2 as the '''Generation''' of the Virtual Machine |
[[File:New Virtual Machine 4.png|left|frameless|585x585px]] | [[File:New Virtual Machine 4.png|left|frameless|585x585px]] | ||
<br style="clear:both;" /> | <br style="clear:both;" /> | ||
− | Specify | + | Specify '''1024MB''' as the RAM required for the Virtual Machine, and disable '''Dynamic Memory''' |
[[File:New Virtual Machine 5.png|left|frameless|587x587px]] | [[File:New Virtual Machine 5.png|left|frameless|587x587px]] | ||
<br style="clear:both;" /> | <br style="clear:both;" /> | ||
− | 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. | + | 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:New Virtual Machine 6.png|left|frameless|586x586px]] | [[File:New Virtual Machine 6.png|left|frameless|586x586px]] | ||
<br style="clear:both;" /> | <br style="clear:both;" /> | ||
− | Create a new Virtual Hard Disk and give it a size of 15GB | + | Create a new Virtual Hard Disk and give it a size of '''15GB''' |
[[File:New Virtual Machine 7.png|left|frameless|589x589px]] | [[File:New Virtual Machine 7.png|left|frameless|589x589px]] | ||
<br style="clear:both;" /> | <br style="clear:both;" /> | ||
Line 59: | Line 61: | ||
<br style="clear:both;" /> | <br style="clear:both;" /> | ||
− | Check the summary of options and click Finish. | + | Check the summary of options and click '''Finish.''' |
[[File:New Virtual Machine 9.png|left|frameless|589x589px]] | [[File:New Virtual Machine 9.png|left|frameless|589x589px]] | ||
<br style="clear:both;" /> | <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. | + | 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]] | [[File:New Virtual Machine 10.png|left|frameless|586x586px]] | ||
<br style="clear:both;" /> | <br style="clear:both;" /> | ||
Line 71: | Line 73: | ||
<br style="clear:both;" /> | <br style="clear:both;" /> | ||
− | Click Add Hardware, and select Network Adapter and press Add | + | Click Add Hardware, and select '''Network Adapter''' and press '''Add''' |
[[File:Add Ethernet.png|left|frameless|588x588px]] | [[File:Add Ethernet.png|left|frameless|588x588px]] | ||
<br style="clear:both;" /> | <br style="clear:both;" /> | ||
Line 78: | Line 80: | ||
[[File:Add Ethernet 2.png|left|frameless]] | [[File:Add Ethernet 2.png|left|frameless]] | ||
<br style="clear:both;" /> | <br style="clear:both;" /> | ||
+ | {{note| 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 | + | 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]] | [[File:Start VM.png|left|frameless|446x446px]] | ||
<br style="clear:both;" /> | <br style="clear:both;" /> | ||
Line 145: | Line 148: | ||
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 154: | Line 157: | ||
<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 162: | Line 165: | ||
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. | + | {{code|sudo tar -xf ICX-Core-01.00-bionic-1.2.9.3.apt.tar install.sh --to-command /bin/sh}} |
− | Where ''ICX-Core-01.00-bionic-1. | + | Where ''ICX-Core-01.00-bionic-1.2.9.3.apt.tar'' is the ICX-Core file name. |
[[File:ICX VB29.png|thumb|left|500px]] | [[File:ICX VB29.png|thumb|left|500px]] | ||
<br style="clear:both;" /> | <br style="clear:both;" /> | ||
− | After installation, you can access the [[ICX Web]] from | + | 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;" />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 | + | <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]] | ||
+ | [[Category: ICX-Core]] |
Latest revision as of 10:22, 17 May 2023
This article describes how to install ICX-AlphaCom Core in a Hyper-V environment.
Prerequisites
- Windows Server or Windows 10 with the Hyper-V feature installed.
- Operating System:
- Ubuntu 22.04.x LTS Server for ICX-AlphaCom version 1.2.3.9 and later (Mandatory): http://releases.ubuntu.com/22.04/
- Ubuntu 18.04.x LTS Server for ICX-AlphaCom version 1.2.3.8 and earlier - note that there is no support for Ubuntu 18.04 anymore
- File transfer software: WinSCP (version 5.15.3 used in this guide): WinSCP https://winscp.net/eng/index.php
- ICX-Core software: ICX System
The virtual machine must have an internet connection and valid DNS server during the installation process |
Hyper-V Manager
Run the Hyper-V Manager:
First, we need to create an External Network Adapter. From the Actions tab, choose Virtual Switch Manager:
Select External and press Create Virtual Switch
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.
Now, we can create a New Virtual Machine. Click New and select Virtual Machine from the Actions tab.
Click Next.
Give the new Virtual Machine a name, and choose where you should store this VM.
Select Generation 2 as the Generation of the Virtual Machine
Specify 1024MB as the RAM required for the Virtual Machine, and disable Dynamic Memory
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.
Create a new Virtual Hard Disk and give it a size of 15GB
Attach the Ubuntu .ISO installation media to the Virtual Machine for it's first boot.
Check the summary of options and click Finish.
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.
Under Security, disable Enable Secure Boot
Click Add Hardware, and select Network Adapter and press Add
Choose the External Network Virtual Switch created in the first steps and click OK.
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.
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:
Define your keyboard:
Confirm the network adapter:
Enter Proxy if needed:
Confirm mirror:
Filesystem:
Select HDD:
Confirm partition:
Confirm installation:
Enter profile and credentials. VERY important to not forget this. Write it down!:
Select Install OpenSSH server:
Skip:
The installation is now running:
Installation complete! Hit Enter key to reboot:
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:
Connect to the virtual machine with WinSCP ...
... and copy the ICX-AlphaCom Core installation file from your computer to the virtual machine:
Close WinSCP.
Install ICX-AlphaCom Core using the command (case sensitive):
sudo tar -xf ICX-Core-01.00-bionic-1.2.9.3.apt.tar install.sh --to-command /bin/sh
|
Where ICX-Core-01.00-bionic-1.2.9.3.apt.tar is the ICX-Core file name.
After installation, you can access the ICX Web from the Host PC by using the eth0 IP address of the virtual machine.
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
|