Apigee Edge 4.19.06 veya 4.50.00 sürümünü 4.51.00 olarak güncelleyin.

Bu bölümde, Apigee Edge 4.19.06 veya 4.50.00 sürümünden 4.51.00 sürümüne nasıl yükseltileceği açıklanmaktadır.

Güncellemeyi kimler gerçekleştirebilir?

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

Edge BGBG'leri yüklendikten sonra herkes yapılandırabilir.

Hangi bileşenleri güncellemeniz gerekir?

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

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 ile korunur.

Postgres 10.17'ye geçiş gerekli

Edge'in bu sürümü, Postgres 10.17 sürümüne bir yükseltme içerir. Bu yükseltme kapsamında tüm Postgres verileri Postgres 10.17'ye taşınır.

Çoğu Edge üretim sistemi, ana bekleme modunda çoğaltma için yapılandırılmış iki Postgres düğümü kullanır. Güncelleme işlemi sırasında Postgres düğümleri güncelleme nedeniyle kullanım dışıyken analiz verileri hâlâ Qpid düğümlerine yazılır. Postgres düğümleri güncellenip tekrar internete bağlandıktan sonra, analiz verileri Postgres düğümlerine aktarılır.

Postgres güncellemesini gerçekleştirme şekliniz, Postgres düğümleriniz için veri depolama alanını nasıl yapılandırdığınıza bağlıdır:

  • Postgres düğümleriniz için yerel veri depolama alanı kullanıyorsanız yükseltme süresince yeni bir Postgres bekleme düğümü yüklemeniz gerekir. Yükseltme işlemi tamamlandıktan sonra yeni Postgres bekleme düğümünü devre dışı bırakabilirsiniz.

    Herhangi bir nedenle güncellemeyi geri çekmeniz gerekirse ek Postgres bekleme düğümü gerekir. Güncellemeyi geri çekmeniz gerekirse yeni Postgres bekleme düğümü, geri alma işleminden sonra ana Postgres düğümü olur. Bu nedenle, yeni Postgres bekleme düğümünü kurduğunuzda bu düğüm, Edge Yükleme şartlarında tanımlandığı gibi Postgres sunucusunun tüm donanım gereksinimlerini karşılayan bir düğümde olmalıdır.

    Edge'in 1 ve 2 düğümlü yapılandırmasında prototip oluşturma ve test için kullanılan topolojilerde yalnızca tek bir Postgres düğümünüz vardır. Bu Postgres düğümlerini, yeni bir Postgres düğümü oluşturmanız gerekmeden doğrudan güncelleyebilirsiniz.

  • Apigee tarafından önerildiği gibi Postgres düğümleriniz için ağ depolama alanı kullanıyorsanız yeni bir Postgres düğümü yüklemeniz gerekmez. Aşağıdaki prosedürlerde, yeni bir Postgres bekleme düğümünü kurmayı ve daha sonra geçersiz kılmayı belirten adımları atlayabilirsiniz.

    Güncelleme işlemine başlamadan önce, Postgres tarafından kullanılan veri deposunun ağ anlık görüntüsünü alın. Ardından, güncelleme sırasında herhangi bir hata oluşursa ve geri alma işlemi yapmak zorunda kalırsanız Postgres düğümünü ilgili anlık görüntüden geri yükleyebilirsiniz.

Yeni bir Postgres bekleme düğümü yükleniyor

Bu prosedür, yeni bir düğümde bir Postgres bekleme sunucusu oluşturur. Edge'in 4.51.00 sürümü için değil, mevcut Edge sürümünüz (4.19.06 veya 4.50.00) için yeni bir Postgres bekleme sunucusu yüklediğinizden emin olun.

Yüklemeyi gerçekleştirmek için Edge'in mevcut sürümünü yüklerken kullandığınız yapılandırma dosyasını kullanın.

