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.

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
- O que é a Task Queue e por que a ação some da tela sem dar erro
- Quem consegue ver a fila: root, SSH e o que sobra para o revendedor
- Como descobrir se a tarefa está rodando, esperando ou morta
- Esperar, reexecutar ou remover: a decisão por sintoma observado
- Os quatro erros que viram conta duplicada ou SSL emitido duas vezes
- Checklist de fila travada para rodar em qualquer servidor cPanel
- O que dizer ao cliente enquanto a tarefa não conclui
- 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:
- A interface pode voltar "sucesso" significando apenas que o pedido foi aceito, não concluído.
- Se o
queueprocdestiver parado ou engasgado, tudo continua sendo aceito e nada é processado. Não aparece erro em lugar nenhum, porque ninguém falhou: ninguém executou.
É exatamente o cenário de "travou e não termina". Antes de refazer qualquer coisa, olhe a fila.
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.
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:
- Reproduza o sintoma e anote o horário exato da ação original.
- WHM, busca
Task Queue, abra o Task Queue Manager. - Localize a tarefa pelo nome e pelo horário. Anote se está em execução ou aguardando.
- Verifique o
queueprocdem Service Status. - Se parado, reinicie com
restartsrv_queueprocde reavalie a fila. - Se ativo e a fila anda, espere um ciclo antes de qualquer ação destrutiva.
- Antes de recriar qualquer coisa, confira o estado real: a conta existe? o domínio resolve? o certificado está instalado?
- 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.
- 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
- Documentação oficial (cpanel) — cPanel docs: taskqueue. Consultado em 2026-10-08.