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 salah satu 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 langkah-langkah khusus sebelum melakukan rollback komponen software tertentu. Tabel berikut mencantumkan berbagai komponen software yang mungkin memerlukan langkah khusus selama rollback:

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

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 mengikuti urutan terbalik upgrade-nya, dengan pengecualian bahwa Server Pengelolaan harus di-roll back setelah Cassandra. Cassandra, komponen Runtime, dan Server Pengelolaan harus di-roll back menggunakan pendekatan data center per data center (DC per DC), yang sementara mengalihkan traffic ke data center yang berfungsi.

Urutan umum rollback untuk Private Cloud 4.52.02 akan terlihat seperti berikut:

Satu pusat data

Untuk penyiapan satu pusat data, prosedur rollback akan mengalami dampak yang signifikan pada traffic runtime dan API pengelolaan tertentu.

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

Beberapa pusat data

Dalam penyiapan multi-pusat data, rollback harus mengikuti pendekatan pusat data per pusat data (DC per DC) dengan mengalihkan traffic ke pusat data yang berfungsi untuk sementara. Hal ini memastikan kontinuitas traffic, menghindari periode nonaktif, dan memungkinkan proses rollback terkontrol untuk Cassandra, Management Server, dan node Runtime.

  1. Lakukan rollback Qpid dan komponen terkait analisis lainnya di semua DC.
  2. Blokir traffic di pusat data pertama dan arahkan ulang traffic ke DC lain.
  3. Lakukan rollback Router dan Message Processor di pusat data pertama.
  4. Lakukan rollback Cassandra di pusat data pertama.
  5. Server Pengelolaan Rollback di pusat data pertama.
  6. Hapus pemblokiran traffic di pusat data pertama dan ikuti langkah #2 hingga langkah #6 hingga pusat data terakhir melakukan rollback pada node Runtime, Cassandra, dan server Pengelolaan.
  7. Lakukan rollback Postgres, Zookeeper, dan LDAP di semua DC.

Untuk memperjelasnya, misalkan Anda telah mengupgrade seluruh cluster Cassandra, semua Server Pengelolaan, dan beberapa Runtime Message Processor (RMP) dari versi 4.52.01 ke 4.52.02 dan perlu melakukan rollback. Dalam hal ini, rollback harus dilakukan sebagai berikut:

  1. Blokir traffic ke pusat data pertama (pusat data) dan alihkan traffic ke DC aktif lainnya untuk memastikan keberlanjutan layanan.
  2. Rollback Router dan Message Processor di pusat data pertama.
  3. Rollback Cassandra di pusat data pertama dengan memulihkan dari cadangan atau snapshot VM.
  4. Rollback Server Pengelolaan di pusat data pertama.
  5. Buka blokir traffic ke pusat data pertama.
  6. Ulangi langkah 1 hingga 5 untuk setiap pusat data yang tersisa hingga semua node Runtime, Cassandra, dan Server Pengelolaan telah di-roll back.

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

Skenario rollback

Edge for Private Cloud 4.52.02 menyertakan upgrade di Cassandra dan driver yang digunakan oleh pemroses pesan dan server pengelolaan untuk terhubung ke Cassandra. Akibatnya, upgrade dan rollback dari 3 komponen ini saling terkait erat. Tabel di bawah mencantumkan contoh umum skenario rollback untuk ketiga komponen spesifik ini. Memundurkan komponen lain harus mengikuti bagian urutan rollback.

Bagian ini menguraikan berbagai skenario rollback beserta metodologi yang direkomendasikan untuk diikuti, berdasarkan pendekatan yang dijelaskan di atas.

Skenario Strategi Rollback
Satu pusat data, beberapa node Cassandra diupgrade Pemulihan cadangan
Satu pusat data, semua node Cassandra diupgrade Pemulihan cadangan
Satu pusat data, semua node (Cassandra, server Pengelolaan, dan node Runtime) diupgrade
Beberapa pusat data, beberapa/semua node Cassandra di pusat data pertama diupgrade Mem-build ulang dari pusat data yang ada
Beberapa pusat data, semua node Cassandra, server Pengelolaan, dan node Runtime di pusat data pertama diupgrade

Tindakan ini harus dilakukan di satu pusat data pada satu waktu.
Beberapa pusat data, beberapa/semua node Cassandra di pusat data terakhir diupgrade
  • Melakukan rollback pusat data terakhir menggunakan pencadangan
  • Lakukan rollback pada pusat data yang tersisa menggunakan pencadangan atau pembuatan ulang, satu pusat data pada satu waktu.
