Apigee Edge 4.51.00, 4.52.00 veya 4.52.01 sürümünü 4.52.02'ye güncelleyin.

Apigee, Edge for Private Cloud'ı doğrudan 4.51.00, 4.52.00 veya 4.52.01 sürümünden 4.52.02 sürümüne yükseltmeyi destekler. Bu sayfada, bu tür yükseltmelerin nasıl yapılacağı açıklanmaktadır.

Güncellemeyi kimler yapabilir?

Güncellemeyi çalıştıran kullanıcı, Edge'i ilk yükleyen kullanıcıyla aynı veya root olarak çalışan bir kullanıcı olmalıdır.

Edge RPM'lerini yükledikten sonra herkes yapılandırabilir.

Hangi bileşenleri güncellemeniz gerekir?

Tüm Edge bileşenlerini güncellemeniz gerekir. Edge, birden fazla sürümden bileşen içeren kurulumları desteklemez.

Önkoşulları güncelleme

Apigee Edge'i yükseltmeden önce aşağıdaki ön koşulları karşıladığınızdan emin olun:

  • Tüm düğümleri yedekleyin
    Güncellemeden önce, güvenlik nedeniyle tüm düğümlerin tam yedeğini almanızı öneririz. Yedekleme işlemini gerçekleştirmek için Edge'in mevcut sürümünüze yönelik prosedürü kullanın.

    Bu sayede, yeni sürüme yapılan güncelleme düzgün çalışmazsa yedek bir planınız olur. Yedekleme hakkında daha fazla bilgi için Yedekleme ve Geri Yükleme başlıklı makaleyi inceleyin.

  • Edge'in çalıştığından emin olun
    Aşağıdaki komutu kullanarak güncelleme işlemi sırasında Edge'in çalışır durumda olduğundan emin olun:
    /opt/apigee/apigee-service/bin/apigee-all status
  • Cassandra sıkıştırma stratejisinin LeveledCompactionStrategy
    olduğundan emin olun Mevcut sürümünüze bağlı olarak Cassandra sıkıştırma stratejisinde gerekli değişiklikleri yapın. Aşağıdaki adımları uyguladıktan sonra ana yükseltme işlemine dönün:

Yükseltme için dikkate alınması gereken özel adımlar

Özel Bulut için Edge 4.52.02'ye yükseltmek istiyorsanız belirli yazılımları yükseltmeyle ilgili belirli adımları uygulayabilirsiniz. Gerekli adımlar, kullandığınız sürüme bağlıdır. Ek adımlar gerektiren çeşitli yazılımlar için aşağıdaki tabloya bakın ve her bir yazılımla ilgili ayrıntılı talimatları uygulayın. Gerekli görevleri tamamladıktan sonra yükseltme işlemine devam etmek için ana yükseltme prosedürüne dönün.

Mevcut sürüm 4.52.02'ye yükseltme için özel adımlar gerektiren yazılımlar
4.52.01 Cassandra
4.52.00 Zookeeper, Cassandra, Qpid
4.51.00 Zookeeper, Postgres, Cassandra, Qpid

Sürümünüze göre gerekli adımları uyguladıktan sonra devam etmek için ana yükseltme işlemine dönün.

Tesis ayarlarının otomatik olarak yayılması

/opt/apigee/customer/application'daki .properties dosyalarını düzenleyerek herhangi bir özellik belirlediyseniz bu değerler güncellemeden sonra korunur.

Zookeeper 3.8.3'e yükseltme

Private Cloud için Edge 4.52.02, Zookeeper yükseltmesi içermez. Ancak 4.52.01'den eski bir sürümden yükseltme yapıyorsanız aşağıda açıklanan Zookeeper yükseltme adımlarını uygulamanız gerekir.

  • Private Cloud için Edge 4.51.00 veya 4.52.00 sürümlerinden yükseltme yapıyorsanız Zookeeper'ı yükseltmek için Zookeeper 3.8.3'e yükseltme gerekli başlıklı makaledeki adımları uygulayın.
  • Private Cloud için Edge 4.52.01 sürümünden yükseltme yapıyorsanız zaten Zookeeper 3.8.3 sürümünü kullanıyor olmalısınız ve Zookeeper'ı yükseltmek için herhangi bir özel adım uygulamanız gerekmez.

Postgres 14'e yükseltme

  • Özel Bulut için Edge 4.51.00'den 4.52.02'ye yükseltme yapıyorsanız Özel Bulut için Edge 4.52.02'de Postgres yükseltme bulunmasa bile Postgres yükseltme adımlarını uygulamanız gerekir. Özel Bulut için Edge 4.51.00'den 4.52.02'ye yükseltme yapmak için ek Postgres yükseltme adımları gerekir. Lütfen Postgres 14'e yükseltme gerekliliği bölümüne bakın.
  • Özel Bulut için Edge 4.52.00 veya 4.52.01 sürümünden 4.52.02 sürümüne yükseltme yapıyorsanız ek Postgres yükseltme adımları gerekmez.

Cassandra 3.11.16'ya yükseltme

Private Cloud için Apigee Edge 4.52.02, Cassandra'yı 3.11.16 sürümüne yükseltir. Cassandra, Apigee'nin kritik bir bileşenidir. Bu yükseltme, Cassandra'da sorgu yapmak ve yazmak için kullanılan çeşitli çalışma zamanı ve yönetim bileşenlerindeki sürücü yazılımında yapılan güncellemeleri de içerir.

Bu önemli bir yükseltme olduğundan, yeni sürümlerde optimum performans sağlamak için Apigee'nin Cassandra'daki veri modelinde belirli değişiklikler yapılması gerekiyordu. Bu değişiklikler minimum düzeyde olsa da yükseltme işlemi başladığında belirli yönetim API'leri kesintiye uğrar. Genellikle kesintiye uğrayan yönetim API'leri aşağıda ilgili bölümlerde listelenmiştir.

Ayrıca, yükseltme işlemi, yükseltilen veri merkezinde daha geniş bir çalışma zamanı proxy akışı ve yönetim API'si grubuna kesinti olmasına neden olur. Bu tür kesintileri en aza indirmek için çalışma zamanınızı ve yönetim trafiğinizi, yükseltilen veri merkezinden ayırmanız çok önemlidir. Daha fazla bilgi için aşağıdaki tek veri merkezi ve çoklu veri merkezi bölümlerini okuyun.

Geliştirici Portalı - API'leri Belgeleme

Apigee Drupal geliştirici portalı, API'lerinizi belgelemek için çeşitli özellikler sunar. Drupal 7 tabanlı geliştirici portalını kullanmayı bırakmanızı öneririz. Ancak portalı ve SmartDocs özelliğini kullanmaya devam ediyorsanız SmartDocs API'lerini kullanma dokümanı sizin için geçerlidir. Geliştirici portalının daha yeni sürümlerini kullanıyorsanız bu yükseltme sırasında API belgeleriniz etkilenmez.

