4.19.06 Edge untuk catatan rilis Private Cloud

Anda sedang melihat dokumentasi Apigee Edge.
Buka Dokumentasi Apigee X.
info

Bagian ini menjelaskan Rilis Fitur Edge versi 4.19.06 untuk Private Cloud.

Ringkasan rilis

Tabel berikut meringkas perubahan dalam rilis ini:

Fitur Baru

Rilis ini mencakup fitur baru berikut:

○ Dukungan LDAP untuk SSO
○ Dukungan deployment HTTP
○ Analisis yang dapat di-plug
○ Dukungan rak Cassandra
○ Dukungan IPv6
○ Penginstalan pengalaman Edge Baru yang disederhanakan
○ Kecualikan transaksi INVALID_TSC (Monetisasi)

Untuk informasi selengkapnya tentang setiap fitur baru ini, lihat Fitur baru.

Kompatibilitas Mundur

Masalah berikut yang memengaruhi kompatibilitas mundur diperkenalkan dalam versi ini Apigee Edge untuk Private Cloud:

     
  • Karena perbaikan untuk masalah 132443137 (seperti yang dijelaskan di 19.03.01 Publik Catatan rilis Cloud), Pemroses Pesan kini mengabaikan header yang dimulai dengan X-Apigee-*. Akibatnya, Anda harus memfaktorkan ulang kode apa pun yang menggunakan X-Apigee-* header dan ganti header tersebut dengan header yang didukung.

  • Nama file log Cassandra telah berubah. Kini menjadi:

    /opt/apigee/var/log/apigee-cassandra/system.log
Rilis yang Disertakan

Sejak Rilis Fitur Edge for Private Cloud sebelumnya, rilis berikut terjadi dan disertakan dalam rilis ini:

○ Tepi:
19.07.23 (UI)
19.03.01
19.02.19
19.02.04
19.01.23
19.01.14
18.12.04
18.08.31
18.07.31
○ Portal:
19.07.08
19.05.23
19.05.08
19.04.18
19.03.20
19.02.27
19.02.21
19.02.04
19.01.16
Pensiun Tidak ada
Penghentian penggunaan

Dengan rilis 4.19.06, hal berikut tidak digunakan lagi:

  • 4.18.01: Apigee Edge versi 4.18.01 untuk Private Cloud kini tidak digunakan lagi.

Untuk informasi selengkapnya, lihat Penghentian Apigee, penghentian, dan CPS perubahan.

Perbaikan Bug

Rilis ini mencakup perbaikan bug berikut:

○ UseStringDeduplikasi tidak ditetapkan (140270474)
○ Error MP (111445518)
○ Kegagalan Cassandra dengan JMX (113342838)
○ Upgrade 13 node (138931337)
○ Proxy dengan nama yang sama (119802562)
○ Keystore tidak dimuat (118851790)
○ Analytics gagal (110988191)
○ Kegagalan pencadangan (110785400)
HEAD permintaan ke Node.js (79993247)
○ pencadangan/pemulihan apigee-postgres (70291825)
○ Mereset sandi sysadmin (65737520)

Untuk mengetahui informasi selengkapnya tentang setiap perbaikan ini, lihat Perbaikan bug.

Masalah Umum

Rilis ini mencakup masalah umum berikut:

○ Awalnya, jangan berikan rating untuk transaksi (141628497)
○ Kebocoran memori server rating mint (137865184)
○ Format file metadata untuk penginstalan apigee-sso (135616498)
apigee-monit tidak didukung di Amazon Linux 1 (122370980)
○ Cadangan Pemroses Pesan tidak mencadangkan kumpulan file yang benar (121095148)
○ DataAccessException dalam konfigurasi multi-pusat data (76087166)
○ Kebijakan MessageLogging termasuk informasi tambahan dalam pesan log (68722102)

Untuk informasi selengkapnya tentang setiap masalah umum ini, termasuk solusinya, lihat Masalah umum.

Jalur upgrade

Tabel berikut menunjukkan jalur upgrade untuk rilis ini:

Dari 4.19.01 Upgrade langsung dari 4.19.01 → 4.19.06
Dari 4.18.05 Upgrade langsung dari 4.18.05 → 4.19.06
Dari 4.18.01 Upgrade langsung dari 4.18.01 → 4.19.06

Fitur baru

Bagian ini mencantumkan fitur baru dalam rilis ini. Selain itu, rilis ini menyertakan semua dalam rilis UI Edge, Pengelolaan Edge, dan Portal yang tercantum di Rilis yang Disertakan.

