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'den 4.51.00'e nasıl yükseltileceği 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.

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

/opt/apigee/customer/application'da .properties dosyalarını düzenleyerek herhangi bir özellik belirlediyseniz bu değerler güncelleme tarafından korunur.

Postgres 10.17'ye yükseltme gerekli

Edge'in bu sürümünde Postgres 10.17'ye yükseltme yer almaktadır. Bu yükseltme kapsamında, tüm Postgres verileri Postgres 10.17'ye taşınır.

Çoğu Edge üretim sistemi, ana-bekleme ç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 için kapalıyken analiz verileri Qpid düğümlerine yazılmaya devam eder. Postgres düğümleri güncellenip tekrar çevrimiçi olduktan sonra analiz verileri Postgres düğümlerine gönderilir.

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 Yükseltme tamamlandıktan sonra yeni Postgres yedek düğümünü devre dışı bırakabilirsiniz.

    Herhangi bir nedenle güncellemeyi geri almanız gerekirse ek Postgres yedek düğümü gereklidir. Güncellemeyi geri almanız gerekirse yeni Postgres yedek düğümü, geri alma işleminden sonra ana Postgres düğümü olur. Bu nedenle, yeni Postgres yedek düğümünü yüklerken, Edge Yükleme şartları bölümünde tanımlandığı gibi, Postgres sunucusunun tüm donanım şartlarını karşılayan bir düğümde olmalıdır.

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

  • Apigee tarafından önerilen ş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 yedek düğümü yüklemeyi ve daha sonra devre dışı bırakmayı 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 yedek Postgres sunucusu oluşturur. 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 yedek sunucusu yüklediğinizden emin olun.

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

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

  1. Mevcut Postgres ana makinesinde, 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 makinesinde apigee-postgresql'ü yeniden başlatın: 
    /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql restart
  3. Ana makinedeki /opt/apigee/apigee-postgresql/conf/pg_hba.conf dosyasını görüntüleyerek yeni yedek düğümün eklendiğini doğrulayın. Bu dosyada şu satırları göreceksiniz: 
    host replication apigee existing_standby_ip/32 trust
host replication apigee new_standby_ip/32 trust
  4. Yeni Postgres yedek 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. Edge apigee-setup yardımcı programını yükleme bölümünde açıklandığı şekilde SELinux'u devre dışı bırakın.
    3. Geçiş yaptığınız Edge sürümüne bağlı olarak aşağıdakilerden birini yapın:
      • Edge 4.19.06'tan yükseltme yapıyorsanız Edge bootstrap_4.19.06.sh dosyasını /tmp/bootstrap_4.19.06.sh 'ye 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'den yükseltme yapıyorsanız Edge bootstrap_4.50.00.sh dosyasını /tmp/bootstrap_4.50.00.sh 'ye 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'ü 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 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 için 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 ana makinede kurulum komutunu çalıştırın: 
    apigee-service apigee-postgresql setup -f /opt/silent.conf
  3. Ana ana makinede configure 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 durdurun: 
    apigee-service apigee-postgresql stop
  8. Bekleme modunu yükseltin.

    Not: Bu adımda hata oluşursa/başarısız olursa bu adım yoksayılabilir. update.sh, bekleme sunucusu Postgres kurulumu 10.17'ye yükseltildiği takdirde 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 çoğaltmayı ayarlayın: 
    apigee-service apigee-postgresql setup-replication-on-standby -f /opt/silent.conf

Bu prosedür tamamlandı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 yedek düğümün hizmetini sonlandı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 yedek düğümü conf_pg_hba_replication.connection'dan 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 makinesinde apigee-postgresql'i yeniden başlatın: 
    /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql restart
  6. Ana makinedeki /opt/apigee/apigee-postgresql/conf/pg_hba.conf dosyasını görüntüleyerek yeni yedek düğümün kaldırıldığını doğrulayın. Bu dosyada yalnızca şu satırı göreceksiniz: 
    host replication apigee existing_standby_ip/32 trust
  7. Yönetim sunucusu düğümünde aşağıdaki Edge yönetim API çağrısını yaparak yedek düğümün UUID'sini ZooKeeper'dan silin: 
    curl -u sysAdminEmail:password -X DELETE http://ms_IP:8080/v1/servers/new_standby_uuid

