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

Mengupdate Apigee Edge 4.50.00 atau 4.51.00 ke 4.52.00

Apigee mendukung upgrade Edge for Private Cloud dari versi 4.50.00 atau versi 4.51.00 langsung ke versi 4.52.00. Halaman ini menjelaskan cara melakukan salah satu upgrade.

Siapa yang dapat melakukan update

Orang yang menjalankan update harus sama dengan orang yang awalnya menginstal Edge, atau orang yang menjalankan sebagai root.

Setelah Anda menginstal RPM Edge, siapa pun dapat mengonfigurasinya.

Komponen mana yang harus Anda update

Anda harus mengupdate semua komponen Edge. Edge tidak mendukung penyiapan yang berisi komponen dari beberapa versi.

Prasyarat update

Pastikan prasyarat berikut terpenuhi sebelum mengupgrade Apigee Edge:

Cadangkan semua node
Sebelum melakukan update, sebaiknya lakukan pencadangan lengkap semua node untuk alasan keamanan. Gunakan prosedur untuk versi Edge Anda saat ini untuk melakukan pencadangan.
Dengan begitu, Anda memiliki rencana cadangan, jika update ke versi baru tidak berfungsi dengan baik. Untuk mengetahui informasi selengkapnya tentang pencadangan, lihat Pencadangan dan Pemulihan.
Memastikan Edge berjalan
Pastikan Edge aktif dan berjalan selama proses update menggunakan perintah:
```
/opt/apigee/apigee-service/bin/apigee-all status
```
Pastikan Strategi Pemadatan Cassandra adalah LeveledCompactionStrategy
Pastikan strategi pemadatan Cassandra ditetapkan ke LeveledCompactionStrategy, seperti yang dijelaskan dalam Mengubah strategi pemadatan Cassandra.

Penyebaran otomatis setelan properti

Jika Anda telah menetapkan properti apa pun dengan mengedit file .properties di /opt/apigee/customer/application, nilai ini akan dipertahankan oleh update.

Upgrade yang diperlukan ke Zookeeper 3.8.0

Rilis Edge for Private Cloud ini mencakup upgrade ke Zookeeper 3.8.0. Sebagai bagian dari upgrade tersebut, semua data Zookeeper akan dimigrasikan ke Zookeeper 3.8.0.

Sebelum mengupgrade Zookeeper, baca panduan pemeliharaan Zookeeper. Sebagian besar sistem produksi Edge menggunakan cluster node Zookeeper yang tersebar di beberapa pusat data. Beberapa node ini dikonfigurasi sebagai pemilih yang berpartisipasi dalam pemilihan pemimpin Zookeeper, dan sisanya dikonfigurasi sebagai pengamat. Lihat Tentang leader, follower, voter, dan observer untuk mengetahui detail selengkapnya. Node pemilih memilih pemimpin, setelah itu node pemilih itu sendiri menjadi pengikut.

Selama proses update, mungkin akan ada penundaan sesaat atau kegagalan penulisan ke Zookeeper saat node pemimpin dinonaktifkan. Hal ini dapat memengaruhi operasi Pengelolaan yang menulis ke Zookeeper, seperti operasi deployment proxy, dan perubahan infrastruktur Apigee, seperti penambahan atau penghapusan pemroses pesan, dll. Seharusnya tidak ada dampak pada API runtime Apigee (kecuali jika API runtime ini memanggil API pengelolaan) selama upgrade Zookeeper saat mengikuti prosedur di bawah.

Secara umum, proses upgrade melibatkan pencadangan setiap node. Tindakan ini diikuti dengan mengupgrade semua observer dan follower, lalu mengupgrade node leader.

Membuat cadangan

Buat cadangan semua node ZooKeeper untuk digunakan jika diperlukan rollback. Perhatikan bahwa rollback akan memulihkan Zookeeper ke status saat pencadangan dilakukan. Catatan: Setiap deployment atau perubahan infrastruktur di Apigee sejak pencadangan dilakukan (yang informasinya disimpan di Zookeeper) akan hilang selama pemulihan.

  /opt/apigee/apigee-service/bin/apigee-service apigee-zookeeper backup

Jika Anda menggunakan virtual machine dan memiliki kemampuan, snapshot atau cadangan VM juga dapat diambil untuk pemulihan atau rollback (jika diperlukan).

Mengidentifikasi pemimpin, pengikut, dan pengamat

Catatan: Contoh perintah di bawah menggunakan utilitas nc untuk mengirim data ke Zookeeper. Anda juga dapat menggunakan utilitas alternatif untuk mengirim data ke Zookeeper.

Jika belum diinstal di node ZooKeeper, instal nc:
```
  sudo yum install nc
```

Jalankan perintah nc berikut pada node, dengan 2181 adalah port ZooKeeper:

  echo stat | nc localhost 2181

Anda akan melihat output seperti berikut:

  Zookeeper version: 3.8.0-5a02a05eddb59aee6ac762f7ea82e92a68eb9c0f, built on 2022-02-25 08:49 UTC
  Clients:
   /0:0:0:0:0:0:0:1:41246[0](queued=0,recved=1,sent=0)
  
  Latency min/avg/max: 0/0.2518/41
  Received: 647228
  Sent: 647339
  Connections: 4
  Outstanding: 0
  Zxid: 0x400018b15
  Mode: follower
  Node count: 100597

Di baris Mode pada output untuk node, Anda akan melihat observer, leader, atau follower (artinya pemilih yang bukan leader) bergantung pada konfigurasi node. Catatan: Dalam penginstalan mandiri Edge dengan satu node ZooKeeper, Mode disetel ke mandiri.

Ulangi langkah 1 dan 2 pada setiap node ZooKeeper.

Mengupgrade Zookeeper di node observer dan follower

Upgrade Zookeeper di setiap node observer dan follower sebagai berikut:

