Menginstal ulang dan memulihkan komponen

Dokumen ini mencakup penginstalan ulang dan pemulihan komponen Edge. Gunakan prosedur ini jika Anda harus menginstal ulang komponen Edge sebelum memulihkan cadangan.

Apache ZooKeeper

Memulihkan satu node mandiri

1. Menghentikan ZooKeeper:

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

2. Hapus direktori ZooKeeper lama:

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

3. Instal ulang ZooKeeper:

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

4. Pulihkan ZooKeeper:

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

   Perhatikan bahwa saat memulihkan komponen, Anda tidak menentukan jalur direktori ke cadangan file, atau tidak menentukan "backup-" atau ".tar.gz" akhiran. Anda hanya menentukan tanggal/waktu dari nama file cadangan.

   Secara opsional, Anda dapat menghilangkan file cadangan dalam perintah restore dan Edge akan gunakan file cadangan terbaru di direktori cadangan komponen.

5. Mulai ulang semua komponen:

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

Pulihkan satu node cluster

Jika satu simpul ZooKeeper gagal yang merupakan bagian dari suatu ensemble, Anda dapat membuat {i>node<i} baru dengan nama {i>host<i}/alamat IP yang sama dan menginstal ulang ZooKeeper. Ketika node ZooKeeper baru bergabung dengan ZooKeeper akan mendapatkan snapshot terbaru dari Leader dan mulai melayani klien. Anda tidak perlu memulihkan data dalam instance ini.

1. Instal ulang ZooKeeper:

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

2. Jalankan pengaturan pada node ZooKeeper menggunakan file konfigurasi yang sama dengan node asli:

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

3. Mulai ZooKeeper:

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

Memulihkan cluster lengkap

1. Hentikan cluster lengkap.
2. Pulihkan semua node ZooKeeper dari file cadangan seperti yang dijelaskan di atas untuk satu node.
3. Mulai cluster ZooKeeper.
4. Mulai ulang semua komponen.

Apache Cassandra

Memulihkan satu node mandiri

1. Hentikan Cassandra:

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

2. Hapus direktori Cassandra lama:

   /opt/apigee/data/apigee-cassandra

3. Instal ulang Cassandra:

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

4. Pulihkan Cassandra:

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

   Perhatikan bahwa saat memulihkan komponen, Anda tidak menentukan jalur direktori ke cadangan file, atau tidak menentukan "backup-" atau ".tar.gz" akhiran. Anda hanya menentukan tanggal/waktu dari nama file cadangan.

   Secara opsional, Anda dapat menghilangkan file cadangan dalam perintah restore dan Edge akan gunakan file cadangan terbaru di direktori cadangan komponen.

5. Mulai ulang semua komponen:
   

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

Pulihkan satu node cluster

Jika satu node Cassandra yang merupakan bagian dari suatu ansambel gagal, Anda dapat membuat node baru dengan nama host/alamat IP yang sama. Anda hanya perlu menginstal ulang Cassandra dan mengikuti beberapa langkah tambahan. Anda tidak perlu memulihkan data dari cadangan. Replika yang tersedia di node lain dapat digunakan untuk memulihkan data pada node yang gagal. Langkah-langkah ini biasanya berlaku jika node di cluster Cassandra Anda mengalami error karena malfungsi hardware, dll.

Jika node yang gagal tidak dapat diakses lagi, hancurkan node tersebut dan isolasi jaringannya untuk memastikan node tersebut tidak dapat bergabung kembali ke cluster Cassandra secara tidak sengaja. Kemudian, munculkan node baru dengan alamat IP yang sama dengan node asli dan jalankan langkah-langkah bootstrap Apigee yang biasa.

Jika node masih dapat diakses dan Anda ingin menggunakannya kembali, lakukan langkah-langkah berikut:

1. Hentikan proses Cassandra di node:
   /opt/apigee/apigee-service/bin/apigee-service apigee-cassandra stop
2. Uninstal software Cassandra dari node:
   /opt/apigee/apigee-service/bin/apigee-service apigee-cassandra uninstall
3. Hapus total direktori data dari node:
   rm -rf /opt/apigee/data/apigee-cassandra

Setelah menyelesaikan langkah-langkah di atas, Anda akan memiliki node dengan alamat IP yang sama dengan node yang gagal dan siap untuk penginstalan software Apigee. Lakukan langkah-langkah berikut:

1. Identifikasi node inti dari pusat data.
   1. Pada node Cassandra yang beroperasi di pusat data yang sama dengan node yang dipulihkan, jalankan perintah berikut:

      apigee-service apigee-cassandra configure -search conf_cassandra_seeds

   2. Outputnya akan terlihat seperti ini:

      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. Lihat baris terakhir pada output. Alamat IP yang dipisahkan koma yang tercantum adalah node awal yang digunakan oleh node di pusat data ini.