Apigee'yi 4.52.02 sürümüne yükselttiğinizde Drupal 7 geliştirici portalının SmartDocs özelliği kullanılarak oluşturulan API modelleri yeni sürüme otomatik olarak taşınmaz. Geliştirici portalını kullanarak her modeli manuel olarak dışa aktarmanız ve yükseltme işlemini tamamladıktan sonra tekrar içe aktarmanız gerekir.

Aşağıda kullanılan terminoloji

Çalışma zamanı: Çalışma zamanı, çalışma zamanı proxy trafiğinizin işlenmesini kapsar. Mevcut proxy'ler için çalışma zamanında API isteğini etkili bir şekilde işlemek üzere Yönlendiricileriniz ve Mesaj İşleyicileriniz tarafından gerçekleştirilen tüm işlemleri içerir. Ancak yeni proxy'lerin dağıtımı veya proxy'lerin yeni düzeltmeleri buna dahil değildir.

Yönetim: Yönetim, Apigee Edge sisteminizin yönetimini içerir. Bu kapsama, uygulamalar, ürünler, hedef sunucular, anahtar depoları vb. dağıtımlar ve bunlarda yapılan değişiklikler dahildir ancak bunlarla sınırlı değildir. Tüm yönetim API'leri (ve Apigee kullanıcı arayüzü ve geliştirici portalı gibi istemcileri) bu kapsama dahildir.

Bu yükseltme sırasında, güncellemenin yürütüldüğü bölgedeki veya veri merkezindeki (DC) çalışma zamanı ve yönetim trafiği etkilenir. Güncellenen veri merkezinden bağımsız olarak, tüm veri merkezlerinde belirli yönetim API'leri etkilenir. Bu etki her adımdan sonra not edilir.

Aşağıdaki her adımda, yükseltme işleminin çeşitli aşamalarında ilerlerken çalışma zamanı ve yönetimin durumu açıklanmaktadır.

Yükseltme stratejileri

Birden fazla veri merkezi

Trafik sürekliliğini sağlamak ve kesintileri önlemek için yükseltme işlemi tek bir veri merkezinde gerçekleştirilmelidir. Bir DC'yi yükseltmeden önce trafik, işlevsel olan diğer DC'lere yeniden yönlendirilmelidir.

Tek veri merkezi

Tek bir veri merkezi kurulumunda yükseltme işlemi, çalışma zamanı trafiği ve belirli yönetim API'leri üzerinde önemli bir etkiyle karşılaşır. Tek bir veri merkezi kurulumu için aşağıdaki seçenekler kullanılabilir.

  • Yükseltme sırasında trafiği işlemek için mevcut veri merkezinin yanına bir veri merkezi ekleyerek Edge for Private bulut kümenizi geçici bir veri merkezine genişletin, ardından yükseltme işlemi tamamlandıktan sonra veri merkezlerinden birini devre dışı bırakın.
  • Ek bir veri merkezine geçemiyorsanız yönetim API'leri ve çalışma zamanı trafiği üzerindeki etkiyi en aza indirmek için kesintiye hazırlanın ve yükseltmeyi düşük trafik dönemlerinde planlayın.

Çalışma zamanı trafiği ve yönetim API'lerinin etkilenmemesi için ek bir veri merkezine genişletmeniz önerilir. Yükseltme sırasında, yükseltilen veri merkezinde aşağıdaki alanlar etkilenebilir ancak bunlarla sınırlı değildir:

  • OAuth jetonlarını yenileyen çalışma zamanı API'leri
  • Erişim Varlık Politikası'nı kullanan çalışma zamanı API'leri
  • Geliştirici uygulamalarını listeleyen yönetim API'leri
  • Ürün listeleyen yönetim API'leri

Yukarıda açıklanan etki, tüm veri merkezleri yükseltilene kadar tüm veri merkezlerinde çalışmamaya devam edecek belirli yönetim API'lerine ek olarak gerçekleşecektir. Bu tür yönetim API'leri sonraki bölümlerdeki adımlarda listelenmiştir.

Geri alma - üst düzey

  • Geri Alma Süreci Sırasında Etki

    Cassandra 3.11.x sürümünden 2.1.x sürümüne geri dönmek, geri dönüşümün gerçekleştirildiği veri merkezinde (DC) hem çalışma süresini hem de yönetim trafiğini etkiler. Ayrıca, belirli yönetim API'lerinde, hangi veri merkezinin geri alındığından bağımsız olarak tüm veri merkezlerinde kesintiler yaşanabilir.

  • DC'yi DC'ye göre geri alma yaklaşımını takip edin

    Hizmet sürekliliğini sağlamak ve hizmet kesintisini önlemek için geri alma işlemi tek bir veri merkezinde gerçekleştirilmelidir. Belirli bir veri merkezinde geri alma işlemini başlatmadan önce, uygulama trafiğinin tamamen çalışır durumdaki başka bir veri merkezine yönlendirildiğinden emin olun.

  • Kısmen Yükseltilmiş Kümeyi Geri Alma

    En az bir veri merkezi, Cassandra'nın eski sürümünde (2.1.22) tamamen çalışır durumda kalırsa diğer yükseltilmiş veri merkezleri, tamamen işlevsel Cassandra 2.1.X veri merkezinden yeniden oluşturma işlemi gerçekleştirerek geri alınabilir.

  • Küme Boyunca Geri Alma

    Cassandra kümesinin tamamı yükseltildiyse ve geri alma işlemi gerekiyorsa bu işlem yedekler veya sanal makine anlık görüntüleri kullanılarak yapılmalıdır. Bu yaklaşım karmaşıktır ve muhtemelen geçici bir kesintiye veya veri kaybına neden olur.

  • Yükseltme Öncesi Dikkat Edilmesi Gereken Noktalar

    Yükseltme işlemine başlamadan önce geri alma prosedürlerini öğrenmeniz önemlidir. Uygun geri alma yollarının kullanılabilmesi için yükseltme sırasında geri almayla ilgili ayrıntıların dikkate alınması önemlidir.

Tek bir veri merkezine sahip kümeleri geri alma

Cassandra'yı 2.1.x sürümünden 3.11.x sürümüne yükseltmek, çalışma zamanı trafiğini ve belirli yönetim API'lerini önemli ölçüde etkileyebilir. Bu etkiler geri alma sırasında da geçerlidir ve çalışma süresinin kesintiye uğramasına veya veri kaybına neden olabilir.

Üretim iş yükleri için yükseltmeden önce yeni bir veri merkezi oluşturmanız önemle tavsiye edilir. Bu sayede, veri kaybı veya API trafiğinde kesinti olmadan daha güvenli bir geri alma yolu elde edebilirsiniz. Yükseltme işlemi başarıyla tamamlandıktan sonra ek veri merkezi kullanımdan kaldırılabilir.

Yeni bir veri merkezi eklemek mümkün değilse ancak geri alma özelliğine hâlâ ihtiyaç duyuluyorsa yükseltmeden önce güvenilir yedeklemeler alın. Cassandra 2.1.x'i yedeklemelerden geri yüklemek mümkündür ancak bu yaklaşım, hizmetin kapalı kalmasına ve olası veri kaybına neden olabilir.