Yeni bir Postgres bekleme düğümü oluşturmak için:

  1. Geçerli Postgres ana kopyasında, aşağıdaki jetonu ayarlamak için /opt/apigee/customer/application/postgresql.properties dosyasını düzenleyin. Dosya yoksa oluşturun:
    conf_pg_hba_replication.connection=host replication apigee existing_standby_ip/32 trust\ \nhost replication apigee new_standby_ip/32 trust

    Burada existing_standby_ip, mevcut Postgres bekleme sunucusunun IP adresidir. new_standby_ip ise yeni bekleme düğümünün IP adresidir.

  2. Postgres ana slaydında apigee-postgresql öğesini yeniden başlatın:
    /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql restart
  3. Ana düğümdeki /opt/apigee/apigee-postgresql/conf/pg_hba.conf dosyasını görüntüleyerek yeni bekleme düğümünün eklendiğini doğrulayın. Dosyada şu satırları görürsünüz:
    host replication apigee existing_standby_ip/32 trust
    host replication apigee new_standby_ip/32 trust
  4. Yeni Postgres bekleme sunucusunu yükleyin:
    1. Mevcut Edge sürümünüzü yüklemek için kullandığınız yapılandırma dosyasını düzenleyerek aşağıdakileri belirtin:
      # IP address of the current master:
      PG_MASTER=192.168.56.103
      # IP address of the new standby node
      PG_STANDBY=192.168.56.102
    2. SELinux'u Edge Apigee-setup yardımcı programını yükleme bölümünde açıklandığı şekilde devre dışı bırakın.
    3. Yükseltme yaptığınız Edge sürümüne bağlı olarak aşağıdakilerden birini yapın:
      • Edge 4.19.06'dan yükseltme yapıyorsanız Edge bootstrap_4.19.06.sh dosyasını /tmp/bootstrap_4.19.06.sh sürümüne indirin:
        curl https://software.apigee.com/bootstrap_4.19.06.sh -o /tmp/bootstrap_4.19.06.sh

        Ardından, Edge apigee-service yardımcı programını ve bağımlılıklarını yükleyin:

        sudo bash /tmp/bootstrap_4.19.06.sh apigeeuser=uName apigeepassword=pWord

      • Edge 4.50.00'dan yükseltme yapıyorsanız Edge bootstrap_4.50.00.sh dosyasını /tmp/bootstrap_4.50.00.sh konumuna indirin:
        curl https://software.apigee.com/bootstrap_4.50.00.sh -o /tmp/bootstrap_4.50.00.sh

        Ardından, Edge apigee-service yardımcı programını ve bağımlılıklarını yükleyin:

        sudo bash /tmp/bootstrap_4.50.00.sh apigeeuser=uName apigeepassword=pWord

    4. apigee-setup yardımcı programını yüklemek için apigee-service uygulamasını kullanın:
      /opt/apigee/apigee-service/bin/apigee-service apigee-setup install
    5. Postgres'i yükleyin:
      /opt/apigee/apigee-setup/bin/setup.sh -p ps -f configFile
    6. Yeni bekleme düğümünde aşağıdaki komutu çalıştırın:
      /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql postgres-check-standby

      Bekleme olduğunu söylediğini doğrulayın.

Postgres'i yerinde yükseltme

Postgres 10.17'ye yerinde yükseltme yapmak için aşağıdaki adımları uygulayın:

  1. Posterleri ana makinede yükselt
    /opt/apigee/apigee-setup/bin/update.sh -c ps -f /opt/silent.conf
  2. Kurulum komutunu ana ana makinede çalıştırın:
    apigee-service apigee-postgresql setup -f /opt/silent.conf
  3. Ana makinede yapılandır komutunu çalıştırın:
    apigee-service apigee-postgresql configure
  4. Ana makineyi yeniden başlatın:
    apigee-service apigee-postgresql restart
  5. Ana sunucu olarak yapılandırın:
    apigee-service apigee-postgresql setup-replication-on-master -f /opt/silent.conf
  6. Ana makinenin başlattığından emin olun:
    apigee-service apigee-postgresql wait_for_ready
  7. Bekleme modunu durdurun:
    apigee-service apigee-postgresql stop
  8. Bekleme modunu yükseltin.

    Not: Bu adım hatalıysa/başarısız olursa yoksayılabilir. update.sh, yedek sunucusunu yanlış bir yapılandırmayla başlatmayı deneyecektir. Postgres yüklemesi 10.17'ye yükseltildiğinde hata yoksayılabilir.

    /opt/apigee/apigee-setup/bin/update.sh -c ps -f /opt/silent.conf
  9. Bekleme modunun durduğundan emin olun:
    apigee-service apigee-postgresql stop
  10. Eski bekleme yapılandırmasını kaldırın:
    rm -rf /opt/apigee/data/apigee-postgresql/
  11. Bekleme sunucusunda çoğaltma ayarlayın:
    apigee-service apigee-postgresql setup-replication-on-standby -f /opt/silent.conf

