Reinstalla e ripristina i componenti

Questo documento illustra la reinstallazione e il ripristino di un componente Edge. Segui questa procedura se devi reinstallare il componente Edge prima di ripristinare il backup.

Apache ZooKeeper

Ripristina un nodo autonomo

1. Interrompi ZooKeeper:

   /opt/apigee/apigee-service/bin/apigee-service apigee-zookeeper stop

2. Rimuovi le directory ZooKeeper precedenti:

   /opt/apigee/data/apigee-zookeeper
   /opt/apigee/etc/apigee-zookeeper.d

3. Reinstalla ZooKeeper:

   /opt/apigee/apigee-service/bin/apigee-service apigee-zookeeper install

4. Ripristina ZooKeeper:

   /opt/apigee/apigee-service/bin/apigee-service apigee-zookeeper restore 2019.03.17,14.40.41

   Tieni presente che quando ripristini un componente, non devi specificare il percorso della directory del backup. il file "backup-" o ".tar.gz" suffisso. Devi specificare solo data/ora del nome del file di backup.

   Facoltativamente, puoi omettere il file di backup nel comando restore e Edge lo farà utilizza il file di backup più recente nella directory di backup del componente.

5. Riavvia tutti i componenti:

   /opt/apigee/apigee-service/bin/apigee-all restart

Ripristina un nodo cluster

Se si verifica un errore in un singolo nodo ZooKeeper che fa parte di un ensemble, puoi creare un nuovo nodo con lo stesso nome host/indirizzo IP e reinstalla ZooKeeper. Quando il nuovo nodo ZooKeeper unisce ZooKeeper riceverà le ultime istantanee dal leader e inizierà a servire i clienti. Non è necessario ripristinare i dati in questa istanza.

1. Reinstalla ZooKeeper:

   /opt/apigee/apigee-service/bin/apigee-service apigee-zookeeper install

2. Esegui la configurazione sul nodo ZooKeeper utilizzando lo stesso file di configurazione usato durante l'installazione del nodo originale:

   /opt/apigee/apigee-service/bin/apigee-service apigee-zookeeper setup -f configFile

3. Avvia ZooKeeper:

   /opt/apigee/apigee-service/bin/apigee-service apigee-zookeeper start

Ripristina un cluster completo

1. Arresta il cluster completo.
2. Ripristina tutti i nodi ZooKeeper dal file di backup per un singolo nodo come descritto sopra.
3. Avvia il cluster ZooKeeper.
4. Riavvia tutti i componenti.

Apache Cassandra

Ripristina un nodo autonomo

1. Interrompi Cassandra:

   /opt/apigee/apigee-service/bin/apigee-service apigee-cassandra stop

2. Rimuovi la directory Cassandra precedente:

   /opt/apigee/data/apigee-cassandra

3. Reinstalla Cassandra:

   /apigee/apigee-service/bin/apigee-service apigee-cassandra install

4. Ripristina Cassandra:

   /apigee/apigee-service/bin/apigee-service apigee-cassandra restore 2019.03.17,14.40.41

   Tieni presente che quando ripristini un componente, non devi specificare il percorso della directory del backup. il file "backup-" o ".tar.gz" suffisso. Devi specificare solo data/ora del nome del file di backup.

   Facoltativamente, puoi omettere il file di backup nel comando restore e Edge lo farà utilizza il file di backup più recente nella directory di backup del componente.

5. Riavvia tutti i componenti:
   

   /apigee/apigee-service/bin/apigee-all restart

Ripristina un nodo cluster

In caso di errore di un singolo nodo Cassandra che fa parte di un ensemble, puoi creare un nuovo nodo con lo stesso nome host/indirizzo IP. Devi solo reinstallare Cassandra e seguire alcuni passaggi aggiuntivi. Non è necessario ripristinare i dati dai backup. Le repliche disponibili in altri nodi possono essere utilizzate per ripristinare i dati sul nodo in errore. Questi passaggi sono in genere applicabili se un nodo nel tuo cluster Cassandra si arresta in modo anomalo a causa di un malfunzionamento hardware e così via.

