Google menggunakan teknologi AI untuk menerjemahkan konten ke dalam bahasa pilihan Anda. Terjemahan AI mungkin mengandung kesalahan.

Me-roll back Apigee Edge 4.54.00

Jika mengalami error selama update ke Edge 4.54.00, Anda dapat me-roll back komponen yang menyebabkan error, lalu mencoba update lagi.

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

Versi 4.53.00
Versi 4.53.01

Untuk mengetahui informasi selengkapnya, lihat Proses rilis Apigee Edge.

Urutan rollback

Rollback komponen harus dilakukan dalam urutan terbalik dari saat komponen di-upgrade. Urutan umum rollback untuk Private Cloud 4.54.00 akan terlihat seperti berikut:

Me-roll back Cassandra, Zookeeper.
Me-roll back Qpid, komponen terkait analisis lainnya, dan Postgres.
Mengembalikan UI
Roll back LDAP.
Melakukan roll back server pengelolaan.
Me-roll back router dan pemroses pesan.

Misalnya, Anda telah mengupgrade semua Router dan Message Processor, semua server pengelolaan, LDAP, dan beberapa node UI ke versi 4.54.00 dari versi 4.53.00 (atau) 4.53.01 dan ingin melakukan rollback. Dalam hal ini, Anda akan:

Me-roll back node UI yang diupgrade
Me-roll back node LDAP
Me-roll back node server Pengelolaan satu per satu
Me-roll back semua RMP satu per satu

Catatan: Apigee SSO di Apigee Edge for Private Cloud 4.54.00 tidak mendukung rollback langsung atau parsial. Untuk mengembalikan Apigee SSO, Anda harus melakukan roll back semua komponen yang telah diupgrade sebelumnya dan memulihkan apigee-sso menggunakan file konfigurasi otomatis dari versi sebelumnya.

Mulai ulang atau instal ulang apigee-sso:

Jika Anda hanya menghentikan apigee-sso selama upgrade, mulai ulang layanan.
Jika Anda meng-uninstal apigee-sso selama upgrade, instal ulang menggunakan file konfigurasi otomatis dari versi sebelumnya:
- 4.53.01 Langkah-langkah penginstalan
- 4.53.00 Langkah-langkah penginstalan

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 yang memiliki akses ke port tersebut. Atau, Anda dapat menjalankan satu komponen sebagai satu pengguna, dan komponen lain sebagai pengguna lain.

Me-roll back Cassandra

Saat upgrade utama 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

Tabel berikut merangkum strategi rollback yang dapat Anda gunakan:

Skenario	Strategi rollback
DC tunggal, beberapa node Cassandra diupgrade	Menggunakan cadangan
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, roll back 1 DC menggunakan cadangan. Membangun ulang DC yang tersisa dari DC yang di-roll back.

Pertimbangan umum

Saat mempertimbangkan rollback, perhatikan hal-hal berikut:

Rollback Cassandra selama upgrade Cassandra: Jika Anda mengalami masalah selama upgrade Cassandra, sebaiknya pertimbangkan rollback. Ikuti strategi rollback dalam artikel ini berdasarkan status Anda selama proses upgrade.
Rollback menggunakan cadangan: Cadangan yang diambil dari Cassandra 5.0.X tidak kompatibel dengan cadangan Cassandra 4.0.X. Untuk melakukan roll back Cassandra menggunakan pemulihan cadangan, Anda harus mencadangkan Cassandra 4.0.X sebelum mencoba upgrade.

Me-roll back Cassandra menggunakan rebuild

Prasyarat

