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

Apigee Edge'in 4.17.01'den 4.17.05'e güncellenmesi

Edge for Private Cloud sürüm 4.17.05

Hangi Edge sürümlerini 4.17.05'e güncelleyebilirsiniz?

Bu prosedürü kullanarak Apigee Edge 4.17.01.0x sürümünü 4.17.05 sürümüne güncelleyebilirsiniz.

Edge'in 4.16.01 sürümünden önceki bir sürümüne sahipseniz önce 4.16.01.x sürümüne geçmeniz, ardından 4.17.01 sürümüne güncellemeniz gerekir.

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.

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.

SMTMAILFROM yapılandırma parametresinin eklenmesi gerekir.

Edge 4.17.05, bir SMTP sunucusunu etkinleştirirken kullanılan yapılandırma dosyasına yeni bir zorunlu parametre ekledi. SMTP sunucusunu etkinleştirirken yapılandırma dosyasında SMTPMAILFROM değerini ayarlamanız gerekir. Bu parametre şu biçimdedir:

SMTPMAILFROM="My Company <myco@company.com>"

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:

> /opt/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 daha fazla bilgi için 4.17.05 Geri Alma İşlemi bölümüne bakın.

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, Sunucu (Mesaj İşleyici/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.
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.

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. 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şilemez 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.17.01'i yüklemek için kullandığınız dosya ile aynı olmalıdır.

Harici internet bağlantısı olan bir düğümde 4.17.05 sürümüne 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 kök olarak giriş yapın.
Not: RPM yüklemesi için kök erişimi gerekir ancak Edge yapılandırmasını kök 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.
Edge 4.17.05 bootstrap_4.17.05.sh dosyasını /tmp/bootstrap_4.17.05.sh dizinine indirin:
> curl https://software.apigee.com/bootstrap_4.17.05.sh -o /tmp/bootstrap_4.17.05.sh
Edge 4.17.05 apigee-service yardımcı programını ve bağımlılıklarını yükleyin:
> sudo bash /tmp/bootstrap_4.17.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.

Yükleyici, varsayılan olarak Java 1.8'in yüklü olup olmadığını kontrol eder. Yüklü değilse sizin için yükler. Java kurulumunun nasıl yapılacağını belirtmek için JAVA_FIX seçeneğini kullanın. JAVA_FIX şu değerleri alır:

I = OpenJDK 1.8'i yükle (varsayılan)
C = Java'yı yüklemeden devam et
Q = Çık. Bu seçenek için Java'yı kendiniz yüklemeniz gerekir.
(Yalnızca CentOS-6.x ve RedHat-6.x) Doğru Qpid sürümünü indirdiğinizden emin olmak için tüm Qpid düğümlerinde aşağıdaki komutu çalıştırın:
> yum install apigee-qpidd --disablerepo=epel
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
Yönetim Sunucusu'nda apigee-validate yardımcı programını güncelleyin:
> /opt/apigee/apigee-service/bin/apigee-service apigee-validate update
apigee-provision yardımcı programını güncelleyin:
> /opt/apigee/apigee-service/bin/apigee-service apigee-provision update
Güncelleme yardımcı programını, düğümlerinizde 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.

Güncellenecek bileşeni belirtmek için "-c" seçeneğini kullanın. Olası bileşenlerin listesi şunları içerir:
ldap = OpenLDAP
cs = Cassandra
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üncelleyin (yalnızca Edge aio yükleme profili veya API BaaS asa yükleme profili için kullanın)
e = ElasticSearch
b = API BaaS Stack
p = API BaaS Portalı
ebp = Aynı düğümde ElasticSearch, API BaaS Stack ve API BaaS Portalı
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.

Güncellemeyi daha sonra geri almak için 4.17.05 Geri Alma İşlemi bölümünde açıklanan prosedürü kullanın.

Yerel bir depodan 4.17.05 sürümüne 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.17.05 deposundan güncellemek için:

Edge apigee-setup yardımcı programını yükleme bölümündeki "Yerel Apigee deposu oluşturma" bölümünde açıklandığı şekilde yerel bir 4.17.05 deposu oluşturun.
Not: Mevcut bir 4.17.01 deponuz varsa 4.17.05 deposunu, Edge apigee-setup yardımcı programını yükleme bölümündeki "Yerel Apigee deposunu güncelleme" bölümünde açıklandığı şekilde ekleyebilirsiniz.
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.17.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.17.05.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ı /tmp/repos dizininden yükleyin:
  > sudo bash /tmp/repos/bootstrap_4.17.05.sh apigeeprotocol="file://" apigeerepobasepath=/tmp/repos
  
  Bu komuta repos dizininin yolunu eklediğinize dikkat edin.
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.17.05.sh dosyasını /tmp/bootstrap_4.17.05.sh dizinine indirin:
  > /usr/bin/curl http://uName:pWord@remoteRepo:3939/bootstrap_4.17.05.sh -o /tmp/bootstrap_4.17.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. Uzak düğümde Edge apigee-service yardımcı programını ve bağımlılıklarını yükleyin:
  > sudo bash /tmp/bootstrap_4.17.05.sh apigeerepohost=remoteRepo:3939 apigeeuser=uName apigeepassword=pWord apigeeprotocol=http://
  
  Burada uName:pWord, depo kullanıcı adı ve şifresidir.
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
Yönetim Sunucusu'ndaki apigee-validate yardımcı programını güncelleyin.
> /opt/apigee/apigee-service/bin/apigee-service apigee-validate update
apigee-provision yardımcı programını güncelleyin:
> /opt/apigee/apigee-service/bin/apigee-service apigee-provision update
Güncelleme yardımcı programını, düğümlerinizde 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.

Güncellenecek bileşeni belirtmek için "-c" seçeneğini kullanın. Olası bileşenlerin listesi şunları içerir:
ldap = OpenLDAP
cs = Cassandra
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üncelleyin (yalnızca Edge aio yükleme profili veya API BaaS asa yükleme profili için kullanın)
e = ElasticSearch
b = API BaaS Stack
p = API BaaS Portalı
ebp = Aynı düğümde ElasticSearch, API BaaS Stack ve API BaaS Portalı
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.

Güncellemeyi daha sonra geri almak için 4.17.05 Geri Alma İşlemi bölümünde açıklanan prosedürü kullanın.

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.
Birden fazla Edge bileşeni (Yönetim Sunucusu, Mesaj İşlemcisi, Yönlendirici, QPID Sunucusu ancak Postgres Sunucusu değil) bulunan tüm makinelerde, hepsini 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.
(Yalnızca CentOS-6.x ve RedHat-6.x) Harici internet bağlantısı olan tüm Qpid düğümlerinde, yukarıda gösterildiği gibi doğru Qpid sürümünü indirmek için aşağıdaki komutu çalıştırdığınızdan emin olun:
> yum install apigee-qpidd --disablerepo=epel