Spostamento di server Apigee in corso...

Lo spostamento dei componenti da una macchina all'altra può causare una configurazione non corrispondente se non manterrai sincronizzati gli indirizzi IP nei file di configurazione dei componenti.

Questa sezione descrive come diagnosticare e correggere le mancate corrispondenze delle configurazioni.

Indirizzi IP e nomi host

Devi utilizzare gli indirizzi IP anziché i nomi host nei file di configurazione dei componenti.

Mentre alcuni file di configurazione dei componenti ti consentono di usare i nomi host degli indirizzi IP, l'uso dei nomi host può complicare la risoluzione dei problemi. Ad esempio, i nomi host potrebbero dipendere da problemi di connettività del server DNS, errori di ricerca e la sincronizzazione dei dati.

Di conseguenza, Apigee consiglia vivamente di utilizzare indirizzi IP per tutti i componenti configurazioni. In alcuni casi, ad esempio con Cassandra, devi utilizzare indirizzi IP e non puoi utilizzare nomi host. La maggior parte degli esempi nella documentazione utilizza gli indirizzi IP per la configurazione dei componenti.

Per i nomi host e gli indirizzi IP, considera le implicazioni dei seguenti scenari quando sposti i server Apigee:

Scenario Impatto sullo spostamento dei server
Variazione dell'indirizzo IP Aggiorna tutti i file correlati che fanno riferimento all'indirizzo IP originale
Modifica del nome host senza modifica dell'indirizzo IP Nessun impatto
Modifica del nome host con modifica dell'indirizzo IP Uguale a una modifica dell'indirizzo IP

Modifica dell'indirizzo IP di un nodo Cassandra

Per modificare l'indirizzo IP di un nodo Cassandra, segui questi passaggi:

Per configurazioni con un singolo nodo Cassandra

  1. Modifica /opt/apigee/customer/application/cassandra.properties sul sistema in fase di modifica. Se il file non esiste, crealo.
  2. Modifica i seguenti parametri:
    • Imposta conf_cassandra_seeds e conf_cassandra_listen_address per specificare il nuovo indirizzo IP del sistema.
    • Cambia conf_cassandra_rpc_address da utilizzare il nuovo indirizzo IP o 0.0.0.0 (che consente a Cassandra Thrift di ascoltare su tutti interfacce).
  3. Apri /opt/apigee/apigee-cassandra/conf/cassandra-topology.properties in un editor. Dovresti vedere il vecchio indirizzo IP e l'impostazione predefinita nel formato: 
    192.168.56.101=dc-1:ra-1
