4.16.09 Proses Rollback

Jika terjadi error selama update ke Edge 4.16.09, Anda dapat melakukan roll back komponen yang menyebabkan error, lalu mencoba update lagi. Misalnya, jika update ke Postgres 9.4 gagal, Anda hanya dapat melakukan rollback node Postgres dan mencoba update lagi.

Ada dua skenario yang memungkinkan Anda melakukan rollback:

  1. Rollback ke rilis yang lebih lama. Misalnya dari 4.16.09 hingga 4.16.05.
  2. Rollback ke versi yang lebih lama dalam rilis yang sama.

Gunakan prosedur di bawah ini untuk melakukan rollback bagi kedua skenario.

Siapa yang dapat melakukan rollback

Pengguna yang melakukan rollback harus sama dengan pengguna yang awalnya mengupdate Edge, atau pengguna yang berjalan sebagai root.

Secara default, komponen Edge berjalan sebagai "apigee" pengguna. Dalam beberapa kasus, Anda mungkin menjalankan komponen Edge sebagai pengguna yang berbeda. Misalnya, jika Router harus mengakses port dengan hak istimewa, seperti port yang berada di bawah 1000, Anda harus menjalankan Router sebagai root atau sebagai pengguna dengan akses ke port tersebut. Atau, Anda dapat menjalankan satu komponen sebagai satu pengguna, dan komponen lainnya sebagai pengguna lainnya.

Komponen mana yang dapat di-roll back

Anda harus mengetahui kondisi berikut saat melakukan rollback:

  • Lima komponen Edge yang tercantum di bawah memiliki kode yang sama. Oleh karena itu, untuk melakukan rollback salah satu dari lima komponen pada node, Anda harus melakukan roll back dari lima komponen yang diinstal pada node. Misalnya, jika Anda telah menginstal Server Pengelolaan, Router, dan Pemroses Pesan di node, untuk me-roll back salah satunya, Anda harus melakukan roll back ketiganya.
    Lima komponen yang menggunakan kode yang sama adalah:
    • Server Pengelolaan
    • Router
    • Message Processor
    • Server Qpid
    • Server Postgres
  • Jika Anda mengupdate dari Edge 4.16.01, jangan rollback Cassandra. Rilis Edge ini berisi versi Cassandra yang telah diupdate. Jika Anda melakukan rollback komponen apa pun, biarkan Cassandra pada versi 4.16.09.
  • Rilis ini tidak berisi qpidd versi baru. Oleh karena itu, Anda tidak perlu melakukan rollback qpidd.

Roll back 4.16.09

Bagian ini berisi prosedur untuk rollback Edge 4.16.09 ke versi sebelumnya. Bagian ini dibagi menjadi dua bagian:

  • Melakukan roll back update Postgres ke versi 9.4
    Bagian terakhir dari setiap prosedur update adalah mengupdate node Postgres ke versi 9.4. Jika update tersebut gagal, Anda dapat menggunakan prosedur ini untuk melakukan rollback update.
  • Melakukan roll back semua komponen Edge lainnya
    Gunakan prosedur ini untuk melakukan rollback komponen Edge lainnya.

Untuk melakukan rollback update Postgres 9.4

Untuk melakukan rollback pembaruan Postgres saat memperbarui Postgres dalam konfigurasi standby, Anda:

  • Promosikan node standby baru untuk menjadi master Postgres. Postgres master baru akan memiliki versi yang sama dengan penginstalan Edge Anda sebelumnya.
  • Konfigurasikan node standby lama agar menjadi node standby master baru. Node standby lama akan memiliki versi yang sama dengan penginstalan Edge Anda sebelumnya.
  • Daftarkan node master dan standby baru dengan grup konsumen dan analisis.

