Bu bölümde, Apigee Edge 4.19.06 veya 4.50.00 sürümünden 4.51.00 sürümüne nasıl yükseltileceği açıklanmaktadır.
Güncellemeyi kimler gerçekleştirebilir?
Güncellemeyi çalıştıran kişi, Edge'i ilk yükleyen veya kök olarak çalışan kişiyle aynı olmalıdır.
Edge BGBG'leri yüklendikten sonra herkes yapılandırabilir.
Hangi bileşenleri güncellemeniz gerekir?
Tüm Edge bileşenlerini güncellemeniz gerekir. Edge, birden çok sürümden bileşenler içeren bir kurulumu desteklemez.
Mülk ayarlarının otomatik olarak yayılması
/opt/apigee/customer/application
içinde .properties
dosyalarını düzenleyerek herhangi bir özellik ayarladıysanız bu değerler güncelleme ile korunur.
Postgres 10.17'ye geçiş gerekli
Edge'in bu sürümü, Postgres 10.17 sürümüne bir yükseltme içerir. Bu yükseltme kapsamında tüm Postgres verileri Postgres 10.17'ye taşınır.
Çoğu Edge üretim sistemi, ana bekleme modunda ç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 nedeniyle kullanım dışıyken analiz verileri hâlâ Qpid düğümlerine yazılır. Postgres düğümleri güncellenip tekrar internete bağlandıktan sonra, analiz verileri Postgres düğümlerine aktarılır.
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 süresince yeni bir Postgres bekleme düğümü yüklemeniz gerekir. Yükseltme işlemi tamamlandıktan sonra yeni Postgres bekleme düğümünü devre dışı bırakabilirsiniz.
Herhangi bir nedenle güncellemeyi geri çekmeniz gerekirse ek Postgres bekleme düğümü gerekir. Güncellemeyi geri çekmeniz gerekirse yeni Postgres bekleme düğümü, geri alma işleminden sonra ana Postgres düğümü olur. Bu nedenle, yeni Postgres bekleme düğümünü kurduğunuzda bu düğüm, Edge Yükleme şartlarında tanımlandığı gibi Postgres sunucusunun tüm donanım gereksinimlerini karşılayan bir düğümde olmalıdır.
Edge'in 1 ve 2 düğümlü yapılandırmasında prototip oluşturma ve test için kullanılan topolojilerde yalnızca tek bir Postgres düğümünüz vardır. Bu Postgres düğümlerini, yeni bir Postgres düğümü oluşturmanız gerekmeden doğrudan güncelleyebilirsiniz.
- Apigee tarafından önerildiği gibi 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 bekleme düğümünü kurmayı ve daha sonra geçersiz kılmayı 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 yapmak zorunda kalırsanız Postgres düğümünü ilgili anlık görüntüden geri yükleyebilirsiniz.
Yeni bir Postgres bekleme düğümü yükleniyor
Bu prosedür, yeni bir düğümde bir Postgres bekleme sunucusu oluşturur. Edge'in 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 bekleme sunucusu yüklediğinizden emin olun.
Yüklemeyi gerçekleştirmek için Edge'in mevcut sürümünü yüklerken kullandığınız yapılandırma dosyasını kullanın.
Yeni bir Postgres bekleme düğümü oluşturmak için:
- Geçerli Postgres ana kopyasında, aşağıdaki jetonu ayarlamak için
/opt/apigee/customer/application/postgresql.properties
dosyasını düzenleyin. 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 bekleme sunucusunun IP adresidir. new_standby_ip ise yeni bekleme düğümünün IP adresidir.
- Postgres ana slaydında
apigee-postgresql
öğesini yeniden başlatın:/opt/apigee/apigee-service/bin/apigee-service apigee-postgresql restart
- Ana düğümdeki
/opt/apigee/apigee-postgresql/conf/pg_hba.conf
dosyasını görüntüleyerek yeni bekleme düğümünün eklendiğini doğrulayın. Dosyada şu satırları görürsünüz:host replication apigee existing_standby_ip/32 trust host replication apigee new_standby_ip/32 trust
- Yeni Postgres bekleme sunucusunu yükleyin:
- 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
- SELinux'u Edge Apigee-setup yardımcı programını yükleme bölümünde açıklandığı şekilde devre dışı bırakın.
- Yükseltme yaptığınız Edge sürümüne bağlı olarak aşağıdakilerden birini yapın:
- Edge 4.19.06'dan yükseltme yapıyorsanız Edge bootstrap_4.19.06.sh dosyasını
/tmp/bootstrap_4.19.06.sh
sürümüne 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'dan yükseltme yapıyorsanız Edge bootstrap_4.50.00.sh dosyasını
/tmp/bootstrap_4.50.00.sh
konumuna 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
- Edge 4.19.06'dan yükseltme yapıyorsanız Edge bootstrap_4.19.06.sh dosyasını
apigee-setup
yardımcı programını yüklemek içinapigee-service
uygulamasını kullanın:/opt/apigee/apigee-service/bin/apigee-service apigee-setup install
- Postgres'i yükleyin:
/opt/apigee/apigee-setup/bin/setup.sh -p ps -f configFile
- Yeni bekleme düğümünde aşağıdaki komutu çalıştırın:
/opt/apigee/apigee-service/bin/apigee-service apigee-postgresql postgres-check-standby
Bekleme olduğunu söylediğini doğrulayın.
- 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:
Postgres'i yerinde yükseltme
Postgres 10.17'ye yerinde yükseltme yapmak için aşağıdaki adımları uygulayın:
- Posterleri ana makinede yükselt
/opt/apigee/apigee-setup/bin/update.sh -c ps -f /opt/silent.conf
- Kurulum komutunu ana ana makinede çalıştırın:
apigee-service apigee-postgresql setup -f /opt/silent.conf
- Ana makinede yapılandır komutunu çalıştırın:
apigee-service apigee-postgresql configure
- Ana makineyi yeniden başlatın:
apigee-service apigee-postgresql restart
- Ana sunucu olarak yapılandırın:
apigee-service apigee-postgresql setup-replication-on-master -f /opt/silent.conf
- Ana makinenin başlattığından emin olun:
apigee-service apigee-postgresql wait_for_ready
- Bekleme modunu durdurun:
apigee-service apigee-postgresql stop
- Bekleme modunu yükseltin.
Not: Bu adım hatalıysa/başarısız olursa yoksayılabilir.
update.sh
, yedek sunucusunu yanlış bir yapılandırmayla başlatmayı deneyecektir. Postgres yüklemesi 10.17'ye yükseltildiğinde hata yoksayılabilir./opt/apigee/apigee-setup/bin/update.sh -c ps -f /opt/silent.conf
- Bekleme modunun durduğundan emin olun:
apigee-service apigee-postgresql stop
- Eski bekleme yapılandırmasını kaldırın:
rm -rf /opt/apigee/data/apigee-postgresql/
- Bekleme sunucusunda çoğaltma ayarlayın:
apigee-service apigee-postgresql setup-replication-on-standby -f /opt/silent.conf
Bu prosedürü tamamladıktan sonra, bekleme modu başarıyla başlar.
Postgres düğümünü geçersiz kılma
Güncelleme tamamlandıktan sonra yeni bekleme düğümünü devre dışı bırakın:
- 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
- Yeni bekleme düğümünde aşağıdaki
curl
komutunu çalıştırarak yeni bekleme düğümünün UUID'sini alın:curl -u sysAdminEmail:password http://node_IP:8084/v1/servers/self
Düğümün UUID'sini çıkışın sonunda şu biçimde görürsünüz:
"type" : [ "postgres-server" ], "uUID" : "599e8ebf-5d69-4ae4-aa71-154970a8ec75"
- Yeni bekleme düğümünde aşağıdaki komutu çalıştırarak yeni bekleme düğümünü durdurun:
/opt/apigee/apigee-service/bin/apigee-all stop
- Postgres ana düğümünde, yeni bekleme düğümünü
conf_pg_hba_replication.connection
öğesinden kaldırmak için/opt/apigee/customer/application/postgresql.properties
öğesini düzenleyin:conf_pg_hba_replication.connection=host replication apigee existing_standby_ip/32 trust
- Postgres ana makinesinde Apigee-postgresql'i yeniden başlatın:
/opt/apigee/apigee-service/bin/apigee-service apigee-postgresql restart
- Ana düğümdeki
/opt/apigee/apigee-postgresql/conf/pg_hba.conf
dosyasını görüntüleyerek yeni bekleme düğümünün kaldırıldığını doğrulayın. Dosyada yalnızca şu satırı görürsünüz:host replication apigee existing_standby_ip/32 trust
- Yönetim Sunucusu düğümünde aşağıdaki Edge Management API çağrısını yaparak bekleme düğümünün UUID'sini ZooKeeper'dan silin:
curl -u sysAdminEmail:password -X DELETE http://ms_IP:8080/v1/servers/new_standby_uuid
Ön koşulları güncelleme
Apigee Edge'i yükseltmeden önce aşağıdaki ön koşulları yerine getirin:
- Tüm düğümleri yedekleyin
Güncellemeden önce, güvenlik nedeniyle tüm düğümleri tamamen yedeklemenizi öneririz. Yedekleme işlemini gerçekleştirmek için Edge'in mevcut sürümüne ilişkin prosedürü kullanın.Bu sayede, yeni sürüme güncellemenin düzgün çalışmaması ihtimaline karşı bir yedekleme planınız olur. Yedekleme hakkında daha fazla bilgi için Yedekleme ve Geri Yükleme başlıklı makaleyi inceleyin.
- Edge'nin çalıştığından emin olma
Güncelleme işlemi sırasında Edge'in çalışır durumda olduğundan emin olmak için şu komutu kullanın:/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 Private Cloud için yeni Edge kullanıcı arayüzü bölümüne bakın.
Edge kullanıcı arayüzünü yükleme
İlk yüklemeyi tamamladıktan sonra Apigee, Private Cloud için Apigee Edge 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ğrulamasını 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ı makaleye bakın.
Edge kullanıcı arayüzünü güncelleme
Edge kullanıcı arayüzü bileşenini güncellemek istiyorsanız yükseltme yaptığınız Private Cloud için Edge sürümünü dikkate alın:
- 4.19.06 veya 4.50.00 sürümünden 4.51.00 sürümüne (yeni Edge kullanıcı arayüzü önceden yüklenmiş olarak):
edge-management-ui
bileşeni için bu bölümdeki yükseltme talimatlarını uygulayın.
Apigee mTLS ile güncelleme
Apigee mTLS'yi güncellemek için aşağıdaki adımları uygulayın:
Güncelleme geri alınıyor
Güncelleme hatası durumunda sorunu düzeltmeyi deneyebilir ve ardından update.sh
işlemini tekrar çalıştırabilirsiniz. Güncellemeyi birden çok kez çalıştırabilirsiniz. Güncellemeye kaldığı yerden devam eder.
Hata, güncellemeyi önceki sürüme geri çekmenizi gerektiriyorsa ayrıntılı talimatlar için 4.51.00 sürümüne geri dönme başlıklı makaleye bakın.
Günlük kaydı güncelleme bilgileri
Varsayılan olarak update.sh
yardımcı programı günlük bilgilerini şu adrese yazar:
/opt/apigee/var/log/apigee-setup/update.log
update.sh
yardımcı programını çalıştıran kişinin bu dizine erişimi yoksa günlüğü /tmp
dizinine update_username.log
adlı bir dosya olarak yazar.
Bu kişinin /tmp
erişimi yoksa update.sh
yardımcı programı
başarısız olur.
Kapalı kalma süresi güncellemesi
Kapalı kalma süresi olmayan güncelleme veya periyodik güncelleme, Edge'i indirmeden Edge yüklemenizi güncellemenize olanak tanır.
Kapalı kalma süresini güncelleme işlemi yalnızca 5 düğümlü veya daha büyük yapılandırmalarda yapılabilir.
Kapalı kalma süresi olmayan yükseltmenin anahtarı, her bir yönlendiriciyi yük dengeleyiciden tek tek kaldırmaktır. Ardından, Yönlendirici'yi ve Yönlendirici ile aynı makinede bulunan diğer bileşenleri güncelleyip Yönlendirici'yi tekrar yük dengeleyiciye ekleyebilirsiniz.
- Makine güncelleme sırası bölümünde anlatıldığı şekilde, makineleri yükleme sırasında doğru şekilde güncelleyin.
- Yönlendiricileri güncelleme zamanı geldiğinde, herhangi bir Yönlendiriciyi seçin ve Sunucu (İleti İşleyici/Yönlendirici) erişilebilirliğini Etkinleştirme/Devre Dışı Bırakma bölümünde açıklandığı gibi erişilemez hale getirin.
- Seçili Yönlendirici'yi ve diğer tüm Edge bileşenlerini Yönlendirici ile aynı makinede güncelleyin. Tüm Edge yapılandırmaları aynı düğümde bir Yönlendirici ve Mesaj İşleyici gösterir.
- Yönlendiriciyi tekrar erişilebilir yapın.
- Kalan Yönlendiriciler için 2-4 arasındaki adımları tekrarlayın.
- Yüklemenizde kalan makineler için güncelleme işlemine devam edin.
Güncelleme öncesinde ve sonrasında aşağıdakilere dikkat edin:
- Birleşik Yönlendirici ve Mesaj İşleyici düğümünde:
- Güncellemeden önce aşağıdakileri yapın:
- Yönlendiriciyi erişilemez hale getirin.
- Mesaj İşleyici'ye erişilemez.
- Güncellemeden sonra aşağıdakileri yapın:
- Mesaj İşleyici'yi erişilebilir hale getirin.
- Yönlendiriciyi erişilebilir hale getirin.
- Güncellemeden önce aşağıdakileri yapın:
- Tek Yönlendirici düğümlerinde:
- Güncellemeden önce, Yönlendiriciyi erişilemez hale getirin.
- Güncellemeden sonra, Yönlendiriciyi erişilebilir hale getirin.
- Tek bir Mesaj İşleyici düğümlerinde:
- Güncellemeden önce İleti İşleyici'yi erişilemez hale getirin.
- Güncellemeden sonra İleti İşleyici'yi erişilebilir hale getirin.
Sessiz bir yapılandırma dosyası kullanma
Güncelleme komutuna sessiz bir 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ızla 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ü kullanın:
- Mevcut olduğunda, güncelleme tamamlanana kadar Cassandra'da onarım işlemi gerçekleştirmek için yapılandırılmış
cron
işlerini devre dışı bırakın. - Edge BGBG'lerini yüklemek için düğümünüze kök olarak giriş yapın.
yum-utils
veyum-plugin-priorities
uygulamalarını yükleyin:sudo yum install yum-utils
sudo yum install yum-plugin-priorities
- SELinux'u Edge Apigee-setup yardımcı programını yükleme bölümünde açıklandığı şekilde devre dışı bırakın.
- Oracle 7.x'e yükleme yapıyorsanız aşağıdaki komutu çalıştırın:
sudo yum-config-manager --enable ol7_optional_latest
- AWS'ye yükleme yapıyorsanız aşağıdaki
yum-configure-manager
komutlarını çalıştırın:yum update rh-amazon-rhui-client.noarch
sudo yum-config-manager --enable rhui-REGION-rhel-server-extras rhui-REGION-rhel-server-optional
- Edge 4.51.00
bootstrap_4.51.00.sh
dosyasını/tmp/bootstrap_4.51.00.sh
hedefine indirin:curl https://software.apigee.com/bootstrap_4.51.00.sh -o /tmp/bootstrap_4.51.00.sh
- Şu 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 cihazınızda Java 1.8'in yüklü olup olmadığını kontrol eder. Yüklemezseniz yükleyici, programı sizin için yükler.
Java yüklemesinin 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 (varsayılan) sürümünü yükleyin.C
: Java'yı yüklemeden devam edin.Q
: Çık. Bu seçenek için Java'yı kendiniz yüklemeniz gerekir.
- Aşağıdaki örnekte gösterildiği gibi,
apigee-setup
yardımcı programını güncellemek içinapigee-service
öğesini kullanın:/opt/apigee/apigee-service/bin/apigee-service apigee-setup update
- Yönetim Sunucusu'ndaki
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
- Yönetim Sunucusu'ndaki
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
- Aşağıdaki komutu çalıştırarak
update
yardımcı programını düğümlerinizde çalıştırın:/opt/apigee/apigee-setup/bin/update.sh -c component -f configFile
Bu işlemi Makine güncellemesi sırası bölümünde açıklanan sırayla yapın.
Burada:
- component, güncellenecek Edge bileşenidir. Olası değerler şunlardır:
cs
: Cassandraedge
: Edge kullanıcı arayüzü hariç tüm Edge bileşenleri: Yönetim Sunucusu, Mesaj İşlemci, Yönlendirici, QPID Sunucusu, Postgres Sunucusuldap
: OpenLDAPps
: postgresqlqpid
: qpiddsso
: Apigee TOA (TOA'yı yüklediyseniz)ue
: Yeni Edge kullanıcı arayüzüui
: Klasik Edge kullanıcı arayüzüzk
: Hayvanat Bahçesi Bakıcısı
- configFile, 4.19.06 veya 4.50.00 yüklemesi sırasında Edge bileşenlerinizi tanımlamak için kullandığınız yapılandırma dosyasıdır.
component ayarını "tümü" yaparak
update.sh
aracını tüm bileşenlerde çalıştırabilirsiniz (yalnızca Edge hepsi bir arada (AIO) yükleme profiliniz varsa). Örneğin:/opt/apigee/apigee-setup/bin/update.sh -c all -f ./sa_silent_config
- component, güncellenecek Edge bileşenidir. Olası değerler şunlardır:
- 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
- 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 çekmeye karar verirseniz 4.51.00 sürümünde eski sürüme dönme bölümünde açıklanan prosedürü uygulayın.
Yerel bir depodan 4.51.00 sürümüne güncelleme
Edge düğümlerinizin internet üzerinden güvenlik duvarı arkasında olması veya başka bir şekilde Apigee deposuna internet üzerinden erişmesi yasaklanıyorsa güncelleme işlemini Apigee deposunun yerel deposundan ya da yansıtması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, ardından .tar dosyasından Edge'i güncelleyin.
- Diğer düğümlerin erişebilmesi için yerel deponun bulunduğu düğüme bir web sunucusu yükleyin. Apigee, kullanmanız için NGINX web sunucusunu sağlar. Dilerseniz kendi web sunucunuzu de kullanabilirsiniz.
Yerel bir 4.51.00 deposundan güncelleme yapmak 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.51.00 deposu oluşturun.
- .tar dosyasından Apigee-service'i yüklemek için:
- Yerel deponun bulunduğu düğümde, yerel depoyu
/opt/apigee/data/apigee-mirror/apigee-4.51.00.tar.gz
adlı tek bir .tar dosyası olarak paketlemek için aşağıdaki komutu kullanın:/opt/apigee/apigee-service/bin/apigee-service apigee-mirror package
- .tar dosyasını, Edge'i güncellemek istediğiniz düğüme kopyalayın. Örneğin, bunu yeni düğümdeki
/tmp
dizinine kopyalayın. - Yeni düğümde, dosyanın tarlasını kaldırarak
/tmp
dizinini kaldırın:tar -xzf apigee-4.51.00.tar.gz
Bu komut, .tar dosyasını içeren dizinde
repos
adında yeni bir dizin oluşturur. Örneğin,/tmp/repos
. - Edge
apigee-service
yardımcı programını ve/tmp/repos
kaynağından bağımlılıkları yükleyin:sudo bash /tmp/repos/bootstrap_4.51.00.sh apigeeprotocol="file://" apigeerepobasepath=/tmp/repos
Depo dizininin yolunu bu komuta eklediğinize dikkat edin.
- Yerel deponun bulunduğu düğümde, yerel depoyu
- NGINX web sunucusunu kullanarak Apigee-service yüklemek için:
- NGINX web sunucusunu, Install the Edge küme-setup yardımcı programı bölümündeki "NGINX web sunucusunu kullanarak depodan yükleme" bölümünde açıklandığı şekilde yapılandırın.
- Uzak düğümde, Edge
bootstrap_4.51.00.sh
dosyasını/tmp/bootstrap_4.51.00.sh
hedefine indirin:/usr/bin/curl http://uName:pWord@remoteRepo:3939/bootstrap_4.51.00.sh -o /tmp/bootstrap_4.51.00.sh
Burada uName:pWord, daha önce depo için belirlediğiniz kullanıcı adı ve şifre, remoteRepo ise depo düğümünün IP adresi veya DNS adıdır.
- Uzak düğümde 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, depo kullanıcı adı ve şifresidir.
- Aşağıdaki örnekte gösterildiği gibi,
apigee-setup
yardımcı programını güncellemek içinapigee-service
öğesini kullanın:/opt/apigee/apigee-service/bin/apigee-service apigee-setup update
- Yönetim Sunucusu'ndaki
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
- Yönetim Sunucusu'ndaki
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
update
yardımcı programını düğümlerinizde Makine güncelleme sırası bölümünde açıklanan sırada ç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üncellersiniz:
cs
: Cassandraedge
: Edge kullanıcı arayüzü hariç tüm Edge bileşenleri: Yönetim Sunucusu, Mesaj İşlemci, Yönlendirici, QPID Sunucusu, Postgres Sunucusuldap
: OpenLDAPps
: postgresqlqpid
: qpiddsso
: Apigee TOA (TOA'yı yüklediyseniz)ue
Yeni Edge Kullanıcı Arayüzüui
: Klasik Edge kullanıcı arayüzüzk
: Hayvanat Bahçesi Bakıcısı
- configFile, 4.19.06 veya 4.50.00 yüklemesi sırasında Edge bileşenlerinizi tanımlamak için kullandığınız yapılandırma dosyasıdır.
component ayarını "tümü" yaparak
update.sh
aracını tüm bileşenlerde çalıştırabilirsiniz (yalnızca Edge hepsi bir arada (AIO) yükleme profiliniz varsa). Örneğin:/opt/apigee/apigee-setup/bin/update.sh -c all -f /tmp/sa_silent_config
- component, güncellenecek Edge bileşenidir. Genellikle aşağıdaki bileşenleri güncellersiniz:
- Henüz yapmadıysanız çalışan tüm düğümlerde kullanıcı arayüzü bileşenlerini yeniden başlatın:
/opt/apigee/apigee-service/bin/apigee-service [edge-management-ui|edge-ui] restart
- 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 çekmeye karar verirseniz 4.51.00 sürümünde eski sürüme dönme bölümünde açıklanan prosedürü uygulayın.
Makine güncellemesi sırası
Edge kurulumunda makineleri güncelleme sıranız önemlidir:
- Diğer düğümleri güncellemeden önce tüm Cassandra ve ZooKeeper düğümlerini güncellemeniz gerekir.
- Birden fazla Uç bileşeni olan tüm makinelerde (Yönetim Sunucusu, Mesaj İşlemci, Yönlendirici, QPID Sunucusu ancak Postgres Sunucusu hariç) tümünü aynı anda güncellemek için
-c edge
seçeneğini kullanın. - Bir adımın birden fazla makinede gerçekleştirilmesi gerektiğini belirtiyorsa adımı belirtilen makine sırasında 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 yapılandırmayı 4.51.00 sürümüne yükseltmek için:
- Tüm bileşenleri güncelleyin:
/opt/apigee/apigee-setup/bin/update.sh -c all -f configFile
- (
apigee-adminapi
uygulamasını 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 yükleme için aşağıdaki bileşenleri güncelleyin:
Edge topolojileri ve düğüm numaraları listesi için Yükleme topolojileri başlıklı makaleye bakın.
- 1. makinede Cassandra ve ZooKeeper'ı güncelleyin:
/opt/apigee/apigee-setup/bin/update.sh -c cs,zk -f configFile
- 2. makinede Qpid ve Postgres'i güncelleyin:
/opt/apigee/apigee-setup/bin/update.sh -c qpid,ps -f configFile
- 1. makinede LDAP'yi güncelleyin:
/opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile
- 2. ve 1. makinede Edge bileşenlerini güncelleyin:
/opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
- 1. makinede kullanıcı arayüzünü güncelleyin:
/opt/apigee/apigee-setup/bin/update.sh -c ui -f configFile
- (
apigee-adminapi
yüklediyseniz) 1. makinedeapigee-adminapi
yardımcı programını güncelledi:/opt/apigee/apigee-service/bin/apigee-service apigee-adminapi update
- (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üklediğinizde oluşturduğunuz yapılandırma dosyasıdır.
- 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ü yükleme için aşağıdaki bileşenleri güncelleyin:
Edge topolojileri ve düğüm numaraları listesi için Yükleme topolojileri başlıklı makaleye bakın.
- Cassandra ve ZooKeeper'ı 1., 2. ve 3. makinede güncelleyin:
/opt/apigee/apigee-setup/bin/update.sh -c cs,zk -f configFile
- 4. makinede Qpid ve Postgres'i güncelleyin:
/opt/apigee/apigee-setup/bin/update.sh -c qpid, ps -f configFile
- Makine 5'te Qpid ve Postgres'i güncelleyin:
/opt/apigee/apigee-setup/bin/update.sh -c qpid, ps -f configFile
- 1. makinede LDAP'yi güncelleyin:
/opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile
- Makine 4, 5, 1, 2, 3'te Edge bileşenlerini güncelleyin:
/opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
- Edge kullanıcı arayüzünü güncelleyin:
- Klasik kullanıcı arayüzü: Klasik kullanıcı arayüzünü kullanıyorsanız makine 1'de
ui
bileşenini aşağıdaki örnekte gösterildiği gibi 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
ue
bileşenini güncelleyin (makine 1 olmayabilir):/opt/apigee/apigee-setup/bin/update.sh -c ue -f /opt/silent.conf
- Klasik kullanıcı arayüzü: Klasik kullanıcı arayüzünü kullanıyorsanız makine 1'de
- (
apigee-adminapi
yüklediyseniz) 1. makinedeapigee-adminapi
yardımcı programını güncelledi:/opt/apigee/apigee-service/bin/apigee-service apigee-adminapi update
- (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üklediğinizde oluşturduğunuz yapılandırma dosyasıdır.
- 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 makine 1'de
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
edge-management-ui
bileşenini yeniden başlatın (1. makine olmayabilir):/opt/apigee/apigee-service/bin/apigee-service edge-management-ui restart
- Klasik kullanıcı arayüzü: Klasik kullanıcı arayüzünü kullanıyorsanız aşağıdaki örnekte gösterildiği gibi makine 1'de
9 düğümlü kümelenmiş yükseltme
9 düğümlü kümelenmiş yükleme için aşağıdaki bileşenleri güncelleyin:
Edge topolojileri ve düğüm numaraları listesi için Yükleme topolojileri başlıklı makaleye bakın.
- Cassandra ve ZooKeeper'ı 1., 2. ve 3. makinede güncelleyin:
/opt/apigee/apigee-setup/bin/update.sh -c cs,zk -f configFile
- 6 ve 7. makinelerde Qpid'yi güncelleyin:
/opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
- Makine 8'de Postgres'i güncelleyin:
/opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
- Makine 9'da Postgres'i güncelleyin:
/opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
- 1. makinede LDAP'yi güncelleyin:
/opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile
- Makine 6, 7, 8, 9, 1, 4 ve 5'teki Edge bileşenlerini sırasıyla güncelleyin:
/opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
- 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
- (
apigee-adminapi
yüklediyseniz) 1. makinedeapigee-adminapi
yardımcı programını güncelleyin:/opt/apigee/apigee-service/bin/apigee-service apigee-adminapi update
- (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üklediğinizde oluşturduğunuz yapılandırma dosyasıdır.
- 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 makine 1'de
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
edge-management-ui
bileşenini yeniden başlatın (1. makine olmayabilir):/opt/apigee/apigee-service/bin/apigee-service edge-management-ui restart
- Klasik kullanıcı arayüzü: Klasik kullanıcı arayüzünü kullanıyorsanız aşağıdaki örnekte gösterildiği gibi makine 1'de
13 düğümlü kümelenmiş yükseltme
13 düğümlü kümelenmiş yükleme için aşağıdaki bileşenleri güncelleyin:
Edge topolojileri ve düğüm numaraları listesi için Yükleme topolojileri başlıklı makaleye bakın.
- 1., 2. ve 3. makinelerde Cassandra ve ZooKeeper'ı güncelleyin:
/opt/apigee/apigee-setup/bin/update.sh -c cs,zk -f configFile
- 12 ve 13. makinelerde Qpid'yi güncelleyin:
/opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
- Makine 8'de Postgres'i güncelleyin:
/opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
- Makine 9'da Postgres'i güncelleyin:
/opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
- Makine 4 ve 5'te LDAP'yi güncelleyin:
/opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile
- 12, 13, 8, 9, 6, 7, 10 ve 11 numaralı makinelerde Edge bileşenlerini bu sırayla güncelleyin:
/opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
- 6 ve 7. 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
- (
apigee-adminapi
uygulamasını yüklediyseniz) 6 ve 7 numaralı makinelerdeapigee-adminapi
yardımcı programını güncelleyin:/opt/apigee/apigee-service/bin/apigee-service apigee-adminapi update
- (Apigee TOA'yı yüklediyseniz) 6 ve 7 numaralı 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üklediğinizde oluşturduğunuz yapılandırma dosyasıdır.
- Kullanıcı arayüzü bileşenini yeniden başlatın:
- Klasik kullanıcı arayüzü: Klasik kullanıcı arayüzünü kullanıyorsanız 6 ve 7 numaralı makinelerde
edge-ui
bileşenini aşağıdaki örnekte gösterildiği gibi 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
- Klasik kullanıcı arayüzü: Klasik kullanıcı arayüzünü kullanıyorsanız 6 ve 7 numaralı makinelerde
12 düğümlü kümelenmiş yükseltme
12 düğümlü kümelenmiş yükleme için aşağıdaki bileşenleri güncelleyin:
Edge topolojileri ve düğüm numaraları listesi için Yükleme topolojileri başlıklı makaleye bakın.
- Cassandra ve ZooKeeper'ı güncelleyin:
- Veri Merkezi 1'deki 1., 2. ve 3. makinelerde:
/opt/apigee/apigee-setup/bin/update.sh -c cs,zk -f configFile
- 2. Veri Merkezi'ndeki 7, 8 ve 9. makinelerde
/opt/apigee/apigee-setup/bin/update.sh -c cs,zk -f configFile
- Veri Merkezi 1'deki 1., 2. ve 3. makinelerde:
- qpidd'i güncelleyin:
- Veri Merkezi 1'deki makineler 4 ve 5
- Makine 4'te
qpidd
uygulamasını güncelleyin:/opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
- Makine 5'te
qpidd
uygulamasını güncelleyin:/opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
- Makine 4'te
- Veri Merkezi 2'deki makineler 10, 11
- Makine 10'da
qpidd
öğesini güncelleyin:/opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
- Makine 11'de
qpidd
güncelleme:/opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
- Makine 10'da
- Veri Merkezi 1'deki makineler 4 ve 5
- Postgres'i güncelleme:
- Veri Merkezi 1'deki Makine 6
/opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
- Veri Merkezi 2'de Makine 12
/opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
- Veri Merkezi 1'deki Makine 6
- LDAP'yi güncelleyin:
- Veri Merkezi 1'deki Makine 1
/opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile
- Veri Merkezi 2'de Makine 7
/opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile
- Veri Merkezi 1'deki Makine 1
- Edge bileşenlerini güncelleyin:
- Veri Merkezi'ndeki 4, 5, 6, 1, 2, 3 numaralı makineler 1
/opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
- Veri Merkezi'ndeki 10, 11, 12, 7, 8, 9 numaralı makineler 2
/opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
- Veri Merkezi'ndeki 4, 5, 6, 1, 2, 3 numaralı makineler 1
- Yeni kullanıcı arayüzünü (
ue
) veya klasik kullanıcı arayüzünü (ui
) güncelleyin:- Veri Merkezi 1'de Makine 1:
/opt/apigee/apigee-setup/bin/update.sh -c [ui|ue] -f configFile
- Veri Merkezi 2'de Makine 7:
/opt/apigee/apigee-setup/bin/update.sh -c [ui|ue] -f configFile
- Veri Merkezi 1'de Makine 1:
- (
apigee-adminapi
uygulamasını yüklediyseniz)apigee-adminapi
yardımcı programı güncellendi:- Veri Merkezi 1'de Makine 1:
/opt/apigee/apigee-service/bin/apigee-service apigee-adminapi update
- Veri Merkezi 2'de Makine 7:
/opt/apigee/apigee-service/bin/apigee-service apigee-adminapi update
- Veri Merkezi 1'de Makine 1:
- (Apigee TOA'yı yüklediyseniz) Apigee TOA'yı güncelleyin:
- Veri Merkezi 1'de Makine 1:
/opt/apigee/apigee-setup/bin/update.sh -c sso -f sso_config_file
- Veri Merkezi 2'de Makine 7:
/opt/apigee/apigee-setup/bin/update.sh -c sso -f sso_config_file
Burada sso_config_file, TOA'yı yüklediğinizde oluşturduğunuz yapılandırma dosyasıdır.
- Veri Merkezi 1'de Makine 1:
- 1. ve 7. makinelerde yeni Edge kullanıcı arayüzü (
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 bir yapılandırma için
Standart olmayan bir yapılandırmanız varsa Edge bileşenlerini aşağıdaki sırayla güncelleyin:
- ZooKeeper
- Cassandra
- qpidd, ps
- LDAP
- Edge, sıradaki tüm düğümlerdeki "-c Edge" profili anlamına gelir: Qpid sunucusu, Edge Postgres Sunucusu, Yönetim Sunucusu, Mesaj İşleyicisi ve Yönlendiricisi olan düğümler.
- Edge kullanıcı arayüzü (klasik veya yeni)
apigee-adminapi
- 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.