2. Pada node baru yang dipulihkan, buat atau edit file berikut:
   

   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. Jika node ini adalah salah satu node seed (alamat IP Node muncul di daftar node seed dari langkah 1), tambahkan baris lain di file:
   

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

   1. Misalnya, dalam contoh di atas, daftar inti memiliki 2 IP - 10.1.0.1 & 10.1.0.2. Jika node yang dipulihkan adalah 10.1.0.1, tambahkan baris seperti ini:
      

      conf_cassandra_seeds="10.1.0.2"

5. Simpan file dan pastikan file tersebut dimiliki & dapat dibaca oleh pengguna Apigee:
   

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

6. Instal software Cassandra:
   

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

7. Jalankan penyiapan Cassandra:
   

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

8. Penyiapan akan mencoba mem-bootstrap layanan Cassandra secara internal. Proses ini mungkin memerlukan waktu lama berdasarkan seberapa banyak data yang ada untuk di-streaming dari node lain, throughput jaringan Anda, dll.
9. [Opsi lanjutan] Anda dapat mempercepat streaming data dengan menjalankan perintah nodetool berikut pada node:
   

   nodetool setstreamthroughput <value>
   nodetool setcompactionthroughput <value>

10. Setelah node Cassandra muncul kembali, gunakan perintah standar seperti di bawah ini untuk memverifikasi bahwa node telah berhasil bergabung ke cincin:
    

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

11. Setelah memvalidasi bahwa node berhasil aktif dan berjalan, edit lagi file /opt/apigee/customer/application/cassandra.properties dan hapus baris yang Anda tambahkan sebelumnya dalam prosedur ini pada langkah 3 dan 4.
12. Mulai ulang layanan Cassandra pada node:
    

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

Memulihkan cluster lengkap

1. Hentikan cluster lengkap.
2. Pulihkan semua node Cassandra dari file cadangan.
3. Mulai gugus Cassandra.
4. Mulai ulang semua komponen.

Database PostgreSQL

PostgreSQL yang berjalan {i>standalone<i} atau sebagai Master

1. Hentikan Server Pengelolaan, Server Qpid, dan Server Postgres di semua node:

   /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. Instal ulang database PostgreSQL:

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

3. Mulai PostgreSQL:

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

4. Pulihkan database PostgreSQL dari file cadangan:

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

   Perhatikan bahwa ketika memulihkan komponen PostgreSQL, Anda tidak menentukan jalur direktori ke file cadangan, juga tidak menentukan ".dump" akhiran. Anda hanya menentukan tanggal/waktu dari nama file cadangan.

   Secara opsional, Anda dapat menghilangkan file cadangan dalam perintah restore dan Edge akan gunakan file cadangan terbaru di direktori cadangan komponen.

5. Mulai Server Pengelolaan, Server Qpid, dan Server Postgres di semua node:

   /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 berjalan sebagai Standby

1. Instal ulang database PostgreSQL:

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

2. Konfigurasi ulang database PostgreSQL menggunakan file konfigurasi yang sama dengan yang Anda gunakan untuk menginstalnya:
   

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

3. Mulai PostgreSQL:

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

Server Postgres

1. Hentikan Server Postgres di semua node master dan standby:

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

2. Hapus direktori Server Postgres lama:

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

3. Instal ulang Postgres Server:

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

4. Pulihkan Server Postgres dari file cadangan:

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

   Perhatikan bahwa saat memulihkan komponen, Anda tidak menentukan jalur direktori ke cadangan file, atau tidak menentukan "backup-" atau ".tar.gz" akhiran. Anda hanya menentukan tanggal/waktu dari nama file cadangan.

   Secara opsional, Anda dapat menghilangkan file cadangan dalam perintah restore dan Edge akan gunakan file cadangan terbaru di direktori cadangan komponen.

5. Mulai Server Postgres di semua node master dan standby:

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

Server Qpid dan Qpidd

1. Hentikan Qpidd, Qpid Server, dan Postgres Server di semua node:
   

   /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. Hapus direktori Qpid Server dan Qpidd lama:

   /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. Instal ulang Qpidd:

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

4. Pulihkan Qpidd:

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

   Perhatikan bahwa saat memulihkan komponen, Anda tidak menentukan jalur direktori ke cadangan file, atau tidak menentukan "backup-" atau ".tar.gz" akhiran. Anda hanya menentukan tanggal/waktu dari nama file cadangan.

   Secara opsional, Anda dapat menghilangkan file cadangan dalam perintah restore dan Edge akan gunakan file cadangan terbaru di direktori cadangan komponen.

5. Mulai Qpidd:

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

6. Instal ulang Server Qpid:

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

