Apigee Edge 4.52.02'yi 4.53.00 sürümüne güncelleme

Apigee, Edge for Private Cloud'ı doğrudan 4.52.02 sürümünden 4.53.00 sürümüne yükseltmeyi destekler. Bu sayfada, bu tür yükseltmelerin nasıl yapılacağı açıklanmaktadır.

Uyumlu yükseltme yollarına genel bakış için Edge for Private Cloud sürümleri için yükseltme uyumluluk matrisini inceleyin.

Güncellemeyi kimler yapabilir?

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

Edge RPM'lerini yükledikten sonra herkes bu RPM'leri yapılandırabilir.

Hangi bileşenleri güncellemeniz gerekir?

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

Önkoşulları güncelleme

Apigee Edge'i yükseltmeden önce aşağıdaki ön koşullardan emin olun:

  • Tüm düğümleri yedekleme
    Güncellemeden önce, güvenlik nedeniyle tüm düğümlerin tam yedeğini almanızı öneririz. Yedekleme işlemini gerçekleştirmek için Edge'in mevcut sürümünüze yönelik prosedürü kullanın.

    Bu sayede, yeni sürüme yapılan güncelleme düzgün çalış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
  • Cassandra ön koşullarını doğrulama
    Daha önce Private Cloud için Edge'in eski bir sürümünden 4.52.02 sürümüne yükselttiyseniz ve şimdi 4.53.00 sürümüne yükseltmeyi planlıyorsanız Cassandra için gerekli yükseltme sonrası adımları tamamladığınızdan emin olun. Bu adımlar, 4.52.02 sürümüne yükseltme dokümanının Yükseltme sonrası adımlar bölümünde açıklanmıştır. Bu adımların önceki yükseltme sırasında tamamlanıp tamamlanmadığından emin değilseniz 4.53.00 sürümüne yükseltme işlemine devam etmeden önce bu adımları tekrar tamamlayın.
  • Python gereksinimleri
    Yükseltme işlemine başlamadan önce Cassandra düğümleri dahil tüm düğümlere Python 3'ün yüklendiğinden emin olun.

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

/opt/apigee/customer/application'daki .properties dosyalarını düzenleyerek herhangi bir özellik belirlediyseniz bu değerler güncelleme sırasında korunur.

Cassandra 4.0.13'e yükseltme gerekli

Private Cloud için Apigee Edge 4.53.00, Cassandra'yı 4.0.13 sürümüne yükseltir.

Yükseltmeler ve geri alma

  • Cassandra 3.11.X'ten Cassandra 4.0.X'e geçiş sorunsuz bir işlemdir. Private Cloud için Edge 4.53.00 ile birlikte yayınlanan Cassandra 4.0.X, Private Cloud 4.52.02'nin çalışma zamanı ve yönetim bileşenleriyle uyumludur.
  • Cassandra 4.0.X sürümünden 3.11.X sürümüne doğrudan yerinde geri alma işlemi yapılamaz. Kopyaları veya yedekleri kullanarak geri alma işlemi karmaşık bir işlemdir ve çalışmama süresi ve/veya veri kaybına neden olabilir. Sorun giderme ve Cassandra 4.0.X'e yükseltme, geri alma işlemine tercih edilir.
  • Yükseltme işlemine başlamadan önce geri alma prosedürlerini öğrenmeniz önemlidir. Uygun geri alma yollarının kullanılabilmesi için yükseltme sırasında geri alma işleminin ayrıntılarını dikkate almak çok önemlidir.

Tek veri merkezi

Cassandra'yı tek bir veri merkezinde 3.11.X sürümünden 4.0.X sürümüne yükseltmek sorunsuzdur ancak geri alma işlemi karmaşıktır ve çalışma süresinin kesintiye uğramasına ve veri kaybına neden olabilir. Üretim iş yükleri için yükseltme işlemini başlatmadan önce yeni veri merkezinde en az bir Cassandra düğümü bulunan yeni bir veri merkezi eklemeniz önemle tavsiye edilir. Bu sayede, veri kaybı veya API trafiğinizin kesintiye uğraması olmadan Cassandra'yı geri alabilirsiniz. Yükseltme işlemi tamamlandıktan veya 2. Kontrol Noktası'na ulaşıldıktan sonra bu ek veri merkezi kullanımdan kaldırılabilir.