di Gemini Advanced.

Se il nodo in cui si è verificato l'errore non è più accessibile, eliminalo e isolane la rete per assicurarti che non sia possibile eseguire di nuovo il join del cluster Cassandra. Quindi, visualizza un nuovo nodo con lo stesso indirizzo IP del nodo originale ed esegui su di esso i consueti passaggi di bootstrap di Apigee.

Se il nodo è ancora accessibile e vuoi riutilizzarlo, segui questi passaggi:

1. Arresta il processo Cassandra sul nodo:
   /opt/apigee/apigee-service/bin/apigee-service apigee-cassandra stop
2. Disinstalla il software Cassandra dal nodo:
   /opt/apigee/apigee-service/bin/apigee-service apigee-cassandra uninstall
3. Cancella la directory dei dati dal nodo:
   rm -rf /opt/apigee/data/apigee-cassandra

Dopo aver completato i passaggi precedenti, dovresti avere un nodo con lo stesso indirizzo IP del nodo in cui si è verificato l'errore ed è pronto per l'installazione del software Apigee. Procedi nel seguente modo:

1. Identificare i nodi iniziali del data center.
   1. Su qualsiasi nodo Cassandra operativo nello stesso data center del nodo in fase di ripristino, esegui questo comando:

      apigee-service apigee-cassandra configure -search conf_cassandra_seeds

   2. L'output visualizzato sarà simile al seguente:

      Found key conf_cassandra_seeds, with value, "127.0.0.1", in /opt/apigee/apigee-cassandra/token/default.properties
      Found key conf_cassandra_seeds, with value, 127.0.0.1, in /opt/apigee/apigee-cassandra/token/application/cassandra.properties
      Found key conf_cassandra_seeds, with value, "10.1.0.1,10.1.0.2", in /opt/apigee/token/application/cassandra.properties
      apigee-configutil: apigee-cassandra: # OK

   3. Fai riferimento all'ultima riga dell'output. Gli indirizzi IP separati da virgole elencati sono i nodi originali utilizzati dai nodi in questo data center.
2. Sul nuovo nodo da ripristinare, crea o modifica il seguente file:
   

   vi /opt/apigee/customer/application/cassandra.properties
   

3. Add the following line:
   

   conf_jvm_options_custom_settings=-Dcassandra.replace_address=<ip-address-of-dead-node>

4. Se questo nodo è uno dei nodi seed (l'indirizzo IP del nodo viene visualizzato nell'elenco dei nodi seed nel passaggio 1), aggiungi un'altra riga al file:
   

   conf_cassandra_seeds="<comma-separated-seed-list-except-this-node’s-ip>"

   .
   1. Ad esempio, nell'istanza precedente, l'elenco originale ha 2 IP: 10.1.0.1 & 10.1.0.2. Se il nodo da ripristinare è 10.1.0.1, aggiungi una riga come questa:
      

      conf_cassandra_seeds="10.1.0.2"

5. Salva il file e assicurati che sia di sua proprietà e leggibile dall'utente Apigee:
   

   chown apigee:apigee /opt/apigee/customer/application/cassandra.properties

6. Installa il software Cassandra:
   

   /opt/apigee/apigee-service/bin/apigee-service apigee-cassandra install

7. Esegui la configurazione di Cassandra:
   

   /opt/apigee/apigee-service/bin/apigee-service apigee-cassandra setup -f <configFile>

8. La configurazione tenterà internamente di eseguire il bootstrap del servizio Cassandra. Questa operazione potrebbe richiedere molto tempo in base alla quantità di dati presenti per lo streaming da altri nodi, alla velocità effettiva di rete e così via.
9. [Opzione avanzata] Puoi accelerare il flusso di dati eseguendo i seguenti comandi nodetool sul nodo:
   

   nodetool setstreamthroughput <value>
   nodetool setcompactionthroughput <value>

