Do pendrive ao domínio, em telas simples.

1 Baixar e gravar

Baixe a ISO e confira a integridade (opcional, mas recomendado):

$ curl -LO https://guata.beacon.tec.br/ol9/guata-server-ol9-offline.iso
$ curl -LO https://guata.beacon.tec.br/ol9/guata-server-ol9-offline.iso.sha256
$ sha256sum -c guata-server-ol9-offline.iso.sha256   # deve dizer: OK

Grave num pendrive (≥ 2 GB). No Windows use o Rufus (modo "Imagem DD"); no Linux:

$ sudo dd if=guata-server-ol9-offline.iso of=/dev/sdX bs=4M status=progress oflag=sync
# troque /dev/sdX pelo pendrive certo (cuidado: apaga o pendrive)

2 Instalar

• Dê boot pelo pendrive. A opção "Instalar Guata Server (Oracle Linux 9)" já vem marcada — é só esperar.
• A instalação é automática (português, fuso de São Paulo, disco do servidor). Ela usa o disco inteiro do servidor de destino.
• Ao terminar, o servidor reinicia sozinho.

3 Primeiro acesso — abrir o painel

No console do servidor (ou por SSH), veja o endereço e o token do painel:

$ guata-server-token

  Abra no navegador:  https://IP-DO-SERVIDOR:8081
  Token de acesso:    9F3A1C7B

Abra esse endereço no navegador do seu computador, entre com o token e pronto — você está no painel.

4 Montar as funções

No painel, cada função é um card. Clique em Adicionar função. Antes de instalar, confira a porta do painel — se já estiver em uso no servidor, o Guatá avisa e sugere outra. A instalação mostra o progresso ao vivo.

O AD pede o nome do domínio (ex.: minhaempresa.local), o nome curto (NetBIOS) e a senha do Administrator. Ele roda em container — você não precisa saber disso, só funciona.

5 Colocar um Windows no domínio

Depois que o AD estiver ativo, em cada PC Windows:

• Aponte o DNS do PC para o servidor Guatá. Configurações de rede → DNS preferencial = IP-DO-SERVIDOR.
• Painel de Controle → Sistema → "Renomear este computador (avançado)" → Alterar → marque Domínio e digite minhaempresa.local.
• Quando pedir credenciais, use Administrator e a senha que você criou no painel.
• Reinicie. Na tela de login, entre com um usuário do domínio: MINHAEMPRESA\usuario.

6 Colocar um Linux (Oracle Linux / RHEL) no domínio

No servidor Linux que vai entrar no domínio (ex.: um appserver de Protheus) — isto é nativo no Oracle Linux, sem container:

$ sudo dnf install -y realmd sssd adcli samba-common-tools \
     oddjob oddjob-mkhomedir
# aponte o DNS da máquina para o servidor Guatá antes (resolv.conf / NetworkManager)
$ sudo realm join -U Administrator minhaempresa.local
# digite a senha do Administrator. Pronto — a máquina está no domínio.

# conferir:
$ realm list
# logar com um usuário do domínio:
$ su - usuario@minhaempresa.local

Para criar a pasta pessoal automático no primeiro login: sudo authselect enable-feature with-mkhomedir e reiniciar o oddjobd.

7 Portas e firewall

O Guatá abre as portas sozinho ao adicionar cada função. Se precisar conferir no firewall do Oracle Linux:

# painéis web (ajuste se você mudou a porta no painel)
$ sudo firewall-cmd --permanent --add-port=8081/tcp   # Guatá Server
# domínio (AD): DNS, Kerberos, LDAP, SMB...
$ for p in 53/tcp 53/udp 88/tcp 88/udp 389/tcp 445/tcp 464/tcp 636/tcp 3268/tcp 3269/tcp; do sudo firewall-cmd --permanent --add-port=$p; done
$ sudo firewall-cmd --reload

8 Bom saber

• Rede só Linux? Dá para usar FreeIPA no lugar do AD — é o nativo do Oracle Linux. Rede com Windows, use o AD (padrão aqui).
• Backup é um appliance à parte (TITAN/PBS) — a gente conecta separado.
• Para adicionar mais funções depois, é só abrir o painel de novo (ou rodar guata-server-ol9 no console).
• Isto é BETA: feito para testar e evoluir junto. Dúvida ou problema, fala com a gente.