Questo documento descrive 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
Ripristina un nodo autonomo
- Arresta ZooKeeper:
/opt/apigee/apigee-service/bin/apigee-service apigee-zookeeper stop
- Rimuovi le vecchie directory ZooKeeper:
/opt/apigee/data/apigee-zookeeper /opt/apigee/etc/apigee-zookeeper.d
- Reinstalla ZooKeeper:
/opt/apigee/apigee-service/bin/apigee-service apigee-zookeeper install
- 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 specifichi il percorso della directory del file di backup, né il prefisso "backup-" o il suffisso ".tar.gz". Specifichi solo la parte di data/ora del nome del file di backup.
Se vuoi, puoi omettere il file di backup nel comando
restoreed Edge utilizzerà il file di backup più recente nella directory di backup del componente. - 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.
- Reinstalla ZooKeeper:
/opt/apigee/apigee-service/bin/apigee-service apigee-zookeeper install
- 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
- Avvia ZooKeeper:
/opt/apigee/apigee-service/bin/apigee-service apigee-zookeeper start
Ripristinare un cluster completo
- Arresta l'intero cluster.
- Ripristina tutti i nodi ZooKeeper dal file di backup come descritto sopra per un singolo nodo.
- Avvia il cluster ZooKeeper.
- Riavvia tutti i componenti.
Apache Cassandra
Ripristina un nodo autonomo
- Arresta Cassandra:
/opt/apigee/apigee-service/bin/apigee-service apigee-cassandra stop
- Rimuovi la vecchia directory Cassandra:
/opt/apigee/data/apigee-cassandra
- Reinstalla Cassandra:
/apigee/apigee-service/bin/apigee-service apigee-cassandra install
- 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 specifichi il percorso della directory del file di backup, né il prefisso "backup-" o il suffisso ".tar.gz". Devi specificare solo la parte relativa alla data/ora del nome del file di backup.
Se vuoi, puoi omettere il file di backup nel comando
restoreed Edge utilizzerà il file di backup più recente nella directory di backup del componente. - 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 dell'hardware e così via.
Se il nodo che ha avuto un errore non è più accessibile, distruggilo e isola la sua rete per assicurarti che non possa rientrare accidentalmente nel 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:
- Arresta il processo Cassandra sul nodo:
/opt/apigee/apigee-service/bin/apigee-service apigee-cassandra stop - Disinstalla il software Cassandra dal nodo:
/opt/apigee/apigee-service/bin/apigee-service apigee-cassandra uninstall - 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 che ha avuto un errore e che è pronto per l'installazione del software Apigee. Segui questi passaggi:
- Identifica i nodi seed del data center.
-
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
-
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
- 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.
-
Su qualsiasi nodo Cassandra operativo nello stesso data center del nodo da ripristinare, esegui il seguente comando:
- Sul nuovo nodo in fase di ripristino, crea o modifica il seguente file:
vi /opt/apigee/customer/application/cassandra.properties
- Add the following line:
conf_jvm_options_custom_settings=-Dcassandra.replace_address=<ip-address-of-dead-node>
- 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>"
- Ad esempio, nell'istanza riportata sopra, l'elenco di origine 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"
- Ad esempio, nell'istanza riportata sopra, l'elenco di origine 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:
- 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
- Installa il software Cassandra:
/opt/apigee/apigee-service/bin/apigee-service apigee-cassandra install
- Esegui la configurazione di Cassandra:
/opt/apigee/apigee-service/bin/apigee-service apigee-cassandra setup -f <configFile>
- La configurazione tenterà internamente di eseguire il bootstrap del servizio Cassandra. Questa operazione potrebbe richiedere molto tempo a seconda della quantità di dati da trasmettere in streaming da altri nodi, della velocità effettiva di rete e così via.
- [Opzione avanzata] Puoi accelerare lo streaming dei dati eseguendo i seguenti comandi nodetool sul nodo:
nodetool setstreamthroughput <value> nodetool setcompactionthroughput <value>
- Una volta ripristinato 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
- Una volta verificato che il nodo è in esecuzione, modifica di nuovo il file
/opt/apigee/customer/application/cassandra.propertiese rimuovi le righe che hai aggiunto in precedenza in questa procedura nei passaggi 3 e 4. - Riavvia il servizio Cassandra sul nodo:
/opt/apigee/apigee-service/bin/apigee-service apigee-cassandra restart
Ripristinare un cluster completo
- Arresta l'intero cluster.
- Ripristina tutti i nodi Cassandra dal file di backup.
- Avvia il cluster Cassandra.
- Riavvia tutti i componenti.
Database PostgreSQL
PostgreSQL in esecuzione in modalità autonoma o come master
- 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 - Reinstalla il database PostgreSQL:
/apigee/apigee-service/bin/apigee-service apigee-postgresql install
- Avvia PostgreSQL:
/opt/apigee/apigee-service/bin/apigee-service apigee-postgresql start
- 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 del file di backup, né il suffisso ".dump". Devi specificare solo la parte relativa alla data/ora del nome del file di backup.
Se vuoi, puoi omettere il file di backup nel comando
restoreed Edge utilizzerà il file di backup più recente nella directory di backup del componente. - 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
- Reinstalla il database PostgreSQL:
/opt/apigee/apigee-service/bin/apigee-service apigee-postgresql install
- Riconfigura il database PostgreSQL utilizzando lo stesso file di configurazione utilizzato per l'installazione:
/opt/apigee/apigee-service/bin/apigee-service apigee-postgresql setup -f configFile
- Avvia PostgreSQL:
/opt/apigee/apigee-service/bin/apigee-service apigee-postgresql start
Server Postgres
- Arresta il server Postgres su tutti i nodi master e standby:
/opt/apigee/apigee-service/bin/apigee-service edge-postgres-server stop
- Rimuovi le vecchie directory del server Postgres:
/opt/apigee/data/edge-postgres-server /opt/apigee/etc/edge-postgres-server.d
- Reinstalla il server Postgres:
/opt/apigee/apigee-service/bin/apigee-service edge-postgres-server install
- 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". Devi specificare solo la parte relativa alla data/ora del nome del file di backup.
Puoi facoltativamente omettere il file di backup nel comando
restoree Edge utilizzerà il file di backup più recente nella directory di backup del componente. - Avvia il server Postgres su tutti i nodi master e di standby:
/opt/apigee/apigee-service/bin/apigee-service edge-postgres-server start
Server Qpid e Qpidd
- Arresta Qpidd, il server Qpid e il server 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 - 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
- Reinstalla Qpidd:
/opt/apigee/apigee-service/bin/apigee-service apigee-qpidd install
- 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 specifichi il percorso della directory del file di backup, né il prefisso "backup-" o il suffisso ".tar.gz". Devi specificare solo la parte relativa alla data/ora del nome del file di backup.
Se vuoi, puoi omettere il file di backup nel comando
restoreed Edge utilizzerà il file di backup più recente nella directory di backup del componente. - Avvia Qpidd:
/opt/apigee/apigee-service/bin/apigee-service apigee-qpidd start
- Reinstalla il server Qpid:
/opt/apigee/apigee-service/bin/apigee-service edge-qpid-server install
- 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 né il prefisso "backup-" o il suffisso ".tar.gz". Devi specificare solo la parte relativa alla data/ora del nome del file di backup.
Puoi facoltativamente omettere il file di backup nel comando
restoree Edge utilizzerà il file di backup più recente nella directory di backup del componente. - 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
- Interrompi SymasLDAP:
/opt/apigee/apigee-service/bin/apigee-service apigee-openldap stop
- Reinstalla SymasLDAP:
/opt/apigee/apigee-service/bin/apigee-service apigee-openldap install
- Rimuovi le vecchie directory SymasLDAP:
/opt/apigee/data/apigee-openldap /opt/apigee/etc/apigee-openldap.d
- 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 specifichi il percorso della directory del file di backup, né il prefisso "backup-" o il suffisso ".tar.gz". Specifichi solo la parte di data/ora del nome del file di backup.
Se vuoi, puoi omettere il file di backup nel comando
restoreed Edge utilizzerà il file di backup più recente nella directory di backup del componente. - Riavvia SymasLDAP:
/opt/apigee/apigee-service/bin/apigee-service apigee-openldap start
- Riavvia tutti i server di gestione:
/opt/apigee/apigee-service/bin/apigee-service edge-management-server restart
Server di gestione
- Arresta il server di gestione:
/opt/apigee/apigee-service/bin/apigee-service edge-management-server stop
- Rimuovi le vecchie directory del server di gestione:
/opt/apigee/data/edge-management-server /opt/apigee/etc/edge-management-server.d
- Reinstalla il server di gestione:
/opt/apigee/apigee-service/bin/apigee-service edge-management-server install
- 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 specifichi il percorso della directory del file di backup, né il prefisso "backup-" o il suffisso ".tar.gz". Specifichi solo la parte di data/ora del nome del file di backup.
Puoi facoltativamente omettere il file di backup nel comando
restoree Edge utilizzerà il file di backup più recente nella directory di backup del componente. - Riavvia il server di gestione:
/opt/apigee/apigee-service/bin/apigee-service edge-management-server start
processore di messaggi
- Stop Message Processor:
/opt/apigee/apigee-service/bin/apigee-service edge-message-processor stop
- Rimuovi le vecchie directory del processore di messaggi:
/opt/apigee/data/edge-message-processor /opt/apigee/etc/edge-message-processor.d
- Reinstalla processore di messaggi:
/opt/apigee/apigee-service/bin/apigee-service edge-message-processor install
- 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 specifichi il percorso della directory del file di backup, né il prefisso "backup-" o il suffisso ".tar.gz". Devi specificare solo la parte relativa alla data/ora del nome del file di backup.
Se vuoi, puoi omettere il file di backup nel comando
restoreed Edge utilizzerà il file di backup più recente nella directory di backup del componente. - Riavvia il processore di messaggi:
/opt/apigee/apigee-service/bin/apigee-service edge-message-processor start
Router
- Stop Router:
/opt/apigee/apigee-service/bin/apigee-service edge-router stop
- Rimuovi le vecchie directory del router:
/opt/apigee/data/edge-router /opt/apigee/etc/edge-router.d
- Reinstalla il router:
/opt/apigee/apigee-service/bin/apigee-service edge-router install
- 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 specifichi il percorso della directory del file di backup, né il prefisso "backup-" o il suffisso ".tar.gz". Specifichi solo la parte di data/ora del nome del file di backup.
Puoi facoltativamente omettere il file di backup nel comando
restoree Edge utilizzerà il file di backup più recente nella directory di backup del componente. - Riavvia il router:
/opt/apigee/apigee-service/bin/apigee-service edge-router start
Nuova UI di Edge
- Arresta la nuova UI Edge:
/opt/apigee/apigee-service/bin/apigee-service edge-management-ui stop
- Rimuovi le vecchie directory dell'interfaccia utente di New Edge:
/opt/apigee/data/edge-management-ui /opt/apigee/etc/edge-management-ui.d
- Reinstalla la nuova UI di Edge:
/opt/apigee/apigee-service/bin/apigee-service edge-management-ui install
/opt/apigee/apigee-service/bin/apigee-service edge-management-ui-static install - Ripristina la nuova UI di Edge dal file di backup:
/opt/apigee/apigee-service/bin/apigee-service edge-management-ui restore 2019.03.17,14.40.41
Tieni presente che, quando ripristini un componente, non specifichi il percorso della directory del file di backup, né il prefisso "backup-" o il suffisso ".tar.gz". Devi specificare solo la parte relativa alla data/ora del nome del file di backup.
Se vuoi, puoi omettere il file di backup nel comando
restoreed Edge utilizzerà il file di backup più recente nella directory di backup del componente. - Riavvia la nuova UI di Edge:
/opt/apigee/apigee-service/bin/apigee-service edge-management-ui start
Ripristino completo del sito
- Arresta tutti i nodi dei componenti. Tieni presente che l'ordine di arresto dei sottosistemi è importante: prima arresta tutti i nodi Edge, quindi arresta tutti i nodi dei datastore.
- Ripristina tutti i componenti come descritto sopra.
- Ora avvia tutti i componenti nel seguente ordine. Tieni presente che l'ordine di avvio dei sottosistemi è importante:
- Avvia il cluster ZooKeeper
- Avvia il cluster Cassandra
- Assicurati che SymasLDAP sia attivo e in esecuzione
- Avvia qpid
- Assicurati che il database PostgreSQL sia attivo e in esecuzione
- Avvia il server di gestione
- Avvia i router e i processori di messaggi
- Avvia server Qpid
- Avvia il server Postgres
- Avvia la nuova UI di Edge