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

Apigee Edge belgelerini görüntülüyorsunuz.
. Git: Apigee X belgeleri.
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 özetlenmiştir:

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ş New Edge deneyimi kurulumu
INVALID_TSC işlemi hariç tut (Para Kazanma)

Bu yeni özelliklerin her biri hakkında daha fazla bilgi için Yeni özellikler.

Geriye Dönük Uyumluluk

Geriye dönük uyumluluğu etkileyen aşağıdaki sorunlar bu sürümde kullanıma sunulmuştur Apigee Edge for Private Cloud:

     
  • 132443137 numaralı sorunun düzeltilmesi nedeniyle (şurada açıklandığı gibi: 19.03.01 Genel Cloud sürüm notları içeriyorsa) İleti İşleyenler artık X-Apigee-*. Sonuç olarak, X-Apigee-* üstbilgilerini seçin ve bu başlıkları desteklenenlerle değiştirin.

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

    /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 ve bu sürüme dahil edildi:

○ Kenar:
19.07.23 (Kullanıcı Arayüzü)
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
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 bkz. Apigee'nin kullanımdan kaldırılması, kullanımdan kaldırılması ve CPS'ler değişiklikler başlıklı makaleyi inceleyin.

Hata Düzeltmeleri

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

. ○ UseStringDeduplication ayarlanmadı (140270474)
○ MP hataları (111445518)
○ JMX ile Cassandra hataları (113342838)
○ 13 düğümlü yükseltme (138931337)
○ Aynı ada sahip proxy'ler (119802562)
○ Anahtar depoları yüklenmiyor (118851790)
○ Analiz başarısız oldu (110988191)
○ Yedekleme hataları (110785400)
Node.js'ye yönelik ○ HEAD istekleri (79993247)
○ Apigee-postgres yedekleme/geri yükleme (70291825)
○ Sistem yöneticisi ş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üm aşağıdaki bilinen sorunları içermektedir:

○ İşlemlerin başlangıçta mint edilmesi (141628497)
○ Derecelendirme sunucularının bellek sızıntısı (137865184)
○ Apigee-sso yüklemesi için meta veri dosyası biçimi (135616498)
apigee-monit, Amazon Linux 1'de (122370980) desteklenmiyor
○ Mesaj İşlemci yedeklemesi doğru dosya grubunu yedeklemiyor (121095148)
○ Çoklu veri merkezi yapılandırmalarında DataAccessExceptions (76087166)
○ Günlük mesajındaki ekstra bilgileri içeren MessageLogging politikası (68722102)

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

Yeni sürüme geçirme yolları

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

Başlangıç 4.19.01 Doğrudan 4.19.01 → 4.19.06 sürümüne geçin
Başlangıç 4.18.05 Doğrudan 4.18.05 → 4.19.06 sürümüne geçin
18.01.2019'dan itibaren Doğrudan 4.18.01 → 4.19.06 sürümüne geçin

Yeni özellikler

Bu bölümde, bu sürümdeki yeni özellikler listelenmiştir. Ayrıca bu sürüm, Aşağıdaki bağlantıda listelenen Edge Kullanıcı Arayüzü, Edge Management ve Portal sürümlerindeki özellikler Dahil Edilen Yayınlar.

Bu sürüm, aşağıdaki geliştirmelere ek olarak birden çok kullanılabilirlik özelliği de içeriyor. performans, güvenlik ve kararlılıkla ilgili iyileştirmeler içeriyor.

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 projede çok sayıda MP işlemini gerçekleştirdiğinde, çok sayıda MP'e sahip daha büyük topolojilerde çağrı, RPC aracılığıyla eşzamanlı olarak yapılır.

Sonuç olarak Apigee, daha büyük dağıtımların RPC yerine HTTP kullanmasını önerir. dağıtım. HTTP dağıtımlarının etkinleştirilmesi artık destekleniyor.

