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

Apigee Edge'in 4.16.01'den 4.16.05'e güncellenmesi

Edge for Private Cloud 4.16.05 sürümü

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

Yalnızca Apigee Edge 4.16.01.x sürümünü 4.16.05'e güncelleyebilirsiniz.

Edge'in 4.16.01.x 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.16.05 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.

Java JDK 8 sürümüne yükseltme gerekiyor

Edge'in bu sürümü, tüm Edge işleme düğümlerine Java JDK 8 sürümünü yüklemenizi gerektirir. Oracle JDK 8 veya OpenJDK 8'i yükleyebilirsiniz. Java JDK 8 henüz yüklü değilse güncelleme komut dosyası sizin için yükleyebilir.

Java 8 güncellemesi kapsamında, bazı TLS şifreleri artık Oracle JDK 8'de kullanılamamaktadır. Tam liste için http://docs.oracle.com/javase/8/docs/technotes/guides/security/SunProviders.html adresindeki "Default Disabled Cipher Suites" (Varsayılan Olarak Devre Dışı Bırakılan Şifreleme Paketleri) bölümüne bakın.

Uyarı: Edge'in bu sürümü JDK 7'yi desteklemez. Şu anda JDK 7 kullanıyorsanız JDK 8'e yükseltmeniz gerekir. Edge 4.16.05 yüklemesini geri alırsanız isteğe bağlı olarak Edge'i Java JDK 7'yi kullanacak şekilde yeniden yapılandırabilirsiniz.

Zookeeper'ı eski sürüme geçirme

Edge for Private Cloud 4.16.01'deki ZooKeeper RPM sürümü apigee-zookeeper-3.4.5-1.0.905.noarch.rpm'dir. Edge'in sonraki sürümlerinde, ZooKeeper sürümü tekrar apigee-zookeeper-3.4.5-0.0.948 olarak değiştirildi. Bu, yum'un Zookeeper'ı 4.16.01'den sonraki sürümlere yükseltmesini engeller. Bu durumu düzeltmek için Zookeeper'ı güncellemeden önce yum downgrade apigee-zookeeper komutunu çalıştırın.

Aşağıdaki komutu kullanarak Zookeeper sürümünüzü kontrol edebilirsiniz:

> rpm -qa |grep apigee-zookeeper

Bu komut, ZooKeeper sürümünü döndürürse:

apigee-zookeeper-3.4.5-1.0.905

Ardından eski sürüme geçmeniz gerekir.

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

apigee-validate yardımcı programını güncelleme

4.16.01 sürümünde, apigee-validate yardımcı programını bir Mesaj İşlemci düğümüne yükleyip çalıştırdınız. 4.16.05 sürümünde apigee-validate yardımcı programı, Yönetim Sunucusu düğümünde çalışacak şekilde güncellendi.

4.16.05 sürümüne güncellediğinizde apigee-validate yardımcı programını güncellemek için iki seçeneğiniz vardır:

Apigee tarafından önerilen: Yönetim Sunucusu düğümüne apigee-validate yardımcı programını yükleyip çalıştırın.

İsteğe bağlı olarak, apigee-validate yardımcı programını Mesaj İşleyici düğümlerinden kaldırabilirsiniz. Mesaj İşleyici düğümünde bırakırsanız 4.16.05 sürümüne güncellemeniz gerekir.
Alternatif olarak, Mesaj İşleyici düğümündeki apigee-validate yardımcı programını güncelleyip buradan çalıştırın. Ancak Apigee, bu aracı Yönetim Sunucusu'ndan yükleyip çalıştırmanızı önerir.

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 daha fazla bilgi için 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_kullanıcıadı.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.16.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.16.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 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.
Edge 4.16.05 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 4.16.05 apigee-service yardımcı programını ve bağımlılıklarını yükleyin:
> 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.
Varsayılan olarak yükleyici, 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.
apigee-setup yardımcı programını güncellemek için apigee-service'i kullanın:
1. Edge 4.15.07.0x sürümünü yükselterek 4.16.01 sürümünü yüklediyseniz apigee-setup yardımcı programını yüklemeniz gerekir:
  > /opt/apigee/apigee-service/bin/apigee-service apigee-setup install
  Bu komut, update.sh yardımcı programını <inst_dir>/apigee/apigee-setup/bin dizinine yükler.
  
  apigee-setup yardımcı programını zaten yüklediyseniz güncelleyin:
  > /opt/apigee/apigee-service/bin/apigee-service apigee-setup update
