Spostamento di server Apigee

Edge per Private Cloud v. 4.17.05

I componenti Apigee utilizzano gli indirizzi IP per comunicare tra loro. Lo spostamento di componenti da una macchina all'altra può causare una mancata corrispondenza della configurazione. Per correggere le mancate corrispondenze della configurazione, segui le istruzioni pertinenti riportate di seguito.

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 da modificare. Se il file non esiste, crealo.
  2. Modifica i seguenti parametri:
    • Imposta i parametri conf_cassandra_seeds e conf_cassandra_listen_address per specificare il nuovo indirizzo IP del sistema.
    • Modifica conf_cassandra_rpc_address per utilizzare il nuovo indirizzo IP o 0.0.0.0 (che consente a Cassandra Thrift di ascoltare su tutte le 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 cambiare 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 lo stesso indirizzo IP e specificalo nel passaggio predefinito indicato sopra
  5. Riavvia Cassandra:
    > /opt/apigee/apigee-service/bin/apigee-service apigee-cassandra inizia
  6. Se necessario, ripara anche ZooKeeper (vedi di seguito), altrimenti 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 il file /opt/apigee/customer/application/cassandra.properties su ciascun sistema nell'anello e modifica il parametro conf_cassandra_seeds in modo da includere il nuovo IP del sistema modificato. Se il file cassandra.properties non esiste, crealo.
  2. Modifica /opt/apigee/customer/application/cassandra.properties sul sistema da modificare e i seguenti parametri:
    • Imposta conf_cassandra_listen_address in modo da utilizzare il nuovo indirizzo IP.
    • Imposta conf_cassandra_rpc_address per utilizzare il nuovo indirizzo IP o 0.0.0.0 (che consente a Cassandra Thrift di ascoltare su tutte le interfacce).
  3. Apri /opt/apigee/apigee-cassandra/conf/cassandra-topology.properties in un editor. Tutti gli indirizzi IP e l'impostazione predefinita di Cassandra dovrebbero essere visualizzati nel formato:
    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

  4. Modifica /opt/apigee/customer/application/cassandra.properties per cambiare il vecchio indirizzo IP specificato nel nuovo indirizzo IP:
    /opt/apigee/customer/application/cassandra.properties

  5. Riavvia Cassandra sul sistema modificato. Se il sistema modificato è un nodo seed, riavvia anche ogni sistema che ha utilizzato il nodo seed modificato.
    > /opt/apigee/apigee-service/bin/apigee-service apigee-cassandra reboot
  6. Esegui il comando nodetool ring sul nodo modificato per garantire che l'anello sia completo. L'utilità è disponibile all'indirizzo opt/apigee/apigee-cassandra/bin.
    > nodetool -h localhost ring
  7. Esegui nodetool Repair sul nodo modificato. Tieni presente che questa procedura potrebbe richiedere del tempo, perciò è vivamente consigliato non eseguirla nelle ore di picco del traffico API.
    > nodetool -h localhost riparazione
  8. Se necessario, ripara ZooKeeper (vedi di seguito), quindi riavvia ogni componente della piattaforma Apigee a partire dal server di gestione

Aggiorna registrazioni datastore

  1. Trova gli UUID delle registrazioni del datastore specificando il vecchio indirizzo IP utilizzando i comandi riportati di seguito. Prendi nota dei parametri "type" e "UUID":
    • 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 genere, in una singola installazione di data center il valore è "dc-1".
  2. Registra i nuovi indirizzi IP utilizzando uno dei comandi riportati di seguito. Il comando necessario dipenderà dal tipo di nodo modificato.

    Nota: il parametro REGION di seguito si riferisce al data center in cui si trova il cluster. Ad esempio, per l'alta disponibilità in genere disponi di un cluster in dc-1 (Data Center 1) e di un cluster in dc-2 (Data Center 2). Questo parametro è definito al momento dell'installazione. Il valore predefinito è dc-1.
    • 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-url
    • 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-coded-codificato
    • 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-POST url
  3. Elimina le vecchie registrazioni per l'UUID del sistema in cui è stato modificato l'indirizzo IP. Per ciascuno di questi problemi relativi a UUID:
    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:

Modifica l'indirizzo IP e riavvia l'ensemble ZooKeeper (solo per configurazioni di insiemi di più nodi)

  1. Apri /opt/apigee/apigee-zookeeper/conf/zoo.cfg in un editor. Tutti gli indirizzi IP e l'impostazione predefinita di ZooKeeper dovrebbero essere visualizzati nel formato:
    server.1=192.168.56.101:2888:3888
    server.2=192.168.56.102:2888:3888
    server.3=192.168.58.803:
    server.3=192.168.58.80:
  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, crealo.
    conf_zoo_quorum=server.1=192.168.56.101:2888:3888nserver.2=192.168.56.102:2888:3888nserver.3=192.168.56.104:2888:3888n Verifica che tutti gli indirizzi IP inseriti siano uguali\n

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

    La riga Mode nell'output dovrebbe riportare "leader".
  4. Riavvia uno ZooKeeper dopo l'altro, iniziando con il leader e terminando con il nodo su cui è stato modificato l'indirizzo IP. Se più di un nodo zookeeper ha modificato gli indirizzi IP, potrebbe essere necessario riavviare tutti i nodi.
    > /opt/apigee/apigee-service/bin/apigee-service apigee-zookeeper discuss
  5. Utilizza il comando echo descritto in precedenza per verificare ciascun nodo ZooKeeper.

Informa i nodi Apigee della modifica della configurazione

  1. Su ciascun nodo 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 per includere il nuovo indirizzo IP
    • Modifica il parametro conf_zookeeper_zk1.host per includere il nuovo indirizzo IP
  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 per includere il nuovo indirizzo IP
  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 per includere il nuovo indirizzo IP
  4. Riavvia tutti i componenti della piattaforma Apigee eseguendo il comando seguente su ciascun nodo:
    /opt/apigee/apigee-service/bin/apigee-all reboot

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 parametro conf_security_ldap.server.host sul nuovo indirizzo IP.
  3. Riavvia il server di gestione:
    > /opt/apigee/apigee-service/bin/apigee-service edge-management-server reboot

Modifica dell'indirizzo IP di altri tipi di nodi Apigee

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

  1. Utilizza il seguente comando cURL per registrare il nuovo indirizzo IP interno ed esterno:
    curl -u $ADMINEMAIL:$PW -X PUT http://$MSIP:8080/v1/servers/<uuid> -d ExternalIP=<ip>
    curl -u $ADMINEMAIL:$PW http://X PUT/0.

Se non conosci l'UUID del nodo, puoi utilizzare il seguente comando per visualizzarlo:

  • Router: curl http://<router_IP>:8081/v1/servers/self
  • Processore di messaggi: curl http://<mp_IP>:8082/v1/servers/self
  • Qpid: curl http://<qp_IP>:8083/v1/servers/self
  • Postgres: curl http://<pg_IP>:8084/v1/servers/self