10. Una volta ripristinato il nodo Cassandra, utilizza comandi standard come quelli riportati di seguito per verificare che il nodo sia stato unito all'anello:
    

    /opt/apigee/apigee-cassandra/bin/nodetool ring
    /opt/apigee/apigee-cassandra/bin/nodetool status

11. Dopo aver verificato che il nodo sia attivo e in esecuzione, modifica nuovamente il file /opt/apigee/customer/application/cassandra.properties e rimuovi le righe aggiunte in precedenza in questa procedura nei passaggi 3 e 4.
12. Riavvia il servizio Cassandra sul nodo:
    

    /opt/apigee/apigee-service/bin/apigee-service apigee-cassandra restart

Ripristina un cluster completo

1. Arresta il cluster completo.
2. Ripristina tutti i nodi Cassandra dal file di backup.
3. Avvia il cluster Cassandra.
4. Riavvia tutti i componenti.

Database PostgreSQL

PosgreSQL in esecuzione in modalità autonoma come master

1. Arresta il server di gestione, il server Qpid e il server Postgres su tutti i nodi:

   /apigee/apigee-service/bin/apigee-service edge-management-server stop
   /opt/apigee/apigee-service/bin/apigee-service edge-qpid-server stop
   /opt/apigee/apigee-service/bin/apigee-service edge-postgres-server stop

2. Reinstalla il database PostgreSQL:

   /apigee/apigee-service/bin/apigee-service apigee-postgresql install 

3. Avvia PostgreSQL:

   /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql start

4. Ripristina il database PostgreSQL dal file di backup:

   /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql restore 2019.03.17,14.40.41

   Tieni presente che quando ripristini il componente PostgreSQL, non specifichi il percorso della directory su il file di backup né specifichi ".dump" suffisso. Devi specificare solo data/ora del nome del file di backup.

   Facoltativamente, puoi omettere il file di backup nel comando restore e Edge lo farà utilizza il file di backup più recente nella directory di backup del componente.

5. Avvia il server di gestione, il server Qpid e il server Postgres su tutti i nodi:

   /opt/apigee/apigee-service/bin/apigee-service edge-management-server start
   /opt/apigee/apigee-service/bin/apigee-service edge-qpid-server start
   /opt/apigee/apigee-service/bin/apigee-service edge-postgres-server start

PosgreSQL in esecuzione in standby

1. Reinstalla il database PostgreSQL:

   /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql install

2. Riconfigura il database PostgreSQL utilizzando lo stesso file di configurazione che hai usato per installarlo:
   

   /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql setup -f configFile

3. Avvia PostgreSQL:

   /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql start 

Server Postgres

1. Arresta il server Postgres su tutti i nodi master e in standby:

   /opt/apigee/apigee-service/bin/apigee-service edge-postgres-server stop

2. Rimuovi le directory precedenti del server Postgres:

   /opt/apigee/data/edge-postgres-server /opt/apigee/etc/edge-postgres-server.d

3. Reinstalla il server Postgres:

   /opt/apigee/apigee-service/bin/apigee-service edge-postgres-server install

4. Ripristina il server Postgres dal file di backup:

   /opt/apigee/apigee-service/bin/apigee-service edge-postgre-server restore 2019.03.17,14.40.41

   Tieni presente che quando ripristini un componente, non devi specificare il percorso della directory del backup. il file "backup-" o ".tar.gz" suffisso. Devi specificare solo data/ora del nome del file di backup.

   Facoltativamente, puoi omettere il file di backup nel comando restore e Edge lo farà utilizza il file di backup più recente nella directory di backup del componente.

5. Avvia il server Postgres su tutti i nodi master e in standby:

   /opt/apigee/apigee-service/bin/apigee-service edge-postgres-server start

Qpid Server e Qpidd

1. Arresta Qpidd, Qpid Server e Postgres su tutti i nodi:
   

   /opt/apigee/apigee-service/bin/apigee-service edge-qpid-server stop
   /opt/apigee/apigee-service/bin/apigee-service edge-postgres-server stop
   /opt/apigee/apigee-service/bin/apigee-service apigee-qpidd stop