Setelah selesai menggunakan rollback, node master lama tidak akan lagi diperlukan. Kemudian, Anda dapat menonaktifkan node master lama.

  1. Pastikan node Postgres standby baru berjalan:
    > /opt/apigee/apigee-service/bin/apigee-all status

    Jika Postgres tidak berjalan, mulai:
    > /opt/apigee/apigee-service/bin/apigee-all start
  2. Pastikan Postgres dihentikan pada node master lama dan node standby lama:
    > /opt/apigee/apigee-service/bin/apigee-all status

    Jika Postgres dijalankan, hentikan:
    > /opt/apigee/apigee-service/bin/apigee-service edge-postgres-server stop
    >
  3. Jika diinstal, mulai Qpid pada node standby lama:
    > /opt/apigee/apigee-service/bin/apigee-service edge-qpid-server start

    Catatan: Dalam banyak konfigurasi, node standby lama hanya akan menghosting Postgres, bukan Qpid.
  4. Promosikan node standby baru sebagai master Postgres:
    1. Promosikan node standby baru untuk menjadi master baru:
      > apigee-service apigee-postgresql promotion-standby-to-master new_standby_IP

      Jika diminta, masukkan sandi Postgres untuk pengguna 'apigee', yang defaultnya adalah "postgres".
    2. Edit file konfigurasi yang Anda gunakan untuk menginstal versi Edge Anda saat ini untuk menentukan hal berikut:
      # alamat IP master baru:
      PG_MASTER=new_standby_IP
      # Alamat IP node lama standby
      PG_standBY=old_standby_IP
    3. Konfigurasikan master baru:
      > /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql setup-replication-on-master -f configFile
  5. Build ulang node standby lama:
    1. Edit file konfigurasi yang Anda gunakan untuk menginstal versi Edge Anda saat ini untuk menentukan hal berikut:
      # alamat IP master baru:
      PG_MASTER=new_standby_IP
      # Alamat IP node lama standby
      PG_standBY=old_standby_IP
    2. Hapus direktori data pada node standby lama:
      > cd /opt/apigee/data/apigee-postgresql/pgdata
      > rm -rf *
    3. Konfigurasi ulang node standby lama menjadi node standby master baru:
      > /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql setup-replication-on-standby -f configFile
    4. Pastikan Postgres berjalan di node standby lama:
      > /opt/apigee/apigee-service/bin/apigee-all status

      Jika tidak berjalan, mulai:
      > /opt/apigee/apigee-service/bin/apigee-service edge-postgres-server start
  6. Verifikasi bahwa node standby baru telah ditambahkan dengan melihat file /opt/apigee/apigee-postgresql/conf/pg_hba.conf pada master baru.
  7. Lihat informasi grup konsumen dan analisis saat ini dengan menjalankan perintah berikut di Server Pengelolaan:
    > curl -u sysAdminEmail:password http://<ms_IP>:8080/v1/analytics/groups/ax

    Perintah ini menampilkan nama grup analisis di kolom name, dan nama grup konsumen di kolom name. Metode ini juga menampilkan UUID dari node master dan standby Postgres lama di kolom postgres-server, dan di kolom datastores.


















  8. Dapatkan alamat UUID dari master lama dengan menjalankan perintah cURL berikut di node master lama:
    > curl -u sysAdminEmail:password http://<node_IP>:8084/v1/servers/self

    Anda akan melihat UUID node di akhir output, dalam bentuk: "
    "


     Jika server Postgres tidak berjalan, Anda dapat menjalankan perintah berikut di Server Pengelolaan untuk menentukan UUID:
    > curl -u sysAdminEmail:password http://<ms_IP>:8080/v1/servers?pod=analytics

    Output perintah ini mencantumkan UUID untuk alamat IP setiap node Postres.
  9. Ulangi langkah sebelumnya untuk mendapatkan alamat IP node standby lama dan master baru.
  10. Hapus node master dan standby lama dari grup konsumen:
    > curl -u sysAdminEmail:password -X DELETE "http://<ms_IP>:8080/v1/analytics/groups/ax/axgroup-001/consumer-groups/consumer-group-001/datastores/
    overload.
     dan/
    *salse. masterUUID,standbyUUID berada dalam urutan yang sama seperti yang muncul di atas saat Anda melihat analisis saat ini dan informasi grup konsumen di atas. Anda mungkin harus menetapkannya sebagai standbyUUID,masterUUID.

    Properti datastores untuk consumer-groups sekarang akan kosong.
  11. Hapus node master dan standby lama dari grup analisis:
    > curl -u sysAdminEmail:password -X DELETE "http://<ms_IP>:8080/v1/analytics/groups/ax/axgroup-001/servers?uuid=masterUUID,standbyUUID&type postgres-
  12. 32


  13. Validasi grup analisis:
    > curl -u sysAdminEmail:password http://<ms_IP>:8080/v1/analytics/groups/ax

    Anda akan melihat UUID dari node master dan standby baru yang tercantum di grup analisis dan grup konsumen.
  14. Mulai ulang Server Pengelolaan Edge:
    > /opt/apigee/apigee-service/bin/apigee-service edge-management-server restart
  15. Mulai ulang semua server Qpid:
    > /opt/apigee/apigee-service/bin/apigee-service edge-qpid-server restart
  16. Mulai ulang semua server Postgres:
    > /opt/apigee/apigee-service/bin/apigee-service edge-postgres-server restart
  17. Verifikasi status replikasi dengan menerbitkan skrip berikut ke kedua server. Sistem akan menampilkan hasil yang identik di kedua server guna memastikan replikasi berhasil:

    Di master baru, jalankan:
    > /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql postgres-check-master

    Validasikan bahwa master server adalah master.

    Di node standby lama:
    > /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql postgres-check-standby

    Validasi bahwa node tersebut merupakan standby.
  18. Ulangi langkah sebelumnya setelah membuat beberapa permintaan API untuk memastikan bahwa node disinkronkan.
  19. Nonaktifkan master Postgres lama menggunakan prosedur di Mengupdate Apigee Edge ke 4.16.09.

    Catatan: Jika node master lama menjalankan Qpid, Anda dapat membiarkan server tersebut berjalan untuk menjalankan Qpid. Pastikan kampanye berjalan. Jika tidak, mulailah:
    > /opt/apigee/apigee-service/bin/apigee-service edge-management-server start

    Atau, Anda dapat meng-uninstal Qpid dari master lama dan menginstal Qpid di node master baru, seperti yang dijelaskan di bawah. Setelah meng-uninstal Qpid, Anda dapat menonaktifkan node master lama.