Download dan jalankan bootstrap Edge for Private Cloud 4.52, seperti yang dijelaskan dalam Update ke 4.52.00 di node dengan koneksi internet eksternal. Prosesnya kemungkinan akan bervariasi, bergantung pada apakah node memiliki koneksi internet eksternal atau Anda melakukan penginstalan offline.
Upgrade komponen Zookeeper:
```
  /opt/apigee/apigee-setup/bin/update.sh -c zk -f <silent-config-file>
```
Catatan: Jika node ini memiliki komponen lain yang diinstal (seperti Cassandra), Anda juga dapat mengupgradenya sekarang (seperti dengan profil cs,zk) atau Anda dapat mengupgrade komponen lainnya nanti. Apigee merekomendasikan agar Anda mengupgrade Zookeeper terlebih dahulu dan memastikan cluster Anda berfungsi dengan baik sebelum mengupgrade komponen lainnya.
Ulangi langkah-langkah di atas pada setiap node observer dan follower Zookeeper.

Mematikan leader

Setelah semua node observer dan follower diupgrade, matikan leader. Pada node yang diidentifikasi sebagai leader, jalankan perintah di bawah:

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

Perhatikan bahwa selama peristiwa ini, sebelum pemimpin baru dipilih, mungkin ada penundaan sesaat atau kegagalan penulisan di Zookeeper. Hal ini dapat memengaruhi operasi yang menulis ke Zookeeper, seperti tindakan deployment proxy atau perubahan infrastruktur Apigee, seperti penambahan atau penghapusan pemroses pesan, dll.

Memastikan leader baru terpilih

Dengan menggunakan langkah-langkah di bagian Mengidentifikasi pemimpin, pengikut, dan pengamat di atas, pastikan pemimpin baru telah dipilih dari pengikut, setelah pemimpin yang ada dihentikan. Perhatikan bahwa leader dapat dipilih di pusat data yang berbeda dari leader saat ini.

Upgrade leader

Ikuti langkah-langkah yang sama seperti di Mengupgrade Zookeeper di node observer dan follower di atas.

Setelah node pemimpin lama juga diupgrade, verifikasi kondisi cluster dan pastikan ada node pemimpin.

Rollback

Jika rollback diperlukan:

Lakukan langkah-langkah rollback pada observer dan follower terlebih dahulu.
Download dan jalankan bootstrap versi yang Anda gunakan untuk melakukan roll back—baik 4.50 maupun 4.51. Prosesnya mungkin akan bervariasi, bergantung pada apakah node memiliki koneksi internet eksternal atau Anda mengikuti penginstalan offline.

Hentikan ZooKeeper jika sedang 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, lakukan roll back pada node pemimpin dengan mengikuti langkah 2 hingga 5 pada node pemimpin.

Setelah semua node di-roll back, verifikasi kondisi cluster dan pastikan ada node leader di cluster.

Memulihkan cadangan

Lihat Memulihkan dari cadangan. Perhatikan bahwa cadangan Zookeeper yang diambil dari versi Edge for Private Cloud yang lebih lama seperti 4.50 dan 4.51 harus kompatibel dengan versi Zookeeper di Edge for Private Cloud 4.52.

Upgrade wajib ke Postgres 14

Rilis Edge ini mencakup upgrade ke Postgres 14. Sebagai bagian dari upgrade tersebut, semua data Postgres dimigrasikan ke Postgres 14.

Sebagian besar sistem produksi Edge menggunakan dua node Postgres yang dikonfigurasi untuk replikasi master-standby. Selama proses update, saat node Postgres tidak aktif untuk update, data analisis masih ditulis ke node Qpid. Setelah node Postgres diupdate dan kembali online, data analisis kemudian akan dikirim ke node Postgres.

Cara Anda melakukan update Postgres bergantung pada cara Anda mengonfigurasi penyimpanan data untuk node Postgres:

Jika Anda menggunakan penyimpanan data lokal untuk node Postgres, Anda harus menginstal node standby Postgres baru selama durasi upgrade. Setelah upgrade selesai, Anda dapat menonaktifkan node standby Postgres baru.
Node standby Postgres tambahan diperlukan jika Anda harus melakukan roll back update karena alasan apa pun. Jika Anda harus melakukan roll back update, node standby Postgres baru akan menjadi node Postgres master setelah rollback. Oleh karena itu, saat Anda menginstal node standby Postgres baru, node tersebut harus berada di node yang memenuhi semua persyaratan hardware server Postgres, seperti yang ditentukan dalam Persyaratan penginstalan Edge.

Dalam konfigurasi Edge 1 node dan 2 node, topologi yang digunakan untuk pembuatan prototipe dan pengujian, Anda hanya memiliki satu node Postgres. Anda dapat mengupdate node Postgres ini secara langsung tanpa harus membuat node Postgres baru.
Jika menggunakan penyimpanan jaringan untuk node Postgres, seperti yang direkomendasikan oleh Apigee, Anda tidak perlu menginstal node Postgres baru. Dalam prosedur di bawah, Anda dapat melewati langkah-langkah yang menentukan untuk menginstal dan kemudian menonaktifkan node standby Postgres baru.
Sebelum memulai proses update, ambil snapshot jaringan dari penyimpanan data yang digunakan oleh Postgres. Kemudian, jika terjadi error selama update dan Anda terpaksa melakukan roll back, Anda dapat memulihkan node Postgres dari snapshot tersebut.

Menginstal node standby Postgres baru

Prosedur ini membuat server standby Postgres di node baru. Pastikan Anda menginstal server standby Postgres baru untuk versi Edge yang ada (4.50.00 atau 4.51.00), bukan untuk versi 4.52.00.

Untuk melakukan penginstalan, gunakan file konfigurasi yang sama dengan yang Anda gunakan untuk menginstal Edge versi saat ini.

Untuk membuat node standby Postgres baru:

Pada master Postgres saat ini, edit file /opt/apigee/customer/application/postgresql.properties untuk menetapkan token berikut. Jika file tersebut tidak ada, buat file:
```
conf_pg_hba_replication.connection=host replication apigee existing_standby_ip/32 trust\ \nhost replication apigee new_standby_ip/32 trust
```
Dengan existing_standby_ip adalah alamat IP server standby Postgres saat ini dan new_standby_ip adalah alamat IP node standby baru.

