Para uma melhor experiência com caixas de código, experimente ver o site em um Desktop.
Hoje vamos aprender a alterar o hostname e o domínio de um nó Proxmox VE isolado (standalone)
de "pve.jbitcore.local" para "pve-homolog.jbitcore.local", preservando a integridade do Proxmox Cluster File System (pmxcfs) e das instâncias virtualizadas.
Antes de iniciar qualquer alteração estrutural no sistema operacional, é uma prática mandatória de engenharia realizar um backup preventivo. O Proxmox utiliza um sistema de arquivos em banco de dados em memória chamado pmxcfs (Proxmox Cluster File System), montado em /etc/pve.
cp -r /etc/pve /root/pve_backup_pre_rename
O que este comando faz:
- cp: Copia arquivos e diretórios de forma recursiva e segura.
- /etc/pve: Origem contendo a base de dados do Proxmox (configurações de VMs, storages, firewalls e nós).
- /root/pve_backup_pre_rename: Destino do snapshot de segurança pré-migração.
O sistema operacional base do Proxmox é o Debian. Portanto, precisamos atualizar
os apontamentos de nome de host, domínio e endereçamento IP de laboratório
(utilizando o bloco privado RFC 1918 192.168.20.0/24 como referência).
A) Arquivo /etc/hostname
Este arquivo define o nome de host (hostname) estático do sistema operacional.
- Conteúdo anterior: pve
- Novo conteúdo: pve-homolog
B) Arquivo /etc/hosts
O resolvedor de nomes local precisa associar o endereço IP de gerência do laboratório
ao novo FQDN (Fully Qualified Domain Name) e ao short name, prevenindo falhas
críticas de resolução de serviços internos (como o pveproxy e pvedaemon).
- Configuração recomendada (com IP RFC 1918 de lab):
127.0.0.1 localhost.localdomain localhost
192.168.20.10 pve-homolog.jbitcore.local pve-homolog pve
C) Arquivos /etc/mailname e /etc/postfix/main.cf
Serviços de notificação do sistema e o agente de transferência de correio
(Postfix) utilizam o hostname e domínio para identificar a origem dos alertas
de falha, relatórios de backup e monitoramento.
- Atualizar em /etc/mailname: pve-homolog.jbitcore.local
- Ajustar no /etc/postfix/main.cf o parâmetro 'myhostname' para refletir o novo FQDN.
--------------------------------------------------------------------------------
3. APLICANDO O NOVO HOSTNAME NO KERNEL (SYSTEMD)
--------------------------------------------------------------------------------
Para atualizar o nome do host em tempo de execução sem a necessidade de uma
reinicialização imediata dos daemons de rede do systemd, utilizamos o utilitário
hostnamectl.
Comando:
hostnamectl set-hostname pve-homolog
O que este comando faz:
- hostnamectl: Interface de controle do systemd para gerenciar o hostname do kernel.
- set-hostname: Altera dinamicamente o hostname do sistema operacional em execução
e persiste a alteração no arquivo de configuração do systemd.
Validação:
hostnamectl
(Exibe o status atual do systemd, confirmando que a alteração foi aplicada).
--------------------------------------------------------------------------------
4. MIGRAÇÃO DE METADADOS NO PROXMOX CLUSTER FILE SYSTEM (PMXCFS)
--------------------------------------------------------------------------------
O Proxmox organiza as configurações de instâncias virtualizadas em subdiretórios
vinculados diretamente ao nome do nó dentro de /etc/pve/nodes/. Como renomeamos
o host, precisamos criar a nova árvore de diretórios e migrar os arquivos de
configuração existentes para que a API do Proxmox volte a enxergar as VMs e LXCs.
Comandos:
cd /etc/pve/nodes
mkdir -p /etc/pve/nodes/pve-homolog/qemu-server
mkdir -p /etc/pve/nodes/pve-homolog/lxc
[ -d /etc/pve/nodes/pve/qemu-server ] && cp -p /etc/pve/nodes/pve/qemu-server/* /etc/pve/nodes/pve-homolog/qemu-server/
[ -d /etc/pve/nodes/pve/lxc ] && cp -p /etc/pve/nodes/pve/lxc/* /etc/pve/nodes/pve-homolog/lxc/
O que este bloco faz:
- cd /etc/pve/nodes: Acessa o diretório raiz gerenciado pelo pmxcfs onde ficam
os nós do cluster/ambiente.
- mkdir -p: Cria a nova árvore de diretórios para o nó 'pve-homolog', incluindo
as subpastas dedicadas a máquinas virtuais KVM (qemu-server) e containers LXC.
- Expressão condicional ([ -d ... ] && cp -p ...): Verifica se o diretório antigo
possui arquivos de configuração. Caso afirmativo, copia os arquivos preservando
suas permissões originais (-p) para a nova estrutura do nó.
--------------------------------------------------------------------------------
5. REINICIALIZAÇÃO DO SISTEMA (REBOOT)
--------------------------------------------------------------------------------
Comando:
reboot
O que este comando faz:
- Reinicia o servidor de forma limpa. O reboot é indispensável para que todos
os daemons de gerenciamento do Proxmox (pve-cluster, pvedaemon, pveproxy, spiceproxy)
e sockets IPC vinculados ao antigo hostname/domínio inicializem corretamente
sob o novo contexto de laboratório.
================================================================================
TABELA TÉCNICA DE REFERÊNCIA E PARÂMETROS
================================================================================
+-----------------------+-----------------------------+-----------------------------+
| Componente / Arquivo | Valor Anterior (Original) | Novo Valor (JBitCore Lab) |
+-----------------------+-----------------------------+-----------------------------+
| Hostname do Sistema | pve | pve-homolog |
| Domínio de Rede | omegait.local | jbitcore.local |
| FQDN Completo | pve.omegait.local | pve-homolog.jbitcore.local |
| Endereçamento IP | 192.168.X.X (Genérico) | 192.168.20.10 (RFC 1918) |
| Diretório de Nós | /etc/pve/nodes/pve | /etc/pve/nodes/pve-homolog |
| Daemon de Gerência | pvedaemon (bind antigo) | pvedaemon (bind atualizado) |
+-----------------------+-----------------------------+-----------------------------+