MicroStrategy ONE

Risoluzione dei problemi relativi alla topologia

Questa sezione tratta i problemi che possono verificarsi nella Workstation e come correggerli.

Come abilitare la registrazione del debug

La registrazione del debug registra gli errori e altre informazioni utili sul motivo per cui si è verificato un problema. Per la procedura per abilitare la registrazione debug, vedere KB483668: Come abilitare la registrazione debug per la topologia.

La registrazione ai servizi non funziona in assenza di connessione di rete

Se non è disponibile alcuna connessione di rete dopo l'installazione, la registrazione dei servizi funziona comunque per tutti i servizi locali. In caso contrario, assicurarsi che l'utente che accede alla macchina sia un amministratore locale. Un utente con privilegi adeguati per la registrazione dei servizi, quando connesso alla rete, potrebbe non disporre dei privilegi di amministratore completi a livello locale in assenza di connessione di rete.

Impossibile avviare l'agente di registrazione servizi e Nessun indirizzo IPV4 privato trovato si trova nel file di log

  1. Se la macchina dispone di più indirizzi IP, vedere Configurazione di ambienti con più indirizzi IP

  2. Se la macchina dispone di un solo indirizzo IP, verificare le impostazioni di rete utilizzando il seguente comando, se IPv4 lo è non nell'elenco di indirizzi privati accettabili (RFC1918) fornito nella tabella seguente.

    • Su Windows:

      Copia 
      ipconfig/all

    • Su Linux:

      Copia 
      ifconfig -a

    Nome RFC1918 Intervallo di indirizzi IP Numero di indirizzi Blocco CIDR più grande (maschera di sottorete) Dimensioni dell'ID host Pezzi di maschera Descrizione di classe
    Blocco a 24 bit 10.0.0.0 - 10.255.255.255 16.777.216 10.0.0.0/8 (255.0.0.0) 24 bit 8 bit Rete unica di classe A
    Blocco da 20 bit 172.16.0.0 - 172.31.255.255 1.048.576 172.16.0.0/12 (255.240.0.0) 20 bit 12 bit 16 reti contigue di classe B
    Blocco a 16 bit 192.168.0.0 - 192.168.255.255 65.536 192.168.0.0/16 (255.255.0.0) 16 bit 16 bit 256 reti contigue di classe C

  3. Verificare se la configurazione di rete è prevista. Se è così e desideri utilizzare la registrazione del servizio, completa i passaggi 4 e 5 per trovare una soluzione alternativa per associare l'agente di registrazione del servizio all'indirizzo IPv4 non accettabile.
  4. Passare a Services Registration\yaml cartella.

  5. Modificare il installation_list.yaml file aggiungendo bind_addr: xxxx alla sezione consolare. Assicurati di includere uno spazio tra i due punti e l'indirizzo IP.

    Copia 
    consul:
      install_path: "C:\\Program Files (x86)\\MicroStrategy\\Services Registration"
      java_install_path: "C:\\Program Files (x86)\\Common Files\\MicroStrategy\\JRE\\180_192\\Win64\\bin"
      server: false
      retry_join:
       - sap-win2016.labs.microstrategy.com
       - pcheng-W10-PRO.labs.microstrategy.com
       - pcheng-RHEL-6-8.labs.microstrategy.com
      bind_addr: 10.21.20.222
  6. Arrestare l'agente di registrazione del servizio, eliminare il Services Registration\data cartella e riavviare l'agente di registrazione del servizio.

"La registrazione ai servizi MicroStrategy NON è disponibile. Controllare lo stato del servizio."

Quando si utilizza la topologia di Workstation per monitorare i servizi, viene visualizzata una pagina vuota con il messaggio "La registrazione ai servizi MicroStrategy NON è disponibile. Verificare lo stato del servizio". Seguire i passaggi seguenti per risolvere questo problema.

L'agente di registrazione del servizio è in esecuzione sul computer Library a cui si connette Workstation?

Accedere al computer in cui è installato Library e verificare se la registrazione ai Servizi MicroStrategy è in esecuzione. Su Windows, utilizzare Gestione servizi Windows. In Linux, usare ps -ef | grep console.

