Google, içerikleri tercih ettiğiniz dile çevirmek için yapay zeka teknolojisini kullanır. Yapay zeka çevirilerinde hata olabilir.

Apigee Edge 4.16.05.x sürümünü en son 4.16.05 sürümüne güncelleyin

Edge for Private Cloud 4.16.05 sürümü

Bu dokümanda, mevcut 4.16.05 kurulumunuzu Apigee'nin en son RPM'lerini ve destek dosyalarını kullanacak şekilde güncellemek için uygulayacağınız prosedür yer almaktadır. Bu prosedür, güncelleme işlemini gerçekleştirmek için update.sh yardımcı programını kullanır.

En son 4.16.05 sürümüne hangi Edge sürümlerini güncelleyebilirsiniz?

Yalnızca mevcut bir Apigee Edge 4.16.05.x sürümünü en son 4.16.05 sürümüne güncelleyebilirsiniz.

Şu anda Edge 4.16.01.0x veya daha eski bir sürümü kullanıyorsanız öncelikle 4.16.05 sürümüne geçmeniz gerekir. 4.16.05 sürümüne nasıl geçiş yapacağınız hakkında bilgi edinmek için Apigee Edge 4.16.01'i 4.16.05'e güncelleme başlıklı makaleyi inceleyin.

Güncellemeyi kimler yapabilir?

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

Edge RPM'lerini yükledikten sonra herhangi bir kullanıcı bunları yapılandırabilir.

Güncelleme için disk alanı gereksinimleri

Güncellemeyi yapmadan önce en az 1 GB boş disk alanınız olduğundan emin olun.

4.16.05.x sürümünden itibaren 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.

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 önerilir. 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
Aşağıdaki komutu kullanarak güncelleme işlemi sırasında Edge'in çalışır durumda olduğundan emin olun:

> /<inst_root>/apigee/apigee-service/bin/apigee-all status

Başarısız bir güncellemeyi ele alma

Güncelleme başarısız olursa sorunu düzeltmeyi deneyebilir ve ardından update.sh dosyasını 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 4.16.05 Geri Alma İşlemi 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 kullanıcının bu dizine erişimi yoksa günlüğü /tmp dizinine update_username.log adlı bir dosya olarak yazar.

Kullanıcının /tmp dizinine 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.

Makineleri, kurulumunuz için doğru sırada güncelleyin. Bu sıra, aşağıda "Makine güncelleme sırası" bölümünde açıklanmıştır.
Yönlendiricileri güncelleme zamanı geldiğinde, bir sonraki "Yönlendirici ve Mesaj İşleyici'yi erişilemez hale getirme" bölümünde açıklandığı gibi herhangi bir Yönlendirici'yi seçip erişilemez hale getirin.
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.
Yönlendiriciyi tekrar erişilebilir hale getirin.
Kalan yönlendiriciler için 2-4 arasındaki adımları tekrarlayın.
Kurulumunuzdaki diğer makineler için güncellemeye devam edin.

Yönlendirici ve Mesaj İşleyici'yi erişilemez hale getirme

Üretim ortamında, optimum performans elde etmek için birden fazla yönlendirici ve mesaj işlemciniz olur. Güncellemeden önce/sonra bu yönlendiricilerin ve mesaj işlemcilerin erişilebilirliğini etkinleştirmeniz/devre dışı bırakmanız gerekir.

Aşağıdaki API çağrısı, bir düğümü erişilebilir veya erişilemez olarak yapılandırır:

> curl -u adminEmail:pWord -X POST "http://<ms_IP>:8080/v1/servers/UUID" -d "reachable=true|false"

Burada UUID, Mesaj İşlemci veya Yönlendirici'nin UUID'sidir ve erişilebilir değeri doğru veya yanlış olarak ayarlanır.

Yönlendiricinin UUID'sini belirlemeniz gerekiyorsa aşağıdaki cURL komutunu kullanın:

> curl http://<routerIP>:8081/v1/servers/self

Mesaj İşleyici'nin UUID'sini belirlemeniz gerekiyorsa aşağıdaki cURL komutunu kullanın:

> curl http://<mpIP>:8082/v1/servers/self

Güncellemeden önce/sonra aşağıdakileri yapın:

Birleşik yönlendirici ve mesaj işleyici düğümünde:
- Güncellemeden önce aşağıdakileri yapın:
  1. Yukarıda gösterilen API çağrısını kullanarak yönlendiriciyi erişilemez hale getirin.
  2. Mesaj İşleyici'yi erişilemez hale getirin.
- Güncellemeden sonra aşağıdakileri yapın:
  1. Mesaj İşleyici'yi erişilebilir hale getirin.
  2. Yönlendiriciyi erişilebilir hale getirin.
