Pular para o conteúdo
Documentação: Comandos

Documentação · Uso

Comandos

Referência do comando vgpu-os (hardware, diagnóstico, monitor e som), dos atalhos de teclado e do acesso pelo console e por SSH.

Alfa

Esta documentação corresponde ao vGPU OS 0.3.0, em estágio alfa. Telas e comandos podem mudar entre versões; para saber a versão instalada, use vgpu-os version.

O vGPU OS tem um comando próprio, vgpu-os, para consultar e diagnosticar o sistema. Os comandos do OSX-REIMS estão na documentação dele (abre em nova aba).

Abrir um terminal

  • No menu da sessão (ao sair do console do OSX-REIMS), tecla s.
  • Ctrl+Alt+F2: tela de login em texto. Entre como vgpu-user. Ctrl+Alt+F1 volta à sessão.
  • Por SSH, de outro computador da rede: ssh vgpu-user@<endereço-ip>. O login do root por SSH é recusado; use sudo.
  • Na aba Terminal do painel web.

vgpu-os version

Mostra a versão do vGPU OS, a versão do Debian e do kernel, e a versão do OSX-REIMS embarcada na ISO e a instalada.

vgpu-os version

vgpu-os hw

Detecção e validação do hardware — o mesmo código usado pelo primeiro setup.

Comando O que faz
vgpu-os hw detect Examina o computador: processador, virtualização, KVM, IOMMU, GPUs e Vulkan
vgpu-os hw plan Diz o que seria instalado, e por quê, sem instalar nada
vgpu-os hw validate Percorre a cadeia gráfica e mostra READY ou a falha encontrada; também confere o KVM
vgpu-os hw report Resumo legível de tudo o que está acima

vgpu-os hw provision e vgpu-os hw drivers instalam o plano; normalmente quem os chama é o primeiro setup.

vgpu-os display

O modo do monitor: resolução e taxa de atualização. Sem argumentos, mostra os modos na tela e deixa escolher; é o mesmo da tecla d do menu da sessão e de Este computador › Monitor no painel web.

Comando O que faz
vgpu-os display Escolhe o modo na tela
vgpu-os display list Lista os monitores, os modos de cada um e o modo salvo
vgpu-os display try <saída> <largura>x<altura>@<Hz> Testa um modo por 15 segundos
vgpu-os display keep Mantém o modo em teste, para todas as inicializações
vgpu-os display revert Desiste do teste e volta ao modo anterior
vgpu-os display reset Esquece o modo salvo e volta ao modo do próprio monitor

Um modo em teste volta sozinho ao anterior depois de 15 segundos, se não for mantido. Com uma VM ligada, o modo não pode ser trocado; reset e revert continuam valendo.

vgpu-os sound

A saída de som e o volume. Sem argumentos, mostra as saídas na tela e deixa escolher; é o mesmo da tecla a do menu da sessão e de Este computador › Som no painel web.

Comando O que faz
vgpu-os sound Escolhe a saída na tela
vgpu-os sound list Lista as saídas, a que está em uso e o volume
vgpu-os sound output <saída> Passa a tocar por essa saída
vgpu-os sound volume <0-100> O volume da saída em uso
vgpu-os sound mute on|off Silencia, ou não
vgpu-os sound test Um tom curto, para conferir

A escolha e o volume ficam guardados para as próximas inicializações.

nvtop

nvtop

Mostra o uso, a memória e a temperatura de cada GPU, de qualquer fabricante. Saia com q.

vgpu-os diagnostics

Reúne tudo o que é preciso para entender um problema: identidade do sistema, OSX-REIMS, Reims vGPU, hardware, validação dos gráficos, PCI, DRM, módulos do kernel, Vulkan, KVM, IOMMU, rede, armazenamento, estado do appliance, tempos de boot, serviços, erros recentes do kernel e logs, inclusive da inicialização anterior.

vgpu-os diagnostics
Opção O que faz
--save Também grava o relatório em um arquivo e mostra onde, para enviar a quem for ajudar
--splash Explica por que a tela de carregamento não apareceu

O relatório não coleta senhas, chaves nem números de série: ele foi feito para ser compartilhado com segurança ao pedir ajuda.

A seção Boot mostra quanto tempo a inicialização levou e quanto cada etapa do vGPU OS demorou. Comece por ela quando o computador parecer lento para ligar.

Refazer o primeiro setup

sudo vgpu-os-firstboot --force

Roda o primeiro setup de novo: rede, hardware, drivers, OSX-REIMS e validação.

Atalhos de teclado

Atalho Onde O que faz
Esc Enquanto o computador inicia Mostra o menu de boot escondido
Ctrl+Alt+F2 Na sessão Tela de login em texto
Ctrl+Alt+F1 Na tela de login em texto Volta à sessão
Ctrl+Alt+Super Com a VM na tela Devolve o teclado ao vGPU OS (clique na VM para dá-lo ao macOS)
Enter, d, a, s, r, p Menu da sessão Console de novo, monitor, som, terminal, reiniciar, desligar