Upgrade Ubuntu

Please follow this process when upgrading Ubuntu on your Corellium appliance.

Your devices and settings will be preserved during the upgrade.

Run the Ubuntu Upgrade Script

Download the Ubuntu upgrade package tarball from the Files Portal. The URL and login details can be found in your Initial Networking Configuration and Passwords document.

1. Transfer the Corellium Ubuntu upgrade (the .tar.xz tarball) to the Controller Node (e.g. via SCP) into the home directory of the root user at /root.

2. SSH into the appliance as root into the /root/ directory.

3. Stop all devices via corellium-coordinator instance stop-all.

   root@jtest1-1:~# corellium-coordinator instance stop-all
   {"level":"info","time":1701988266608,"cluster":{"name":"jtest-1","domain":"jtest-1.corellium.net"},"host":"jtest1-1","service":"corellium-coordinator","activeInstanceIds":["12d6eba0-3b7d-4b6a-ae59-9a6f2f5e08e5","4bbb73a7-6881-497a-8af9-c8ba24add3b3","efde3efc-3b44-4bb5-91f9-39c65b824e10","ffb795dd-61af-47f0-a103-453d41b5d3db"],"msg":"Active instances to stop:"}

4. On the Devices page of the web interface, verify that all devices are off. (Any devices that are not off will be lost and may cause post-upgrade issues.)

5. Over SSH, extract the Corellium Ubuntu upgrade via tar xvf <ubuntu_upgrade_name>.tar.xz. The files should all be extracted to /root/<ubuntu_upgrade_name>/

   root@jtest1-1:~# ls -lh *.tar.xz
   -rw-r--r-- 1 root root 2.5G Dec  7 13:56 ubuntu_upgrade_18.tar.xz
   root@jtest1-1:~# tar xvf ubuntu_upgrade_18.tar.xz 
   jtest-1-ubuntu_upgrade_18/
   jtest-1-ubuntu_upgrade_18/fwupdater/
   ...

6. Change the directory to the top directory of the update.

   root@jtest1-1:~# cd jtest1-ubuntu_upgrade_18/

7. Start the updater: ./install.sh.

   root@jtest1-1:~/jtest1-ubuntu_upgrade_18# ./install.sh 
   Corellium installer started. Please configure Corellium by visiting the installation site at one of the following address(es):
       https://10.10.0.203:8086/

8. Open the URL listed by install.sh in the browser of a workstation that has access to the Corellium server.

9. Ensure that Reset Corellium is not checked. Please note that checking this will completely reset Corellium and all users, teams, projects, and virtual devices will be permanently lost.

   

10. Click RECONFIGURE CORELLIUM at the bottom of the page.

11. Wait for the process to finish and for the servers to reboot. (This process can take up to an hour.)

    

12. SSH into the appliance. Verify the upgrade was successful by checking the OS version.

    root@jtest1-1:~# grep VERSION /etc/os-release
    VERSION="18.04.6 LTS (Bionic Beaver)"
    VERSION_ID="18.04"
    VERSION_CODENAME=bionic

After upgrading Ubuntu, proceed to the next step to install Corellium.

Install Corellium After Upgrading Ubuntu

After you've upgraded Ubuntu, install the appropriate Corellium release. (The instructions are included below for your convenience.)

1. Transfer the Corellium installation package (the .tar.xz tarball) to the Controller Node (e.g. via SCP) into the root user's home directory at /root.

2. SSH into the Controller Node.

3. Over SSH, extract the Corellium installation package via tar xvf <corellium_release_name>.tar.xz. The files should all be extracted to /root/<corellium_release_name>

4. Change the directory into the top directory of the update: cd <corellium_release_name>

5. Start the updater: ./install.sh.

6. Open the URL listed by install.sh in the browser of a workstation that has access to the Corellium server.

7. Fill out the required information. For more details, please read the Architecture Overview. Your settings should have transferred, but make sure they are correct.

8. Ensure that Reset Corellium is not checked. Please note that checking this will completely reset Corellium and all users, teams, projects, and virtual devices will be permanently lost.

   

9. Click Upgrade Corellium at the bottom of the page.

10. Wait for the process to finish and for the servers to reboot. (This process can take up to an hour.)