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 untuk Private Cloud versi 4.19.06.

Ringkasan rilis

Tabel berikut merangkum 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 New Edge yang disederhanakan
○ Mengecualikan transaksi INVALID_TSC (Monetisasi)

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

Kompatibilitas Mundur

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

     
  • Karena perbaikan untuk masalah 132443137 (seperti yang dijelaskan dalam catatan rilis Cloud Publik 19.03.01), Pemroses Pesan kini mengabaikan header yang diawali dengan X-Apigee-*. Oleh karena itu, Anda harus memfaktorkan ulang kode apa pun yang menggunakan header X-Apigee-* dan mengganti header tersebut dengan header yang didukung.

  • Nama file log Cassandra telah berubah. Sekarang:

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

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

○ Edge:
   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, berikut ini tidak digunakan lagi:

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

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

Perbaikan Bug

Rilis ini mencakup perbaikan bug berikut:

○ UseStringDeduplication 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)
○ Permintaan HEAD ke Node.js (79993247)
○ Pencadangan/pemulihan apigee-postgres (70291825)
○ Mereset sandi admin sistem (65737520)

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

Masalah Umum

Rilis ini mencakup masalah umum berikut:

○ Mint tidak memberi rating transaksi pada awalnya (141628497)
○ Kebocoran memori server rating Mint (137865184)
○ Format file metadata untuk penginstalan apigee-sso (135616498)
apigee-monit tidak didukung di Amazon Linux 1 (122370980)
○ Pencadangan Message Processor tidak mencadangkan kumpulan file yang benar (121095148)
○ DataAccessException dalam konfigurasi multi-pusat data (76087166)
○ Kebijakan MessageLogging menyertakan informasi tambahan dalam pesan log (68722102)

Untuk mengetahui 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 mencakup semua fitur dalam rilis Edge UI, Edge Management, dan Portal yang tercantum dalam Rilis yang Disertakan.

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

Dukungan deployment HTTP

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

Oleh karena itu, Apigee merekomendasikan agar deployment yang lebih besar menggunakan HTTP, bukan RPC, untuk deployment. Deployment HTTP kini didukung.

Untuk mengetahui informasi selengkapnya, lihat Mengaktifkan deployment HTTP.

Dukungan rak Cassandra

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

Untuk mengetahui informasi selengkapnya, lihat Dukungan rak Cassandra.

Analisis yang dapat di-plug-in

Secara default, data analisis yang dikumpulkan oleh Message Processor diupload ke Qpid dan Postgres untuk diproses. Kemudian, Anda dapat melihat data analisis di UI Edge.

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

Untuk mengetahui informasi selengkapnya, lihat Menulis data analisis ke file.

Penginstalan pengalaman New Edge yang disederhanakan

Penginstalan New Edge telah disederhanakan dengan skrip baru.

Untuk mengetahui informasi selengkapnya, lihat Menginstal New Edge Experience.

Dukungan IDP LDAP

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

Untuk mengetahui informasi selengkapnya, lihat Ringkasan autentikasi IdP eksternal.

Dukungan IPv6

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

Untuk mengetahui informasi selengkapnya, lihat Menggunakan IPv6 di Router.

Mengecualikan transaksi INVALID_TSC (Monetisasi)

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

Untuk mengetahui informasi selengkapnya, lihat Properti server Monetisasi.

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 dengan 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 diperbaiki dalam rilis ini. Selain itu, rilis ini mencakup semua perbaikan bug dalam rilis Edge UI, Edge Management, dan Portal yang ditampilkan di Rilis yang Disertakan.

ID Masalah Deskripsi
140270474

UseStringDeduplication tidak disetel

UseStringDeduplication tidak ditetapkan untuk komponen edge-message-processor di lingkungan produksi.
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

Upgrade penginstalan 13 node dari 17.09, 18.01, dan 18.05 gagal.
119802562

Proxy dengan nama yang sama

Jika dua pengguna dalam organisasi yang sama membuat proxy dengan nama yang sama, proxy yang dibuat kedua akan menggantikan proxy yang dibuat pertama. Hal ini hanya terjadi jika pengguna yang berbeda tidak dapat melihat proxy lainnya.
118851790

