View source for ICX-AlphaCom Core in VirtualBox

{{I}}
This article describes how to install ICX-Core in a VirtualBox environment.


<div style="float:right;"> <youtube width="300" height="180">OJwvnLRDG74=3s</youtube>  </div>

==Prerequisites==

*Virtual machine: VirtualBox (version 6.0 is used in this guide): https://www.oracle.com/virtualization/technologies/vm/downloads/virtualbox-downloads.html
*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: [[Downloads#ICX_System|ICX System]]

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

==VirtualBox==
After downloading and installing VirtualBox, run the software and create the virtual machine by clicking "'''New'''":
[[File:ICX VB1.png|thumb|left|500px]]
<br style="clear:both;" />

Give your machine a name, set '''Type''' = Linux,  and set '''Version''' = Ubuntu:
[[File:ICX VB2.png|thumb|left|500px]]
<br style="clear:both;" />

The memory must be at least 1GB:
[[File:ICX VB3.png|thumb|left|500px]]
<br style="clear:both;" />

Create the virtual HDD:
[[File:ICX VB4.png|thumb|left|500px]]
<br style="clear:both;" />

Select the HDD type:
[[File:ICX VB5.png|thumb|left|500px]]
<br style="clear:both;" />

Physical HDD storage:
[[File:ICX VB6.png|thumb|left|500px]]
<br style="clear:both;" />

The HDD must be minimum 15GB:
[[File:ICX VB7.png|thumb|left|500px]]
<br style="clear:both;" />

After the creation of the virtual machine is finished, select and set some '''Settings''' before starting:
[[File:ICX VB8.png|thumb|left|500px]]
<br style="clear:both;" />

In '''Storage''', browse for the OS .iso file (Ubuntu 22.04.x LTS Server) and mount it:
[[File:ICX VB9.png|thumb|left|500px]]
<br style="clear:both;" />

Set up the '''Network''' connection:

*Choose '''Bridged Adapter''', and select which interface to use for the ICX-Core

[[File:ICX VB10.png|thumb|left|500px]]
<br style="clear:both;" />

Now '''Start''' the machine:
[[File:ICX VB11.png|thumb|left|500px]]
<br style="clear:both;" />

==Ubuntu==
The Ubuntu installation will automatically launch after '''Start''' in the previous section. Choose your language:
[[File:ICX VB12.png|thumb|left|500px]]
<br style="clear:both;" />

Define your keyboard:
[[File:ICX VB13.png|thumb|left|500px]]
<br style="clear:both;" />

Confirm the network adapter:
[[File:ICX VB14.png|thumb|left|500px]]
<br style="clear:both;" />

Enter Proxy if needed:
[[File:ICX VB15.png|thumb|left|500px]]
<br style="clear:both;" />

Confirm mirror:
[[File:ICX VB16.png|thumb|left|500px]]
<br style="clear:both;" />

Filesystem:
[[File:ICX VB17.png|thumb|left|500px]]
<br style="clear:both;" />

Select HDD:
[[File:ICX VB18.png|thumb|left|500px]]
<br style="clear:both;" />

Confirm partition:
[[File:ICX VB19.png|thumb|left|500px]]
<br style="clear:both;" />

Confirm installation:
[[File:ICX VB20.png|thumb|left|500px]]
<br style="clear:both;" />

Enter profile and credentials. VERY important to not forget this. Write it down!:
[[File:ICX VB21.png|thumb|left|500px]]
<br style="clear:both;" />
{{Note|The selected Username will also name the host folder for the ICX-Core}}

Select Install OpenSSH server:
[[File:ICX VB22.png|thumb|left|500px]]
<br style="clear:both;" />

Skip:
[[File:ICX VB23.png|thumb|left|500px]]
<br style="clear:both;" />

The installation is now running:
[[File:ICX VB24.png|thumb|left|500px]]
<br style="clear:both;" />

Installation complete! Hit Enter key to reboot:
[[File:ICX VB25.png|thumb|left|500px]]
<br style="clear:both;" />

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

==ICX-Core==
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]]
<br style="clear:both;" />

Connect to the virtual machine with WinSCP ...
[[File:ICX VB27.png|thumb|left|500px]]
<br style="clear:both;" />

... and copy the ICX-Core installation file from your computer to the virtual machine:
[[File:ICX VB28.png|thumb|left|500px]]
<br style="clear:both;" />

{{Note|the target folder must be ''/home/[Username]/'}}

Close WinSCP.

Install ICX-Core using the command (case sensitive):
{{code|sudo tar -xf ICX-Core-01.00-jammy-1.3.3.0.apt.tar install.sh --to-command /bin/sh}}
Where ''ICX-Core-01.00-bionic-1.2.3.9.apt.tar'' is the ICX-Core file name.
[[File:ICX VB29.png|thumb|left|500px]]
<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. 
[[File:ICX VB30.png|thumb|left|500px]]
<br style="clear:both;" />

[[Category: ICX-AlphaCom Platform]]
[[Category: ICX-Core]]