Bu prosedürü tamamladıktan sonra, bekleme modu başarıyla başlar.

Postgres düğümünü geçersiz kılma

Güncelleme tamamlandıktan sonra yeni bekleme düğümünü devre dışı bırakın:

  1. Postgres'in çalıştığından emin olun:
    /opt/apigee/apigee-service/bin/apigee-all status

    Postgres çalışmıyorsa başlatın:

    /opt/apigee/apigee-service/bin/apigee-all start

  2. Yeni bekleme düğümünde aşağıdaki curl komutunu çalıştırarak yeni bekleme düğümünün UUID'sini alın:
    curl -u sysAdminEmail:password http://node_IP:8084/v1/servers/self

    Düğümün UUID'sini çıkışın sonunda şu biçimde görürsünüz:

    "type" : [ "postgres-server" ],
    "uUID" : "599e8ebf-5d69-4ae4-aa71-154970a8ec75"

  3. Yeni bekleme düğümünde aşağıdaki komutu çalıştırarak yeni bekleme düğümünü durdurun:
    /opt/apigee/apigee-service/bin/apigee-all stop
  4. Postgres ana düğümünde, yeni bekleme düğümünü conf_pg_hba_replication.connection öğesinden kaldırmak için /opt/apigee/customer/application/postgresql.properties öğesini düzenleyin:
    conf_pg_hba_replication.connection=host replication apigee existing_standby_ip/32 trust
  5. Postgres ana makinesinde Apigee-postgresql'i yeniden başlatın:
    /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql restart
  6. Ana düğümdeki /opt/apigee/apigee-postgresql/conf/pg_hba.conf dosyasını görüntüleyerek yeni bekleme düğümünün kaldırıldığını doğrulayın. Dosyada yalnızca şu satırı görürsünüz:
    host replication apigee existing_standby_ip/32 trust
  7. Yönetim Sunucusu düğümünde aşağıdaki Edge Management API çağrısını yaparak bekleme düğümünün UUID'sini ZooKeeper'dan silin:
    curl -u sysAdminEmail:password -X DELETE http://ms_IP:8080/v1/servers/new_standby_uuid

Ö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üğümleri tamamen yedeklemenizi öneririz. Yedekleme işlemini gerçekleştirmek için Edge'in mevcut sürümüne ilişkin prosedürü kullanın.

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

  • Edge'nin çalıştığından emin olma
    Güncelleme işlemi sırasında Edge'in çalışır durumda olduğundan emin olmak için şu komutu kullanın:
    /opt/apigee/apigee-service/bin/apigee-all status

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ükleme

İlk yüklemeyi tamamladıktan sonra Apigee, Private Cloud için Apigee Edge 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ğ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 başlıklı makaleye bakın.

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

Edge kullanıcı arayüzü bileşenini güncellemek istiyorsanız yükseltme yaptığınız Private Cloud için Edge sürümünü dikkate alın:

  • 4.19.06 veya 4.50.00 sürümünden 4.51.00 sürümüne (yeni Edge kullanıcı arayüzü önceden yüklenmiş olarak): edge-management-ui bileşeni için bu bölümdeki yükseltme talimatlarını uygulayın.

Apigee mTLS ile güncelleme

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

Güncelleme geri alınıyor

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

Hata, güncellemeyi önceki sürüme geri çekmenizi gerektiriyorsa ayrıntılı talimatlar için 4.51.00 sürümüne geri dönme başlıklı makaleye bakın.

Günlük kaydı güncelleme bilgileri

Varsayılan olarak update.sh yardımcı programı günlük bilgilerini şu adrese yazar:

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

update.sh yardımcı programını çalıştıran kişinin bu dizine erişimi yoksa günlüğü /tmp dizinine update_username.log adlı bir dosya olarak yazar.

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

Kapalı kalma süresi güncellemesi

Kapalı kalma süresi olmayan güncelleme veya periyodik güncelleme, Edge'i indirmeden Edge yüklemenizi güncellemenize olanak tanır.

Kapalı kalma süresini güncelleme işlemi yalnızca 5 düğümlü veya daha büyük yapılandırmalarda yapılabilir.

