ICX-AlphaCom Core - Installation

This article describes how to install the ICX-AlphaCom Core software package.

ICX-AlphaCom Core is the software running on the ICX-500 Gateway. The software is also available for installation on industry standard PC hardware. ICX-AlphaCom Core can be installed either on a physical machine or virtual machine.

Minimum requirements

CPU: PC type hardware using Intel and AMD 64 bit processors, with the exception of the Intel Itanium processor.
Memory: 1 GByte
Harddisk: 15 GByte
Operating System:

- ICX-AlphaCom versions as from 1.2.3.9: Linux - Ubuntu 22.04.x LTS Server
- ICX-AlphaCom versions up to 1.2.3.8: Linux - Ubuntu 18.04.x LTS Server
- ICX-AlphaCom version 1.2.3.9 can be used as an upgrade path for Ubuntu - upgrade ICX-AlphaCom on a running system to 1.2.3.9 before upgrading Ubuntu to 22.04
Virtual Machine: The VM must be defined with:
- 1 processor
- 1 GB RAM
- 15 GB harddisk as a minimum

DO NOT UPGRADE UBUNTU FROM 18.04 EVEN IF OFFERED BY THE SYSTEM UNLESS ICX-AlphaCom HAS BEEN UPGRADED TO 1.2.3.9 BEFOREHAND. NEW INSTALLATIONS OF ICX-AlphaCom VERSION 1.2.3.9 OR LATER MUST BE DONE ON UBUNTU 22.04

Installation

Precautions:

Direct access to the Linux Console of the VM is required. The installation must be done from the VM console directly
- Installations performed using SSH connection (Putty, Tera Term etc.) might fail due to network changes during installation.
- For installations performed using remote connection, the remote computer must be in the same subnet as the VM machine.
ICX-AlphaCom Core can run directly on a PC or in a VM, note the Minimum requirements as specified above for the correct Ubuntu version
An Internet connection must be available with a DNS server as the installation process will download security updates. Installation will not complete without a live connection.
Before installing any release version of ICX-AlphaCom Core, any previously installed beta-version of ICX-AlphaCom Core must be removed. Command: sudo apt purge --auto-remove vs-'*'

Upload:

Upload the ICX-AlphaCom Core software to your home directory of the VM, using for example WinSCP
Example file: “ICX-Core-01.00-jammy-1.3.3.0.apt.tar”

Install:

From the Linux console, install the ICX-AlphaCom Core software with the following command:

sudo tar -xf ICX-Core-01.00-jammy-1.3.3.0.apt.tar install.sh --to-command /bin/sh

Upgrading ICX-Core and Ubuntu

Upgrading ICX-AlphaCom Core

After first time installation, later ICX-AlphaCom Core upgrades can be done from the ICX-WEB menu: System Maintenance -> System Upgrade

Upgrading from 1.2.3.9 to 1.3.3.0 must be done from the Linux Console using the normal installation process of copying the installation file and running the install script. Failure to do this will result in the loss of your ICX-AlphaCom Core

Upgrading Ubuntu 18.04 to 22.04

Upgrading Ubuntu from 18.04 is a two-step process:

Upgrade from 18.04 to 20.04
Upgrade from 20.04 to 22.04

The full process is described in this article: Upgrade ICX-AlphaCom Core to Ubuntu 22.04.

Post-Install

Maintenance and configuration of the Ubuntu Linux system should only be performed from the ICX-WEB.
Ubuntu services such as Networking, Firewall and NTP are over-written or disabled by the ICX-AlphaCom Core services
Modification of the Linux services directly may be ignored, or may affect system operation

Licensing

The ICX-AlphaCom Core requires a license to operate:

1002600000 - ICX-Core_x64 - Software package ICXCore for x64.

In addition, licenses are required for devices and services. For details see Licenses for ICX-500 and ICX-AlphaCom Core

After being installed, the ICX-AlphaCom Core will run on a 20-day free license period, allowing for test and demo without having to purchase licenses.