View source for Upgrade ICX-AlphaCom Core to Ubuntu 22.04

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

New installations of ICX-AlphaCom require Ubuntu 22.04 LTS<br>Upgrading Ubuntu will require upgrading the ICX-AlphaCom Core installation.
==ICX-AlphaCom Core 1.2.3.8 and below==
<br>
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| The ICX-AlphaCom system requires an internet connection for this process to take place and the system must be rebooted several times.}}  
{{Warn| 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. {{Code| sudo apt update && sudo apt upgrade -y}}

Once the process has completed, issue the following command. {{Code| 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. {{Code| 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. {{Code| 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. {{Code| sudo do-release-upgrade}}

{{Note| 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

<br />

===Add the PHP8.1 repository===
From the linux console enter the following command.{{Code| 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.{{Code| 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. {{Code| 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. {{Code| sudo reboot}}

Otherwise, continue with the following step.

From the linux console, enter the following command.  {{Code| 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

<br />

=== 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
{{code| sudo tar -xf ICX-Core-01.00-jammy-1.3.3.0.apt.tar install.sh --to-command /bin/sh}}

==Related articles==

*[[:Category: ICX Release notes|Software Release Notes]]

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