Önkoşulları güncelleme

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

  • 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.

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

  • Edge'in çalıştığından emin olun
    Aşağıdaki komutu kullanarak güncelleme işlemi sırasında Edge'in çalışır durumda olduğundan emin olun: 
    /opt/apigee/apigee-service/bin/apigee-all status

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.51.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.19.06 veya 4.50.00'ı yüklemek için kullandığınız dosyayla 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ü 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. Edge 4.51.00 bootstrap_4.51.00.sh dosyasını şuraya indirin: /tmp/bootstrap_4.51.00.sh: 
    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

    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.
  9. 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
  10. Yönetim sunucusunda apigee-validate yardımcı programını aşağıdaki örnekte gösterildiği gibi güncelleyin: 
    /opt/apigee/apigee-service/bin/apigee-service apigee-validate update
  11. 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
  12. 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.19.06 veya 4.50.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 ./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 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.51.00 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.51.00 deposu oluşturun.
  2. apigee-service'i .tar dosyasından yüklemek için:
    1. Yerel deponun bulunduğu düğümde, yerel deposu /opt/apigee/data/apigee-mirror/apigee-4.51.00.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 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'ten yükleyin: 
      sudo bash /tmp/repos/bootstrap_4.51.00.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 repodan 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'e 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 belirlediğiniz kullanıcı adı ve şifredir, remoteRepo ise depo düğümünün IP adresi veya DNS adıdır.

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

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

  4. Aşağıdaki örnekte gösterildiği gibi, apigee-setup yardımcı programını güncellemek için apigee-service'ü kullanın: 
    /opt/apigee/apigee-service/bin/apigee-service apigee-setup update
  5. Yönetim sunucusunda apigee-validate yardımcı programını aşağıdaki örnekte gösterildiği gibi güncelleyin: 
    /opt/apigee/apigee-service/bin/apigee-service apigee-validate update
  6. Yönetim sunucusunda apigee-provision yardımcı programını aşağıdaki örnekte gösterildiği gibi güncelleyin: 
    /opt/apigee/apigee-service/bin/apigee-service apigee-provision update
  7. update yardımcı programını, 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.19.06 veya 4.50.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.51.00 sürümünü geri alma başlıklı makalede 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.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'u 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 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. makinedeki Edge bileşenlerini güncelleyin: 
    /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
  5. 1. makinedeki 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ı 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

    Burada 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üğü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 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üncelleme: 
    /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üncelleme: 
    /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
  6. 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
  7. (apigee-adminapi'ı yüklediyseniz) 1. makinede 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

    Burada 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. makinedeki 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 (makine 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. 6 ve 7 numaralı makinelerde Qpid'i güncelleyin: 
    /opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
  3. 8 numaralı 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 uç 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'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 SSO'yu yüklediyseniz) 1. makinede Apigee SSO'yu 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. makinedeki 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 (makine 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. 12 ve 13 numaralı makinelerde Qpid'i güncelleyin: 
    /opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
  3. 8 numaralı 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. makinede 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ı makinelerdeki apigee-adminapi yardımcı programını güncelledi: 
    /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. qpidd'yi güncelleyin:
    1. 1. Veri Merkezi'ndeki 4 ve 5 numaralı makineler
      1. 4. makinede qpidd öğesini güncelleme: 
        /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. 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
  3. Postgres'i güncelleyin:
    1. 1. Veri Merkezi'ndeki 6. Makine 
      /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
    2. 2. Veri Merkezi'ndeki 12 numaralı makine 
      /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
  4. 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
  5. 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
  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 numaralı 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. qpidd, 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. 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.