Mengembalikan Apigee Edge 4.53.01

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

Anda dapat melakukan roll back Edge 4.53.01 ke salah satu versi rilis utama berikut:

  • Versi 4.53.00
  • Versi 4.52.02

Melakukan roll back versi melibatkan roll back setiap komponen yang mungkin telah Anda upgrade. Selain itu, berdasarkan versi yang Anda gunakan, Anda mungkin perlu mempertimbangkan langkah-langkah khusus sebelum melakukan roll back komponen software tertentu. Tabel berikut mencantumkan berbagai komponen software yang mungkin memerlukan langkah-langkah khusus selama rollback:

Rollback ke versi Pertimbangan khusus untuk software
4.53.00 Zookeeper, Postgres, LDAP
4.52.02 Zookeeper, Cassandra, Postgres, LDAP

Berikut adalah skenario saat Anda mungkin ingin melakukan rollback:

Melakukan roll back ke rilis utama atau rilis kecil sebelumnya. Misalnya, dari 4.53.01 ke 4.53.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.01 akan terlihat seperti di bawah ini:

  1. Rollback Qpid, komponen terkait analisis lainnya, dan Postgres.
  2. Melakukan rollback router dan pemroses pesan
  3. Rollback Cassandra, Zookeeper
  4. Mengembalikan server pengelolaan
  5. Mengembalikan LDAP

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

  • Melakukan rollback semua RMP satu per satu
  • Melakukan rollback seluruh cluster Cassandra menggunakan cadangan
  • 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

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.01, 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

