mirror of
https://github.com/MacRimi/ProxMenux.git
synced 2026-11-02 19:02:31 +00:00
Describe the post-install behaviour as the scripts run it
- The automated run can also ask to confirm the system update - Persistent NIC names, ZFS ARC reconcile and ARC policy match the code - Uninstall rewrites journald.conf with systemd defaults
This commit is contained in:
@@ -1,7 +1,7 @@
|
||||
{
|
||||
"meta": {
|
||||
"title": "Script pós-instalação automatizado | Documentação ProxMenux",
|
||||
"description": "O script pós-instalação automatizado ProxMenux executa 14 otimizações predefinidas adaptadas ao hardware num host Proxmox VE novo. Não tem lista de funções para selecionar, mas pode pedir confirmação para ocultar o aviso de subscrição, instalar Log2RAM em certos casos e reiniciar. As alterações reversíveis ficam registadas.",
|
||||
"description": "O script pós-instalação automatizado ProxMenux executa 14 otimizações predefinidas adaptadas ao hardware num host Proxmox VE novo. Não tem lista de funções para selecionar, mas pode pedir confirmação para a atualização do sistema, para ocultar o aviso de subscrição, instalar Log2RAM em certos casos e reiniciar. As alterações reversíveis ficam registadas.",
|
||||
"ogTitle": "Script pós-instalação automatizado | Documentação ProxMenux",
|
||||
"ogDescription": "14 otimizações predefinidas adaptadas ao hardware para um host Proxmox VE novo, com confirmações para algumas ações e registo de alterações reversíveis."
|
||||
},
|
||||
|
||||
@@ -83,13 +83,13 @@
|
||||
"whyItems": [
|
||||
"Adicionar ou remover dispositivos PCIe pode mudar a numeração do barramento, transformando <code>enp3s0</code> em <code>enp4s0</code>. Se <code>/etc/network/interfaces</code> mencionar o nome antigo, a ponte desaparece ao reiniciar.",
|
||||
"As atualizações de BIOS / firmware às vezes alteram como os dispositivos enumeram, com o mesmo efeito.",
|
||||
"O script fixa os nomes das placas físicas, incluindo portas físicas usadas por bonds. Ignora interfaces virtuais, como veths LXC e os próprios dispositivos bond; não corrige condições de corrida nos nomes de placas virtuais <code>hotplug</code>."
|
||||
"O script escreve ficheiros <code>.link</code> para as placas físicas, incluindo as portas dos bonds, com o MAC indicado pelo sysfs nesse momento; nas portas de um bond pode ser o MAC partilhado do bond, por isso verifique os nomes após reiniciar. Ignora interfaces virtuais, como veths LXC e os próprios dispositivos bond; não corrige condições de corrida nos nomes de placas virtuais <code>hotplug</code>."
|
||||
],
|
||||
"writtenTitle": "O que é escrito",
|
||||
"writtenIntro": "Um ficheiro por NIC físico, em <code>/etc/systemd/network/10-proxmenux-<iface>.link</code>. Cada arquivo começa com o cabeçalho <code># Managed by ProxMenux — do not edit</code> para que ProxMenux possa distinguir seus próprios arquivos de arquivos <code>.link</code> fornecidos pelo usuário ou pacote.",
|
||||
"writtenOutro": "Os ficheiros <code>.link</code> de outros pacotes ou escritos pelo utilizador são preservados; só os que têm o cabeçalho ProxMenux são geridos. Em cada nova execução, a função verifica os seus ficheiros: relê <code>MACAddress=</code> de cada <code>10-proxmenux-*.link</code> e remove os que têm uma MAC ausente de <code>/sys/class/net/</code>. Os ficheiros de versões anteriores no formato <code>10-<iface>.link</code> são migrados automaticamente na primeira execução.",
|
||||
"pveTitle": "PVE 9 vs PVE 8",
|
||||
"pveBody": "O script usa ficheiros systemd <code>.link</code> para os nomes persistentes. No Proxmox VE 9 também recarrega as regras udev após os escrever, para que novas placas possam usá-las sem reiniciar. Verifique as interfaces existentes após reiniciar tanto no PVE 8 como no PVE 9. Isto não substitui <code>ifupdown2</code> no host. Em ambos os casos, o script assinala a necessidade de reinício na pós-instalação personalizável.",
|
||||
"pveBody": "O script usa ficheiros systemd <code>.link</code> para os nomes persistentes. No Proxmox VE 9 também recarrega as regras udev após os escrever, para que uma placa já fixada que volte a ser ligada ou detetada aplique a sua regra sem reiniciar. Verifique as interfaces existentes após reiniciar tanto no PVE 8 como no PVE 9. Isto não substitui <code>ifupdown2</code> no host. Em ambos os casos, o script assinala a necessidade de reinício na pós-instalação personalizável.",
|
||||
"reviewTitle": "Reveja primeiro o /etc/network/interfaces existente",
|
||||
"reviewBody": "Se a configuração antiga em <code>/etc/network/interfaces</code> usa nomes de placas gerados pelo kernel, fixar os nomes <em>atuais</em> é o resultado pretendido. Se já adaptou manualmente a configuração a nomes específicos, confirme antes de reiniciar que os nomes fixados correspondem ao ficheiro interfaces.",
|
||||
"revertTitle": "Reversível do menu Desinstalar",
|
||||
|
||||
@@ -15,7 +15,7 @@
|
||||
"trackedBody": "Cada uma dessas opções registra uma ferramenta em <code>installed_tools.json</code>, então eles aparecem em <link>Otimizações de Uninstall</link>. Reverter o <code>zfs_arc</code> remove o <code>/etc/modprobe.d/99-zfsarc.conf</code> e reconstrói o initramfs; o <code>zfs_auto_snapshot</code> reverte o cronograma do cron e oferece purgar o pacote; o <code>zfs_autotrim</code> configura o <code>autotrim=off</code> nos pools que ele ativou; o <code>vzdump_speed</code> restaura o <code>/etc/vzdump.conf</code> do <code>.bak</code> a instalação criada.",
|
||||
"arc": {
|
||||
"heading": "Otimizar o tamanho do ZFS ARC",
|
||||
"intro": "A <strong>Adaptive Replacement Cache (ARC)</strong> é a cache de leitura ZFS em RAM. Instalações Proxmox VE desde 8.1 limitam a 10% da RAM, máximo 16 GiB; hosts antigos ou atualizados podem diferir. Esta opção escreve o seu próprio limite pela RAM. Verifique definições e carga: uma cache menor nem sempre é mais rápida.",
|
||||
"intro": "A <strong>Adaptive Replacement Cache (ARC)</strong> é a cache de leitura ZFS em RAM. Instalações Proxmox VE desde 8.1 limitam a 10% da RAM, máximo 16 GiB; hosts antigos ou atualizados podem diferir. Esta opção escreve explicitamente essa mesma regra (RAM/10, máximo de 16 GiB, mínimo de 64 MiB) num ficheiro próprio, o que cobre também hosts antigos ou atualizados. Verifique definições e carga: uma cache menor nem sempre é mais rápida.",
|
||||
"sizingTitle": "Regras de dimensionamento",
|
||||
"headerRam": "RAM do host",
|
||||
"headerMax": "Limite ARC",
|
||||
@@ -41,7 +41,7 @@
|
||||
"max": "16 GiB (limite)"
|
||||
}
|
||||
],
|
||||
"after": "O ficheiro <code>/etc/modprobe.d/99-zfsarc.conf</code> contém apenas <code>options zfs zfs_arc_max=…</code>. Os outros parâmetros ZFS (<code>zfs_arc_min</code>, pré-leitura/limite de escritas L2ARC, tempo limite TXG) não são ajustados. Antes, procura outros <code>*.conf</code> em <code>/etc/modprobe.d/</code> com <code>zfs_arc_min</code> / <code>zfs_arc_max</code>, copia-os com manifesto para <code>/usr/local/share/proxmenux/backups/zfs_arc/</code> e remove linhas em conflito, deixando ativo só o ficheiro ARC ProxMenux. Depois, <code>update-initramfs -u -k all</code> e, quando aplicável, <code>proxmox-boot-tool refresh</code> integram o limite no initramfs dos sistemas com raiz ZFS.",
|
||||
"after": "O ficheiro <code>/etc/modprobe.d/99-zfsarc.conf</code> contém apenas <code>options zfs zfs_arc_max=…</code>. Os outros parâmetros ZFS (<code>zfs_arc_min</code>, pré-leitura/limite de escritas L2ARC, tempo limite TXG) não são ajustados. Antes, procura outros <code>*.conf</code> em <code>/etc/modprobe.d/</code> com <code>zfs_arc_min</code> / <code>zfs_arc_max</code>, copia-os com manifesto para <code>/usr/local/share/proxmenux/backups/zfs_arc/</code> e remove deles os valores <code>zfs_arc_min</code> / <code>zfs_arc_max</code> em conflito (as outras opções dessas linhas mantêm-se), para que só o ficheiro ARC ProxMenux defina o limite. Depois, <code>update-initramfs -u -k all</code> e, quando aplicável, <code>proxmox-boot-tool refresh</code> integram o limite no initramfs dos sistemas com raiz ZFS.",
|
||||
"rebootTitle": "Requer uma reinicialização para fazer efeito",
|
||||
"rebootBody": "As definições ARC são lidas ao carregar o módulo <code>zfs</code>. Para hosts com raiz ZFS, ProxMenux regenera initramfs com <code>update-initramfs -u -k all</code> e atualiza o carregador quando necessário com <code>proxmox-boot-tool refresh</code>. O novo parâmetro continua a exigir reinício, assinalado automaticamente.",
|
||||
"safeTitle": "Seguro em hosts não-ZFS",
|
||||
|
||||
@@ -103,7 +103,7 @@
|
||||
"heading": "Verificação",
|
||||
"intro": "Após a aplicação das otimizações do sistema:",
|
||||
"tipTitle": "Restauro e limitações",
|
||||
"tipBody": "As seis opções ficam em <code>installed_tools.json</code> e <link>Desinstalar otimizações</link>. O restauro remove configurações, unidade e alias kexec e repõe journald/logrotate. Alguns limites ativos precisam de nova sessão ou reinício. A limpeza de /root/.profile só remove o antigo ulimit -n 256000; o atual ulimit -n 1048576 pode permanecer e exigir remoção manual."
|
||||
"tipBody": "As seis opções ficam em <code>installed_tools.json</code> e <link>Desinstalar otimizações</link>. O restauro remove os ficheiros de configuração, a unidade e o alias kexec, reescreve journald.conf com os valores predefinidos do systemd e repõe logrotate.conf a partir da cópia de segurança. Alguns limites ativos precisam de nova sessão ou reinício."
|
||||
},
|
||||
"related": {
|
||||
"heading": "Relacionado",
|
||||
|
||||
Reference in New Issue
Block a user