Selain penyempurnaan berikut, rilis ini juga berisi beberapa kegunaan, peningkatan performa, keamanan, dan stabilitas.

Dukungan deployment HTTP

Secara default, Edge menggunakan RPC untuk men-deploy proxy API. Meskipun mode ini sangat berfungsi dengan baik untuk sebagian besar besar, topologi yang lebih besar dengan banyak anggota DPR mungkin mengalami waktu tunggu saat banyak panggilan serentak dilakukan melalui RPC.

Akibatnya, Apigee merekomendasikan agar deployment yang lebih besar menggunakan HTTP daripada RPC untuk deployment. Mengaktifkan deployment HTTP kini didukung.

Untuk informasi selengkapnya, lihat Mengaktifkan HTTP deployment.

Dukungan rak Cassandra

Apigee kini memberikan panduan umum untuk menskalakan operasi Cassandra dengan membuat Cassandra di Apigee Edge untuk mengetahui rak Private Cloud.

Untuk informasi selengkapnya, lihat Dukungan rak Cassandra.

Analisis yang dapat di-plug

Secara default, data analisis yang dikumpulkan oleh Pemroses Pesan diupload ke Qpid dan Postgres untuk diproses. Anda kemudian dapat melihat data analisis di UI Edge.

Dengan Rilis Fitur ini, Anda dapat mengonfigurasi Pemroses Pesan untuk menulis data analisis ke {i>disk<i} atau Anda dapat memilih untuk menggunakan kedua opsi.

Untuk informasi selengkapnya, lihat Menulis data analisis ke file.

Penginstalan pengalaman Edge Baru yang disederhanakan

Penginstalan pengalaman New Edge telah disederhanakan dengan skrip baru.

Untuk mengetahui informasi selengkapnya, lihat Menginstal Pengalaman Edge Baru.

Dukungan IDP LDAP

Autentikasi pengguna dengan panggilan API pengelolaan Edge UI dan Edge kini mendukung LDAP di tambahan di SAML. Dukungan LDAP mencakup metode binding langsung dan tidak langsung.

Untuk informasi selengkapnya, lihat Ringkasan eksternal Autentikasi IDP.

Dukungan IPv6

Secara default, semua panggilan API runtime ke Apigee Edge untuk Private Cloud menggunakan IPv4. Anda dapat menambahkan IPv6 ke {i>Router<i} dengan properti baru.

Untuk informasi selengkapnya, lihat Menggunakan IPv6 di {i>Router<i}.

Kecualikan INVALID_TSC transaksi (Monetisasi)

Anda sekarang dapat mengecualikan transaksi INVALID_TSC agar tidak ditambahkan ke Postgres saat menggunakan Monetisasi.

Untuk informasi selengkapnya, lihat Monetisasi properti server.

Software yang didukung

Rilis ini mencakup perubahan berikut pada software yang didukung:

Dukungan Ditambahkan Tidak Lagi Didukung

Rilis ini menambahkan dukungan untuk platform berikut:

  • Red Hat Enterprise Linux (RHEL) 6.10
  • CentOS 6.10
  • Oracle Linux 6.9

Platform berikut tidak lagi didukung pada rilis ini:

  • Red Hat Enterprise Linux (RHEL) 6.9
  • CentOS 6.9
  • Oracle 6.8

Untuk mengetahui daftar lengkap platform yang didukung, lihat Software yang didukung dan versi yang didukung.

Perbaikan bug

Bagian ini mencantumkan bug Private Cloud yang telah diperbaiki dalam rilis ini. Selain itu, mencakup semua perbaikan bug dalam rilis Edge UI, Pengelolaan Edge, dan Portal yang ditampilkan di Rilis yang Disertakan.

ID Masalah Deskripsi
140270474

UseStringDeduplikasi tidak ditetapkan

UseStringDeduplication tidak melakukan penyiapan untuk komponen edge-message-processor dalam produksi lingkungan fleksibel App Engine.
111445518

Error MP

Prosesor Pesan terus mencatat pesan error berikut setiap 5 menit:
2019-06-29 00:02:05,775 Apigee-Timer-6 ERROR CMgmt -
  ConnectorServiceImpl.refreshToken() : Connector Management API auth token
  generation failed: 0 null
113342838

Kegagalan Cassandra dengan JMX

Operasi Cassandra tidak berfungsi saat autentikasi JMX diaktifkan
138931337

Upgrade 13 node

Peningkatan 13 instalasi node dari 17.09, 18.01, dan 18.05 gagal.
119802562

Proxy dengan nama yang sama