Se l'agente è in esecuzione, controlla se la formazione dell'agente cluster è avvenuta correttamente. Vedere Aggiornamento delle porte dei servizi per la registrazione dei servizi o il monitoraggio della topologia per ulteriori informazioni.

  1. Se è presente un firewall sul computer in cui è installato Library, assicurarsi che le porte 8300(TCP) e 8301(TCP/UDP) siano aperte.
  2. Provare a eseguire il ping dei computer elencati in Services Registration/config/consul.json per "retry_join " per garantire l'accesso ai computer.
  3. Assicurati che l'elezione del leader sia completata. Controllare il ServicesRegistration log con il timestamp più recente in formato Services Registration/log cartella. Se viene visualizzato il messaggio "Impossibile sincronizzare lo stato remoto: Nessun leader cluster", seguire i passaggi 4 e 5. Altrimenti, vai al passaggio 6.
  4. La corretta configurazione del cluster deve essere verificata su ogni macchina con un agente di registrazione del servizio. Controlla la configurazione del cluster. Dovrebbero esserci uno o tre agenti di comunicazione definiti nel cluster, come specificato nella sezione "retry_join " elenco di installation_list.yaml file. Questo elenco dovrebbe essere coerente su tutti i nodi.
  5. Verificare che non siano presenti dati sporchi in Services Registration/data cartella. Dopo la creazione o la modifica non riuscita dei membri del cluster, nei file di dati potrebbero essere rimasti dati non validi. Arrestare tutti gli agenti, eliminare il Services Registration/data cartella su ogni nodo del cluster e riavviare tutti gli agenti per formare il cluster.
  6. Se MicroStrategy Library è distribuito su un computer in cui i MicroStrategy Services non sono installati, accedere al server applicazioni che gestisce la console e riavviare la distribuzione di MicroStrategy Library. Se l'agente non è in esecuzione, selezionare ServicesRegistration log con il timestamp più recente in formato Services Registration/log cartella per verificare il motivo per cui l'agente non è stato avviato. Se viene visualizzato il messaggio "Nessun indirizzo IPv4 privato trovato", vedere Impossibile avviare l'agente di registrazione servizi.

Se l'agente non è in esecuzione, controllare il file di registro ServicesRegistration con il timestamp più recente in Services Registration\log cartella per verificare il motivo per cui l'agente non può essere avviato.

La macchina ha più indirizzi IP? Tutti gli IP erano disponibili durante l'installazione del prodotto?

La macchina ha un indirizzo IP non accettabile? Se l'agente ha visualizzato il messaggio "Nessun indirizzo IPv4 privato trovato", vedere Impossibile avviare l'agente di registrazione servizi.

Come è stato distribuito il file WAR di MicroStrategy Library sul server?

Potrebbero verificarsi problemi se il server Linux non è stato aggiornato correttamente. Ad esempio, se è stato eseguito l'aggiornamento alla versione 11.0 dalla versione 10.10 su un server Linux, il programma di installazione di MicroStrategy non è stato eseguito, ma il file WAR è stato scaricato e copiato. In questo caso, vedere Installare MicroStrategy nel Aggiornamento sul posto in una distribuzione Linux sezione del Upgrade Help e Scenari di distribuzione nel Installazione di MicroStrategy Library su Linux sezione del Upgrade Help.

I nodi comunicano tra loro tramite la traduzione degli indirizzi di rete (NAT)?

NAT non è attualmente supportato dalla funzione di registrazione del servizio.

Un servizio visualizza un'icona rossa

  1. In Workstation, posizionare il cursore del mouse sull'icona dell'arresto per visualizzare informazioni aggiuntive nel tooltip.
  2. Esaminare le possibili cause fornite nella descrizione comando.
  3. Verificare che il servizio sia in esecuzione. Accedere al computer su cui è installato il servizio. Verificare che sia in esecuzione in Gestione servizi Windows.
  4. Verificare che la porta richiesta sia disponibile. Se il servizio non si avvia, verificare se la porta richiesta è disponibile. Vedere MicroStrategy Platform Services supportati per visualizzare le porte predefinite.
  5. Verificare che nel file di configurazione sia presente la porta corretta. Se il servizio è in esecuzione, ma su Workstation viene visualizzato il messaggio che il servizio è inattivo, controllare il file di configurazione (ad esempio MicroStrategy Mobile Server JSP.json ) per questo servizio. Il file di configurazione si trova nella directory di installazione all'indirizzo MicroStrategy/Services Registration/config. Controlla se il numero di porta, il numero di porta http e il numero di porta https sono coerenti con la porta utilizzata per il servizio.
  6. Se le porte sono definite correttamente in service.json ma in Workstation il servizio è inattivo, copia l'URL del controllo dello stato da service.json file. Incolla l'URL nel browser per vedere se è un collegamento valido. Se il collegamento non funziona, sostituire "localhost " con l'indirizzo IP del computer da cui si sta accedendo all'URL, quindi riprovare.
  7. Controllare il file di log in /MicroStrategy/Services Registration/log nella directory di installazione.

