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'un doğrudan 4.51.00, 4.52.00 veya 4.52.01 sürümünden 4.52.02 sürümüne yükseltilmesini destekler. Bu sayfada, bu tür yükseltmelerin nasıl yapılacağı açıklanmaktadır.

Güncellemeyi kimler gerçekleştirebilir?

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

Kenar BGBG'lerini yükledikten sonra, bunları herkes yapılandırabilir.

Hangi bileşenleri güncellemeniz gerekiyor?

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

Ön koşulları güncelleme

Apigee Edge'i yükseltmeden önce aşağıdaki ön koşulları yerine getirin:

  • Tüm düğümleri yedekleyin
    Güncellemeden önce güvenlik nedeniyle tüm düğümlerin eksiksiz bir yedeğini almanızı öneririz. Yedeklemeyi gerçekleştirmek için geçerli Edge sürümünüze ait prosedürü kullanın.

    Bu sayede, yeni sürüme güncellemenin düzgün çalışmaması ihtimaline karşı bir yedek planınız olabilir. Yedekleme hakkında daha fazla bilgi için Yedekleme ve Geri Yükleme başlıklı makaleyi inceleyin.

  • Edge'nin çalıştığından emin olun
    Şu 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. Cassandra sıkıştırma stratejisinin Cassandra sıkıştırma stratejisini değiştirme bölümünde açıklandığı gibi LeveledCompactionStrategy olarak ayarlandığından emin olun.

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

Edge for Private Cloud 4.52.02 sürümüne geçmek için belirli yazılımları yükseltmeyle ilgili belirli adımları çalıştırmayı düşünebilirsiniz. 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. Bu sayfanın sonraki bölümlerinde her bir yazılım için ayrıntılı tartışmalar ve kesin adımlar sağlanmaktadır.

Mevcut sürüm 4.52.02 sürümüne yükseltmek için özel adımlar gerektiren yazılımlar
4.52.01 Cassandra
4.52.00 Cassandra, Hayvanat Bahçesi, Qpid
4.51.00 Cassandra, Hayvanat Bahçesi, Qpid, Postgres

Mülk ayarlarının otomatik olarak yayılması

/opt/apigee/customer/application içinde .properties dosyalarını düzenleyerek herhangi bir özellik ayarladıysanız bu değerler güncelleme tarafından korunur.

Cassandra 3.11.16 sürümüne gerekli yükseltme

Private Cloud 4.52.02 için Apigee Edge, Cassandra'nın 3.11.16 sürümüne yükseltilmiştir. Cassandra, Apigee'nin önemli bir bileşenidir. Bu yükseltme, Cassandra'ya sorgu göndermek ve yazmak için kullanılan çeşitli çalışma zamanı ve yönetim bileşenlerindeki sürücü yazılımı güncellemeleri de içerir.

Bu önemli bir yükseltme olduğundan, yeni sürümlerde en iyi performansı sunabilmek için Apigee'nin Cassandra'daki veri modelinde bazı değişiklikler yapılması gerekiyordu. Bu değişiklikler çok küçük olsa da yükseltme işlemi belirli yönetim API'lerinde aksamaya neden olarak hem Apigee kullanıcı arayüzünü hem de geliştirici portalını etkiler. Aşağıdaki dokümanda, çalışmayacak olan API'ler tam olarak belirtilmiş ve yükseltme sırasında kesinti başladığında ve sona erdiğinde gerçekleştirilmesi gereken adımlar özetlenmektedir. Daha da önemlisi, yükseltme sırasında çalışma zamanı trafiğinde herhangi bir kesinti yaşanmaması gerekir.

Üst düzey geri alma

Cassandra yükseltmelerini tek seferde bir düğüm uygula. Bir düğüm güncellendiğinde doğrudan geri alınamayacak belirli şema değişiklikleri geçerlilik kazanır. Kümenin ne kadarının yükseltildiğine bağlı olarak farklı teknikler kullanılabildiğinden Geri Alma ile ilgili bölümü ayrıntılı olarak okuyun.