Yeni bir veri merkezi eklemek mümkün değilse ancak geri alma özelliğinin kullanılması isteniyorsa Cassandra 3.11.X'i geri yüklemek için yedekler gereklidir. Ancak bu yöntem, hem çalışmama süresi hem de veri kaybına neden olabilir.

Birden fazla veri merkezi

Edge for Private Cloud 4.52.02 ile birden fazla veri merkezi çalıştırmak, Edge for Private Cloud 4.53.00'a yükseltme sırasında geri alma işlemleri için daha fazla esneklik sunar.

  • Geri alma işlemleri, eski Cassandra sürümünü (3.11.X) çalıştıran en az bir veri merkezinin bulunmasına bağlıdır.
  • Cassandra kümenizin tamamı 4.0.X sürümüne yükseltildiyse Cassandra 3.11.X sürümüne geri dönmemeniz gerekir. Özel Bulut 4.53.00 veya 4.52.02'nin diğer bileşenleriyle birlikte daha yeni Cassandra sürümünü kullanmaya devam etmeniz gerekir.
  1. Tek seferde bir Cassandra veri merkezini yükseltin: Tek bir veri merkezinde Cassandra düğümlerini tek tek yükselterek başlayın. Bir sonraki veri merkezine geçmeden önce bir veri merkezindeki tüm Cassandra düğümlerinin yükseltme işlemini tamamlayın.
  2. Duraklatıp doğrulama: Bir veri merkezini yükselttikten sonra, Özel Bulut kümenizin (özellikle de yükseltilen veri merkezinin) düzgün çalıştığından emin olmak için duraklatın.
  3. Hatırlatma: Yalnızca hâlâ eski sürümü çalıştıran en az bir veri merkeziniz varsa önceki Cassandra sürümüne geri dönebilirsiniz.
  4. Zamana duyarlı: İşlevleri doğrulamak için kısa bir süre duraklatabilirsiniz (birkaç saat önerilir) ancak süresiz olarak karma sürüm durumunda kalamazsınız. Bunun nedeni, tek tip olmayan bir Cassandra kümesinin (farklı sürümlerde düğümlere sahip) işlevsel sınırlamaları olmasıdır.
  5. Kapsamlı test: Apigee, bir sonraki veri merkezini yükseltmeden önce performans ve işlevselliğin kapsamlı bir şekilde test edilmesini önemle tavsiye eder. Tüm veri merkezleri yükseltildikten sonra önceki sürüme geri dönmek mümkün değildir.
İki kontrol noktası işlemi olarak geri alma
  1. 1. Kontrol noktası: Tüm bileşenlerin 4.52.02 sürümünde olduğu ilk durum. En az bir Cassandra veri merkezi eski sürümde kaldığı sürece tam geri alma işlemi yapılabilir.
  2. 2. kontrol noktası: Tüm veri merkezlerindeki tüm Cassandra düğümleri güncellendikten sonra. Bu duruma geri dönebilirsiniz ancak 1. Kontrol Noktası'na geri dönemezsiniz.
Örnek