Se un servizio è configurato per utilizzare un numero di porta non predefinito dopo l'installazione, il nuovo numero di porta non viene registrato nel file di configurazione JSON. È necessario aggiornare manualmente il file JSON con il numero di porta configurato dopo l'installazione e riavviare MicroStrategy Service Registry. VedereAggiornamento delle porte dei servizi per la registrazione dei servizi o il monitoraggio della topologia per ulteriori informazioni.

Impossibile avviare o interrompere un servizio

  1. Connettersi a un ambiente, assicurandosi che l'accesso utente corrispondente disponga di privilegi adeguati. In Workstation, accedere a un ambiente come utente di MicroStrategy con privilegi di amministratore o come utente amministratore del contenitore Web per Library. In modalità manutenzione, vai alla visualizzazione della topologia e verifica che la funzionalità di avvio/arresto sia supportata per un servizio, facendo clic con il pulsante destro del mouse sul servizio. Se il Avvia e Interrompi opzioni nel menu a comparsa sono disattivate, la funzione di avvio/arresto non è supportata per quel servizio.
  2. Verifica che SSH sia disponibile e in esecuzione sul computer su cui è installato il servizio. In caso contrario, vedere Configurazione di SSH in Windows o Configurazione SSH su Linux.
  3. Verificare che il firewall sia abilitato e che la porta 22 sia aperta sul firewall.
  4. Verifica lo stato del servizio in una vista aggiornata. Se un utente ha inviato la richiesta di avvio o arresto nella workstation, prima che venga inviata un'altra richiesta, aggiornare la visualizzazione della topologia per ottenere lo stato del servizio più recente.

Un servizio non è raggiungibile

  1. Verificare che il computer in cui è ospitato il servizio sia raggiungibile dal computer MicroStrategy Library.
  2. Se nell'ambiente sono presenti firewall, verificare che le porte (8300 e 8301) siano aperte per supportare l'invio e la ricezione di richieste TCP/UDP tra le macchine che ospitano i servizi.
  3. Verificare che l'agente sia in esecuzione. In Windows, utilizzare Gestione servizi di Windows per verificare se la registrazione ai servizi MicroStrategy è in esecuzione. In Linux, usare ps -ef | grep -i consul.

Consul non si avvia dopo l'installazione dell'hotfix MicroStrategy 2019 Update 2 su un computer Linux

Lo strumento nslookup risulta mancante se Redhat Enterprise Linux 7 è installato utilizzando l'opzione minimal. Consul dipende dal comando nslookup per risolvere l'indirizzo IP di una macchina dal nome di dominio completo (FQDN). Per garantire che Consul possa essere avviato correttamente, installa lo strumento mancante eseguendo il seguente comando in un terminale:

Copia 
# yum install bind-utils

Distribuzioni personalizzate

Caso 1: quando si installa la topologia in un ambiente con due computer, i servizi MicroStrategy vengono installati senza l'opzione più computer. Di conseguenza, è necessario configurare manualmente il cluster della console dopo l'installazione. In questo caso, Library è stata distribuita tramite il programma di installazione e sia Library che il server Web si trovano sullo stesso computer. L'Intelligence Server è installato su un'altra macchina. Innanzitutto, assicurarsi che le porte richieste sono aperte.

