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 bu RPM'leri 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ın karşılandığından emin olun:

  • Tüm düğümleri yedekleme
    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ışmaması ihtimaline karşı 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 Referans
4.52.01 Cassandra Cassandra sıkıştırma stratejisini değiştirme
4.52.00 Cassandra, Zookeeper, Qpid Cassandra sıkıştırma stratejisini değiştirme
4.51.00 Cassandra, Zookeeper, Qpid, Postgres Cassandra sıkıştırma stratejisini değiştirme

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üncelleme sırasında korunur.

Cassandra 3.11.16'ya yükseltme gerekli

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 belirli yönetim API'lerini kesintiye uğratarak hem Apigee kullanıcı arayüzünü hem de geliştirici portalını etkiler. Aşağıdaki dokümanda, çalışmayacak API'ler tam olarak belirtilmiştir ve yükseltme sırasında kesintinin ne zaman başlayıp ne zaman sona ereceğiyle ilgili adımlar özetlenmiştir. Yeni sürüme geçme işlemi sırasında çalışma zamanı trafiğinde kesinti yaşanmaması önemlidir.

Üst düzey geri alma

Cassandra yükseltmelerini bir düğümde bir uygulayın. Bir düğüm güncellenir güncellenmez, doğrudan geri alınamayan belirli şema değişiklikleri geçerli olur. Kümenin ne kadarının yükseltildiğine bağlı olarak farklı teknikler kullanılabileceğinden, geri alma ile ilgili bölümü dikkatlice okuyun.

Cassandra kümesinin tamamı yükseltildikten sonra yükseltmeyi geri almanız gerekirse tek seçenek yedeklemeleri geri yüklemektir. Buna hazırlanın ve Cassandra yedekleme geri yükleme hakkında bilgi edinin. Sanal makine düzeyindeki anlık görüntüleri Apigee yedeklemelerinden daha hızlı 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 fazla 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 belgelemek için çeşitli özellikler sunar. Drupal 7 tabanlı geliştirici portalını kullanmayı bırakmanızı öneririz. Ancak portalı kullanmaya ve SmartDocs özelliğinden yararlanmaya 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ğı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 ç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.

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 sırasında çalışma zamanı trafiği üzerinde herhangi bir etkisi olmadığını unutmayın. Ancak yönetim API'lerinin ve geliştirici portalı işlevlerinin küçük bir alt kümesinde kesinti yaşanıyor.

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

  1. Apigee'de 2.1.22 sürümü çalıştıran Cassandra.
  2. Edge for Private Cloud 4.52.02 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çin 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çerikleri içeren 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.
  • 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.
  • Henüz mevcut değilse 9160 ve 9042 bağlantı noktalarına Private Cloud için Edge 4.52.02 bileşenlerinin tamamından 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: 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, 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
  3. Yukarıdaki komut, aşağıdaki gibi 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 yükseltildikten sonra aşağıdaki yönetim işlevi bozulur:

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'de düşüş:

3a. adım: [isteğe bağlı] Daha önce dışa aktarılan SmartDocs dosyalarını içe aktarın

Tüm yönetim sunucuları yükseltildikten sonra 1. adımda dışa aktardığınız SmartDocs modellerini içe aktarabilirsiniz. Bunu daha sonra da yapabilirsiniz.

Çalışma zamanı durumu Yönetim Durumu
Çalışma zamanı tamamen işlevsel Yönetim tamamen çalışır durumda

4. adım: Tüm çalışma zamanı düğümlerini yükseltin

Tüm bölgelerdeki tüm Yönlendirici ve İleti İşlemcisi 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 çalışır durumda

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üğümlerini tek tek yükseltin.

Bu aşamada, Edge for Private Cloud 4.52.01'den önceki sürümlerden yükseltme yapıyorsanız ve Qpid veya Postgres'i yükseltmeyle ilgili ek adımları izliyorsanız ilgili adımları uygulayarak yükseltme yapın.

Çalışma zamanı durumu Yönetim Durumu
Çalışma zamanı tamamen işlevsel Yönetim tamamen çalışır durumda

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