2. Rimuovi le directory Qpid e Qpidd precedenti:

   /opt/apigee/data/edge-qpid-server
   /opt/apigee/etc/edge-qpid-server.d
   /opt/apigee/data/apigee-qpidd
   /opt/apigee/etc/apigee-qpidd.d 

3. Reinstalla Qpidd:

   /opt/apigee/apigee-service/bin/apigee-service apigee-qpidd install 

4. Ripristina Qpidd:

   /opt/apigee/apigee-service/bin/apigee-service apigee-qpidd restore 2019.03.17,14.40.41

   Tieni presente che quando ripristini un componente, non devi specificare il percorso della directory del backup. il file "backup-" o ".tar.gz" suffisso. Devi specificare solo data/ora del nome del file di backup.

   Facoltativamente, puoi omettere il file di backup nel comando restore e Edge lo farà utilizza il file di backup più recente nella directory di backup del componente.

5. Avvia Qpidd:

   /opt/apigee/apigee-service/bin/apigee-service apigee-qpidd start 

6. Reinstalla il server Qpid:

   /opt/apigee/apigee-service/bin/apigee-service edge-qpid-server install

7. Ripristina server Qpid:

   /opt/apigee/apigee-service/bin/apigee-service edge-qpid-server restore 2019.03.17,14.40.41

   Tieni presente che quando ripristini un componente, non devi specificare il percorso della directory del backup. il file "backup-" o ".tar.gz" suffisso. Devi specificare solo data/ora del nome del file di backup.

   Facoltativamente, puoi omettere il file di backup nel comando restore e Edge lo farà utilizza il file di backup più recente nella directory di backup del componente.

8. Riavvia i server Qpid, Qpidd e Postgres su tutti i nodi:

   /opt/apigee/apigee-service/bin/apigee-service apigee-qpidd restart
   /opt/apigee/apigee-service/bin/apigee-service edge-qpid-server restart
   /opt/apigee/apigee-service/bin/apigee-service edge-postgres-server restart

OpenLDAP

1. Interrompi OpenLDAP:

   /opt/apigee/apigee-service/bin/apigee-service apigee-openldap stop

2. Reinstalla OpenLDAP:

   /opt/apigee/apigee-service/bin/apigee-service apigee-openldap install

3. Rimuovi le directory OpenLDAP precedenti:

   /opt/apigee/data/apigee-openldap /opt/apigee/etc/apigee-openldap.d

4. Ripristina OpenLDAP:

   /opt/apigee/apigee-service/bin/apigee-service apigee-openldap restore 2019.03.17,14.40.41

   Tieni presente che quando ripristini un componente, non devi specificare il percorso della directory del backup. il file "backup-" o ".tar.gz" suffisso. Devi specificare solo data/ora del nome del file di backup.

   Facoltativamente, puoi omettere il file di backup nel comando restore e Edge lo farà utilizza il file di backup più recente nella directory di backup del componente.

5. Riavvia OpenLDAP:

   /opt/apigee/apigee-service/bin/apigee-service apigee-openldap start

6. Riavvia tutti i server di gestione:

   /opt/apigee/apigee-service/bin/apigee-service edge-management-server restart

Server di gestione

1. Arresta server di gestione:

   /opt/apigee/apigee-service/bin/apigee-service edge-management-server stop

2. Rimuovi le directory del server di gestione precedenti:

   /opt/apigee/data/edge-management-server /opt/apigee/etc/edge-management-server.d

3. Reinstalla il server di gestione:

   /opt/apigee/apigee-service/bin/apigee-service edge-management-server install

4. Ripristina il server di gestione dal file di backup:

   /opt/apigee/apigee-service/bin/apigee-service edge-management-server restore 2019.03.17,14.40.41

   Tieni presente che quando ripristini un componente, non devi specificare il percorso della directory del backup. il file "backup-" o ".tar.gz" suffisso. Devi specificare solo data/ora del nome del file di backup.

   Facoltativamente, puoi omettere il file di backup nel comando restore e Edge lo farà utilizza il file di backup più recente nella directory di backup del componente.

