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, Edge for Private Cloud Feature Release'in 4.19.06 sürümü açıklanmaktadır.

Sürüm özeti

Bu sürümdeki değişiklikler aşağıdaki tabloda özetlenmiştir:

Yeni Özellikler

Bu sürümde aşağıdaki yeni özellikler yer almaktadır:

○ SSO için LDAP desteği
○ HTTP dağıtım desteği
○ Takılabilir analizler
○ Cassandra raf desteği
○ IPv6 desteği
○ Basitleştirilmiş New Edge deneyimi yüklemesi
INVALID_TSC işlemlerini hariç tutma (para kazanma)

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

Geriye Dönük Uyumluluk

Apigee Edge Private Cloud'un bu sürümünde geriye dönük uyumluluğu etkileyen aşağıdaki sorunlar ortaya çıkmıştır:

     
  • 132443137 numaralı sorunun düzeltilmesi nedeniyle (19.03.01 Public Cloud sürüm notlarında açıklandığı gibi) ileti işlemciler artık X-Apigee-* ile başlayan üstbilgileri yoksayıyor. Bu nedenle, X-Apigee-* üstbilgilerini kullanan tüm kodları yeniden düzenlemeniz ve bu üstbilgileri desteklenen üstbilgilerle değiştirmeniz gerekir.

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

    /opt/apigee/var/log/apigee-cassandra/system.log
Dahil Edilen Yayınlar

Önceki Edge for Private Cloud Feature Release'den bu yana aşağıdaki sürümler yayınlandı ve bu sürüme dahil edildi:

○ 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
Kullanımdan kaldırma Yok
Kullanımdan kaldırmalar

4.19.06 sürümünün yayınlanmasıyla birlikte aşağıdakilerin desteği sonlandırılacak:

  • 4.18.01: Apigee Edge Private Cloud'un 4.18.01 sürümünün desteği artık sonlandırıldı.

Daha fazla bilgi için Apigee'de desteği sonlandırılan ve kullanımdan kaldırılan özellikler ile CPS değişiklikleri başlıklı makaleyi inceleyin.

Hata Düzeltmeleri

Bu sürümde aşağıdaki hata düzeltmeleri yer almaktadır:

○ UseStringDeduplication ayarlanmadı (140270474)
○ MP hataları (111445518)
○ JMX ile Cassandra hataları (113342838)
○ 13 düğümlü yükseltmeler (138931337)
○ Aynı ada sahip proxy'ler (119802562)
○ Anahtar depoları yüklenmiyor (118851790)
○ Analytics başarısız oldu (110988191)
○ Yedekleme hataları (110785400)
○ Node.js'ye HEAD istekleri (79993247)
○ apigee-postgres yedekleme/geri yükleme (70291825)
○ sysadmin şifresini sıfırlama (65737520)

Bu düzeltmelerin her biri hakkında daha fazla bilgi için Hata düzeltmeleri bölümüne bakın.

Bilinen Sorunlar

Bu sürümde aşağıdaki bilinen sorunlar bulunmaktadır:

○ Mint'in başlangıçta işlemleri derecelendirmemesi (141628497)
○ Mint derecelendirme sunucularında bellek sızıntısı (137865184)
○ apigee-sso yüklemesi için meta veri dosya biçimi (135616498)
apigee-monit, Amazon Linux 1'de desteklenmiyor (122370980)
○ Mesaj İşleyici yedeklemesi, doğru dosya grubunu yedeklemiyor (121095148)
○ Çoklu veri merkezi yapılandırmalarında DataAccessExceptions (76087166)
○ MessageLogging politikası, günlük mesajına ek bilgiler ekliyor (68722102)

Geçici çözümler de dahil olmak üzere bu bilinen sorunların her biri hakkında daha fazla bilgi için Bilinen sorunlar başlıklı makaleye bakın.

Yükseltme yolları

Aşağıdaki tabloda, bu sürüm için yükseltme yolları gösterilmektedir:

