Red Hat Training

A Red Hat training course is available for RHEL 8

Apêndice A. Solução de problemas

As seções seguintes cobrem várias informações de solução de problemas que podem ser úteis ao diagnosticar problemas durante diferentes estágios do processo de instalação.

A.1. Solução de problemas no início do processo de instalação

As informações de solução de problemas nas seções seguintes podem ser úteis ao diagnosticar problemas no início do processo de instalação. As seções a seguir são para todas as arquiteturas suportadas. Entretanto, se um problema é para uma determinada arquitetura, ele é especificado no início da seção.

A.1.1. Dracut

Dracut é uma ferramenta que gerencia a imagem initramfs durante o processo de inicialização do sistema operacional Linux. O shell de emergência dracut é um modo interativo que pode ser iniciado enquanto a imagem initramfs é carregada. Você pode executar comandos básicos de solução de problemas a partir do shell de emergência dracut. Para mais informações, consulte a seção Troubleshooting da página de manual dracut.

A.1.2. Usando arquivos de log de instalação

Para fins de depuração, o programa de instalação registra as ações de instalação em arquivos que estão localizados no diretório /tmp. Estes arquivos de log estão listados na tabela a seguir.

Tabela A.1. Arquivos de log gerados durante a instalação

Arquivo de logConteúdo

/tmp/anaconda.log

Mensagens gerais.

/tmp/program.log

Todos os programas externos são executados durante a instalação.

/tmp/storage.log

Informações de módulo de armazenamento extensivo.

/tmp/packaging.log

mensagens de instalação de pacotes de yum e rpm.

/tmp/dbus.log

Informações sobre a sessão dbus que é utilizada para os módulos do programa de instalação.

/tmp/ifcfg.log

Informações sobre roteiros de rede.

/tmp/sensitive-info.log

Informações de configuração que não fazem parte de outros logs e não são copiadas para o sistema instalado.

/tmp/syslog

Mensagens de sistema relacionadas com o hardware.

Se a instalação falhar, as mensagens são consolidadas em /tmp/anaconda-tb-identifier, onde o identificador é uma cadeia aleatória. Após uma instalação bem sucedida, estes arquivos são copiados para o sistema instalado sob o diretório /var/log/anaconda/. Entretanto, se a instalação não for bem sucedida, ou se as opções inst.nosave=all ou inst.nosave=logs forem utilizadas ao iniciar o sistema de instalação, estes logs só existem no disco RAM do programa de instalação. Isto significa que os logs não são salvos permanentemente e são perdidos quando o sistema é desligado. Para armazená-los permanentemente, copie os arquivos para outro sistema na rede ou copie-os para um dispositivo de armazenamento montado, como uma unidade flash USB.

A.1.2.1. Criação de arquivos de log de pré-instalação

Use este procedimento para definir a opção inst.debug para criar arquivos de log antes do início do processo de instalação. Estes arquivos de registro contêm, por exemplo, a configuração atual de armazenamento.

Pré-requisitos

  • O menu de inicialização do Red Hat Enterprise Linux é exibido.

Procedimento

  1. Selecione a opção Install Red Hat Enterprise Linux a partir do menu de inicialização.
  2. Pressione a tecla Tab em sistemas baseados em BIOS ou a tecla e em sistemas baseados em UEFI para editar as opções de inicialização selecionadas.
  3. Anexar inst.debug às opções. Por exemplo:

    vmlinuz ... inst.debug
  4. Pressione a tecla Enter em seu teclado. O sistema armazena os arquivos de log de pré-instalação no diretório /tmp/pre-anaconda-logs/ antes do início do programa de instalação.
  5. Para acessar os arquivos de log, mude para o console.
  6. Mude para o diretório /tmp/pre-anaconda-logs/:

    # cd /tmp/pre-anaconda-logs/

    Recursos adicionais

A.1.2.2. Transferência de arquivos de log de instalação para uma unidade USB

Use este procedimento para transferir arquivos de log de instalação para um drive USB.

Pré-requisitos

  • Faça backup de quaisquer dados no drive USB antes de usar este procedimento.
  • Você está logado em uma conta raiz e tem acesso ao sistema de arquivos temporários do programa de instalação.

