Edge 4.51.00 sürümüne güncelleme sırasında bir hatayla karşılaşırsanız hataya neden olan bileşeni geri alıp güncellemeyi tekrar deneyebilirsiniz.
Edge 4.51.00'ı aşağıdaki özellik yayınlanan sürüm sürümlerine geri alabilirsiniz:
- Sürüm 4.50.00
- Sürüm 4.19.06
Geri alma işlemi yapmak isteyebileceğiniz iki senaryo vardır:
- Önceki bir özellik sürümüne geri dönme Örneğin, 4.51.00'dan 4.50.00'a düşürme.
- Aynı sürümdeki önceki bir güncelleme sürümüne geri dönme. Örneğin, 4.50.00.02'den 4.50.00.01'e.
Daha fazla bilgi için Apigee Edge sürüm süreci başlıklı makaleyi inceleyin.
Kimler geri alma işlemi gerçekleştirebilir?
Geri alma işlemini gerçekleştiren kullanıcı, Edge'i ilk güncelleyen kullanıcıyla aynı olmalı veya root olarak çalışan bir kullanıcı olmalıdır.
Varsayılan olarak Edge bileşenleri "apigee" kullanıcısı olarak çalışır. Bazı durumlarda, Edge bileşenlerini farklı kullanıcılar olarak çalıştırıyor olabilirsiniz. Örneğin, yönlendiricinin 1000'in altındakiler gibi ayrıcalıklı bağlantı noktalarına erişmesi gerekiyorsa yönlendiriciyi kök olarak veya bu bağlantı noktalarına erişimi olan bir kullanıcı olarak çalıştırmanız gerekir. Alternatif olarak, bir bileşeni bir kullanıcı olarak, başka bir bileşeni ise başka bir kullanıcı olarak çalıştırabilirsiniz.
Ortak koda sahip bileşenler
Aşağıdaki Edge bileşenleri ortak kodu paylaşır. Bu nedenle, bir düğümdeki bu bileşenlerden herhangi birini geri almak için o düğümdeki tüm bu bileşenleri geri almanız gerekir.
edge-management-server(Yönetim Sunucusu)edge-message-processor(Mesaj İşleyici)edge-router(Yönlendirici)edge-postgres-server(Postgres sunucusu)edge-qpid-server(Qpid Sunucusu)
Örneğin, düğümde Yönetim Sunucusu, Yönlendirici ve Mesaj İşlemci yüklüyse bunlardan herhangi birini geri almak için üçünü de geri almanız gerekir.
Önceki bir özellik sürümüne geri dönme
Önceki bir özellik sürümüne geri dönmek için bileşeni barındıran her düğümde aşağıdakileri yapın:
-
Geri dönmek istediğiniz sürümün
bootstrap.shdosyasını indirin:- 4.50.00 sürümüne geri dönmek için
bootstrap_4.50.00.shdosyasını indirin:curl https://software.apigee.com/bootstrap_4.50.00.sh -o /tmp/bootstrap_4.50.00.sh
- 4.19.06 sürümüne geri dönmek için
bootstrap_4.19.06.shdosyasını indirin:curl https://software.apigee.com/bootstrap_4.19.01.sh -o /tmp/bootstrap_4.19.01.sh
- 4.50.00 sürümüne geri dönmek için
- Geri döndürülecek bileşeni durdurun:
- Düğümdeki ortak koda sahip bileşenlerden herhangi birini geri almak için aşağıdaki örnekte gösterildiği gibi hepsini durdurmanız gerekir:
/opt/apigee/apigee-service/bin/apigee-service edge-management-server stop
/opt/apigee/apigee-service/bin/apigee-service edge-router stop/opt/apigee/apigee-service/bin/apigee-service edge-message-processor stop/opt/apigee/apigee-service/bin/apigee-service edge-qpid-server stop/opt/apigee/apigee-service/bin/apigee-service edge-postgres-server stop - Düğümdeki diğer bileşenleri geri almak için yalnızca ilgili bileşeni durdurun:
/opt/apigee/apigee-service/bin/apigee-service component stop
- Düğümdeki ortak koda sahip bileşenlerden herhangi birini geri almak için aşağıdaki örnekte gösterildiği gibi hepsini durdurmanız gerekir:
- Para Kazanma'yı geri alıyorsanız tüm Yönetim Sunucusu ve Mesaj İşleyici düğümlerinden kaldırın:
/opt/apigee/apigee-service/bin/apigee-service edge-mint-gateway uninstall
- Düğümde geri almak için bileşeni kaldırın:
- Düğümdeki ortak koda sahip bileşenlerden herhangi birini geri almak için aşağıdaki örnekte gösterildiği gibi
edge-gatewaybileşen grubunu kaldırarak hepsini kaldırmanız gerekir:/opt/apigee/apigee-service/bin/apigee-service edge-gateway uninstall
- Düğümdeki diğer bileşenleri geri almak için aşağıdaki örnekte gösterildiği gibi yalnızca ilgili bileşeni kaldırın:
/opt/apigee/apigee-service/bin/apigee-service component uninstall
component, bileşen adıdır.
- Edge Router'ı geri almak için
edge-gatewaybileşen grubunu kaldırmanın yanı sıra/opt/nginx/conf.ddosyasının içeriğini de silmeniz gerekir:cd /opt/nginx/conf.d
rm -rf *
- Düğümdeki ortak koda sahip bileşenlerden herhangi birini geri almak için aşağıdaki örnekte gösterildiği gibi
apigee-setupuygulamasının 4.51.00 sürümünü kaldırma:/opt/apigee/apigee-service/bin/apigee-service apigee-setup uninstall
apigee-serviceyardımcı programının 4.19.06 veya 4.50.00 sürümünü ve bağımlılıklarını yükleyin. Aşağıdaki örnekteapigee-service'nin 4.50.00 sürümü yüklenmektedir:sudo bash /tmp/bootstrap_4.50.00.sh apigeeuser=uName apigeepassword=pWord
uName ve pWord, Apigee'den aldığınız kullanıcı adı ve şifredir. pWord parametresini atlarsanız bu parametreyi girmeniz istenir.
Hata alırsanız 1. adımda
bootstrap.shdosyasını indirdiğinizden emin olun.apigee-setupuygulamasını yükleyin:/opt/apigee/apigee-service/bin/apigee-service apigee-setup install
- Bileşenin eski sürümünü yükleyin:
/opt/apigee/apigee-setup/bin/setup.sh -p component -f configFile
Burada component, yüklenecek bileşeni, configFile ise eski sürümün yapılandırma dosyasını ifade eder.
- Qpid'i geri alıyorsanız iptables'ı temizleyin:
sudo iptables -F
- Geri aldığınız bileşeni barındıran her düğüm için bu işlemi tekrarlayın.
Önceki bir güncelleme sürümüne geri dönme
Bir bileşeni bir sürümün belirli bir versiyonuna geri almak için bileşeni barındıran her düğümde aşağıdakileri yapın:
- Belirli bileşen sürümünü indirin:
/opt/apigee/apigee-service/bin/apigee-service component_version install
component_version, yüklenecek bileşen ve güncelleme sürümüdür. Örneğin:
/opt/apigee/apigee-service/bin/apigee-service edge-ui-4.18.05-0.0.3749 install
Apigee online deposunu kullanıyorsanız aşağıdaki komutu kullanarak kullanılabilir bileşen sürümlerini belirleyebilirsiniz:
yum --showduplicates list comp
Örneğin:
yum --showduplicates list edge-ui
- Bileşeni yüklemek için
apigee-setupkullanın:/opt/apigee/apigee-setup/bin/setup.sh -p comp -f configFile
Örneğin:
/opt/apigee/apigee-setup/bin/setup.sh -p ui -f configFile
Yükleme sırasında sürümü değil, yalnızca bileşen adını belirttiğinizi unutmayın.
- Geri aldığınız bileşeni barındıran her düğüm için bu işlemi tekrarlayın.
Postgres 10.17 güncellemesini geri alma
4.19.06 veya 4.50.00 sürümünden 4.51.00 sürümüne yükselttiyseniz Edge bileşenlerine ek olarak Postgres güncellemenizi de geri almanız gerekir.
Postgres'i ana-yedek yapılandırmasında güncellerken Postgres güncellemesini geri almak için:
- Yeni bekleme düğümünü Postgres ana düğümü olacak şekilde yükseltin. Yeni Postgres ana sürümü, önceki Edge kurulumunuzla aynı sürüm olacaktır.
- Eski bekleme düğümünü yeni ana düğümün bekleme düğümü olacak şekilde yapılandırın. Eski yedek düğüm, önceki Edge kurulumunuzla aynı sürümde olur.
- Yeni ana ve bekleme düğümlerini analiz ve tüketici gruplarına kaydedin.
Geri alma işlemini tamamladığınızda eski ana düğüme artık gerek kalmaz. Ardından eski ana düğümü kullanımdan kaldırabilirsiniz.
- Yeni bekleme Postgres düğümünün ç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
- Postgres'in eski ana düğümde ve eski bekleme düğümünde durdurulduğundan emin olun:
/opt/apigee/apigee-service/bin/apigee-all status
Postgres çalışıyorsa durdurun:
/opt/apigee/apigee-service/bin/apigee-service edge-postgres-server stop > /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql stop
- Yüklüyse eski bekleme düğümünde Qpid'yi başlatın:
/opt/apigee/apigee-service/bin/apigee-service edge-qpid-server start
- Yeni bekleme düğümünü Postgres ana düğümü olarak yükseltin:
- Yeni bekleme düğümünü yeni ana düğüm olarak yükseltin:
apigee-service apigee-postgresql promote-standby-to-master new_standby_IP
İstenirse "apigee" kullanıcısı için Postgres şifresini girin. Bu şifre varsayılan olarak "postgres"tir.
- Edge'in mevcut sürümünü yüklemek için kullandığınız yapılandırma dosyasını düzenleyerek aşağıdakileri belirtin:
# IP address of the new master: PG_MASTER=new_standby_IP # IP address of the old standby node PG_STANDBY=old_standby_IP
- Yeni ana anahtarı yapılandırın:
/opt/apigee/apigee-service/bin/apigee-service apigee-postgresql setup-replication-on-master -f configFile
- Yeni bekleme düğümünü yeni ana düğüm olarak yükseltin:
- Eski bekleme düğümünü daha yeni sürüme zaten yükselttiyseniz öncelikle eski bekleme düğümündeki Apigee yazılımını eski sürüme geçirmeniz gerekir. Eski bekleme düğümünde eski sürüm hâlâ mevcutsa bu adımı atlayıp 6. adıma geçebilirsiniz.
- Eski yedek düğümde Postgres'i durdurun:
apigee-service apigee-postgresql stop apigee-service edge-postgres-server stop
- Eski bekleme düğümünden Postgres'i kaldırın:
apigee-service apigee-postgresql uninstall apigee-service edge-postgres-server uninstall
- Postgres veri dizinini eski bekleme düğümünden silin:
cd /opt/apigee/data/apigee-postgresql/pgdata > rm -rf *
- Eski bekleme düğümünde eski sürüm önyüklemesini (geri döndüğünüz Apigee sürümü için) indirip çalıştırın. Uygulanacak adımlar, internet tabanlı veya çevrimdışı yükleme kullanmanıza bağlı olarak değişiklik gösterebilir. Apigee önyüklemesinin eski sürümünü çalıştırmak, yum depolarını eski sürüm Apigee verileriyle ayarlar.
- Eski yedek düğümde Postgres bileşenlerini ayarlayın:
/opt/apigee/apigee-setup/bin/setup.sh -p ps -f configFile
- Eski yedek düğümdeki Postgres bileşenlerinin eski sürüme geri alındığını kontrol edin ve doğrulayın:
apigee-service apigee-postgresql version apigee-service edge-postgres-server version
- Eski yedek düğümde Postgres'i durdurun:
- Eski bekleme düğümünü yeniden oluşturun:
- Edge'in mevcut sürümünü yüklemek için kullandığınız yapılandırma dosyasını düzenleyerek aşağıdakileri belirtin:
# IP address of the new master: PG_MASTER=new_standby_IP # IP address of the old standby node PG_STANDBY=old_standby_IP
- Eski bekleme düğümündeki veri dizinini kaldırın:
cd /opt/apigee/data/apigee-postgresql/pgdata > rm -rf *
- Eski bekleme düğümünü yeni ana düğümün bekleme düğümü olacak şekilde yeniden yapılandırın:
/opt/apigee/apigee-service/bin/apigee-service apigee-postgresql setup-replication-on-standby -f configFile
- Postgres'in eski bekleme düğümünde ç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-service edge-postgres-server start
- Edge'in mevcut sürümünü yüklemek için kullandığınız yapılandırma dosyasını düzenleyerek aşağıdakileri belirtin:
- Yeni ana düğümdeki
/opt/apigee/apigee-postgresql/conf/pg_hba.confdosyasını görüntüleyerek yeni bekleme düğümünün eklendiğini doğrulayın. - Yönetim sunucusunda aşağıdaki komutu çalıştırarak mevcut analizleri ve tüketici grubu bilgilerini görüntüleyin:
curl -u sysAdminEmail:password http://ms_IP:8080/v1/analytics/groups/ax
Bu komut,
namealanında analiz grubu adını veconsumer-groupsaltındakinamealanında tüketici grubu adını döndürür. Ayrıca,postgres-servervedatastoresalanlarında eski Postgres ana ve bekleme düğümlerinin UUID'lerini döndürür. Aşağıdaki biçimde bir çıkış görürsünüz:{ "name" : "axgroup-001", "properties" : { }, "scopes" : [ "VALIDATE~test", "sgilson~prod" ], "uuids" : { "qpid-server" : [ "8381a053-433f-4382-bd2a-100fd37a1592", "4b6856ec-ef05-498f-bac6-ef5f0d5f6521" ], "postgres-server" : [ "ab1158bd-1d59-4e2a-9c95-24cc2cfa6edc:27f90844-efab-4b32-8a23-8f85cdc9a256" ] }, "consumer-groups" : [ { "name" : "consumer-group-001", "consumers" : [ "8381a053-433f-4382-bd2a-100fd37a1592", "4b6856ec-ef05-498f-bac6-ef5f0d5f6521" ], "datastores" : [ "ab1158bd-1d59-4e2a-9c95-24cc2cfa6edc:27f90844-efab-4b32-8a23-8f85cdc9a256" ], "properties" : { } } ], "data-processors" : { } } - Eski ana düğümde aşağıdaki
curlkomutunu çalıştırarak eski ana düğümün UUID adresini alın:curl -u sysAdminEmail:password http://node_IP:8084/v1/servers/self
Çıkışın sonunda düğümün UUID'sini şu biçimde görürsünüz:
"type" : [ "postgres-server" ], "uUID" : "599e8ebf-5d69-4ae4-aa71-154970a8ec75"
- Eski yedek düğümün ve yeni ana düğümün IP adreslerini almak için önceki adımı tekrarlayın.
- Eski ana ve bekleme düğümlerini tüketici grubundan kaldırın:
curl -u sysAdminEmail:password -X DELETE \ "http://ms_IP:8080/v1/analytics/groups/ax/axgroup-001/consumer-groups/consumer-group-001/datastores/masterUUID,standbyUUID" -v
axgroup-001 ve consumer-group-001, analiz ve tüketici gruplarının varsayılan adlarıdır. masterUUID,standbyUUID, yukarıdaki mevcut analiz ve tüketici grubu bilgilerini görüntülediğinizde gösterilen sırayla gösterilir. Bunları standbyUUID,masterUUID olarak belirtmeniz gerekebilir.
consumer-groupsiçindatastoresözelliği artık boş olmalıdır. - Eski ana ve bekleme düğümlerini analiz grubundan kaldırın:
curl -u sysAdminEmail:password -X DELETE \ "http://ms_IP:8080/v1/analytics/groups/ax/axgroup-001/servers?uuid=masterUUID,standbyUUID&type=postgres-server" -v
uuidsaltındakipostgres-serverözelliği artık boş olmalıdır. - Analiz ve tüketici gruplarıyla yeni PG ana ve bekleme düğümlerini kaydedin:
curl -u sysAdminEmail:password -X POST -H "Content-Type: application/json" -d '' "http://ms_IP:8080/v1/analytics/groups/ax/axgroup-001/servers?uuid=masterUUID,standbyUUID&type=postgres-server" -v
curl -u sysAdminEmail:password -X POST -H "Content-Type:application/json" -d '' "http://ms_IP:8080/v1/analytics/groups/ax/axgroup-001/consumer-groups/consumer-group-001/datastores?uuid=masterUUID,standbyUUID" -v - Analiz grubunu doğrulayın:
curl -u sysAdminEmail:password http://ms_IP:8080/v1/analytics/groups/ax
Analiz grubunda ve tüketici grubunda listelenen yeni ana ve bekleme düğümlerinin UUID'lerini görmeniz gerekir.
- Edge Yönetim Sunucusu'nu yeniden başlatın:
/opt/apigee/apigee-service/bin/apigee-service edge-management-server restart
- Tüm Qpid sunucularını yeniden başlatın:
/opt/apigee/apigee-service/bin/apigee-service edge-qpid-server restart
- Tüm Postgres sunucularını yeniden başlatın:
/opt/apigee/apigee-service/bin/apigee-service edge-postgres-server restart
- Her iki sunucuda da aşağıdaki komut dosyalarını çalıştırarak replikasyon durumunu doğrulayın. Sistem, başarılı bir replikasyon için her iki sunucuda da aynı sonuçları göstermelidir:
Yeni ana düğümde şu komutu çalıştırın:
/opt/apigee/apigee-service/bin/apigee-service apigee-postgresql postgres-check-master
Ana cihaz olduğunu doğrulayın. Eski bekleme düğümünde:
/opt/apigee/apigee-service/bin/apigee-service apigee-postgresql postgres-check-standby
Bekleme modunda olduğunu doğrulayın.
- Düğümlerin senkronize olduğundan emin olmak için birkaç API isteği yaptıktan sonra önceki adımı tekrarlayın.
- Apigee Edge 4.16.01/4.16.05'i 4.17.09'a güncelleme bölümündeki prosedürü kullanarak eski Postgres ana sunucusunu kullanımdan kaldırın.
Alternatif olarak, Qpid'i eski ana düğümden kaldırıp yeni ana düğüme yükleyebilirsiniz. Qpid'i kaldırdıktan sonra eski ana düğümü kullanımdan kaldırabilirsiniz.
mTLS'yi geri alma
mTLS güncellemesini geri almak için tüm ana makinelerde aşağıdaki adımları uygulayın:
- Apigee'yi durdurma:
apigee-all stop
- mTLS'yi durdurma:
apigee-service apigee-mtls uninstall
- mTLS'yi yeniden yükleme:
apigee-service apigee-mtls install
apigee-service apigee-mtls setup -f /opt/silent.conf