Mulai ulang apigee-postgresql di master Postgres:

/opt/apigee/apigee-service/bin/apigee-service apigee-postgresql restart

Pastikan node standby baru telah ditambahkan dengan melihat file /opt/apigee/apigee-postgresql/conf/pg_hba.conf di master. Anda akan melihat baris berikut dalam file tersebut:
```
host replication apigee existing_standby_ip/32 trust
host replication apigee new_standby_ip/32 trust
```
Instal server standby Postgres baru:
1. Edit file konfigurasi yang Anda gunakan untuk menginstal versi Edge saat ini guna menentukan hal berikut:
```
# IP address of the current master:
PG_MASTER=192.168.56.103
# IP address of the new standby node
PG_STANDBY=192.168.56.102
```
2. Nonaktifkan SELinux seperti yang dijelaskan dalam Menginstal utilitas apigee-setup Edge.
3. Jika saat ini Anda menggunakan Edge 4.51.00:
  1. Download file bootstrap_4.51.00.sh Edge ke /tmp/bootstrap_4.51.00.sh :
```
curl https://software.apigee.com/bootstrap_4.51.00.sh -o /tmp/bootstrap_4.51.00.sh
```
  2. Instal utilitas dan dependensi apigee-service Edge:
```
sudo bash /tmp/bootstrap_4.51.00.sh apigeeuser=uName apigeepassword=pWord
```
  Jika Anda saat ini menggunakan Edge 4.50.00:
  1. Download file bootstrap_4.50.00.sh Edge ke /tmp/bootstrap_4.50.00.sh :
```
curl https://software.apigee.com/bootstrap_4.50.00.sh -o /tmp/bootstrap_4.50.00.sh
```
  2. Instal utilitas dan dependensi apigee-service Edge:
```
sudo bash /tmp/bootstrap_4.50.00.sh apigeeuser=uName apigeepassword=pWord
```
4. Gunakan apigee-service untuk menginstal utilitas apigee-setup:
```
/opt/apigee/apigee-service/bin/apigee-service apigee-setup install
```
5. Menginstal Postgres:
```
/opt/apigee/apigee-setup/bin/setup.sh -p ps -f configFile
```
6. Di node standby baru, jalankan perintah berikut:
```
/opt/apigee/apigee-service/bin/apigee-service apigee-postgresql postgres-check-standby
```
  Pastikan bahwa instance tersebut adalah standby.

Melakukan upgrade Postgres di tempat

Catatan: Anda harus melakukan langkah awal berikut sebelum melakukan upgrade langsung Postgres.

Catatan: Dengan Postgres 14, parameter konfigurasi Postgres wal_keep_segments tidak lagi didukung. Jika Anda telah menambahkan atau mengubah parameter Postgres ini, Anda harus menghapusnya sebelum melakukan upgrade Postgres. Untuk melakukannya:

Buka file $APIGEE_ROOT/customer/application/postgresql.properties.
Hapus konfigurasi yang terkait dengan wal_keep_segments.
Mulai ulang Postgres.

Lihat dokumentasi Postgres untuk mengetahui properti alternatif yang tersedia di Postgres 14, seperti wal_keep_size, yang dapat digunakan sebagai gantinya.

Langkah awal

Sebelum melakukan upgrade langsung ke Postgres, lakukan langkah-langkah berikut pada host master dan standby, 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

Melakukan upgrade di tempat

Untuk melakukan upgrade langsung ke Postgres 14, lakukan langkah-langkah berikut:

Mengupgrade postgres di host master

/opt/apigee/apigee-setup/bin/update.sh -c ps -f /opt/silent.conf

Jalankan perintah penyiapan di host master:

apigee-service apigee-postgresql setup -f /opt/silent.conf

Jalankan perintah konfigurasi di host master:
```
apigee-service apigee-postgresql configure
```

Mulai ulang host master:

apigee-service apigee-postgresql restart

Konfigurasikan sebagai master:

apigee-service apigee-postgresql setup-replication-on-master -f /opt/silent.conf

Pastikan host master telah dimulai:

apigee-service apigee-postgresql wait_for_ready

Hentikan standby:
```
apigee-service apigee-postgresql stop
```
Upgrade standby.
Catatan: Jika langkah ini mengalami error/gagal, langkah ini dapat diabaikan. update.sh akan mencoba memulai server standby dengan konfigurasi yang salah. Jika penginstalan Postgres diupgrade ke versi 14, error ini dapat diabaikan.
```
/opt/apigee/apigee-setup/bin/update.sh -c ps -f /opt/silent.conf
```
Pastikan standby dihentikan:
```
apigee-service apigee-postgresql stop
```

Hapus konfigurasi standby lama:

rm -rf /opt/apigee/data/apigee-postgresql/

Siapkan replikasi di server standby:

apigee-service apigee-postgresql setup-replication-on-standby -f /opt/silent.conf

Hapus baris conf/postgresql.conf+max_locks_per_transaction=30000 dari file /opt/apigee/customer/application/postgresql.properties di host master dan standby. Baris ini ditambahkan di langkah awal.

Setelah menyelesaikan prosedur ini, standby akan berhasil dimulai.

Menonaktifkan node Postgres

Setelah update selesai, nonaktifkan node standby baru:

Pastikan Postgres berjalan:

/opt/apigee/apigee-service/bin/apigee-all status

Jika Postgres tidak berjalan, mulai:

/opt/apigee/apigee-service/bin/apigee-all start

Dapatkan UUID node standby baru dengan menjalankan perintah curl berikut pada node standby baru:

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"

Hentikan node standby baru dengan menjalankan perintah berikut pada node standby baru:
```
/opt/apigee/apigee-service/bin/apigee-all stop
```
Di node master Postgres, edit /opt/apigee/customer/application/postgresql.properties untuk menghapus node standby baru dari conf_pg_hba_replication.connection:
```
conf_pg_hba_replication.connection=host replication apigee existing_standby_ip/32 trust
```