Uninstal Qpid dari master lama dan instal Qpid di master baru

Gunakan prosedur berikut untuk meng-uninstal Qpid dari master lama dan menginstalnya di master baru:

  1. Blokir akses ke port Qpid 5672 di master lama agar tidak dapat diakses oleh Prosesor Pesan dengan menjalankan perintah berikut di semua Prosesor Pesan:
    > iptables -A OUTPUT -p tcp -d 10.233.147.20 --dport 5672 -j DROP
  2. Pastikan antrean pesan Qpid kosong dengan menjalankan perintah berikut. Anda tidak dapat meng-uninstal Qpid sebelum memproses semua pesan yang tertunda:
    > qpid-stat -q

    Perintah ini menampilkan tabel yang berisi jumlah untuk msg, msgIn, dan msgOut. Semua pesan akan diproses saat msg=0 dan msgIn=msgOut.
  3. Tentukan UUID server Qpid pada master lama dengan menjalankan perintah berikut pada master lama. Simpan informasi ini nanti di prosedur:
    > curl -u sysAdminEmail:password http://<node_IP>::8083/v1/servers/self
  4. Hentikan Qpid di master lama:
    > /opt/apigee/apigee-service/bin/apigee-service edge-qpid-server stop
    > /opt/apigee/apigee-service/bin/apigee-service apigee-qpidd stop
  5. Uninstal server Qpid:
    > /opt/apigee/apigee-service/bin/apigee-service edge-qpid-server uninstall
    > /opt/apigee/apigee-service/bin/apigee-service apigee-qpidd uninstal
  6. Tidak ada yang cocok dengan kueri Anda.


  7. Hapus server Qpid lama dari Zookeeper:
    > curl -u sysAdminEmail:password -X DELETE http://<ms_IP>:8080/v1/servers/qpid_UUID
  8. Instal Qpid di master baru:
    > /opt/apigee/apigee-setup/bin/setup.sh -p qs -f configFile
  9. Tentukan UUID server Qpid pada master baru dengan menjalankan perintah berikut pada master baru. Simpan informasi ini nanti di prosedur:
    > curl -u sysAdminEmail:password http://<node_IP>::8083/v1/servers/self
  10. B Tidak.


  11. Mulai ulang semua Pemroses Pesan:
    > /opt/apigee/apigee-service/bin/apigee-service edge-message-processor restart
  12. Jalankan perintah berikut di server Qpid baru untuk memeriksa apakah antrean telah dibuat:
    > qpid-stat -q

    Pastikan Anda melihat msg, msgIn, dan msgOut saat server Qpid memproses pesan.