Birden fazla veri merkezine sahip kümeleri geri alma

Birden fazla veri merkezinin geri alınması, veri merkezine göre veri merkezi (DC-by-DC) yaklaşımını izler. Bu yaklaşımda, geri alınan veri merkezinden gelen trafik diğer işlevsel veri merkezlerine yönlendirilir. Böylece, trafik kesintisini önlemek için Cassandra, Yönetim Sunucusu ve Çalışma zamanı düğümleri için kontrollü ve izole bir geri alma işlemi sağlanır.

Ayrıntılar için Cassandra 3.11.16 güncellemesini geri alma bölümüne bakın.

0. adım: Başlangıç durumu

  • Zookeeper, Postgres ve LDAP bileşenleri zaten 4.52.02 sürümlerine yükseltilmiştir. Private Cloud kümesi için Edge'iniz kararlı ve çalışıyor. Geri alma işlemi gerekiyorsa küme bu duruma geri alınır.
  • Apigee'de 2.1.22 sürümü ile çalışan Cassandra.
  • Edge bileşenleri:
    • Yönetim sunucusu, eski thrift protokolü üzerinden Cassandra ile iletişim kuruyor.
    • Eski thrift protokolü üzerinden Cassandra ile iletişim kuran çalışma sunucusu (mesaj işleyiciler ve yönlendiriciler).
Bu aşamadaki çalışma zamanı durumu Bu aşamadaki yönetim durumu
Çalışma zamanı tamamen işlevsel Yönetim tamamen çalışır durumda

1. Adım: Yükseltme işlemine hazırlanın

