Troubleshooting

I Fedora Atomic Desktops utilizzano un nuovo metodo per distribuire e gestire il sistema operativo desktop; pertanto, potresti occasionalmente riscontrare dei problemi durante l’uso quotidiano. Di seguito sono elencati alcuni dei problemi segnalati più frequentemente e le relative soluzioni temporanee (workaround).

"Sostituzioni di pacchetti base non consentite"

"Questo può accadere quando un pacchetto che viene installato a livelli (layered) ha una dipendenza da un pacchetto presente nel sistema operativo di base. Nel caso problematico, il pacchetto stratificato richiede una versione più recente del pacchetto dipendente che non è disponibile nel sistema operativo di base.

"Nella maggior parte dei casi, attendere una nuova composizione (compose) di OSTree risolverà il problema. Il pacchetto dipendente verrà aggiornato nella nuova composizione e l’installazione stratificata del pacchetto desiderato andrà a buon fine.

"Tuttavia, se continui a riscontrare questo problema anche con una nuova composizione (compose), puoi provare a pulire i metadati con il comando`rpm-ostree cleanup -m`e successivamente riprovare l’operazione con`rpm-ostree install`.

In alternativa, puoi provare a eseguire il rebase su qualsiasi ref updates, come fedora/44/updates/x86_64 dopo l’operazione di cleanup.

"Per ulteriori informazioni, consulta rpm-ostree#415.

"Installazione di pacchetti in /opt`pt `/usr/local

L’installazione in /opt`è stata spesso segnalata come un problema dagli utenti che cercavano di installare Google Chrome. È stata implementata una soluzione parziale che consente agli utenti di aggiungere Google Chrome come layer; tuttavia, non rappresenta una soluzione completa per le applicazioni che scrivono dati mutabili in `/opt.

"Questo problema è tracciato in rpm-ostree#233.

"Utilizzo dei driver NVIDIA"

"Il progetto https://universal-blue.org/[Blue crea immagini del sistema operativo con i driver NVIDIA già inclusi. Le immagini di Universal Blue si basano sulle immagini di Fedora Atomic Desktop, con l’aggiunta di ulteriori modifiche a loro discrezione. Le immagini di Universal Blue non sono ufficialmente approvate dal Fedora Project. Utilizzale a tua discrezione.

"Puoi installare i driver binari ufficiali NVIDIA dai repository RPM Fusion.

"I driver binari NVIDIA non sono mantenuti dal Fedora Project e, a volte, potrebbero non essere disponibili per la versione del kernel inclusa nei Fedora Atomic Desktops.

  1. "Per prima cosa, assicurati che il tuo sistema sia completamente aggiornato eseguendo il comando`sudo rpm-ostree upgrade`e riavviando.

  2. "Quindi, configura i repository RPM Fusion seguendo lahttps://docs.fedoraproject.org/en-US/quick-docs/rpmfusion-setup/#_enabling_the_rpm_fusion_repositories_for_ostree_based_systems[ documentazione, inclusi i due riavvii previsti.

  3. "Infine, installa i driver:

    # rpm-ostree install kmod-nvidia xorg-x11-drv-nvidia
# rpm-ostree kargs --append=rd.driver.blacklist=nouveau,nova-core \
    --append=modprobe.blacklist=nouveau,nova-core \
    --append=nvidia-drm.modeset=1 \
    --append=initcall_blacklist=simpledrm_platform_driver_init
# systemctl reboot

"Quando si utilizza il Secure Boot, i driver NVIDIA installati localmente devono essere firmati con una chiave locale registrata tramite mokutil.https://github.com/fedora-silverblue/issue-tracker/issues/499[ Per ulteriori dettagli, consulta la segnalazione fedora-silverblue#499.

"Potresti inoltre riscontrare i seguenti problemi durante l’installazione:https://github.com/fedora-silverblue/issue-tracker/issues/286[ https://github.com/fedora-silverblue/issue-tracker/issues/286[#286, #331."

Grazie ad Alex Larsson che ha apportato le modifiche necessarie ai pacchetti akmods`e `kmodtools. Puoi leggere di più sul lavoro svolto da Alex sul suo blog.

Moduli del kernel "out-of-tree" e driver che utilizzano DKMS

I Fedora Atomic Desktops attualmente non supportano DKMS. Consulta il problema (issue) a monte: rpm-ostree#1091.

