Melakukan rollback Apigee Edge 4.53.00

Jika Anda mengalami error selama update ke Edge 4.53.00, Anda dapat mengembalikan komponen yang menyebabkan error, lalu mencoba update lagi.

Anda dapat melakukan roll back Edge 4.53.00 ke versi rilis minor berikut:

  • Versi 4.52.02

Melakukan roll back versi melibatkan roll back setiap komponen yang mungkin telah Anda upgrade. Selain itu, Anda harus mempertimbangkan pertimbangan khusus saat mengembalikan Cassandra ke versi 4.52.02.

Ada dua skenario saat Anda mungkin ingin melakukan rollback:

  1. Melakukan roll back ke rilis utama atau rilis kecil sebelumnya. Misalnya, dari 4.53.00 ke 4.52.02.
  2. Roll back ke rilis patch sebelumnya dalam rilis yang sama. Misalnya, dari 4.53.00.01 ke 4.53.00.00.

Untuk mengetahui informasi selengkapnya, lihat Proses rilis Apigee Edge.

Urutan rollback

Rollback komponen harus dilakukan dalam urutan terbalik dari saat komponen diupgrade, kecuali server pengelolaan yang harus di-roll back setelah Cassandra.

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

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

Misalnya, Anda telah mengupgrade seluruh cluster Cassandra, semua server pengelolaan, dan beberapa RMP ke versi 4.53.00 dari versi 4.52.02 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. Mengembalikan 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 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 lain.

Komponen dengan kode umum

Komponen Edge berikut berbagi kode umum. Oleh karena itu, untuk mengembalikan salah satu komponen ini di node, Anda harus mengembalikan 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 (Qpid Server)

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

Rollback Cassandra

Rollback Cassandra

Saat upgrade besar Cassandra dilakukan pada node tertentu, Cassandra akan mengubah skema data yang disimpan di node tersebut. Akibatnya, rollback langsung di tempat tidak dapat dilakukan.

Skenario rollback

Cassandra 4.0.X, yang tersedia dengan Edge untuk Private Cloud 4.53.00, kompatibel dengan komponen lain dari Private Cloud 4.52.02.

Lihat tabel di bawah untuk mengetahui ringkasan berbagai strategi rollback yang dapat Anda gunakan:

Skenario Strategi rollback
DC tunggal, beberapa node Cassandra diupgrade Menggunakan cadangan
DC tunggal, semua node Cassandra diupgrade Jangan rollback Cassandra. Komponen lain dapat di-roll back.
DC tunggal, semua node (Cassandra dan lainnya) diupgrade Jangan rollback Cassandra. Komponen lain dapat di-roll back.
Beberapa DC, beberapa node di satu DC diupgrade Membangun ulang dari DC yang ada
Beberapa DC, semua node Cassandra di beberapa DC diupgrade Membangun ulang dari DC yang ada
Beberapa DC, node Cassandra dari DC terakhir yang diupgrade Coba selesaikan upgrade. Jika tidak memungkinkan, lakukan rollback 1 DC menggunakan cadangan. Bangun ulang DC yang tersisa dari DC yang di-roll back.
Beberapa DC, semua node Cassandra diupgrade Jangan rollback Cassandra. Komponen lain dapat di-roll back.
Beberapa DC, semua node (Cassandra dan lainnya) diupgrade Jangan rollback Cassandra. Komponen lain dapat di-roll back.

Pertimbangan umum