2. 4.16.01 sürümünü doğrudan yüklediyseniz (4.15.07.0x sürümünden yükseltme yapmadıysanız) apigee-setup yardımcı programını güncellemeniz gerekir:
  > /opt/apigee/apigee-service/bin/apigee-service apigee-setup update
  apigee-service için yapılan bu güncelleme, update.sh yardımcı programını <inst_dir>/apigee/apigee-setup/bin dizinine yükler.
Yönetim Sunucusu'na apigee-validate yardımcı programını yükleyin:
> /opt/apigee/apigee-service/bin/apigee-service apigee-validate install
Not: apigee-validate yardımcı programını bir Mesaj İşleyici düğümüne yüklediyseniz bu düğümde aşağıdaki komutu kullanarak güncelleyebilirsiniz:
> /opt/apigee/apigee-service/bin/apigee-service apigee-validate update
Ancak 4.16.05 için Apigee, Yönetim Sunucusu'na apigee-validate yardımcı programını yükleyip çalıştırmanızı önerir.
apigee-validate yardımcı programına iletilen yapılandırma dosyasını düzenleyin. Önceki Edge sürümünde, apigee-validate tarafından kullanılan yapılandırma dosyası aşağıdaki özellikleri gerektiriyordu:
APIGEE_ADMINPW=sysAdminPword
MP_POD=gateway
REGION=dc-1
Bu sürümde, yapılandırma dosyası yalnızca APIGEE_ADMINPW özelliğini gerektirir. Diğer iki özelliği dosyadan kaldırabilirsiniz.
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. Ö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 = 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ü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 Yığını
- 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.16.05 Geri Alma İşlemi bölümünde açıklanan prosedürü kullanın.

Yerel bir depodan 4.16.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.16.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ığı gibi yerel bir 4.16.05 deposu oluşturun.
Not: Mevcut bir 4.16.01 deponuz varsa 4.16.05 deposunu buna 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.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 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 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.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. 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=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:
1. Edge 4.15.07.0x sürümünü yükselterek 4.16.01 sürümünü yüklediyseniz apigee-setup yardımcı programını yüklemeniz gerekir:
  > /opt/apigee/apigee-service/bin/apigee-service apigee-setup install
  Bu komut, update.sh yardımcı programını <inst_dir>/apigee/apigee-setup/bin dizinine yükler.
  
  apigee-setup yardımcı programını zaten yüklediyseniz güncelleyin:
  > /opt/apigee/apigee-service/bin/apigee-service apigee-setup update
2. 4.16.01'i doğrudan yüklediyseniz (yani 4.15.07.0x'ten yükseltme yapmadıysanız) apigee-setup yardımcı programını güncellemeniz gerekir:
  > /opt/apigee/apigee-service/bin/apigee-service apigee-setup update
  apigee-service için yapılan bu güncelleme, update.sh yardımcı programını <inst_dir>/apigee/apigee-setup/bin dizinine yükler.
Yönetim Sunucusu düğümüne apigee-validate yardımcı programını yükleyin:
> /opt/apigee/apigee-service/bin/apigee-service apigee-validate install
Not: apigee-validate yardımcı programını bir Mesaj İşleyici düğümüne yüklediyseniz bu düğümde aşağıdaki komutu kullanarak güncelleyebilirsiniz:

> /opt/apigee/apigee-service/bin/apigee-service apigee-validate update
Ancak 4.16.05 için Apigee, Yönetim Sunucusu'na apigee-validate yardımcı programını yükleyip çalıştırmanızı önerir.
apigee-validate yardımcı programına iletilen yapılandırma dosyasını düzenleyin. Önceki Edge sürümünde, apigee-validate tarafından kullanılan yapılandırma dosyası aşağıdaki özellikleri gerektiriyordu:
APIGEE_ADMINPW=sysAdminPword
MP_POD=gateway
REGION=dc-1
Bu sürümde, yapılandırma dosyası yalnızca APIGEE_ADMINPW özelliğini gerektirir. Diğer iki özelliği dosyadan kaldırabilirsiniz.
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. Ö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 = 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ü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 Yığını
- 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.16.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.
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.