Kapalı kalma süresi olmayan yükseltmenin anahtarı, her bir yönlendiriciyi yük dengeleyiciden tek tek kaldırmaktır. Ardından, Yönlendirici'yi ve Yönlendirici ile aynı makinede bulunan diğer bileşenleri güncelleyip Yönlendirici'yi tekrar yük dengeleyiciye ekleyebilirsiniz.

  1. Makine güncelleme sırası bölümünde anlatıldığı şekilde, makineleri yükleme sırasında doğru şekilde güncelleyin.
  2. Yönlendiricileri güncelleme zamanı geldiğinde, herhangi bir Yönlendiriciyi seçin ve Sunucu (İleti İşleyici/Yönlendirici) erişilebilirliğini Etkinleştirme/Devre Dışı Bırakma bölümünde açıklandığı gibi erişilemez hale getirin.
  3. Seçili 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 yapın.
  5. Kalan Yönlendiriciler için 2-4 arasındaki adımları tekrarlayın.
  6. Yüklemenizde kalan makineler için güncelleme işlemine devam edin.

Güncelleme öncesinde ve sonrasında aşağıdakilere dikkat edin:

Sessiz bir yapılandırma dosyası kullanma

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

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

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

  1. Mevcut olduğunda, güncelleme tamamlanana kadar Cassandra'da onarım işlemi gerçekleştirmek için yapılandırılmış 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 uygulamalarını 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 aşağıdaki komutu çalıştırı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ı çalıştırın:
    yum update rh-amazon-rhui-client.noarch
    sudo yum-config-manager --enable rhui-REGION-rhel-server-extras rhui-REGION-rhel-server-optional
  7. Edge 4.51.00 bootstrap_4.51.00.sh dosyasını /tmp/bootstrap_4.51.00.sh hedefine indirin:
    curl https://software.apigee.com/bootstrap_4.51.00.sh -o /tmp/bootstrap_4.51.00.sh
  8. Şu komutu çalıştırarak Edge 4.51.00 apigee-service yardımcı programını ve bağımlılıklarını yükleyin:
    sudo bash /tmp/bootstrap_4.51.00.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 cihazınızda Java 1.8'in yüklü olup olmadığını kontrol eder. Yüklemezseniz yükleyici, programı 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 (varsayılan) sürümünü yükleyin.
    • C: Java'yı yüklemeden devam edin.
    • Q: Çık. Bu seçenek için Java'yı kendiniz yüklemeniz gerekir.
  9. Aşağıdaki örnekte gösterildiği gibi, apigee-setup yardımcı programını güncellemek için apigee-service öğesini kullanın:
    /opt/apigee/apigee-service/bin/apigee-service apigee-setup update
  10. 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
  11. 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
  12. Aşağıdaki komutu çalıştırarak update yardımcı programını düğümlerinizde çalıştırın:
    /opt/apigee/apigee-setup/bin/update.sh -c component -f configFile

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

    Burada:

    • component, güncellenecek Edge bileşenidir. Olası değerler ş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.19.06 veya 4.50.00 yüklemesi sırasında Edge bileşenlerinizi tanımlamak için kullandığınız yapılandırma dosyasıdır.

    component ayarını "tümü" yaparak update.sh aracını tüm bileşenlerde çalıştırabilirsiniz (yalnızca Edge hepsi bir arada (AIO) yükleme profiliniz varsa). Örneğin:

    /opt/apigee/apigee-setup/bin/update.sh -c all -f ./sa_silent_config
  13. 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
  14. 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.51.00 sürümünde eski sürüme dönme bölümünde açıklanan prosedürü uygulayın.

Yerel bir depodan 4.51.00 sürümüne güncelleme

Edge düğümlerinizin internet üzerinden güvenlik duvarı arkasında olması veya başka bir şekilde Apigee deposuna internet üzerinden erişmesi yasaklanıyorsa güncelleme işlemini Apigee deposunun yerel deposundan ya da 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 .tar dosyasını oluşturun, .tar dosyasını bir düğüme kopyalayın, ardından .tar dosyasından Edge'i güncelleyin.
  • Diğer düğümlerin erişebilmesi için yerel deponun bulunduğu düğüme bir web sunucusu yükleyin. Apigee, kullanmanız için NGINX web sunucusunu sağlar. Dilerseniz kendi web sunucunuzu de kullanabilirsiniz.