Saat mempertimbangkan pengembalian ke versi sebelumnya, perhatikan hal-hal berikut:

  • Rollback komponen runtime atau pengelolaan: Jika Anda ingin melakukan rollback komponen seperti edge-management-server, edge-message-processor, atau komponen non-Cassandra ke Private Cloud versi 4.52.02, sebaiknya JANGAN melakukan rollback Cassandra. Cassandra yang disertakan dengan Private Cloud 4.53.00 kompatibel dengan semua komponen non-Cassandra Edge untuk Private Cloud 4.52.02. Anda dapat mengembalikan komponen non-Cassandra menggunakan metodologi yang tercantum di sini, sementara Cassandra tetap menggunakan versi 4.0.13.
  • Rollback setelah seluruh cluster Cassandra diupgrade ke 4.0.X: Jika seluruh cluster Cassandra Anda diupgrade ke versi 4.0.X sebagai bagian dari upgrade ke Private Cloud versi 4.53.00, sebaiknya Anda melanjutkan penyiapan cluster ini dan TIDAK melakukan rollback Cassandra. Komponen seperti edge-management-server, edge-message-processor, edge-router, dll., dari Private Cloud versi 4.52.02 kompatibel dengan Cassandra versi 4.0.X.
  • Rollback Cassandra selama upgrade Cassandra: Jika Anda mengalami masalah selama upgrade Cassandra, Anda dapat mempertimbangkan rollback. Strategi rollback yang tercantum dalam artikel ini dapat diikuti berdasarkan status Anda selama proses upgrade.
  • Rollback menggunakan cadangan: Cadangan yang diambil dari Cassandra 4.0.X tidak kompatibel dengan cadangan Cassandra 3.11.X. Untuk mengembalikan Cassandra menggunakan pemulihan cadangan, Anda harus mencadangkan Cassandra 3.11.X sebelum mencoba upgrade.

Melakukan rollback Cassandra menggunakan pembangunan ulang

Prasyarat

  • Anda mengoperasikan cluster Edge untuk Private Cloud 4.52.02 di beberapa pusat data.
  • Anda sedang dalam proses mengupgrade Cassandra dari 3.11.X ke 4.0.X dan mengalami masalah selama upgrade.
  • Anda memiliki minimal satu pusat data yang berfungsi penuh di cluster yang masih menjalankan Cassandra versi lama (Cassandra 3.11.X).

Prosedur ini mengandalkan data streaming dari pusat data yang ada. Proses ini dapat memakan waktu yang cukup lama, bergantung pada jumlah data yang disimpan di Cassandra. Anda harus siap mengalihkan traffic runtime dari pusat data ini saat rollback sedang berlangsung.

Langkah-langkah tingkat tinggi

  1. Pilih satu pusat data (yang diupgrade sebagian atau sepenuhnya) yang ingin Anda kembalikan. Alihkan traffic runtime ke pusat data lain yang berfungsi.
  2. Identifikasi node awal di pusat data dan mulai dengan salah satu node awal.
  3. Hentikan, uninstal, dan bersihkan node Cassandra.
  4. Instal Cassandra versi lama di node dan konfigurasikan sesuai kebutuhan.
  5. Hapus konfigurasi tambahan yang ditambahkan sebelumnya.
  6. Ulangi langkah-langkah di atas untuk semua node awal di pusat data, satu per satu.
  7. Ulangi langkah-langkah di atas untuk semua node Cassandra yang tersisa di pusat data, satu per satu.
  8. Bangun ulang node dari pusat data fungsional yang ada, satu per satu.
  9. Mulai ulang semua komponen edge-* di pusat data yang terhubung ke Cassandra.
  10. Uji dan alihkan traffic kembali ke pusat data ini.
  11. Ulangi langkah-langkah tersebut untuk setiap pusat data, satu per satu.

Langkah-langkah mendetail

  1. Pilih satu pusat data tempat semua atau beberapa node Cassandra diupgrade. Alihkan semua traffic proxy runtime dan traffic pengelolaan dari pusat data ini saat node Cassandra di pusat data ini di-roll back. Pastikan semua node Cassandra dalam status UN (Up/Normal) saat perintah nodetool ring dieksekusi di node. Jika node tertentu tidak berfungsi, pecahkan masalahnya dan aktifkan kembali node tersebut sebelum melanjutkan.

    Lihat contoh di bawah:

    /opt/apigee/apigee-cassandra/bin/nodetool status
