4.19.06 Edge for Private Cloud sürüm notları

Apigee Edge belgelerini görüntülüyorsunuz.
Apigee X belgelerine gidin.
bilgi

Bu bölümde, Private Cloud Özellik Sürümü için Edge'in 4.19.06 sürümü açıklanmaktadır.

Sürüm özeti

Aşağıdaki tabloda bu sürümdeki değişiklikler özetlenmektedir:

Yeni Özellikler

Bu sürüm aşağıdaki yeni özellikleri içerir:

○ TOA için LDAP desteği
○ HTTP dağıtım desteği
○ Takılabilir analiz
○ Cassandra raf desteği
○ IPv6 desteği
Basitleştirilmiş Yeni Edge deneyimi kurulumu
INVALID_TSC işlemleri hariç tutma (Para kazanma)

Bu yeni özelliklerin her biri hakkında daha fazla bilgi için Yeni özellikler bölümüne göz atın.

Geriye Dönük Uyumluluk

Geriye dönük uyumluluğu etkileyen aşağıdaki sorunlar, Private Cloud için Apigee Edge'in bu sürümünde kullanıma sunulmuştur:

     
  • 19.03.01 Herkese Açık Cloud sürüm notlarında açıklandığı üzere 132443137 numaralı sorunun düzeltilmesi nedeniyle Mesaj İşleyiciler artık X-Apigee-* ile başlayan üstbilgileri yok sayıyor. Bu nedenle, X-Apigee-* üst bilgilerini kullanan tüm kodları yeniden düzenleyerek bu başlıkları desteklenen başlıklarla değiştirmeniz gerekir.

  • Cassandra günlük dosyalarının adı değişti. Şimdi:

    /opt/apigee/var/log/apigee-cassandra/system.log
Dahil Edilen Sürümler

Önceki Edge for Private Cloud Özellik Sürümü'nden bu yana aşağıdaki sürümler çıktı ve bu sürüme dahil edildi:

