Roll back Apigee Edge 4.52.02

Jika mengalami error selama update ke Edge 4.52.02, Anda dapat melakukan rollback komponen yang menyebabkan error, lalu mencoba update lagi.

Anda dapat melakukan roll back Edge 4.52.02 ke versi rilis utama berikut:

  • Versi 4.52.01
  • Versi 4.52.00
  • Versi 4.51.00

Me-roll back versi melibatkan me-roll back setiap komponen yang mungkin telah Anda upgrade. Selain itu, berdasarkan versi yang Anda mulai, Anda mungkin perlu mempertimbangkan hal-hal khusus sebelum melakukan rollback komponen software tertentu. Tabel di bawah mencantumkan berbagai software yang mungkin memerlukan langkah khusus selama rollback:

Rollback ke versi Pertimbangan khusus untuk software
4.52.01 Cassandra
4.52.00 Cassandra, Zookeeper, Qpid
4.51.00 Cassandra, Zookeeper, Qpid, Postgres

Ada dua skenario saat Anda mungkin ingin melakukan rollback:

  1. Melakukan roll back ke rilis utama atau minor sebelumnya. Misalnya dari 4.52.02 menjadi 4.52.00.
  2. Kembalikan ke rilis patch sebelumnya dalam rilis yang sama. Misalnya, dari 4.52.00.02 ke 4.52.00.01.

Untuk informasi selengkapnya, lihat Proses rilis Apigee Edge.

Urutan rollback

Rollback komponen harus dilakukan dalam urutan terbalik saat diupgrade, dengan pengecualian bahwa server pengelolaan harus di-roll back setelah Cassandra.

Urutan umum rollback untuk Private Cloud 4.52.02 akan terlihat seperti di bawah ini:

  1. Melakukan rollback Postgres, Qpid, dan komponen terkait analisis lainnya
  2. Router dan Pemroses Pesan Rollback
  3. Rollback Cassandra, Zookeeper
  4. Server Pengelolaan Rollback

Misalnya, Anda telah mengupgrade seluruh cluster Cassandra, semua server pengelolaan, dan beberapa RMP ke versi 4.52.02 dari versi 4.52.01 dan ingin melakukan rollback. Dalam hal ini, Anda akan:

  1. Melakukan rollback semua RMP satu per satu
  2. Melakukan rollback seluruh cluster Cassandra menggunakan cadangan
  3. Melakukan rollback node server Edge Management satu per satu

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 pengguna "apigee". Dalam beberapa kasus, Anda mungkin menjalankan komponen Edge sebagai pengguna yang berbeda. Misalnya, jika Router harus mengakses port dengan hak istimewa, seperti port di bawah 1.000, 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 lain sebagai pengguna lain.

Komponen dengan kode umum

Komponen Edge berikut memiliki kode yang sama. Oleh karena itu, untuk melakukan rollback salah satu komponen ini di node, Anda harus melakukan rollback semua komponen ini yang ada di node tersebut.

  • edge-management-server (Server Pengelolaan)
  • edge-message-processor (Message Processor)
  • edge-router (Router)
  • edge-postgres-server (Server Postgres)
  • edge-qpid-server (Server Qpid)

Misalnya, jika Anda menginstal Server Pengelolaan, Router, dan Pemroses Pesan di node, untuk melakukan rollback salah satunya, Anda harus melakukan rollback ketiganya.

Rollback Cassandra

Saat upgrade besar Cassandra dilakukan pada node Cassandra tertentu, Cassandra akan mengubah skema data yang disimpan di node, sehingga rollback langsung tidak dapat dilakukan. Ada dua metodologi untuk melakukan rollback. Anda akan menggunakan salah satu metodologi ini berdasarkan status upgrade yang Anda rollback.

Metodologi untuk melakukan rollback

Menghapus total dan menggunakan node yang ada di cluster untuk membuat ulang node

Prosedur ini dapat diikuti jika Anda memiliki minimal satu pusat data yang berfungsi penuh di cluster yang masih menggunakan Cassandra versi lama (Cassandra 2.1.22). Jika telah mengupgrade seluruh cluster Cassandra dan ingin melakukan rollback, Anda harus mengikuti langkah-langkah di Menghapus total dan memulihkan pencadangan atau snapshot VM.