Datacenter: dc-1
================
Status=Up/Down
|/ State=Normal/Leaving/Joining/Moving
--  Address      Load       Tokens       Owns (effective)  Host ID                               Rack
UN  DC1-1IP1  456.41 KiB  1            100.0%            78fc4ddd-2ed9-4a8c-98a2-63a38c2f1920  ra-1
UN  DC1-1IP2  870.93 KiB  1            100.0%            160db01a-64ab-43a7-b9ea-3b7f8f66d52b  ra-1
UN  DC1-1IP3  824.08 KiB  1            100.0%            21d61543-d59e-403a-bf5d-bfe7f664baa6  ra-1
Datacenter: dc-2
================
Status=Up/Down
|/ State=Normal/Leaving/Joining/Moving
--  Address      Load       Tokens       Owns (effective)  Host ID                               Rack
UN  DC2-1IP1   802.08 KiB  1            100.0%            583e0576-336d-4ce7-9729-2ae74e0abde2  ra-1
UN  DC2-1IP2   844.4 KiB   1            100.0%            fef794d5-f4c2-4a4e-bb05-9adaeb4aea4b  ra-1
UN  DC2-1IP3   878.12 KiB  1            100.0%            3894b3d9-1f5a-444d-83db-7b1e338bbfc9  ra-1

    Anda dapat menjalankan nodetool describecluster di node untuk memahami status seluruh cluster saat ini. Misalnya, berikut menunjukkan instance cluster 2 pusat data dengan semua node DC-1 menggunakan Cassandra versi 4, sedangkan semua node DC-2 menggunakan Cassandra versi 3:

    # On nodes where Cassandra is upgraded
/opt/apigee/apigee-cassandra/bin/nodetool describecluster
Cluster Information:
    Name: Apigee
    Snitch: org.apache.cassandra.locator.PropertyFileSnitch
    DynamicEndPointSnitch: enabled
    Partitioner: org.apache.cassandra.dht.RandomPartitioner
    Schema versions:
        2eadcd74-0245-309a-9992-3625afa70038: [DC-1-IP1, DC-1-IP2, DC-1-IP3]
        129dc15e-198e-3c11-b64c-701044a3a1ad: [DC-2-IP1, DC-2-IP2, DC-2-IP3]

Stats for all nodes:
    Live: 6
    Joining: 0
    Moving: 0
    Leaving: 0
    Unreachable: 0

Data Centers:
    dc-1 #Nodes: 3 #Down: 0
    dc-2 #Nodes: 3 #Down: 0

Database versions:
    4.0.13: [DC-1-IP1:7000, DC-1-IP2:7000, DC-1-IP3:7000]
    3.11.16: [DC-2-IP1:7000, DC-2-IP2:7000, DC-2-IP3:7000]

Keyspaces:
    system_schema -> Replication class: LocalStrategy {}
    system -> Replication class: LocalStrategy {}
    auth -> Replication class: NetworkTopologyStrategy {dc-2=3, dc-1=3}
    cache -> Replication class: NetworkTopologyStrategy {dc-2=3, dc-1=3}
    devconnect -> Replication class: NetworkTopologyStrategy {dc-2=3, dc-1=3}
    dek -> Replication class: NetworkTopologyStrategy {dc-2=3, dc-1=3}
    user_settings -> Replication class: NetworkTopologyStrategy {dc-2=3, dc-1=3}
    apprepo -> Replication class: NetworkTopologyStrategy {dc-2=3, dc-1=3}
    kms -> Replication class: NetworkTopologyStrategy {dc-2=3, dc-1=3}
    identityzone -> Replication class: NetworkTopologyStrategy {dc-2=3, dc-1=3}
    audit -> Replication class: NetworkTopologyStrategy {dc-2=3, dc-1=3}
    analytics -> Replication class: NetworkTopologyStrategy {dc-2=3, dc-1=3}
    keyvaluemap -> Replication class: NetworkTopologyStrategy {dc-2=3, dc-1=3}
    counter -> Replication class: NetworkTopologyStrategy {dc-2=3, dc-1=3}
    apimodel_v2 -> Replication class: NetworkTopologyStrategy {dc-2=3, dc-1=3}
    system_distributed -> Replication class: SimpleStrategy {replication_factor=3}
    system_traces -> Replication class: SimpleStrategy {replication_factor=2}
    system_auth -> Replication class: SimpleStrategy {replication_factor=1}