4.19.01 sürümünden itibaren Doğrudan 4.19.01 sürümünden 4.19.06 sürümüne yükseltme
4.18.05 sürümünden itibaren Doğrudan 4.18.05 sürümünden 4.19.06 sürümüne yükseltme
4.18.01 sürümünden itibaren Doğrudan 4.18.01 sürümünden 4.19.06 sürümüne yükseltme

Yeni özellikler

Bu bölümde, bu sürümdeki yeni özellikler listelenmektedir. Ayrıca bu sürüm, Dahil Edilen Sürümler bölümünde listelenen Edge kullanıcı arayüzü, Edge yönetimi ve Portal sürümlerindeki tüm özellikleri içerir.

Bu sürümde aşağıdaki geliştirmelerin yanı sıra kullanılabilirlik, performans, güvenlik ve kararlılıkla ilgili birçok geliştirme de yer almaktadır.

HTTP dağıtım desteği

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

Bu nedenle 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ın etkinleştirilmesi artık desteklenmektedir.

Daha fazla bilgi için HTTP dağıtımını etkinleştirme başlıklı makaleyi inceleyin.

Cassandra raf desteği

Apigee artık Cassandra'yı Apigee Edge for Private Cloud'da raf farkındalığına sahip hale getirerek Cassandra'nın ölçeklendirme işlemleri için genel rehberlik sunuyor.

Daha fazla bilgi için Cassandra raf desteği bölümüne bakın.

Takılabilir analizler

Varsayılan olarak, Mesaj İşleyici tarafından toplanan analiz verileri 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üyle birlikte, 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 dosyaya yazma başlıklı makaleyi inceleyin.

Basitleştirilmiş yeni Edge deneyimi yüklemesi

Yeni Edge deneyiminin yüklenmesi, yeni bir komut dosyasıyla basitleştirildi.

Daha fazla bilgi için Yeni Edge deneyimini yükleme başlıklı makaleyi inceleyin.

LDAP IdP desteği

Kullanıcıların Edge kullanıcı arayüzü ve Edge yönetim API'si çağrılarıyla kimlik doğrulaması artık SAML'ye ek olarak LDAP'yi de destekliyor. 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ış başlıklı makaleyi inceleyin.

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. Yeni bir mülkle yönlendiriciye IPv6 desteği ekleyebilirsiniz.

Daha fazla bilgi için Yönlendiricide IPv6'yı kullanma başlıklı makaleyi inceleyin.

INVALID_TSC işlemlerini hariç tutma (Para kazanma)

Artık para kazanma özelliğini kullanırken INVALID_TSC işlemlerinin Postgres veritabanına eklenmesini engelleyebilirsiniz.

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

Desteklenen yazılımlar

Bu sürümde, desteklenen yazılımlarda aşağıdaki değişiklikler yapılmıştır:

Destek Eklendi Artık Desteklenmiyor

Bu sürümde 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 desteklenmemektedir:

  • 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 başlıklı makaleyi inceleyin.

Hata düzeltmeleri

Bu bölümde, bu sürümde düzeltilen Private Cloud hataları listelenmektedir. Ayrıca bu sürüm, Dahil Edilen Sürümler bölümünde 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ındaki edge-message-processor bileşenleri için ayarlanmıyordu.
111445518

MP hataları

Mesaj İşleyiciler, her 5 dakikada bir aşağıdaki hata mesajını sürekli olarak günlüğe kaydetti:
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üğümlü yükseltmeler

17.09, 18.01 ve 18.05 sürümlerinden 13 düğümlü kurulumların yükseltilmesi başarısız oluyordu.
119802562

Aynı ada sahip proxy'ler

Aynı kuruluştaki iki kullanıcı aynı adlara sahip proxy'ler oluşturduysa ikinci oluşturulan, ilkini üzerine yazar. Bu durum 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 Internal Error (Error Fetching Keystores) hatası gösterildi.
110988191

Analytics başarısız oldu

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

Yedekleme hataları

ZooKeeper, Cassandra ve OpenLDAP, verilerini aralıklı olarak aşağıdaki hatayla düzgün şekilde yedekleyemedi: File changed as we read it.
79993247