Keystore tidak dimuat

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

Analytics gagal

Analytics gagal untuk lingkungan saat diberi data dari Microgateway yang ditetapkan ke tanggal di masa mendatang.
110785400

Kegagalan pencadangan

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

Permintaan HEAD ke Node.js

Permintaan HEAD ke target Node.js dapat terhenti, yang membuat koneksi tertunda.
70291825

Pencadangan/pemulihan apigee-postgres

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

Mereset sandi admin sistem

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

Masalah umum

Tabel berikut mencantumkan masalah umum dalam rilis ini:

ID Masalah Deskripsi
141628497

Mint tidak memberikan rating transaksi pada awalnya

Edge for the Private Cloud tidak menilai transaksi pada awalnya 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 yang dilakukan pada awalnya tidak akan diproses oleh monetisasi dan tidak akan diberi rating. Transaksi ini hanya akan muncul di analisis reguler.

Solusi:

Mulai ulang Prosesor Pesan (MP) apa pun, yang dapat dilakukan dengan langkah-langkah berikut:
apigee-service edge-message-processor restart

Setelah monetisasi diaktifkan, memulai ulang MP akan menyebabkan Edge memuat konfigurasi dari ZooKeeper saat startup. Hal ini terjadi pada setiap mulai ulang, yang berarti bahwa masalah hanya berlaku pada awalnya.

137865184

Kebocoran memori server rating Mint

Saat instance Qpid baru didaftarkan dalam mxgroup, antrean akan dibuat tanpa konsumen, sehingga kedalaman antrean akan bertambah hingga menggunakan semua resource yang tersedia.

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 tindakan berikut:

  • Tambahkan CRLF di akhir file metadata.xml

    ATAU

  • Menggunakan lokasi berbasis URL untuk metadata
122370980

apigee-monit tidak didukung di Amazon Linux 1

Solusi:

Tidak ada.
121095148

Cadangan Message Processor tidak mencadangkan kumpulan file yang benar

Solusi:

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

76087166

DataAccessException dalam beberapa konfigurasi pusat data

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

DataAccessException: Error while accessing datastore;
Please retry later

Akibatnya, Server Pengelolaan mungkin tidak dimulai karena mencoba terhubung ke node Cassandra di dc-1 dan dc-2. DataAccessExceptions terjadi jika node Cassandra tidak aktif. Hal ini juga dapat menyebabkan gangguan traffic API, saat Pemroses Pesan melaporkan DataAccessExceptions saat mencoba mengambil KVM.

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

Solusi

Solusinya adalah 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 ini:

  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:

    • ADMIN_EMAIL dan ADMIN_PW adalah kredensial akun Apigee Anda.
    • MS_IP dan MS_PORT adalah alamat IP dan nomor port Server Pengelolaan.
    • REGION adalah nama pusat data tempat Server Pengelolaan berada.
    • GATEWAY_POD adalah nama pod, yang secara default adalah "gateway". Anda mungkin telah mengganti namanya menjadi sesuatu yang lain, jadi periksa penerapan 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"
    }

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

  2. Ulangi langkah pertama untuk setiap jenis node Cassandra: kms-datastore, dc-datastore, dan keyvaluemap-datastore. Pastikan untuk mencatat 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

Perhatikan bahwa operasi ini mendaftarkan dan membatalkan pendaftaran node dari Zookeeper dan tidak berdampak pada cluster Cassandra. Untuk mengetahui informasi selengkapnya tentang perintah ini, lihat Memperbarui pendaftaran datastore.

68722102

Kebijakan MessageLogging yang menyertakan informasi tambahan dalam pesan log

Elemen FormatMessage dari kebijakan MessageLogging mengontrol format pesan yang dicatat ke dalam log. Jika FormatMessage=false, pesan yang dicatat tidak boleh menyertakan informasi yang dihasilkan 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 for Private Cloud 4.19.06, gunakan link berikut:

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