Edge 4.51.00'a 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 sürümü sürümlerine geri döndürebilirsiniz:
- 4.50.00 sürümü
- Sürüm 4.19.06
Geri alma işlemini gerçekleştirmek isteyebileceğiniz iki senaryo vardır:
- Önceki bir özellik sürümüne geri dönün. Örneğin, 4.51.00 yerine 4.50.00.
- Aynı sürümdeki önceki bir güncelleme sürümüne geri dönün. Örneğin, 4.50.00.02 yerine 4.50.00.01.
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ı veya root olarak çalışan bir kullanıcı olmalıdır.
Edge bileşenleri varsayılan olarak "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'den düşük olanlar gibi ayrıcalıklı bağlantı noktalarına erişmesi gerekiyorsa yönlendiriciyi root olarak veya bu bağlantı noktalarına erişimi olan bir kullanıcı olarak çalıştırmanız gerekir. Dilerseniz bir bileşeni bir kullanıcı olarak, diğer bileşeni ise başka bir kullanıcı olarak çalıştırabilirsiniz.
Ortak kod içeren bileşenler
Aşağıdaki Edge bileşenleri ortak kod paylaşır. Bu nedenle, bir düğümdeki bu bileşenlerden herhangi birini geri almak için söz konusu düğümdeki bu bileşenlerin tümünü 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 İleti İşleyen yüklüyse bunlardan 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 yüklemek istediğiniz sürümün
bootstrap.sh
dosyasını indirin:- 4.50.00 sürümüne geri dönmek için
bootstrap_4.50.00.sh
sürümü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.sh
dosyası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
- Bileşenin geri alınmasını durdurun:
- Noddaki ortak kod içeren 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
- Noddaki ortak kod içeren bileşenlerden herhangi birini geri almak için aşağıdaki örnekte gösterildiği gibi hepsini durdurmanız gerekir:
- Para Kazanma özelliğini geri alıyorsanız tüm Yönetim Sunucusu ve Mesaj İşlemcisi düğümlerinden kaldırın:
/opt/apigee/apigee-service/bin/apigee-service edge-mint-gateway uninstall
- Düğümde geri alma işlemi yapmak için bileşeni kaldırın:
- Düğümdeki ortak kod içeren bileşenlerden herhangi birini geri almak için aşağıdaki örnekte gösterildiği gibi
edge-gateway
bileşen grubunu kaldırarak bunların tümünü 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
Burada component, bileşen adıdır.
- Edge Router'ı geri almak için
edge-gateway
bileşen grubunu kaldırmanın yanı sıra/opt/nginx/conf.d
dosyasının içeriğini de silmeniz gerekir:cd /opt/nginx/conf.d
rm -rf *
- Düğümdeki ortak kod içeren bileşenlerden herhangi birini geri almak için aşağıdaki örnekte gösterildiği gibi
apigee-setup
'ın 4.51.00 sürümünü kaldırın:/opt/apigee/apigee-service/bin/apigee-service apigee-setup uninstall
apigee-service
yardı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 örnekte,apigee-service
'ın 4.50.00 sürümü yüklenir:sudo bash /tmp/bootstrap_4.50.00.sh apigeeuser=uName apigeepassword=pWord
Burada uName ve pWord, Apigee'den aldığınız kullanıcı adı ve şifredir. pWord öğesini atlarsanız girmeniz istenir.
Hata alırsanız 1. adımda
bootstrap.sh
dosyasını indirdiğinizden emin olun.apigee-setup
'ı 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şen, configFile ise eski sürümün yapılandırma dosyanızdır.
- Qpid'i geri çekiyorsanız iptables'i 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 sürümüne 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
Burada 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 mevcut bileşen sürümlerini belirleyebilirsiniz:
yum --showduplicates list comp
Örneğin:
yum --showduplicates list edge-ui
- Bileşeni yüklemek için
apigee-setup
'ü kullanı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 yalnızca bileşen adını belirtmeniz gerektiğini, sürümü belirtmeniz gerekmediğini 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-bekleme yapılandırmasında güncellerken Postgres güncellemesini geri almak için:
- Yeni yedek düğümü, Postgres ana düğümü olacak şekilde yükseltin. Yeni Postgres ana makinesi, önceki Edge yüklemenizle aynı sürüm olacaktır.
- Eski yedek düğümü yeni ana düğümün yedek düğümü olacak şekilde yapılandırın. Eski yedek düğüm, önceki Edge yüklemenizle aynı sürüm olacaktır.
- Yeni ana ve yedek düğümleri analiz ve tüketici gruplarına kaydedin.
Geri alma işlemini tamamladığınızda eski ana düğüm artık gerekli olmaz. Ardından eski ana düğümü devre dışı bırakabilirsiniz.
- Yeni yedek Postgres düğümünün çalıştığından emin olun:
/opt/apigee/apigee-service/bin/apigee-all status
Postgres çalışmıyorsa çalıştırın:
/opt/apigee/apigee-service/bin/apigee-all start
- Eski ana düğümde ve eski yedek düğümde Postgres'in 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 yedek düğümde Qpid'i başlatın:
/opt/apigee/apigee-service/bin/apigee-service edge-qpid-server start
- Yeni yedek düğümü Postgres ana düğümü olarak tanıtın:
- Yeni yedek düğümü yeni ana olarak tanıtın:
apigee-service apigee-postgresql promote-standby-to-master new_standby_IP
İstenirse "apigee" kullanıcısı için Postgres şifresini girin. Varsayılan olarak "postgres" değerini alır.
- 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 new master: PG_MASTER=new_standby_IP # IP address of the old standby node PG_STANDBY=old_standby_IP
- Yeni ana sayfayı yapılandırın:
/opt/apigee/apigee-service/bin/apigee-service apigee-postgresql setup-replication-on-master -f configFile
- Yeni yedek düğümü yeni ana olarak tanıtın:
- Eski yedek düğümü daha yeni bir sürüme yükselttiyseniz öncelikle eski yedek düğümdeki Apigee yazılımını eski bir sürüme indirmeniz gerekir. Eski bekleme düğümünde hâlâ eski sürüm varsa 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
- Postgres'i eski yedek düğümden kaldırın:
apigee-service apigee-postgresql uninstall apigee-service edge-postgres-server uninstall
- Eski yedek düğümden Postgres veri dizinini silin:
cd /opt/apigee/data/apigee-postgresql/pgdata > rm -rf *
- Eski yedek düğümde eski sürüm bootstrap'u (geri döndüğünüz Apigee sürümü için) indirip çalıştırın. Uygulanacak adımlar, internet tabanlı veya çevrimdışı kurulum kullandığınıza bağlı olarak değişiklik gösterebilir. Eski sürüm Apigee bootstrap çalıştırıldığında yum depoları eski sürüm Apigee verileriyle ayarlanır.
- 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 çekilip çekilmediğini kontrol edin:
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:
- 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 new master: PG_MASTER=new_standby_IP # IP address of the old standby node PG_STANDBY=old_standby_IP
- Eski yedek düğümdeki veri dizinini kaldırın:
cd /opt/apigee/data/apigee-postgresql/pgdata > rm -rf *
- Eski yedek düğümü yeni ana düğümün yedek düğümü olacak şekilde yeniden yapılandırın:
/opt/apigee/apigee-service/bin/apigee-service apigee-postgresql setup-replication-on-standby -f configFile
- Eski yedek düğümde 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-service edge-postgres-server start
- 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:
- Yeni ana makinedeki
/opt/apigee/apigee-postgresql/conf/pg_hba.conf
dosyasını görüntüleyerek yeni yedek düğümün eklendiğini doğrulayın. - Yönetim sunucusunda aşağıdaki komutu çalıştırarak geçerli analiz ve tüketici grubu bilgilerini görüntüleyin:
curl -u sysAdminEmail:password http://ms_IP:8080/v1/analytics/groups/ax
Bu komut,
name
alanındaki analiz grubu adını veconsumer-groups
altındakiname
alanındaki tüketici grubu adını döndürür. Ayrıca, eski Postgres ana ve yedek düğümlerinin UUID'lerinipostgres-server
alanında vedatastores
alanında döndürür. Şu çıkışı göreceksiniz:{ "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
curl
komutunu ç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 yedek düğümleri 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
Burada axgroup-001 ve consumer-group-001, analiz ve tüketici gruplarının varsayılan adlarıdır. masterUUID,standbyUUID, mevcut analizleri ve tüketici grubu bilgilerini yukarıda görüntülediğinizde görünen sırayla Bunları standbyUUID,masterUUID olarak belirtmeniz gerekebilir.
consumer-groups
içindatastores
özelliği artık boş olmalıdır. - Eski ana ve yedek düğümleri 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
uuids
altındakipostgres-server
özelliği artık boş olmalıdır. - Yeni PG ana ve yedek düğümlerini analiz ve tüketici gruplarına 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
Analizler grubunda ve tüketici grubunda yeni ana ve yedek düğümlerin UUID'lerini göreceksiniz.
- Edge Yönetim Sunucusunu 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 çoğaltma durumunu doğrulayın. Sistem, başarılı bir kopyalama sağlamak için her iki sunucuda da aynı sonuçları göstermelidir:
Yeni ana slaytta şunları çalıştırın:
/opt/apigee/apigee-service/bin/apigee-service apigee-postgresql postgres-check-master
Ana cihaz olduğunu doğrulayın. Eski yedek düğümde:
/opt/apigee/apigee-service/bin/apigee-service apigee-postgresql postgres-check-standby
Bekleme modunda olduğunu doğrulayın.
- Nodların 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 makinesini devre dışı bırakın.
Alternatif olarak, Qpid'i eski ana makineden kaldırıp yeni ana düğüme yükleyebilirsiniz. Qpid'i kaldırdıktan sonra eski ana düğümü devre dışı bırakabilirsiniz.
mTLS'yi geri alma
mTLS güncellemesini geri almak için tüm ana makinelerde aşağıdaki adımları uygulayın:
- Apigee'yi durdurun:
apigee-all stop
- mTLS'yi durdurma:
apigee-service apigee-mtls uninstall
- mTLS'yi yeniden yükleyin:
apigee-service apigee-mtls install
apigee-service apigee-mtls setup -f /opt/silent.conf