blog
Revenda

Criação de conta no WHM travou: leia a fila antes de refazer

A ação foi aceita, virou tarefa em segundo plano e está esperando o queueprocd. Como ler a fila, decidir entre esperar, reexecutar ou remover, e o que dizer ao cliente enquanto isso.

JR · · 8 min de leitura · 2 tabelas · 2 blocos de código

Resposta curta: antes de recriar a conta, abra o Task Queue Manager no WHM e confira se a tarefa ainda está na fila. Operações como criação de conta e AutoSSL são processadas em segundo plano pelo daemon queueprocd; repetir a ação por cima gera conta ou certificado duplicado.

Neste artigo
  1. O que é a Task Queue e por que a ação some da tela sem dar erro
  2. Quem consegue ver a fila: root, SSH e o que sobra para o revendedor
  3. Como descobrir se a tarefa está rodando, esperando ou morta
  4. Esperar, reexecutar ou remover: a decisão por sintoma observado
  5. Os quatro erros que viram conta duplicada ou SSL emitido duas vezes
  6. Checklist de fila travada para rodar em qualquer servidor cPanel
  7. O que dizer ao cliente enquanto a tarefa não conclui
  8. Fila drenando e tarefa ainda falhando: onde procurar a causa real

Criação de conta que não termina, SSL AutoSSL que nunca aparece, mudança de pacote que fica "aplicando": na maior parte das vezes não há erro nenhum na tela. O pedido foi aceito, virou uma tarefa, entrou numa fila e está esperando. Quem não sabe que essa fila existe repete a ação, e o resultado é conta duplicada, certificado emitido duas vezes ou um usuário criado pela metade.

A fila tem nome, tem tela e tem daemon. Este guia é a leitura documental dela, segundo a documentação oficial do cPanel sobre taskqueue, com o processo que uma agência pode padronizar em todos os servidores que administra. Não há medição nossa aqui: o que vale é o procedimento e a ordem das decisões.

O que é a Task Queue e por que a ação some da tela sem dar erro

Várias operações do WHM não são executadas na hora em que você clica. Elas são enfileiradas e processadas em segundo plano por um daemon chamado queueprocd. Criação de conta, remoção de conta e tarefas de AutoSSL estão entre as operações tratadas por esse caminho na documentação de taskqueue do cPanel. Atualizações de zona e rotinas disparadas por hooks também costumam chegar à fila, conforme o hook configurado.

Isso tem duas consequências práticas:

É exatamente o cenário de "travou e não termina". Antes de refazer qualquer coisa, olhe a fila.

Caminho de uma ação do WHM até a execuçãoClique no WHMPedido aceito, não executadoTarefa entra na filaAguarda sua vezqueueprocd processaExecução em segundo planoAção concluídaConta, SSL ou zona prontos
O "sucesso" na tela é só o aceite do pedido. A execução acontece depois, no daemon.

Quem consegue ver a fila: root, SSH e o que sobra para o revendedor

Papel O que consegue fazer
root do servidor Ver a fila completa, reiniciar o queueprocd, remover tarefas
Revendedor sem root Não acessa o Task Queue Manager; depende do provedor
Acesso SSH como root Consulta de status do serviço e restart via restartsrv_queueprocd

Se você é revendedor em servidor gerenciado, a parte acionável deste artigo é o diagnóstico de superfície (seções seguintes) mais o pedido correto ao provedor: "verifiquem o estado do queueprocd e da task queue, tenho uma criação de conta pendente há X minutos". Esse pedido economiza um ciclo inteiro de ida e volta.

Como descobrir se a tarefa está rodando, esperando ou morta

Abra o Task Queue Manager e anote nome, horário e estado da tarefa

No WHM, use a barra de busca e digite Task Queue. A ferramenta é o Task Queue Manager. Ela mostra as tarefas que o servidor tem para processar, incluindo as que estão sendo executadas agora e as agendadas para depois.