○ Edge:
   19.07.23 (Kullanıcı Arayüzü)
   19.03.01
   19.02.19
   19.02.04
   19.01.23
{11.23
{11.
4 19.
○ Portal:
   19.07.08
   19.05.23
   19.05.08
   19.04.18
   19.03.20

{/1.5 {/1.5 {/1.02.

Emeklilik Yok
Kullanımdan kaldırmalar

4.19.06 sürümüyle birlikte aşağıdakiler kullanımdan kaldırılmıştır:

  • 4.18.01: Private Cloud için Apigee Edge'in 4.18.01 sürümü kullanımdan kaldırıldı.

Daha fazla bilgi için Apigee'nin kullanımdan kaldırılması, kullanımdan kaldırılması ve CPS değişiklikleri bölümünü inceleyin.

Hata Düzeltmeleri

Bu sürüm aşağıdaki hata düzeltmelerini içerir:

7027015 son model yedekler










HEAD

Bu düzeltmelerin her biri hakkında daha fazla bilgi edinmek için Hata düzeltmeleri sayfasına göz atın.

Bilinen Sorunlar

Bu sürüm aşağıdaki bilinen sorunları içermektedir:

○ İlk etapta derecelendirme olmayan işlemler (141628497) 88 70 Mesaj kaydı kapsamı 6 88 Eşitleme günlüğü veya 70 Mesaj kaydı kapsamı 7






apigee-monit

Bu bilinen sorunların her biri ve çözümleri hakkında daha fazla bilgi için Bilinen sorunlar'a bakın.

Yeni sürüme geçirme yolları

Aşağıdaki tabloda bu sürümün yükseltme yolları gösterilmektedir:

19.04.01'den itibaren Doğrudan 4.19.01 → 4.19.06 sürümünden yükseltme
18.05.05'ten itibaren Doğrudan 4.18.05 → 4.19.06 sürümünden yükseltme
18.04.01'den itibaren Doğrudan 4.18.01 → 4.19.06 sürümünden yükseltme

Yeni özellikler

Bu bölümde, bu sürümdeki yeni özellikler listelenmiştir. Ayrıca bu sürüm, Dahil Olan Sürümler'de listelenen Edge Kullanıcı Arayüzü, Edge Yönetimi ve Portal sürümlerindeki tüm özellikleri içerir.

Bu sürüm, aşağıdaki geliştirmelerin yanı sıra kullanılabilirlik, performans, güvenlik ve kararlılıkla ilgili birçok geliştirmeyi de içermektedir.

HTTP dağıtım desteği

Varsayılan olarak Edge, API proxy'lerini dağıtmak için RPC'yi kullanır. Bu mod çoğu yükleme için çok iyi çalışsa da RPC üzerinden çok sayıda eşzamanlı çağrı yapıldığında çok sayıda MP'ye sahip daha büyük topolojilerde zaman aşımları yaşanabilir.

Sonuç olarak Apigee, daha büyük dağıtımlarda dağıtım için RPC yerine HTTP kullanılmasını önerir. HTTP dağıtımlarını etkinleştirme artık desteklenmektedir.

Daha fazla bilgi için HTTP dağıtımını etkinleştirme bölümüne bakın.

Cassandra raf desteği

Apigee, artık Cassandra'yı Apigee Edge'de Özel Bulut rafına duyarlı hale getirerek Cassandra'nın ölçeklendirme operasyonlarına genel rehberlik sağlar.

Daha fazla bilgi için Cassandra rafı desteği sayfasına göz atın.

Tak-çıkar analiz

Mesaj İşleyici tarafından toplanan analiz verileri, varsayılan olarak işlenmek üzere Qpid ve Postgres'e yüklenir. Ardından analiz verilerini Edge kullanıcı arayüzünde görüntüleyebilirsiniz.

Bu Özellik Sürümü ile Mesaj İşleyici'yi analiz verilerini diske yazacak şekilde yapılandırabilir veya her iki seçeneği de kullanabilirsiniz.

Daha fazla bilgi için Analiz verilerini bir dosyaya yazma bölümüne bakın.

Basitleştirilmiş Yeni Edge deneyimi yüklemesi

Yeni Edge deneyiminin yüklenmesi yeni bir komut dosyasıyla basitleştirilmiştir.

Daha fazla bilgi için Yeni Uç Deneyimini Yükleme konusuna bakın.

LDAP IdP desteği

Edge Kullanıcı Arayüzü ve Edge Management API çağrılarıyla kullanıcıların kimlik doğrulaması, artık SAML'nin yanı sıra LDAP'yi de desteklemektedir. LDAP desteği hem doğrudan bağlama hem de dolaylı bağlama yöntemlerini içerir.

Daha fazla bilgi için Harici IdP kimlik doğrulamasına genel bakış sayfasına göz atın.

IPv6 desteği

Varsayılan olarak, Private Cloud için Apigee Edge'e yapılan tüm çalışma zamanı API çağrıları IPv4'ü kullanır. Yönlendiriciye yeni bir özellik kullanarak IPv6 desteği ekleyebilirsiniz.

Daha fazla bilgi için Yönlendiricide IPv6 kullanma konusuna bakın.

INVALID_TSC işlemleri hariç tut (Para kazanma)

Artık Para Kazanma özelliğini kullanırken INVALID_TSC işlemlerinin Postgres veritabanına eklenmemesini sağlayabilirsiniz.

Daha fazla bilgi için Para kazanma sunucu özellikleri başlıklı makaleyi inceleyin.

Desteklenen yazılımlar

Bu sürüm, desteklenen yazılımlarda yapılan aşağıdaki değişiklikleri içerir:

Destek Eklendi Artık Desteklenmiyor

Bu sürümle aşağıdaki platformlar için destek eklendi:

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

Bu sürümde aşağıdaki platformlar artık desteklenmiyor:

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

Desteklenen platformların tam listesi için Desteklenen yazılımlar ve desteklenen sürümler konusuna bakın.

Hata düzeltmeleri

Bu bölümde, bu sürümde düzeltilen Private Cloud hataları listelenir. Ayrıca bu sürüm, Dahil Olan Sürümler'de gösterilen Edge kullanıcı arayüzü, Edge Yönetimi ve Portal sürümlerindeki tüm hata düzeltmelerini içerir.

Sorun Kimliği Açıklama
140270474

UseStringDeduplication ayarlanmadı

UseStringDeduplication, üretim ortamlarında edge-message-processor bileşenleri için ayarlanmıyordu.
111445518

MP hataları

Mesaj İşleyiciler sürekli olarak her 5 dakikada bir şu hata mesajını günlüğe kaydeder:
2019-06-29 00:02:05,775 Apigee-Timer-6 ERROR CMgmt -
  ConnectorServiceImpl.refreshToken() : Connector Management API auth token
  generation failed: 0 null
113342838

JMX ile Cassandra hataları

JMX kimlik doğrulaması etkinleştirildiğinde Cassandra işlemleri çalışmıyordu
138931337

13 düğüm yükseltmeleri

17.09, 18.01 ve 18.05 sürümlerindeki 13 düğümlü yüklemelerin yükseltme işlemleri başarısız oluyordu.
119802562

Aynı ada sahip proxy'ler

Aynı kuruluştaki iki kullanıcı aynı adlara sahip proxy'ler oluşturursa oluşturulan ikinci proxy ilkinin üzerine yazılır. Bu sorun yalnızca farklı kullanıcılar diğer proxy'yi göremediğinde meydana geliyordu.
118851790

Anahtar depoları yüklenmiyor

Bir kuruluş/ortam için 100'den fazla anahtar deposu olduğunda, Edge kullanıcı arayüzündeki anahtar deposu ve referans bölümü yüklenmiyordu. Bunun yerine, kullanıcı arayüzünde bir Internal Error (Error Fetching Keystores) hatası gösteriliyordu.
110988191

Analiz başarısız oldu

Analytics, Microgateway'den gelecek bir tarihe ayarlanmış veriler sağlandığında bir ortam için başarısız oldu.
110785400

Yedekleme hataları

ZooKeeper, Cassandra ve OpenLDAP, verilerini aralıklarla yedekleyemedi ve şu hata oluştu: File changed as we read it.
79993247

Node.js'ye HEAD istek

Node.js hedefine yapılan HEAD istekleri kilitlenebilir ve bu durum, bağlantılar beklemede kalır.
70291825

Apigee-postgres yedekleme/geri yükleme

Apigee-postgres yedekleme/geri yükleme işlemi yürütmek artık tüm bileşenlerin verilerini yedekliyor.
65737520

Sysadmin şifresini sıfırlama

Yönetim Sunucusu için özel karakterler içeren sistem yöneticisi şifresinin sıfırlanması başarısız olur.

Bilinen sorunlar

Bu sürümdeki bilinen sorunlar aşağıdaki tabloda listelenmiştir:

Sorun Kimliği Açıklama
141628497

Başlangıçta işlemlerde puan vermeyen darphane

Private Cloud için Edge, bir kuruluş için para kazanmayı ilk kez etkinleştirdiğinizde işlemleri başlangıçta derecelendirmez. Bu durum yeni ve mevcut kuruluşlar için geçerlidir.

Para kazanma etkinleştirme API'si iş kimliğiyle yanıt verir ve tamamlandığında işin durumu başarılı olarak gösterilir. Ancak başlangıçta para kazandıran API çağrıları, para kazanma tarafından işlenmeyecek ve derecelendirilmeyecek. Bu işlemler yalnızca normal analizlerde gösterilir.

Geçici çözüm:

Mesaj İşleyicileri (MP'ler) yeniden başlatın. Bu işlemler:
apigee-service edge-message-processor restart

Para kazanma özelliği etkinleştirildikten sonra MP'lerin yeniden başlatılması, Edge'in başlangıçta ZooKeeper'dan yapılandırmayı yüklemesine neden olur. Bu durum, her yeniden başlatma işleminde ortaya çıkar, yani sorun yalnızca başlangıçta geçerlidir.

137865184

Mint puan sunucuları bellek sızıntısı

Yeni bir Qpid örneği bir mxgroup'a kaydedildiğinde sıralar tüketici olmadan derlenir. Bu da, mevcut tüm kaynakları kullanana kadar sıra derinliğinin büyümesine neden olur.

Geçici çözüm:

Yok.
135616498

Apigee-sso install için meta veri dosyası biçimi

apigee-sso yüklenirken ve URL yerine birMetadata.xml dosyası kullanılırken,Metadata.xml dosyası dosyanın sonunda yeni bir satır (CRLF) içermiyorsa meta veri.xml dosyası tamamen okunmaz.

Geçici çözüm:

Bu sorunu çözmek için aşağıdakilerden birini yapabilirsiniz:

  • ecommerce.xml dosyasının sonuna bir CRLF ekleyin

    VEYA

  • Meta veriler için URL tabanlı bir konum kullan
122370980

apigee-monit, Amazon Linux 1'de desteklenmiyor

Geçici çözüm:

Yok.
121095148

İleti İşleyici yedeği doğru dosya grubunu yedeklemiyor

Geçici çözüm:

Yedeklemeyi ikinci kez çalıştırdığınızda doğru dosya grubunun yedeklenmesi gerekir.

76087166

Birden çok veri merkezi yapılandırmasında DataAccessException

Birden fazla veri merkezi yapılandırmasında, bir veri deposu kullanılamaz hale gelirse aşağıdaki hatayı görebilirsiniz:

DataAccessException: Error while accessing datastore;
Please retry later

Sonuç olarak, Yönetim Sunucusu hem dc-1 hem de dc-2'de Cassandra düğümlerine bağlanmaya çalıştığı için başlatılamayabilir. Bir Cassandra düğümü devre dışıysa DataAccessExceptions oluşur. Bu durum, Mesaj İşleyicilerin KVM'leri almaya çalışırken DataAccessExceptions bildirdiği API trafiği kesintilerine de yol açabilir.

Beklenen durumun Yönetim Sunucusu'nun bölgeler genelindeki veri deposu bileşenlerine bağlanmaması olduğunu unutmayın.

Geçici çözüm

Geçici çözüm, kullanılamayan veri merkezindeki aşağıdaki Cassandra düğüm türlerinin kaydını silmek ve Cassandra düğümleri tekrar kullanılabilir hale geldikten sonra bunları yeniden kaydetmektir:

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

Bu Cassandra düğüm türlerinin kaydını iptal etmek ve yeniden kaydetmek için:

  1. Aşağıdaki curl komutunu kullanarak Cassandra düğümlerinin UUID'lerini alın:
    curl -u ADMIN_EMAIL:ADMIN_PW \
      "http://MS_IP:MS_PORT/v1/servers?region=REGION&pod=GATEWAY_POD \
      &type=CASSANDRA_NODE_TYPE"

    Burada:

    • ADMIN_EMAIL ve ADMIN_PW, Apigee hesabınızın kimlik bilgileridir.
    • MS_IP ve MS_PORT, Yönetim Sunucusu'nun IP adresi ve bağlantı noktası numarasıdır.
    • REGION, Yönetim Sunucusu'nun bulunduğu veri merkezinin adıdır.
    • GATEWAY_POD, varsayılan olarak "ağ geçidi" olan kapsül adıdır. Ancak, etiketi farklı bir şekilde yeniden adlandırmış olabilirsiniz. Bu nedenle uygulamanızı kontrol edin.
    • CASSANDRA_NODE_TYPE şunlardan biridir: kms-datastore, dc-datastore ve keyvaluemap-datastore.

    Örneğin:

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

    Yanıtta şu biçim kullanılır:

    {
      "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"
    }

    Örneğin:

    {
      "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"
    }

    Yanıttaki uUID alanının değerlerini not edin. Bunları kullanarak düğümlerin kaydını iptal edebilirsiniz.

  2. Her Cassandra düğüm türü için birinci adımı tekrarlayın: kms-datastore, dc-datastore ve keyvaluemap-datastore. Döndürülen UUID'leri not etmeyi unutmayın.
  3. Aşağıdaki komutu kullanarak düğümlerin kaydını iptal edin:
    curl -u ADMIN_EMAIL:ADMIN_PW "http://MS_IP:MS_PORT/v1/servers/UUID" -X DELETE

    Burada UUID, önceki komutun yanıtında döndürülen UUID'dir.

  4. 1. ve 2. adımda topladığınız her UUID için 3. adımı tekrarlayın.
  5. Aşağıdaki komutu kullanarak düğümleri yeniden kaydedin:
    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

Bu işlemlerin, düğümleri kaydeden ve Zookeeper'daki kaydını iptal ettiğini, bunların Cassandra kümesi üzerinde herhangi bir etkisinin olmadığını unutmayın. Bu komutlar hakkında daha fazla bilgi için Datastore kayıtlarını güncelleme bölümüne bakın.

68722102

Günlük mesajında ek bilgiler içeren MessageLogging politikası

MessageLogging politikasının FormatMessage öğesi, günlüğe kaydedilen mesajın biçimini kontrol eder. FormatMessage=false olduğunda, günlüğe kaydedilen mesajın Apigee tarafından oluşturulan herhangi bir bilgi içermemesi gerekir. Ancak, FormatMessage=false değerini ayarlasanız bile günlük mesajı aşağıdaki bilgileri içerir:

  • Öncelik puanı
  • Zaman damgası

Geçici çözüm:

Yok.

Sonraki adım

Edge for Private Cloud 4.19.06 sürümünü kullanmaya başlamak için aşağıdaki bağlantıları kullanın:

Yeni yüklemeler:
Yeni yüklemeye genel bakış
Mevcut yüklemeler:
Yeni sürüme geçiş yolları