Setel 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. Instal dan siapkan 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 layanan sedang 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 lainnya dalam cluster. Node harus melaporkan bahwa node berada dalam status "UN" (Aktif/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 awal Cassandra di pusat data, satu per satu.
  8. Ulangi langkah 3 hingga 6 di semua node Cassandra yang tersisa di pusat data, satu per satu.
  9. 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 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 mengalihkan kembali traffic proxy dan API pengelolaan ke pusat data tersebut.
  12. 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 rollback update Zookeeper 3.8.4

Rollback

Jika rollback diperlukan:

  1. Lakukan langkah-langkah rollback pada pengamat dan pengikut terlebih dahulu.
  2. Download dan jalankan bootstrap versi yang Anda roll back—baik 4.52.02 atau 4.53.00. Prosesnya kemungkinan akan bervariasi, bergantung pada apakah node memiliki koneksi internet eksternal atau Anda mengikuti penginstalan offline.
  3. Hentikan Zookeeper jika berjalan di node: 
      /opt/apigee/apigee-service/bin/apigee-service apigee-zookeeper stop
  4. Uninstal zookeeper yang ada: 
      /opt/apigee/apigee-service/bin/apigee-service apigee-zookeeper uninstall
  5. Instal Zookeeper seperti biasa: 
      /opt/apigee/apigee-setup/bin/setup.sh -p zk -f <silent-config-file>
  6. Setelah semua pengikut dan pengamat di-roll back, roll back node pemimpin dengan mengikuti langkah 2 hingga 5 di node pemimpin.
  7. Setelah semua node di-rollback, verifikasi kesehatan cluster dan pastikan ada node pemimpin di cluster.

Pulihkan cadangan

Lihat Memulihkan dari cadangan. Perhatikan bahwa cadangan Zookeeper yang diambil dari versi Edge untuk Private Cloud sebelumnya seperti 4.52.02 atau 4.53.00 harus kompatibel dengan versi Zookeeper di Edge untuk Private Cloud 4.53.01

Melakukan roll back update Postgres 17

Jika Anda mengupgrade ke 4.53.01 dari versi 4.52.02 atau 4.53.00, Anda harus mengembalikan update Postgres selain komponen Edge.

Untuk mengembalikan update Postgres saat mengupdate Postgres dalam konfigurasi master-standby:

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

Setelah Anda selesai melakukan rollback, node master lama tidak akan diperlukan lagi. 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 di node master lama dan node standby lama: 
    /opt/apigee/apigee-service/bin/apigee-all status

    Jika Postgres sedang berjalan, hentikan: 

    /opt/apigee/apigee-service/bin/apigee-service edge-postgres-server stop > /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql stop
  3. Jika sudah diinstal, mulai Qpid di node standby lama: 
    /opt/apigee/apigee-service/bin/apigee-service edge-qpid-server start
  4. Promosikan node standby baru sebagai master Postgres:
    1. Promosikan node standby baru menjadi master baru: 
      apigee-service apigee-postgresql promote-standby-to-master new_standby_IP

      Jika diminta, masukkan sandi Postgres untuk pengguna 'apigee', yang secara default adalah "postgres".

    2. Edit file konfigurasi yang Anda gunakan untuk menginstal Edge versi saat ini guna menentukan berikut ini: 
      # IP address of the new master:
PG_MASTER=new_standby_IP
# IP address of the old standby node
PG_STANDBY=old_standby_IP
    3. Konfigurasi master baru:
      /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql setup-replication-on-master -f configFile
  5. Jika Anda telah mengupgrade node standby lama ke versi yang lebih baru, Anda harus mendowngrade software Apigee di node standby lama terlebih dahulu. Jika Anda masih memiliki versi lama di node standby lama, Anda dapat melewati langkah ini dan melanjutkan ke langkah 6.
    1. Hentikan Postgres di node standby lama: 
      apigee-service apigee-postgresql stop
apigee-service edge-postgres-server stop
    2. Uninstal Postgres dari node standby lama: 
      apigee-service apigee-postgresql uninstall
apigee-service edge-postgres-server uninstall
    3. Hapus direktori data Postgres dari node standby lama: 
      cd /opt/apigee/data/apigee-postgresql/pgdata > rm -rf *
    4. Download dan jalankan bootstrap versi lama (untuk versi Apigee yang Anda kembalikan) di node standby lama. Langkah-langkah persisnya dapat bervariasi berdasarkan apakah Anda menggunakan penginstalan berbasis internet atau offline. Menjalankan bootstrap Apigee versi lama akan menyiapkan repositori yum dengan data Apigee versi lama.
    5. Siapkan komponen Postgres di node standby lama: 
      /opt/apigee/apigee-setup/bin/setup.sh -p ps -f configFile
    6. Periksa dan pastikan komponen Postgres di node standby lama telah di-roll back ke versi yang lebih lama: 
      apigee-service apigee-postgresql version
apigee-service edge-postgres-server version
  6. Bangun kembali node standby lama:
    1. Edit file konfigurasi yang Anda gunakan untuk menginstal Edge versi saat ini guna menentukan berikut ini: 
      # IP address of the new master:
PG_MASTER=new_standby_IP
# IP address of the old standby node
PG_STANDBY=old_standby_IP
    2. Hapus direktori data di node standby lama: 
      cd /opt/apigee/data/apigee-postgresql/pgdata > rm -rf *
    3. Mengonfigurasi ulang node standby lama agar 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 Postgres tidak berjalan, mulai:

      /opt/apigee/apigee-service/bin/apigee-service edge-postgres-server start
  7. Verifikasi bahwa node standby baru telah ditambahkan dengan melihat file /opt/apigee/apigee-postgresql/conf/pg_hba.conf di master baru.
  8. 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 di bagian consumer-groups. Perintah ini juga menampilkan UUID node standby dan master Postgres lama di kolom postgres-server, dan di kolom datastores. Anda akan melihat output dalam bentuk: 

    {
  "name" : "axgroup-001",
  "properties" : {
  },
  "scopes" : [ "VALIDATE~test", "sgilson~prod" ],
  "uuids" : {
    "qpid-server" : [ "8381a053-433f-4382-bd2a-100fd37a1592", "4b6856ec-ef05-498f-bac6-ef5f0d5f6521" ],
    "postgres-server" : [
      "ab1158bd-1d59-4e2a-9c95-24cc2cfa6edc:27f90844-efab-4b32-8a23-8f85cdc9a256"
    ]
  },
  "consumer-groups" : [ {
    "name" : "consumer-group-001",
    "consumers" : [ "8381a053-433f-4382-bd2a-100fd37a1592", "4b6856ec-ef05-498f-bac6-ef5f0d5f6521" ],
    "datastores" :
      [ "ab1158bd-1d59-4e2a-9c95-24cc2cfa6edc:27f90844-efab-4b32-8a23-8f85cdc9a256" ],
      "properties" : {     }
    }
  ],
  "data-processors" : {
  }
}
  9. Dapatkan alamat UUID 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:

    "type" : [ "postgres-server" ],
"uUID" : "599e8ebf-5d69-4ae4-aa71-154970a8ec75"
  10. Ulangi langkah sebelumnya untuk mendapatkan alamat IP node standby lama dan master baru.
  11. 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/masterUUID,standbyUUID" -v

    Dengan axgroup-001 dan consumer-group-001 adalah nama default grup analisis dan konsumen. masterUUID,standbyUUID memiliki urutan yang sama seperti yang muncul di atas saat Anda melihat informasi grup konsumen dan analisis saat ini di atas. Anda mungkin harus menentukannya sebagai standbyUUID,masterUUID.

    Properti datastores untuk consumer-groups sekarang harus kosong.

  12. 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-server" -v

    Properti postgres-server di bagian uuids sekarang harus kosong.

  13. Daftarkan node master dan standby PG baru dengan grup analytics dan konsumen:
    curl -u sysAdminEmail:password -X POST -H "Content-Type: application/json" -d ''
  "http://ms_IP:8080/v1/analytics/groups/ax/axgroup-001/servers?uuid=masterUUID,standbyUUID&type=postgres-server" -v
curl -u sysAdminEmail:password -X POST -H "Content-Type:application/json" -d ''
  "http://ms_IP:8080/v1/analytics/groups/ax/axgroup-001/consumer-groups/consumer-group-001/datastores?uuid=masterUUID,standbyUUID" -v
  14. Validasi grup analisis: 
    curl -u sysAdminEmail:password http://ms_IP:8080/v1/analytics/groups/ax

    Anda akan melihat UUID node master dan standby baru yang tercantum di grup analisis dan grup konsumen.

  15. Mulai ulang Server Pengelolaan Edge: 
    /opt/apigee/apigee-service/bin/apigee-service edge-management-server restart
  16. Mulai ulang semua server Qpid: 
    /opt/apigee/apigee-service/bin/apigee-service edge-qpid-server restart
  17. Mulai ulang semua server Postgres: 
    /opt/apigee/apigee-service/bin/apigee-service edge-postgres-server restart
  18. Verifikasi status replikasi dengan mengeluarkan skrip berikut di kedua server. Sistem harus menampilkan hasil yang identik di kedua server untuk memastikan replikasi berhasil:

    Di master baru, jalankan:

    /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql postgres-check-master

    Pastikan bahwa instance tersebut adalah master. Di node standby lama: 

    /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql postgres-check-standby

    Pastikan perangkat dalam mode standby.

  19. Ulangi langkah sebelumnya setelah membuat beberapa permintaan API untuk memastikan node disinkronkan.
  20. Nonaktifkan master Postgres lama menggunakan prosedur dalam Menonaktifkan node Postgres.

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

Melakukan rollback update LDAP 2.6

Bagian ini memberikan panduan langkah demi langkah yang komprehensif untuk melakukan roll back penginstalan LDAP ke versi LDAP sebelumnya. Rollback harus dilakukan di seluruh cluster LDAP dan hanya dapat dilakukan menggunakan cadangan LDAP pra-upgrade yang valid.

Tujuan utamanya adalah mengembalikan seluruh cluster LDAP ke status yang konsisten dari cadangan yang diketahui baik. Prosedur ini sama untuk semua skenario - server tunggal, aktif-aktif, dan aktif-pasif.

Prasyarat dan pertimbangan

  • Ketidakcocokan cadangan: Menggunakan cadangan dari versi LDAP 2.4 yang lebih lama yang Anda jalankan dengan Edge for Private Cloud 4.52.02 atau 4.53.00. Pencadangan ini harus dilakukan sebelum upgrade dicoba. Cadangan yang diambil setelah upgrade tidak kompatibel dan tidak dapat digunakan.
  • Periode nonaktif Management API: Selama rollback LDAP, Management API tidak akan tersedia, yang dapat memengaruhi tugas administratif. Pastikan untuk mematikan semua edge-management-server dan edge-ui sebelum melanjutkan pengembalian LDAP.
  • Risiko kehilangan data: Melanjutkan tanpa cadangan yang valid dan kompatibel berisiko menyebabkan kehilangan data yang tidak dapat dipulihkan.
  • Cadangan yang valid: Cadangan LDAP pra-upgrade yang valid diperlukan.

Prosedur rollback

  1. Pastikan untuk mematikan semua edge-management-server dan edge-ui sebelum melanjutkan upgrade LDAP. 
    apigee-service edge-management-server stop
apigee-service edge-ui stop
  2. Mencadangkan Data LDAP yang ada (Sebelum menghentikan LDAP)

    Dapatkan jumlah total catatan untuk referensi dari semua server LDAP. (Jumlah data harus sama di semua server LDAP)

          # Note: Replace 'YOUR_PASSWORD' with your current LDAP manager password. 
ldapsearch -o ldif-wrap=no -b "dc=apigee,dc=com" \ -D "cn=manager,dc=apigee,dc=com" -H ldap://:10389 -LLL -x -w 'YOUR_PASSWORD' | wc -l
  3. Menghentikan dan meng-uninstal LDAP 2.6 baru

    Hentikan layanan apigee-openldap dan hapus direktori konfigurasi dan datanya. Tindakan ini harus dilakukan di semua server LDAP, satu node dalam satu waktu di cluster untuk memastikan konsistensi.

    apigee-service apigee-openldap stop
apigee-service apigee-openldap uninstall
rm -rf /opt/apigee/data/apigee-openldap/*
  4. Menginstal versi lama LDAP 2.4
    • Menginstal versi LDAP lama: 
      /opt/apigee/apigee-setup/bin/setup.sh -p ld -f /opt/silent.conf
    • Validasi versi LDAP: 
      source ~/.bash_profile
ldapsearch -VV

#Expected output:
ldapsearch: @(#) $OpenLDAP: ldapsearch 2.4.46
    • Ulangi Langkah-Langkah di atas pada setiap node LDAP, satu per satu
  5. Membersihkan data residual

    Di semua server LDAP, hentikan layanan yang baru diinstal satu per satu dan bersihkan direktori datanya untuk bersiap melakukan pemulihan dari cadangan.

    apigee-service apigee-openldap stop
rm -rf /opt/apigee/data/apigee-openldap/*
  6. Memulihkan data LDAP

    Untuk penyiapan server tunggal, Anda dapat langsung melanjutkan ke langkah 5b. Untuk penyiapan multi-server, lanjutkan dengan langkah 5a.

    1. Mengidentifikasi server LDAP aktif

      Sebelum memulihkan data LDAP, identifikasi server (penyedia) yang aktif dengan menjalankan perintah ini.

      grep -i '^olcSyncrepl:' /opt/apigee/data/apigee-openldap/slapd.d/cn=config/olcDatabase*\ldif

* **Note**:
* If this command returns output, the server is a passive server. 
* If it returns no output, the server is the active server.
    2. Pulihkan data LDAP (Pastikan langkah 4 telah diselesaikan di semua server sebelum memulihkan.)
      • Di server LDAP tunggal dan aktif (ditentukan di Langkah 5a), pulihkan cadangan. 
        cd /opt/apigee/backup/openldap

# To restore a specific backup, provide the timestamp as shown below:
apigee-service apigee-openldap restore 2025.07.28,13.59.00
# Note: If no timestamp is provided, the latest available backup will be restored by default.
apigee-service apigee-openldap restore

# It is recommended to specify the backup explicitly to avoid restoring an unintended version.
      • Mulai layanan apigee-openldap. 
        apigee-service apigee-openldap start
  7. Mulai server LDAP yang tersisa

    Jika Anda memiliki penyiapan multi-server, di setiap server LDAP, mulai layanan:

    apigee-service apigee-openldap start
  8. Validasi akhir
    • Langkah terakhir adalah memverifikasi bahwa rollback berhasil dan data konsisten di seluruh cluster LDAP.
    • Jalankan perintah validasi di semua server LDAP. Jumlah data harus sama di semua server dan harus cocok dengan jumlah yang Anda ambil pada Langkah 1. 
      # Note: Replace 'YOUR_PASSWORD' with your current LDAP manager password.
ldapsearch -o ldif-wrap=no -b "dc=apigee,dc=com" \ -D "cn=manager,dc=apigee,dc=com" -H ldap://:10389 -LLL -x -w 'YOUR_PASSWORD' | wc -l
    • Setelah Anda mengonfirmasi bahwa data sudah benar dan konsisten, rollback LDAP Anda selesai. Sekarang Anda dapat melanjutkan dengan memulai edge-management-server, edge-ui, dan komponen dependen lainnya sesuai dengan prosedur upgrade standar organisasi Anda.

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
  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 dan apigee-cassandra-client, seperti yang ditunjukkan dalam 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 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.

    3. 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.01: 
    /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.

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