Yükseltme tamamlandıktan sonra her Cassandra düğümünde aşağıdaki komutu tek tek ç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 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 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 çalışır durumda

Zookeeper 3.8.3'e yükseltme gerekli

Private Cloud için Edge 4.52.02, Zookeeper'a yükseltme içermese de 4.52.01'den önceki sürümlerden yükseltme yapıyorsanız 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 gerekli

  • Ö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 gerekli bölümüne bakın.
  • Private Cloud 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.

Qpid J-Broker'a yükseltme gerekli

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

  • Private Cloud için Edge 4.51.00 veya 4.52.00'den 4.52.02'ye 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 kurulumu 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, kaldığınız 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.

Kullanıcının /tmp'e erişimi 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 tekrar ekleyin.

  1. Makineleri, Makine güncelleme sırası bölümünde açıklandığı şekilde kurulumunuza uygun doğru sırayla 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 makineler için 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'yi 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 çalıştırı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, kurulum uzmanı bunu 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ı 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. Aşağıdaki örnekte gösterildiği gibi, Yönetim Sunucusu'ndaki apigee-validate yardımcı programını 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ü 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 ./sa_silent_config
    7. Henüz yapmadıysanız Edge kullanıcı arayüzü bileşenini çalıştıran 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 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 başka bir şekilde yasaklanmışsa güncellemeyi Apigee deposunun yerel bir deposundan veya aynasından yapabilirsiniz.

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, remoteRepo ise 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. Aşağıdaki örnekte gösterildiği gibi, Yönetim Sunucusu'ndaki apigee-validate yardımcı programını güncelleyin:
    /opt/apigee/apigee-service/bin/apigee-service apigee-validate update
  6. Aşağıdaki örnekte gösterildiği gibi, Yönetim Sunucusu'ndaki apigee-provision yardımcı programını güncelleyin:
    /opt/apigee/apigee-service/bin/apigee-service apigee-provision update
  7. update yardımcı programını, düğümlerinizde 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ü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ükleme 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üncellemesinin sırası

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

  • Diğer düğümleri güncellemeden önce tüm Cassandra ve ZooKeeper düğümlerini güncellemeniz gerekir.
  • Birden fazla Edge bileşeni (yönetim sunucusu, ileti işleyici, yönlendirici, QPID sunucusu ancak Postgres sunucusu değil) içeren makinelerde hepsini aynı anda güncellemek için -c edge seçeneğini kullanın.
  • Bir adımda birden fazla makinede yapılması gerektiği belirtiliyorsa bu adımı belirtilen makine sırasına göre gerçekleştirin.
  • 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 Cassandra ve ZooKeeper'ı güncelleyin:
    /opt/apigee/apigee-setup/bin/update.sh -c cs,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. 2. ve 1. makinedeki Edge bileşenlerini güncelleyin:
    /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
  5. 2. makinede Qpid'i güncelleyin:
    /opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
  6. 1. makinedeki kullanıcı arayüzünü güncelleyin:
    /opt/apigee/apigee-setup/bin/update.sh -c ui -f configFile
  7. (apigee-adminapi'yi yüklediyseniz) 1. makinedeki 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üklerken 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üğü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 Cassandra ve ZooKeeper'ı güncelleyin:
    /opt/apigee/apigee-setup/bin/update.sh -c cs,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. 4, 5, 1, 2, 3 numaralı makinelerdeki Edge bileşenlerini güncelleyin:
    /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
  6. 4. makinede Qpid'i güncelleyin:
    /opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
  7. 5. makinede Qpid'i güncelleyin:
    /opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
  8. 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 (1. makine olmayabilir) ue bileşenini güncelleyin:
      /opt/apigee/apigee-setup/bin/update.sh -c ue -f /opt/silent.conf
  9. (apigee-adminapi'yi yüklediyseniz) 1. makinedeki 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ü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

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 Cassandra ve ZooKeeper'ı güncelleyin:
    /opt/apigee/apigee-setup/bin/update.sh -c cs,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. 6, 7, 8, 9, 1, 4 ve 5 numaralı makinelerdeki Edge bileşenlerini şu sırayla güncelleyin:
    /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
  6. 6 ve 7 numaralı makinelerde Qpid'i güncelleyin:
    /opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
  7. 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
  8. (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
  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. 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üme yükseltme

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 Cassandra ve ZooKeeper'ı güncelleyin:
    /opt/apigee/apigee-setup/bin/update.sh -c cs,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. makinede LDAP'yi güncelleyin:
    /opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile
  5. 12, 13, 8, 9, 6, 7, 10 ve 11 numaralı makinelerdeki Edge bileşenlerini aşağıdaki sırayla güncelleyin:
    /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
  6. 12 ve 13 numaralı makinelerde Qpid'i güncelleyin:
    /opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
  7. 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
  8. (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
  9. (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.

  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 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. Cassandra ve ZooKeeper'ı güncelleyin:
    1. 1. Veri Merkezi'ndeki 1, 2 ve 3 numaralı 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üncelleyin:
    1. 1. Veri Merkezi'ndeki 6. Makine
      /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
    2. Veri Merkezi 2'deki 12 numaralı makine
      /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
  3. LDAP'yi güncelleme:
    1. 1. Veri Merkezi'ndeki 1. Makine
      /opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile
    2. 2. Veri Merkezi'ndeki 7. Makine
      /opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile
  4. Edge bileşenlerini güncelleme:
    1. 1. Veri Merkezi'ndeki 4, 5, 6, 1, 2, 3 numaralı makineler
      /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
    2. 2. Veri Merkezi'ndeki 10, 11, 12, 7, 8, 9 numaralı makineler
      /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
  5. qpidd'yi güncelleyin:
    1. 1. Veri Merkezi'ndeki 4 ve 5 numaralı makineler
      1. 4. makinede qpidd'yi güncelleyin:
        /opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
      2. 5. makinede qpidd öğesini güncelleyin:
        /opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
    2. 2. Veri Merkezi'ndeki 10 ve 11 numaralı makineler
      1. 10 numaralı makinede qpidd güncellemesi:
        /opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
      2. 11. makinede qpidd güncellemesi:
        /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. 1. Veri Merkezi'ndeki 1. makine:
      /opt/apigee/apigee-setup/bin/update.sh -c [ui|ue] -f configFile
    2. 2. Veri Merkezi'ndeki 7. makine:
      /opt/apigee/apigee-setup/bin/update.sh -c [ui|ue] -f configFile
  7. (apigee-adminapi'u yüklediyseniz) apigee-adminapi yardımcı programı güncellendi:
    1. 1. Veri Merkezi'ndeki 1. makine:
      /opt/apigee/apigee-service/bin/apigee-service apigee-adminapi update
    2. 2. Veri Merkezi'ndeki 7. makine:
      /opt/apigee/apigee-service/bin/apigee-service apigee-adminapi update
  8. (Apigee TOA'yı yüklediyseniz) Apigee TOA'yı güncelleyin:
    1. 1. Veri Merkezi'ndeki 1. makine:
      /opt/apigee/apigee-setup/bin/update.sh -c sso -f sso_config_file
    2. 2. Veri Merkezi'ndeki 7. makine:
      /opt/apigee/apigee-setup/bin/update.sh -c sso -f sso_config_file
    3. Burada sso_config_file, TOA'yı yüklerken oluşturduğunuz yapılandırma dosyasıdır.

  9. 1. ve 7. makinelerde yeni Edge kullanıcı arayüzünü (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ırmalar 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: Qpid sunucusu, Edge Postgres sunucusu, Yönetim sunucusu, Mesaj İşleyen ve Yönlendirici'nin bulunduğu düğümler sırasıyla tüm düğümlerde "-c edge" profilidir.
  6. qpidd
  7. Edge kullanıcı arayüzü (klasik veya yeni)
  8. apigee-adminapi
  9. Apigee TOA

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