Yerel bir 4.51.00 deposundan güncelleme yapmak için:

  1. Edge Apigee-setup yardımcı programını yükleme bölümündeki "Yerel Apigee deposu oluşturma" bölümünde açıklandığı gibi yerel bir 4.51.00 deposu oluşturun.
  2. .tar dosyasından Apigee-service'i yüklemek için:
    1. Yerel deponun bulunduğu düğümde, yerel depoyu /opt/apigee/data/apigee-mirror/apigee-4.51.00.tar.gz adlı tek bir .tar dosyası olarak 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, bunu yeni düğümdeki /tmp dizinine kopyalayın.
    3. Yeni düğümde, dosyanın tarlasını kaldırarak /tmp dizinini kaldırın:
      tar -xzf apigee-4.51.00.tar.gz

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

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

      Depo dizininin yolunu bu komuta eklediğinize dikkat edin.

  3. NGINX web sunucusunu kullanarak Apigee-service yüklemek için:
    1. NGINX web sunucusunu, Install the Edge küme-setup yardımcı programı bölümündeki "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.51.00.sh dosyasını /tmp/bootstrap_4.51.00.sh hedefine indirin:
      /usr/bin/curl http://uName:pWord@remoteRepo:3939/bootstrap_4.51.00.sh -o /tmp/bootstrap_4.51.00.sh

      Burada uName:pWord, daha önce depo için belirlediğiniz kullanıcı adı ve şifre, 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.51.00.sh apigeerepohost=remoteRepo:3939 apigeeuser=uName apigeepassword=pWord apigeeprotocol=http://

      Burada uName:pWord, depo 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 öğesini kullanın:
    /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. update yardımcı programını düğümlerinizde Makine güncelleme sırası bölümünde açıklanan sırada ç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, 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.19.06 veya 4.50.00 yüklemesi sırasında Edge bileşenlerinizi tanımlamak için kullandığınız yapılandırma dosyasıdır.

    component ayarını "tümü" yaparak update.sh aracını tüm bileşenlerde çalıştırabilirsiniz (yalnızca Edge hepsi bir arada (AIO) yükleme profiliniz varsa). Örneğin:

    /opt/apigee/apigee-setup/bin/update.sh -c all -f /tmp/sa_silent_config
  8. Henüz yapmadıysanız çalışan tüm düğümlerde kullanıcı arayüzü bileşenlerini 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.51.00 sürümünde eski sürüme dönme bölümünde açıklanan prosedürü uygulayın.