Node.js'ye HEAD istekleri

HEAD Node.js hedefiyle ilgili istekler askıda kalabiliyor ve bağlantılar beklemede kalıyordu.
70291825

apigee-postgres backup/restore

Artık bir apigee-postgres yedekleme/geri yükleme işlemi yürütüldüğünde tüm bileşenlerin verileri yedekleniyor.
65737520

Sistem yöneticisi şifresini sıfırlama

Özel karakterler içeren yönetim sunucusunun sistem yöneticisi şifresini sıfırlama işlemi başarısız oluyordu.

Bilinen sorunlar

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

Sorun Kimliği Açıklama
141628497

Mint, işlemleri başlangıçta puanlamıyor

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

Para kazanmayı 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 yapılan tüm para kazanma özellikli API çağrıları para kazanma özelliği tarafından işlenmez ve derecelendirilmez. Bu işlemler yalnızca normal analizlerde gösterilir.

Geçici çözüm:

Aşağıdaki yöntemlerle tüm mesaj işlemcileri (MP) yeniden başlatın:
apigee-service edge-message-processor restart

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

137865184

Mint rating servers memory leak

Bir mxgroup'a yeni bir Qpid örneği kaydedildiğinde, kuyruklar tüketiciler olmadan oluşturulur. Bu da kuyruk derinliğinin, mevcut tüm kaynakları kullanana kadar artmasına neden olur.

Geçici çözüm:

Yok.
135616498

apigee-sso yüklemesi için meta veri dosyası biçimi

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

Geçici çözüm:

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

  • metadata.xml dosyasının sonuna CRLF ekleyin.

    VEYA

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

apigee-monit Amazon Linux 1'de desteklenmez

Geçici çözüm:

Yok.
121095148

Mesaj İşleyici yedeği, doğru dosya grubunu yedeklemiyor

Geçici çözüm:

Yedeklemeyi ikinci kez çalıştırın. Bu kez doğru dosya grubu yedeklenir.

76087166

Birden fazla 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'deki Cassandra düğümlerine bağlanmaya çalıştığı için başlatılamayabilir. Bir Cassandra düğümü kapalıysa DataAccessExceptions oluşur. Bu durum, API trafiğinde kesintiye de neden olabilir. Bu durumda, mesaj işleyiciler KVM'leri almaya çalışırken DataAccessExceptions değerini bildirir.

Beklenen durumun, yönetim sunucusunun bölgeler arası veri deposu bileşenlerine bağlanmaması olduğunu unutmayın.

Geçici çözüm

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

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

Bu Cassandra düğüm türlerinin kaydını silmek 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 "gateway" olan pod adıdır. Ancak, bunu başka bir adla 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ıt aşağıdaki biçimi kullanı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ıtın uUID alanındaki değerleri not edin. Bu bilgileri kullanarak düğümlerin kaydını silersiniz.

  2. Her Cassandra düğüm türü (kms-datastore, dc-datastore ve keyvaluemap-datastore) için birinci adımı tekrarlayın. Döndürülen UUID'leri not ettiğinizden emin olun.
  3. Aşağıdaki komutu kullanarak düğümlerin kaydını silin:
    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, Zookeeper'dan düğümleri kaydettiğini ve kaydını sildiğini, Cassandra kümesi üzerinde herhangi bir etkisi olmadığını unutmayın. Bu komutlar hakkında daha fazla bilgi için Veri deposu kayıtlarını güncelleme başlıklı makaleyi inceleyin.

68722102

Günlük iletisine ek bilgiler ekleyen MessageLogging politikası

MessageLogging politikasının FormatMessage öğesi, kaydedilen mesajın biçimini kontrol eder. FormatMessage=false olduğunda, günlüğe kaydedilen mesajın Apigee tarafından oluşturulan herhangi bir bilgiyi içermemesi gerekir. Ancak FormatMessage=false ayarını yapsanız bile günlük iletisi 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'yı 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ı