# On nodes where Cassandra is not upgraded
/opt/apigee/apigee-cassandra/bin/nodetool describecluster
Cluster Information:
    Name: Apigee
    Snitch: org.apache.cassandra.locator.PropertyFileSnitch
    DynamicEndPointSnitch: enabled
    Partitioner: org.apache.cassandra.dht.RandomPartitioner
    Schema versions:
        2eadcd74-0245-309a-9992-3625afa70038: [DC-1-IP1, DC-1-IP2, DC-1-IP3]
        129dc15e-198e-3c11-b64c-701044a3a1ad: [DC-2-IP1, DC-2-IP2, DC-2-IP3]
  2. Identifikasi node awal di pusat data: Lihat bagian Cara mengidentifikasi node awal di Lampiran. Jalankan langkah-langkah di bawah pada salah satu node awal:
  3. Hentikan, uninstal, dan bersihkan data dari node Cassandra. Pilih node awal pertama di Cassandra versi 4 di pusat data ini. Hentikan. 
    # Stop Cassandra service on the node
/opt/apigee/apigee-service/bin/apigee-service apigee-cassandra stop

# Uninstall Cassandra software
/opt/apigee/apigee-service/bin/apigee-service apigee-cassandra uninstall

# Wipe out Cassandra data
rm -rf /opt/apigee/data/apigee-cassandra
  4. Instal software Cassandra yang lebih lama di node dan tetapkan beberapa konfigurasi. Jalankan file bootstrap Edge untuk Private Cloud 4.52.02. 
    5. # Download bootstrap of 4.52.02
curl https://software.apigee.com/bootstrap_4.52.02.sh -o /tmp/bootstrap_4.52.02.sh -u uName:pWord

# Execute bootstrap of 4.52.02
sudo bash /tmp/bootstrap_4.52.02.sh apigeeuser=uName apigeepassword=pWord
  5. Buat atau edit file /opt/apigee/customer/application/cassandra.properties.
  6. Tambahkan konten berikut ke file. ipOfNode adalah alamat IP node yang digunakan Cassandra untuk berkomunikasi dengan node Cassandra lainnya: 
    conf_jvm_options_custom_settings=-Dcassandra.replace_address=ipOfNode -Dcassandra.allow_unsafe_replace=true
  7. Pastikan file dimiliki dan dapat dibaca oleh pengguna apigee: 
    chown apigee:apigee /opt/apigee/customer/application/cassandra.properties
  8. Instal dan siapkan Cassandra: 
    # Install cassandra version 3.11.X
/opt/apigee/apigee-service/bin/apigee-service apigee-cassandra install

# Setup cassandra while passing standard configuration file
/opt/apigee/apigee-service/bin/apigee-service apigee-cassandra setup -f configFile
# Ensure Cassandra version is correct and service is running
/opt/apigee/apigee-service/bin/apigee-service apigee-cassandra version
/opt/apigee/apigee-service/bin/apigee-service apigee-cassandra status
  9. Pastikan node telah dimulai. Periksa perintah berikut di node ini dan node lainnya dalam cluster. Node harus melaporkan bahwa node berada dalam status "UN" (Aktif/Normal): 
    /opt/apigee/apigee-cassandra/bin/nodetool status
  10. Hapus konfigurasi tambahan yang ditambahkan sebelumnya dari file /opt/apigee/customer/application/cassandra.properties.
  11. Ulangi langkah 3 hingga 10 di semua node awal Cassandra di pusat data, satu per satu.
  12. Ulangi langkah 3 hingga 10 di semua node Cassandra yang tersisa di pusat data, satu per satu.
  13. Bangun ulang semua node di pusat data dari pusat data yang menjalankan Cassandra versi lama. Lakukan langkah ini satu node dalam satu waktu: 
    /opt/apigee/apigee-cassandra/bin/nodetool rebuild -dc <name of working DC>

    Prosedur ini mungkin memerlukan waktu. Anda dapat menyesuaikan streamingthroughput jika diperlukan. Periksa nodetool netstats untuk mengetahui status penyelesaian operasi.

  14. (Opsional) Jalankan perintah perbaikan di node Cassandra jika data tidak dibangun ulang. 
    /opt/apigee/apigee-cassandra/bin/nodetool -h node-IP repair -pr
  15. Mulai ulang semua komponen edge-* di pusat data, satu per satu: 
    /opt/apigee/apigee-service/bin/apigee-service edge-message-processor restart
