KB 2808: UPDATING THE DEBIAN LINUX SYSTEM ON OLFEO VIRTUAL APPLIANCES

Update the Debian Linux 9 or 10 system to Debian 11 on Olfeo virtual appliances running on VMware/Hyper-V.

Here, we will upgrade from Debian 9 to Debian 11.
We will perform this upgrade gradually, starting with upgrading
-> Debian 9 to Debian 10, and then
-> Debian 10 to Debian 11.

Warning

The upgrade of the machines concerned must be carried out when they are not in production, 
one by one, so as not to disrupt your company's network activity.

 

PROCEDURE

BACKING UP THE APPLIANCE AND CHECKING THE CURRENT DEBIAN VERSION

  1. We start by backing up our virtual machine; a snapshot in VMware or Hyper-V is sufficient.
  2. We then check which version of Debian we are running by typing the following command: lsb_release -a Result on Debian 9:Result under Debian 10:
  3. If you are running Debian 10, you can skip to the section "Upgrade Debian 10 to Debian 11."

UPGRADE FROM DEBIAN 9 TO DEBIAN 10

  1. We start by updating our system: apt update
    apt upgrade
    apt full-upgrade
  2. We then go to the /etc/apt/source.list file where we replace "stretch" with "buster."
  3. We rerun the previous commands to retrieve the Debian 10 updates: apt update
    apt upgrade
    apt full-upgrade If you encounter this screen during the upgrade, you can select "Yes."
  4. Following the update and upgrade, we can restart the machine: reboot
  5. We verify that we have successfully upgraded to Debian 10: lsb_release -a

UPGRADE FROM DEBIAN 10 TO DEBIAN 11

  1. We start by updating our system: apt update
    apt upgrade
    apt full-upgrade
  2. We then go to the /etc/apt/source.list file where we replace "buster" with "bullseye" and "buster/updates" with "bullseye-security."
    Our file should look like this:
  3. We rerun the previous commands to retrieve the Debian 11 updates: apt update
    apt upgrade
    apt full-upgrade
  4. Once the update and upgrade are complete, we run a command to clean up unnecessary packages: apt autoremove –purge
  5. We can restart the machine: reboot
  6. We verify that we have successfully upgraded to Debian 11: lsb_release -a

OLFEO SERVICES AUDIT

To check the status of Olfeo services.
We enter the Olfeo chroot:

chroot /opt/olfeo/chroot/

We then enter the following command:

./olfeo-status.sh

If services are not started correctly, you can type the following command to restart the services:

./olfeo-stop.sh && ./olfeo-start.sh

Install-Module Microsoft.Graph -Scope CurrentUser
Connect-MgGraph

Step 3: Collect User Information

In order to launch a campaign in Olfeo Awareness, we need to collect the email address, first name, and last name of each participant. In a directory, this data generally corresponds to the attributes userPrincipalName, givenName, and surname.

Depending on the configuration of your directory, it may be necessary to use other attributes instead of these.

Use the Get-MgUser command to retrieve users, select the desired attributes (userPrincipalName, givenName, surname):

$users = Get-MgUser -All -Select userPrincipalName, givenName, lastName

Step 4: Export users to a CSV file

Export the retrieved data to a CSV file with the following command, then click "manage files" to download the file:

$users | Select-Object userPrincipalName, givenName, surname | Export-Csv -Path "/home/admin/users.csv" -Delimiter ";" -NoTypeInformation

Once the CSV file has been retrieved, in the first row, replace userPrincipalName, givenName, and surname with email, first_name, and last_name.

You are now ready to create a new awareness campaign by importing the desired participants!