Aşağıdaki adımlar, genellikle oluşturduğunuz standart dosyalara (ör. bileşen yükseltmelerini etkinleştirmek için Apigee'nin standart yapılandırma dosyası) ek olarak uygulanır.

  1. Cassandra'yı LeveledCompactionStrategy kullanacak şekilde değiştirin.
  2. Apigee'yi kullanarak Cassandra'yı yedekleme.
  3. Mümkünse Cassandra düğümlerinin sanal makine anlık görüntülerini alın.
  4. /opt/apigee/apigee-cassandra/cass_upgrade.conf adresindeki her Cassandra düğümünde aşağıdaki içeriğe sahip bir Cassandra yükseltme yapılandırma dosyası oluşturun:
    # IP Address of node
    HOSTIP=10.0.0.1
    
    # Username for running Cassandra queries. Optional. Can be skipped if you have not enabled Cassandra authentication.
    CASS_USERNAME=<cassuser>
    
    # Password for running Cassandra queries. Optional. Can be skipped if you have not enabled Cassandra authentication.
    CASS_PASSWORD=<casspass>
    
    # Port for connecting to Cassandra via thrift. Optional. Defaults to 9160 if skipped.
    CASS_PORT=9160
    
    # Port for connecting to Cassandra via CQL. Optional. Defaults to 9042 if skipped.
    CASS_CQL_PORT=9042
    
    # Directory to be used by Cassandra upgrade scripts. Optional. Defaults to /tmp/cass_upgrade_scripts if skipped.
    # Note that if upgrade is successful, this directory is deleted via root user - so provide a directory accordingly.
    CASS_TMP_DIR=/tmp/cass_upgrade_scripts
        
    /opt/apigee/apigee-cassandra/cass_upgrade.conf konumunda dosya oluşturulamazsa her Cassandra düğümünde aynı içeriğe sahip /opt/silent.conf dosyasını oluşturun.
  5. Apigee Drupal 7 geliştirici portalının SmartDocs özelliğini kullanıyorsanız modellerinizi geliştirici portalı kullanıcı arayüzünden JSON biçiminde indirerek her birinin dışa aktarımını yapın. Yönetim sunucuları güncellendikten sonra bu modellerin Apigee'ye geri içe aktarılması gerekir.
  6. Henüz mevcut değilse 9160 ve 9042 bağlantı noktalarına tüm Edge bileşenlerinden Cassandra düğümlerine erişilebildiğinden emin olun. Daha fazla bilgi için Bağlantı noktası koşulları bölümüne bakın.

2. Adım: Trafiği ilk veri merkezinden başka bir yere yönlendirin

  1. İlk veri merkezinden gelen çalışma zamanı ve yönetim trafiğini engelleyin.
  2. Tüm çalışma zamanı trafiğini ve yönetim API'lerini diğer işlevsel veri merkezlerine yönlendirin.
  3. Çalışma zamanı ve yönetim trafiğinin diğer DC'ler tarafından başarıyla ele alındığını doğrulayın.

3. adım: İlk veri merkezindeki tüm Cassandra düğümlerini yükseltin

  1. Veri merkezindeki tüm Cassandra düğümlerini tek tek yükseltin. Aşağıdaki komutları her düğümde tek tek çalıştırın:
    /opt/apigee/apigee-setup/bin/update.sh -c cs -f configFile
  2. Bir düğüm güncellendikten sonra, devam etmeden önce bazı doğrulamalar yapmak için düğümde aşağıdaki komutu çalıştırın:
    /opt/apigee/apigee-service/bin/apigee-service apigee-cassandra validate_upgrade -f configFile
    Yukarıdaki komut, aşağıdaki gibi bir sonuç döndürür:
    Cassandra version is verified - [cqlsh 5.0.1 | Cassandra 3.11.16 | CQL spec 3.4.4 | Native protocol v3] Metadata is verified
  3. Yükseltme tamamlandıktan sonra her Cassandra düğümünde aşağıdaki post_upgrade komutunu tek tek çalıştırın:
    /opt/apigee/apigee-service/bin/apigee-service apigee-cassandra post_upgrade
Bu aşamadaki çalışma zamanı durumu Bu aşamadaki yönetim durumu
  • Yükseltilen veri merkezlerinde çalışma zamanında trafik engellendi
  • Çalışma zamanı diğer veri merkezlerinde tam olarak çalışır.

4. Adım: İlk veri merkezindeki tüm yönetim düğümlerini yükseltin

Veri merkezindeki tüm yönetim düğümlerini yükseltin:

/opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
Bu aşamadaki çalışma zamanı durumu Bu aşamadaki yönetim durumu
  • Yükseltilen veri merkezlerinde çalışma zamanında trafik engellendi
  • Çalışma zamanı tamamen işlevsel

5. Adım: İlk veri merkezindeki tüm çalışma zamanı düğümlerini yükseltin

Veri merkezindeki tüm Yönlendirici ve İleti İşlemcisi düğümlerini tek tek yükseltin:

/opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
Bu aşamadaki çalışma zamanı durumu Bu aşamadaki yönetim durumu
  • Yükseltilen veri merkezlerinde çalışma zamanında trafik engellendi
  • Çalışma zamanı diğer veri merkezlerinde tam olarak çalışır.

6. adım: Trafiği ilk veri merkezine yönlendirin

  • İlk veri merkezi Cassandra, çalışma zamanı bileşenleri ve yönetim sunucusuyla yükseltildikten sonra, ilk veri merkezine çalışma zamanı ve yönetim trafiğini yeniden etkinleştirin.
  • Çalışma zamanı ve yönetim trafiğinin DC'lerde başarılı olduğundan emin olun.

7. Adım: Diğer veri merkezlerini yükseltin

Trafik akışını bu veri merkezlerinden başka yerlere yönlendirerek, Apigee yazılımını güncelleyerek ve bu veri merkezlerinde trafiği yeniden etkinleştirerek kalan veri merkezlerinde 1. Adım ile 6. Adım'ı tek tek tekrarlayın.

8. adım: Yükseltme adımını tüm yönetim düğümlerinde yeniden çalıştırın

Veri merkezlerindeki tüm yönetim düğümlerinde aşağıdaki yükseltme komutunu yeniden çalıştırın:

/opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile

9. Adım - [İsteğe bağlı] Daha önce dışa aktarılan akıllı dokümanları içe aktarın

Tüm yönetim sunucuları yükseltildikten sonra, 1. adımda dışa aktardığınız akıllı doküman modellerini içe aktarabilirsiniz. Bunu daha sonra yapmaya karar verebilirsiniz.

Bunu yalnızca Drupal 7 tabanlı geliştirici portalını kullanıyorsanız ve akıllı doküman özelliğini kullanıyorsanız yapmanız gerekir.

Bu aşamadaki çalışma zamanı durumu Bu aşamadaki yönetim durumu
Çalışma zamanı tamamen işlevsel Yönetim tamamen çalışır durumda

10. Adım: Kullanılmayan tabloları bırakın

Kullanılmayan eski tabloları Cassandra kümesinden kaldırmak için aşağıdaki komutu çalıştırın. Bu işlem çalıştırılana kadar Cassandra'nın belirli özelliklerini kullanamazsınız (ör. yeni kimlik doğrulama ayarlama - eski kimlik doğrulama mekanizmaları çalışmaya devam eder). Bu komut yalnızca kümedeki bir düğümde yürütülebilir

/opt/apigee/apigee-service/bin/apigee-service apigee-cassandra drop_old_tables -f configFile

11. adım: Kalan tüm Edge ve diğer bileşenleri Private Cloud 4.52.02'ye yükseltin

Tüm bölgelerdeki kalan tüm edge-qpid-server ve edge-postgres-server düğümlerini tek tek yükseltin.

Bu aşamada, Private Cloud için Edge 4.52.01'den önceki sürümlerden yükseltme yapıyorsanız sırasıyla Qpid ve Postgres'i yükseltmeyle ilgili ek adımları uygulayın ve kalan bileşenleri bu adımlar doğrultusunda yükseltin.

Qpid J-Broker'a yükseltme

Private Cloud için Edge 4.52.02, Qpid'e yükseltme içermese de 4.52.01'den eski sürümlerden yükseltme yapıyorsanız QPID'i yükseltme adımlarını uygulamanız gerekir.

  • Private Cloud için Edge 4.51.00 veya 4.52.00 sürümünden 4.52.02 sürümüne yükseltme yapıyorsanız ek Qpid yükseltme adımlarını uygulamanız gerekir. 4.51.00 veya 4.52.00 sürümünden 4.52.02 sürümüne geçiyorsanız lütfen Qpid'i yükseltme bölümüne bakın.
  • Private Cloud için Edge 4.52.01'den 4.52.02'ye yükseltme yapıyorsanız zaten Qpid Broker'ın en son sürümünü kullanıyor olmalısınız ve ek Qpid yükseltme adımları gerekmez.

Yeni Edge kullanıcı arayüzü

Bu bölümde, Edge kullanıcı arayüzüyle ilgili dikkat edilmesi gereken noktalar listelenmiştir. Daha fazla bilgi için Özel Bulut için yeni Edge kullanıcı arayüzü başlıklı makaleyi inceleyin.

Edge kullanıcı arayüzünü yükleme

Apigee, ilk yüklemeyi tamamladıktan sonra Apigee Edge for Private Cloud geliştiricileri ve yöneticileri için geliştirilmiş bir kullanıcı arayüzü olan Edge kullanıcı arayüzünü yüklemenizi önerir.

Edge kullanıcı arayüzünün, Temel kimlik doğrulamayı devre dışı bırakmanızı ve SAML veya LDAP gibi bir IDP kullanmanızı gerektirdiğini unutmayın.

Daha fazla bilgi için Yeni Edge kullanıcı arayüzünü yükleme başlıklı makaleyi inceleyin.

Edge kullanıcı arayüzünü güncelleme

Edge kullanıcı arayüzü bileşenini güncellemek için Private Cloud için Edge'in hangi sürümünden yeni sürüme geçtiğinizi göz önünde bulundurun:

Apigee mTLS ile güncelleme

Apigee mTLS'yi güncellemek için aşağıdaki adımları uygulayın:

Güncellemeyi geri alma

Güncelleme başarısız olursa sorunu düzeltmeyi deneyebilir ve ardından update.sh komutunu tekrar çalıştırabilirsiniz. Güncellemeyi birden çok kez çalıştırabilirsiniz. Güncelleme, en son kaldığı yerden devam eder.

Hata nedeniyle güncellemeyi önceki sürümünüze geri çekmeniz gerekiyorsa ayrıntılı talimatlar için 4.52.00 sürümünü geri çekme başlıklı makaleyi inceleyin.

Güncelleme bilgilerini günlüğe kaydetme

update.sh yardımcı programı, varsayılan olarak günlük bilgilerini şuraya yazar:

/opt/apigee/var/log/apigee-setup/update.log

update.sh yardımcı programını çalıştıran kullanıcının söz konusu dizin erişimi yoksa günlük, /tmp dizinine update_username.log adlı bir dosya olarak yazılır.

/tmp'e erişiminiz yoksa update.sh yardımcı programı başarısız olur.

Sıfır kapalı kalma süresiyle güncelleme

Kesintisiz güncelleme veya periyodik güncelleme, Edge'i kapatmadan Edge yüklemenizi güncellemenize olanak tanır.

Kesintisiz güncelleme yalnızca 5 ve daha fazla düğüm içeren yapılandırmalarda mümkündür.

Kesintisiz yükseltmenin anahtarı, her yönlendiriciyi yük dengeleyiciden tek tek kaldırmaktır. Ardından, yönlendiriciyi ve yönlendiriciyle aynı makinedeki diğer bileşenleri güncelleyin ve yönlendiriciyi yük dengeleyiciye geri ekleyin.

  1. Makineleri, Makine güncelleme sırası bölümünde açıklandığı şekilde kurulumunuza uygun şekilde güncelleyin.
  2. Yönlendiricileri güncelleme zamanı geldiğinde, herhangi bir yönlendiriciyi seçin ve Sunucu (Mesaj İşleyen/Yönlendirici) erişilebilirliğini etkinleştirme/devre dışı bırakma bölümünde açıklandığı gibi erişilemez hale getirin.
  3. Seçilen yönlendiriciyi ve yönlendiriciyle aynı makinedeki diğer tüm Edge bileşenlerini güncelleyin. Tüm Edge yapılandırmalarında aynı düğümde bir Yönlendirici ve Mesaj İşleyen gösterilir.
  4. Yönlendiricinin tekrar erişilebilir olmasını sağlayın.
  5. Kalan yönlendiriciler için 2 ile 4 arasındaki adımları tekrarlayın.
  6. Kurulumunuzda kalan makinelerde güncellemeye devam edin.

Güncellemeden önce ve sonra aşağıdakileri yapın:

Sessiz yapılandırma dosyası kullanma

Güncelleme komutuna sessiz yapılandırma dosyası iletmeniz gerekir. Sessiz yapılandırma dosyası, Edge 4.50.00 veya 4.51.00'ı yüklemek için kullandığınız dosyayla aynı olmalıdır.

Harici internet bağlantısı olan bir düğümde 4.52.02'ye güncelleme

Bir düğümdeki Edge bileşenlerini güncellemek için aşağıdaki prosedürü uygulayın:

  1. Varsa Cassandra'da onarım işlemi gerçekleştirecek şekilde yapılandırılmış cron işlerini güncelleme tamamlanana kadar devre dışı bırakın.
  2. Edge RPM'lerini yüklemek için düğümünüze root olarak giriş yapın.
  3. yum-utils ve yum-plugin-priorities'i yükleyin:
    sudo yum install yum-utils
    sudo yum install yum-plugin-priorities
  4. SELinux'u Edge apigee-setup yardımcı programını yükleme bölümünde açıklandığı şekilde devre dışı bırakın.
  5. Oracle 7.x'e yüklüyorsanız aşağıdaki komutu yürütün:
    sudo yum-config-manager --enable ol7_optional_latest
  6. AWS'ye yüklüyorsanız aşağıdaki yum-configure-managerkomutları yürütün:
    yum update rh-amazon-rhui-client.noarch
    sudo yum-config-manager --enable rhui-REGION-rhel-server-extras rhui-REGION-rhel-server-optional
  7. Şu anda Edge 4.51.00 sürümünü kullanıyorsanız:

    1. Edge bootstrap_4.52.02.sh dosyasını /tmp/bootstrap_4.52.02.sh'e indirin:
      curl https://software.apigee.com/bootstrap_4.52.02.sh -o /tmp/bootstrap_4.52.02.sh
    2. Aşağıdaki komutu çalıştırarak Edge 4.52.02 apigee-service yardımcı programını ve bağımlılıklarını yükleyin:
      sudo bash /tmp/bootstrap_4.52.02.sh apigeeuser=uName apigeepassword=pWord

      Burada uName:pWord, Apigee'den aldığınız kullanıcı adı ve şifredir. pWord değerini atlarsanız bu değeri girmeniz istenir.

      Yükleyici varsayılan olarak Java 1.8'in yüklü olup olmadığını kontrol eder. Aksi takdirde yükleyici, sürücüyü sizin için yükler.

      Java yüklemesinin nasıl ele alınacağını belirtmek için JAVA_FIX seçeneğini kullanın. JAVA_FIX aşağıdaki değerleri alır:

      • I: OpenJDK 1.8'i yükleyin (varsayılan).
      • C: Java yüklemeden devam edin.
      • Q: Çık. Bu seçenekte Java'yı kendiniz yüklemeniz gerekir.
    3. Aşağıdaki örnekte gösterildiği gibi apigee-setup yardımcı programını güncellemek için apigee-service'ü kullanın:
      /opt/apigee/apigee-service/bin/apigee-service apigee-setup update
    4. Yönetim sunucusunda apigee-validate yardımcı programını aşağıdaki örnekte gösterildiği gibi güncelleyin:
      /opt/apigee/apigee-service/bin/apigee-service apigee-validate update
    5. Yönetim sunucusunda apigee-provision yardımcı programını aşağıdaki örnekte gösterildiği gibi güncelleyin:
      /opt/apigee/apigee-service/bin/apigee-service apigee-provision update
    6. Aşağıdaki komutu yürüterek update yardımcı programını düğümlerinizde çalıştırın:
      /opt/apigee/apigee-setup/bin/update.sh -c component -f configFile

      Bunu Makine güncelleme sırası bölümünde açıklanan sırayla yapın.

      Burada:

      • component, güncellenecek Edge bileşenidir. Olası değerler şunları içerir:
        • cs: Cassandra
        • edge: Edge kullanıcı arayüzü dışındaki tüm Edge bileşenleri: Yönetim sunucusu, Mesaj işleyici, Yönlendirici, Qpid sunucusu, Postgres sunucusu
        • ldap: OpenLDAP
        • ps: postgresql
        • qpid: qpidd
        • sso: Apigee TOA (TOA'yı yüklediyseniz)
        • ue: Yeni Edge kullanıcı arayüzü
        • ui: Klasik Edge kullanıcı arayüzü
        • zk: Zookeeper
      • configFile, 4.50.00 veya 4.51.00 yüklemesi sırasında Edge bileşenlerinizi tanımlamak için kullandığınız yapılandırma dosyasıyla aynıdır.

      component değerini "tümü" olarak ayarlayarak update.sh'ü tüm bileşenler üzerinde çalıştırabilirsiniz. Bunun için Edge hepsi bir arada (AIO) yükleme profilinizin olması gerekir. Örneğin:

      /opt/apigee/apigee-setup/bin/update.sh -c all -f ./sa_silent_config
    7. Henüz yapmadıysanız Edge kullanıcı arayüzü bileşenlerini çalıştıran tüm düğümlerde yeniden başlatın:
      /opt/apigee/apigee-service/bin/apigee-service [edge-management-ui|edge-ui] restart
    8. Yüklemeyi test etme bölümünde açıklandığı gibi, Yönetim Sunucusu'nda apigee-validate yardımcı programını çalıştırarak güncellemeyi test edin.

Daha sonra güncellemeyi geri almaya karar verirseniz 4.52.02 sürümünü geri alma bölümünde açıklanan prosedürü uygulayın.

Yerel bir depodan 4.52.02'ye güncelleme

Edge düğümleriniz bir güvenlik duvarının arkasındaysa veya internet üzerinden Apigee deposuna erişmeleri yasaklanmışsa güncellemeyi yerel bir depodan veya Apigee deposunun kopyasından yapabilirsiniz.#heading

Yerel bir Edge deposu oluşturduktan sonra Edge'i yerel depodan güncellemek için iki seçeneğiniz vardır:

  • Deponun .tar dosyasını oluşturun, .tar dosyasını bir düğüme kopyalayın ve ardından .tar dosyasından Edge'i güncelleyin.
  • Diğer düğümlerin erişebilmesi için yerel depoyu içeren düğüme bir web sunucusu yükleyin. Apigee, kullanabileceğiniz Nginx web sunucusunu sağlar veya kendi web sunucunuzu kullanabilirsiniz.

Yerel bir 4.52.02 deposundan güncellemek için:

  1. Edge apigee-setup yardımcı programını yükleme başlıklı makalede açıklandığı şekilde yerel bir 4.52.02 deposu oluşturun.
  2. apigee-service'i .tar dosyasından yüklemek için:
    1. Yerel deposunun bulunduğu düğümde, yerel deposu /opt/apigee/data/apigee-mirror/apigee-4.52.02.tar.gz adlı tek bir .tar dosyasına paketlemek için aşağıdaki komutu kullanın:
      /opt/apigee/apigee-service/bin/apigee-service apigee-mirror package
    2. .tar dosyasını, Edge'i güncellemek istediğiniz düğüme kopyalayın. Örneğin, yeni düğümdeki /tmp dizinine kopyalayın.
    3. Yeni düğümde, dosyayı /tmp dizinine çıkarın:
      tar -xzf apigee-4.52.02.tar.gz

      Bu komut, .tar dosyasını içeren dizinde repos adlı yeni bir dizin oluşturur. Örneğin /tmp/repos.

    4. Edge apigee-service yardımcı programını ve bağımlılıklarını /tmp/repos'ten yükleyin:
      sudo bash /tmp/repos/bootstrap_4.52.02.sh apigeeprotocol="file://" apigeerepobasepath=/tmp/repos

      Bu komuta repos dizininin yolunu eklediğinizi unutmayın.

  3. Nginx web sunucusunu kullanarak apigee-service'i yüklemek için:
    1. Nginx web sunucusunu, Edge apigee-setup yardımcı programını yükleme başlıklı makalenin "Nginx web sunucusunu kullanarak depodan yükleme" bölümünde açıklandığı şekilde yapılandırın.
    2. Uzak düğümde Edge bootstrap_4.52.02.sh dosyasını /tmp/bootstrap_4.52.02.sh'e indirin:
      /usr/bin/curl http://uName:pWord@remoteRepo:3939/bootstrap_4.52.02.sh -o /tmp/bootstrap_4.52.02.sh

      Burada uName:pWord, depo için daha önce belirlediğiniz kullanıcı adı ve şifredir ve remoteRepo, depo düğümünün IP adresi veya DNS adıdır.

    3. Uzak düğümde Edge apigee-setup yardımcı programını ve bağımlılıklarını yükleyin:
      sudo bash /tmp/bootstrap_4.52.02.sh apigeerepohost=remoteRepo:3939 apigeeuser=uName apigeepassword=pWord apigeeprotocol=http://

      Burada uName:pWord, deponun kullanıcı adı ve şifresidir.

  4. Aşağıdaki örnekte gösterildiği gibi apigee-setup yardımcı programını güncellemek için apigee-service'ü kullanın:
    /opt/apigee/apigee-service/bin/apigee-service apigee-setup update 
  5. Yönetim sunucusunda apigee-validate yardımcı programını aşağıdaki örnekte gösterildiği gibi güncelleyin:
    /opt/apigee/apigee-service/bin/apigee-service apigee-validate update
  6. Yönetim sunucusunda apigee-provision yardımcı programını aşağıdaki örnekte gösterildiği gibi güncelleyin:
    /opt/apigee/apigee-service/bin/apigee-service apigee-provision update
  7. update yardımcı programını, Makine güncelleme sırası bölümünde açıklanan sırada düğümlerinizde çalıştırın:
    /opt/apigee/apigee-setup/bin/update.sh -c component -f configFile

    Burada:

    • component, güncellenecek Edge bileşenidir. Genellikle aşağıdaki bileşenleri güncelleyebilirsiniz:
      • cs: Cassandra
      • edge: Edge kullanıcı arayüzü hariç tüm Edge bileşenleri: Yönetim sunucusu, Mesaj işleyici, Yönlendirici, Qpid sunucusu, Postgres sunucusu
      • ldap: OpenLDAP
      • ps: postgresql
      • qpid: qpidd
      • sso: Apigee TOA (TOA'yı yüklediyseniz)
      • ue Yeni Edge kullanıcı arayüzü
      • ui: Klasik Edge kullanıcı arayüzü
      • zk: Zookeeper
    • configFile, 4.50.00 veya 4.51.00 yüklemesi sırasında Edge bileşenlerinizi tanımlamak için kullandığınız yapılandırma dosyasıyla aynıdır.

    component değerini "tümü" olarak ayarlayarak update.sh'ü tüm bileşenler üzerinde çalıştırabilirsiniz. Bunun için Edge hepsi bir arada (AIO) yükleme profilinizin olması gerekir. Örneğin:

    /opt/apigee/apigee-setup/bin/update.sh -c all -f /tmp/sa_silent_config
  8. Henüz yapmadıysanız kullanıcı arayüzü bileşenlerini çalıştıran tüm düğümlerde yeniden başlatın:
    /opt/apigee/apigee-service/bin/apigee-service [edge-management-ui|edge-ui] restart
  9. Yüklemeyi test etme bölümünde açıklandığı gibi, Yönetim Sunucusu'nda apigee-validate yardımcı programını çalıştırarak güncellemeyi test edin.

Daha sonra güncellemeyi geri almaya karar verirseniz 4.52.02 sürümünü geri alma bölümünde açıklanan prosedürü uygulayın.

Makine güncelleme sırası - 4.51.00 (veya) 4.52.00 (veya) 4.52.01'den yeni sürüme geçme

Edge kurulumundaki makineleri güncelleme sırası önemlidir:

  • Diğer tüm bileşenleri yükseltmeden önce veri merkezlerindeki tüm ZooKeeper düğümlerini güncellemeniz gerekir. Edge Private Cloud 4.51.00 (veya) 4.52.00 sürümünden yükseltme yapıyorsanız zookeeper'ı yükseltmek için ek adımları da uygulamanız gerekir.
  • Postgresql'i tüm veri merkezlerinde güncellemeniz gerekir. Edge Private Cloud 4.51.00'dan yükseltme yapıyorsanız postgres'i yükseltmek için ek adımları da uygulamanız gerekir.
  • Tüm veri merkezlerinde LDAP düğümlerini güncellemeniz gerekir.
  • Tüm veri merkezleri yükseltilene kadar tüm Cassandra, Yönetim Sunucusu, Mesaj İşleyen ve Yönlendirici düğümlerini tek bir veri merkeziyle güncellemeniz gerekir.
  • Tüm veri merkezlerinde edge-qpid-server ve edge-postgres-server bileşenlerini güncellemeniz gerekir.
  • Tüm veri merkezlerinde Qpid düğümlerini yükseltmeniz gerekir. Edge Private Cloud 4.51.00 (veya) 4.52.00 sürümünden yükseltme yapıyorsanız Qpid'i yükseltmek için ek adımları da uygulamanız gerekir.
  • Tüm veri merkezlerinde Edge kullanıcı arayüzünü, yeni Edge kullanıcı arayüzünü ve SSO düğümlerini güncelleyin.
  • Para kazanma özelliğini güncellemek için ayrı bir adım yoktur. -c edge seçeneğini belirttiğinizde güncellenir.

1 düğümlü bağımsız yükseltme

1 düğümlü bağımsız bir yapılandırmayı 4.52.02'ye yükseltmek için:
  1. Tüm bileşenleri güncelleyin:
    /opt/apigee/apigee-setup/bin/update.sh -c all -f configFile
  2. (apigee-adminapi'ü yüklediyseniz) apigee-adminapi yardımcı programı güncellendi:
    /opt/apigee/apigee-service/bin/apigee-service apigee-adminapi update

2 düğümlü bağımsız yükseltme

2 düğümlü bağımsız kurulum için aşağıdaki bileşenleri güncelleyin:

Edge topolojileri ve düğüm numaralarının listesi için Yükleme topolojileri bölümüne bakın.

  1. 1. makinede Zookeeper'ı güncelleyin:
    /opt/apigee/apigee-setup/bin/update.sh -c zk -f configFile
  2. 2. makinede Postgres'i güncelleyin:
    /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
  3. 1. makinede LDAP'yi güncelleyin:
    /opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile
  4. 1. makinede Cassandra'yı güncelleyin:
    /opt/apigee/apigee-setup/bin/update.sh -c cs -f configFile
  5. 1. ve 2. makinedeki Edge bileşenlerini güncelleyin:
    /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
  6. 2. makinede Qpid'i güncelleyin:
    /opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
  7. 1. makinedeki kullanıcı arayüzünü güncelleyin:
    /opt/apigee/apigee-setup/bin/update.sh -c ui -f configFile
  8. (apigee-adminapi'ü yüklediyseniz) 1. makinedeki apigee-adminapi yardımcı programını güncelledi:
    /opt/apigee/apigee-service/bin/apigee-service apigee-adminapi update
  9. (Apigee TOA'yı yüklediyseniz) 1. makinede Apigee TOA'yı güncelleyin:
    /opt/apigee/apigee-setup/bin/update.sh -c sso -f sso_config_file

    Burada sso_config_file, TOA'yı yüklerken oluşturduğunuz yapılandırma dosyasıdır.

  10. 1. makinede Edge kullanıcı arayüzü bileşenini yeniden başlatın:
    /opt/apigee/apigee-service/bin/apigee-service edge-ui restart

5 düğüm yükseltme

5 düğümlü bir kurulum için aşağıdaki bileşenleri güncelleyin:

Edge topolojileri ve düğüm numaralarının listesi için Yükleme topolojileri bölümüne bakın.

  1. 1, 2 ve 3 numaralı makinelerde ZooKeeper'ı güncelleyin:
    /opt/apigee/apigee-setup/bin/update.sh -c zk -f configFile
  2. 4. makinede Postgres'i güncelleyin:
    /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
  3. 5. makinede Postgres'i güncelleyin:
    /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
  4. 1. makinede LDAP'yi güncelleyin:
    /opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile
  5. 1, 2 ve 3 numaralı makinelerde Cassandra'yı güncelleyin:
    /opt/apigee/apigee-setup/bin/update.sh -c cs -f configFile
  6. 1, 2, 3, 4 ve 5 numaralı makinelerdeki Edge bileşenlerini güncelleyin:
    /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
  7. 4. makinede Qpid'i güncelleyin:
    /opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
  8. 5. makinede Qpid'i güncelleyin:
    /opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
  9. Edge kullanıcı arayüzünü güncelleme:
    • Klasik kullanıcı arayüzü: Klasik kullanıcı arayüzünü kullanıyorsanız aşağıdaki örnekte gösterildiği gibi 1. makinedeki ui bileşenini güncelleyin:
      /opt/apigee/apigee-setup/bin/update.sh -c ui -f configFile
    • Yeni Edge kullanıcı arayüzü: Yeni Edge kullanıcı arayüzünü yüklediyseniz uygun makinede ue bileşenini güncelleyin (1. makine olmayabilir):
      /opt/apigee/apigee-setup/bin/update.sh -c ue -f /opt/silent.conf
  10. (apigee-adminapi'ü yüklediyseniz) 1. makinedeki apigee-adminapi yardımcı programını güncelledi:
    /opt/apigee/apigee-service/bin/apigee-service apigee-adminapi update
  11. (Apigee TOA'yı yüklediyseniz) 1. makinede Apigee TOA'yı güncelleyin:
    /opt/apigee/apigee-setup/bin/update.sh -c sso -f sso_config_file

    Burada sso_config_file, TOA'yı yüklerken oluşturduğunuz yapılandırma dosyasıdır.

  12. Kullanıcı arayüzü bileşenini yeniden başlatın:
    • Klasik kullanıcı arayüzü: Klasik kullanıcı arayüzünü kullanıyorsanız aşağıdaki örnekte gösterildiği gibi 1. makinede edge-ui bileşenini yeniden başlatın:
      /opt/apigee/apigee-service/bin/apigee-service edge-ui restart
    • Yeni Edge kullanıcı arayüzü: Yeni Edge kullanıcı arayüzünü yüklediyseniz uygun makinede (makinesi 1 olmayabilir) edge-management-ui bileşenini yeniden başlatın:
      /opt/apigee/apigee-service/bin/apigee-service edge-management-ui restart

9 düğümlü küme yükseltme

9 düğümlü kümelenmiş kurulum için aşağıdaki bileşenleri güncelleyin:

Edge topolojileri ve düğüm numaralarının listesi için Yükleme topolojileri bölümüne bakın.

  1. 1, 2 ve 3 numaralı makinelerde ZooKeeper'ı güncelleyin:
    /opt/apigee/apigee-setup/bin/update.sh -c zk -f configFile
  2. 8 numaralı makinede Postgres'i güncelleyin:
    /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
  3. 9 numaralı makinede Postgres'i güncelleyin:
    /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
  4. 1. makinede LDAP'yi güncelleyin:
    /opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile
  5. 1, 2 ve 3 numaralı makinelerde Cassandra'yı güncelleyin:
    /opt/apigee/apigee-setup/bin/update.sh -c cs -f configFile
  6. 1, 4, 5, 6, 7, 8 ve 9 numaralı makinelerdeki Edge bileşenlerini şu sırayla güncelleyin:
    /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
  7. 6 ve 7 numaralı makinelerde Qpid'i güncelleyin:
    /opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
  8. 1. makinede yeni kullanıcı arayüzünü (ue) veya klasik kullanıcı arayüzünü (ui) güncelleyin:
    /opt/apigee/apigee-setup/bin/update.sh -c [ui|ue] -f configFile
  9. (apigee-adminapi'u yüklediyseniz) 1. makinedeki apigee-adminapi yardımcı programını güncelleyin:
    /opt/apigee/apigee-service/bin/apigee-service apigee-adminapi update
  10. (Apigee TOA'yı yüklediyseniz) 1. makinede Apigee TOA'yı güncelleyin:
    /opt/apigee/apigee-setup/bin/update.sh -c sso -f sso_config_file

    Burada sso_config_file, TOA'yı yüklerken oluşturduğunuz yapılandırma dosyasıdır.

  11. Kullanıcı arayüzü bileşenini yeniden başlatın:
    • Klasik kullanıcı arayüzü: Klasik kullanıcı arayüzünü kullanıyorsanız aşağıdaki örnekte gösterildiği gibi 1. makinede edge-ui bileşenini yeniden başlatın:
      /opt/apigee/apigee-service/bin/apigee-service edge-ui restart
    • Yeni Edge kullanıcı arayüzü: Yeni Edge kullanıcı arayüzünü yüklediyseniz uygun makinede (makinesi 1 olmayabilir) edge-management-ui bileşenini yeniden başlatın:
      /opt/apigee/apigee-service/bin/apigee-service edge-management-ui restart

13 düğümlü kümeyi yeni sürüme geçirme

13 düğümlü kümelenmiş kurulum için aşağıdaki bileşenleri güncelleyin:

Edge topolojileri ve düğüm numaralarının listesi için Yükleme topolojileri bölümüne bakın.

  1. 1, 2 ve 3 numaralı makinelerde ZooKeeper'ı güncelleyin:
    /opt/apigee/apigee-setup/bin/update.sh -c zk -f configFile
  2. 8 numaralı makinede Postgres'i güncelleyin:
    /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
  3. 9 numaralı makinede Postgres'i güncelleyin:
    /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
  4. 4. ve 5. makinelerde LDAP'yi güncelleyin:
    /opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile
  5. 1, 2 ve 3 numaralı makinelerde Cassandra'yı güncelleyin:
    /opt/apigee/apigee-setup/bin/update.sh -c cs -f configFile
  6. 6, 7, 10, 11, 12, 13, 8 ve 9 numaralı makinelerdeki Edge bileşenlerini şu sırayla güncelleyin:
    /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
  7. 12 ve 13 numaralı makinelerde Qpid'i güncelleyin:
    /opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
  8. 6 ve 7 numaralı makinelerde yeni kullanıcı arayüzünü (ue) veya klasik kullanıcı arayüzünü (ui) güncelleyin:
    /opt/apigee/apigee-setup/bin/update.sh -c [ui|ue] -f configFile
  9. (apigee-adminapi'u yüklediyseniz) 6 ve 7 numaralı makinelerde apigee-adminapi yardımcı programını güncelleyin:
    /opt/apigee/apigee-service/bin/apigee-service apigee-adminapi update
  10. (Apigee TOA'yı yüklediyseniz) 6. ve 7. makinelerde Apigee TOA'yı güncelleyin:
    /opt/apigee/apigee-setup/bin/update.sh -c sso -f sso_config_file

    Burada sso_config_file, TOA'yı yüklerken oluşturduğunuz yapılandırma dosyasıdır.

  11. Kullanıcı arayüzü bileşenini yeniden başlatın:
    • Klasik kullanıcı arayüzü: Klasik kullanıcı arayüzünü kullanıyorsanız aşağıdaki örnekte gösterildiği gibi 6 ve 7 numaralı makinelerde edge-ui bileşenini yeniden başlatın:
      /opt/apigee/apigee-service/bin/apigee-service edge-ui restart
    • Yeni Edge kullanıcı arayüzü: Yeni Edge kullanıcı arayüzünü yüklediyseniz 6 ve 7 numaralı makinelerde edge-management-ui bileşenini yeniden başlatın:
      /opt/apigee/apigee-service/bin/apigee-service edge-management-ui restart

12 düğümlü küme yükseltme

12 düğümlü kümelenmiş kurulum için aşağıdaki bileşenleri güncelleyin:

Edge topolojileri ve düğüm numaralarının listesi için Yükleme topolojileri bölümüne bakın.

  1. Her iki DC'deki 1,2,3,7,8,9 numaralı makinelerde ZooKeeper'ı güncelleyin:

    /opt/apigee/apigee-setup/bin/update.sh -c zk -f configFile
  2. Her iki DC'deki 6 ve 12 numaralı makinelerde Postgres'i güncelleyin:
    /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
  3. Her iki DC'deki 1 ve 7 numaralı makinelerde LDAP'yi güncelleyin:
    /opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile
  4. DC-1'deki trafiği engelleyin ve tüm trafiğin diğer DC-2'ye yönlendirildiğinden emin olun

  5. Güncelleme DC-1'deki 1, 2 ve 3 numaralı makinelerde Cassandra'yı güncelleyin:
    /opt/apigee/apigee-setup/bin/update.sh -c cs -f configFile
  6. DC-1'deki 1. makinede yönetim sunucusunu güncelleyin:
    /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
  7. DC-1'deki 2. ve 3. makinede yönlendiriciyi ve mesaj işleyiciyi güncelleyin:
    /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
  8. DC-1'deki trafiğin engellemesini kaldırın ve DC-1'i doğrulayın. Ardından DC-2'deki trafiği engelleyerek ve trafiği DC-1'e yeniden yönlendirerek DC-2'ye geçin.
  9. DC-2'deki 7, 8 ve 9 numaralı makinelerde Cassandra'yı güncelleyin:
    /opt/apigee/apigee-setup/bin/update.sh -c cs -f configFile
  10. DC-2'deki 7. makinede yönetim sunucusunu güncelleyin:
    /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
  11. DC-2'deki 8 ve 9 numaralı makinelerde yönlendiriciyi ve mesaj işleyiciyi güncelleyin:
    /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
  12. DC-2'de trafiğin engellemesini kaldırın. Artık her iki DC de trafiği yönetecektir.
  13. 1 ve 7 numaralı makinelerdeki tüm yönetim sunucularında güncelleme komutunu yeniden çalıştırın:
    /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
  14. Her iki DC'deki 4,5,6,10,11,12 numaralı makinelerde edge-qpid-server ve edge-postgres-server'ı güncelleyin:
    /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
  15. Her iki DC'deki 4, 5, 10 ve 11 numaralı makinelerde Qpid'i güncelleyin:
    /opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
  16. Her iki DC'de de yeni kullanıcı arayüzünü (ue) veya klasik kullanıcı arayüzünü (ui) güncelleyin:
    /opt/apigee/apigee-setup/bin/update.sh -c  [ui|ue] -f configFile
  17. (apigee-adminapi'yi yüklediyseniz) Her iki DC'de de apigee-adminapi'yi güncelleyin:
    /opt/apigee/apigee-service/bin/apigee-service apigee-adminapi update
  18. (Apigee TOA'yı yüklediyseniz) Her iki DC'deki Apigee TOA düğümlerini güncelleyin:
    /opt/apigee/apigee-setup/bin/update.sh -c sso -f configFile
  19. Yeni Edge kullanıcı arayüzünü (edge-management-ui) veya klasik Edge kullanıcı arayüzünü (edge-ui) her iki DC'de de yeniden başlatın:
    /opt/apigee/apigee-service/bin/apigee-service [edge-ui|edge-management-ui] restart