

As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.

# Usando o Xdcv com sessões de console
<a name="xdcv-console-sessions"></a>

O Amazon DCV oferece dois tipos de sessões: console e virtual.

Com **sessões virtuais**, o Amazon DCV inicia uma instância de servidor X dedicada, Xdcv, e executa um ambiente de desktop dentro dela. O Amazon DCV inicia uma nova instância Xdcv para cada sessão virtual, e cada sessão virtual usa a exibição fornecida por sua própria instância do servidor X. O binário Xdcv é fornecido pelo `nice-xdcv` pacote.

Com **sessões de console**, o Amazon DCV captura diretamente o conteúdo da tela do desktop, que no Linux normalmente é renderizado pelo servidor X do sistema (Xorg). Também é possível configurar uma sessão de console para ser atendida pelo Xdcv no lugar do Xorg. Isso fornece redimensionamento dinâmico e vários monitores sem configurar detalhes específicos em seu. `xorg.conf`

Este tópico descreve como fazer essa mudança no Ubuntu, RHEL/Rocky Linux/CentOS Stream e Amazon Linux 2023.

**Importante**  
Essa configuração se aplica somente a hosts sem GPU. A aplicação dessas etapas em instâncias com uma GPU interromperá o pipeline de GPU-accelerated exibição.

**nota**  
Essas instruções pressupõem que seu sistema usa o GDM (GNOME Display Manager). Se você usar um gerenciador de exibição diferente, como LightDM ou SDDM, ajuste o comando adequadamente. `systemctl restart`

**Topics**
+ [Pré-requisitos](#xdcv-console-prereqs)
+ [Ubuntu](#xdcv-console-ubuntu)
+ [RHEL//Rocky Linux//CentOS Stream](#xdcv-console-rhel)
+ [Amazon Linux 2023](#xdcv-console-al2023)
+ [Como verificar a configuração](#xdcv-console-verify)
+ [Revertendo](#xdcv-console-revert)

## Pré-requisitos
<a name="xdcv-console-prereqs"></a>

Antes de executar os comandos para sua distribuição, confirme o seguinte:
+ O `nice-xdcv` pacote está instalado e o `Xdcv-console` binário está presente em`/usr/bin/Xdcv-console`.
+ Você tem privilégios de root (use `sudo` quando apropriado).

**nota**  
Após a configuração, o próximo login do console iniciará uma Xdcv-backed sessão em vez de uma sessão padrão do Xorg.

## Ubuntu
<a name="xdcv-console-ubuntu"></a>

No Ubuntu, a troca é realizada desviando o binário Xorg original do caminho e apontando para ele `Xdcv-console` por meio de um `/usr/bin/Xorg` link simbólico.

```
$ dpkg-divert --package nice-xdcv --divert /usr/bin/Xorg.orig --rename /usr/bin/Xorg
$ ln -sf /usr/bin/Xdcv-console /usr/bin/Xorg
$ sudo systemctl restart gdm
```O que cada comando faz

`dpkg-divert`  
Diz ao dpkg que o `nice-xdcv` pacote possui o caminho `/usr/bin/Xorg` e renomeia o binário Xorg existente para. `/usr/bin/Xorg.orig` Isso preserva o binário original e evita que futuras atualizações do pacote Xorg sobrescrevam sua personalização.

`ln -sf`  
Cria ou substitui um link simbólico para que qualquer invocação de processo seja `/usr/bin/Xorg` realmente executado. `/usr/bin/Xdcv-console`

`systemctl restart gdm`  
Reinicia o Gerenciador de Display do GNOME para que a alteração tenha efeito. Isso encerra qualquer sessão gráfica ativa no host, portanto, execute-a quando ninguém estiver conectado ao console.

## RHEL//Rocky Linux//CentOS Stream
<a name="xdcv-console-rhel"></a>

Nas RHEL-family distribuições, o `nice-xdcv` pacote fornece duas unidades systemd que manipulam o switch declarativamente.

```
$ systemctl enable --now xdcv-console-update.service
$ systemctl enable xdcv-console.path
$ sudo systemctl restart gdm
```O que cada comando faz

`xdcv-console-update.service`  
A unidade que reconcilia o sistema `Xdcv-console` para uso em sessões de console. Ativá-lo com `--now` o ativa imediatamente e faz com que ele seja iniciado nas inicializações subsequentes.

`xdcv-console.path`  
Uma unidade baseada em caminho que observa os arquivos relevantes no disco e aciona novamente o serviço de atualização se a configuração do servidor X mudar, por exemplo, após a atualização de um pacote. Ativá-la garante que a configuração do Xdcv seja reaplicada automaticamente, em vez de ser revertida silenciosamente.

`systemctl restart gdm`  
Reinicia o Gerenciador de Display do GNOME para que a alteração tenha efeito. Isso encerra qualquer sessão gráfica ativa no host, portanto, execute-a quando ninguém estiver conectado ao console.

## Amazon Linux 2023
<a name="xdcv-console-al2023"></a>

O Amazon Linux 2023 usa o `update-alternatives` sistema para gerenciar quais binários fornecem`/usr/bin/X`.

```
$ update-alternatives --install /usr/bin/X xdcv /usr/bin/Xdcv-console 11
$ sudo update-alternatives --set X /usr/bin/Xdcv-console
$ sudo systemctl restart gdm
```O que cada comando faz

`update-alternatives --install`  
Se inscreve `Xdcv-console` como candidato para a `X` alternativa, com prioridade 11. A prioridade só importa quando a alternativa está no modo automático; o próximo comando substitui isso.

`update-alternatives --set X`  
`X`Fixa de `Xdcv-console` forma explícita, para que não seja substituída posteriormente por um candidato de maior prioridade.

`systemctl restart gdm`  
Reinicia o Gerenciador de Display do GNOME para que a alteração tenha efeito. Isso encerra qualquer sessão gráfica ativa no host, portanto, execute-a quando ninguém estiver conectado ao console.

## Como verificar a configuração
<a name="xdcv-console-verify"></a>

Depois de aplicar as etapas para sua distribuição, confirme se o caminho do servidor X agora é resolvido para`Xdcv-console`:

```
$ ls -l /usr/bin/Xorg       # Ubuntu
$ ls -lh /usr/bin/X         # RHEL/Rocky Linux/CentOS Stream
$ ls -l /etc/alternatives/X # Amazon Linux 2023
```

Em seguida, inicie uma sessão do console e verifique se ela funciona conforme o esperado. Se o gerenciador de exibição não iniciar, faça login via SSH para solucionar o problema antes de tentar outro login gráfico.

## Revertendo
<a name="xdcv-console-revert"></a>

Se você precisar reverter para o servidor X padrão:
+ **Ubuntu:** remova o link simbólico e execute `dpkg-divert --package nice-xdcv --rename --remove /usr/bin/Xorg` para restaurar o binário original.
+ **RHEL/Rocky:** `systemctl disable --now xdcv-console.path xdcv-console-update.service`.
+ **Amazon Linux 2023:** `update-alternatives --remove X /usr/bin/Xdcv-console` e reinicie o gdm.