Procedimento

  1. Pressione Ctrl Alt F2 para acessar um prompt de shell no sistema que você está instalando.
  2. Conecte uma unidade flash USB ao sistema e execute o comando dmesg:

    # dmesg

    É exibido um registro detalhando todos os eventos recentes. No final deste log, um conjunto de mensagens é exibido. Por exemplo:

    [ 170.171135] sd 5:0:0:0:0: [sdb] Disco removível SCSI anexo
  3. Anote o nome do dispositivo conectado. No exemplo acima, é sdb.
  4. Navegue até o diretório /mnt e crie um novo diretório que sirva como alvo de montagem para a unidade USB. Este exemplo usa o nome usb:

    # mkdir usb
  5. Monte a unidade flash USB no diretório recém-criado. Na maioria dos casos, você não quer montar a unidade inteira, mas uma partição sobre ela. Não use o nome sdb, use o nome da partição para a qual você deseja escrever os arquivos de log. Neste exemplo, é usado o nome sdb1:

    # montar /dev/sdb1 /mnt/usb
  6. Verifique se você montou o dispositivo e a partição correta acessando-o e listando seu conteúdo:

    # cd /mnt/usb
    # ls
  7. Copiar os arquivos de registro para o dispositivo montado.

    # cp /tmp/*log /mnt/usb
  8. Desmontar a unidade flash USB. Se você receber uma mensagem de erro de que o alvo está ocupado, mude seu diretório de trabalho para fora da montagem (por exemplo, /).

    # umount /mnt/usb

A.1.2.3. Transferência de arquivos de log de instalação através da rede

Use este procedimento para transferir arquivos de log de instalação através da rede.

Pré-requisitos

  • Você está logado em uma conta raiz e tem acesso ao sistema de arquivos temporários do programa de instalação.

Procedimento

  1. Pressione Ctrl Alt F2 para acessar um prompt de shell no sistema que você está instalando.
  2. Mude para o diretório /tmp onde estão localizados os arquivos de log:

    # cd /tmp
  3. Copie os arquivos de log em outro sistema da rede usando o comando scp:

    # scp *log user@address:path
    1. Substitua user por um nome de usuário válido no sistema alvo, address pelo endereço ou nome do host do sistema alvo, e path pelo caminho para o diretório onde você deseja salvar os arquivos de log. Por exemplo, se você quiser entrar como john em um sistema com um endereço IP de 192.168.0.122 e colocar os arquivos de log no diretório /home/john/logs/ nesse sistema, o comando é o seguinte:

      # scp *log john@192.168.0.122:/home/john/logs/

      Ao conectar-se ao sistema alvo pela primeira vez, o cliente SSH lhe pede para confirmar que a impressão digital do sistema remoto está correta e que você deseja continuar:

      The authenticity of host '192.168.0.122 (192.168.0.122)' can't be established.
      ECDSA key fingerprint is a4:60:76:eb:b2:d0:aa:23:af:3d:59:5c:de:bb:c4:42.
      Are you sure you want to continue connecting (yes/no)?
    2. Digite yes e pressione Enter para continuar. Forneça uma senha válida quando solicitado. Os arquivos são transferidos para o diretório especificado no sistema de destino.

A.1.3. Detecção de falhas de memória usando a aplicação Memtest86

Falhas nos módulos de memória (RAM) podem fazer com que seu sistema falhe de forma imprevisível. Em certas situações, as falhas de memória podem causar erros apenas com combinações particulares de software. Por esta razão, você deve testar a memória de seu sistema antes de instalar o Red Hat Enterprise Linux.

Nota

O Red Hat Enterprise Linux inclui a aplicação de teste de memória Memtest86 apenas para sistemas BIOS. O suporte para sistemas UEFI está atualmente indisponível.

A.1.3.1. Memtest86 em funcionamento

Use este procedimento para executar o aplicativo Memtest86 para testar a memória de seu sistema quanto a falhas antes de instalar o Red Hat Enterprise Linux.

Pré-requisitos

  • Você acessou o menu de inicialização do Red Hat Enterprise Linux.

