Reinstalla e ripristina i componenti

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

Apache ZooKeeper

Ripristinare un nodo autonomo

1. Interrompi ZooKeeper:

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

2. Rimuovi le vecchie directory ZooKeeper:

   /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 né il prefisso "backup-" o il suffisso ".tar.gz". Specifica solo la parte di data/ora del nome del file di backup.

   Se vuoi, puoi omettere il file di backup nel comando restore e Edge utilizzerà 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 del cluster

Se un singolo nodo ZooKeeper che fa parte di un ensemble non funziona, puoi creare un nuovo nodo con lo stesso nome host/indirizzo IP e reinstallare ZooKeeper. Quando il nuovo nodo ZooKeeper si unisce all'insieme ZooKeeper, riceve gli snapshot più recenti dal leader e inizia a servire i client. 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 utilizzato 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

Ripristinare un cluster completo

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

Apache Cassandra

Ripristinare un nodo autonomo

1. Arresta Cassandra:

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

2. Rimuovi la vecchia directory Cassandra:

   /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 né il prefisso "backup-" o il suffisso ".tar.gz". Specifica solo la parte di data/ora del nome del file di backup.

   Se vuoi, puoi omettere il file di backup nel comando restore e Edge utilizzerà 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 del cluster

Se un singolo nodo Cassandra che fa parte di un ensemble non funziona, 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 non riuscito. Questi passaggi sono in genere applicabili se un nodo del cluster Cassandra si arresta in modo anomalo a causa di un malfunzionamento hardware e così via.

Se il nodo non è più accessibile, distruggilo e isola la sua rete per assicurarti che non possa ricongiungersi accidentalmente al cluster Cassandra. Quindi, crea un nuovo nodo con lo stesso indirizzo IP del nodo originale ed esegui i normali 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. Elimina 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 non riuscito e pronto per l'installazione del software Apigee. Segui questi passaggi:

1. Identifica i nodi seed del data center.
   1. Su qualsiasi nodo Cassandra operativo nello stesso data center del nodo da ripristinare, esegui il seguente comando:

      apigee-service apigee-cassandra configure -search conf_cassandra_seeds

   2. L'output 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 seed utilizzati dai nodi in questo data center.
2. Sul nuovo nodo in fase di ripristino, 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 del passaggio 1), aggiungi un'altra riga nel file:
   

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

   1. Ad esempio, nell'istanza riportata sopra, l'elenco seed contiene due indirizzi IP: 10.1.0.1 e 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 proprietà dell'utente Apigee e che possa essere letto:
   

   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. Il programma di installazione tenterà internamente di eseguire il bootstrap del servizio Cassandra. Questa operazione potrebbe richiedere molto tempo in base alla quantità di dati da trasmettere in streaming da altri nodi, alla velocità effettiva di rete e così via.
9. [Opzione avanzata] Puoi accelerare lo streaming dei dati eseguendo i seguenti comandi nodetool sul nodo:
   

   nodetool setstreamthroughput <value>
   nodetool setcompactionthroughput <value>

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

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

11. Una volta verificato che il nodo è in esecuzione, modifica di nuovo il file /opt/apigee/customer/application/cassandra.properties e rimuovi le righe che hai aggiunto 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

Ripristinare un cluster completo

1. Interrompi l'intero cluster.
2. Ripristina tutti i nodi Cassandra dal file di backup.
3. Avvia il cluster Cassandra.
4. Riavvia tutti i componenti.

Database PostgreSQL

PostgreSQL in esecuzione standalone o 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 durante il ripristino del componente PostgreSQL non devi specificare il percorso della directory al file di backup né il suffisso ".dump". Specifica solo la parte di data/ora del nome del file di backup.

   Se vuoi, puoi omettere il file di backup nel comando restore e Edge utilizzerà 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

PostgreSQL in esecuzione come 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 utilizzato 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 di standby:

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