Jika dua pengguna di organisasi yang sama membuat proxy dengan nama yang sama, yang kedua dibuat akan menimpa yang pertama. Hal ini hanya terjadi ketika pengguna yang berbeda tidak dapat melihat {i>proxy<i} lainnya.
118851790

Keystore tidak dapat dimuat

Ketika ada lebih dari 100 keystore untuk sebuah organisasi/lingkungan, keystore dan bagian referensi di UI Edge tidak dapat dimuat. Sebagai gantinya, UI menampilkan error Internal Error (Error Fetching Keystores).
110988191

Analytics gagal

Analytics gagal untuk suatu lingkungan saat diberikan data dari Microgateway yang tetapkan ke tanggal di masa mendatang.
110785400

Kegagalan pencadangan

ZooKeeper, Cassandra, dan OpenLDAP sesekali gagal mencadangkan data dengan benar menggunakan error berikut: File changed as we read it.
79993247

HEAD permintaan ke Node.js

HEAD permintaan ke target Node.js dapat hang, dan koneksi itu masih tertunda.
70291825

pencadangan/pemulihan apigee-postgres

Menjalankan pencadangan/restore apigee-postgres kini mencadangkan data untuk semua komponen.
65737520

Mereset sandi sysadmin

Mereset sandi admin sistem untuk Server Pengelolaan yang berisi file khusus karakter tersebut akan gagal.

Masalah umum

Tabel berikut mencantumkan masalah umum dalam rilis ini:

ID Masalah Deskripsi
141628497

Jangan memberi rating pada transaksi di awal

Edge untuk Private Cloud tidak menilai transaksi di awal saat Anda pertama kali mengaktifkan monetisasi untuk organisasi. Hal ini berlaku untuk organisasi baru dan yang sudah ada.

Monetization enablement API merespons dengan ID tugas dan, setelah selesai, status tugas akan menunjukkan keberhasilan. Namun, setiap panggilan API yang dimonetisasi di awal tidak akan diproses oleh monetisasi dan tidak akan diberi rating. Transaksi ini hanya akan muncul di analisis reguler.

Solusi:

Mulai ulang Pemroses Pesan (MP), yang dapat dilakukan dengan hal berikut:
apigee-service edge-message-processor restart

Setelah monetisasi diaktifkan, memulai ulang anggota parlemen menyebabkan Edge memuat konfigurasi dari ZooKeeper saat startup. Hal ini terjadi setiap kali dimulai ulang, yang berarti masalah hanya berlaku pada awalnya.

137865184

Kebocoran memori server rating mint

Saat instance Qpid baru didaftarkan di mxgroup, antrean akan dibuat tanpa konsumen, yang mengakibatkan kedalaman antrean bertambah hingga semua resource yang tersedia digunakan.

Solusi:

Tidak ada.
135616498

Format file metadata untuk penginstalan apigee-sso

Saat menginstal apigee-sso dan menggunakan file metadata.xml, bukan URL, jika file metadata.xml tidak menyertakan baris baru (CRLF) di akhir file, file metadata.xml tidak akan dibaca sepenuhnya.

Solusi:

Untuk mengatasi masalah ini, Anda dapat melakukan salah satu hal berikut:

  • Menambahkan CRLF ke akhir file metadata.xml

    ATAU

  • Menggunakan lokasi berbasis URL untuk metadata
122370980

apigee-monit tidak didukung di Amazon Linux 1

Solusi:

Tidak ada.
121095148

Pencadangan Pemroses Pesan tidak mencadangkan kumpulan file yang benar

Solusi:

Jalankan pencadangan untuk kedua kalinya, dan kumpulan file yang benar akan dicadangkan.

76087166

DataAccessException di beberapa konfigurasi pusat data

Di beberapa konfigurasi pusat data, jika satu datastore tidak tersedia, Anda mungkin melihat error berikut:

DataAccessException: Error while accessing datastore;
Please retry later

Hasilnya, Server Pengelolaan mungkin tidak dimulai karena sedang mencoba terhubung ke Cassandra node di dc-1 dan dc-2. DataAccessExceptions terjadi jika node Cassandra ke bawah. Hal ini juga dapat mengakibatkan gangguan traffic API, yang membuat Pemroses Pesan melaporkan DataAccessExceptions saat mencoba mengambil KVM.

Perhatikan bahwa status yang diharapkan adalah Server Pengelolaan tidak terhubung ke komponen datastore lintas region.

Solusi