In alternativa, ti consigliamo di creare pacchetti kmods per i https://rpmfusion.org/Packaging/KernelModules/Kmods2[moduli del kernel "out-of-tree" e di inviarli ai repository di RPM Fusion. I pacchetti kmods verranno poihttps://rpmfusion.org/[ utilizzati da akmods, che è supportathttps://rpmfusion.org/Packaging/KernelModules/Akmods[o sui Fedora Atomic Desktops.

Aggiunta di repository di pacchetti esterni

Questa sezione tratta sorgenti software di terze parti non ufficialmente affiliate o approvate dal Fedora Project. Utilizzale a tua discrezione.
Se desideri utilizzare i repository RPM Fusion, segui la sezione [Abilitazione dei repository RPM Fusion] (xref:tips-and-tricks.adoc#_enabling_rpm_fusion_repos[.

Alcuni software potrebbero essere disponibili solo presso repository di terze parti. Sui Fedora Atomic Desktops, puoi aggiungere manualmente un repository esterno inserendo il file ..repo`in `/etc/yum.repos.d/`e la chiave GPG in/etc/pki/rpm-gpg/`. Di seguito è riportato un esempio completo per la configurazione del repository di Tailscale:

  1. Scarica e installa la configurazione del repository:

    $ curl -O https://pkgs.tailscale.com/stable/fedora/tailscale.repo
[tailscale-stable]
name=Tailscale stable
baseurl=https://pkgs.tailscale.com/stable/fedora/$basearch
enabled=1
type=rpm
repo_gpgcheck=1
gpgcheck=0
gpgkey=https://pkgs.tailscale.com/stable/fedora/repo.gpg
$ sudo install -o 0 -g 0 -m644 tailscale.repo /etc/yum.repos.d/tailscale.repo

  2. Scarica e installa le chiavi GPG:

    $ curl -O https://pkgs.tailscale.com/stable/fedora/repo.gpg
$ sudo install -o 0 -g 0 -m644 repo.gpg /etc/pki/rpm-gpg/tailscale.gpg

  3. Sostituisci l’URL della voce gpgkey== nella configurazione del repository con il percorso locale delle chiavi GPG:

    $ sudoedit /etc/yum.repos.d/tailscale.repo
$ cat /etc/yum.repos.d/tailscale.repo
[tailscale-stable]
name=Tailscale stable
baseurl=https://pkgs.tailscale.com/stable/fedora/$basearch
enabled=1
type=rpm
repo_gpgcheck=1
gpgcheck=0
### Update this line
gpgkey=file:///etc/pki/rpm-gpg/tailscale.gpg
###    ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^

  4. Installa i nuovi pacchetti con:

    $ rpm-ostree install tailscale

Un supporto migliore in`rpm-ostree`per questo caso d’uso è monitorato nel problema (issue) rpm-ostree#4014.

Problemi relativi a SELinux

Mentre gli utenti utilizzano quotidianamente i Fedora Atomic Desktops, è possibile che abbiano modificato la policy predefinita di SELinux nel tentativo di aggirare uno o più problemi ad esso correlati. Ciò accade solitamente quando un utente nota un diniego (denial) di SELinux nel journal di sistema. In tal caso, se si desidera ripristinare la policy predefinita di SELinux, è possibile provare questa serie di azioni.

  1. Controllare lo stato della policy di SELinux

    $ sudo ostree admin config-diff | grep policy
M    selinux/targeted/active/policy.linked
M    selinux/targeted/active/policy.kern
M    selinux/targeted/policy/policy.31
A    selinux/targeted/policy/policy.30

    Se questo comando restituisce un qualsiasi output, significa che la tua policy di SELinux è stata modificata rispetto a quella predefinita.

  2. Copia la policy predefinita di SELinux inclusa nella composizione OSTree

    $ sudo cp -al /etc/selinux{,.bak}
$ sudo rsync -rlv /usr/etc/selinux/ /etc/selinux/

    `ostree admin config-diff | grep policy`Dopo aver eseguito questa operazione, l’output del comando ostree admin config-diff | grep policy non dovrebbe più indicare che la policy è stata modificata.

    Se la policy risulta ancora modificata, puoi provare il seguente approccio.

  3. Rimuovere la policy di SELinux; copiare la policy predefinita

    $ sudo rm -rf /etc/selinux
$ sudo cp -aT /usr/etc/selinux /etc/selinux

    Dopo questa operazione, il comando`ostree admin config-diff | grep policy` non dovrebbe restituire alcuna modifica.

Impossibile aggiungere l’utente al gruppo

A causa del modo in cui rpm-ostree`gestisce le voci di utenti e gruppi, potrebbe non essere possibile utilizzare il comando`usermod -a -G per aggiungere con successo un utente a un gruppo. Fino a quando rpm-ostree non passerà all’utilizzo di systemd sysusers, gli utenti dovranno popolare il file`/etc/group`partendo dal file /usr/lib/group prima di potersi aggiungere al gruppo desiderato.

Ad esempio, se desideri aggiungere un utente al gruppo libvirt:

$ grep -E '^libvirt:' /usr/lib/group | sudo tee -a /etc/group
$ sudo usermod -aG libvirt $USER
Sarà necessario disconnettersi e rientrare (effettuare il log out e log in) per applicare queste modifiche.

Questo problema è monitorato in rpm-ostree#29 e rpm-ostree#49.

ostree fsck la corruzione di file

È possibile ritrovarsi in una situazione in cui uno o più file sul disco risultino corrotti o mancanti. In questo caso, ostree fsck segnalerà errori in determinati commit. La [soluzione temporanea](https://github.com/ostreedev/ostree/pull/345#issuecomment-262263824[) in questo caso consiste nel contrassegnare l’intero commit OSTree come parzialmente recuperato e procedere quindi a scaricarlo nuovamente.

Read-only /boot/efi prevents any upgrades

Questo problema si riscontra più comunemente quando gli utenti hanno installato Fedora Atomic Desktops su hardware Apple. La partizione`/boot/efi`sull’hardware Apple è formattata come HFS+ e non è sempre resiliente alle interruzioni di corrente o ad altri tipi di spegnimenti improvvisi.

Dato che i Fedora Atomic Desktops includono ora il pacchetto`hfsplus-tools` nella composizione di base, è diventato relativamente facile per gli utenti aggirare questo tipo di errore.

# umount /boot/efi
# fsck.hfsplus /dev/sda1
# mount -o rw /boot/efi

Consulta la "issue" di GitHub rpm-ostree#1380 per ulteriori dettagli.

Impossibile installare Fedora Atomic Desktop su sistemi EFI

Alcuni utenti hanno riferito di non riuscire a installare un Fedora Atomic Desktop su un sistema basato su EFI dove era precedentemente installato un altro sistema operativo. L’errore che viene osservato più spesso è simile al seguente:

ostree ['admin', '--sysroot=/mnt/sysimage', 'deploy', '--os=fedora-workstation', 'fedora-workstation:fedora/28/x86_64/workstation'] è uscito con codice d'errore -6

Esistono un paio di possibili soluzioni temporanee (workaround):

  • Se la soluzione precedente non dovesse funzionare, prova quanto segue: durante il processo di installazione, seleziona la partizione EFI esistente e riformattala, impostando il punto di mount su /boot/efi. Tieni presente che, procedendo in questo modo, non sarai più in grado di avviare il sistema operativo (o i sistemi operativi) installato precedentemente.

  • Riformatta la partizione EFI dell’host durante il processo di installazione. Puoi farlo selezionando "Partizionamento personalizzato" e spuntando la casella Reformat(Riformatta) durante la creazione o la configurazione della partizione da assegnare a /boot/efi.

Scegliere di riformattare `/boot/efi`comporterà probabilmente l’impossibilità di avviare qualsiasi altro sistema operativo precedentemente installato. Assicurati di aver effettuato il backup di tutti i dati importanti prima di utilizzare questa soluzione temporanea.

Questo problema è monitorato in Bugzilla#1575957.

toolbox: impossibile elencare le immagini con com.redhat.component=fedora-toolbox

A partire dalla versione`1.4.0`di podman, questa soluzione temporanea (workaround) non è più necessaria. Assicurati che`podman` sia aggiornato eseguendo il comando`rpm-ostree upgrade`prima di tentare questa procedura.

Quando si esegue il comando toolbox list, i sistemi che utilizzano versioni di podman successive alla `1.2.0`genereranno il seguente errore:

toolbox: impossibile elencare le immagini con com.redhat.component=fedora-toolbox

La seguente soluzione temporanea potrebbe essere utile per altri errori di toolbox`causati da versioni di `podman`superiori alla `1.2.0 Vedihttps://github.com/containers/toolbox/issues/169#issuecomment-495193902[ toolbox#169.

Come soluzione temporanea, è possibile sovrascrivere le versioni di podman successive alla`1.2.0` eseguendo il comando:

$ rpm-ostree override --remove=podman-manpages \
   replace https://kojipkgs.fedoraproject.org//packages/podman/1.2.0/2.git3bd528e.fc30/x86_64/podman-1.2.0-2.git3bd528e.fc30.x86_64.rpm

Reboot the system to apply the changes.

Per riferimento, è inoltre possibile sovrascrivere il pacchetto seguendo questi passaggi:

  1. Download podman-1.2.0-2.git3bd528e.fc30.x86_64.rpm from Koji.

  2. Rimuovi`podman-manpages`eseguendo:`rpm-ostree override remove podman-manpages`.

  3. Sostituisci il pacchetto `podman`attualmente installato (utilizzando il pacchetto che hai scaricato nel primo passaggio) eseguendo:

    $ rpm-ostree override replace podman-1.2.0-2.git3bd528e.fc30.x86_64.rpm

Ora puoi riavviare il sistema affinché la modifica diventi effettiva.

Per annullare questa soluzione temporanea e ripristinare la configurazione originale, esegui i seguenti comandi:

$ rpm-ostree override reset podman
$ rpm-ostree override reset podman-manpages

Impossibile accedere a un toolbox a causa di errori di permessi

Con alcune versioni di`podman`, il tentativo di accedere a un toolbox causerà degli errori. È possibile risolvere il problema ripristinando i permessi sui contenitori overlay con il seguente comando:

$ sudo chown -R $USER ~/.local/share/containers/storage/overlay-containers

Questo ripristinerà i permessi sui tuoi container e ti permetterà di accedervi nuovamente.

Vedi il problema di podman a monte: podman#3187.

In esecuzione`restorecon`

Non si dovrebbe mai eseguire `restorecon`su un sistema Fedora Atomic Desktop. Vedere il seguente bug per i dettagli - Bugzilla#1259018

Tuttavia, se ti è capitato di farlo, è possibile rimediare.

  1. Avvia con`enforcing=0` nella riga di comando del kernel

  2. Crea un nuovo commit "corretto" localmente

  3. Distribuisci il nuovo commit "corretto"

  4. Run restorecon

  5. Riavvia

  6. Pulizia

$ rpm-ostree status -b | grep BaseCommit
              BaseCommit: 696991d589980aeaef5eda352dd7ad3d33c444c789c209f793a84bc6e7269aee
### If the above command does not display any output, try:
$ rpm-ostree status -b | grep Commit
              Commit: 696991d589980aeaef5eda352dd7ad3d33c444c789c209f793a84bc6e7269aee
$ sudo ostree checkout \
    -H 696991d589980aeaef5eda352dd7ad3d33c444c789c209f793a84bc6e7269aee \
    /ostree/repo/tmp/selinux-fix
$ sudo ostree fsck --delete
$ sudo ostree commit --consume \
    --link-checkout-speedup --orphan --selinux-policy=/ /ostree/repo/tmp/selinux-fix
$ sudo restorecon -Rv /var
$ sudo restorecon -Rv /etc
### In the command below, substitute:
### - x86_64 with your actual CPU architecture
### - silverblue with the name for your Fedora Atomic Desktop variant
$ sudo ostree admin deploy fedora:fedora/44/x86_64/silverblue
$ sudo reboot

L’avvertenza per questo ripristino è che i pacchetti stratificati verranno rimossi; sarà necessario reinstallarli dopo il recupero.

Vedi questo commento a monte per ulteriori dettagli: ostree#1265.

Ripristino delle password in Modalità di Ripristino (Rescue Mode)

Nel caso in cui non sia possibile ricordare la password utente o la password di root, è possibile reimpostarla seguendo questi passaggi:

  1. Mentre il sistema si avvia, interrompi la sequenza di boot nel menuhttps://docs.fedoraproject.org/en-US/quick-docs/grub2-bootloader/[ GRUB2 utilizzando il tasto Esc.

  2. Durante l’avvio del sistema, interrompi la sequenza di boot nel menu grub2 utilizzando il tasto Esc.

  3. Modifica la voce selezionata con il tasto e.

  4. `linuxlinux16linuxefi`Modifica la voce selezionata con il tasto e.

  5. Usa i tasti freccia per selezionare la riga che inizia con linux, linux16 o linuxefi.init=/bin/bash.

  6. Press Ctrl + x or F10 to boot the entry.

  7. Al prompt `bash`risultante, esegui i seguenti comandi:

# mount -t selinuxfs selinuxfs /sys/fs/selinux
# /sbin/load_policy
# passw
# sync
# /sbin/reboot -ff

Se desideri cambiare la password per un account utente specifico, sostituisci il comando passwd`con `passwd <username><username>.

Al termine del riavvio del sistema, dovresti essere in grado di accedere con il tuo nome utente e la nuova password.

Want to help? Learn how to contribute to Fedora Docs ›