Daha fazla bilgi için bkz. HTTP'yi etkinleştirme dağıtım.

Cassandra raf desteği

Apigee, artık Cassandra'yı geliştirerek Cassandra'nın operasyonlarının ölçeklendirilmesiyle ilgili genel rehberlik sunuyor. kullanıma sunuyoruz.

Daha fazla bilgi için bkz. Cassandra rafı desteği.

Takılabilir analiz

Mesaj İşleyici tarafından toplanan analiz verileri varsayılan olarak Qpid ve Postgres'e yüklenir gerekir. 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 şuraya yazacak şekilde yapılandırabilirsiniz: veya her iki seçeneği de kullanmayı seçebilirsiniz.

Daha fazla bilgi için bkz. Bir dosyaya analiz verileri yazma.

Basitleştirilmiş New Edge deneyimi kurulumu

Yeni Edge deneyiminin yüklenmesi yeni bir komut dosyasıyla kolaylaştırıldı.

Daha fazla bilgi için New Edge Experience'ı yükleme konusuna bakın.

LDAP IDP desteği

Edge UI ve Edge management API çağrılarıyla kullanıcıların kimlik doğrulaması artık ve SAML'ye ek olarak. LDAP desteği hem doğrudan bağlama hem de dolaylı bağlama yöntemlerini içerir.

Daha fazla bilgi için Harici bilgilere genel bakış IDP kimlik doğrulaması.

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. IPv6 ekleyebilirsiniz yönlendiriciyi yeni bir özellikle destekler.

Daha fazla bilgi için Şu sayfada IPv6'yı kullanma bölümüne bakın: Yönlendirici bölümüne bakın.

INVALID_TSC işlemi hariç tut (Para kazanma)

Artık INVALID_TSC işlemi Postgres'e eklenmeden hariç tutabilirsiniz veritabanını kullanarak elde edilir.

Daha fazla bilgi için bkz. Para kazanma sunucu özelliklerine sahip olduğundan emin olun.

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üm, aşağıdaki platformlar için destek sağlar:

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

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

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

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

Hata düzeltmeleri

Bu bölümde, bu sürümde düzeltilmiş olan Private Cloud hataları listelenmektedir. Ayrıca, sürümü, şurada gösterilen Edge UI, Edge Management ve Portal sürümlerindeki tüm hata düzeltmelerini içerir Dahil Edilen Yayınlar.

Sorun Kimliği Açıklama
140270474

UseStringDeduplication ayarlanmadı

UseStringDeduplication şu değildi üretimdeki edge-message-processor bileşenleri için ayarlanıyor ortam olarak da bilinir.
111445518

MP hataları

İleti işlemcileri, 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üğüm yükseltmeleri

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

Aynı ada sahip proxy'ler

Aynı kuruluştaki iki kullanıcı proxy oluşturduysa oluşturulan ikinci dosya ilkinin üzerine yazılır. Bu durum yalnızca Farklı kullanıcılar diğer proxy'yi göremedi.
118851790

Anahtar depoları yüklenmiyor

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

Analytics başarısız oldu

Mikro ağ geçidinden gelen verilerle sağlandığında analiz, gelecekteki bir tarihe ayarlayın.
110785400

Yedekleme hataları

ZooKeeper, Cassandra ve OpenLDAP aralıklı olarak başarısız oldu Şu hatayla verilerini düzgün şekilde yedekleyin: File changed as we read it.
79993247

Node.js'ye HEAD istek

Node.js hedefine yapılan HEAD istekleri askıya alınabilir. Bu durum, bağlantıların beklemede kalmasına neden olur.
70291825

Apigee-postgres yedeklemesi/restore

Bir Apigee-postgres yedeklemesi/geri yüklemesi yürütmesi artık tüm bileşenler için verileri yedekliyor.
65737520

Sistem yöneticisi şifresini sıfırlama

Özel içeren Yönetim Sunucusu'nun 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