Beberapa pusat data, semua node Cassandra, server Pengelolaan, dan node Runtime diupgrade di semua DC

Tindakan ini harus dilakukan satu pusat data pada satu waktu.

Umumnya, Anda harus mempertimbangkan hal-hal berikut saat melakukan rollback Cassandra:

  1. Rollback komponen runtime atau pengelolaan

    Jika Anda perlu melakukan roll back komponen seperti Edge Management Server atau Edge Message Processor ke versi Edge Private Cloud sebelumnya di pusat data (DC) mana pun, pastikan Cassandra juga di-roll back di pusat data tertentu tersebut secara bersamaan. Hal ini diperlukan untuk mencegah kegagalan traffic pengelolaan dan runtime.

  2. Melakukan rollback menggunakan cadangan

    Pencadangan yang diambil dari Cassandra 3.11.x tidak kompatibel dengan cadangan dari Cassandra 2.1.x. Untuk mengaktifkan rollback menggunakan pemulihan cadangan, pastikan cadangan Cassandra 2.1.x diambil sebelum melakukan upgrade.

  3. Mengisolasi Data Center untuk Rollback

    Untuk menghindari periode nonaktif, pastikan traffic dialihkan ke pusat data yang berfungsi penuh dan diblokir dari pusat data yang sedang mengalami rollback.

Melakukan rollback Cassandra menggunakan rebuild

Prasyarat

  1. Anda mengoperasikan cluster Edge for Private Cloud 4.51.00 / 4.52.00 / 4.52.01 di beberapa pusat data
  2. Anda sedang dalam proses mengupgrade Cassandra dari 2.1.X ke 3.11.X dan mengalami masalah selama upgrade
  3. Anda memiliki minimal 1 pusat data yang berfungsi penuh di cluster yang masih menggunakan Cassandra versi lama (Cassandra 2.1.X)

Langkah-langkah tingkat tinggi

  1. Pilih satu pusat data (diupgrade sebagian atau sepenuhnya) yang ingin Anda rollback. Alihkan semua traffic aplikasi dari pusat data ini ke pusat data lain yang berfungsi penuh.
  2. Jika Router dan Message Processor telah diupgrade, rollback semua node Router dan message processor di pusat data, satu per satu.
  3. Hentikan Cassandra di satu node, uninstal, dan bersihkan semua data terkait.
  4. Instal bootstrap versi sebelumnya dan siapkan Cassandra versi 2.1.x di node yang telah dibersihkan.
  5. Buat ulang node dari pusat data fungsional yang ada yang masih menjalankan Cassandra 2.1.x.
  6. Lakukan langkah 3 hingga 5 pada setiap node Cassandra yang tersisa di pusat data, satu node pada satu waktu.
  7. Jalankan kembali penyiapan Server Pengelolaan di pusat data.
  8. Lakukan pengujian untuk memvalidasi rollback. Setelah diverifikasi, alihkan traffic aplikasi kembali ke pusat data yang dipulihkan.
  9. Ulangi langkah-langkah di atas untuk pusat data lain yang memerlukan rollback, satu per satu.

Langkah-langkah mendetail untuk menghapus total dan menggunakan node yang ada di cluster untuk membuat ulang node:

