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 alıyor:

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

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 çıktı:

     
  • 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 özellik sürümünden 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ırılan özellikler 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 for Private Cloud'un 4.18.01 sürümünün desteği 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 başlıklı makaleyi inceleyin.

Bilinen Sorunlar

Bu sürümde aşağıdaki bilinen sorunlar yer almaktadı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ı makaleyi inceleyin.

Yükseltme yolları

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

4.19.01 veya sonraki sürümler 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üm, aşağıdaki geliştirmelerin yanı sıra kullanılabilirlik, performans, güvenlik ve kararlılıkla ilgili çeşitli geliştirmeler de içerir.

HTTP dağıtım desteği

Edge, API proxy'lerini dağıtmak için varsayılan olarak 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 destekleniyor.

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 işlemlerini ölçeklendirme konusunda genel rehberlik sunuyor.

Daha fazla bilgi için Cassandra raf desteği başlıklı makaleyi inceleyin.

Takılabilir analizler

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

Bu özellik sürümüyle birlikte, mesaj işleyiciyi analiz verilerini diske yazacak şekilde yapılandırabilir veya her iki seçeneği de kullanmayı tercih edebilirsiniz.

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

Edge kullanıcı arayüzü ve Edge yönetim API'si çağrılarıyla kullanıcıların kimlik doğrulaması artık SAML'nin yanı sıra 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 özellik ile yönlendiriciye IPv6 desteği ekleyebilirsiniz.

Daha fazla bilgi için Yönlendiricide IPv6 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 sunucu ö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 eklenmiştir:

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

Bu sürümde artık desteklenmeyen platformlar:

  • 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 özel bulut 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ı

İleti İşleyiciler, her 5 dakikada bir sürekli olarak aşağıdaki hata mesajını 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 proxy, 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

Analiz başarısız oldu

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

Yedekleme hataları

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

Node.js'ye HEAD istek

Node.js hedefine yapılan HEAD istekleri askıda kalabiliyordu 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 yedeklenir.
65737520

Sistem yöneticisi şifresini sıfırlama

Özel karakterler içeren Yönetim Sunucusu'nun 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ş için 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 kazanma özelliğini 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 kazandırılmış API çağrıları para kazanma 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 etkinleştirildikten sonra MP'lerin yeniden başlatılması, Edge'in yapılandırmayı başlangıçta 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 derecelendirme sunucularında bellek sızıntısı

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 yedeklemesi 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. DataAccessExceptions, bir Cassandra düğümü kapalıysa oluşur. Bu durum, API trafiğinde kesintiye de neden olabilir. Bu durumda, ileti işlemciler 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 bu düğümleri 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 sunucusunun 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 biri olmalıdır: 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ıyor:

    {
      "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. 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, düğümleri Zookeeper'a 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 mesajına ek bilgiler ekleyen MessageLogging politikası

MessageLogging politikasının FormatMessage öğesi, kaydedilen mesajın biçimini kontrol eder. FormatMessage=false olduğunda, 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 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'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ı