5. Riavvia il server di gestione:

   /opt/apigee/apigee-service/bin/apigee-service edge-management-server start

processore di messaggi

1. Arresta processore di messaggi:

   /opt/apigee/apigee-service/bin/apigee-service edge-message-processor stop

2. Rimuovi le directory del processore di messaggi precedenti:

   /opt/apigee/data/edge-message-processor
   /opt/apigee/etc/edge-message-processor.d

3. Reinstalla il processore di messaggi:

   /opt/apigee/apigee-service/bin/apigee-service edge-message-processor install

4. Ripristina il processore di messaggi dal file di backup:

   /opt/apigee/apigee-service/bin/apigee-service edge-message-processor restore 2019.03.17,14.40.41

   Tieni presente che quando ripristini un componente, non devi specificare il percorso della directory del backup. il file "backup-" o ".tar.gz" suffisso. Devi specificare solo data/ora del nome del file di backup.

   Facoltativamente, puoi omettere il file di backup nel comando restore e Edge lo farà utilizza il file di backup più recente nella directory di backup del componente.

5. Riavvia processore di messaggi:

   /opt/apigee/apigee-service/bin/apigee-service edge-message-processor start

Router

1. Arresta router:

   /opt/apigee/apigee-service/bin/apigee-service edge-router stop

2. Rimuovi le directory del router precedenti:

   /opt/apigee/data/edge-router
   /opt/apigee/etc/edge-router.d

3. Reinstalla il router:
   

   /opt/apigee/apigee-service/bin/apigee-service edge-router install

4. Ripristina il router dal file di backup:

   /opt/apigee/apigee-service/bin/apigee-service edge-router restore 2019.03.17,14.40.41

   Tieni presente che quando ripristini un componente, non devi specificare il percorso della directory del backup. il file "backup-" o ".tar.gz" suffisso. Devi specificare solo data/ora del nome del file di backup.

   Facoltativamente, puoi omettere il file di backup nel comando restore e Edge lo farà utilizza il file di backup più recente nella directory di backup del componente.

5. Riavvia il router:
   

   /opt/apigee/apigee-service/bin/apigee-service edge-router start

UI Edge

1. Interrompi UI:

   /opt/apigee/apigee-service/bin/apigee-service edge-ui stop

2. Rimuovi le directory della UI precedenti:

   /opt/apigee/data/edge-ui
   /opt/apigee/etc/edge-ui.d

3. Reinstalla l'interfaccia utente:
   

   /opt/apigee/apigee-service/bin/apigee-service edge-ui install

4. Ripristina l'interfaccia utente dal file di backup:

   /opt/apigee/apigee-service/bin/apigee-service edge-ui restore 2019.03.17,14.40.41

   Tieni presente che quando ripristini un componente, non devi specificare il percorso della directory del backup. il file "backup-" o ".tar.gz" suffisso. Devi specificare solo data/ora del nome del file di backup.

   Facoltativamente, puoi omettere il file di backup nel comando restore e Edge lo farà utilizza il file di backup più recente nella directory di backup del componente.

5. Riavvia UI:
   

   /opt/apigee/apigee-service/bin/apigee-service edge-ui start

Recupero completo del sito

1. Arresta tutti i nodi dei componenti. Tieni presente che l'ordine di arresto dei sottosistemi è importante: arresta tutti i nodi perimetrali e quindi arresta tutti i nodi dei datastore.
2. Ripristina tutti i componenti come descritto sopra.
3. Ora avvia tutti i componenti nel seguente ordine. Tieni presente che l'ordine di inizio sottosistemi è importante:
   1. Avvia il cluster ZooKeeper
   2. Avvia il cluster Cassandra
   3. Assicurati che OpenLDAP sia attivo e in esecuzione
   4. Avvia qpid
   5. Assicurati che il database PostgreSQL sia attivo e in esecuzione
   6. Avvia server di gestione
   7. Avvia router e processori di messaggi
   8. Avvia server Qpid
   9. Avvia server Postgres
   10. Avvia UI Apigee