İki veri merkezi (DC) kümesini ele alalım:

  1. Başlangıç durumu: Her iki DC'deki Cassandra düğümleri 3.11.X sürümündedir. Diğer tüm düğümler, Private Cloud için Edge 4.52.02 sürümündedir. Her DC için üç Cassandra düğümü olduğunu varsayalım.
  2. DC-1'i yükseltin: DC-1'deki üç Cassandra düğümünü tek tek yükseltin.
  3. Duraklatıp doğrulayın: Özellikle DC-1'in doğru şekilde çalıştığından emin olmak için duraklatın (performansı ve işlevselliği kontrol edin). DC-2'deki Cassandra düğümlerini kullanarak ilk duruma geri dönebilirsiniz. Karma sürümlü Cassandra kümesinin sınırlamaları nedeniyle bu duraklatmanın geçici olması gerektiğini unutmayın.
  4. DC-2'yi yükseltin: DC-2'deki kalan üç Cassandra düğümünü yükseltin. Bu, yeni geri alma kontrol noktanız olur.
  5. Diğer bileşenleri yükseltin: Yönetim, çalışma zamanı ve analiz düğümlerini tüm veri merkezlerinde her zamanki gibi birer düğüm ve birer veri merkezi olacak şekilde yükseltin. Sorun oluşursa 4. adımdaki duruma geri dönebilirsiniz.

Cassandra yükseltmeyle ilgili ön koşullar

Private Cloud için Edge 4.52.02 ile Cassandra 3.11.16'yı çalıştırmanız ve aşağıdakilerden emin olmanız gerekir:
  • Kümenin tamamı çalışır durumda ve Cassandra 3.11.16 ile tam işlevseldir.
  • Sıkıştırma stratejisi LeveledCompactionStrategy olarak ayarlanmıştır (4.52.02 sürümüne yükseltme için ön koşuldur).
  • 4.52.02 yükseltmesinin bir parçası olarak ilk yükseltmeden Cassandra 3.11.16'ya geçişin tüm yükseltme sonrası adımları tamamlandı. Düzelmediyse bu adımları tekrarlayın. Bu durum yalnızca eski bir sürümden Private Cloud 4.52.02 sürümüne yükselttiyseniz geçerlidir.

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

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

  1. Apigee'yi kullanarak Cassandra'yı yedekleme.
  2. Mümkünse Cassandra düğümlerinin sanal makine anlık görüntülerini alın.
  3. Yönetim sunucusu, mesaj işleyici, yönlendirici, Qpid ve Postgres dahil olmak üzere tüm Edge for Private Cloud bileşenlerinden, henüz yapılandırılmamışsa Cassandra düğümlerine 9042 bağlantı noktasına erişilebildiğinden emin olun. Daha fazla bilgi için Bağlantı noktası koşulları bölümüne bakın.

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

Tüm Cassandra düğümleri, her veri merkezinde tek tek güncellenmelidir. Bir veri merkezindeki düğümlerin yükseltilmesi arasında, güncellenen düğümün tamamen başlatıldığından ve kümeye katıldığından emin olmak için birkaç dakika bekleyin. Ardından, aynı veri merkezindeki başka bir düğümü yükseltmeye devam edin.

Bir veri merkezindeki tüm Cassandra düğümlerini yükselttikten sonra, bir sonraki veri merkezindeki düğümlere geçmeden önce biraz bekleyin (30 dakika ila birkaç saat). Bu süre zarfında, güncellenen veri merkezini ayrıntılı olarak inceleyin ve Apigee kümenizin işlevsel ve performans metriklerinin bozulmadığından emin olun. Bu adım, Cassandra'nın 4.0.X sürümüne yükseltildiği veri merkezinin kararlılığını sağlamak için önemlidir. Apigee bileşenlerinin geri kalanı ise 4.52.02 sürümünde kalır.

  1. Bir Cassandra düğümünü yükseltmek için aşağıdaki komutu çalıştırın: 
    /opt/apigee/apigee-setup/bin/update.sh -c cs -f configFile
  2. Bir düğüm güncellendikten sonra, devam etmeden önce bazı doğrulamalar yapmak için düğümde aşağıdaki komutu çalıştırın: 
    /opt/apigee/apigee-service/bin/apigee-service apigee-cassandra validate_upgrade -f configFile
  3. Yukarıdaki komut, aşağıdaki gibi bir çıktı verir: 
    Cassandra version is verified - [cqlsh 6.0.0 | Cassandra 4.0.13 | CQL spec 3.4.5 | Native protocol v5] 
Metadata is verified

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

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

/opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile

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

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

/opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile

5. Adım: Edge for Private Cloud 4.53.00'daki geri kalan tüm bileşenleri yükseltin

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

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

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

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

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.

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.53.00 sürümünü geri alma 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ı, Private Cloud için Edge 4.52.02'yi yüklemek için kullandığınız dosyayla aynı olmalıdır.

Harici internet bağlantısı olan bir düğümde 4.53.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. SELinux'u Edge apigee-setup yardımcı programını yükleme bölümünde açıklandığı şekilde devre dışı bırakın.
  4. 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

Daha sonra güncellemeyi geri almaya karar verirseniz 4.53.00 sürümünü geri alma bölümünde açıklanan prosedürü uygulayın.

Yerel bir depodan 4.53.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.53.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.53.00 deposu oluşturun.
  2. apigee-service'i .tar dosyasından yüklemek için:
    1. Yerel deposunun bulunduğu düğümde, yerel deposu /opt/apigee/data/apigee-mirror/apigee-4.53.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 çıkarın: 
      tar -xzf apigee-4.53.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.53.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 depodan yükleme" bölümünde açıklandığı şekilde yapılandırın.
    2. Uzak düğümde Edge bootstrap_4.53.00.sh dosyasını /tmp/bootstrap_4.53.00.sh'e indirin: 
      /usr/bin/curl http://uName:pWord@remoteRepo:3939/bootstrap_4.53.00.sh -o /tmp/bootstrap_4.53.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üğümde Edge apigee-setup yardımcı programını ve bağımlılıklarını yükleyin: 
      sudo bash /tmp/bootstrap_4.53.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.50.00 veya 4.51.00 yükleme sırasında Edge bileşenlerinizi tanımlamak için kullandığınız yapılandırma dosyasıyla aynıdır.

    component değerini "tümü" olarak ayarlayarak update.sh'ü tüm bileşenler üzerinde çalıştırabilirsiniz. Bunun için Edge hepsi bir arada (AIO) yükleme profilinizin olması gerekir. Örneğin:

    /opt/apigee/apigee-setup/bin/update.sh -c all -f /tmp/sa_silent_config
  8. Henüz yapmadıysanız kullanıcı arayüzü bileşenlerini çalıştıran tüm düğümlerde yeniden başlatın: 
    /opt/apigee/apigee-service/bin/apigee-service [edge-management-ui|edge-ui] restart
  9. Yüklemeyi test etme bölümünde açıklandığı gibi, Yönetim Sunucusu'nda apigee-validate yardımcı programını çalıştırarak güncellemeyi test edin.

Daha sonra güncellemeyi geri almaya karar verirseniz 4.53.00 sürümünü geri alma bölümünde açıklanan prosedürü uygulayın.

Makine güncellemesinin sırası

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

  • Diğer düğümleri güncellemeden önce tüm Cassandra ve ZooKeeper düğümlerini güncellemeniz gerekir.
  • Birden fazla Edge bileşeni (yönetim sunucusu, ileti işleyici, yönlendirici, QPID sunucusu ancak Postgres sunucusu değil) içeren makinelerde hepsini aynı anda güncellemek için -c edge seçeneğini kullanın.
  • Bir adımda birden fazla makinede yapılması gerektiği belirtiliyorsa bu adımı belirtilen makine sırasına göre gerçekleştirin.
  • Para kazanma özelliğini güncellemek için ayrı bir adım yoktur. -c edge seçeneğini belirttiğinizde güncellenir.

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

1 düğümlü bağımsız bir yapılandırmayı 4.53.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ını güncelleyin: 
    /opt/apigee/apigee-service/bin/apigee-service apigee-adminapi update

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

