Menginstal ulang dan memulihkan komponen

Dokumen ini membahas 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. Hentikan 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. Memulihkan 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 file cadangan, dan Anda juga tidak menentukan awalan "backup-" atau akhiran ".tar.gz". Anda hanya menentukan bagian tanggal/waktu dari nama file cadangan.

   Anda dapat menghilangkan file cadangan dalam perintah restore dan Edge akan menggunakan file cadangan terbaru di direktori cadangan komponen.

5. Mulai ulang semua komponen:

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

Memulihkan satu node cluster

Jika satu node ZooKeeper yang merupakan bagian dari ensemble gagal, Anda dapat membuat node baru dengan nama host/alamat IP yang sama dan menginstal ulang ZooKeeper. Saat node ZooKeeper baru bergabung dengan ensemble ZooKeeper, node tersebut 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 penyiapan di node ZooKeeper menggunakan file konfigurasi yang sama dengan yang digunakan saat menginstal 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. Menghentikan seluruh cluster.
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. Memulihkan 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 file cadangan, dan Anda juga tidak menentukan awalan "backup-" atau akhiran ".tar.gz". Anda hanya menentukan bagian tanggal/waktu dari nama file cadangan.

   Anda dapat menghilangkan file cadangan dalam perintah restore dan Edge akan menggunakan file cadangan terbaru di direktori cadangan komponen.

5. Mulai ulang semua komponen:
   

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

Memulihkan satu node cluster

Jika satu node Cassandra yang merupakan bagian dari 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 di node yang gagal. Langkah-langkah ini biasanya berlaku jika node di cluster Cassandra Anda 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 di node tersebut.

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

1. Hentikan proses Cassandra pada 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 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 seed pusat data.
   1. Di node Cassandra operasional mana pun di pusat data yang sama dengan node yang dipulihkan, jalankan perintah berikut:

      apigee-service apigee-cassandra configure -search conf_cassandra_seeds

   2. Perintah ini akan menghasilkan output 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 dalam output. Alamat IP yang tercantum dan dipisahkan koma adalah node awal yang digunakan oleh node di pusat data ini.
2. Pada node baru yang sedang 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 dalam daftar node seed dari langkah 1), tambahkan baris lain dalam file:
   

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

   1. Misalnya, dalam contoh di atas, daftar awal 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 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 melakukan bootstrap layanan Cassandra secara internal. Proses ini mungkin memerlukan waktu yang lama berdasarkan jumlah data yang akan 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 aktif kembali, gunakan perintah standar seperti di bawah untuk memverifikasi bahwa node telah berhasil bergabung ke ring:
    

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

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

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

Memulihkan cluster lengkap

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

Database PostgreSQL

PosgreSQL yang berjalan mandiri 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 saat memulihkan komponen PostgreSQL, Anda tidak menentukan jalur direktori ke file cadangan, dan Anda juga tidak menentukan sufiks ".dump". Anda hanya menentukan bagian tanggal/waktu dari nama file cadangan.

   Anda dapat secara opsional menghapus file cadangan dalam perintah restore dan Edge akan menggunakan 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. Menginstal 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 Postgres Server lama:

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

3. Instal ulang Server Postgres:

   /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 file cadangan, dan Anda juga tidak menentukan awalan "backup-" atau akhiran ".tar.gz". Anda hanya menentukan bagian tanggal/waktu dari nama file cadangan.

   Anda dapat secara opsional menghapus file cadangan dalam perintah restore dan Edge akan menggunakan 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. Memulihkan 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 file cadangan, dan Anda juga tidak menentukan awalan "backup-" atau akhiran ".tar.gz". Anda hanya menentukan bagian tanggal/waktu dari nama file cadangan.

   Anda dapat secara opsional menghapus file cadangan dalam perintah restore dan Edge akan menggunakan file cadangan terbaru di direktori cadangan komponen.

5. Mulai Qpidd:

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

6. Instal ulang Qpid Server:

   /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 file cadangan, dan Anda juga tidak menentukan awalan "backup-" atau akhiran ".tar.gz". Anda hanya menentukan bagian tanggal/waktu dari nama file cadangan.

   Anda dapat menghilangkan file cadangan dalam perintah restore dan Edge akan menggunakan file cadangan terbaru di direktori cadangan komponen.

8. Mulai ulang Qpid Server, Qpidd, dan Postgres Server di 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

SymasLDAP

1. Menghentikan SymasLDAP:

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

2. Instal ulang SymasLDAP:

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

3. Hapus direktori SymasLDAP lama:

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

4. Memulihkan SymasLDAP:

   /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 file cadangan, dan Anda juga tidak menentukan awalan "backup-" atau akhiran ".tar.gz". Anda hanya menentukan bagian tanggal/waktu dari nama file cadangan.

   Anda dapat secara opsional menghapus file cadangan dalam perintah restore dan Edge akan menggunakan file cadangan terbaru di direktori cadangan komponen.

5. Mulai ulang SymasLDAP:

   /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. Menghentikan 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. Menginstal 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 file cadangan, dan Anda juga tidak menentukan awalan "backup-" atau akhiran ".tar.gz". Anda hanya menentukan bagian tanggal/waktu dari nama file cadangan.

   Anda dapat menghilangkan file cadangan dalam perintah restore dan Edge akan menggunakan 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. Menghentikan Message Processor:

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

2. Hapus direktori Message Processor lama:

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

3. Instal ulang Message Processor:

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

4. Memulihkan Message Processor 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 file cadangan, dan Anda juga tidak menentukan awalan "backup-" atau akhiran ".tar.gz". Anda hanya menentukan bagian tanggal/waktu dari nama file cadangan.

   Anda dapat secara opsional menghapus file cadangan dalam perintah restore dan Edge akan menggunakan file cadangan terbaru di direktori cadangan komponen.

5. Mulai ulang Message Processor:

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

Router

1. Router Berhenti:

   /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 file cadangan, dan Anda juga tidak menentukan awalan "backup-" atau akhiran ".tar.gz". Anda hanya menentukan bagian tanggal/waktu dari nama file cadangan.

   Anda dapat menghilangkan file cadangan dalam perintah restore dan Edge akan menggunakan file cadangan terbaru di direktori cadangan komponen.

5. Mulai Ulang Router:
   

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

UI Edge Baru

1. Menghentikan UI Edge Baru:

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

2. Hapus direktori UI Edge Baru yang lama:

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

3. Menginstal ulang UI Edge Baru:

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

4. Memulihkan UI New Edge dari file cadangan:

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

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

   Anda dapat secara opsional menghapus file cadangan dalam perintah restore dan Edge akan menggunakan file cadangan terbaru di direktori cadangan komponen.

5. Mulai ulang UI New Edge:

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

Pemulihan Situs Lengkap

1. Hentikan semua node komponen. Perhatikan bahwa urutan penghentian subsistem itu penting: pertama-tama hentikan semua node Edge, dan kemudian hentikan 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 sangat penting:
   1. Mulai cluster ZooKeeper
   2. Memulai cluster Cassandra
   3. Memastikan SymasLDAP aktif dan berjalan
   4. Memulai qpid
   5. Pastikan database PostgreSQL sudah aktif dan berjalan
   6. Mulai Server Pengelolaan
   7. Mulai Router dan Pemroses Pesan
   8. Memulai Server Qpid
   9. Mulai Server Postgres
   10. Memulai UI Edge Baru