7. Memulihkan Server Qpid:

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

   Perhatikan bahwa saat memulihkan komponen, Anda tidak menentukan jalur direktori ke cadangan file, atau tidak menentukan "backup-" atau ".tar.gz" akhiran. Anda hanya menentukan tanggal/waktu dari nama file cadangan.

   Secara opsional, Anda dapat menghilangkan file cadangan dalam perintah restore dan Edge akan gunakan file cadangan terbaru di direktori cadangan komponen.

8. Mulai ulang Server Qpid, Qpidd, dan Postgres pada semua node:

   /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. Hentikan OpenLDAP:

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

2. Instal ulang OpenLDAP:

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

3. Hapus direktori OpenLDAP lama:

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

4. Pulihkan OpenLDAP:

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

   Perhatikan bahwa saat memulihkan komponen, Anda tidak menentukan jalur direktori ke cadangan file, atau tidak menentukan "backup-" atau ".tar.gz" akhiran. Anda hanya menentukan tanggal/waktu dari nama file cadangan.

   Secara opsional, Anda dapat menghilangkan file cadangan dalam perintah restore dan Edge akan gunakan file cadangan terbaru di direktori cadangan komponen.

5. Mulai ulang OpenLDAP:

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

6. Mulai ulang semua Server Pengelolaan:

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

Server Pengelolaan

1. Hentikan Server Pengelolaan:

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

2. Hapus direktori Server Pengelolaan lama:

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

3. Instal ulang Server Pengelolaan:

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

4. Pulihkan Server Pengelolaan dari file cadangan:

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

   Perhatikan bahwa saat memulihkan komponen, Anda tidak menentukan jalur direktori ke cadangan file, atau tidak menentukan "backup-" atau ".tar.gz" akhiran. Anda hanya menentukan tanggal/waktu dari nama file cadangan.

   Secara opsional, Anda dapat menghilangkan file cadangan dalam perintah restore dan Edge akan gunakan file cadangan terbaru di direktori cadangan komponen.

5. Mulai ulang Server Pengelolaan:

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

Message Processor

1. Hentikan Pemroses Pesan:

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

2. Hapus direktori Pemroses Pesan lama:

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

3. Instal Ulang Pemroses Pesan:

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

4. Pulihkan Pemroses Pesan dari file cadangan:

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

   Perhatikan bahwa saat memulihkan komponen, Anda tidak menentukan jalur direktori ke cadangan file, atau tidak menentukan "backup-" atau ".tar.gz" akhiran. Anda hanya menentukan tanggal/waktu dari nama file cadangan.

   Secara opsional, Anda dapat menghilangkan file cadangan dalam perintah restore dan Edge akan gunakan file cadangan terbaru di direktori cadangan komponen.

5. Mulai Ulang Pemroses Pesan:

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

Router

1. Hentikan Router:

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

2. Hapus direktori Router lama:

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

3. Instal ulang Router:
   

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

4. Pulihkan Router dari file cadangan:

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

   Perhatikan bahwa saat memulihkan komponen, Anda tidak menentukan jalur direktori ke cadangan file, atau tidak menentukan "backup-" atau ".tar.gz" akhiran. Anda hanya menentukan tanggal/waktu dari nama file cadangan.

   Secara opsional, Anda dapat menghilangkan file cadangan dalam perintah restore dan Edge akan gunakan file cadangan terbaru di direktori cadangan komponen.

5. Mulai Ulang Router:
   

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

UI Edge

1. Hentikan UI:

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

2. Hapus direktori UI lama:

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

3. Instal ulang UI:
   

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

4. Memulihkan UI dari file cadangan:

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

   Perhatikan bahwa saat memulihkan komponen, Anda tidak menentukan jalur direktori ke cadangan file, atau tidak menentukan "backup-" atau ".tar.gz" akhiran. Anda hanya menentukan tanggal/waktu dari nama file cadangan.

   Secara opsional, Anda dapat menghilangkan file cadangan dalam perintah restore dan Edge akan gunakan file cadangan terbaru di direktori cadangan komponen.

5. Mulai ulang UI:
   

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

Selesaikan Pemulihan Situs

1. Hentikan semua node komponen. Perhatikan bahwa urutan penghentian subsistem itu penting: pertama menghentikan semua node Edge, lalu menghentikan semua node datastore.
2. Pulihkan semua komponen seperti yang dijelaskan di atas.
3. Sekarang, mulai semua komponen dalam urutan berikut. Perhatikan bahwa urutan memulai subsistem itu penting:
   1. Mulai cluster ZooKeeper
   2. Mulai gugus Cassandra
   3. Pastikan OpenLDAP sudah aktif dan berjalan
   4. Mulai qpid
   5. Memastikan database PostgreSQL aktif dan berjalan
   6. Mulai Server Pengelolaan
   7. Memulai Router dan Pemroses Pesan
   8. Mulai Server Qpid
   9. Mulai Server Postgres
   10. Mulai UI Apigee