Cassandra kümesinin tamamı yeni sürüme geçirildikten sonra yükseltmeyi geri çekmeniz gerekirse tek seçenek, yedekleri geri yüklemektir. Bu duruma hazırlanın ve Cassandra yedek geri yükleme hakkında bilgi edinin. Sanal makine düzeyindeki anlık görüntüleri Apigee yedeklemelerinden daha hızlı bir şekilde geri yükleyebiliyorsanız Cassandra sanal makinelerinizi daha önceki bir duruma geri yüklemek için sanal makine anlık görüntülerini kullanın.

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

Geliştirici portalında API'leri belgeleme

Apigee Drupal geliştirici portalı, API'lerinizi belgelemeniz için çeşitli özellikler sunar. Drupal 7 tabanlı geliştirici portalını kullanmaktan vazgeçmeniz önerilir. Ancak bu portalı kullanmaya devam ediyorsanız ve SmartDokümanlar özelliğini kullanıyorsanız SmartDokümanlar API'lerini Kullanma başlıklı belge sizin için de geçerli olacaktır. Geliştirici portalının daha yeni sürümlerini kullanıyorsanız bu yükseltme işleminin API belgeleriniz üzerinde bir etkisi olmayacaktır.

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

Aşağıdaki bölümlerde kullanılan terminoloji

Çalışma zamanı: Çalışma zamanı, çalışma zamanı proxy trafiğinizin işlenmesini kapsar. Mevcut proxy'ler için bir çalışma zamanı 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. Bununla birlikte, yeni proxy'lerin dağıtılmasını veya proxy'lerin yeni revizyonlarını içermez.

Yönetim: Yönetim, Apigee Edge sisteminizin yönetimini de kapsar. Dağıtımlar, uygulamalarda, ürünlerde, hedef sunucularda, anahtar depolarında ve benzeri yerlerde yapılan değişiklikler bu kapsamdadır, 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.

