4.19.06 Edge untuk catatan rilis Private Cloud

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

Bagian ini menjelaskan Edge untuk Rilis Fitur 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 Edge Baru yang Disederhanakan
○ Kecualikan INVALID_TSC transaksi (Monetisasi)

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

Kompatibilitas Mundur

Masalah yang memengaruhi kompatibilitas mundur berikut 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), Prosesor Pesan sekarang mengabaikan header yang dimulai dengan X-Apigee-*. Akibatnya, Anda harus memfaktorkan ulang kode apa pun yang menggunakan header X-Apigee-* dan mengganti header tersebut dengan yang didukung.

  • Nama file log Cassandra telah berubah. Sekarang menjadi:

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

Sejak Edge untuk Rilis Fitur 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
   19
   19.01.1418.12.0418.08.3118.07.31
○ Portal:
   19.07.08
   19.05.23
   19.05.08
   19.04.18
   19.03.20
   19.02.2719.02.2119.02.0419.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 mengetahui informasi selengkapnya, lihat Penghentian penggunaan Apigee, penghentian, dan perubahan CPS.

Perbaikan Bug

Rilis ini mencakup perbaikan bug berikut:

○ UseStringDeduplikasi not set (140270474)
○ restores errors (111445518)
○ Cassandra fail with JMX (113342838)
○ 13-node Keystores (138931337)
○1 Proxies with the same






HEAD

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

Masalah Umum

Rilis ini mencakup masalah umum berikut:

○2 Mint tidak memberi rating transaksi di awal (141628497)
○ Kebocoran memori server rating Mint (137865184)
○ Format file metadata untuk penginstalan apigee-sso




apigee-monit

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

Jalur upgrade

Tabel berikut menunjukkan jalur upgrade untuk rilis ini:

From 4.19.01 Langsung upgrade dari 4.19.01 → 4.19.06
Mulai dari 4.18.05 Langsung upgrade dari 4.18.05 → 4.19.06
Dari 4.18.01 Langsung upgrade dari 4.18.01 → 4.19.06

Fitur baru

Bagian ini mencantumkan fitur baru dalam rilis ini. Selain itu, rilis ini mencakup semua fitur di UI Edge, Pengelolaan Edge, dan rilis 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 banyak panggilan serentak dilakukan melalui RPC.

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

Untuk mengetahui informasi selengkapnya, lihat Mengaktifkan deployment HTTP.

Dukungan rak Cassandra

Apigee kini menyediakan panduan umum untuk penskalaan operasi Cassandra dengan membuat Cassandra di Apigee Edge untuk rack Private Cloud peka.

Untuk mengetahui 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. Selanjutnya, Anda dapat melihat data analisis di UI Edge.

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

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 Edge UI dan API pengelolaan Edge kini mendukung LDAP selain SAML. Dukungan LDAP mencakup metode binding langsung dan tidak langsung.

Untuk 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.

Kecualikan INVALID_TSC transaksi (Monetisasi)

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

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

ID Masalah Deskripsi
140270474

UseStringDeduplikasi tidak ditetapkan

UseStringDeduplication tidak disiapkan untuk komponen edge-message-processor di lingkungan produksi.
111445518

Error MP

Pemroses Pesan terus-menerus mencatat pesan error berikut ke dalam log 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 instalasi 13 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, proxy kedua yang dibuat akan menimpa proxy pertama. Hal ini hanya terjadi saat 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 dapat dimuat. Sebagai gantinya, UI menampilkan error Internal Error (Error Fetching Keystores).
110988191

Analytics gagal

Analisis gagal untuk suatu lingkungan jika disediakan dengan data dari Microgateway yang ditetapkan ke tanggal di masa mendatang.
110785400

Kegagalan pencadangan

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

Permintaan HEAD ke Node.js

Permintaan HEAD ke target Node.js dapat mengalami hang, sehingga koneksi tertunda.
70291825

pencadangan/pemulihan apigee-postgres

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

Mereset sandi sysadmin

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 pada transaksi di awal

Edge untuk Private Cloud tidak memberikan rating pada transaksi di awal saat Anda pertama kali mengaktifkan monetisasi untuk organisasi. Hal ini berlaku untuk organisasi baru dan lama.

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

Solusi:

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

Setelah monetisasi diaktifkan, memulai ulang anggota MP akan menyebabkan Edge memuat konfigurasi dari ZooKeeper saat memulai. Hal ini terjadi setiap memulai ulang komputer, yang berarti masalah hanya berlaku di awal.

137865184

Kebocoran memori server rating Mint

Saat instance Qpid baru didaftarkan di mxgroup, antrean dibangun tanpa konsumen, yang mengakibatkan kedalaman antrean 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 langkah berikut:

  • Tambahkan 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 pencadangan kumpulan file yang benar.

76087166

DataAccessException di beberapa konfigurasi pusat data

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

DataAccessException: Error while accessing datastore;
Please retry later

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

Perhatikan bahwa status yang diharapkan adalah agar 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 kembali:

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

Untuk membatalkan pendaftaran dan mendaftarkan ulang jenis node Cassandra ini:

  1. Dapatkan UUID node Cassandra dengan 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 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 berupa "gateway". Namun, Anda mungkin telah mengganti namanya menjadi yang 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"
    }

    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 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 diperhatikan bahwa operasi ini mendaftarkan dan membatalkan pendaftaran node dari Zookeeper, serta tidak berdampak apa pun pada cluster Cassandra. Untuk mengetahui informasi selengkapnya tentang perintah ini, lihat Memperbarui pendaftaran datastore.

68722102

Kebijakan MessageLogging menyertakan 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 dihasilkan Apigee. Namun, meskipun Anda menetapkan FormatMessage=false, pesan log tetap menyertakan informasi berikut:

  • Skor prioritas
  • Stempel waktu

Solusi:

Tidak ada.

Langkah berikutnya

Untuk memulai Edge untuk Private Cloud 4.19.06, gunakan tautan berikut:

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