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 secara opsional menghapus 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 ansambel ZooKeeper, node tersebut akan mendapatkan snapshot terbaru dari Pemimpin dan mulai melayani klien. Anda tidak perlu memulihkan data di 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. Hentikan 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 secara opsional menghapus 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 kerusakan hardware, dll.

Jika node yang gagal tidak lagi dapat diakses, hancurkan node dan isolasi jaringannya untuk memastikan node tidak dapat bergabung kembali ke cluster Cassandra secara tidak sengaja. Kemudian, aktifkan 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 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 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 awal pusat data.
   1. Di setiap node Cassandra operasional 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. Di 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 awal (Alamat IP Node muncul dalam daftar node awal dari langkah 1), tambahkan baris lain dalam file:
   

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

   1. Misalnya, pada instance 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 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 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 dengan ring:
    

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

11. Setelah Anda memvalidasi bahwa node berhasil diaktifkan dan berjalan, edit kembali file /opt/apigee/customer/application/cassandra.properties 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

PostgreSQL berjalan secara 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. Menginstal 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

PosgreSQL berjalan sebagai Standby

1. Menginstal ulang database PostgreSQL:

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

2. Mengonfigurasi 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 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

Qpid Server 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 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 secara opsional menghapus 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. Hentikan 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. 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. Menginstal ulang Server Pengelolaan:

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

4. Memulihkan 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 secara opsional menghapus 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. Hentikan 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. Menginstal 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. 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. Memulihkan 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 secara opsional menghapus 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

1. Menghentikan 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. UI penginstalan ulang:
   

   /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 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. UI Mulai Ulang:
   

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

Pemulihan Situs Lengkap

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