default=dc-1:ra-1

    Salva queste informazioni.

  4. Modifica /opt/apigee/customer/application/cassandra.properties per sostituire il vecchio indirizzo IP specificato con quello nuovo: 
    conf_cassandra-topology_topology=192.168.56.103=dc-1:ra-1\ndefault=dc-1:ra-1\n

    Assicurati di inserire "\n" dopo l'indirizzo IP e specificare le stesse impostazioni predefinite che hai indicato nel Passaggio 3.

  5. Riavvia Cassandra: 
    /opt/apigee/apigee-service/bin/apigee-service apigee-cassandra restart
  6. Se necessario, ripara anche ZooKeeper (consulta Modifica dell'indirizzo IP di un nodo ZooKeeper). In caso contrario, riavvia ogni componente della piattaforma Apigee, a partire dal server di gestione.

Per configurazioni con più nodi Cassandra (anello)

  1. Se il nodo da modificare è un nodo seed, modifica /opt/apigee/customer/application/cassandra.properties file su ciascun sistema nell'anello e modifica il parametro conf_cassandra_seeds in modo da includere al nuovo IP del sistema modificato. Se il file cassandra.properties non esiste, crea li annotino.
  2. Modifica /opt/apigee/customer/application/cassandra.properties sul sistema da modificare e modifica i seguenti parametri:
    • Imposta conf_cassandra_listen_address per utilizzare il nuovo indirizzo IP.
    • Imposta conf_cassandra_rpc_address in modo che utilizzi il nuovo indirizzo IP o "0.0.0.0" (in questo modo Cassandra Thrift può rimanere in ascolto su tutte le interfacce).
  3. Apri /opt/apigee/apigee-cassandra/conf/cassandra-topology.properties in un editor. Dovresti vedere tutti gli indirizzi IP e l'impostazione predefinita di Cassandra nella modulo: 
    192.168.56.101=dc-1:ra-1
192.168.56.102=dc-1:ra-1
192.168.56.103=dc-1:ra-1
default=dc-1:ra-1

    Salva queste informazioni.

  4. Modifica /opt/apigee/customer/application/cassandra.properties per sostituire il vecchio indirizzo IP specificato con quello nuovo: 
    conf_cassandra-topology_topology=192.168.56.101=dc-1:ra-1\n192.168.56.102=dc-1:ra-1\n192.168.56.104=dc-1:ra-1\ndefault=dc-1:ra-1\n

    Assicurati di inserire "\n" dopo ogni indirizzo IP e utilizza le stesse impostazioni predefinite registrati in precedenza nel Passaggio 3.

  5. Riavvia Cassandra sul sistema modificato. 
    /opt/apigee/apigee-service/bin/apigee-service apigee-cassandra restart
  6. Per tutti gli altri nodi, ripeti le modifiche apportate nei passaggi 3 e 4 per informarli della posizione di questo nodo nell'anello di Cassandra. Inoltre, modifica l'IP del nodo seed come descritto nel passaggio 1.
  7. Riavvia uno alla volta ogni nodo Cassandra rimanente. 
    /opt/apigee/apigee-service/bin/apigee-service apigee-cassandra restart
  8. Esegui il comando nodetool ring sul nodo modificato per assicurarti che l'anello sia completo. L'utilità è disponibile all'indirizzo /opt/apigee/apigee-cassandra/bin. 
    nodetool [-u username -pw password] -h localhost ring
  9. Esegui nodetool repair sul nodo modificato. Tieni presente che questo processo potrebbe richiedere del tempo, quindi ti consigliamo vivamente di non farlo durante le ore di picco del traffico API. 
    nodetool [-u username -pw password] -h localhost repair -pr
  10. Se necessario, ripara ZooKeeper (vedi Modifica dell'indirizzo IP di un nodo ZooKeeper), quindi riavvia ogni componente della piattaforma Apigee, a partire dal server di gestione.

Aggiorna datastore registrazioni

  1. Trova gli UUID delle registrazioni dei datastore che specificano il vecchio indirizzo IP utilizzando il metodo i comandi seguenti. Prendi nota del "tipo" e "UUID" parametri: 
    • curl -u ADMINEMAIL:PW "http://$MSIP:$port/v1/servers?pod=central&region=DC" | egrep -i '[type|internalip|uuid|region]'
       
    • curl -u ADMINEMAIL:PW "http://$MSIP:$port/v1/servers?pod=gateway&region=DC" | egrep -i '[type|internalip|uuid|region]'
       
    • curl -u ADMINEMAIL:PW "http://$MSIP:$port/v1/servers?pod=analytics&region=DC" | egrep -i '[type|internalip|uuid|region]'

      Dove DC è il nome del data center. In un'unica installazione di un data center, in genere è "dc-1".

  2. Registra i nuovi indirizzi IP utilizzando uno dei comandi seguenti. Il comando necessario dipendono dal tipo di nodo modificato.
    • Per type="application-datastore": 
      curl -u ADMINEMAIL:PW "http://MSIP:port/v1/servers -d \
  "Type=application-datastore&Type=audit-datastore&InternalIP=NEWIP&region=REGION&pod=central" \
  -H 'content-type: application/x-www-form-urlencoded' -X POST
    • Per type="kms-datastore": 
      curl -u ADMINEMAIL:PW "http://MSIP:port/v1/servers -d \
  "Type=kms-datastore&Type=dc-datastore&Type=keyvaluemap-datastore&Type=counter-datastore&Type=cache-datastore \
  &InternalIP=NEWIP&region=REGION&pod=GATEWAY_POD" -H 'content-type: \
  application/x-www-form-urlencoded' -X POST
    • Per type="reportcrud-datastore": 
      curl -u ADMINEMAIL:PW "http://MSIP:port/v1/servers" -d \
  "Type=reportcrud-datastore&InternalIP=NEW_IP&region=REGION&pod=analytics" \
  -H 'content-type: application/x-www-form-urlencoded' -X POST
  3. Elimina le vecchie registrazioni per l'UUID del sistema su cui era l'indirizzo IP è cambiato. Per ciascuno di questi UUID problemi: 
    curl -u ADMINEMAIL:PW "http://MSIP:port/v1/servers/OLD_UUID" -X DELETE

Modifica dell'indirizzo IP di un nodo ZooKeeper

Per modificare l'indirizzo IP di un nodo ZooKeeper, procedi nel seguente modo:

Modificare l'indirizzo IP e riavviare l'ensemble ZooKeeper (per configurazioni di ensemble multinodo) )

  1. Apri /opt/apigee/apigee-zookeeper/conf/zoo.cfg in un editor. Dovresti vedere tutti gli indirizzi IP e le impostazioni predefinite di ZooKeeper, nel formato seguente: 
    server.1=192.168.56.101:2888:3888
server.2=192.168.56.102:2888:3888
server.3=192.168.56.103:2888:3888

    Salva queste informazioni.

  2. Su ogni nodo ZooKeeper, modifica il file /opt/apigee/customer/application/zookeeper.properties per impostare la proprietà conf_zoo_quorum sugli indirizzi IP corretti. Se il file non esiste, crearlo. 
    conf_zoo_quorum=server.1=192.168.56.101:2888:3888\nserver.2=192.168.56.102:2888:3888\nserver.3=192.168.56.104:2888:3888\n

    Assicurati di inserire "\n" dopo ogni indirizzo IP e che le voci siano nello stesso ordine in ogni nodo.

  3. Trova il leader del gruppo ZooKeeper utilizzando il seguente comando (sostituisci node con l'indirizzo IP della macchina Zookeeper): 
    echo srvr | nc node 2181

    La riga Modalità nell'output dovrebbe indicare "leader".

  4. Riavvia uno ZooKeeper dopo l'altro iniziando con la variante leader e terminando con il nodo attivo che l'indirizzo IP è stato modificato. Se più di un nodo zookeeper ha modificato gli indirizzi IP, per riavviare tutti i nodi. 
    /opt/apigee/apigee-service/bin/apigee-service apigee-zookeeper restart
  5. Utilizza il comando echo descritto sopra per verificare ciascun nodo ZooKeeper.

Informa i nodi Apigee della configurazione modificata

  1. Su ciascun nodo del router, modifica il file /opt/apigee/customer/application/router.properties come segue: Se il file non esiste, crealo.
    • Modifica il parametro conf_zookeeper_connection.string in modo da includere il nuovo IP indirizzo
    • Modifica il parametro conf_zookeeper_zk1.host in modo da includere il nuovo IP indirizzo
  2. Su ogni nodo del processore di messaggi, modifica il file /opt/apigee/customer/application/message-processor.properties come segue: Se il file non esiste, crealo.
    • Modifica il parametro conf_zookeeper_connection.string per includere il nuovo Indirizzo IP
    • Modifica il parametro conf_zookeeper_zk1.host in modo da includere il nuovo IP indirizzo
  3. Sul nodo del server di gestione, modifica il file /opt/apigee/customer/application/management-server.properties come segue: Se il file non esiste, crealo.
    • Modifica il parametro conf_zookeeper_connection.string per includere il nuovo Indirizzo IP
    • Modifica il parametro conf_zookeeper_zk1.host in modo da includere il nuovo IP indirizzo
  4. Riavvia tutti i componenti della piattaforma Apigee eseguendo questo comando su ciascun nodo: 
    /opt/apigee/apigee-service/bin/apigee-all restart

Modifica dell'indirizzo IP di un server LDAP (OpenLDAP)

Per modificare l'indirizzo IP di un nodo OpenLDAP, segui questi passaggi:

  1. Sul nodo del server di gestione, modifica il file /opt/apigee/customer/application/management-server.properties . Se il file non esiste, crealo.
  2. Nel file management-server.properties, imposta il valore conf_security_ldap.server.host al nuovo indirizzo IP.
  3. Riavvia il server di gestione: 
    /opt/apigee/apigee-service/bin/apigee-service edge-management-server restart

Modifica dell'indirizzo IP di un altro nodo Apigee Tipi

Per modificare l'indirizzo IP di uno di questi tipi di nodi (router, processore di messaggi, Postgres, Server (non postgresql) e Qpid Server (non qpidd):

  1. Usa il seguente comando curl per registrare i nuovi indirizzi IP interni ed esterni: 
    curl -u ADMINEMAIL:PW -X PUT \
  http://MSIP:8080/v1/servers/uuid -d ExternalIP=ip
curl -u ADMINEMAIL:PW -X PUT \
  http://$MSIP:8080/v1/servers/uuid -d InternalIP=ip

    Dove uuid è l'UUID del nodo.

Per informazioni su come ottenere l'UUID di un componente, consulta la sezione Recuperare gli UUID.