Su tutte le macchine

  1. Interrompere la registrazione dei servizi su tutte le macchine. In questo caso le macchine sono due.

    • In Windows, utilizzare Service Manager (Esegui > services.msc ) per arrestare la registrazione ai MicroStrategy Services.

    • Per Linux, vedere Riavvio della registrazione dei servizi per i passaggi dettagliati.

  2. Passare alla directory di installazione ed eliminare MicroStrategy/Services Registration/data.

  3. Riavvia la registrazione dei servizi su tutte le macchine nello stesso cluster di console

Sul computer server Library:

  1. Passare a MicroStrategy/Services Registration/yaml directory.
  2. Apri installation_list.yaml e individuare la sezione console.
  3. Aggiungere il retry_join con l'FQDN dell'Intelligence Server, in modo che il server Library possa puntarvi.
  4. Verificare il server il parametro è impostato su false.
  5. Rimuovere il bootstrap_expect: <number> riga.

Sulla macchina del server Intelligence:

  1. Passare a MicroStrategy/Services Registration/yaml directory.
  2. Apri installation_list.yaml e individuare la sezione console.
  3. Aggiorna retry_join elencando gli FQDN di tutti gli agenti di comunicazione. Vedere Specifica dell'agente di comunicazione della topologia per ulteriori informazioni.
  4. Rimuove gli FQDN di tutti gli agenti di monitoraggio da retry_join.
  5. Verificare il formato per retry_join corrisponde al formato mostrato in Modifica dell'agente di monitoraggio in un agente di comunicazione.
  6. Aggiungi bootstrap_expect: <number>. Vedere Specifica dell'agente di comunicazione della topologia per ulteriori informazioni.
  7. Modifica server: true a server: false.
  8. Salvare il file.

Caso 2: JBoss è in esecuzione sullo stesso computer di Intelligence Server. Sia Web che Library sono installati, ma distribuiti in JBoss.

  1. Poiché Web e Library si trovano sullo stesso computer, entrambi MicroStrategy Web Server JSP.json e MicroStrategy Library REST Server.json sono disponibili in ServicesRegistration/config cartella di installazione. Aggiorna installation_list.yaml con il numero di porta utilizzato per la distribuzione JBoss di Web e Library, se necessario. Vedere Aggiornamento delle porte dei servizi per la registrazione dei servizi o il monitoraggio della topologia per aggiornare le porte.
  2. Eseguire un controllo dello stato andando a http://localhost:8080/MicroStrategyLibrary/health e http://10.248.128.29:8080/MicroStrategy/health. Sostituisci 8080 con il numero di porta su cui è in esecuzione Web e Library. Se il problema persiste, prova a sostituire localhost con l'indirizzo IP della macchina.
  3. Arrestare il console ed eliminare il ServicesRegistration/data cartella.
  4. Riavviare la registrazione dei servizi.

Impossibile monitorare o controllare i servizi MicroStrategy da Workstation

In determinate situazioni, il programma di installazione potrebbe non generare i file JSON per i servizi MicroStrategy, quali Intelligence Server, Platform Web, Library, Collaboration Server e altri. Di conseguenza, la sottocartella config potrebbe non essere generata all'interno della directory di installazione della registrazione dei servizi oppure la cartella config potrebbe contenere solo un singolo file JSON. Quando si verifica una di queste situazioni, alcuni o tutti i servizi non possono essere monitorati o controllati tramite Workstation.

Per risolvere questo problema, vai al nodo problematico ed esegui i seguenti passaggi.

  1. Passare alla cartella jar nella directory di installazione della registrazione dei servizi.

    • Windows:

      C:\Program Files (x86)\MicroStrategy\Services Registration\jar

    • Linux:

      /opt/MicroStrategy/ServicesRegistration/jar

  2. Esegui il seguente comando:

    Copia 
    # java -jar svcsreg-admin.jar parse
  3. Verifica che i file JSON vengano generati nella cartella di configurazione.

  4. Riavviare la registrazione ai Servizi MicroStrategy.

    • In Windows, eseguire il riavvio tramite Gestione servizi Windows.

    • In Linux, esegui il seguente comando:

      Copia 
      # java -jar svcsreg-admin.jar control consul restart
  5. Aprire la scheda Topologia in Workstation. A questo punto dovrebbe essere possibile monitorare lo stato dei servizi e impartire comandi di avvio e arresto ai servizi MicroStrategy.

Argomenti correlati

Installazione e configurazione della topologia