Tek bir yönlendirici düğümünde:
- Güncellemeden önce yönlendiriciyi erişilebilir hale getirin.
- Güncellemeden sonra yönlendiriciyi erişilebilir hale getirin.
Tek bir Mesaj İşleyici düğümünde:
- Güncellemeden önce Mesaj İşleyici'yi erişilemez hale getirin.
- Güncellemeden sonra Mesaj İşleyici'yi erişilebilir hale getirin.

Sessiz yapılandırma dosyası kullanma

Güncelleme komutuna bir sessiz yapılandırma dosyası iletmeniz gerekir. Sessiz yapılandırma dosyası, Edge 4.16.05'i yüklemek için kullandığınız dosya ile aynı olmalıdır.

Harici internet bağlantısı olan bir düğümde 4.16.05'i güncelleme prosedürü

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

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.
Edge RPM'lerini yüklemek için düğümünüze root olarak giriş yapın
Not: RPM yüklemesi için root erişimi gerekir ancak Edge yapılandırmasını root erişimi olmadan gerçekleştirebilirsiniz.
Edge apigee-setup yardımcı programını yükleme bölümünde açıklandığı şekilde SELinux'u devre dışı bırakın.
Tüm Yum önbelleklerini temizleyin:
> sudo yum clean all
En son Edge bootstrap_4.16.05.sh dosyasını /tmp/bootstrap_4.16.05.sh dizinine indirin:
> curl https://software.apigee.com/bootstrap_4.16.05.sh -o /tmp/bootstrap_4.16.05.sh
Edge apigee-service yardımcı programını ve bağımlılıklarını güncelleyin:
> sudo bash /tmp/bootstrap_4.16.05.sh apigeeuser=uName apigeepassword=pWord

Burada uName:pWord, Apigee'den aldığınız kullanıcı adı ve şifredir. pWord parametresini atlarsanız bu parametreyi girmeniz istenir.
apigee-setup yardımcı programını güncellemek için apigee-service'i kullanın:
> /opt/apigee/apigee-service/bin/apigee-service apigee-setup update

apigee-service'e yapılan bu güncelleme, update.sh yardımcı programını /<inst_dir>/apigee/apigee-setup/bin dizinine yükler.
Düğümlerinizde güncelleme yardımcı programını aşağıdaki "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

Yapılandırma dosyasıyla ilgili tek şart, yapılandırma dosyasının "apigee" kullanıcısı tarafından erişilebilir veya okunabilir olmasıdır. Örneğin, dosyayı düğümdeki /tmp dizinine yerleştirin.

Güncellenecek bileşeni belirtmek için "-c" seçeneğini kullanın. Olası bileşenlerin listesi şunları içerir:
- ldap = OpenLDAP
- cs = Cassandr
- zk = Zookeeper
- qpid = qpidd
- ps = postgresql
- edge =Edge kullanıcı arayüzü hariç tüm Edge bileşenleri: Yönetim Sunucusu, Mesaj İşlemcisi, Yönlendirici, QPID Sunucusu, Postgres Sunucusu
- ui = Edge kullanıcı arayüzü
- all = makinedeki tüm bileşenleri günceller (yalnızca Edge aio yükleme profili veya API BaaS asa yükleme profili için kullanılır)
- e = ElasticSearch
- b = API BaaS Stack
- p = API BaaS Portal
- ebp = ElasticSearch, API BaaS Stack ve API BaaS Portal aynı düğümde
apigee-validate yardımcı programını çalıştırarak güncellemeyi test edin, Yüklemeyi test edin.

4.16.05 sürümünü yerel bir depodan güncelleme prosedürü

Edge düğümleriniz bir güvenlik duvarının arkasındaysa veya başka bir şekilde Apigee deposuna internet üzerinden erişmeleri 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.16.05 deposundan güncellemek için:

Bir düğüme Edge bileşenlerini yükleme bölümünde açıklandığı gibi yerel bir 4.16.05 deponuz olduğundan emin olun.
Yerel depoyu güncelleyin:
1. En son Edge bootstrap_4.16.05.sh dosyasını /tmp/bootstrap_4.16.05.sh dizinine indirin:
  > curl https://software.apigee.com/bootstrap_4.16.05.sh -o /tmp/bootstrap_4.16.05.sh
2. Senkronizasyonu gerçekleştirin:
  > /opt/apigee/apigee-service/bin/apigee-service apigee-mirror sync --only-new-rpms
apigee-service'i bir .tar dosyasından yüklemek için:
1. Yerel depoya sahip düğümde, yerel depoyu /opt/apigee/data/apigee-mirror/apigee-4.16.05.tar.gz adlı tek bir.tar dosyasında 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.16.05.tar.gz
  
  Bu komut, .tar dosyasını içeren dizinde repos adlı yeni bir dizin oluşturur. Örneğin, /tmp/repos.