Anote três coisas de cada item suspeito: o nome da tarefa, o horário em que entrou e se ela está em execução ou apenas aguardando. O "há quanto tempo" é o dado que decide tudo depois.

Confirme se o queueprocd está vivo antes de culpar a tarefa

Uma fila grande com nada em execução costuma significar daemon parado. Em WHM, Service Manager e Service Status mostram o queueprocd. Por SSH, como root:

/usr/local/cpanel/scripts/restartsrv_queueprocd --status

Se o serviço estiver parado, reinicie:

/usr/local/cpanel/scripts/restartsrv_queueprocd

Validação: volte ao Task Queue Manager e atualize. Em um servidor saudável, a lista encolhe e as tarefas passam para execução. Se nada muda depois do restart, o problema não é o daemon, é a tarefa específica ou um recurso que ela espera (disco cheio, DNS, serviço dependente fora).

Cruze a fila com o que a conta já tem no servidor

Antes de concluir que "a conta não foi criada", verifique o que já existe. Se o usuário aparece em List Accounts, a tarefa avançou pelo menos até a criação do usuário. Se o domínio não resolve, a parte de DNS pode não ter rodado. Esse diagnóstico evita a pior decisão possível: recriar por cima.

Remover uma tarefa da fila cancela o que falta, não desfaz o que foi feito

A remoção é feita na própria tela do Task Queue Manager: localize a linha da tarefa e use a ação de exclusão oferecida ao lado dela. A documentação de taskqueue do cPanel descreve a ferramenta como o lugar onde o root vê e gerencia as tarefas, mas não publica um passo a passo de remoção por versão de interface, então o rótulo exato do botão pode mudar entre releases. Confira na tela antes de clicar.

O efeito é só um: a tarefa deixa de existir para o queueprocd. Nada é desfeito. Se a criação de conta já tinha criado o usuário do sistema, o usuário continua lá depois da remoção, e cabe a você limpar o resíduo pelo WHM. Remover tarefa não é rollback, é cancelar o que ainda não rodou.

Por isso a ordem importa: remova apenas tarefa duplicada, ou tarefa que você decidiu abandonar para refazer do zero depois de limpar o estado.

Esperar, reexecutar ou remover: a decisão por sintoma observado

Os três verbos têm significado específico aqui. Esperar é deixar o queueprocd concluir a tarefa que já está na fila. Reexecutar é refazer a ação na interface do WHM depois que a tarefa original saiu da fila, por conclusão parcial ou por remoção, e com o estado já limpo. Remover é apagar a tarefa da fila sem que ela rode, o que não desfaz nada do que já tinha sido feito.

Situação observada Decisão Resultado esperado
Tarefa em execução, poucos minutos, servidor com carga Esperar Conclui sozinha; a conta aparece completa
Fila com itens aguardando e queueprocd parado Reiniciar o daemon A fila drena na ordem; nada precisa ser refeito
Tarefa de AutoSSL pendente Esperar o ciclo Certificado instalado sem nova emissão manual
Tarefa antiga, daemon ativo, fila andando, só ela parada Investigar causa antes de remover Causa costuma ser dependência externa
Tarefa duplicada por clique repetido Remover a duplicata Sobra uma única execução
Tarefa saiu da fila sem concluir e o estado já foi limpo Reexecutar a ação no WHM Nova tarefa entra na fila, agora sozinha
Conta criada pela metade, tarefa já encerrada Remover a conta pelo WHM e recriar Estado limpo, sem resíduo

A regra que evita a maior parte do estrago: nunca crie de novo enquanto a tarefa original ainda está na fila. Ou ela termina, ou você a remove de forma explícita. Não existe terceiro caminho seguro.

Decisão por sintoma na fila travadaTarefa em execução há poucos minutosEsperar concluirFila parada e queueprocd foraReiniciar o daemonFila anda, só ela paradaInvestigar dependência externaTarefa duplicada por clique repetidoRemover a duplicataConta pela metade, tarefa encerradaLimpar pelo WHM e recriar
Decida pelo sintoma observado. Nunca recrie enquanto a tarefa original segue na fila.