Procedimento

  1. A partir do menu de inicialização do Red Hat Enterprise Linux, selecione Troubleshooting > Run a memory test. A janela Memtest86 da aplicação é exibida e os testes começam imediatamente. Por default, Memtest86 realiza dez testes em cada passe. Após o primeiro passe estar completo, uma mensagem é exibida na parte inferior da janela, informando o status atual. Outro passe começa automaticamente.

    Se Memtest86 detecta um erro, o erro é exibido no painel central da janela e é destacado em vermelho. A mensagem inclui informações detalhadas, como qual teste detectou um problema, a localização da memória que está falhando e outros. Na maioria dos casos, uma única passagem bem sucedida de todos os 10 testes é suficiente para verificar se sua RAM está em boas condições. Em raras circunstâncias, porém, erros que não foram detectados durante o primeiro passe podem aparecer em passes subseqüentes. Para realizar um teste completo em sistemas importantes, execute os testes durante a noite ou por alguns dias para completar vários passes.

    Nota

    O tempo necessário para completar uma única passagem completa de Memtest86 varia dependendo da configuração de seu sistema, notadamente o tamanho e a velocidade da RAM. Por exemplo, em um sistema com 2 GiB de memória DDR2 a 667 MHz, uma única passagem leva 20 minutos para ser completada.

  2. Opcional: Siga as instruções na tela para acessar a janela Configuration e especifique uma configuração diferente.
  3. Para interromper os testes e reiniciar seu computador, pressione a tecla Esc a qualquer momento.

Recursos adicionais

A.1.4. Verificação da mídia de inicialização

A verificação das imagens ISO ajuda a evitar problemas que às vezes são encontrados durante a instalação. Estas fontes incluem imagens em DVD e ISO armazenadas em um disco rígido ou servidor NFS. Use este procedimento para testar a integridade de uma fonte de instalação baseada em ISO antes de usá-la para instalar o Red Hat Enterprise Linux.

Pré-requisitos

  • Você acessou o menu de inicialização do Red Hat Enterprise Linux.

Procedimento

  1. No menu de inicialização, selecione Test this media & install Red Hat Enterprise Linux 8.1 para testar a mídia de inicialização.
  2. O processo de inicialização testa a mídia e destaca quaisquer problemas.
  3. Opcional: Você pode iniciar o processo de verificação anexando rd.live.check à linha de comando da inicialização.

A.1.5. Consoles e logging durante a instalação

O instalador do Red Hat Enterprise Linux usa o tmux multiplexador de terminal para exibir e controlar várias janelas além da interface principal. Cada uma destas janelas tem um propósito diferente; elas exibem vários logs diferentes, que podem ser usados para solucionar problemas durante o processo de instalação. Uma das janelas fornece um prompt de shell interativo com privilégios root, a menos que este prompt tenha sido especificamente desativado usando uma opção de inicialização ou um comando Kickstart.

Nota

Em geral, não há motivo para deixar o ambiente de instalação gráfica padrão a menos que seja necessário diagnosticar um problema de instalação.

O multiplexador de terminal está rodando no console virtual 1. Para mudar do ambiente de instalação real para tmux, imprensa Ctrl+Alt+F1. Para voltar à interface principal de instalação que roda no console virtual 6, pressione Ctrl+Alt+F6.

Nota

Se você escolher a instalação em modo texto, você começará no console virtual 1 (tmux), e mudar para o console 6 abrirá uma janela de comandos em vez de uma interface gráfica.

O console em funcionamento tmux tem cinco janelas disponíveis; seu conteúdo está descrito na tabela a seguir, juntamente com atalhos de teclado. Observe que os atalhos de teclado são em duas partes: primeira pressione Ctrl+bEm seguida, solte ambas as teclas e pressione a tecla numérica para a janela que você deseja usar.

Você também pode usar Ctrl+b n, Alt Tab, e Ctrl+b p para mudar para o próximo ou anterior tmux janela, respectivamente.

Tabela A.2. Janelas de tmux disponíveis

AtalhoConteúdo

Ctrl+b 1

Janela principal do programa de instalação. Contém avisos baseados em texto (durante a instalação em modo texto ou se você usar o modo VNC direto), e também algumas informações de depuração.

Ctrl+b 2

Prontidão de shell interativa com privilégios root.

Ctrl+b 3

Log de instalação; exibe mensagens armazenadas em /tmp/anaconda.log.