Anda mengoperasikan cluster Edge for Private Cloud 4.53.00/4.53.01 di beberapa pusat data.
Anda sedang dalam proses mengupgrade Cassandra dari 4.0.X ke 5.0.X dan mengalami masalah selama upgrade.
Anda memiliki setidaknya satu pusat data yang berfungsi penuh di cluster yang masih menjalankan Cassandra versi lama (Cassandra 4.0.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 mengalihkan traffic runtime dari pusat data ini saat rollback sedang berlangsung.

Langkah-langkah tingkat tinggi

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

Langkah selengkapnya

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 dijalankan pada 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 pada 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:
    5.0.8: [DC-1-IP1:7000, DC-1-IP2:7000, DC-1-IP3:7000]
    4.0.13: [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]

Identifikasi node seed di pusat data: Lihat bagian Cara mengidentifikasi node seed di Lampiran. Jalankan langkah-langkah di bawah pada salah satu node awal:

Hentikan, uninstal, dan bersihkan data dari node Cassandra. Pilih node seed pertama di Cassandra versi 5 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

Instal software Cassandra yang lebih lama di node dan tetapkan beberapa konfigurasi. Jalankan file bootstrap Edge for Private Cloud 4.53.00/4.53.01.

# Download bootstrap of 4.53.00
curl https://software.apigee.com/bootstrap_4.53.00.sh -o /tmp/bootstrap_4.53.00.sh -u uName:pWord

# Execute bootstrap of 4.53.00
sudo bash /tmp/bootstrap_4.53.00.sh apigeeuser=uName apigeepassword=pWord

Buat atau edit file /opt/apigee/customer/application/cassandra.properties.
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
```

Pastikan file dimiliki dan dapat dibaca oleh pengguna apigee:

chown apigee:apigee /opt/apigee/customer/application/cassandra.properties

Instal dan siapkan Cassandra:

# Install cassandra version 4.0.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

Pastikan node telah dimulai. Periksa perintah berikut di node ini dan node lainnya dalam cluster. Node harus melaporkan bahwa node berada dalam status "UN" (Up/Normal):
```
/opt/apigee/apigee-cassandra/bin/nodetool status
```
Hapus konfigurasi tambahan yang ditambahkan sebelumnya dari file /opt/apigee/customer/application/cassandra.properties.
Ulangi langkah 3 hingga 10 pada semua node seed Cassandra di pusat data, satu per satu.
Ulangi langkah 3 hingga 10 pada semua node Cassandra yang tersisa di pusat data, satu per satu.
Bangun ulang semua node di pusat data dari pusat data yang menjalankan versi Cassandra yang lebih 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.
(Opsional) Jalankan perintah perbaikan di node Cassandra jika data tidak dibangun ulang.
```
/opt/apigee/apigee-cassandra/bin/nodetool -h node-IP repair -pr
```

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

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.
Ulangi langkah-langkah di atas untuk setiap pusat data yang ingin Anda rollback.

Me-roll back Cassandra menggunakan Pencadangan

Prasyarat

Anda sedang dalam proses mengupgrade Cassandra dari 4.0.X ke 5.0.X dan mengalami masalah selama upgrade.
Anda memiliki cadangan untuk node yang di-roll back. Cadangan diambil sebelum upgrade dari 4.0.X ke 5.0.X dicoba.

Langkah

Pilih satu node yang ingin di-roll back. Jika Anda melakukan rollback semua node di pusat data menggunakan cadangan, mulai dengan node awal terlebih dahulu. Lihat bagian Cara mengidentifikasi node seed di Lampiran.

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

Instal software Cassandra yang lebih lama di node dan konfigurasikan:

Jalankan file bootstrap untuk Edge for Private Cloud 4.53.00/4.53.01:

# Download bootstrap for 4.53.00
curl https://software.apigee.com/bootstrap_4.53.00.sh -o /tmp/bootstrap_4.53.00.sh -u uName:pWord

# Execute bootstrap for 4.53.00
sudo bash /tmp/bootstrap_4.53.00.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 4.0.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 pada node ini dan node lain dalam cluster. Node akan melaporkan bahwa node ini dalam status "UN":

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

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

Setelah cadangan dipulihkan, hapus konfigurasi tambahan:

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

Mulai layanan Cassandra di node:

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

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

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 seed

Pada 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 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

Me-roll back ZooKeeper

Rollback

Jika rollback diperlukan:

Lakukan langkah-langkah rollback pada observer dan follower terlebih dahulu. Lihat Mengidentifikasi pemimpin, pengikut, dan pengamat untuk memilih pengamat dan pengikut.
Download dan jalankan bootstrap versi yang Anda rollback—baik 4.53.00/4.53.01. Prosesnya kemungkinan akan bervariasi, bergantung pada apakah node memiliki koneksi internet eksternal atau Anda mengikuti penginstalan offline.

Hentikan Zookeeper jika berjalan di node:

  /opt/apigee/apigee-service/bin/apigee-service apigee-zookeeper stop

Uninstal zookeeper yang ada:

  /opt/apigee/apigee-service/bin/apigee-service apigee-zookeeper uninstall

Instal Zookeeper seperti biasa:

  /opt/apigee/apigee-setup/bin/setup.sh -p zk -f <silent-config-file>

Setelah semua pengikut dan pengamat di-roll back, roll back node pemimpin dengan mengikuti langkah 2 hingga 5 di node pemimpin.
Setelah semua node di-roll back, verifikasi kondisi cluster dan pastikan ada node leader di cluster.

Memulihkan cadangan

Lihat Memulihkan dari cadangan.

Me-roll back Qpid

Catatan: Roll back apigee-qpidd terlebih dahulu, sebelum Anda mencoba melakukan roll back komponen Edge lainnya (edge-qpid-server, edge-message-processor, edge-management-server).

Untuk melakukan roll back ke Rilis Fitur sebelumnya, pastikan untuk mendownload file bootstrap.sh untuk versi yang ingin Anda gunakan untuk melakukan roll back. Untuk mengembalikan ke v 4.53.00/4.53.01, download bootstrap_4.53.00.sh.

Untuk me-roll back Qpid, ikuti langkah-langkah berikut di semua host Qpid:

Hentikan broker Qpid yang ada:
```
apigee-service apigee-qpidd stop
```
Blokir traffic masuk di port broker 5672 dari semua pemroses pesan dengan menerapkan firewall. Anda dapat menerapkan firewall ini di tingkat instance node Qpid atau komponen jaringan/firewall eksternal lainnya.
Sebaiknya lakukan langkah yang sama untuk semua alamat IP pemroses pesan. Misalnya, untuk MENGHAPUS permintaan yang berasal dari alamat IP pemroses pesan ke node Qpid di port 5672 menggunakan IPTables, Anda dapat menggunakan perintah seperti ini:
```
iptables -A INPUT -p tcp --dport 5672 -s MESSAGE_PROCESSOR_IP -j DROP
```
Mulai broker Qpid lagi untuk menguras pesan yang ada jika ada:
```
apigee-service apigee-qpidd start
```
Pastikan antrean yang ada kosong. Untuk memeriksanya, login ke portal pengelolaan Qpid:
```
http://QPID_NODE_IP:8090
```
Catatan: Jika port 8090 di node QPID ini tidak dapat diakses, Anda dapat menggunakan mekanisme alternatif seperti penerusan port SSH untuk mengakses URL ini.

Setelah memverifikasi bahwa antrean telah dikosongkan, hentikan dan uninstal Qpid:

/opt/apigee/apigee-service/bin/apigee-service apigee-qpidd stop
/opt/apigee/apigee-service/bin/apigee-service apigee-qpidd uninstall

Hapus direktori data Qpid:
```
rm -r APIGEE_ROOT/data/apigee-qpidd
```

Instal ulang broker Qpid:

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

Setelah broker Qpid diinstal ulang, hapus setelan firewall dan cantumkan setelan yang ada menggunakan perintah berikut:
```
iptables -F
iptables -L
```

Me-roll back Postgres

Untuk melakukan downgrade dari versi 4.54.00 ke versi 4.53.00/4.53.01, Anda harus membatalkan 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.
Konfigurasikan node standby lama menjadi node standby master baru. Node standby lama akan memiliki versi yang sama dengan penginstalan Edge Anda sebelumnya.
Daftarkan node master dan standby baru ke grup analisis dan konsumen.

Setelah Anda selesai melakukan rollback, node master lama tidak akan diperlukan lagi. Kemudian, Anda dapat menonaktifkan node master lama.

Sebelum memulai

Sebelum melakukan rollback Postgres 18 ke 17/14, lakukan langkah-langkah berikut di host standby baru dan host standby lama, untuk memperbarui properti max_locks_per_transaction di apigee-postgresql:

Jika tidak ada, buat file /opt/apigee/customer/application/postgresql.properties.

Ubah kepemilikan file ini menjadi apigee:

sudo chown apigee:apigee /opt/apigee/customer/application/postgresql.properties

Tambahkan properti berikut ke file:

conf/postgresql.conf+max_locks_per_transaction=30000

Konfigurasikan apigee-postgresql:

apigee-service apigee-postgresql configure

Mulai ulang apigee-postgresql:

apigee-service apigee-postgresql restart

Prosedur rollback mendetail

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

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

Jika sudah diinstal, mulai Qpid di node standby lama:
```
/opt/apigee/apigee-service/bin/apigee-service edge-qpid-server start
```
Catatan: Dalam banyak konfigurasi, node standby lama hanya akan menghosting Postgres, bukan Qpid.
Promosikan node standby baru sebagai master Postgres:
1. Promosikan node standby baru menjadi master baru:
```
apigee-service apigee-postgresql promote-standby-to-master old_master_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. Konfigurasikan master baru:
```
/opt/apigee/apigee-service/bin/apigee-service apigee-postgresql setup-replication-on-master -f configFile
```
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
apigee-service edge-analytics 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 akan 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 bahwa 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
```

Catatan: Pastikan Anda menghapus RPM postgresql18-libs-18.3-1PGDG jika masih ada.

Bangun ulang node standby lama:

Edit file konfigurasi yang Anda gunakan untuk menginstal versi Edge saat ini guna menentukan hal berikut:

# IP address of the new master:
PG_MASTER=new_standby_IP
# IP address of the old standby node
PG_STANDBY=old_standby_IP

Hapus direktori data di node standby lama:

cd /opt/apigee/data/apigee-postgresql/pgdata
rm -rf *

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

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

Pastikan node standby baru telah ditambahkan dengan melihat file /opt/apigee/apigee-postgresql/conf/pg_hba.conf di master baru.

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. Tindakan ini juga menampilkan UUID node master dan standby 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" : {
  }
}

Dapatkan alamat UUID master lama dengan menjalankan perintah curl berikut pada 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"
```
Catatan: Layanan edge-postgres-server harus berjalan. Jika server Postgres tidak berjalan, Anda dapat menjalankan perintah berikut di Server Pengelolaan untuk menentukan UUID:
```
curl -u sysAdminEmail:password http://ms_IP:8080/v1/servers?pod=analytics
```
Output perintah ini mencantumkan UUID untuk alamat IP setiap node Postres.
Ulangi langkah sebelumnya untuk mendapatkan alamat IP node standby lama dan master baru.
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 berada dalam urutan yang sama seperti yang muncul di atas saat Anda melihat informasi analisis dan grup konsumen saat ini di atas. Anda mungkin harus menentukannya sebagai standbyUUID,masterUUID.

Properti datastores untuk consumer-groups sekarang seharusnya kosong.

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 akan kosong.

Daftarkan node master dan standby PG baru dengan grup analisis 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

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 dalam grup analisis dan grup konsumen.

Mulai ulang Server Pengelolaan Edge:

/opt/apigee/apigee-service/bin/apigee-service edge-management-server restart

Mulai ulang semua server Qpid:

/opt/apigee/apigee-service/bin/apigee-service edge-qpid-server restart

Mulai ulang semua server Postgres:

/opt/apigee/apigee-service/bin/apigee-service edge-postgres-server restart

Verifikasi status replikasi dengan menjalankan skrip berikut di kedua server. Sistem harus menampilkan hasil yang sama 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, jalankan:
```
/opt/apigee/apigee-service/bin/apigee-service apigee-postgresql postgres-check-standby
```
Pastikan bahwa instance tersebut adalah standby.
Ulangi langkah sebelumnya setelah membuat beberapa permintaan API untuk memastikan bahwa node telah disinkronkan.
Nonaktifkan master Postgres lama:
Catatan: Jika node master lama menjalankan Qpid, Anda dapat membiarkan server tersebut tetap aktif untuk menjalankan Qpid. Pastikan instance tersebut berjalan. Jika tidak, mulai:
```
/opt/apigee/apigee-service/bin/apigee-service edge-qpid-server start
/opt/apigee/apigee-service/bin/apigee-service apigee-qpidd start
```
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.

Roll back New Edge UI

Apigee Edge for Private Cloud 4.54.00 menggantikan UI Klasik (edge-ui) dengan UI Edge Baru (edge-management-ui). Karena komponen UI berubah di 4.54.00, melakukan roll back ke versi 4.53.00 atau 4.53.01 memerlukan uninstal edge-management-ui dan menginstal ulang profil UI sebelumnya:

UI Klasik (edge-ui): Instal ulang profil ui.
UI Edge Baru (edge-ui dan edge-management-ui): Instal ulang profil ui dan ue di node masing-masing.

Untuk me-roll back UI di node:

Hentikan dan uninstal UI Edge Baru 4.54.00, lalu instal versi sebelumnya untuk melakukan roll back:

Hentikan dan uninstal UI Edge Baru 4.54.00 (edge-management-ui):

/opt/apigee/apigee-service/bin/apigee-service edge-management-ui stop
/opt/apigee/apigee-service/bin/apigee-service edge-management-ui uninstall
/opt/apigee/apigee-service/bin/apigee-service edge-management-ui-static uninstall

Jalankan file bootstrap untuk Apigee Edge for Private Cloud 4.53.00/4.53.01:

# Download bootstrap for 4.53.00
curl https://software.apigee.com/bootstrap_4.53.00.sh -o /tmp/bootstrap_4.53.00.sh -u uName:pWord

# Execute bootstrap for 4.53.00
sudo bash /tmp/bootstrap_4.53.00.sh apigeeuser=uName apigeepassword=pWord

Lakukan roll back apigee-setup dari 4.54.00 ke versi sebelumnya:

# Uninstall apigee-setup
/opt/apigee/apigee-service/bin/apigee-service apigee-setup uninstall

# Install apigee-setup
/opt/apigee/apigee-service/bin/apigee-service apigee-setup install

Pulihkan konfigurasi UI 4.53.00/4.53.01 Anda:
- Jika Anda mencadangkan file konfigurasi senyap dari penginstalan 4.53.00 atau 4.53.01, gunakan file cadangan tersebut untuk prosedur rollback. Jika tidak, dalam file konfigurasi otomatis 4.54.00, pulihkan atau batalkan komentar properti UI 4.53.00 atau 4.53.01 yang dihapus atau dijadikan sebagai komentar selama upgrade. Sebagai referensi, lihat bagian Upgrade UI.
- Jika /opt/apigee/customer/application/ui.properties dihapus selama upgrade, pulihkan dari direktori cadangan:
```
cp -rf /opt/apigee/backup/ui/customer/application/ui.properties /opt/apigee/customer/application/
chown apigee:apigee /opt/apigee/customer/application/ui.properties
```
Instal ulang dan konfigurasi versi UI sebelumnya:
- Melakukan roll back ke UI Klasik (edge-ui):
  1. Instal dan siapkan UI Klasik (untuk Basic Auth, tidak diperlukan langkah tambahan):
```
/opt/apigee/apigee-setup/bin/setup.sh -p ui -f configFile
```
  2. Jika SSO diaktifkan, konfigurasikan SSO di UI Klasik (pastikan apigee-sso berjalan terlebih dahulu):
```
/opt/apigee/apigee-service/bin/apigee-service edge-ui configure-sso -f configFile
```
- Melakukan roll back ke UI Edge Baru 4.53.00 atau 4.53.01 (edge-management-ui dan Shoehorn edge-ui):
  1. Pastikan EDGEUI_ENABLE_UNIFIED_UI=y ditetapkan dalam file konfigurasi otomatis, lalu instal dan siapkan profil ui dan ue:
```
/opt/apigee/apigee-setup/bin/setup.sh -p ui -f configFile
/opt/apigee/apigee-setup/bin/setup.sh -p ue -f configFile
```
  2. Jika SSO diaktifkan, konfigurasi SSO di kedua komponen UI (pastikan apigee-sso berjalan terlebih dahulu):
```
/opt/apigee/apigee-service/bin/apigee-service edge-ui configure-sso -f configFile
/opt/apigee/apigee-service/bin/apigee-service edge-management-ui configure-sso -f configFile
```
Catatan: Dalam topologi multi-node tempat UI Klasik dan UI Edge Baru 4.53.01 dihosting di node terpisah, jalankan perintah rollback di host masing-masing. Perintah configure-sso hanya boleh dijalankan jika SSO dikonfigurasi di versi sebelumnya.
- Node 1 (node UI Klasik): Jalankan perintah UI Klasik:
```
/opt/apigee/apigee-setup/bin/setup.sh -p ui -f configFile
/opt/apigee/apigee-service/bin/apigee-service edge-ui configure-sso -f configFile
```
- Node 2 (Node New Edge UI): Jalankan perintah New Edge UI (setup.sh -p ue dan edge-management-ui configure-sso):
```
/opt/apigee/apigee-setup/bin/setup.sh -p ue -f configFile
/opt/apigee/apigee-service/bin/apigee-service edge-ui configure-sso -f configFile
/opt/apigee/apigee-service/bin/apigee-service edge-management-ui configure-sso -f configFile
```

Verifikasi status dan versi UI yang di-roll back:

Untuk UI Klasik (edge-ui):

/opt/apigee/apigee-service/bin/apigee-service edge-ui status
/opt/apigee/apigee-service/bin/apigee-service edge-ui version

Untuk Edge UI Baru (edge-management-ui):

/opt/apigee/apigee-service/bin/apigee-service edge-management-ui status
/opt/apigee/apigee-service/bin/apigee-service edge-management-ui version

Catatan: Di Apigee Edge for Private Cloud versi sebelum 4.54.00, UI Edge Klasik (edge-ui) dan UI Edge Baru (edge-management-ui) tidak dapat berdampingan di node yang sama. Administrator harus menyediakan node khusus yang terpisah untuk setiap komponen UI saat menjalankan versi sebelumnya.

Me-roll back OpenLDAP

Bagian ini memberikan panduan langkah demi langkah untuk mengembalikan Symas OpenLDAP 2.6.10 di Edge untuk Private Cloud 4.54.00 ke OpenLDAP 2.4.46 (Edge untuk Private Cloud 4.53.00) atau Symas OpenLDAP 2.6.7 (Edge untuk Private Cloud 4.53.01). Anda harus melakukan rollback pada seluruh cluster LDAP 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.

Sebelum memulai

Ketidakcocokan cadangan: Gunakan cadangan pra-upgrade dari OpenLDAP 2.4.46 (Edge for Private Cloud 4.53.00) atau Symas OpenLDAP 2.6.7 (Edge for Private Cloud 4.53.01) yang diambil menggunakan apigee-service apigee-openldap backup sebelum upaya upgrade. Cadangan yang dibuat 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. Matikan semua instance edge-management-server dan edge-ui sebelum melanjutkan rollback LDAP.
Catatan: Jika Anda menggunakan UI Edge Baru (edge-management-ui), pastikan Anda menghentikan UI Klasik (edge-ui) dan UI Edge Baru (edge-management-ui).
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.
Pencadangan file silent.conf: Pertahankan cadangan file silent.conf dari versi sebelumnya dan saat ini untuk mencegah kesalahan konfigurasi selama prosedur upgrade dan rollback.
Urutan rollback: Selesaikan prosedur rollback untuk Cassandra, ZooKeeper, Qpid, PostgreSQL, apigee-sso, dan Edge UI sebelum melakukan rollback OpenLDAP.

Prosedur rollback

Matikan Server Pengelolaan dan UI: Matikan semua instance edge-management-server dan edge-ui sebelum melanjutkan rollback LDAP:
```
apigee-service edge-management-server stop
apigee-service edge-ui stop
```
Mencatat jumlah entri LDAP saat ini (sebelum menghentikan LDAP): Dapatkan total jumlah entri untuk referensi dari semua server LDAP, dengan mengganti YOUR_PASSWORD dengan sandi pengelola LDAP Anda saat ini. (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
```
Hentikan dan uninstal LDAP 2.6 baru: Hentikan layanan apigee-openldap dan hapus direktori konfigurasi dan direktori datanya. Lakukan langkah ini 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/*
```

Instal versi LDAP sebelumnya 2.4.46 atau 2.6.7:

Menginstal LDAP versi lama:

/opt/apigee/apigee-setup/bin/setup.sh -p ld -f /opt/silent.conf

Memvalidasi versi LDAP:

source ~/.bash_profile
ldapsearch -VV

# Expected output if rolled back to 4.53.00:
ldapsearch: @(#) $OpenLDAP: ldapsearch 2.4.46

# Expected output if rolled back to 4.53.01:
ldapsearch: @(#) $OpenLDAP: ldapsearch 2.6.7

Ulangi sublangkah sebelumnya di langkah 4 pada setiap node LDAP, satu per satu.

Bersihkan data residu: Di semua server LDAP, satu per satu, hentikan layanan yang baru diinstal dan bersihkan direktori datanya untuk mempersiapkan pemulihan dari cadangan:
```
apigee-service apigee-openldap stop
rm -rf /opt/apigee/data/apigee-openldap/*
```
Pulihkan data LDAP: Untuk penyiapan server tunggal, lanjutkan langsung ke langkah 6b. Untuk penyiapan multi-server, lanjutkan dengan langkah 6a.
1. Identifikasi server LDAP aktif: Sebelum memulihkan data LDAP, identifikasi server (penyedia) aktif dengan menjalankan perintah ini:
```
grep -i '^olcSyncrepl:' /opt/apigee/data/apigee-openldap/slapd.d/cn=config/olcDatabase*.ldif
```
  Catatan:
  1. Jika perintah ini menampilkan output, server adalah server pasif.
  2. Jika perintah ini tidak menampilkan output, berarti server tersebut adalah server aktif.
2. Pulihkan data LDAP (pastikan langkah 5 diselesaikan di semua server sebelum memulihkan):
  - Di server LDAP tunggal atau aktif (ditentukan di langkah 6a), buka direktori cadangan dan pulihkan cadangan sebelum upgrade (misalnya, 2025.07.28,13.59.00, atau hapus stempel waktu jika cadangan sebelum upgrade adalah cadangan terbaru di direktori):
```
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
```
Mulai server LDAP yang tersisa: Jika Anda memiliki penyiapan multi-server, di setiap server LDAP yang tersisa, mulai layanan:
```
apigee-service apigee-openldap start
```
Catatan: Anda tidak perlu memulihkan data secara manual di server peer ini. Setelah dimulai, server tersebut akan terhubung ke server pertama (yang kini berisi data yang dipulihkan) dan otomatis menyinkronkan seluruh direktori melalui replikasi.
Validasi akhir:
- Pastikan rollback berhasil dan data konsisten di seluruh cluster LDAP.
- Jalankan perintah validasi di semua server LDAP, dengan mengganti YOUR_PASSWORD dengan sandi pengelola LDAP Anda saat ini. Jumlah data harus sama di semua server dan harus cocok dengan jumlah yang Anda ambil di langkah 2:
```
# 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, mulai edge-management-server, edge-ui, dan komponen dependen lainnya sesuai dengan prosedur standar organisasi Anda.

Melakukan Roll Back Komponen Edge

Komponen dengan kode umum

Komponen Edge berikut menggunakan kode yang sama. Oleh karena itu, untuk melakukan roll back salah satu komponen ini di node, Anda harus melakukan roll back semua komponen 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 telah menginstal Server Pengelolaan, Router, dan Message Processor di node, untuk me-roll back salah satunya, Anda harus me-roll back ketiganya.

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

Download file bootstrap.sh untuk versi yang ingin Anda roll back:
- Untuk mengembalikan ke 4.53.00/4.53.01, download bootstrap_4.53.00.sh/bootstrap_4.53.01.sh

Hentikan komponen untuk melakukan roll back:

Untuk me-roll back salah satu komponen dengan kode umum pada 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

Untuk me-roll back komponen lain pada node, hentikan hanya komponen tersebut:
```
/opt/apigee/apigee-service/bin/apigee-service component stop
```

Jika Anda mengembalikan Monetisasi, uninstal dari semua node Server Pengelolaan dan Pemroses Pesan:
```
/opt/apigee/apigee-service/bin/apigee-service edge-mint-gateway uninstall
```
Uninstal komponen untuk melakukan roll back pada node:
1. Untuk me-roll back salah satu komponen dengan kode umum pada node, Anda harus meng-uninstal semuanya dengan meng-uninstal grup komponen edge-gateway dan apigee-cassandra-client, seperti yang ditunjukkan 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 roll back Nginx:
```
### Find the apigee-nginx RPM
rpm -qa | grep -i "apigee-nginx"

### Remove the apigee-nginx RPM
dnf remove apigee-nginx-1.30.x
```
3. Untuk me-roll back komponen lain pada node, uninstal komponen tersebut saja, seperti yang ditunjukkan contoh berikut:
```
/opt/apigee/apigee-service/bin/apigee-service component uninstall
```
  Dengan component adalah nama komponen.
  Catatan: Jika edge-analytics tidak otomatis di-uninstal bersama edge-qpid-server dan edge-postgres-server, uninstal secara manual menggunakan perintah berikut:
```
/opt/apigee/apigee-service/bin/apigee-service edge-analytics uninstall
```
4. Untuk melakukan roll back Router Edge, Anda harus menghapus konten file /opt/nginx/conf.d selain meng-uninstal grup komponen edge-gateway:
```
cd /opt/nginx/conf.d
rm -rf *
```

Uninstal apigee-setup versi 4.54.00:

/opt/apigee/apigee-service/bin/apigee-service apigee-setup uninstall

Instal utilitas apigee-service versi 4.53.00 dan dependensinya. Contoh berikut menginstal apigee-service versi 4.53.00:
```
sudo bash /tmp/bootstrap_4.53.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 terjadi error, pastikan Anda mendownload file bootstrap.sh pada langkah 1.

Instal apigee-setup:

/opt/apigee/apigee-service/bin/apigee-service apigee-setup install

Instal komponen versi lama:
```
/opt/apigee/apigee-setup/bin/setup.sh -p component -f configFile
```
Dengan component sebagai komponen yang akan diinstal dan configFile adalah file konfigurasi Anda untuk versi yang lebih lama.
Jika Anda melakukan roll back Qpid, flush iptables:
```
sudo iptables -F
```
Ulangi proses ini untuk setiap node yang menghosting komponen yang Anda roll back.

Catatan: Setelah meng-uninstal apigee-cassandra-client, apigee-provision, dan apigee-validate akan otomatis dihapus karena dependensinya. Jika selanjutnya diperlukan, dependensi tersebut harus diinstal ulang.

Me-roll back mTLS

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

Hentikan Apigee:
```
apigee-all stop
```
Hentikan mTLS:
```
apigee-service apigee-mtls uninstall
```

Instal ulang mTLS:

apigee-service apigee-mtls install
apigee-service apigee-mtls setup -f /opt/silent.conf