Actions

Upgrade ICX-AlphaCom Core to Ubuntu 22.04

From Zenitel Wiki

Icx icon.png

Ubuntu 18.04 LTS has reached the end of its General Support period.

New installations of ICX-AlphaCom require Ubuntu 22.04 LTS
Upgrading Ubuntu will require upgrading the ICX-AlphaCom Core installation.

ICX-AlphaCom Core 1.2.3.8 and below


The Upgrade requires several steps.

  • Backup your System.
  • Update and upgrade your current Ubuntu 18.04 with the current security and software updates
  • Upgrade your current Ubuntu 18.04 to the latest Linux distribution
  • Upgrade your current Ubuntu 18.04 to 20.04
  • Add PHP8.1 repository
  • Upgrade your ICX-AlphaCom Core to 1.2.3.9
  • Delete PHP7.2
  • Upgrade Ubuntu 20.04 to 22.04
  • Upgrade your ICX-AlphaCom Core to 1.3.3.0 from the command line.

Your Ubuntu OS will now be 22.04.

Note icon The ICX-AlphaCom system requires an internet connection for this process to take place and the system must be rebooted several times.


Warning icon The ICX-AlphaCom Core will be unavailable at times during the upgrade.


Backup your System

Perform a Get All from AlphaPro.

Use the System Maintenance / Backup tool to take a backup of your system.

More information is available from here; ICX Web#Backup and Restore

You can also use the VM host to take a snapshot of the current status of the system.

Update and upgrade your current Ubuntu 18.04 with the current security and software updates.

From the linux console, enter the following command.

sudo apt update && sudo apt upgrade -y


Once the process has completed, issue the following command.

sudo reboot


Upgrade your current Ubuntu 18.04 to the latest Linux distribution.

This step depends on whether the Linux Kernel of the Ubuntu 18.04 system has also been updated.

From the linux console, enter the following command.

sudo apt dist-upgrade -y


Once the process has completed, check if there have been any changes made.

If there are changes made, issue the following command.

sudo reboot


Otherwise, continue with the following step.

Upgrade your current Ubuntu 18.04 to Ubuntu 20.04

This step will upgrade your Ubuntu system to the intermediate step of 20.04.

From the linux console, enter the following command.

sudo do-release-upgrade


Note icon Not all these steps may need to be undertaken. There are several factors that determine whether you will see all of these steps, or only some of them.

Simply follow the directions of the steps as they appear according to the list below


  • If you are connected to the Ubuntu OS via SSH, you will receive a warning message regarding the loss of connection should something fail. Note the warning message and press Y to continue, followed by Enter at the next screen. If you are directly connected using the VM Console, you will not receive this message.
  • At the Third Party Sources warning, press Enter
  • At the Download warning message, press Y to continue.
  • At the Configuring libc6 pop-up box, choose Yes to restart services without asking
  • At the Configuring lxd pop-up box, choose 4.0
  • At the Configuring openssh-server pop up box, choose Keep the local version currently installed
  • At the snmp.conf warning, press Enter to select the default option
  • At the Obsolete Packages warning, choose Y to remove the unused packages
  • Finally, at the completion of the upgrade, choose Y to reboot the system


Add the PHP8.1 repository

From the linux console enter the following command.

sudo add-apt-repository ppa:ondrej/php


Upgrade your ICX-AlphaCom Core to 1.2.3.9

This step is performed using the Upgrade tab in System Maintenance on ICX-Web.

More information is available from here; ICX_Web#System_Upgrade

Delete the PHP7.2 installation

From the linux console, enter the following command.

sudo apt purge php7.2*


Upgrade Ubuntu 20.04 to 22.04

This step will upgrade your Ubuntu system to the final step of 22.04

From the linux console, enter the following command.

sudo apt update && sudo apt upgrade -y


Once the process has completed, check if there has been any changes made.

If there are changes made, issue the following command.

sudo reboot


Otherwise, continue with the following step.

From the linux console, enter the following command.

sudo do-release-upgrade


  • If you are connected to the Ubuntu OS via SSH, you will receive a warning message regarding the loss of connection should something fail. Note the warning message and press Y to continue, followed by Enter at the next screen. If you are directly connected using the VM Console, you will not receive this message.
  • At the Download warning message, press Y to continue.
  • At the Configuring openssh-server pop up box, choose Keep the local version currently installed
  • At the Obsolete Packages warning, choose Y to remove the unused packages
  • Finally, at the completion of the upgrade, choose Y to reboot the system


Upgrade ICX-AlphaCom Core to 1.3.3.0

To upgrade the ICX-AlphaCom Core from 1.2.3.9 to 1.3.3.0, you will be required to install from the Command Line.

  • Transfer the installer ICX-Core-01.00-jammy-1.3.3.0.apt.tar to the Ubuntu host using WinSCP
  • Install the file using the following command
sudo tar -xf ICX-Core-01.00-jammy-1.3.3.0.apt.tar install.sh --to-command /bin/sh


Related articles