Untuk melakukan rollback komponen individual dari 4.16.09

Sebagai bagian dari melakukan rollback, Anda harus mendownload file bootstrap.sh untuk versi Edge saat ini:

  • Untuk melakukan roll back ke 4.16.05, download bootstrap_4.16.05.sh
  • Untuk me-roll back ke 4.16.01, download bootstrap.sh

Untuk setiap node yang menghosting komponen untuk melakukan roll back:

  1. Hentikan komponen untuk rollback:
    1. Jika Anda melakukan roll back salah satu komponen berikut di node, Anda harus menghentikan semuanya: Management Server, Router, Message Processor, Qpid Server, atau Postgres Server:
      • > perhentian server pengelolaan API apigee
      • > perhentian edge-service apigee-service
      • > perhentian prosesor pesan tepi-layanan apigee
      • > perhentian server edge-qpid layanan apigee
      • > perhentian server apigee-service edge-postgres
    2. Jika Anda me-roll back komponen lain di node, hentikan hanya komponen tersebut:
      • > perhentian comp layanan apigee
  2. Jika Anda me-roll back Monetisasi, uninstal dari semua node Server Pengelolaan dan Pemroses Pesan:
    > uninstal apigee-service edge-mint-gateway
  3. Uninstal komponen untuk melakukan rollback pada node:
    1. Jika Anda melakukan roll back salah satu komponen berikut di node, uninstal semuanya: Management Server, Router, Message Processor, Qpid Server, atau Postgres Server:
      > apigee-service edge-gateway uninstal
    2. Jika Anda melakukan roll back komponen lain di node, uninstal komponen tersebut saja:
      > uninstal apigee-service comp
  4. Jika Anda me-roll back Router, Anda harus menghapus konten /opt/nginx/conf.d:
    > cd /opt/nginx/conf.d
    > rm -rf *
  5. Untuk melakukan rollback komponen:
    1. Uninstal versi apigee-setup 4.16.09:
      > /opt/apigee/apigee-service/bin/apigee-service apigee-setup uninstall
    2. Download bootstrap.sh untuk rilis 4.16.01 atau 4.16.05:
      Untuk 4.16.01:
      > curl https://software.apigee.com/bootstrap.sh -o /tmp/bootstrap.sh

      Untuk 4.16.05.com/bootstrap. https://url.
    3. Instal utilitas dan dependensi layanan apigee 4.16.01 atau 4.16.05:
      > sudo bash /tmp/bootstrap.sh apigeeuser=uName apigeepassword=pWord

      dengan uName dan pWord adalah nama pengguna dan sandi. Jika menghapus pWord, Anda akan diminta untuk memasukkannya.
    4. Instal apigee-setup versi 4.16.01 atau 4.16.05:
      > /opt/apigee/apigee-service/bin/apigee-service apigee-setup install
    5. Instal versi 4.16.01 atau 4.16.05 dari komponen:
      > /opt/apigee/apigee-setup/bin/setup.sh -p comp -f configFile

      dengan comp adalah komponen yang akan diinstal dan configFile adalah file 4.16.
  6. Untuk melakukan rollback komponen ke versi rilis 4.16.05 tertentu:
    1. Download versi komponen tertentu:
      > /<instal_dir>/apigee/apigee-service/bin/apigee-service comp-version install

      dengan comp-version adalah komponen dan versi yang akan diinstal. Misalnya:
      > /<instal_dir>/apigee/apigee-service/bin/apigee-service edge-ui-4.16.05-0.0.3649 install

      Jika menggunakan repo online Apigee, Anda dapat menentukan versi komponen yang tersedia dengan menggunakan perintah berikut:
      > yum --showduplicates edge


    2. Gunakan apigee-setup untuk menginstal komponen:
      > /<install_dir>/apigee/apigee-setup/bin/setup.sh -p comp -f configFile

      Misalnya:
      > /<install_dir>/apigee/apigee-setup/bin/setup.sh Anda melakukan

Hubungi Dukungan Apigee jika Anda mengalami masalah saat melakukan roll back.