Makine güncellemesi sırası

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

  • Diğer düğümleri güncellemeden önce tüm Cassandra ve ZooKeeper düğümlerini güncellemeniz gerekir.
  • Birden fazla Uç bileşeni olan tüm makinelerde (Yönetim Sunucusu, Mesaj İşlemci, Yönlendirici, QPID Sunucusu ancak Postgres Sunucusu hariç) tümünü aynı anda güncellemek için -c edge seçeneğini kullanın.
  • Bir adımın birden fazla makinede gerçekleştirilmesi gerektiğini belirtiyorsa adımı belirtilen makine sırasında 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 yapılandırmayı 4.51.00 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 topolojileri ve düğüm numaraları listesi için Yükleme topolojileri başlıklı makaleye 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 Qpid ve Postgres'i güncelleyin:
    /opt/apigee/apigee-setup/bin/update.sh -c qpid,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. makinede Edge bileşenlerini güncelleyin:
    /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
  5. 1. makinede kullanıcı arayüzünü güncelleyin:
    /opt/apigee/apigee-setup/bin/update.sh -c ui -f configFile
  6. (apigee-adminapi yüklediyseniz) 1. makinede apigee-adminapi yardımcı programını güncelledi:
    /opt/apigee/apigee-service/bin/apigee-service apigee-adminapi update
  7. (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.

  8. 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ü yükleme için aşağıdaki bileşenleri güncelleyin:

Edge topolojileri ve düğüm numaraları listesi için Yükleme topolojileri başlıklı makaleye bakın.

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

9 düğümlü kümelenmiş yükseltme

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

Edge topolojileri ve düğüm numaraları listesi için Yükleme topolojileri başlıklı makaleye bakın.

  1. Cassandra ve ZooKeeper'ı 1., 2. ve 3. makinede güncelleyin:
    /opt/apigee/apigee-setup/bin/update.sh -c cs,zk -f configFile
  2. 6 ve 7. makinelerde Qpid'yi güncelleyin:
    /opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
  3. Makine 8'de Postgres'i güncelleyin:
    /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
  4. Makine 9'da Postgres'i güncelleyin:
    /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
  5. 1. makinede LDAP'yi güncelleyin:
    /opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile
  6. Makine 6, 7, 8, 9, 1, 4 ve 5'teki Edge bileşenlerini sırasıyla güncelleyin:
    /opt/apigee/apigee-setup/bin/update.sh -c edge -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 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 makine 1'de 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 edge-management-ui bileşenini yeniden başlatın (1. makine olmayabilir):
      /opt/apigee/apigee-service/bin/apigee-service edge-management-ui restart

13 düğümlü kümelenmiş yükseltme

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

Edge topolojileri ve düğüm numaraları listesi için Yükleme topolojileri başlıklı makaleye bakın.

  1. 1., 2. ve 3. makinelerde Cassandra ve ZooKeeper'ı güncelleyin:
    /opt/apigee/apigee-setup/bin/update.sh -c cs,zk -f configFile
  2. 12 ve 13. makinelerde Qpid'yi güncelleyin:
    /opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
  3. Makine 8'de Postgres'i güncelleyin:
    /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
  4. Makine 9'da Postgres'i güncelleyin:
    /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
  5. Makine 4 ve 5'te LDAP'yi güncelleyin:
    /opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile
  6. 12, 13, 8, 9, 6, 7, 10 ve 11 numaralı makinelerde Edge bileşenlerini bu sırayla güncelleyin:
    /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
  7. 6 ve 7. 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 uygulamasını 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 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 6 ve 7 numaralı makinelerde edge-ui bileşenini aşağıdaki örnekte gösterildiği gibi 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ümelenmiş yükseltme

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

Edge topolojileri ve düğüm numaraları listesi için Yükleme topolojileri başlıklı makaleye bakın.

  1. Cassandra ve ZooKeeper'ı güncelleyin:
    1. Veri Merkezi 1'deki 1., 2. ve 3. makinelerde:
      /opt/apigee/apigee-setup/bin/update.sh -c cs,zk -f configFile
    2. 2. Veri Merkezi'ndeki 7, 8 ve 9. makinelerde
      /opt/apigee/apigee-setup/bin/update.sh -c cs,zk -f configFile
  2. qpidd'i güncelleyin:
    1. Veri Merkezi 1'deki makineler 4 ve 5
      1. Makine 4'te qpidd uygulamasını güncelleyin:
        /opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
      2. Makine 5'te qpidd uygulamasını güncelleyin:
        /opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
    2. Veri Merkezi 2'deki makineler 10, 11
      1. Makine 10'da qpidd öğesini güncelleyin:
        /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
  3. Postgres'i güncelleme:
    1. Veri Merkezi 1'deki 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
  4. LDAP'yi güncelleyin:
    1. Veri Merkezi 1'deki 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
  5. Edge bileşenlerini güncelleyin:
    1. Veri Merkezi'ndeki 4, 5, 6, 1, 2, 3 numaralı makineler 1
      /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
    2. Veri Merkezi'ndeki 10, 11, 12, 7, 8, 9 numaralı makineler 2
      /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
  6. Yeni kullanıcı arayüzünü (ue) veya klasik kullanıcı arayüzünü (ui) güncelleyin:
    1. Veri Merkezi 1'de Makine 1:
      /opt/apigee/apigee-setup/bin/update.sh -c [ui|ue] -f configFile
    2. Veri Merkezi 2'de 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'de Makine 1:
      /opt/apigee/apigee-service/bin/apigee-service apigee-adminapi update
    2. Veri Merkezi 2'de 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'de Makine 1:
      /opt/apigee/apigee-setup/bin/update.sh -c sso -f sso_config_file
    2. Veri Merkezi 2'de 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. 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 bir 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. qpidd, ps
  4. LDAP
  5. Edge, sıradaki tüm düğümlerdeki "-c Edge" profili anlamına gelir: Qpid sunucusu, Edge Postgres Sunucusu, Yönetim Sunucusu, Mesaj İşleyicisi ve Yönlendiricisi olan düğümler.
  6. Edge kullanıcı arayüzü (klasik veya yeni)
  7. apigee-adminapi
  8. 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.