4. Edge RPM'lerini yüklemek için düğümünüze root olarak giriş yapın
  Not: RPM yüklemesi için root erişimi gerekir ancak Edge yapılandırmasını root erişimi olmadan gerçekleştirebilirsiniz.
5. Edge apigee-setup yardımcı programını yükleme bölümünde açıklandığı şekilde SELinux'u devre dışı bırakın.
6. Edge apigee-service yardımcı programını ve bağımlılıklarını /tmp/repos dizininden yükleyin:
  > sudo bash /tmp/repos/bootstrap_4.16.05.sh apigeeprotocol="file://" apigeerepobasepath=/tmp/repos
  
  Bu komutta repos dizininin yolunu eklediğinize dikkat edin.
Nginx web sunucusunu kullanarak apigee-service'i yüklemek için:
1. Nginx web sunucusunu, Edge bileşenlerini bir düğüme yükleme bölümündeki "Nginx web sunucusunu kullanarak depodan yükleme" başlığı altında açıklandığı şekilde yapılandırın.
2. Uzak düğümde Edge bootstrap_4.16.05.sh dosyasını /tmp/bootstrap_4.16.05.sh dizinine indirin:
  > /usr/bin/curl http://uName:pWord@remoteRepo:3939/bootstrap_4.16.05.sh -o /tmp/bootstrap_4.16.05.sh
  
  Burada uName:pWord, depo için yukarıda belirlediğiniz kullanıcı adı ve şifre, remoteRepo ise depo düğümünün IP adresi veya DNS adıdır.
3. Edge RPM'lerini yüklemek için düğümünüze root olarak giriş yapın
  Not: RPM yüklemesi için root erişimi gerekir ancak Edge yapılandırmasını root erişimi olmadan gerçekleştirebilirsiniz.
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. Uzak düğümde Edge apigee-service yardımcı programını ve bağımlılıklarını yükleyin:
  > sudo bash /tmp/bootstrap_4.16.05.sh apigeerepohost=remoteRepo:3939 apigeeuser=uNamea pigeepassword=pWord apigeeprotocol=http://
  
  Burada uName:pWord, depo kullanıcı adı ve şifresidir.
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.
apigee-setup yardımcı programını güncellemek için apigee-service'i kullanın:
> /opt/apigee/apigee-service/bin/apigee-service apigee-setup update

apigee-service'e yapılan bu güncelleme, update.sh yardımcı programını <inst_dir>/apigee/apigee-setup/bin dizinine yükler.
Düğümlerinizde güncelleme yardımcı programını aşağıdaki "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

Yapılandırma dosyasıyla ilgili tek şart, yapılandırma dosyasının "apigee" kullanıcısı tarafından erişilebilir veya okunabilir olmasıdır. Örneğin, dosyayı düğümdeki /tmp dizinine yerleştirin.

Güncellenecek bileşeni belirtmek için "-c" seçeneğini kullanın. Olası bileşenlerin listesi şunları içerir:
- ldap = OpenLDAP
- cs = Cassandr
- zk = Zookeeper
- qpid = qpidd
- ps = postgresql
- edge =Edge kullanıcı arayüzü hariç tüm Edge bileşenleri: Yönetim Sunucusu, Mesaj İşlemcisi, Yönlendirici, QPID Sunucusu, Postgres Sunucusu
- ui = Edge kullanıcı arayüzü
- all = makinedeki tüm bileşenleri günceller (yalnızca Edge aio yükleme profili veya API BaaS asa yükleme profili için kullanılır)
- e = ElasticSearch
- b = API BaaS Stack
- p = API BaaS Portal
- ebp = ElasticSearch, API BaaS Stack ve API BaaS Portal aynı düğümde
apigee-validate yardımcı programını çalıştırarak güncellemeyi test edin, Yüklemeyi test edin.

Makine güncelleme sırası

Edge kurulumunda makineleri güncelleme sıranız önemlidir. Güncelleme yaparken dikkat edilmesi gereken en önemli noktalar şunlardır:

Diğer düğümleri güncellemeden önce tüm Cassandra ve ZooKeeper düğümlerini güncellemeniz gerekir.
Herhangi bir yönlendirici ve mesaj işlemci düğümünü güncellemeden önce tüm qpidd ve postgresql düğümlerini güncellemeniz gerekir.
Birden fazla Edge bileşeni (Yönetim Sunucusu, Mesaj İşlemcisi, Yönlendirici, QPID Sunucusu, Postgres Sunucusu) bulunan 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.
Bir Router düğümünü güncelledikten sonra /opt/nginx/conf.d dizinindeki tüm dosyaları kaldırmanız ve ardından Router'ı yeniden başlatmanız gerekir.