Langkah-langkah untuk melakukan rollback

  1. Mulai dengan node yang ingin Anda rollback:
    • Hentikan Cassandra di node: 
      /opt/apigee/apigee-service/bin/apigee-service apigee-cassandra stop
    • Uninstal software Cassandra dari node: 
      /opt/apigee/apigee-service/bin/apigee-service apigee-cassandra uninstall
    • Hapus direktori data dari node: 
      rm -rf /opt/apigee/data/apigee-cassandra
    • Download dan jalankan bootstrap Edge untuk Private Cloud versi lama yang ingin Anda rollback.

    Contoh: Untuk melakukan rollback ke 4.52.01,

    • Download bootstrap 4.52.01: 
      curl https://software.apigee.com/bootstrap_4.52.01.sh -o /tmp/bootstrap_4.52.01.sh -u ‘uName:pWord’
    • Jalankan bootstrap 4.52.01: 
      sudo bash /tmp/bootstrap_4.52.01.sh apigeeuser=uName apigeepassword=pWord

    • Siapkan Cassandra di node: 
      /opt/apigee/apigee-setup/bin/setup.sh -p c -f configFile
    • Jalankan build ulang di node dengan memberikan nama pusat data fungsional: 
      /opt/apigee/apigee-cassandra/bin/nodetool rebuild -h <node-IP> <functional-dc>
    • Ulangi langkah-langkah di atas pada setiap node yang ingin Anda rollback, satu per satu.
  2. Setelah semua node di-roll back dan dibuat ulang:
    • Jalankan penyiapan node server pengelolaan. Pastikan server pengelolaan berasal dari versi yang di-roll back. Jika tidak, rollback server pengelolaan juga.
    • Hentikan server pengelolaan: 
      /opt/apigee/apigee-service/bin/apigee-service edge-management-server stop
    • Jika Anda menggunakan monetisasi, uninstal juga monetisasi: 
      /opt/apigee/apigee-service/bin/apigee-service edge-mint-gateway uninstall
    • Uninstal server pengelolaan: 
      /opt/apigee/apigee-service/bin/apigee-service edge-gateway uninstall
    • Download dan jalankan bootstrap versi lama. Misalnya, jalankan langkah-langkah berikut untuk mendownload dan mengeksekusi bootstrap versi 4.52.01: 
      curl https://software.apigee.com/bootstrap_4.52.01.sh -o /tmp/bootstrap_4.52.01.sh -u ‘uName:pWord’
      sudo bash /tmp/bootstrap_4.52.01.sh apigeeuser=uName apigeepassword=pWord
    • Jalankan penyiapan satu node server pengelolaan: 
      /opt/apigee/apigee-setup/bin/setup.sh -p mt -f configFile

Pengoptimalan setelah mem-build ulang

Pada langkah-langkah di atas, semua data di node di-streaming dari pusat data jarak jauh selama proses build ulang. Anda dapat mengoptimalkan proses ini dengan menggunakan perbaikan setelah semua replika di-streaming ke pusat data lokal. Tindakan ini akan menghindari streaming lintas-DC dan akan lebih cepat daripada membuat ulang semua node dari DC jarak jauh.

Contoh: Misalkan Anda memiliki enam node Cassandra di pusat data lokal. Secara default, faktor replikasi Apigee adalah tiga, sehingga setiap node memiliki 50% data. Dalam hal ini, Anda dapat mem-build ulang node #1 dan #4 dengan mengikuti prosedur di atas. Untuk node #2, #3, #5, dan #6, ikuti langkah-langkah di bawah untuk memulihkan cadangan dan menjalankan perbaikan.

  1. Ikuti prosedur hingga langkah enam seperti yang didokumentasikan untuk membuat ulang replika di pusat data lokal.
  2. Untuk node yang tersisa, ikuti langkah-langkah di bawah pada setiap node yang tersisa satu per satu.
    • Pulihkan cadangan yang telah Anda ambil di node ini (catatan: cadangan ini kemungkinan akan memiliki data yang sudah tidak berlaku karena cadangan ini diambil sebelum Anda memulai upgrade Cassandra): 
      /opt/apigee/apigee-service/bin/apigee-service apigee-cassandra restore backup_file
    • Jika memiliki snapshot VM node, Anda dapat memulihkan snapshot, bukan memulihkan pencadangan Cassandra.
    • Setelah pencadangan dipulihkan, mulai layanan Cassandra di node: 
      /opt/apigee/apigee-service/bin/apigee-service apigee-cassandra start
    • Jalankan perbaikan pada node agar data terbaru dapat di-streaming dari pusat data yang ada: 
      /opt/apigee/apigee-cassandra/bin/nodetool -h <node-IP> repair -dc <local-dc-name>
    • Ulangi langkah tiga hingga enam di setiap node yang ingin diperbaiki.