Solusinya adalah dengan membatalkan pendaftaran jenis node Cassandra berikut di pusat data yang tidak tersedia lalu mendaftarkannya kembali setelah node Cassandra tersedia lagi:

  • kms-datastore
  • dc-datastore
  • keyvaluemap-datastore

Untuk membatalkan pendaftaran dan mendaftarkan ulang jenis node Cassandra berikut:

  1. Dapatkan UUID node Cassandra menggunakan perintah curl berikut:
    curl -u ADMIN_EMAIL:ADMIN_PW \
      "http://MS_IP:MS_PORT/v1/servers?region=REGION&pod=GATEWAY_POD \
      &type=CASSANDRA_NODE_TYPE"

    Dengan keterangan:

    • ADMIN_EMAIL dan ADMIN_PW adalah kredensial Apigee Anda menggunakan akun layanan.
    • MS_IP dan MS_PORT adalah alamat IP dan port Server Pengelolaan angka
    • REGION adalah nama pusat data tempat Server Pengelolaan berada ditemukan.
    • GATEWAY_POD adalah nama pod, yang secara default merupakan "gateway". Anda mungkin memiliki mengubahnya menjadi nama lain, jadi periksa implementasi Anda.
    • CASSANDRA_NODE_TYPE adalah salah satu dari kms-datastore, dc-datastore, dan keyvaluemap-datastore.

    Contoh:

    curl -u nickdanger@google.com:myP@$$w0rD
      "http://192.168.0.1:8080/v1/servers?region=dc-1&pod=gateway&type=dc-datastore"

    Respons menggunakan format berikut:

    {
      "internalIP" : "POD_IP_ADDRESS",
      "isUp" : [true|false],
      "pod" : "GATEWAY_POD",
      "reachable" : [true|false],
      "region" : "dc-1",
      "tags" : {
        "property" : [ ]
      },
      "type" : [ "kms-datastore", "dc-datastore", "keyvaluemap-datastore" ],
        "uUID" : "POD_UUID"
    }

    Contoh:

    {
      "internalIP" : "192.168.1.11",
      "isUp" : false,
      "pod" : "gateway",
      "reachable" : false,
      "region" : "dc-1",
      "tags" : {
        "property" : [ ]
      },
      "type" : "dc-datastore",
      "uUID" : "13cee956-d3a7-4577-8f0f-1694564179e4"
    }

    Perhatikan nilai kolom uUID dalam respons. Anda akan menggunakannya untuk membatalkan pendaftaran node.

  2. Ulangi langkah satu untuk setiap jenis node Cassandra: kms-datastore, dc-datastore, dan keyvaluemap-datastore. Pastikan untuk memperhatikan UUID yang ditampilkan.
  3. Batalkan pendaftaran node menggunakan perintah berikut:
    curl -u ADMIN_EMAIL:ADMIN_PW "http://MS_IP:MS_PORT/v1/servers/UUID" -X DELETE

    Dengan UUID adalah UUID yang ditampilkan dalam respons perintah sebelumnya.

  4. Ulangi langkah 3 untuk setiap UUID yang Anda kumpulkan pada langkah 1 dan 2.
  5. Daftarkan ulang node menggunakan perintah berikut:
    curl -u ADMIN_EMAIL:ADMIN_PW "http://MS_IP:MS_PORT/v1/servers -d \
      "Type=kms-datastore&Type=dc-datastore&Type=keyvaluemap-datastore& \
      Type=counter-datastore&Type=cache-datastore&InternalIP=POD_IP_ADDRESS& \
      region=REGION&pod=GATEWAY_POD" -H \
      'content-type: application/x-www-form-urlencoded' -X POST

Perlu diingat bahwa operasi ini mendaftarkan dan membatalkan pendaftaran node dari Zookeeper dan dampak pada gugus Cassandra. Untuk informasi selengkapnya tentang perintah ini, lihat Memperbarui pendaftaran datastore.

68722102

Kebijakan MessageLogging termasuk informasi tambahan dalam pesan log

Elemen FormatMessage kebijakan MessageLogging mengontrol format pesan yang dicatat dalam log. Saat FormatMessage=false, pesan yang dicatat dalam log tidak seharusnya menyertakan informasi yang dibuat Apigee. Namun, meskipun Anda menetapkan FormatMessage=false, pesan log tetap menyertakan informasi berikut:

  • Skor prioritas
  • Stempel waktu

Solusi:

Tidak ada.

Langkah berikutnya

Untuk mulai menggunakan Edge untuk Private Cloud 4.19.06, gunakan link berikut:

Penginstalan baru:
Ringkasan penginstalan baru
Penginstalan yang ada:
Jalur upgrade