Melakukan rollback Apigee Edge 4.53.00

Jika mengalami error selama update ke Edge 4.53.00, Anda dapat melakukan rollback 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

Me-roll back versi melibatkan me-roll back setiap komponen yang mungkin telah Anda upgrade. Selain itu, Anda harus mempertimbangkan pertimbangan khusus saat melakukan rollback Cassandra ke versi 4.52.02.

Ada dua skenario saat Anda mungkin ingin melakukan rollback:

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

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.53.00 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.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. 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

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 for 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
Satu DC, beberapa node Cassandra diupgrade Menggunakan cadangan
Satu DC, semua node Cassandra diupgrade Jangan melakukan rollback Cassandra. Komponen lain dapat di-roll back.
Satu DC, semua node (Cassandra dan lainnya) diupgrade Jangan melakukan rollback Cassandra. Komponen lain dapat di-roll back.
Beberapa DC, beberapa node di satu DC diupgrade Mem-build ulang dari DC yang ada
Beberapa DC, semua node Cassandra di beberapa DC diupgrade Mem-build ulang dari DC yang ada
Beberapa DC, node Cassandra dari DC terakhir yang diupgrade Coba selesaikan upgrade. Jika tidak memungkinkan, rollback 1 DC menggunakan cadangan. Buat ulang DC yang tersisa dari DC yang di-roll back.
Beberapa DC, semua node Cassandra diupgrade Jangan melakukan rollback Cassandra. Komponen lain dapat di-roll back.
Beberapa DC, semua node (Cassandra dan lainnya) diupgrade Jangan melakukan rollback Cassandra. Komponen lain dapat di-roll back.

Pertimbangan umum

Saat mempertimbangkan rollback, 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 rollback Cassandra. Cassandra yang dikirimkan dengan Private Cloud 4.53.00 kompatibel dengan semua komponen non-Cassandra Edge untuk Private Cloud 4.52.02. Anda dapat melakukan rollback komponen non-Cassandra menggunakan metodologi yang tercantum di sini saat 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 lanjutkan penyiapan cluster ini dan JANGAN rollback Cassandra. Komponen seperti edge-management-server, edge-message-processor, edge-router, dll., dari Cloud Pribadi versi 4.52.02 kompatibel dengan Cassandra versi 4.0.X.
  • Rollback Cassandra selama upgrade Cassandra: Jika mengalami masalah selama upgrade Cassandra, sebaiknya pertimbangkan untuk melakukan rollback. Strategi rollback yang tercantum dalam artikel ini dapat diikuti berdasarkan status Anda selama proses upgrade.
  • Rollback menggunakan pencadangan: Pencadangan yang diambil dari Cassandra 4.0.X tidak kompatibel dengan pencadangan Cassandra 3.11.X. Untuk melakukan rollback Cassandra menggunakan pemulihan cadangan, Anda harus membuat cadangan Cassandra 3.11.X sebelum mencoba upgrade.

Melakukan rollback Cassandra menggunakan rebuild

Prasyarat

  • Anda mengoperasikan cluster Edge for 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 streaming data dari pusat data yang ada. Proses ini dapat memerlukan waktu yang cukup lama, bergantung pada jumlah data yang disimpan di Cassandra. Anda harus siap untuk mengalihkan traffic runtime dari pusat data ini saat rollback sedang berlangsung.

Langkah-langkah tingkat tinggi

  1. Pilih satu pusat data (diupgrade sebagian atau sepenuhnya) yang ingin Anda rollback. Alihkan traffic runtime ke pusat data lain yang berfungsi.
  2. Identifikasi node seed di pusat data dan mulai dengan salah satu node seed.
  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 seed 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. Buat 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 berada dalam status UN (Up/Normal) saat perintah nodetool ring dieksekusi di node. Jika node tertentu tidak aktif, 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, contoh 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. Mengidentifikasi node seed di pusat data: Lihat bagian Cara mengidentifikasi node seed di Lampiran. Jalankan langkah-langkah di bawah ini di salah satu node seed:
  3. Hentikan, uninstal, dan bersihkan data dari node Cassandra. Pilih node seed 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 for 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