2 düğümlü bağımsız kurulum için aşağıdaki bileşenleri güncelleyin:

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

  1. 1. makinede Cassandra ve ZooKeeper'ı güncelleyin: 
    /opt/apigee/apigee-setup/bin/update.sh -c cs,zk -f configFile
  2. 2. makinede Postgres'i güncelleyin: 
    /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
  3. 1. makinede LDAP'yi güncelleyin: 
    /opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile
  4. 2. ve 1. makinedeki Edge bileşenlerini güncelleyin: 
    /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
  5. 2. makinede Qpid'i güncelleyin: 
    /opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
  6. 1. makinedeki kullanıcı arayüzünü güncelleyin: 
    /opt/apigee/apigee-setup/bin/update.sh -c ui -f configFile
  7. (apigee-adminapi'yi yüklediyseniz) 1. makinedeki apigee-adminapi yardımcı programını güncelledi: 
    /opt/apigee/apigee-service/bin/apigee-service apigee-adminapi update
  8. (Apigee TOA'yı yüklediyseniz) 1. makinede Apigee TOA'yı güncelleyin: 
    /opt/apigee/apigee-setup/bin/update.sh -c sso -f sso_config_file

    Burada sso_config_file, TOA'yı yüklerken oluşturduğunuz yapılandırma dosyasıdır.

  9. 1. makinede Edge kullanıcı arayüzü bileşenini yeniden başlatın: 
    /opt/apigee/apigee-service/bin/apigee-service edge-ui restart

5 düğüm yükseltme

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

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

  1. 1, 2 ve 3 numaralı makinelerde Cassandra ve ZooKeeper'ı güncelleyin: 
    /opt/apigee/apigee-setup/bin/update.sh -c cs,zk -f configFile
  2. 4. makinede Postgres'i güncelleyin: 
    /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
  3. 5. makinede Postgres'i güncelleyin: 
    /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
  4. 1. makinede LDAP'yi güncelleyin: 
    /opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile
  5. 4, 5, 1, 2, 3 numaralı makinelerdeki Edge bileşenlerini güncelleyin: 
    /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
  6. 4. makinede Qpid'i güncelleyin: 
    /opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
  7. 5. makinede Qpid'i güncelleyin: 
    /opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
  8. Edge kullanıcı arayüzünü güncelleme:
    • Klasik kullanıcı arayüzü: Klasik kullanıcı arayüzünü kullanıyorsanız aşağıdaki örnekte gösterildiği gibi 1. makinedeki ui bileşenini güncelleyin: 
      /opt/apigee/apigee-setup/bin/update.sh -c ui -f configFile
    • Yeni Edge kullanıcı arayüzü: Yeni Edge kullanıcı arayüzünü yüklediyseniz uygun makinede (1. makine olmayabilir) ue bileşenini güncelleyin: 
      /opt/apigee/apigee-setup/bin/update.sh -c ue -f /opt/silent.conf
  9. (apigee-adminapi'yi yüklediyseniz) 1. makinedeki apigee-adminapi yardımcı programını güncelledi: 
    /opt/apigee/apigee-service/bin/apigee-service apigee-adminapi update
  10. (Apigee TOA'yı yüklediyseniz) 1. makinede Apigee TOA'yı güncelleyin: 
    /opt/apigee/apigee-setup/bin/update.sh -c sso -f sso_config_file

    Burada sso_config_file, TOA'yı yüklerken oluşturduğunuz yapılandırma dosyasıdır.

  11. Kullanıcı arayüzü bileşenini yeniden başlatın:
    • Klasik kullanıcı arayüzü: Klasik kullanıcı arayüzünü kullanıyorsanız aşağıdaki örnekte gösterildiği gibi 1. makinede edge-ui bileşenini yeniden başlatın: 
      /opt/apigee/apigee-service/bin/apigee-service edge-ui restart
    • Yeni Edge kullanıcı arayüzü: Yeni Edge kullanıcı arayüzünü yüklediyseniz uygun makinede (makinesi 1 olmayabilir) edge-management-ui bileşenini yeniden başlatın: 
      /opt/apigee/apigee-service/bin/apigee-service edge-management-ui restart

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

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

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

  1. 1, 2 ve 3 numaralı makinelerde Cassandra ve ZooKeeper'ı güncelleyin: 
    /opt/apigee/apigee-setup/bin/update.sh -c cs,zk -f configFile
  2. 8 numaralı makinede Postgres'i güncelleyin: 
    /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
  3. 9 numaralı makinede Postgres'i güncelleyin: 
    /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
  4. 1. makinede LDAP'yi güncelleyin: 
    /opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile
  5. 6, 7, 8, 9, 1, 4 ve 5 numaralı makinelerdeki Edge bileşenlerini şu sırayla güncelleyin: 
    /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
  6. 6 ve 7 numaralı makinelerde Qpid'i güncelleyin: 
    /opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
  7. 1. makinede yeni kullanıcı arayüzünü (ue) veya klasik kullanıcı arayüzünü (ui) güncelleyin: 
    /opt/apigee/apigee-setup/bin/update.sh -c [ui|ue] -f configFile
  8. (apigee-adminapi'u yüklediyseniz) 1. makinedeki apigee-adminapi yardımcı programını güncelleyin: 
    /opt/apigee/apigee-service/bin/apigee-service apigee-adminapi update
  9. (Apigee TOA'yı yüklediyseniz) 1. makinede Apigee TOA'yı güncelleyin: 
    /opt/apigee/apigee-setup/bin/update.sh -c sso -f sso_config_file

    Burada sso_config_file, TOA'yı yüklerken oluşturduğunuz yapılandırma dosyasıdır.

  10. Kullanıcı arayüzü bileşenini yeniden başlatın:
    • Klasik kullanıcı arayüzü: Klasik kullanıcı arayüzünü kullanıyorsanız aşağıdaki örnekte gösterildiği gibi 1. makinede edge-ui bileşenini yeniden başlatın: 
      /opt/apigee/apigee-service/bin/apigee-service edge-ui restart
    • Yeni Edge kullanıcı arayüzü: Yeni Edge kullanıcı arayüzünü yüklediyseniz uygun makinede (makinesi 1 olmayabilir) edge-management-ui bileşenini yeniden başlatın: 
      /opt/apigee/apigee-service/bin/apigee-service edge-management-ui restart

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

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

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

  1. 1, 2 ve 3 numaralı makinelerde Cassandra ve ZooKeeper'ı güncelleyin: 
    /opt/apigee/apigee-setup/bin/update.sh -c cs,zk -f configFile
  2. 8 numaralı makinede Postgres'i güncelleyin: 
    /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
  3. 9 numaralı makinede Postgres'i güncelleyin: 
    /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
  4. 4. ve 5. makinede LDAP'yi güncelleyin: 
    /opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile
  5. 12, 13, 8, 9, 6, 7, 10 ve 11 numaralı makinelerdeki Edge bileşenlerini aşağıdaki sırayla güncelleyin: 
    /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
  6. 12 ve 13 numaralı makinelerde Qpid'i güncelleyin: 
    /opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
  7. 6 ve 7 numaralı makinelerde yeni kullanıcı arayüzünü (ue) veya klasik kullanıcı arayüzünü (ui) güncelleyin: 
    /opt/apigee/apigee-setup/bin/update.sh -c [ui|ue] -f configFile
  8. (apigee-adminapi'u yüklediyseniz) 6 ve 7 numaralı makinelerde apigee-adminapi yardımcı programını güncelleyin: 
    /opt/apigee/apigee-service/bin/apigee-service apigee-adminapi update
  9. (Apigee TOA'yı yüklediyseniz) 6. ve 7. makinelerde Apigee TOA'yı güncelleyin: 
    /opt/apigee/apigee-setup/bin/update.sh -c sso -f sso_config_file

    Burada sso_config_file, TOA'yı yüklerken oluşturduğunuz yapılandırma dosyasıdır.

  10. Kullanıcı arayüzü bileşenini yeniden başlatın:
    • Klasik kullanıcı arayüzü: Klasik kullanıcı arayüzünü kullanıyorsanız aşağıdaki örnekte gösterildiği gibi 6 ve 7 numaralı makinelerde edge-ui bileşenini yeniden başlatın: 
      /opt/apigee/apigee-service/bin/apigee-service edge-ui restart
    • Yeni Edge kullanıcı arayüzü: Yeni Edge kullanıcı arayüzünü yüklediyseniz 6 ve 7 numaralı makinelerde edge-management-ui bileşenini yeniden başlatın: 
      /opt/apigee/apigee-service/bin/apigee-service edge-management-ui restart

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

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

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

  1. Cassandra ve ZooKeeper'ı güncelleyin:
    1. 1. Veri Merkezi'ndeki 1, 2 ve 3 numaralı makinelerde: 
      /opt/apigee/apigee-setup/bin/update.sh -c cs,zk -f configFile
    2. Veri Merkezi 2'deki 7, 8 ve 9 numaralı makinelerde 
      /opt/apigee/apigee-setup/bin/update.sh -c cs,zk -f configFile
  2. Postgres'i güncelleyin:
    1. 1. Veri Merkezi'ndeki 6. Makine 
      /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
    2. Veri Merkezi 2'deki 12 numaralı makine 
      /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
  3. LDAP'yi güncelleme:
    1. 1. Veri Merkezi'ndeki 1. Makine 
      /opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile
    2. 2. Veri Merkezi'ndeki 7. Makine 
      /opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile
  4. Edge bileşenlerini güncelleme:
    1. 1. Veri Merkezi'ndeki 4, 5, 6, 1, 2, 3 numaralı makineler 
      /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
    2. 2. Veri Merkezi'ndeki 10, 11, 12, 7, 8, 9 numaralı makineler 
      /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
  5. qpidd'yi güncelleyin:
    1. 1. Veri Merkezi'ndeki 4 ve 5 numaralı makineler
      1. 4. makinede qpidd'yi güncelleyin: 
        /opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
      2. 5. makinede qpidd öğesini güncelleyin: 
        /opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
    2. 2. Veri Merkezi'ndeki 10 ve 11 numaralı makineler
      1. 10 numaralı makinede qpidd güncellemesi: 
        /opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
      2. 11. makinede qpidd güncellemesi: 
        /opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
  6. Yeni kullanıcı arayüzünü (ue) veya klasik kullanıcı arayüzünü (ui) güncelleyin:
    1. 1. Veri Merkezi'ndeki 1. makine: 
      /opt/apigee/apigee-setup/bin/update.sh -c [ui|ue] -f configFile
    2. 2. Veri Merkezi'ndeki 7. makine: 
      /opt/apigee/apigee-setup/bin/update.sh -c [ui|ue] -f configFile
  7. (apigee-adminapi'u yüklediyseniz) apigee-adminapi yardımcı programı güncellendi:
    1. 1. Veri Merkezi'ndeki 1. makine: 
      /opt/apigee/apigee-service/bin/apigee-service apigee-adminapi update
    2. 2. Veri Merkezi'ndeki 7. makine: 
      /opt/apigee/apigee-service/bin/apigee-service apigee-adminapi update
  8. (Apigee TOA'yı yüklediyseniz) Apigee TOA'yı güncelleyin:
    1. 1. Veri Merkezi'ndeki 1. makine: 
      /opt/apigee/apigee-setup/bin/update.sh -c sso -f sso_config_file
    2. 2. Veri Merkezi'ndeki 7. makine: 
      /opt/apigee/apigee-setup/bin/update.sh -c sso -f sso_config_file

      3. Burada sso_config_file, TOA'yı yüklerken oluşturduğunuz yapılandırma dosyasıdır.

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

Standart olmayan yapılandırmalar için

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

  1. ZooKeeper
  2. Cassandra
  3. ps
  4. LDAP
  5. Edge: Qpid sunucusu, Edge Postgres sunucusu, Yönetim sunucusu, Mesaj İşleyen ve Yönlendirici'nin bulunduğu düğümler sırasıyla tüm düğümlerde "-c edge" profilidir.
  6. qpidd
  7. Edge kullanıcı arayüzü (klasik veya yeni)
  8. apigee-adminapi
  9. Apigee TOA

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