Aşağıdaki her adımda, yükseltme prosedürünün çeşitli aşamalarında ilerledikçe çalışma zamanı ve yönetim durumu açıklanmıştır. Yükseltme işleminin çalışma zamanı trafiği üzerinde herhangi bir etkisi olmayacağını unutmayın. Ancak yönetim API'lerinin ve geliştirici portalı işlevlerinin küçük bir kısmında kesinti söz konusudur.

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

  1. Apigee'de 2.1.22 sürümü ile çalışan Cassandra.
  2. Edge for Private Cloud 4.52.02 bileşenleri:
    • Eski ikinci el protokolü üzerinden Cassandra ile iletişim kuran yönetim-sunucu.
    • Eski ikinci el protokolü üzerinden Cassandra ile iletişim kuran çalışma zamanı sunucuları (İleti İşlemcileri 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 işlevsel

1. adım: Yükseltme için hazırlanın

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

  1. Cassandra'yı LeveledCompactionStrateji'yi kullanacak şekilde değiştirin.
  2. Apigee'yi kullanarak Cassandra'yı yedekleyin.
  3. Cassandra düğümlerinin sanal makine anlık görüntülerini alın (uygunsa).
  4. /opt/apigee/apigee-cassandra/cass_upgrade.conf adresindeki her Cassandra düğümünde aşağıdaki içeriklerle 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
        
    Dosya /opt/apigee/apigee-cassandra/cass_upgrade.conf adresinde oluşturulamıyorsa her Cassandra düğümünde aynı içerikle /opt/silent.conf dosyasını oluşturun.
  • Apigee Drupal 7 geliştirici portalının SmartDokümanlar özelliğini kullanıyorsanız modellerinizin her birini geliştirici portalı kullanıcı arayüzünden JSON biçiminde indirerek dışa aktarın. Yönetim sunucuları güncellendikten sonra bu modellerin Apigee'ye geri aktarılması gerekir.
  • 9160 ve 9042 bağlantı noktalarına, henüz mevcut değilse, tüm Edge for Private Cloud 4.52.02 bileşenlerinden Cassandra düğümlerine erişilebildiğinden emin olun. Daha fazla bilgi için Bağlantı noktası gereksinimleri bölümüne bakın.

2. Adım: Tüm Cassandra düğümlerini yükseltin

  1. Tüm bölgelerdeki tüm Cassandra düğümlerini tek tek yükseltin. Her düğümde aşağıdaki komutları çalıştırın:
    /opt/apigee/apigee-setup/bin/update.sh -c cs -f configFile
  2. Bir düğüm güncellendikten sonra, ilerlemeden önce bazı doğrulamalar çalıştırmak 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
  3. Yukarıdaki sonuç şuna benzer bir çıktı verir:
    Cassandra version is verified - [cqlsh 5.0.1 | Cassandra 3.11.16 | CQL spec 3.4.4 | Native protocol v3] Metadata is verified
Bu aşamadaki çalışma zamanı durumu Bu aşamadaki yönetim durumu
Çalışma zamanı tamamen işlevsel Cassandra yeni sürüme geçirildikten sonra aşağıdaki yönetim işlevi bozuldu:

3. Adım: Tüm Yönetim düğümlerini yükseltin

Tüm bölgelerdeki tüm Yönetim düğümlerini tek tek yükseltin:

/opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
Çalışma Zamanı Durumu Yönetim Durumu
Çalışma zamanı tamamen işlevsel Management API kullanımdan kaldırıldı:

3a Adımı: [isteğe bağlı] Daha önce dışa aktarılan SmartDokümanlar'ı içe aktarın

Tüm yönetim sunucuları yeni sürüme geçirildikten sonra, 1. adımda dışa aktardığınız SmartDokümanlar modellerini içe aktarabilirsiniz. Bu işlemi daha sonra da yapabilirsiniz.

Çalışma Zamanı Durumu Yönetim Durumu
Çalışma zamanı tamamen işlevsel Yönetim tamamen işlevsel

4. Adım: Tüm Çalışma Zamanı düğümlerini yükseltin

Tüm bölgelerdeki tüm Yönlendiricileri ve İleti İşlemci düğümlerini tek tek yükseltin:

/opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
Çalışma Zamanı Durumu Yönetim Durumu
Çalışma zamanı tamamen işlevsel Yönetim tamamen işlevsel

5. Adım: Kalan tüm Edge for Private Cloud 4.52.02 bileşenlerini yükseltin

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

Bu aşamada, Edge for Private Cloud 4.52.01'den önceki sürümlerden yükseltme yapıyor ve Qpid veya Postgres'i yükseltmeyle ilgili ek adımları uyguluyorsanız aynı sürümü yükseltmek için ilgili adımları uygulayın.

Çalışma Zamanı Durumu Yönetim Durumu
Çalışma zamanı tamamen işlevsel Yönetim tamamen işlevsel

6. adım: Yükseltme sonrası adımlar

Yükseltme işlemi tamamlandıktan sonra her Cassandra düğümünde aşağıdaki komutu çalıştırın:

/opt/apigee/apigee-service/bin/apigee-service apigee-cassandra post_upgrade

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

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

Henüz yapmadıysanız 3a adımını tamamlayın.

Çalışma Zamanı Durumu Yönetim Durumu
Çalışma zamanı tamamen işlevsel Yönetim tamamen işlevsel

Zookeeper 3.8.3'e zorunlu yükseltme

Edge for Private Cloud 4.52.02 sürümü, Zookeeper'a yükseltmeyi içermese de 4.52.01'den daha eski sürümlerden yeni sürüme geçiyorsanız Zookeeper'ı yükseltmeyle ilgili adımları uygulamanız gerekir.

  • Private Cloud'un 4.51.00 veya 4.52.00 sürümleri için Edge'den yeni sürüme geçiyorsanız Zookeeper'ı yeni sürüme geçirmek için Zookeeper 3.8.3'e geçiş için gerekli yükseltme başlıklı makaledeki adımlara bakın.
  • Edge for Private Cloud'un 4.52.01 sürümüne geçiş yapıyorsanız Zookeeper'ın 3.8.3 sürümünü zaten kullanıyor olmanız gerekir ve Zookeeper'ı yükseltmek için özel bir adım uygulamanız gerekmez.

Postgres 14'e yükseltme gerekli

  • Edge for Private Cloud 4.51.00 sürümünden 4.52.02 sürümüne geçiş yapıyorsanız Edge for Private Cloud 4.52.02 sürümü Postgres yükseltmesini içermese bile Postgres'i yükseltme adımlarını uygulamanız gerekir. Edge for Private Cloud 4.51.00'dan 4.52.02'ye yükseltme işlemi için ek Postgres yükseltme adımları gerekir. Lütfen Postgres 14'e yükseltme gerekli bölümüne bakın.
  • Edge for Private Cloud 4.52.00 veya 4.52.01 sürümünden 4.52.02 sürümüne geçiyorsanız ek Postgres yükseltme adımları gerekmez.

Qpid J-Broker'a yükseltme gerekli

Edge for Private Cloud 4.52.02 sürümü, QPID'ye yükseltme içermese de 4.52.01'den daha eski bir sürümden yükseltme yapıyorsanız QPID'yi yükseltme adımlarını uygulamanız gerekir.

  • Edge for Private Cloud 4.51.00 veya 4.52.00 sürümünden 4.52.02 sürümüne geçiş 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çiş yapıyorsanız lütfen Qpid'yi Yeni Sürüme Geçirme bölümüne bakın.
  • Edge for Private Cloud 4.52.01 sürümünden 4.52.02 sürümüne geçiyorsanız Qpid Broker'ın en yeni sürümünü kullanıyor olmanız gerekir. 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 Private Cloud için yeni Edge kullanıcı arayüzü bölümüne bakın.

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

İlk kurulumu tamamladıktan sonra Apigee, Private Cloud için Apigee Edge'in geliştiricileri ve yöneticilerine yönelik gelişmiş 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ğrulamasını 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 bölümüne bakın.

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

Edge Kullanıcı Arayüzü bileşenini güncellemek için yükseltme yaptığınız Private Cloud'un Edge sürümünü düşünün:

Apigee mTLS ile güncelleyin

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

Güncellemeyi geri çekme

Güncelleme hatası durumunda, sorunu düzeltmeyi deneyebilir ve ardından update.sh uygulamasını tekrar çalıştırabilirsiniz. Güncellemeyi birden çok kez çalıştırabilirsiniz. Güncelleme kaldığı yerden devam eder.

Hata, güncellemeyi önceki sürüme geri almanızı gerektiriyorsa ayrıntılı talimatlar için 4.52.00 sürümüne geri dönme bölümüne bakın.

Günlük kaydı güncelleme bilgileri

Varsayılan olarak update.sh yardımcı programı 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 bu dizine erişimi yoksa bu, günlüğü /tmp dizinine update_username.log adlı bir dosya olarak yazar.

Kişinin /tmp hizmetine erişimi yoksa update.sh yardımcı programı başarısız olur.

Sıfır kapalı kalma süresi güncellemesi

Sıfır kapalı kalma süresi güncellemesi veya periyodik güncelleme, Edge'i indirmeden Edge yüklemenizi güncellemenize olanak tanır.

Sıfır kapalı kalma süresi güncellemesi yalnızca 5 düğüm ve daha büyük yapılandırmalarda yapılabilir.

Kapalı kalma süresini sıfıra yükseltmenin anahtarı, her bir Yönlendiriciyi yük dengeleyiciden tek tek kaldırmaktır. Daha sonra Yönlendirici'yi ve Yönlendirici ile aynı makinedeki diğer bileşenleri güncellersiniz ve ardından Yönlendiriciyi tekrar yük dengeleyiciye eklersiniz.

  1. Makineleri, Makine güncelleme sırası bölümünde açıklandığı gibi yüklemeniz için doğru sırayla güncelleyin.
  2. Yönlendiricileri güncelleme zamanı geldiğinde bir Yönlendirici seçin ve Sunucu (İleti İşlemci/Yönlendirici) erişilebilirliğini etkinleştirme/devre dışı bırakma bölümünde açıklandığı gibi ilgili yönlendiriciyi erişilemez hale getirin.
  3. Seçilen Yönlendirici'yi ve diğer tüm Edge bileşenlerini Yönlendirici ile aynı makinede güncelleyin. Tüm Edge yapılandırmaları aynı düğümde bir Yönlendirici ve Mesaj İşleyici gösterir.
  4. Yönlendiriciyi tekrar erişilebilir hale getirin.
  5. Kalan Yönlendiriciler için 2 ile 4 arasındaki adımları tekrarlayın.
  6. Yüklemenizdeki kalan makineler için güncellemeye devam edin.

Güncelleme öncesinde ve sonrasında aşağıdakileri yapın:

Sessiz bir yapılandırma dosyası kullanma

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

Harici internet bağlantısı olan bir düğümde 4.52.02 sürümüne güncelleyin

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

  1. Varsa güncelleme tamamlanana kadar Cassandra'da onarım işlemi gerçekleştirecek şekilde yapılandırılmış tüm cron işlerini devre dışı bırakın.
  2. Edge BGBG'lerini yüklemek için düğümünüze kök olarak giriş yapın.
  3. yum-utils ve yum-plugin-priorities sürümlerini 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ükleme yapıyorsanız şu komutu yürütün:
    sudo yum-config-manager --enable ol7_optional_latest
  6. AWS'ye yükleme yapıyorsanız aşağıdaki yum-configure-manager komutlarını 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 hedefine indirin:
      curl https://software.apigee.com/bootstrap_4.52.02.sh -o /tmp/bootstrap_4.52.02.sh
    2. Şu 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 adımını atlarsanız bunu girmeniz istenir.

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

      Java yüklemesinin nasıl yapılacağını belirtmek için JAVA_FIX seçeneğini kullanın. JAVA_FIX şu değerleri alır:

      • I: OpenJDK 1.8'i (varsayılan) yükleyin.
      • C: Java'yı yüklemeden devam edin.
      • Q: Çık. Bu seçeneği kullanabilmek için Java'yı kendiniz yüklemeniz gerekir.
    3. apigee-setup yardımcı programını güncellemek için apigee-service kullanın. Örnekteki gibi:
      /opt/apigee/apigee-service/bin/apigee-service apigee-setup update
    4. Yönetim Sunucusu'ndaki 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 Sunucusu'ndaki 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 çalıştırarak düğümlerinizde update yardımcı programını çalıştırın:
      /opt/apigee/apigee-setup/bin/update.sh -c component -f configFile

      Bu işlemi Makine güncelleme sırası bölümünde açıklanan sırayla yapın.

      Burada:

      • component, güncellenecek Edge bileşenidir. Olası değerlerden bazıları şunlardır:
        • cs: Cassandra
        • edge: Edge Kullanıcı Arayüzü hariç tüm Edge bileşenleri: Yönetim Sunucusu, Mesaj İşlemci, 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: Hayvanat bahçesi bakıcısı
      • 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 öğesini "tümü" olarak ayarlayarak update.sh öğesini tüm bileşenlerde çalıştırabilirsiniz. Ancak, bu işlem için Edge hepsi bir arada (AIO) yükleme profiliniz 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şenini, çalıştırılan tüm düğümlerde yeniden başlatın:
      /opt/apigee/apigee-service/bin/apigee-service 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 çekmeye karar verirseniz 4.52.02 sürümüne geri alma bölümünde açıklanan prosedürü kullanın.

Yerel depodan 4.52.02 sürümüne güncelleme

Edge düğümleriniz bir güvenlik duvarının arkasındaysa veya herhangi bir şekilde Apigee deposuna internet üzerinden erişmesi yasaksa güncellemeyi Apigee deposunun yerel deposundan veya yansıtmasından gerçekleştirebilirsiniz.

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

  • Deponun bir .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 depo içeren düğüme bir web sunucusu yükleyin. Apigee, sizin için Nginx web sunucusunu sağlar. Dilerseniz kendi web sunucunuzu da kullanabilirsiniz.

Yerel 4.52.02 kod deposundan güncelleme yapmak için:

  1. Edge Apigee-setup yardımcı programını yükleme makalesindeki "Yerel Apigee deposu oluşturma" bölümünde açıklandığı gibi bir yerel 4.52.02 depo oluşturun.
  2. Apigee-service'yi .tar dosyasından yüklemek için:
    1. Yerel depoya sahip düğümde aşağıdaki komutu kullanarak yerel depoyu /opt/apigee/data/apigee-mirror/apigee-4.52.02.tar.gz adlı tek bir .tar dosyası olarak paketleyin:
      /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, bunu yeni düğümdeki /tmp dizinine kopyalayın.
    3. Yeni düğümde dosyayı /tmp dizinine kaldırı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. /tmp/repos projesinden Edge apigee-service yardımcı programını ve bağımlıları yükleyin:
      sudo bash /tmp/repos/bootstrap_4.52.02.sh apigeeprotocol="file://" apigeerepobasepath=/tmp/repos

      Depo dizininin yolunu bu komuta eklediğinize dikkat edin.

  3. Nginx web sunucusunu kullanarak Apigee-service'yi yüklemek için:
    1. Nginx web sunucusunu, Edge Apigee-setup yardımcı programını yükleme başlıklı makaledeki "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 hedefine 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 ayarladığınız kullanıcı adı ve şifre, remoteRepo ise depo düğümünün IP adresi veya DNS adıdır.

    3. Uzak düğüme 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, depo kullanıcı adı ve şifresidir.

  4. apigee-setup yardımcı programını güncellemek için apigee-service kullanın. Örnekteki gibi:
    /opt/apigee/apigee-service/bin/apigee-service apigee-setup update 
  5. Yönetim Sunucusu'ndaki 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 Sunucusu'ndaki 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. Düğümlerinizde update yardımcı programını Makine güncelleme sırası bölümünde açıklanan sırayla ç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üncellersiniz:
      • cs: Cassandra
      • edge: Edge Kullanıcı Arayüzü hariç tüm Edge bileşenleri: Yönetim Sunucusu, İleti İşlemci, 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: Hayvanat bahçesi bakıcısı
    • 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 öğesini "tümü" olarak ayarlayarak update.sh öğesini tüm bileşenlerde çalıştırabilirsiniz. Ancak, bu işlem için Edge hepsi bir arada (AIO) yükleme profiliniz 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 çekmeye karar verirseniz 4.52.02 sürümüne geri alma bölümünde açıklanan prosedürü kullanın.

Makine güncelleme sırası

Edge kurulumunda makineleri güncelleme sıranız önemlidir:

  • Başka düğümleri güncellemeden önce tüm Cassandra ve ZooKeeper düğümlerini güncellemeniz gerekir.
  • Birden fazla Edge bileşeni olan makinelerde (Postgres Server değil, Yönetim Sunucusu, İleti İşlemci, Yönlendirici, QPID Sunucusu) tüm cihazları aynı anda güncellemek için -c edge seçeneğini kullanın.
  • Bir adımın birden fazla makinede uygulanması gerektiğini belirtiyorsa bu işlemi belirtilen makine sırasına göre gerçekleştirin.
  • Para Kazanma'yı güncellemek için ayrı bir adım yoktur. -c edge seçeneğini belirlediğinizde güncellenir.

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

1 düğümlü bağımsız yapılandırmayı 4.52.02 sürümüne 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 uygulamasını 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 yükleme için aşağıdaki bileşenleri güncelleyin:

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

  1. Makine 1'de Cassandra ve ZooKeeper'ı güncelleme:
    /opt/apigee/apigee-setup/bin/update.sh -c cs,zk -f configFile
  2. Makine 2'de Postgres'i güncelleyin:
    /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
  3. Makine 1'de LDAP'yi güncelleme:
    /opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile
  4. Makine 2 ve 1'de Edge bileşenlerini güncelleyin:
    /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
  5. Makine 2'de Qpid'i güncelleme:
    /opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
  6. Makine 1'deki kullanıcı arayüzünü güncelleyin:
    /opt/apigee/apigee-setup/bin/update.sh -c ui -f configFile
  7. (apigee-adminapi uygulamasını yüklediyseniz) 1. makinede apigee-adminapi yardımcı programını güncelledi:
    /opt/apigee/apigee-service/bin/apigee-service apigee-adminapi update
  8. (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üklediğinizde oluşturduğunuz yapılandırma dosyasıdır.

  9. 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üğümlü yükseltme

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

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

  1. Makine 1, 2 ve 3'te Cassandra ve ZooKeeper'ı güncelleme:
    /opt/apigee/apigee-setup/bin/update.sh -c cs,zk -f configFile
  2. Makine 4'te Postgres'i güncelleyin:
    /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
  3. Makine 5'te Postgres'i güncelleme:
    /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
  4. Makine 1'de LDAP'yi güncelleme:
    /opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile
  5. Makine 4, 5, 1, 2 ve 3'te Edge bileşenlerini güncelleyin:
    /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
  6. Makine 4'te Qpid'i güncelleyin:
    /opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
  7. Makine 5'te Qpid'i güncelleme:
    /opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
  8. Edge kullanıcı arayüzünü güncelleyin:
    • Klasik kullanıcı arayüzü: Klasik kullanıcı arayüzünü kullanıyorsanız aşağıdaki örnekte gösterildiği gibi makine 1'de 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 (makine 1 olmayabilir):
      /opt/apigee/apigee-setup/bin/update.sh -c ue -f /opt/silent.conf
  9. (apigee-adminapi uygulamasını yüklediyseniz) 1. makinede apigee-adminapi yardımcı programını güncelledi:
    /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üklediğinizde 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 edge-ui bileşenini makine 1'de 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 edge-management-ui bileşenini uygun makinede yeniden başlatın (1. makine olmayabilir):
      /opt/apigee/apigee-service/bin/apigee-service edge-management-ui restart

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

9 düğümlü kümeli yükleme için aşağıdaki bileşenleri güncelleyin:

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

  1. Makine 1, 2 ve 3'te Cassandra ve ZooKeeper'ı güncelleme:
    /opt/apigee/apigee-setup/bin/update.sh -c cs,zk -f configFile
  2. Makine 8'de Postgres'i güncelleyin:
    /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
  3. Makine 9'da Postgres'i güncelleyin:
    /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
  4. Makine 1'de LDAP'yi güncelleme:
    /opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile
  5. Makine 6, 7, 8, 9, 1, 4 ve 5'teki Edge bileşenlerini şu sırayla güncelleyin:
    /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
  6. Makine 6 ve 7'de Qpid'i güncelleme:
    /opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
  7. Makine 1'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
  8. (apigee-adminapi uygulamasını yüklediyseniz) 1. makinede apigee-adminapi yardımcı programını güncelleyin:
    /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üklediğinizde oluşturduğunuz yapılandırma dosyasıdır.

  10. 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 edge-ui bileşenini makine 1'de 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 edge-management-ui bileşenini uygun makinede yeniden başlatın (1. makine olmayabilir):
      /opt/apigee/apigee-service/bin/apigee-service edge-management-ui restart

13 düğümlü küme yükseltmesi

13 düğümlü kümeli yükleme için aşağıdaki bileşenleri güncelleyin:

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

  1. Cassandra ve ZooKeeper'ı 1, 2 ve 3 numaralı makinelerde güncelleyin:
    /opt/apigee/apigee-setup/bin/update.sh -c cs,zk -f configFile
  2. Makine 8'de Postgres'i güncelleyin:
    /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
  3. Makine 9'da Postgres'i güncelleyin:
    /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
  4. Makine 4 ve 5'te LDAP'yi güncelleme:
    /opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile
  5. 12, 13, 8, 9, 6, 7, 10 ve 11 numaralı makinelerde Edge bileşenlerini şu sırayla güncelleyin:
    /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
  6. Makine 12 ve 13'te Qpid'yi güncelleme:
    /opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
  7. Makine 6 ve 7'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
  8. (apigee-adminapi uygulamasını yüklediyseniz) apigee-adminapi yardımcı programını 6 ve 7 makinelerinde güncelleyin:
    /opt/apigee/apigee-service/bin/apigee-service apigee-adminapi update
  9. (Apigee TOA'yı yüklediyseniz) 6 ve 7 numaralı 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üklediğinizde oluşturduğunuz yapılandırma dosyasıdır.

  10. 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 edge-ui bileşenini 6 ve 7 numaralı makinelerde 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 ardından makine 6 ve 7'de 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ükseltmesi

12 düğümlü kümeli yükleme için aşağıdaki bileşenleri güncelleyin:

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

  1. Cassandra ve ZooKeeper'ı güncelleme:
    1. Veri Merkezi 1'deki 1, 2 ve 3. makinelerde:
      /opt/apigee/apigee-setup/bin/update.sh -c cs,zk -f configFile
    2. Veri Merkezi 2'deki 7, 8 ve 9 numaralı makinelerde
      /opt/apigee/apigee-setup/bin/update.sh -c cs,zk -f configFile
  2. Postgres'i güncelleme:
    1. Veri Merkezi 1'de Makine 6
      /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
    2. Veri Merkezi 2'de Makine 12
      /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
  3. LDAP'yi güncelleme:
    1. Veri Merkezi 1'de Makine 1
      /opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile
    2. Veri Merkezi 2'de Makine 7
      /opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile
  4. Edge bileşenlerini güncelleyin:
    1. Veri Merkezi 1'deki makine 4, 5, 6, 1, 2, 3
      /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
    2. Veri Merkezi 2'deki Makine 10, 11, 12, 7, 8, 9
      /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
  5. Qpidd'i güncelleme:
    1. Veri Merkezi 1'de Makine 4 ve 5
      1. Makine 4'te qpidd değerini güncelleyin:
        /opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
      2. Makine 5'te qpidd değerini güncelleyin:
        /opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
    2. Veri Merkezi 2'deki Makine 10 ve 11
      1. Makine 10'da qpidd güncelleme:
        /opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
      2. Makine 11'de qpidd güncelleme:
        /opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
  6. Yeni kullanıcı arayüzünü (ue) veya klasik kullanıcı arayüzünü (ui) güncelleyin:
    1. Veri Merkezi 1'deki Makine 1:
      /opt/apigee/apigee-setup/bin/update.sh -c [ui|ue] -f configFile
    2. Veri Merkezi 2'deki Makine 7:
      /opt/apigee/apigee-setup/bin/update.sh -c [ui|ue] -f configFile
  7. (apigee-adminapi uygulamasını yüklediyseniz) apigee-adminapi yardımcı programı güncellendi:
    1. Veri Merkezi 1'deki Makine 1:
      /opt/apigee/apigee-service/bin/apigee-service apigee-adminapi update
    2. Veri Merkezi 2'deki Makine 7:
      /opt/apigee/apigee-service/bin/apigee-service apigee-adminapi update
  8. (Apigee TOA'yı yüklediyseniz) Apigee TOA'yı güncelleyin:
    1. Veri Merkezi 1'deki Makine 1:
      /opt/apigee/apigee-setup/bin/update.sh -c sso -f sso_config_file
    2. Veri Merkezi 2'deki Makine 7:
      /opt/apigee/apigee-setup/bin/update.sh -c sso -f sso_config_file
    3. Burada sso_config_file, TOA'yı yüklediğinizde oluşturduğunuz yapılandırma dosyasıdır.

  9. 1 ve 7 numaralı makinelerde yeni Edge kullanıcı arayüzü (edge-management-ui) veya klasik Edge kullanıcı arayüzü (edge-ui) bileşenini yeniden başlatın:
    /opt/apigee/apigee-service/bin/apigee-service [edge-ui|edge-management-ui] restart

Standart olmayan yapılandırma için

Standart olmayan bir yapılandırmanız varsa Edge bileşenlerini aşağıdaki sırayla güncelleyin:

  1. ZooKeeper
  2. Cassandra
  3. ps
  4. LDAP
  5. Edge, sıradaki tüm düğümlerde bulunan "-c uç" profili anlamına gelir: Qpid sunucusu, Edge Postgres Sunucusu, Yönetim Sunucusu, İleti İşlemci ve Yönlendirici olan düğümler.
  6. Qpidd
  7. Edge kullanıcı arayüzü (klasik veya yeni)
  8. apigee-adminapi
  9. Apigee TOA

Güncellemeyi bitirdikten sonra Edge kullanıcı arayüzü bileşenini çalıştıran tüm makinelerde yeniden başlattığınızdan emin olun.