/opt/apigee/apigee-service/bin/apigee-service edge-router restart
/opt/apigee/apigee-service/bin/apigee-service edge-management-server restart
/opt/apigee/apigee-service/bin/apigee-service edge-qpid-server restart
/opt/apigee/apigee-service/bin/apigee-service edge-postgres-server restart
  16. Validasi dan alihkan traffic kembali ke pusat data ini. Jalankan beberapa validasi untuk traffic runtime dan API pengelolaan di pusat data ini, lalu mulai mengalihkan kembali traffic proxy dan API pengelolaan ke pusat data tersebut.
  17. Ulangi langkah-langkah di atas untuk setiap pusat data yang ingin Anda kembalikan.

Melakukan rollback Cassandra menggunakan Cadangan

Prasyarat

  1. Anda sedang dalam proses mengupgrade Cassandra dari 3.11.X ke 4.0.X dan mengalami masalah selama upgrade.
  2. Anda memiliki cadangan untuk node yang Anda kembalikan. Pencadangan dilakukan sebelum upgrade dari 3.11.X ke 4.0.X dicoba.

Langkah

  1. Pilih satu node yang ingin Anda kembalikan. Jika Anda memulihkan semua node di pusat data menggunakan cadangan, mulailah dengan node awal terlebih dahulu. Lihat bagian "Cara Mengidentifikasi Node Awal" di Lampiran.

  2. Hentikan, uninstal, dan bersihkan node Cassandra:

    # Stop Cassandra service on the node
/opt/apigee/apigee-service/bin/apigee-service apigee-cassandra stop

# Uninstall Cassandra software
/opt/apigee/apigee-service/bin/apigee-service apigee-cassandra uninstall

# Wipe Cassandra data
rm -rf /opt/apigee/data/apigee-cassandra

  3. Instal software Cassandra yang lebih lama di node dan konfigurasikan:

    • Jalankan file bootstrap untuk Edge for Private Cloud 4.52.02:
      • # Download bootstrap for 4.52.02
curl https://software.apigee.com/bootstrap_4.52.02.sh -o /tmp/bootstrap_4.52.02.sh -u ‘uName:pWord’

# Execute bootstrap for 4.52.02
sudo bash /tmp/bootstrap_4.52.02.sh apigeeuser=uName apigeepassword=pWord
    • Buat atau edit file /opt/apigee/customer/application/cassandra.properties:
      • conf_jvm_options_custom_settings=-Dcassandra.replace_address=ipOfNode -Dcassandra.allow_unsafe_replace=true
    • Pastikan file dimiliki oleh pengguna apigee dan dapat dibaca:
      • chown apigee:apigee /opt/apigee/customer/application/cassandra.properties
    • Instal dan siapkan Cassandra:
      • # Install Cassandra version 3.11.X
/opt/apigee/apigee-service/bin/apigee-service apigee-cassandra install

# Set up Cassandra with the standard configuration file
/opt/apigee/apigee-service/bin/apigee-service apigee-cassandra setup -f configFile

# Verify Cassandra version and check service status
/opt/apigee/apigee-service/bin/apigee-service apigee-cassandra version
/opt/apigee/apigee-service/bin/apigee-service apigee-cassandra status

    Pastikan node telah dimulai. Periksa perintah berikut di node ini dan node lainnya dalam cluster. Node harus melaporkan bahwa node ini dalam status "UN":

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

  4. Hentikan layanan Cassandra dan pulihkan cadangan. Baca dokumentasi pencadangan dan pemulihan untuk mengetahui detail selengkapnya:

    # Stop Cassandra service on the node
/opt/apigee/apigee-service/bin/apigee-service apigee-cassandra stop

# Wipe the data directory in preparation for restore
rm -rf /opt/apigee/data/apigee-cassandra/data

