Skip to main content

Risoluzione dei problemi

Questa sezione elenca i problemi più frequentemente riscontrati con il modulo registrar HostMyServers per WHMCS, insieme alle procedure per diagnosticarli e risolverli.

Attivare la modalità debug​

Prima di cercare l'origine di un problema, attiva i log di debug in WHMCS:

Configurazione → Sistema → Moduli registrar → HostMyServers → Configura → Modalità debug: Attivata

Una volta attivata, ogni chiamata API del modulo viene registrata nei log WHMCS. Accedi ai log da:

Utilità → Attività → Registrar Log

Le voci mostrano la richiesta inviata e la risposta ricevuta dall'API HostMyServers, consentendo di identificare con precisione l'origine di un errore.

Disattiva dopo la diagnosi

La modalità debug genera grandi volumi di log e può rallentare leggermente il tuo WHMCS. Disattivala non appena il problema è risolto.

Problemi di connessione​

Il modulo non appare nell'elenco dei registrar​

Sintomo: dopo l'installazione, HostMyServers non è visibile in Configurazione → Moduli registrar.

Cause e soluzioni:

  • La cartella del modulo non è denominata esattamente hostmyservers (tutto in minuscolo, senza trattini o spazi) → rinominarla
  • Il file hostmyservers.php è assente o mal posizionato → verificare la struttura della cartella
  • Problema di permessi → eseguire chmod 644 sui file e chmod 755 sulle cartelle
  • Cache WHMCS → Utilità → Svuota cache dei template

Errore "Connessione rifiutata" o timeout​

Sintomo: il test di connessione fallisce con un errore di connessione o timeout.

Cause e soluzioni:

  • Il server non riesce a raggiungere l'endpoint API HostMyServers → verificare il firewall in uscita del server. L'API utilizza la porta 443 (HTTPS)
  • cURL non installato o disattivato → verificare con php -m | grep curl

Errore di autenticazione (401 / Credenziali non valide)​

Sintomo: il test di connessione restituisce "Credenziali non valide" o un errore 401.

Cause e soluzioni:

  • Identificativo API o chiave API errati → verificare su hostmyservers.fr/user/api
  • Modalità Sandbox attivata con credenziali di produzione (o viceversa) → assicurarsi della coerenza tra modalità e credenziali
  • La chiave API è stata eliminata/ricreata su hostmyservers.fr/user/api senza aggiornare WHMCS → aggiornare la chiave nella configurazione del modulo

Problemi di registrazione / operazioni​

Il dominio rimane in stato "In attesa" indefinitamente​

Sintomo: dopo un ordine, il dominio non passa mai allo stato Attivo.

Cause e soluzioni:

  • Registrazione asincrona normale (alcuni TLD richiedono diverse ore) → attendere e forzare una sincronizzazione
  • Errore silenzioso durante la registrazione → attivare la modalità debug e consultare i log
  • Saldo insufficiente al momento dell'ordine → verificare il saldo nell'area clienti HostMyServers e ricaricare se necessario, quindi riavviare manualmente la registrazione

Errore durante il rinnovo automatico​

Sintomo: il cron avvia un rinnovo che fallisce silenziosamente.

Cause e soluzioni:

  • Saldo insufficiente → ricaricare il conto e riavviare manualmente il rinnovo
  • Data di scadenza errata in WHMCS → avviare una sincronizzazione per correggere, poi rinnovare
  • Dominio scaduto da più di 30 giorni (fuori dal periodo di grazia) → contattare il supporto HostMyServers per un ripristino

I nameserver non vengono aggiornati​

Sintomo: la modifica dei nameserver in WHMCS non viene recepita da HostMyServers.

Cause e soluzioni:

  • Formato nameserver non valido (es. presenza di / finale o spazio) → verificare i valori inseriti
  • Il TLD non supporta la modifica dei nameserver tramite API → consultare la documentazione HostMyServers per questo TLD
  • Errore API → attivare il debug e consultare i log

Problemi di sincronizzazione​

Le date di scadenza sono errate in WHMCS​

Sintomo: la data di scadenza visualizzata in WHMCS non corrisponde alla realtà in HostMyServers.

Soluzione:

  1. Vai su Utilità → Sincronizzazione domini
  2. Avvia una sincronizzazione completa
  3. WHMCS confronta e corregge le date automaticamente

Se il problema persiste su un dominio specifico, consulta i log di sincronizzazione per identificare l'errore restituito dall'API.

La sincronizzazione non viene eseguita​

Sintomo: gli stati e le date non vengono mai aggiornati automaticamente.

Causa: il task cron WHMCS non è configurato o non viene eseguito.

Soluzione: verificare la configurazione del cron (vedi Automazione).

Problemi di account​

Saldo insufficiente​

Se il saldo HostMyServers è insufficiente, tutte le operazioni a pagamento (registrazione, rinnovo, trasferimento) falliranno con un errore Insufficient funds.

Soluzione: ricarica il tuo account dall'area clienti HostMyServers. Attiva gli avvisi di saldo basso per evitare questo tipo di incidente.

Ordine in attesa di validazione manuale​

Alcuni ordini possono essere messi in attesa di validazione manuale da HostMyServers (in particolare per TLD specifici o volumi insoliti). In questo caso, contatta direttamente il supporto HostMyServers.

Contattare il supporto HostMyServers​

Se non riesci a risolvere il problema dopo aver consultato questa documentazione:

  1. Nota il messaggio di errore esatto e i corrispondenti log di debug
  2. Nota la versione del modulo (visibile in hostmyservers.php all'inizio del file)
  3. Nota la tua versione WHMCS e PHP
  4. Contatta il supporto HostMyServers includendo queste informazioni

Il supporto HostMyServers è disponibile dalla tua area clienti → Supporto → Apri un ticket.