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'dan 4.51.00'a nasıl yükseltme yapılacağı açıklanmaktadır.

Güncellemeyi kimler yapabilir?

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

Edge RPM'lerini yükledikten sonra herkes bunları 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 bir kurulumu desteklemez.

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

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

Postgres 10.17'ye zorunlu yükseltme

Edge'in bu sürümü, Postgres 10.17'ye 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-yedek replikasyon için yapılandırılmış iki Postgres düğümü kullanır. Güncelleme işlemi sırasında Postgres düğümleri güncelleme için devre dışı bırakılırken analiz verileri Qpid düğümlerine yazılmaya devam eder. Postgres düğümleri güncellenip tekrar çevrimiçi olduktan sonra analiz verileri Postgres düğümlerine aktarılır.

Postgres güncellemesini gerçekleştirme şekliniz, Postgres düğümleriniz için veri depolamayı 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üresi boyunca yeni bir Postgres yedek düğümü yüklemeniz gerekir. Yükseltme tamamlandıktan sonra yeni Postgres bekleme düğümünü kullanımdan kaldırabilirsiniz.

    Güncellemeyi herhangi bir nedenle geri almanız gerekirse ek Postgres bekleme düğümü gerekir. Güncellemeyi geri almanız gerekirse yeni Postgres bekleme düğümü, geri alma işleminden sonra ana Postgres düğümü olur. Bu nedenle, yeni Postgres yedek düğümünü yüklediğinizde, Edge Yükleme gereksinimleri bölümünde tanımlandığı şekilde bir Postgres sunucusunun tüm donanım gereksinimlerini karşılayan bir düğümde olması gerekir.

    Edge'in 1 düğümlü 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 olur. Yeni bir Postgres düğümü oluşturmak zorunda kalmadan bu Postgres düğümlerini doğrudan güncelleyebilirsiniz.

  • Apigee tarafından önerildiği şekilde 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ün yüklenmesini ve daha sonra kullanımdan kaldırılmasını 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 yapmanız gerekirse Postgres düğümünü bu anlık görüntüden geri yükleyebilirsiniz.

Yeni bir Postgres yedek düğümü yükleme

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

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

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

  1. Mevcut Postgres ana sunucusunda, aşağıdaki jetonu ayarlamak için /opt/apigee/customer/application/postgresql.properties dosyasını düzenleyin. Bu 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 yedek sunucusunun IP adresi, new_standby_ip ise yeni yedek düğümün IP adresidir.

  2. Postgres ana sunucusunda apigee-postgresql hizmetini 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. Bu dosyada aşağıdaki satırları görmeniz gerekir: 
    host replication apigee existing_standby_ip/32 trust
host replication apigee new_standby_ip/32 trust
  4. Yeni Postgres yedek sunucusunu yükleyin:
    1. Edge'in mevcut sürümünü 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. Edge apigee-setup yardımcı programını yükleme bölümünde açıklandığı şekilde SELinux'u 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 dizinine 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 dizinine 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 komutunu kullanın: 
      /opt/apigee/apigee-service/bin/apigee-service apigee-setup install
    5. Postgres'i yükleme: 
      /opt/apigee/apigee-setup/bin/setup.sh -p ps -f configFile
    6. Yeni yedek düğümde aşağıdaki komutu çalıştırın: 
      /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql postgres-check-standby

      Bekleme modunda olduğunu doğrulayın.

Postgres'te yerinde yükseltme yapma

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

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

    Not: Bu adımda hata oluşursa veya adım başarısız olursa bu durum yoksayılabilir. update.sh, bekleme sunucusunu yanlış bir yapılandırmayla başlatmaya çalışır. Postgres kurulumu 10.17'ye yükseltildiyse hata yoksayılabilir.

    /opt/apigee/apigee-setup/bin/update.sh -c ps -f /opt/silent.conf
  9. Bekleme modunun durdurulduğ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. Yedek sunucuda replikasyonu 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şlatılır.

Postgres düğümünü kullanımdan kaldırma

Güncelleme tamamlandıktan sonra yeni bekleme düğümünü kullanımdan kaldırı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 yedek düğümde aşağıdaki curl komutunu çalıştırarak yeni yedek düğümün UUID'sini alın: 
    curl -u sysAdminEmail:password http://node_IP:8084/v1/servers/self

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

    "type" : [ "postgres-server" ],