Mulai dengan node yang ingin Anda rollback

  1. Pastikan traffic dialihkan ke pusat data yang berfungsi sepenuhnya sebelum melanjutkan ke langkah berikutnya.
  2. Jika Router dan Message Processor telah diupgrade, rollback semua node Router dan Message Processor ke versi sebelumnya di pusat data, satu per satu.
  3. Hentikan Cassandra di node: 
    /opt/apigee/apigee-service/bin/apigee-service apigee-cassandra stop
  4. Uninstal software Cassandra dari node: 
    /opt/apigee/apigee-service/bin/apigee-service apigee-cassandra uninstall
  5. Hapus direktori data dari node: 
    rm -rf /opt/apigee/data/apigee-cassandra

  6. Download dan jalankan bootstrap Edge untuk Private Cloud versi lama yang ingin Anda rollback:

    Contoh: Untuk melakukan rollback ke 4.52.01

  7. 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’
  8. Jalankan bootstrap 4.52.01: 
    sudo bash /tmp/bootstrap_4.52.01.sh apigeeuser=uName apigeepassword=pWord
  9. Instal Software Cassandra di node: 
    apigee-service apigee-cassandra install
  10. Tambahkan properti di bawah ini dalam file /opt/apigee/apigee-cassandra/source/conf/cassandra-env.sh. 
    JVM_OPTS="$JVM_OPTS -Dcassandra.replace_address=<cass_ip-address>"

    Contoh: 

    JVM_OPTS="$JVM_OPTS -Dcassandra.replace_address=10.0.0.1"

  11. Siapkan Cassandra di node: 
    /opt/apigee/apigee-setup/bin/setup.sh -p c -f configFile
  12. Setelah Cassandra UP dan RUNNING, hapus CWC di atas dari file di bawah:file /opt/apigee/apigee-cassandra/source/conf/cassandra-env.sh.
  13. Mulai ulang node Cassandra 
    apigee-service apigee-cassandra restart
  14. Jalankan build ulang di node dengan memberikan nama pusat data fungsional: 
    /opt/apigee/apigee-cassandra/bin/nodetool rebuild -h <node-IP> <functional-dc>

    Contoh: 

    /opt/apigee/apigee-cassandra/bin/nodetool rebuild -h 10.0.0.1 dc-2

  15. Ulangi langkah-langkah di atas pada setiap node yang ingin Anda rollback di pusat data, satu per satu.

Setelah semua node Cassandra di pusat data di-roll back dan dibuat ulang

  1. Jalankan penyiapan node server pengelolaan di pusat data yang di-roll back. Pastikan server pengelolaan berasal dari versi yang di-roll back. Jika tidak, rollback server pengelolaan juga.

    2. Melakukan rollback server pengelolaan ke versi lama

  2. Hentikan server pengelolaan: 
    /opt/apigee/apigee-service/bin/apigee-service edge-management-server stop
  3. Jika Anda menggunakan monetisasi, uninstal juga monetisasi: 
    /opt/apigee/apigee-service/bin/apigee-service edge-mint-gateway uninstall
  4. Uninstal edge-gateway dan apigee-cassandra-client: 
    /opt/apigee/apigee-service/bin/apigee-service edge-gateway uninstall
     
    /opt/apigee/apigee-service/bin/apigee-service apigee-cassandra-client uninstall
  5. Download dan jalankan bootstrap versi lama. Misalnya, jalankan langkah-langkah berikut untuk mendownload dan menjalankan 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

    6. Penyiapan server pengelolaan

  6. Jalankan penyiapan satu node server pengelolaan: 
    /opt/apigee/apigee-setup/bin/setup.sh -p mt -f configFile
  7. Setelah menyelesaikan langkah-langkah di atas, alihkan traffic kembali ke pusat data yang di-roll back.

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. Hal ini menghindari streaming lintas pusat data dan akan lebih cepat daripada mem-build ulang semua node dari pusat data 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-langkah di atas 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.
  3. 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 cadangan Cassandra.

  4. Setelah pencadangan dipulihkan, mulai layanan Cassandra di node: 
    /opt/apigee/apigee-service/bin/apigee-service apigee-cassandra start
  5. 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>

    Contoh: 

    /opt/apigee/apigee-cassandra/bin/nodetool -h 10.0.0.1 repair -dc dc-1

  6. Ulangi semua langkah di atas yang disebutkan di Langkah #2 pada setiap node yang ingin Anda perbaiki

Melakukan rollback Cassandra menggunakan pencadangan / 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.).

Prasyarat

  1. Anda sedang dalam proses mengupgrade Cassandra dari 2.1.X ke 3.11.X di pusat data terakhir dan mengalami masalah selama upgrade.
  2. Anda memiliki cadangan untuk node sebelum upgrade yang Anda rollback. Pencadangan dilakukan sebelum upgrade 2.1.X ke 3.11.X dicoba.