# Restore the backup taken before the upgrade attempt
/opt/apigee/apigee-service/bin/apigee-service apigee-cassandra restore backupFile

  5. Setelah cadangan dipulihkan, hapus konfigurasi tambahan:

    Hapus konfigurasi yang ditambahkan sebelumnya dari file /opt/apigee/customer/application/cassandra.properties.

  6. Mulai layanan Cassandra di node:

    /opt/apigee/apigee-service/bin/apigee-service apigee-cassandra start

  7. Ulangi langkah-langkah di setiap node Cassandra yang ingin Anda kembalikan menggunakan cadangan, satu per satu.

  8. Setelah semua node Cassandra dipulihkan, mulai ulang semua komponen edge-* satu per satu:

    /opt/apigee/apigee-service/bin/apigee-service edge-message-processor restart
/opt/apigee/apigee-service/bin/apigee-service edge-router restart
/opt/apigee/apigee-service/bin/apigee-service edge-management-server restart
/opt/apigee/apigee-service/bin/apigee-service edge-qpid-server restart
/opt/apigee/apigee-service/bin/apigee-service edge-postgres-server restart

Pengoptimalan pencadangan (opsi lanjutan)

Anda berpotensi meminimalkan (atau menghilangkan) kehilangan data saat memulihkan cadangan jika Anda memiliki replika yang berisi data terbaru. Jika replika tersedia, setelah memulihkan cadangan, jalankan perbaikan pada node yang dipulihkan.

Lampiran

Cara mengidentifikasi node awal

Di node Cassandra mana pun di pusat data, jalankan perintah berikut:

/opt/apigee/apigee-service/bin/apigee-service apigee-cassandra configure -search conf_cassandra_seeds

Perintah akan menampilkan beberapa baris. Cari baris terakhir output. Alamat IP yang tercantum di baris terakhir adalah node awal. Pada contoh di bawah, DC-1-IP1, DC-1-IP2, DC-2-IP1, dan DC-2-IP2 adalah IP node awal:

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, "DC-1-IP1, DC-1-IP2, DC-2-IP1, DC-2-IP2", in /opt/apigee/token/application/cassandra.properties
apigee-configutil: apigee-cassandra: # OK

Melakukan roll back ke rilis utama atau rilis kecil sebelumnya

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

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

    • Untuk melakukan roll back ke 4.52.02, download bootstrap_4.52.02.sh: 
      curl https://software.apigee.com/bootstrap_4.52.02.sh -o /tmp/bootstrap_4.52.02.sh
  2. Hentikan komponen untuk melakukan roll back:
    1. Untuk mengembalikan komponen dengan kode umum di node, Anda harus menghentikan semuanya, seperti yang ditunjukkan 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 mengembalikan komponen lainnya di node, hentikan komponen tersebut: 
      /opt/apigee/apigee-service/bin/apigee-service component stop
  3. Jika Anda melakukan rollback 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 pada node:
    1. Untuk mengembalikan komponen dengan kode umum di node, Anda harus menghapus semua komponen tersebut dengan menghapus grup komponen edge-gateway, seperti yang ditunjukkan contoh berikut: 
      /opt/apigee/apigee-service/bin/apigee-service edge-gateway uninstall
    2. Untuk melakukan rollback Nginx seperti di bawah ini: 
      ###Find the apigee-nginx RPM 
rpm -qa | grep -i "apigee-nginx"

###Remove the apigee-nginx RPM
dnf remove apigee-nginx-1.26.x
    3. Untuk mengembalikan komponen lain di node, hapus instalasi komponen tersebut saja, seperti yang ditunjukkan dalam contoh berikut: 
      /opt/apigee/apigee-service/bin/apigee-service component uninstall

      Dengan component adalah nama komponen.

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

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

    Jika Anda mendapatkan error, pastikan Anda mendownload file bootstrap.sh pada 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 untuk versi yang lebih lama.

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

Melakukan roll back ke rilis patch sebelumnya

Untuk mengembalikan 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. Contoh:

    /opt/apigee/apigee-service/bin/apigee-service edge-ui-4.53.00-0.0.20254 install

    Jika menggunakan repo online Apigee, Anda dapat menentukan versi komponen yang tersedia dengan 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 kembalikan.

Membatalkan mTLS

Untuk melakukan roll back 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