2. Rimuovi le vecchie directory del server Postgres:

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

3. Reinstalla Postgres Server:

   /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 né il prefisso "backup-" o il suffisso ".tar.gz". Specifica solo la parte di data/ora del nome del file di backup.

   Se vuoi, puoi omettere il file di backup nel comando restore e Edge utilizzerà il file di backup più recente nella directory di backup del componente.

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

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

Qpid Server e Qpidd

1. Arresta Qpidd, Qpid Server e Postgres Server 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 vecchie directory Qpid Server e Qpidd:

   /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. Ripristinare 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 né il prefisso "backup-" o il suffisso ".tar.gz". Specifica solo la parte di data/ora del nome del file di backup.

   Se vuoi, puoi omettere il file di backup nel comando restore e Edge utilizzerà 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 il 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 né il prefisso "backup-" o il suffisso ".tar.gz". Specifica solo la parte di data/ora del nome del file di backup.

   Se vuoi, puoi omettere il file di backup nel comando restore e Edge utilizzerà 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

SymasLDAP

1. Interrompi SymasLDAP:

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

2. Reinstalla SymasLDAP:

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

3. Rimuovi le vecchie directory SymasLDAP:

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

4. Ripristina SymasLDAP:

   /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 né il prefisso "backup-" o il suffisso ".tar.gz". Specifica solo la parte di data/ora del nome del file di backup.

   Se vuoi, puoi omettere il file di backup nel comando restore e Edge utilizzerà il file di backup più recente nella directory di backup del componente.

5. Riavvia SymasLDAP:

   /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 il server di gestione:

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

2. Rimuovi le vecchie directory del server di gestione:

   /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 Management Server 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 né il prefisso "backup-" o il suffisso ".tar.gz". Specifica solo la parte di data/ora del nome del file di backup.

   Se vuoi, puoi omettere il file di backup nel comando restore e Edge utilizzerà 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. Interrompi il processore di messaggi:

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

2. Rimuovi le vecchie directory di Message Processor:

   /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 Message Processor 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 né il prefisso "backup-" o il suffisso ".tar.gz". Specifica solo la parte di data/ora del nome del file di backup.

   Se vuoi, puoi omettere il file di backup nel comando restore e Edge utilizzerà il file di backup più recente nella directory di backup del componente.

5. Riavvia il processore di messaggi:

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

Router

1. Stop Router:

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

2. Rimuovi le vecchie directory del router:

   /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 né il prefisso "backup-" o il suffisso ".tar.gz". Specifica solo la parte di data/ora del nome del file di backup.

   Se vuoi, puoi omettere il file di backup nel comando restore e Edge utilizzerà il file di backup più recente nella directory di backup del componente.

5. Riavvia router:
   

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

UI Edge

1. Arresta UI:

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

2. Rimuovi le vecchie directory dell'interfaccia utente:

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

3. Reinstalla UI:
   

   /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 né il prefisso "backup-" o il suffisso ".tar.gz". Specifica solo la parte di data/ora del nome del file di backup.

   Se vuoi, puoi omettere il file di backup nel comando restore e Edge utilizzerà il file di backup più recente nella directory di backup del componente.

5. Riavvia l'interfaccia utente:
   

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

Ripristino completo del sito

1. Arresta tutti i nodi dei componenti. Tieni presente che l'ordine di arresto dei sottosistemi è importante: prima arresta tutti i nodi Edge e poi 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 avvio dei sottosistemi è importante:
   1. Avvia il cluster ZooKeeper
   2. Avvia il cluster Cassandra
   3. Assicurati che SymasLDAP sia in esecuzione
   4. Start qpid
   5. Assicurati che il database PostgreSQL sia attivo e in esecuzione
   6. Avvia server di gestione
   7. Avviare i router e i processori di messaggi
   8. Avvia server Qpid
   9. Avvia server Postgres
   10. Avvia l'interfaccia utente di Apigee