Menetapkan konfigurasi Cassandra

  1. Buat atau edit file /opt/apigee/customer/application/cassandra.properties.
  2. 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
  3. Pastikan file dimiliki dan dapat dibaca oleh pengguna apigee: 
    chown apigee:apigee /opt/apigee/customer/application/cassandra.properties
  4. Menginstal dan menyiapkan Cassandra:
    • Instal Cassandra versi 3.11.X: 
      /opt/apigee/apigee-service/bin/apigee-service apigee-cassandra install
    • Siapkan Cassandra dengan meneruskan file konfigurasi standar: 
      /opt/apigee/apigee-service/bin/apigee-service apigee-cassandra setup -f configFile
    • Pastikan Cassandra 3.11.X telah diinstal dan layanannya berjalan: 
      /opt/apigee/apigee-service/bin/apigee-service apigee-cassandra version
      /opt/apigee/apigee-service/bin/apigee-service apigee-cassandra status
  5. Pastikan node telah dimulai. Periksa perintah berikut di node ini dan node lain di cluster. Node harus melaporkan bahwa node tersebut dalam status "UN" (Up/Normal): 
    /opt/apigee/apigee-cassandra/bin/nodetool status
  6. Hapus konfigurasi tambahan yang ditambahkan sebelumnya dari file /opt/apigee/customer/application/cassandra.properties.
  7. Ulangi langkah 3 hingga 6 di semua node seed Cassandra di pusat data, satu per satu.
  8. Ulangi langkah 3 hingga 6 pada semua node Cassandra yang tersisa di pusat data, satu per satu.
  9. Buat ulang semua node di pusat data dari pusat data yang menjalankan versi Cassandra yang lebih lama. Lakukan langkah ini satu node pada satu waktu: 
    /opt/apigee/apigee-cassandra/bin/nodetool rebuild -dc <name of working DC>
    Prosedur ini mungkin memerlukan waktu. Anda dapat menyesuaikan streamingthroughput jika perlu. Periksa status menggunakan: 
    /opt/apigee/apigee-cassandra/bin/nodetool netstats
  10. 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
  11. Validasi dan alihkan traffic kembali ke pusat data ini. Jalankan beberapa validasi untuk traffic runtime dan API pengelolaan di pusat data ini, lalu mulai alihkan traffic proxy dan API pengelolaan kembali ke pusat data tersebut.
  12. Ulangi langkah-langkah di atas untuk setiap pusat data yang ingin Anda rollback.

Melakukan rollback Cassandra menggunakan Pencadangan

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 rollback. Pencadangan dilakukan sebelum upgrade dari 3.11.X ke 4.0.X dicoba.

Langkah

  1. Pilih satu node yang ingin Anda rollback. Jika Anda melakukan rollback semua node di pusat data menggunakan cadangan, mulailah dengan node seed terlebih dahulu. Lihat bagian "Cara Mengidentifikasi Node Bibit" 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 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 lain di cluster. Node harus melaporkan bahwa node ini berada dalam status "UN":

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

  4. Hentikan layanan Cassandra dan pulihkan pencadangan. Lihat 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 pencadangan 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 rollback 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) hilangnya data saat memulihkan cadangan jika memiliki replika yang tersedia yang berisi data terbaru. Jika replika tersedia, setelah memulihkan cadangan, jalankan perbaikan pada node yang dipulihkan.

Lampiran

Cara mengidentifikasi node seed

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 ini akan menghasilkan beberapa baris. Cari baris terakhir output. Alamat IP yang tercantum di baris terakhir adalah node seed. Pada contoh di bawah, DC-1-IP1, DC-1-IP2, DC-2-IP1, dan DC-2-IP2 adalah IP node seed:

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 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.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 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 mengembalikan 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.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 apigee-service versi 4.52.02: 
    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 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.53.00-0.0.20254 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. Menghentikan 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