Mulai ulang apigee-postgresql di master Postgres:

/opt/apigee/apigee-service/bin/apigee-service apigee-postgresql restart

Pastikan node standby baru telah dihapus dengan melihat file /opt/apigee/apigee-postgresql/conf/pg_hba.conf di master. Anda hanya akan melihat baris berikut dalam file tersebut:
```
host replication apigee existing_standby_ip/32 trust
```
Hapus UUID node standby dari ZooKeeper dengan melakukan panggilan API pengelolaan Edge berikut pada node Server Pengelolaan:
```
curl -u sysAdminEmail:password -X DELETE http://ms_IP:8080/v1/servers/new_standby_uuid
```

Langkah-langkah pasca-upgrade untuk Postgres

Setelah upgrade Postgres utama, statistik internal Postgres akan dihapus. Statistik ini membantu perencana kueri Postgres dalam menggunakan indeks dan jalur yang paling optimal untuk menjalankan kueri.

Postgres dapat secara bertahap membangun kembali statistiknya seiring waktu saat kueri dijalankan dan saat daemon autovacuum berjalan. Namun, hingga statistik dibuat ulang, kueri Anda mungkin lambat.

Untuk mengatasi masalah ini, jalankan ANALYZE di semua tabel dalam database pada node Postgres master. Atau, Anda dapat menjalankan ANALYZE untuk beberapa tabel sekaligus.

CATATAN: ANALYZE dapat memerlukan waktu lama untuk dijalankan, tetapi hanya memerlukan kunci baca pada tabel, sehingga operasi lain di Postgres dapat terus dijalankan saat ANALYZE berjalan.

UI Edge Baru

Bagian ini mencantumkan pertimbangan terkait Edge UI. Untuk mengetahui informasi selengkapnya, lihat UI Edge baru untuk cloud pribadi.

Menginstal UI Edge

Setelah menyelesaikan penginstalan awal, Apigee merekomendasikan agar Anda menginstal UI Edge, yang merupakan antarmuka pengguna yang ditingkatkan untuk developer dan administrator Apigee Edge for Private Cloud.

Perhatikan bahwa UI Edge mengharuskan Anda menonaktifkan autentikasi Dasar dan menggunakan IDP seperti SAML atau LDAP.

Untuk mengetahui informasi selengkapnya, lihat Menginstal UI Edge baru.

Mengupdate Edge UI

Untuk mengupdate komponen Edge UI, pertimbangkan versi Edge untuk cloud pribadi yang Anda upgrade:

Dari 4.51.00 ke 4.52.00 (dengan UI Edge baru yang sudah diinstal): Gunakan petunjuk upgrade di bagian ini untuk komponen edge-management-ui.

Mengupdate dengan mTLS Apigee

Untuk mengupdate mTLS Apigee , lakukan langkah-langkah berikut:

Me-roll back update

Jika update gagal, Anda dapat mencoba memperbaiki masalahnya, lalu menjalankan update.sh lagi. Anda dapat menjalankan update beberapa kali dan update akan dilanjutkan dari bagian terakhir yang Anda buka.

Jika kegagalan mengharuskan Anda melakukan roll back update ke versi sebelumnya, lihat Melakukan roll back 4.52.00 untuk mengetahui petunjuk mendetail.

Mencatat informasi update ke dalam log

Secara default, utilitas update.sh menulis informasi log ke:

/opt/apigee/var/log/apigee-setup/update.log

Jika orang yang menjalankan utilitas update.sh tidak memiliki akses ke direktori tersebut, utilitas akan menulis log ke direktori /tmp sebagai file bernama update_username.log.

Jika orang tersebut tidak memiliki akses ke /tmp, utilitas update.sh akan gagal.

Update tanpa periode nonaktif

Update tanpa periode nonaktif, atau update berkelanjutan, memungkinkan Anda mengupdate penginstalan Edge tanpa menonaktifkan Edge.

Update tanpa periode nonaktif hanya dapat dilakukan dengan konfigurasi 5 node dan yang lebih besar.

Kunci untuk melakukan upgrade tanpa periode nonaktif adalah dengan menghapus setiap Router, satu per satu, dari load balancer. Kemudian, Anda mengupdate Router dan komponen lainnya di mesin yang sama dengan Router, lalu menambahkan Router kembali ke load balancer.

Update mesin dalam urutan yang benar untuk penginstalan Anda seperti yang dijelaskan dalam Urutan update mesin.
Jika sudah waktunya untuk mengupdate Router, pilih salah satu Router dan buat agar tidak dapat dijangkau, seperti yang dijelaskan dalam Mengaktifkan/Menonaktifkan keterjangkauan server (Message Processor/Router).
Update Router yang dipilih dan semua komponen Edge lainnya di mesin yang sama dengan Router. Semua konfigurasi Edge menampilkan Router dan Message Processor di node yang sama.
Buat Router dapat dijangkau lagi.
Ulangi langkah 2 hingga 4 untuk Router yang tersisa.
Lanjutkan update untuk mesin yang tersisa di penginstalan Anda.

Perhatikan hal-hal berikut sebelum dan setelah update:

Pada node Router dan Message Processor gabungan:
- Sebelum update – lakukan hal berikut:
  1. Membuat Router tidak dapat dijangkau.
  2. Membuat Message Processor tidak dapat dijangkau.
- Setelah update – lakukan hal berikut:
  1. Buat Message Processor dapat dijangkau.
  2. Buat Router dapat dijangkau.
Pada node Router tunggal:
- Sebelum update, buat Router tidak dapat dijangkau.
- Setelah update, buat Router dapat dijangkau.
Pada node Message Processor tunggal:
- Sebelum melakukan update, buat Message Processor tidak dapat dijangkau.
- Setelah update, buat Message Processor dapat dijangkau.

Menggunakan file konfigurasi otomatis