Ctrl+b 4

Log de armazenamento; exibe mensagens relacionadas a dispositivos de armazenamento e configuração, armazenadas em /tmp/storage.log.

Ctrl+b 5

Log do programa; exibe mensagens de utilidades executadas durante o processo de instalação, armazenadas em /tmp/program.log.

A.1.6. Salvando screenshots

Você pode pressionar Turno+Tela de impressão a qualquer momento durante a instalação gráfica para capturar a tela atual. As capturas de tela são salvas em /tmp/anaconda-screenshots.

A.1.7. Retomando uma tentativa de download interrompida

Você pode retomar um download interrompido usando o comando curl.

Pré-requisito

  • Você navegou até a seção Product Downloads do Portal do Cliente da Red Hat em https://access.redhat.com/downloads, e selecionou a variante, versão e arquitetura necessárias.
  • Você clicou com o botão direito do mouse no arquivo ISO necessário e selecionou Copy Link Location para copiar a URL do arquivo de imagem ISO para sua área de transferência.

Procedimento

  1. Faça o download da imagem ISO a partir do novo link. Adicione a opção --continue-at - para retomar o download automaticamente:

    US$ curl --output directory-path/filename.iso 'new_copied_link_location' --continue-at -
  2. Use um utilitário de soma de controle, como sha256sum para verificar a integridade do arquivo de imagem após o término do download:

    $ sha256sum rhel-8.1-x86_64-dvd.iso
    			`85a...46c rhel-8.1-x86_64-dvd.iso`

    Compare a saída com os checksums de referência fornecidos na página web do Red Hat Enterprise Linux Product Download.

Exemplo A.1. Retomando uma tentativa de download interrompida

O seguinte é um exemplo de comando curl para uma imagem ISO parcialmente baixada:

$ enrolar --saída _rhel-8.1-x86_64-dvd.iso 'https://access.cdn.redhat.com//content/origin/files/sha256/85/85a...46c/rhel-8.1-x86_64-dvd.iso?_auth=141...963' -continuar-em -

A.1.8. Não é possível inicializar na instalação gráfica

Algumas placas de vídeo têm dificuldade de inicialização no programa de instalação gráfica do Red Hat Enterprise Linux. Se o programa de instalação não for executado usando suas configurações default, ele tenta executar em um modo de resolução mais baixa. Se isso falhar, o programa de instalação tenta rodar em modo texto. Há várias soluções possíveis para resolver problemas de exibição, a maioria das quais envolve a especificação de opções de inicialização personalizadas. Para mais informações, veja Seção D.3, “Opções de inicialização do console”.

Tabela A.3. Soluções

SoluçãoDescrição

Use o modo gráfico básico

Você pode tentar realizar a instalação usando o driver gráfico básico. Para isso, selecione Troubleshooting > Install Red Hat Enterprise Linux 8.1 in basic graphics mode no menu de inicialização, ou edite as opções de inicialização do programa de instalação e anexe inst.xdriver=vesa no final da linha de comando.

Especificar a resolução do visor manualmente

Se o programa de instalação não detectar sua resolução de tela, você pode anular a detecção automática e especificá-la manualmente. Para isso, anexe a opção inst.resolution=x no menu de inicialização, onde x é a resolução de sua tela, por exemplo, 1024x768.

Use um driver de vídeo alternativo

Você pode tentar especificar um driver de vídeo personalizado, anulando a detecção automática do programa de instalação. Para especificar um driver, use a opção inst.xdriver=x, onde x é o driver do dispositivo que você deseja usar (por exemplo, nouveau)*.

Realizar a instalação usando VNC

Se as opções acima falharem, você pode usar um sistema separado para acessar a instalação gráfica através da rede, usando o protocolo Virtual Network Computing (VNC). Para detalhes sobre a instalação usando VNC, veja o Performing a remote RHEL installation using VNC seção do documento Performing an advanced RHEL installation.

*Se especificar um driver de vídeo personalizado resolve seu problema, você deve relatá-lo como um bug em https://bugzilla.redhat.com sob o componente anaconda. O programa de instalação deve ser capaz de detectar seu hardware automaticamente e usar o driver apropriado sem intervenção.