Edge for Private Cloud 4.18.01 sürümü
Edge 4.18.01 güncellemesi sırasında bir hata oluşursa hataya neden olan bileşeni geri alabilir ve güncellemeyi tekrar deneyebilirsiniz. Örneğin, Postgres 9.6 güncellemesi başarısız olursa yalnızca Postgres düğümlerini geri alabilir ve güncellemeyi tekrar deneyebilirsiniz.
Geri alma işlemi yapmak isteyebileceğiniz iki senaryo vardır:
- Daha eski bir sürüme geri dönme Örneğin, 4.18.01'den 4.17.01'e.
- Aynı sürümdeki daha eski bir sürüme geri dönme.
Her iki senaryoda da geri alma işlemi gerçekleştirmek için aşağıdaki prosedürü kullanın.
Geri alma işlemini kimler yapabilir?
Geri alma işlemini gerçekleştiren kullanıcı, Edge'i ilk güncelleyen kullanıcı veya kök 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.
Hangi bileşenler geri alınabilir?
Geri alma işlemi gerçekleştirirken aşağıdaki koşullara dikkat etmeniz gerekir:
- Aşağıda listelenen beş Edge bileşeni ortak kod paylaşır. Bu nedenle, bir düğümdeki beş bileşenden herhangi birini geri almak için düğümde yüklü olan beş bileşenden herhangi birini geri almanız gerekir. Ö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.
Kod paylaşan beş bileşen şunlardır:
- Yönetim Sunucusu
- Yönlendirici
- Mesaj İşleyici
- Qpid Sunucusu
- Postgres Server
- Edge 4.16.01'den güncelleme yapıyorsanız Cassandra'yı geri almayın. Edge'in bu sürümü, Cassandra'nın güncellenmiş bir sürümünü içerir. Herhangi bir bileşeni geri alırsanız Cassandra'yı 4.18.01 sürümünde bırakın.
4.18.01 sürümüne geri dönme
Bu bölümde, Edge 4.18.01'i önceki bir sürüme geri alma prosedürü yer alır. Bu bölüm iki kısma ayrılmıştır:
- Postgres güncellemesini geri alma
Her güncelleme prosedürünün son bölümü, Postgres düğümlerini 9.6 sürümüne güncellemektir. Bu güncelleme başarısız olursa güncellemeyi geri almak için bu prosedürü kullanabilirsiniz. - Diğer tüm Edge bileşenlerini geri alma
Diğer Edge bileşenlerini geri almak için bu prosedürü kullanın.
Postgres 9.6 güncellemesini geri almak için
Ana-yedek yapılandırmasında Postgres'i 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 bekleme 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ü 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
Ç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 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 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
Burada 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 sağlamak 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. Bu işlem aşağıda açıklanmıştır. Qpid'i kaldırdıktan sonra eski ana düğümü kullanımdan kaldırabilirsiniz.
Qpid'i eski ana sunucudan kaldırın ve yeni ana sunucuya yükleyin.
Qpid'i eski ana sunucudan kaldırıp yeni ana sunucuya yüklemek için aşağıdaki prosedürü kullanın:
- Tüm Mesaj İşleyicilerde aşağıdaki komutu çalıştırarak Mesaj İşleyicilerin eski ana düğümdeki Qpid bağlantı noktası 5672'ye erişimini engelleyin:
> iptables -A OUTPUT -p tcp -d 10.233.147.20 --dport 5672 -j DROP
- Aşağıdaki komutu çalıştırarak Qpid mesaj sırasının boş olduğundan emin olun. Qpid, bekleyen tüm mesajları işleyene kadar Qpid'yi kaldıramazsınız:
> qpid-stat -q
Bu komut,
msg, msgIn, and msgOutsayısını içeren bir tablo gösterir.msg=0vemsgIn=msgOutolduğunda tüm mesajlar işlenmiş olur. - Eski ana sunucuda aşağıdaki komutu çalıştırarak eski ana sunucudaki Qpid sunucusunun UUID'sini belirleyin. Bu bilgileri daha sonra kullanmak üzere kaydedin:
> curl -u sysAdminEmail:password http://node_IP::8083/v1/servers/self
- Eski ana düğümde Qpid'i durdurun:
> /opt/apigee/apigee-service/bin/apigee-service edge-qpid-server stop > /opt/apigee/apigee-service/bin/apigee-service apigee-qpidd stop
- Qpid sunucusunu kaldırma:
> /opt/apigee/apigee-service/bin/apigee-service edge-qpid-server uninstall > /opt/apigee/apigee-service/bin/apigee-service apigee-qpidd uninstall
- Eski Qpid sunucusunu analiz ve tüketici gruplarından kaldırın:
> curl -u sysAdminEmail:password -X DELETE -H "Content-Type: application/json" -d '' "http://ms_IP:8080/v1/analytics/groups/ax/axgroup-001/consumer-groups/consumer-group-001/consumers/qpid_UUID" -v > curl -u sysAdminEmail:password -X DELETE "http://ms_IP:8080/v1/analytics/groups/ax/axgroup-001/servers?uuid=qpid_UUID&type=qpid-server" -v
- Eski Qpid sunucusunu Zookeeper'dan kaldırın:
> curl -u sysAdminEmail:password -X DELETE http://ms_IP:8080/v1/servers/qpid_UUID
- Yeni ana sunucuya Qpid'i yükleyin:
> /opt/apigee/apigee-setup/bin/setup.sh -p qs -f configFile
- Yeni ana sunucuda aşağıdaki komutu çalıştırarak yeni ana sunucudaki Qpid sunucusunun UUID'sini belirleyin. Bu bilgileri daha sonra kullanmak üzere kaydedin:
> curl -u sysAdminEmail:password http://node_IP::8083/v1/servers/self
- Yeni Qpid sunucusunu 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=qpid_UUID&type=qpid-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/consumers?uuid=qpid_UUID" -v
- Tüm Mesaj İşleyicileri yeniden başlatın:
> /opt/apigee/apigee-service/bin/apigee-service edge-message-processor restart
- Sıraların oluşturulduğunu kontrol etmek için yeni Qpid sunucusunda aşağıdaki komutu çalıştırın:
> qpid-stat -q
Qpid sunucusu mesajları işlerken
msg, msgIn ve msgOut değerlerinin güncellendiğini doğrulayın.
4.18.01 sürümündeki bileşenleri tek tek geri almak için
Geri alma işlemini gerçekleştirirken Edge'in mevcut sürümü için bootstrap.sh dosyasını indirmeniz gerekir:
- 4.17.09 sürümüne geri dönmek için
bootstrap_4.17.09.shdosyasını indirin. - 4.17.05 sürümüne geri dönmek için
bootstrap_4.17.05.shdosyasını indirin. - 4.17.01 sürümüne geri dönmek için
bootstrap_4.17.01.shdosyasını indirin. - 4.16.09 sürümüne geri dönmek için
bootstrap_4.16.09.shdosyasını indirin. - 4.16.05 sürümüne geri dönmek için
bootstrap_4.16.05.shdosyasını indirin. - 4.16.01 sürümüne geri dönmek için
bootstrap.shdosyasını indirin.
Geri alınacak bileşeni barındıran her düğüm için:
- Geri alınacak bileşeni durdurun:
- Düğümde aşağıdaki bileşenlerden herhangi birini geri alıyorsanız hepsini durdurmanız gerekir: Yönetim Sunucusu, Yönlendirici, Mesaj İşlemcisi, Qpid Sunucusu veya Postgres Sunucusu:
> apigee-service edge-management-server stop
> apigee-service edge-router stop
> apigee-service edge-message-processor stop
> apigee-service edge-qpid-server stop
> apigee-service edge-postgres-server stop
- Düğümdeki başka bir bileşeni geri alıyorsanız yalnızca o bileşeni durdurun:
> apigee-service comp stop
- Düğümde aşağıdaki bileşenlerden herhangi birini geri alıyorsanız hepsini durdurmanız gerekir: Yönetim Sunucusu, Yönlendirici, Mesaj İşlemcisi, Qpid Sunucusu veya Postgres Sunucusu:
- Para Kazanma'yı geri alıyorsanız tüm Yönetim Sunucusu ve Mesaj İşleyici düğümlerinden kaldırın:
> apigee-service edge-mint-gateway uninstall
- Düğümde geri alma işlemi yapmak için bileşeni kaldırın:
- Düğümde aşağıdaki bileşenlerden herhangi birini geri alıyorsanız hepsini kaldırın: Yönetim Sunucusu, Yönlendirici, Mesaj İşlemcisi, Qpid Sunucusu veya Postgres Sunucusu:
> apigee-service edge-gateway uninstall
- Düğümdeki başka bir bileşeni geri alıyorsanız yalnızca o bileşeni kaldırın:
> apigee-service comp uninstall
- Yönlendiriciyi geri alıyorsanız
/opt/nginx/conf.ddizininin içeriğini silmeniz gerekir:> cd /opt/nginx/conf.d > rm -rf *
- Düğümde aşağıdaki bileşenlerden herhangi birini geri alıyorsanız hepsini kaldırın: Yönetim Sunucusu, Yönlendirici, Mesaj İşlemcisi, Qpid Sunucusu veya Postgres Sunucusu:
-
Bileşeni geri almak için:
apigee-setup'in 4.18.01 sürümünü kaldırın:> /opt/apigee/apigee-service/bin/apigee-service apigee-setup uninstall
- İstediğiniz sürüm için bootstrap.sh dosyasını indirin: Örneğin, 4.16.09 için:
> curl https://software.apigee.com/bootstrap_4.16.09.sh -o /tmp/bootstrap_4.16.09.sh
- 4.16.01, 4.16.05 veya 4.16.09
apigee-serviceyardımcı programını ve bağımlılıklarını yükleyin. Örneğin, 4.16.09 için:> sudo bash /tmp/bootstrap_4.16.09.sh apigeeuser=uName apigeepassword=pWord
Burada uName ve pWord, Apigee'den aldığınız kullanıcı adı ve şifredir. pWord parametresini atlarsanız bu parametreyi girmeniz istenir.
apigee-setupuygulamasını yükleyin:> /opt/apigee/apigee-service/bin/apigee-service apigee-setup install
- Bileşenin istediğiniz sürümünü yükleyin:
> /opt/apigee/apigee-setup/bin/setup.sh -p comp -f configFile
Burada comp, yüklenecek bileşeni, configFile ise istediğiniz sürümün yapılandırma dosyasını ifade eder.
- Qpid'i geri alıyorsanız iptables'ı temizleyin:
> sudo iptables -F
- Bileşeni 4.18.01 sürümünün belirli bir sürümüne geri almak için:
- Belirli bileşen sürümünü indirin:
> /opt/apigee/apigee-service/bin/apigee-service comp-version install
Burada comp-version, yüklenecek bileşen ve sürümdür. Örneğin:
> /opt/apigee/apigee-service/bin/apigee-service edge-ui-4.17.09-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 yalnızca bileşen adını belirttiğinize dikkat edin.
- Belirli bileşen sürümünü indirin:
Geri alma işlemi sırasında sorun yaşarsanız Apigee Edge Destek Ekibi ile iletişime geçin.