Anda harus meneruskan file konfigurasi otomatis ke perintah update. File konfigurasi otomatis harus sama dengan yang Anda gunakan untuk menginstal Edge 4.50.00 atau 4.51.00.

Update ke 4.52.00 pada node dengan koneksi internet eksternal

Gunakan prosedur berikut untuk mengupdate komponen Edge pada node:

Jika ada, nonaktifkan tugas cron yang dikonfigurasi untuk melakukan operasi perbaikan pada Cassandra hingga update selesai.
Login ke node Anda sebagai root untuk menginstal RPM Edge.
CATATAN: Meskipun penginstalan RPM memerlukan akses root, Anda dapat melakukan konfigurasi Edge tanpa akses root.
Instal yum-utils dan yum-plugin-priorities:
Catatan: Jika sistem operasi Anda adalah RHEL 8.0 - 8.6, lewati langkah ini.
```
sudo yum install yum-utils
sudo yum install yum-plugin-priorities
```
Nonaktifkan SELinux seperti yang dijelaskan dalam Menginstal utilitas apigee-setup Edge.
Jika Anda menginstal di Oracle 7.x, jalankan perintah berikut:
```
sudo yum-config-manager --enable ol7_optional_latest
```

Jika Anda menginstal di AWS, jalankan perintah yum-configure-manager berikut:

yum update rh-amazon-rhui-client.noarch
sudo yum-config-manager --enable rhui-REGION-rhel-server-extras rhui-REGION-rhel-server-optional

Jika saat ini Anda menggunakan Edge 4.51.00:
1. Download file bootstrap_4.52.00.sh Edge ke /tmp/bootstrap_4.52.00.sh:
```
curl https://software.apigee.com/bootstrap_4.51.00.sh -o /tmp/bootstrap_4.51.00.sh
```
2. Instal utilitas dan dependensi apigee-service Edge 4.52.00 dengan menjalankan perintah berikut:
```
sudo bash /tmp/bootstrap_4.52.00.sh apigeeuser=uName apigeepassword=pWord
```
  Dengan uName:pWord adalah nama pengguna dan sandi yang Anda terima dari Apigee. Jika Anda menghilangkan pWord, Anda akan diminta untuk memasukkannya.
  
  Secara default, penginstal akan memeriksa apakah Anda telah menginstal Java 1.8. Jika tidak, penginstal akan menginstalnya untuk Anda.
  
  Gunakan opsi JAVA_FIX untuk menentukan cara menangani penginstalan Java. JAVA_FIX menggunakan nilai berikut:
  - I: Menginstal OpenJDK 1.8 (default).
  - C: Melanjutkan tanpa menginstal Java.
  - Q: Keluar. Untuk opsi ini, Anda harus menginstal Java sendiri.
3. Gunakan apigee-service untuk mengupdate utilitas apigee-setup, seperti yang ditunjukkan dalam contoh berikut:
```
/opt/apigee/apigee-service/bin/apigee-service apigee-setup update
```
4. Update utilitas apigee-validate di Server Pengelolaan, seperti yang ditunjukkan contoh berikut:
```
/opt/apigee/apigee-service/bin/apigee-service apigee-validate update
```
5. Update utilitas apigee-provision di Server Pengelolaan, seperti yang ditunjukkan contoh berikut:
```
/opt/apigee/apigee-service/bin/apigee-service apigee-provision update
```
6. Jalankan utilitas update di node Anda dengan menjalankan perintah berikut:
```
/opt/apigee/apigee-setup/bin/update.sh -c component -f configFile
```
  Lakukan ini sesuai urutan yang dijelaskan dalam Urutan update mesin.
  
  Dengan:
  - component adalah komponen Edge yang akan diupdate. Nilai yang memungkinkan mencakup:
    - cs: Cassandra
    - edge: Semua komponen Edge kecuali Edge UI: Server Pengelolaan, Message Processor, Router, Server QPID, Server Postgres
    - ldap: OpenLDAP
    - ps: postgresql
    - qpid: qpidd
    - sso: Apigee SSO (jika Anda menginstal SSO)
    - ue: UI Edge Baru
    - ui: UI Edge Klasik
    - zk: Zookeeper
  - configFile adalah file konfigurasi yang sama dengan yang Anda gunakan untuk menentukan komponen Edge selama penginstalan 4.50.00 atau 4.51.00.
  Anda dapat menjalankan update.sh terhadap semua komponen dengan menetapkan component ke "all", tetapi hanya jika Anda memiliki profil penginstalan all-in-one (AIO) Edge. Contoh:
```
/opt/apigee/apigee-setup/bin/update.sh -c all -f ./sa_silent_config
```
7. Mulai ulang komponen Edge UI di semua node yang menjalankannya, jika Anda belum melakukannya:
```
/opt/apigee/apigee-service/bin/apigee-service [edge-management-ui|edge-ui] restart
```
8. Uji update dengan menjalankan utilitas apigee-validate di Server Pengelolaan, seperti yang dijelaskan dalam Menguji penginstalan.
Jika nanti Anda memutuskan untuk me-roll back update, gunakan prosedur yang dijelaskan dalam Me-roll back 4.52.00.

Mengupdate ke 4.52.00 dari repositori lokal

Jika node Edge Anda berada di belakang firewall, atau dengan cara lain dilarang mengakses repositori Apigee melalui Internet, Anda dapat melakukan update dari repositori lokal, atau mirror, dari repo Apigee.

Setelah membuat repositori Edge lokal, Anda memiliki dua opsi untuk mengupdate Edge dari repo lokal:
- Buat file .tar dari repo, salin file .tar ke node, lalu update Edge dari file .tar.
- Instal server web di node dengan repositori lokal agar node lain dapat mengaksesnya. Apigee menyediakan server web Nginx untuk Anda gunakan, atau Anda dapat menggunakan server web Anda sendiri.
Untuk mengupdate dari repo 4.52.00 lokal:
1. Buat repositori 4.52.00 lokal seperti yang dijelaskan dalam "Membuat repositori Apigee lokal" di Menginstal utilitas apigee-setup Edge.
  CATATAN: Jika sudah memiliki repo, Anda dapat menambahkan repo 4.52.00 ke repo tersebut seperti yang dijelaskan dalam "Memperbarui repositori Apigee lokal" di Menginstal utilitas apigee-setup Edge.