"uUID" : "599e8ebf-5d69-4ae4-aa71-154970a8ec75"
  3. Yeni yedek düğümde aşağıdaki komutu çalıştırarak yeni yedek düğümü 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 parametresinden kaldırmak için /opt/apigee/customer/application/postgresql.properties dosyasını düzenleyin: 
    conf_pg_hba_replication.connection=host replication apigee existing_standby_ip/32 trust
  5. Postgres ana sunucusunda apigee-postgresql'yi 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. Bu dosyada yalnızca aşağıdaki satırı görmeniz gerekir: 
    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

Güncelleme ön koşulları

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

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

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

  • Edge'in çalıştığından emin olun
    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 listelenmektedir. Daha fazla bilgi için Private Cloud için yeni Edge kullanıcı arayüzü başlıklı makaleyi inceleyin.

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

İlk yüklemeyi tamamladıktan sonra Apigee, Özel Bulut için Apigee Edge 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ü, Temel kimlik doğrulamasını devre dışı bırakmanızı ve SAML veya LDAP gibi bir IDP kullanmanızı gerektirir.

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 yükseltme yaptığınız Private Cloud için Edge sürümünü göz önünde bulundurun:

Apigee mTLS ile güncelleme

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

Güncellemeyi geri alma

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

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

Güncelleme bilgilerini günlüğe kaydetme

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 kişinin bu dizine erişimi yoksa günlüğü /tmp dizinine update_username.log adlı bir dosya olarak yazar.

Kullanıcının /tmp erişimi yoksa update.sh yardımcı programı başarısız olur.

Sıfır kesinti süreli güncelleme

Sıfır kesinti süreli güncelleme veya periyodik güncelleme, Edge kurulumunuzu Edge'i kapatmadan güncellemenize olanak tanır.

Sıfır kesinti süreli güncelleme yalnızca 5 düğümlü ve daha büyük yapılandırmalarda mümkündür.

Sıfır kesinti süreli yükseltmenin anahtarı, her bir yönlendiriciyi yük dengeleyiciden tek tek kaldırmaktır. Ardından, Router'ı ve Router ile aynı makinedeki diğer bileşenleri günceller ve Router'ı tekrar yük dengeleyiciye eklersiniz.

  1. Makineleri, Makine güncelleme sırası bölümünde açıklandığı şekilde kurulumunuz için doğru sırada güncelleyin.
  2. Yönlendiricileri güncelleme zamanı geldiğinde, Sunucu (Mesaj İşlemcisi/Yönlendirici) erişilebilirliğini etkinleştirme/devre dışı bırakma bölümünde açıklandığı gibi herhangi bir yönlendiriciyi seçin ve 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ı, aynı düğümde bir yönlendirici ve mesaj işlemcisi gösterir.
  4. Yönlendiriciyi tekrar erişilebilir hale getirin.
  5. Kalan yönlendiriciler için 2-4 arasındaki adımları tekrarlayın.
  6. Kurulumunuzdaki diğer 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 bir sessiz 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ız dosya ile 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. Varsa Cassandra'da onarım işlemi gerçekleştirmek üzere yapılandırılmış tüm cron işlerini güncelleme tamamlanana kadar devre dışı bırakın.
  2. Edge RPM'lerini yüklemek için düğümünüze kök olarak giriş yapın.
  3. yum-utils ve yum-plugin-priorities paketlerini yükleyin: 
    sudo yum install yum-utils