Mint, başlangıçta işlemleri derecelendirmez

Private Cloud için Edge, bir kuruluş için para kazanma özelliğini ilk kez etkinleştirdiğinizde işlemleri 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ı olduğunu gösterir. Ancak başlangıçta yapılan ve para kazanılan 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:

Mesaj İşleyicileri (MP) yeniden başlatın. Bu işlemleri aşağıda bulabilirsiniz:
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şlatmada gerçekleşir, yani sorun yalnızca başlangıçta geçerlidir.

137865184

Mint derecelendirme sunucuları bellek sızıntısı

Bir mxgroup'a yeni bir Qpid örneği kaydedildiğinde sıralar tüketici olmadan oluşturulur. Bu da, mevcut tüm kaynakları kullanana kadar sıra derinliğinin 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 meta veri.xml dosyası kullanılırken meta veriler.xml dosyası dosyanın sonunda yeni 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:

  • meta veri.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

Mesaj İşleyici yedeklemesi doğru dosya grubunu yedeklemiyor

Geçici çözüm:

Yedeklemeyi ikinci kez çalıştırdığınızda doğru dosya grubu yedeklenecektir.

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 şu hata oluştu:

DataAccessException: Error while accessing datastore;
Please retry later

Yönetim Sunucusu, Cassandra'ya bağlanmaya çalıştığı için başlatılmayabilir. hem dc-1 hem de dc-2'deki düğümler. DataAccessExceptions, bir Cassandra düğümü aşağı tüketim. Bu durum, Mesaj İşleyenlerin bildirdiği API trafiğinin kesintiye uğramasına da neden olabilir. KVM'leri almaya çalışırken DataAccessExceptions.

Beklenen durumun, Yönetim Sunucusu'nun veri deposu bileşenlerine bağlanmaması için olduğunu unutmayın. ve bölgeleri keşfedebilirsiniz.

Geçici çözüm

Geçici çözüm, kullanılamayan veri merkezinde aşağıdaki Cassandra düğüm türlerinin kaydını silmektir. ve ardından, 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'nizin kimlik bilgileridir hesap.
    • MS_IP ve MS_PORT, Yönetim Sunucusu'nun IP adresi ve bağlantı noktasıdır sayı.
    • REGION, Yönetim Sunucusu'nun bulunduğu veri merkezinin adıdır. bulabilirsiniz.
    • GATEWAY_POD, varsayılan olarak "ağ geçidi" olan kapsül adıdır. Projede ancak, başka bir adla adlandırıldı. 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ıttaki uUID alanındaki değerleri not edin. Bu araçları şu amaçla kullanacaksınız: düğümlerin kaydını iptal edebilir.

  2. Her Cassandra düğüm türü için birinci adımı tekrarlayın: kms-datastore, dc-datastore ve keyvaluemap-datastore. Lütfen Döndürülen UUID'ler.
  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'daki düğümleri kaydettiği ve kayıtlarını silmesini ve hiçbir Cassandra kümesi üzerindeki etkisidir. Bu komutlar hakkında daha fazla bilgi için bkz. Veri deposu kayıtlarını güncelleyin.

68722102

Günlük mesajındaki ekstra bilgiler dahil olan MessageLogging politikası

MessageLogging politikasının FormatMessage öğesi, günlüğe kaydedilen mesajın biçimini kontrol eder. FormatMessage=false söz konusu olduğunda, günlüğe Apigee tarafından oluşturulan herhangi bir bilgi eklenmemelidir. Ancak FormatMessage=false öğesini ayarlamış olsanız bile günlük iletisi aşağıdaki bilgileri içermeye devam eder:

  • Öncelik puanı
  • Zaman damgası

Geçici çözüm:

Yok.

Sonraki adım

Aşağıdaki bağlantıları kullanarak Edge for Private Cloud 4.19.06'yı kullanmaya başlayabilirsiniz:

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