2. Untuk menginstal apigee-service dari file .tar:
  1. Pada node dengan repo lokal, gunakan perintah berikut untuk mengemas repo lokal menjadi satu file .tar bernama /opt/apigee/data/apigee-mirror/apigee-4.52.00.tar.gz:
```
/opt/apigee/apigee-service/bin/apigee-service apigee-mirror package
```
  2. Salin file .tar ke node tempat Anda ingin mengupdate Edge. Misalnya, salin ke direktori /tmp di node baru.
  3. Pada node baru, untar file ke direktori /tmp:
```
tar -xzf apigee-4.52.00.tar.gz
```
    Perintah ini akan membuat direktori baru, bernama repos, di direktori yang berisi file .tar. Misalnya, /tmp/repos.
  4. Instal utilitas dan dependensi Edge apigee-service dari /tmp/repos:
```
sudo bash /tmp/repos/bootstrap_4.52.00.sh apigeeprotocol="file://" apigeerepobasepath=/tmp/repos
```
    Perhatikan bahwa Anda menyertakan jalur ke direktori repos dalam perintah ini.
3. Untuk menginstal apigee-service menggunakan server web Nginx:
  1. Konfigurasikan server web Nginx seperti yang dijelaskan dalam "Menginstal dari repo menggunakan server web Nginx" di Menginstal utilitas apigee-setup Edge.
  2. Pada node jarak jauh, download file bootstrap_4.52.00.sh Edge ke /tmp/bootstrap_4.52.00.sh:
```
/usr/bin/curl http://uName:pWord@remoteRepo:3939/bootstrap_4.52.00.sh -o /tmp/bootstrap_4.52.00.sh
```
    Dengan uName:pWord adalah nama pengguna dan sandi yang Anda tetapkan sebelumnya untuk repo, dan remoteRepo adalah alamat IP atau nama DNS node repo.
  3. Pada node jarak jauh, instal utilitas dan dependensi apigee-setup Edge:
```
sudo bash /tmp/bootstrap_4.52.00.sh apigeerepohost=remoteRepo:3939 apigeeuser=uName apigeepassword=pWord apigeeprotocol=http://
```
    Dengan uName:pWord adalah nama pengguna dan sandi repo.
4. Gunakan apigee-service untuk mengupdate utilitas apigee-setup, seperti yang ditunjukkan dalam contoh berikut:
```
/opt/apigee/apigee-service/bin/apigee-service apigee-setup update 
```
5. Update utilitas apigee-validate di Server Pengelolaan, seperti yang ditunjukkan contoh berikut:
```
/opt/apigee/apigee-service/bin/apigee-service apigee-validate update
```
6. Update utilitas apigee-provision di Server Pengelolaan, seperti yang ditunjukkan contoh berikut:
```
/opt/apigee/apigee-service/bin/apigee-service apigee-provision update
```
7. Jalankan utilitas update pada node Anda sesuai urutan yang dijelaskan dalam Urutan update mesin:
```
/opt/apigee/apigee-setup/bin/update.sh -c component -f configFile
```
  Dengan:
  - component adalah komponen Edge yang akan diupdate. Anda biasanya mengupdate komponen berikut:
    - cs: Cassandra
    - edge: Semua komponen Edge kecuali Edge UI: Management Server, Message Processor, Router, QPID Server, Postgres Server
    - ldap: OpenLDAP
    - ps: postgresql
    - qpid: qpidd
    - sso: Apigee SSO (jika Anda menginstal SSO)
    - ue UI Edge Baru
    - ui: UI Edge Klasik
    - zk: Zookeeper
  - configFile adalah file konfigurasi yang sama dengan yang Anda gunakan untuk menentukan komponen Edge selama penginstalan 4.50.00 atau 4.51.00.
    CATATAN: File konfigurasi harus dapat dibaca oleh pengguna "apigee". Untuk mengubah pemilik, gunakan perintah berikut:
    chown apigee:apigee configFile
  Anda dapat menjalankan update.sh terhadap semua komponen dengan menetapkan component ke "all", tetapi hanya jika Anda memiliki profil penginstalan all-in-one (AIO) Edge. Contoh:
```
/opt/apigee/apigee-setup/bin/update.sh -c all -f /tmp/sa_silent_config
```
8. Mulai ulang komponen UI di semua node yang menjalankannya, jika Anda belum melakukannya:
```
/opt/apigee/apigee-service/bin/apigee-service [edge-management-ui|edge-ui] restart
```
9. Uji update dengan menjalankan utilitas apigee-validate di Server Pengelolaan, seperti yang dijelaskan dalam Menguji penginstalan.
Jika nanti Anda memutuskan untuk me-roll back update, gunakan prosedur yang dijelaskan dalam Me-roll back 4.52.00.

Urutan update mesin

Urutan update mesin dalam penginstalan Edge sangat penting:
- Anda harus mengupdate semua node Cassandra dan ZooKeeper sebelum mengupdate node lainnya.
- Untuk mesin apa pun dengan beberapa komponen Edge (Server Pengelolaan, Message Processor, Router, Server QPID, tetapi bukan Server Postgres), gunakan opsi -c edge untuk mengupdate semuanya secara bersamaan.
- Jika sebuah langkah menentukan bahwa langkah tersebut harus dilakukan di beberapa mesin, lakukan langkah tersebut dalam urutan mesin yang ditentukan.
- Tidak ada langkah terpisah untuk memperbarui Monetisasi. Nilai ini diperbarui saat Anda menentukan opsi -c edge.
CATATAN: Setelah mengupdate komponen Edge UI, Anda harus memulai ulang layanan Edge UI, seperti yang dijelaskan dalam petunjuk penginstalan update.

Upgrade mandiri 1 node