Langkah-langkah tingkat tinggi

  1. Pilih pusat data (diupgrade sebagian atau sepenuhnya) untuk melakukan rollback. Alihkan semua traffic runtime dari pusat data ini ke pusat data lain yang berfungsi penuh.
  2. Jika router dan pemroses pesan telah diupgrade, rollback semua node router dan pemroses pesan di pusat data, satu per satu
  3. Hentikan Cassandra di satu node, uninstal, dan bersihkan semua data terkait.
  4. Instal bootstrap versi sebelumnya dan siapkan Cassandra versi 2.1.x di node yang telah dibersihkan.
  5. Hentikan node Cassandra dan bersihkan semua data terkait.
  6. Pulihkan node Cassandra dari cadangan yang diambil sebelum upgrade.
  7. Ulangi langkah 3 hingga 6 untuk setiap node Cassandra yang tersisa di pusat data, satu node pada satu waktu.
  8. Jalankan kembali penyiapan Server Pengelolaan di pusat data.
  9. Lakukan pengujian untuk memvalidasi rollback. Setelah diverifikasi, alihkan traffic runtime kembali ke pusat data yang dipulihkan.
  10. Ulangi langkah-langkah di atas untuk pusat data lain yang memerlukan rollback, satu per satu.
  11. (Opsional) Jalankan perintah perbaikan di semua node Cassandra di semua pusat data jika ada inkonsistensi data di antara node tersebut.

Langkah-langkah mendetail untuk melakukan rollback Cassandra menggunakan pencadangan/snapshot VM

Mulai dengan 1 node cassandra di cluster

  1. Pastikan traffic dialihkan ke pusat data yang berfungsi sepenuhnya sebelum melanjutkan ke langkah berikutnya.
  2. Jika router dan pemroses pesan telah diupgrade, rollback semua node router dan pemroses pesan ke versi sebelumnya di pusat data, satu per satu.
  3. Hentikan Cassandra di node: 
    /opt/apigee/apigee-service/bin/apigee-service apigee-cassandra stop
  4. Uninstal software Cassandra dari node: 
    /opt/apigee/apigee-service/bin/apigee-service apigee-cassandra uninstall
  5. Hapus direktori data dari node: 
    rm -rf /opt/apigee/data/apigee-cassandra

  6. Download dan jalankan bootstrap Edge untuk Private Cloud versi lama yang ingin Anda rollback:

    Contoh: Untuk melakukan rollback ke 4.52.01

  7. 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’
  8. Jalankan bootstrap 4.52.01: 
    sudo bash /tmp/bootstrap_4.52.01.sh apigeeuser=uName apigeepassword=pWord
  9. Siapkan Cassandra di node: 
    /opt/apigee/apigee-setup/bin/setup.sh -p c -f configFile
  10. Hentikan Cassandra di node: 
    /opt/apigee/apigee-service/bin/apigee-service apigee-cassandra stop
  11. Hapus direktori data di node: 
    rm -rf /opt/apigee/data/apigee-cassandra/data
  12. Memulihkan cadangan: 
    /opt/apigee/apigee-service/bin/apigee-service apigee-cassandra restore backup_file
  13. Memulai layanan Cassandra di node 
    /opt/apigee/apigee-service/bin/apigee-service apigee-cassandra start
  14. Ulangi langkah-langkah di setiap node Cassandra satu per satu.
  15. Jalankan penyiapan node server pengelolaan di pusat data yang di-roll back. Pastikan server pengelolaan berasal dari versi yang di-roll back. Jika tidak, rollback server pengelolaan juga.
  16. Setelah menyelesaikan langkah-langkah di atas, alihkan traffic kembali ke pusat data yang di-roll back.
  17. (Opsional) Jalankan perintah perbaikan di semua node Cassandra di semua pusat data jika ada inkonsistensi data di antara node tersebut. 
    /opt/apigee/apigee-cassandra/bin/nodetool -h <node-IP> repair -pr

Melakukan rollback update Zookeeper 3.8.3

Jika Anda 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 roll back ke versi 4.52.01, lakukan roll back Zookeeper seperti Anda melakukan roll back software apa pun, seperti yang tercantum di bagian Melakukan roll back 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 roll back ke versi 4.52.01 atau 4.52.00, lakukan roll back Postgres seperti Anda melakukan roll back software apa pun, seperti yang tercantum di bagian Melakukan roll back 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
  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 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 mengembalikan komponen dengan kode umum di node, Anda harus meng-uninstal semuanya dengan meng-uninstal grup komponen edge-gateway dan apigee-cassandra-client, seperti yang ditunjukkan pada contoh berikut: 
      /opt/apigee/apigee-service/bin/apigee-service edge-gateway uninstall
       
      /opt/apigee/apigee-service/bin/apigee-service apigee-cassandra-client 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 component

    Contoh:

    yum --showduplicates list edge-ui
  2. Gunakan apigee-setup untuk menginstal komponen: 
    /opt/apigee/apigee-setup/bin/setup.sh -p component -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