Menghapus total dan memulihkan cadangan/snapshot VM

Prosedur ini adalah satu-satunya yang tersedia jika Anda telah mengupgrade seluruh cluster Cassandra dan ingin melakukan rollback.

Selain itu, pencadangan Apigee bersifat khusus node. Anda tidak dapat memulihkan cadangan yang diambil dari satu node ke node lain. Pencadangan Cassandra menyertakan informasi metadata node (seperti alamat IP, posisi ring, dll.).

  1. Mulai dengan 1 node Cassandra di cluster:
    • Hentikan layanan Cassandra di node: 
      /opt/apigee/apigee-service/bin/apigee-service apigee-cassandra stop
    • Uninstal software Cassandra dari node: 
      /opt/apigee/apigee-service/bin/apigee-service apigee-cassandra uninstall
    • Hapus direktori data dari node: 
      rm -rf /opt/apigee/data/apigee-cassandra
    • Download dan jalankan bootstrap Edge versi lama untuk Private Cloud yang ingin Anda rollback.

    Contoh: Untuk melakukan rollback ke 4.52.01

    • Download bootstrap 4.52.01: 
      curl https://software.apigee.com/bootstrap_4.52.01.sh -o /tmp/bootstrap_4.52.01.sh -u ‘uName:pWord’
    • Jalankan bootstrap 4.52.01: 
      sudo bash /tmp/bootstrap_4.52.01.sh apigeeuser=uName apigeepassword=pWord

    • Siapkan Cassandra di node: 
      /opt/apigee/apigee-setup/bin/setup.sh -p c -f configFile
    • Pulihkan cadangan di node menggunakan prosedur di Memulihkan dari cadangan.
    • Hentikan Cassandra di node: 
      /opt/apigee/apigee-service/bin/apigee-service apigee-cassandra stop
    • Menghapus direktori data: 
      rm -rf /opt/apigee/data/apigee-cassandra/data
    • Memulihkan cadangan: 
      /opt/apigee/apigee-service/bin/apigee-service apigee-cassandra restore backup_file
    • Mulai layanan Cassandra di node: 
      /opt/apigee/apigee-service/bin/apigee-service apigee-cassandra start
    • Ulangi langkah-langkah di setiap node Cassandra satu per satu.
    • Jalankan perbaikan di seluruh node satu per satu: 
      /opt/apigee/apigee-cassandra/bin/nodetool -h <node-IP> repair -pr

Melakukan rollback update Zookeeper 3.8.3

Jika melakukan rollback ke versi 4.52.00 atau 4.51.00, Anda harus mengikuti beberapa langkah khusus sebelum melakukan rollback Zookeeper. Langkah-langkah ini tercantum di Rollback.

Jika Anda melakukan rollback ke versi 4.52.01, rollback Zookeeper seperti Anda melakukan rollback software apa pun, seperti yang tercantum di bagian Melakukan rollback ke rilis utama atau minor sebelumnya di bawah.

Rollback Qpid

Jika Anda melakukan rollback ke versi 4.52.00 atau 4.51.00, Anda harus melihat beberapa langkah khusus sebelum melakukan rollback Qpid. Langkah-langkah ini tercantum di Rollback.

Jika Anda melakukan rollback ke versi 4.52.01, rollback Qpid seperti Anda melakukan rollback software apa pun seperti yang tercantum di Melakukan rollback ke rilis utama atau minor sebelumnya

Melakukan rollback update Postgres 10.17

Jika melakukan rollback ke versi 4.51.00, Anda harus melihat beberapa langkah khusus sebelum melakukan rollback Postgres. Langkah-langkah ini tercantum di Rollback.

Jika Anda melakukan rollback ke versi 4.52.01 atau 4.52.00, rollback Postgres seperti Anda akan melakukan rollback software apa pun, seperti yang tercantum di bagian Melakukan rollback ke rilis utama atau minor sebelumnya di bawah.

Melakukan roll back ke rilis utama atau minor sebelumnya

Untuk melakukan roll back ke rilis utama atau minor sebelumnya, lakukan hal berikut di setiap node yang menghosting komponen:

  1. Download file bootstrap.sh untuk versi yang ingin Anda rollback:

    • Untuk melakukan rollback ke 4.51.00, download bootstrap_4.51.00.sh: 
      curl https://software.apigee.com/bootstrap_4.51.00.sh -o /tmp/bootstrap_4.51.00.sh
  2. Hentikan komponen untuk melakukan rollback:
    1. Untuk melakukan rollback pada komponen dengan kode umum di node, Anda harus menghentikan semuanya, seperti yang ditunjukkan pada contoh berikut: 
      /opt/apigee/apigee-service/bin/apigee-service edge-management-server stop