Untuk mengupgrade konfigurasi mandiri 1 node ke 4.52.00:
1. Perbarui semua komponen:
```
/opt/apigee/apigee-setup/bin/update.sh -c all -f configFile
```
2. (Jika Anda menginstal apigee-adminapi) Mengupdate utilitas apigee-adminapi:
```
/opt/apigee/apigee-service/bin/apigee-service apigee-adminapi update
```
Upgrade mandiri 2 node

Update komponen berikut untuk penginstalan mandiri 2 node:

Lihat Topologi penginstalan untuk mengetahui daftar topologi Edge dan nomor node.
1. Update Cassandra dan ZooKeeper di mesin 1:
```
/opt/apigee/apigee-setup/bin/update.sh -c cs,zk -f configFile
```
2. Update Qpid dan Postgres di mesin 2:
```
/opt/apigee/apigee-setup/bin/update.sh -c qpid,ps -f configFile
```
3. Update LDAP di mesin 1:
```
/opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile
```
4. Update komponen Edge di mesin 2 dan 1:
```
/opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
```
5. Update UI di mesin 1:
```
/opt/apigee/apigee-setup/bin/update.sh -c ui -f configFile
```
6. (Jika Anda menginstal apigee-adminapi) Mengupdate utilitas apigee-adminapi di mesin 1:
```
/opt/apigee/apigee-service/bin/apigee-service apigee-adminapi update
```
7. (Jika Anda menginstal Apigee SSO) Update Apigee SSO di mesin 1:
```
/opt/apigee/apigee-setup/bin/update.sh -c sso -f sso_config_file
```
  Dengan sso_config_file sebagai file konfigurasi yang Anda buat saat menginstal SSO.
8. Mulai ulang komponen Edge UI di mesin 1:
```
/opt/apigee/apigee-service/bin/apigee-service edge-ui restart
```
Upgrade 5 node

Update komponen berikut untuk penginstalan 5 node:

Lihat Topologi penginstalan untuk mengetahui daftar topologi Edge dan nomor node.
1. Update Cassandra dan ZooKeeper di mesin 1, 2, dan 3:
```
/opt/apigee/apigee-setup/bin/update.sh -c cs,zk -f configFile
```
2. Update Qpid dan Postgres di mesin 4:
```
/opt/apigee/apigee-setup/bin/update.sh -c qpid, ps -f configFile
```
3. Update Qpid dan Postgres di mesin 5:
```
/opt/apigee/apigee-setup/bin/update.sh -c qpid, ps -f configFile
```
4. Update LDAP di mesin 1:
```
/opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile
```
5. Update komponen Edge di mesin 4, 5, 1, 2, 3:
```
/opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
```
6. Update UI Edge:
  - UI Klasik: Jika Anda menggunakan UI klasik, update komponen ui di mesin 1, seperti yang ditunjukkan contoh berikut:
```
/opt/apigee/apigee-setup/bin/update.sh -c ui -f configFile
```
  - UI Edge Baru: Jika Anda menginstal UI Edge baru, update komponen ue di mesin yang sesuai (mungkin bukan mesin 1):
```
/opt/apigee/apigee-setup/bin/update.sh -c ue -f /opt/silent.conf
```
7. (Jika Anda menginstal apigee-adminapi) Mengupdate utilitas apigee-adminapi di mesin 1:
```
/opt/apigee/apigee-service/bin/apigee-service apigee-adminapi update
```
8. (Jika Anda menginstal Apigee SSO) Update Apigee SSO di mesin 1:
```
/opt/apigee/apigee-setup/bin/update.sh -c sso -f sso_config_file
```
  Dengan sso_config_file sebagai file konfigurasi yang Anda buat saat menginstal SSO.
9. Mulai ulang komponen UI:
  - UI Klasik: Jika Anda menggunakan UI klasik, mulai ulang komponen edge-ui di mesin 1, seperti yang ditunjukkan pada contoh berikut:
```
/opt/apigee/apigee-service/bin/apigee-service edge-ui restart
```
  - UI Edge Baru: Jika Anda menginstal UI Edge baru, mulai ulang komponen edge-management-ui di komputer yang sesuai (mungkin bukan komputer 1):
```
/opt/apigee/apigee-service/bin/apigee-service edge-management-ui restart
```
Upgrade cluster 9 node

Update komponen berikut untuk penginstalan cluster 9 node:

Lihat Topologi penginstalan untuk mengetahui daftar topologi Edge dan nomor node.
1. Update Cassandra dan ZooKeeper di mesin 1, 2, dan 3:
```
/opt/apigee/apigee-setup/bin/update.sh -c cs,zk -f configFile
```
2. Update Qpid di mesin 6 dan 7:
```
/opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
```
3. Update Postgres di mesin 8:
```
/opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
```
4. Update Postgres di mesin 9:
```
/opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
```
5. Update LDAP di mesin 1:
```
/opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile
```
6. Update komponen Edge di mesin 6, 7, 8, 9, 1, 4, dan 5 dalam urutan tersebut:
```
/opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
```
7. Perbarui UI baru (ue) atau UI klasik (ui) di mesin 1:
```
/opt/apigee/apigee-setup/bin/update.sh -c [ui|ue] -f configFile
```
8. (Jika Anda menginstal apigee-adminapi) Update utilitas apigee-adminapi di mesin 1:
```
/opt/apigee/apigee-service/bin/apigee-service apigee-adminapi update
```
9. (Jika Anda menginstal Apigee SSO) Update Apigee SSO di mesin 1:
```
/opt/apigee/apigee-setup/bin/update.sh -c sso -f sso_config_file
```
  Dengan sso_config_file sebagai file konfigurasi yang Anda buat saat menginstal SSO.
10. Mulai ulang komponen UI:
  - UI Klasik: Jika Anda menggunakan UI klasik, mulai ulang komponen edge-ui di mesin 1, seperti yang ditunjukkan pada contoh berikut:
```
/opt/apigee/apigee-service/bin/apigee-service edge-ui restart
```
  - UI Edge Baru: Jika Anda menginstal UI Edge baru, mulai ulang komponen edge-management-ui di komputer yang sesuai (mungkin bukan komputer 1):
```
/opt/apigee/apigee-service/bin/apigee-service edge-management-ui restart
```
Upgrade cluster 13 node

Update komponen berikut untuk penginstalan cluster 13 node:

Lihat Topologi penginstalan untuk mengetahui daftar topologi Edge dan nomor node.
1. Update Cassandra dan ZooKeeper di mesin 1, 2, dan 3:
```
/opt/apigee/apigee-setup/bin/update.sh -c cs,zk -f configFile
```
2. Update Qpid di mesin 12 dan 13:
```
/opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
```
3. Update Postgres di mesin 8:
```
/opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
```
4. Update Postgres di mesin 9:
```
/opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
```
5. Update LDAP di mesin 4 dan 5:
```
/opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile
```
6. Update komponen Edge pada mesin 12, 13, 8, 9, 6, 7, 10, dan 11 dalam urutan berikut:
```
/opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
```
7. Update UI baru (ue) atau UI klasik (ui) di mesin 6 dan 7:
```
/opt/apigee/apigee-setup/bin/update.sh -c [ui|ue] -f configFile
```
8. (Jika Anda menginstal apigee-adminapi) Mengupdate utilitas apigee-adminapi di mesin 6 dan 7:
```
/opt/apigee/apigee-service/bin/apigee-service apigee-adminapi update
```
9. (Jika Anda menginstal Apigee SSO) Update Apigee SSO di mesin 6 dan 7:
```
/opt/apigee/apigee-setup/bin/update.sh -c sso -f sso_config_file
```
  Dengan sso_config_file sebagai file konfigurasi yang Anda buat saat menginstal SSO.
10. Mulai ulang komponen UI:
  - UI Klasik: Jika Anda menggunakan UI klasik, mulai ulang komponen edge-ui di mesin 6 dan 7, seperti yang ditunjukkan dalam contoh berikut:
```
/opt/apigee/apigee-service/bin/apigee-service edge-ui restart
```
  - UI Edge Baru: Jika Anda menginstal UI Edge baru, mulai ulang komponen edge-management-ui di mesin 6 dan 7:
```
/opt/apigee/apigee-service/bin/apigee-service edge-management-ui restart
```
Upgrade cluster 12 node

Update komponen berikut untuk penginstalan cluster 12 node:

Lihat Topologi penginstalan untuk mengetahui daftar topologi Edge dan nomor node.
1. Update Cassandra dan ZooKeeper:
  1. Di mesin 1, 2, dan 3 di Pusat Data 1:
```
/opt/apigee/apigee-setup/bin/update.sh -c cs,zk -f configFile
```
  2. Di mesin 7, 8, dan 9 di Pusat Data 2
```
/opt/apigee/apigee-setup/bin/update.sh -c cs,zk -f configFile
```
2. Update qpidd:
  1. Mesin 4, 5 di Pusat Data 1
    1. Update qpidd di mesin 4:
      /opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
    2. Update qpidd di mesin 5:
      /opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
  2. Mesin 10, 11 di Pusat Data 2
    1. Update qpidd di mesin 10:
      /opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
    2. Update qpidd di mesin 11:
      /opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
3. Update Postgres:
  1. Mesin 6 di Pusat Data 1
```
/opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
```
  2. Mesin 12 di Pusat Data 2
```
/opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
```
4. Memperbarui LDAP:
  1. Mesin 1 di Pusat Data 1
```
/opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile
```
  2. Mesin 7 di Pusat Data 2
```
/opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile
```
5. Perbarui komponen Edge:
  1. Mesin 4, 5, 6, 1, 2, 3 di Pusat Data 1
```
/opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
```
  2. Mesin 10, 11, 12, 7, 8, 9 di Pusat Data 2
```
/opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
```
6. Perbarui UI baru (ue) atau UI klasik (ui):
  1. Mesin 1 di Pusat Data 1:
```
/opt/apigee/apigee-setup/bin/update.sh -c [ui|ue] -f configFile
```
  2. Mesin 7 di Pusat Data 2:
```
/opt/apigee/apigee-setup/bin/update.sh -c [ui|ue] -f configFile
```
7. (Jika Anda menginstal apigee-adminapi) Mengupdate utilitas apigee-adminapi:
  1. Mesin 1 di Pusat Data 1:
```
/opt/apigee/apigee-service/bin/apigee-service apigee-adminapi update
```
  2. Mesin 7 di Pusat Data 2:
```
/opt/apigee/apigee-service/bin/apigee-service apigee-adminapi update
```
8. (Jika Anda menginstal Apigee SSO) Update Apigee SSO:
  1. Mesin 1 di Pusat Data 1:
```
/opt/apigee/apigee-setup/bin/update.sh -c sso -f sso_config_file
```
  2. Mesin 7 di Pusat Data 2:
```
/opt/apigee/apigee-setup/bin/update.sh -c sso -f sso_config_file
```
9. Mulai ulang komponen UI Edge baru (edge-management-ui) atau UI Edge klasik (edge-ui) di mesin 1 dan 7:
```
/opt/apigee/apigee-service/bin/apigee-service [edge-ui|edge-management-ui] restart
```
Untuk konfigurasi non-standar

Jika Anda memiliki konfigurasi non-standar, update komponen Edge dengan urutan berikut:
1. ZooKeeper
2. Cassandra
3. qpidd, ps
4. LDAP
5. Edge, yang berarti profil "-c edge" di semua node dalam urutan: node dengan server Qpid, Edge Postgres Server, Management Server, Message Processor, dan Router.
  CATATAN: Jika node memiliki server Qpid dan Server Postgres Edge yang diinstal, jalankan langkah profil "-c edge".
6. UI Edge (klasik atau baru)
7. apigee-adminapi
8. Apigee SSO
Setelah selesai mengupdate, pastikan untuk memulai ulang komponen Edge UI di semua mesin yang menjalankannya.