Os quatro erros que viram conta duplicada ou SSL emitido duas vezes

Matar a tarefa no meio da criação de conta. A criação não é atômica do ponto de vista do operador: usuário do sistema, home, zona DNS, entradas de e-mail e vhost são etapas. Interromper no meio deixa resíduo. O sintoma clássico é usuário existente sem zona DNS, ou home ausente para um usuário que o WHM lista. A correção não é recriar por cima: é remover a conta pelo WHM, confirmar que o domínio sumiu da lista e só então criar de novo.

Reemitir SSL porque o AutoSSL "não fez nada". Tarefa de AutoSSL na fila é tarefa que ainda vai rodar. Emitir manualmente em paralelo gera certificado duplicado e, dependendo da autoridade certificadora, consome limite de emissão por domínio sem necessidade.

Reiniciar o servidor inteiro para "destravar". Reinicia tudo, inclusive serviços que estavam bem, e não diz qual era o problema. Reiniciar só o queueprocd é a intervenção mínima.

Confundir fila cheia com servidor lento. Fila cheia com daemon ativo e itens saindo é comportamento normal sob carga. Fila cheia com nada saindo é falha.

Checklist de fila travada para rodar em qualquer servidor cPanel

Salve isto no seu runbook e rode na mesma ordem, em qualquer servidor cPanel:

  1. Reproduza o sintoma e anote o horário exato da ação original.
  2. WHM, busca Task Queue, abra o Task Queue Manager.
  3. Localize a tarefa pelo nome e pelo horário. Anote se está em execução ou aguardando.
  4. Verifique o queueprocd em Service Status.
  5. Se parado, reinicie com restartsrv_queueprocd e reavalie a fila.
  6. Se ativo e a fila anda, espere um ciclo antes de qualquer ação destrutiva.
  7. Antes de recriar qualquer coisa, confira o estado real: a conta existe? o domínio resolve? o certificado está instalado?
  8. Só remova a tarefa, pela ação de exclusão na linha dela no Task Queue Manager, se ela estiver duplicada ou se você já decidiu limpar e refazer do zero. Removida a tarefa, limpe o resíduo pelo WHM antes de reexecutar a ação.
  9. Registre no ticket interno: horário, tarefa, decisão tomada, resultado.

Padronização que vale para quem cuida de muitos clientes: nunca faça criação de conta ou emissão de SSL em lote clicando rápido em várias abas. Cada ação entra na mesma fila e você perde a capacidade de saber qual tarefa pertence a qual cliente. Faça em série, com o Task Queue Manager aberto na segunda aba.

O que dizer ao cliente enquanto a tarefa não conclui

O cliente final não quer saber o nome do daemon. Ele quer saber se perdeu dinheiro e quando funciona. Frase pronta, em português de cliente:

Se a tarefa travou de fato e você vai limpar e refazer:

Dizer que vai haver indisponibilidade antes de ela acontecer transforma um incidente em manutenção. Dizer depois transforma em reclamação.

Fila drenando e tarefa ainda falhando: onde procurar a causa real

Se a fila drena normalmente e a tarefa específica continua falhando, pare de mexer na fila. Olhe disco disponível, estado do serviço de DNS e dos serviços dependentes, e o log da operação correspondente. A Task Queue é o mecanismo de entrega, não a causa raiz. Ela atrasa quando alguma coisa embaixo dela está esperando.

E se você é revendedor sem root: o diagnóstico de superfície já foi feito até aqui. Abra o chamado com horário, nome da operação e o que você já verificou. Chamado com essas três informações evita a primeira rodada de perguntas do suporte.

Referências

  1. Documentação oficial (cpanel) — cPanel docs: taskqueue. Consultado em 2026-10-08.
Leia também