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 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-bionic-1.2.3.9.apt.tar”

Install:

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

sudo tar -xf ICX-Core-01.00-bionic-1.2.3.9.apt.tar install.sh --to-command /bin/sh

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

Upgrading ICX-Core and Ubuntu

Upgrading ICX-Core

Before upgrading Ubuntu to version 22.04, ICX-Core must be upgraded to version 1.2.3.9. Upgrading version 1.2.3.8 to 1.2.3.9 can be done via the ICX-AlphaCom web interface. Upgrading from an earlier version of ICX-Core requires an additional step:

Login into the VM console using the username and password when Ubuntu 18.04 was installed
Enter the following command:

sudo add-apt-repository ppa:ondrej/php

Now the ICX-AlphaCom web interface can be used to upgrade to ICX-AlphaCom version 1.2.3.9

Upgrading Ubuntu 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.