sudo yum install yum-plugin-priorities
  4. Edge apigee-setup yardımcı programını yükleme bölümünde açıklandığı şekilde SELinux'u 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 komutları çalıştırın: yum-configure-manager 
    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 dizinine indirin: 
    curl https://software.apigee.com/bootstrap_4.51.00.sh -o /tmp/bootstrap_4.51.00.sh
  8. Aşağıdaki 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

    uName:pWord, Apigee'den aldığınız kullanıcı adı ve şifredir. pWord parametresini atlarsanız bu parametreyi girmeniz istenir.

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

    Java yüklemesinin nasıl işleneceğini belirtmek için JAVA_FIX seçeneğini kullanın. JAVA_FIX şu 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.
  9. apigee-setup yardımcı programını güncellemek için aşağıdaki örnekte gösterildiği gibi apigee-service komutunu kullanın: 
    /opt/apigee/apigee-service/bin/apigee-service apigee-setup update
  10. Yönetim sunucusundaki 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 sunucusundaki 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 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ğerler şunları içerir:
      • cs: Cassandra
      • edge: Edge kullanıcı arayüzü dışındaki tüm Edge bileşenleri: Yönetim Sunucusu, Mesaj İşlemcisi, Yönlendirici, QPID Sunucusu, Postgres Sunucusu
      • ldap: OpenLDAP
      • ps: postgresql
      • qpid: qpidd
      • sso: Apigee SSO (SSO'yu yüklediyseniz)
      • ue: Yeni Edge kullanıcı arayüzü
      • ui: Klasik Edge kullanıcı arayüzü
      • zk: Hayvanat bahçesi görevlisi
    • 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ıyla aynıdır.

    component değerini "all" olarak ayarlayarak update.sh komutunu tüm bileşenler için çalıştırabilirsiniz ancak bu işlem yalnızca Edge hepsi bir arada (AIO) yükleme profiliniz varsa yapılabilir. Ö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 almaya karar verirseniz 4.51.00 sürümünü geri alma bölümünde açıklanan prosedürü uygulayın.

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

Edge düğümleriniz bir güvenlik duvarının arkasındaysa veya başka bir şekilde Apigee deposuna internet üzerinden erişmesi yasaklanmışsa güncellemeyi Apigee deposunun yerel bir deposundan veya yansısı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 ve ardından Edge'i .tar dosyasından güncelleyin.
  • Diğer düğümlerin erişebilmesi için yerel depoya sahip düğüme bir web sunucusu yükleyin. Apigee, kullanmanız için NGINX web sunucusunu sağlar veya kendi web sunucunuzu 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. apigee-service'i bir .tar dosyasından 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ı halinde 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 açın: 
      tar -xzf apigee-4.51.00.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 adresinden yükleyin: 
      sudo bash /tmp/repos/bootstrap_4.51.00.sh apigeeprotocol="file://" apigeerepobasepath=/tmp/repos

      Bu komutta, depolar dizininin yolunu eklediğinize dikkat edin.

  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 sayfasındaki "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 dizinine indirin: 
      /usr/bin/curl http://uName:pWord@remoteRepo:3939/bootstrap_4.51.00.sh -o /tmp/bootstrap_4.51.00.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üğü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://

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

  4. apigee-setup yardımcı programını güncellemek için aşağıdaki örnekte gösterildiği gibi apigee-service komutunu kullanın: 
    /opt/apigee/apigee-service/bin/apigee-service apigee-setup update
  5. Yönetim sunucusundaki 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 sunucusundaki 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, Mesaj İşlemcisi, Yönlendirici, QPID Sunucusu, Postgres Sunucusu
      • ldap: OpenLDAP
      • ps: postgresql
      • qpid: qpidd
      • sso: Apigee SSO (SSO'yu yüklediyseniz)
      • ue Yeni Edge kullanıcı arayüzü
      • ui: Klasik Edge kullanıcı arayüzü
      • zk: Hayvanat bahçesi görevlisi
    • 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ıyla aynıdır.

    component değerini "all" olarak ayarlayarak update.sh komutunu tüm bileşenlerde çalıştırabilirsiniz. Ancak bu işlem yalnızca Edge hepsi bir arada (AIO) yükleme profiliniz varsa yapılabilir. Ö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 bu bileşenleri 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.51.00 sürümünü 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:

  • 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, Mesaj İşlemcisi, Yönlendirici, QPID Sunucusu ancak Postgres Sunucusu değil) içeren makinelerde, tüm bileşenleri aynı anda güncellemek için -c edge seçeneğini kullanın.
  • Bir adımın birden fazla makinede gerçekleştirilmesi 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 yapılandırmayı 4.51.00 sürümüne yükseltmek için:

  1. Tüm bileşenleri güncelleme: 
    /opt/apigee/apigee-setup/bin/update.sh -c all -f configFile
  2. (apigee-adminapi aracı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 bir kurulum için aşağıdaki bileşenleri güncelleyin:

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

  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üncelleme: 
    /opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile
  4. 2 ve 1 numaralı makinelerdeki 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. makinedeki apigee-adminapi yardımcı programı güncellendi: 
    /opt/apigee/apigee-service/bin/apigee-service apigee-adminapi update
  7. (Apigee SSO'yu yüklediyseniz) 1. makinede Apigee SSO'yu güncelleyin: 
    /opt/apigee/apigee-setup/bin/update.sh -c sso -f sso_config_file

    sso_config_file, TOA'yı yüklerken 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üğümlü yükseltme

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

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

  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 Qpid ve Postgres'i güncelleyin: 
    /opt/apigee/apigee-setup/bin/update.sh -c qpid, ps -f configFile
  3. 5. makinede Qpid ve Postgres'i güncelleyin: 
    /opt/apigee/apigee-setup/bin/update.sh -c qpid, ps -f configFile
  4. 1. makinede LDAP'yi güncelleme: 
    /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. 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 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 makinedeki (1. makine olmayabilir) ue bileşenini güncelleyin: 
      /opt/apigee/apigee-setup/bin/update.sh -c ue -f /opt/silent.conf
  7. (apigee-adminapi yüklediyseniz) 1. makinedeki apigee-adminapi yardımcı programı güncellendi: 
    /opt/apigee/apigee-service/bin/apigee-service apigee-adminapi update
  8. (Apigee SSO'yu yüklediyseniz) 1. makinede Apigee SSO'yu güncelleyin: 
    /opt/apigee/apigee-setup/bin/update.sh -c sso -f sso_config_file

    sso_config_file, TOA'yı yüklerken 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 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 (1. makine 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ümelenmiş yükseltme

9 düğümlü kümelenmiş bir 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 başlıklı makaleyi inceleyin.

  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. 6 ve 7 numaralı makinelerde Qpid'yi güncelleyin: 
    /opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
  3. 8. makinede Postgres'i güncelleyin: 
    /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
  4. 9 numaralı makinede Postgres'i güncelleyin: 
    /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
  5. 1. makinede LDAP'yi güncelleme: 
    /opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile
  6. 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
  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. makinedeki apigee-adminapi yardımcı programını güncelleyin: 
    /opt/apigee/apigee-service/bin/apigee-service apigee-adminapi update
  9. (Apigee SSO'yu yüklediyseniz) 1. makinede Apigee SSO'yu güncelleyin: 
    /opt/apigee/apigee-setup/bin/update.sh -c sso -f sso_config_file

    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 (1. makine 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ümelenmiş yükseltme

13 düğümlü kümelenmiş bir 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 başlıklı makaleyi inceleyin.

  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. 12 ve 13 numaralı makinelerde Qpid'yi güncelleyin: 
    /opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
  3. 8. makinede Postgres'i güncelleyin: 
    /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
  4. 9 numaralı makinede Postgres'i güncelleyin: 
    /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
  5. 4 ve 5 numaralı makinelerde 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ı makinelerdeki Edge bileşenlerini şu sırayla güncelleyin: 
    /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
  7. 6 ve 7 numaralı makinelerde 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) 6 ve 7 numaralı makinelerde apigee-adminapi yardımcı programını güncelledik: 
    /opt/apigee/apigee-service/bin/apigee-service apigee-adminapi update
  9. (Apigee SSO'yu yüklediyseniz) 6 ve 7 numaralı makinelerde Apigee SSO'yu güncelleyin: 
    /opt/apigee/apigee-setup/bin/update.sh -c sso -f sso_config_file

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

12 düğümlü kümelenmiş bir 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 başlıklı makaleyi inceleyin.

  1. Cassandra ve ZooKeeper'ı güncelleyin:
    1. Veri Merkezi 1'deki 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. qpidd'yi güncelleyin:
    1. Veri Merkezi 1'deki 4 ve 5 numaralı makineler
      1. 4. makinede qpidd güncellemesi: 
        /opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
      2. 5. makinede qpidd güncellemesi: 
        /opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
    2. Veri Merkezi 2'deki 10 ve 11 numaralı makineler
      1. 10. 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
  3. Postgres'i güncelleme:
    1. Veri Merkezi 1'deki 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
  4. LDAP'yi güncelleme:
    1. Veri Merkezi 1'deki Makine 1 
      /opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile
    2. Veri Merkezi 2'deki 7. makine 
      /opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile
  5. Edge bileşenlerini güncelleme:
    1. Veri Merkezi 1'deki 4, 5, 6, 1, 2, 3 numaralı makineler 
      /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
    2. Veri Merkezi 2'deki 10, 11, 12, 7, 8, 9 numaralı makineler 
      /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. 1. Veri Merkezi'ndeki 1. Makine: 
      /opt/apigee/apigee-setup/bin/update.sh -c [ui|ue] -f configFile
    2. 2. veri merkezindeki 7. makine: 
      /opt/apigee/apigee-setup/bin/update.sh -c [ui|ue] -f configFile
  7. (apigee-adminapi 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 merkezindeki 7. makine: 
      /opt/apigee/apigee-service/bin/apigee-service apigee-adminapi update
  8. (Apigee SSO'yu yüklediyseniz) Apigee SSO'yu 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 merkezindeki 7. makine: 
      /opt/apigee/apigee-setup/bin/update.sh -c sso -f sso_config_file

      3. sso_config_file, TOA'yı yüklerken 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 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, yani tüm düğümlerdeki "-c edge" profili şu sırayla: Qpid sunucusu, Edge Postgres Sunucusu, Yönetim Sunucusu, Mesaj İşlemcisi ve Yönlendirici içeren düğümler.
  6. Edge kullanıcı arayüzü (klasik veya yeni)
  7. apigee-adminapi
  8. Apigee TOA

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