blog
Revenda

Aumentei a cota de e-mail no pacote e as caixas antigas não mudaram

O caminho documentado para reaplicar a cota nas caixas já existentes de todos os domínios da revenda, conferir no Email Accounts que o número mudou e explicar o caso ao cliente em uma frase.

JR · · 7 min de leitura · 1 tabela · 5 blocos de código

Resposta curta: a cota de caixa definida no pacote vale apenas para contas criadas depois da alteração; as existentes mantêm o limite gravado na criação. O cPanel documenta 1 script para reaplicar em lote: /usr/local/cpanel/scripts/update_existing_mail_quotas_for_account.

Neste artigo
  1. Por que a caixa do cliente continua cheia depois de você aumentar o plano
  2. O script documentado que reaplica a cota nas caixas existentes
  3. Checklist antes de aplicar em lote
  4. Rodando em uma conta e em uma lista de contas em arquivo
  5. Confirmar que mudou de verdade, no painel do cliente
  6. O que o script não resolve
  7. A frase pronta que explica ao cliente sem culpar ninguém
  8. Duas regras para o problema não voltar na sua carteira

Por que a caixa do cliente continua cheia depois de você aumentar o plano

Quando uma conta de e-mail é criada no cPanel, o limite dela é gravado naquele momento, a partir do valor padrão vigente no pacote. Depois disso, a cota passa a ser uma propriedade da caixa, não do pacote.

Consequência prática: você edita o pacote no WHM, sobe a cota padrão de caixa, aplica o pacote na conta e o cliente continua recebendo "mailbox is full". Nada quebrou. As caixas antigas simplesmente mantêm o número que receberam no dia da criação. Só as caixas criadas depois da alteração nascem com o valor novo.

Isso é diferente da cota de disco da conta cPanel, que é um limite único no nível da conta e acompanha o pacote. Aqui são dois limites empilhados:

Limite Onde vive Muda ao reaplicar o pacote
Cota de disco da conta cPanel Conta/pacote Sim
Cota padrão de caixa de e-mail do pacote Pacote Sim (vale para caixas novas)
Cota da caixa já existente A própria caixa Não

A linha que importa é a terceira. É ela que precisa ser reescrita.

O script documentado que reaplica a cota nas caixas existentes

O cPanel distribui um script específico para isso: update_existing_mail_quotas_for_account, documentado em docs.cpanel.net. Ele existe exatamente porque alterar o padrão do pacote não propaga nada para trás.

O caminho, como em todos os scripts do cPanel:

/usr/local/cpanel/scripts/update_existing_mail_quotas_for_account

Ele roda como root, no servidor, via SSH. Revendedor sem shell, portanto, depende do provedor para executá-lo. Se é o seu caso, esta é a parte em que você abre chamado pedindo a execução do script para os seus usuários, citando o nome dele. Pedir "aumentar a cota de e-mail" costuma render uma volta inútil; pedir pelo nome do script resolve na primeira ida.

Antes de rodar, confira no --help a sintaxe da sua versão

A invocação e as opções disponíveis variam entre versões do cPanel. Não decore flag de blog. Rode o script sem argumentos ou com --help e leia o uso impresso na sua versão:

/usr/local/cpanel/scripts/update_existing_mail_quotas_for_account --help

Confira ali se a chamada é por usuário cPanel, se existe modo que abrange todas as contas e se há alguma opção de simulação. Siga o que a sua instalação imprime, não o que você lembra de outra versão.

Checklist antes de aplicar em lote

Rodar em um domínio é trivial. Rodar em todos os clientes da revenda sem checklist é como você descobre, na segunda-feira, que reduziu a cota de uma caixa que estava com 9 GB.

  1. Anote o valor padrão atual de cada pacote. No WHM, em Packages, o campo de cota de caixa de e-mail. Se pacotes diferentes têm padrões diferentes, o lote precisa ser por pacote, não por servidor inteiro.
  2. Verifique se você está subindo ou descendo a cota. Se o padrão novo for menor que o atual de alguma caixa, reaplicar vai reduzir essa caixa. Caixa acima do limite novo para de receber. Esse é o único risco real da operação.
  3. Veja o espaço livre em disco da conta cPanel. Não adianta dar 5 GB por caixa se a conta inteira tem 3 GB. A cota de caixa nunca cria espaço: ela só deixa de barrar antes do limite da conta.
  4. Faça uma conta piloto. Escolha um cliente seu, interno, rode, confira no painel, só então amplie.
  5. Avise os clientes se houver qualquer redução. Uma linha de e-mail antes evita três chamados depois.

Rodando em uma conta e em uma lista de contas em arquivo

Para uma conta, a chamada com o usuário cPanel no parâmetro nomeado (usuariodocliente é exemplo fictício, troque pelo real):

/usr/local/cpanel/scripts/update_existing_mail_quotas_for_account --user=usuariodocliente

Se o --help da sua versão imprimir outra forma de passar o usuário, siga o que ele imprime.

Para várias contas, mantenha a lista em arquivo. É mais auditável que um loop que varre o servidor inteiro, e você consegue repetir a execução exata depois:

# contas.txt: um usuario cPanel por linha
while read -r user; do
  echo "== $user"
  /usr/local/cpanel/scripts/update_existing_mail_quotas_for_account --user="$user"
done < contas.txt | tee /root/cota-email-$(date +%F).log

O tee guarda a saída com data no nome. Quando um cliente disser daqui a dois meses que a caixa dele "nunca foi alterada", você tem a linha.

Como listar só as contas de um pacote com whmapi1 listaccts

Se a mudança foi em um pacote específico, liste as contas daquele pacote pela API do WHM e filtre antes de alimentar o contas.txt:

whmapi1 listaccts --output=jsonpretty | less

Leia os campos user e plan na saída e monte a lista. Prefira conferir com o olho a confiar em um filtro escrito às pressas: a lista errada aqui custa caro.

Confirmar que mudou de verdade, no painel do cliente

Saída limpa do script não é prova. A validação que vale é a que o cliente vê.

  1. Entre no cPanel da conta, em Email Accounts.
  2. Localize a caixa reclamante e olhe a coluna de armazenamento. O denominador precisa ser o número novo.
  3. Clique em Manage na caixa e confira o campo de cota (Storage Space). É ali que o valor efetivo daquela caixa aparece, e é por ele que você compara antes e depois da execução.
  4. Repita em uma caixa de outro domínio da mesma conta, se houver. Confirma que a aplicação pegou a conta toda, não só o domínio principal.

Se o número exibido continuar o antigo, não insista rodando o script de novo. Reveja se o pacote realmente foi salvo com o valor novo, se a conta está mesmo nesse pacote e se o usuário que você passou é o usuário cPanel correto, não o domínio.

O que o script não resolve

A frase pronta que explica ao cliente sem culpar ninguém

Use, adaptando o número:

Funciona porque explica o motivo sem culpar ninguém, nomeia a ação e termina com um lugar onde o cliente confirma sozinho. Economiza a resposta seguinte.

Duas regras para o problema não voltar na sua carteira

Duas regras que evitam a repetição deste problema na sua carteira:

E o conselho que trabalha contra a venda do upgrade: antes de propor plano maior porque "o e-mail vive cheio", confira a cota efetiva das caixas em Email Accounts. Em muitos casos o espaço já está contratado e só não chegou até a caixa.

Referências

  1. Documentação oficial (cpanel) — The update_existing_mail_quotas_for_account Script. Consultado em 2026-10-04.
Leia também