Actions

Difference between revisions of "ICX-AlphaCom Core - Installation"

From Zenitel Wiki

 
(16 intermediate revisions by 4 users not shown)
Line 8: Line 8:
 
*'''Memory''': 1 GByte
 
*'''Memory''': 1 GByte
 
*'''Harddisk''': 15 GByte
 
*'''Harddisk''': 15 GByte
*'''Operating System''': Linux - Ubuntu 18.04.x LTS Server - this is a strict requirement
+
*'''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:
 
*'''Virtual Machine''': The VM must be defined with:
 
**1 processor
 
**1 processor
 
**1 GB RAM
 
**1 GB RAM
 
**15 GB harddisk as a minimum
 
**15 GB harddisk as a minimum
{{code|DO NOT UPGRADE UBUNTU FROM 18.04 EVEN IF OFFERED BY THE SYSTEM. THIS WILL IRREVERSIBLY BREAK THE ICX-ALPHACOM CORE INSTALLATION}}
+
{{warn|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}}
  
 
<br />
 
<br />
Line 23: Line 27:
 
**Installations performed using SSH connection (Putty, Tera Term etc.) might fail due to network changes during installation.
 
**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.
 
**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, in either case make certain that Ubuntu 18.04 Server is installed
+
*ICX-AlphaCom Core can run directly on a PC or in a VM, note the [[ICX-AlphaCom_Core_-_Installation#Minimum requirements|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.
 
*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 version ICX-AlphaCom Core 1.0.3.0, any previously installed beta-version of ICX-AlphaCom Core must be removed. Command: '''sudo apt purge vs-<nowiki>'*'</nowiki>'''
+
*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-<nowiki>'*'</nowiki>'''
  
 
'''Upload:'''
 
'''Upload:'''
  
 
*Upload the ICX-AlphaCom Core software to your home directory of the VM,  using for example WinSCP
 
*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.0.3.2.apt.tar”
+
*Example file: “ICX-Core-01.00-jammy-1.3.3.0.apt.tar”
  
 
'''Install:'''
 
'''Install:'''
  
 
*From the Linux console, install the ICX-AlphaCom Core software with the following command:
 
*From the Linux console, install the ICX-AlphaCom Core software with the following command:
{{code|sudo tar -xf ICX-Core-01.00-bionic-1.1.3.0.apt.tar install.sh --to-command /bin/sh}}
+
{{code|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'''
  
*After first time installation, later ICX-AlphaCom Core upgrades can be done from the ICX-WEB menu: '''System Maintenance''' -> '''System Upgrade'''
+
{{warn|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}}
  
== Post-Install ==
+
===Upgrading Ubuntu 18.04 to 22.04===
 +
Upgrading Ubuntu from 18.04 is a two-step process:
  
* '''Maintenance and configuration of the Ubuntu Linux system should only be performed from the ICX-WEB.'''
+
*Upgrade from 18.04 to 20.04
* Ubuntu services such as Networking, Firewall and NTP are over-written or disabled by the ICX-AlphaCom Core services
+
*Upgrade from 20.04 to 22.04
* Modification of the Linux services directly may be ignored, or may affect system operation
+
 
 +
The full process is described in this article: [[Upgrade_ICX-AlphaCom_Core_to_Ubuntu_22.04|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==
 
==Licensing==
Line 58: Line 75:
  
 
*[[ICX-AlphaCom Core in VirtualBox|Installation of ICX-AlphaCom Core in VirtualBox environment]]
 
*[[ICX-AlphaCom Core in VirtualBox|Installation of ICX-AlphaCom Core in VirtualBox environment]]
 
+
*[[:Category: ICX Release notes|Software Release Notes]]
<br>
 
  
 
[[Category: ICX-AlphaCom Platform]]
 
[[Category: ICX-AlphaCom Platform]]
 +
[[Category: ICX-Core]]
 +
[[Category: ICX Release notes]]

Latest revision as of 09:20, 6 March 2024

Icx icon.png

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
Warning icon 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-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

Warning icon 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.


Related articles