Edge for Private Cloud 4.18.01 sürümü
Edge 4.18.01 güncellemesi sırasında hata oluşması durumunda, hataya neden olan bileşeni geri alıp güncellemeyi tekrar deneyebilirsiniz. Örneğin, Postgres 9.6'ya yapılan güncelleme başarısız olursa yalnızca Postgres düğümlerini geri alıp güncellemeyi tekrar deneyebilirsiniz.
Geri alma işlemini gerçekleştirmek isteyebileceğiniz iki senaryo vardır:
- Eski bir sürüme geri alma. Örneğin, 4.18.01 ile 4.17.01 arası.
- Aynı sürümdeki eski bir sürüme geri alma.
Her iki senaryoda da geri alma işlemi yapmak için aşağıdaki prosedürü kullanın.
Geri alma işlemini kimler gerçekleştirebilir?
Geri alma işlemini gerçekleştiren kullanıcı, Edge'i ilk kez güncelleyen veya kök olarak çalışan bir kullanıcıyla aynı 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 ayrıcalıklı bağlantı noktalarına (ör. 1.000'in altındakiler) 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 ve başka bir bileşeni 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şulları göz önünde bulundurmanız gerekir:
- Aşağıda listelenen beş Edge bileşeni ortak kodu paylaşır. Bu nedenle, bir düğümdeki beş bileşenden birini geri almak için düğümde yüklü olan beş bileşenden birini geri almanız gerekir. Örneğin, düğümde Yönetim Sunucusu, Yönlendirici ve Mesaj İşleyici yüklüyse bunlardan herhangi birini geri almak için üçünü de geri almanız gerekir.
Kodu paylaşan beş bileşen şunlardır:
- Yönetim Sunucusu
- Yönlendirici
- Mesaj İşleyici
- Qpid Sunucusu
- Postgres Sunucusu
- Edge 4.16.01'den güncelliyorsanız Cassandra'yı geri almayın. Bu Edge 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 eski sürüme dönülüyor
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 bölümden oluşur:
- Postgres güncellemesini geri alma
Her güncelleme prosedürünün son adı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 bekleme yapılandırmasında Postgres'i güncellerken Postgres güncellemesini geri almak için:
- Postgres ustası olmak üzere yeni bekleme düğümünü yükseltin. Yeni Postgres ana kopyası, önceki Edge yüklemenizle aynı sürüm olur.
- Eski bekleme düğümünü yeni ana düğümün bekleme düğümü olarak yapılandırın. Eski bekleme düğümü, önceki Edge yüklemenizle aynı sürüm olacaktır.
- Yeni ana ve bekleme düğümlerini analiz ve tüketici gruplarıyla kaydedin.
Geri alma işlemini bitirdiğinizde, eski ana düğüme artık gerek kalmaz. Ardından eski ana düğümü geçersiz kılabilirsiniz.
- Yeni beklemedeki 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 yapın:
> apigee-service apigee-postgresql promote-standby-to-master new_standby_IP
İstenirse varsayılan olarak "postgres" olan "Apigee" kullanıcısı için Postgres şifresini girin.
- 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 slaydı 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 yapın:
- 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 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
- 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:
/opt/apigee/apigee-postgresql/conf/pg_hba.conf
dosyasını yeni ana düğümde görüntüleyerek yeni bekleme düğümünün eklendiğini doğrulayın.- Yönetim Sunucusu'nda 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,
name
alanındaki analiz grubunun adını,consumer-groups
altındakiname
alanındaki tüketici grubu adını döndürür. Ayrıca,postgres-server
vedatastores
alanındaki eski Postgres ana ve bekleme düğümlerinin UUID'lerini de döndürür. Çıkış şu biçimde görünmelidir:{ "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
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"
- Eski bekleme düğümünün ve yeni ana ağı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 yukarıda göründüğü sıradadır. Bunları standbyUUID,masterUUID olarak belirtmeniz gerekebilir.
consumer-groups
iç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
uuids
altı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
Yeni ana ve beklemedeki düğümlerin UUID'lerinin analiz grubunda ve tüketici grubunda listelendiğini görürsünüz.
- Uç 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ı yayınlayarak çoğaltma durumunu doğrulayın. Çoğaltmanın başarılı olması için sistem her iki sunucuda da aynı sonuçları göstermelidir:
Yeni ana slaytta şu komutu çalıştırın:
> /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql postgres-check-master
Dosyanın ana slayt olduğunu söylediğini doğrulayın. Eski bekleme düğümünde:
> /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql postgres-check-standby
Bekleme olduğunu söylediğini 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 sürümüne güncelleme bölümündeki prosedürü kullanarak eski Postgres ana düğümünü kullanımdan kaldırın.
Alternatif olarak, aşağıda açıklandığı gibi Qpid'yi eski ana düğümden kaldırıp yeni ana düğüme de yükleyebilirsiniz. Qpid'yi kaldırdıktan sonra eski ana düğümü devre dışı bırakabilirsiniz.
Eski ana slayttan Qpid'yi kaldırın ve yeni ana slayda Qpid'yi yükleyin
Qpid'yi eski ana makineden kaldırıp yeni ana makineye yüklemek için aşağıdaki prosedürü uygulayın:
- Aşağıdaki komutu tüm Mesaj İşleyicilerinde çalıştırarak eski ana makinede Qpid bağlantı noktası 5672'ye Mesaj İşleyicilerin 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. Bekleyen tüm mesajları işleyene kadar Qpid'yi kaldıramazsınız:
> qpid-stat -q
Bu komut,
msg, msgIn, and msgOut
sayısını içeren bir tabloyu görüntüler.msg=0
vemsgIn=msgOut
olduğunda tüm mesajlar işlenecek. - Aşağıdaki komutu eski ana makinede çalıştırarak eski ana makinede Qpid sunucusunun UUID'sini belirleyin. Sürecin ilerleyen bölümlerinde kullanmak için bu bilgileri kaydedin:
> curl -u sysAdminEmail:password http://node_IP::8083/v1/servers/self
- Eski ana slaytta Qpid'yi 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ırın:
> /opt/apigee/apigee-service/bin/apigee-service edge-qpid-server uninstall > /opt/apigee/apigee-service/bin/apigee-service apigee-qpidd uninstall
- Eski Qpid sunucusunu analizlerden 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 slayda Qpid'yi yükleyin:
> /opt/apigee/apigee-setup/bin/setup.sh -p qs -f configFile
- Yeni ana makinede aşağıdaki komutu çalıştırarak yeni ana makinede Qpid sunucusunun UUID'sini belirleyin. Sürecin ilerleyen bölümlerinde kullanmak için bu bilgileri kaydedin:
> curl -u sysAdminEmail:password http://node_IP::8083/v1/servers/self
- Yeni Qpid sunucusunu analizler 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şturulup oluşturulmadığını 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 öğelerini güncellediğinizden emin olun.
4.18.01 sürümünden itibaren bağımsız bileşenleri geri almak için
Geri alma işleminin bir parçası olarak, 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.sh
uygulamasını indirin - 4.17.05 sürümüne geri dönmek için
bootstrap_4.17.05.sh
dosyasını indirin - 4.17.01'e geri dönmek için
bootstrap_4.17.01.sh
dosyasını indirin - 4.16.09 sürümüne geri dönmek için
bootstrap_4.16.09.sh
dosyasını indirin - 4.16.05 sürümüne geri dönmek için
bootstrap_4.16.05.sh
dosyasını indirin - 4.16.01'e geri dönmek için
bootstrap.sh
dosyasını indirin
Geri alınacak bileşen barındıran her düğüm için:
- Geri alma işlemini yapmak için bileşeni durdurun:
- Düğümde şu bileşenlerden herhangi birini eski haline getiriyorsanız tümünü durdurmanız gerekir: Yönetim Sunucusu, Yönlendirici, Mesaj İşlemci, 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 sadece o bileşeni durdurun:
> apigee-service comp stop
- Düğümde şu bileşenlerden herhangi birini eski haline getiriyorsanız tümünü durdurmanız gerekir: Yönetim Sunucusu, Yönlendirici, Mesaj İşlemci, Qpid Sunucusu veya Postgres Sunucusu:
- Para kazanma özelliğini eski haline getiriyorsanız bu programı tüm Yönetim Sunucusu ve Mesaj İşleyici düğümlerinden kaldırın:
> apigee-service edge-mint-gateway uninstall
- Düğümde geri almak için bileşeni kaldırın:
- Düğümde şu bileşenlerden herhangi birini eski haline getiriyorsanız tümünü kaldırın: Yönetim Sunucusu, Yönlendirici, İleti İşlemci, Qpid Sunucusu veya Postgres Sunucusu:
> apigee-service edge-gateway uninstall
- Düğümdeki başka bir bileşeni geri alacaksanız sadece o bileşeni kaldırın:
> apigee-service comp uninstall
- Yönlendiriciyi eski haline getiriyorsanız
/opt/nginx/conf.d
içeriğini silmeniz gerekir:> cd /opt/nginx/conf.d > rm -rf *
- Düğümde şu bileşenlerden herhangi birini eski haline getiriyorsanız tümünü kaldırın: Yönetim Sunucusu, Yönlendirici, İleti İşlemci, Qpid Sunucusu veya Postgres Sunucusu:
-
Bileşeni geri almak için:
apigee-setup
ürününün 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-service
yardı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
Bu bölümde uName ve pWord, Apigee'den aldığınız kullanıcı adı ve şifredir. pWord yönergesini çıkarırsanız bu değeri girmeniz istenir.
apigee-setup
eklentisini yükleme:> /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şen, configFile ise istenen sürüm için yapılandırma dosyanızdır.
- Qpid'yi 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:
- İlgili 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 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
uygulamasını 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ı belirtmeyi unutmayın.
- İlgili bileşen sürümünü indirin:
Eski sürüme geri dönerken sorunlarla karşılaşırsanız Apigee Edge Desteği ile iletişime geçin.