/opt/apigee/apigee-service/bin/apigee-service edge-router stop
/opt/apigee/apigee-service/bin/apigee-service edge-message-processor stop
/opt/apigee/apigee-service/bin/apigee-service edge-qpid-server stop
/opt/apigee/apigee-service/bin/apigee-service edge-postgres-server stop
    2. Untuk melakukan rollback komponen lain di node, hentikan komponen tersebut saja: 
      /opt/apigee/apigee-service/bin/apigee-service component stop
  3. Jika Anda ingin mengembalikan Monetisasi, uninstal dari semua node Server Pengelolaan dan Message Processor: 
    /opt/apigee/apigee-service/bin/apigee-service edge-mint-gateway uninstall
  4. Uninstal komponen untuk melakukan rollback di node:
    1. Untuk melakukan rollback pada komponen dengan kode umum di node, Anda harus meng-uninstal semuanya dengan meng-uninstal grup komponen edge-gateway, seperti yang ditunjukkan pada contoh berikut: 
      /opt/apigee/apigee-service/bin/apigee-service edge-gateway uninstall
    2. Untuk melakukan rollback komponen lain di node, cukup uninstal komponen tersebut, seperti yang ditunjukkan dalam contoh berikut: 
      /opt/apigee/apigee-service/bin/apigee-service component uninstall

      Dengan component adalah nama komponen.

    3. Untuk melakukan rollback Edge Router, Anda harus menghapus konten file /opt/nginx/conf.d selain meng-uninstal grup komponen edge-gateway: 
      cd /opt/nginx/conf.d
rm -rf *
  5. Uninstal apigee-setup versi 4.52.02: 
    /opt/apigee/apigee-service/bin/apigee-service apigee-setup uninstall
  6. Instal utilitas apigee-service versi 4.51.00 dan dependensinya. Contoh berikut menginstal apigee-service versi 4.51.00: 
    sudo bash /tmp/bootstrap_4.51.00.sh apigeeuser=uName apigeepassword=pWord

    Dengan uName dan pWord adalah nama pengguna dan sandi yang Anda terima dari Apigee. Jika Anda menghilangkan pWord, Anda akan diminta untuk memasukkannya.

    Jika Anda mendapatkan error, pastikan Anda mendownload file bootstrap.sh di langkah 1.

  7. Instal apigee-setup: 
    /opt/apigee/apigee-service/bin/apigee-service apigee-setup install
  8. Instal komponen versi lama: 
    /opt/apigee/apigee-setup/bin/setup.sh -p component -f configFile

    Dengan component adalah komponen yang akan diinstal dan configFile adalah file konfigurasi Anda untuk versi lama.

  9. Jika Anda melakukan rollback Qpid, hapus iptables: 
    sudo iptables -F
  10. Ulangi proses ini untuk setiap node yang menghosting komponen yang Anda rollback.

Melakukan roll back ke rilis patch sebelumnya

Untuk melakukan rollback komponen ke rilis patch tertentu, lakukan hal berikut di setiap node yang menghosting komponen:

  1. Download versi komponen tertentu: 
    /opt/apigee/apigee-service/bin/apigee-service component_version install

    Dengan component_version adalah rilis komponen dan patch yang akan diinstal. Misalnya:

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

    Jika menggunakan repo online Apigee, Anda dapat menentukan versi komponen yang tersedia menggunakan perintah berikut: 

    yum --showduplicates list comp

    Contoh:

    yum --showduplicates list edge-ui
  2. Gunakan apigee-setup untuk menginstal komponen: 
    /opt/apigee/apigee-setup/bin/setup.sh -p comp -f configFile

    Contoh:

    /opt/apigee/apigee-setup/bin/setup.sh -p ui -f configFile

    Perhatikan bahwa Anda hanya menentukan nama komponen saat menginstalnya, bukan versinya.

  3. Ulangi proses ini untuk setiap node yang menghosting komponen yang Anda rollback.

Melakukan roll back mTLS

Untuk melakukan rollback update mTLS, lakukan langkah-langkah berikut di semua host:

  1. Hentikan Apigee: 
    apigee-all stop
  2. Menghentikan mTLS: 
    apigee-service apigee-mtls uninstall
  3. Instal ulang mTLS: 
    apigee-service apigee-mtls install
apigee-service apigee-mtls setup -f /opt/silent.conf