4.18.01 Geri Alma İşlemi

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:

  1. Eski bir sürüme geri alma. Örneğin, 4.18.01 ile 4.17.01 arası.
  2. 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.

  1. 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
  2. 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

  3. Yüklüyse eski bekleme düğümünde Qpid'yi başlatın:
    > /opt/apigee/apigee-service/bin/apigee-service edge-qpid-server start
  4. Yeni bekleme düğümünü Postgres ana düğümü olarak yükseltin:
    1. 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.

    2. 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
    3. Yeni ana slaydı yapılandırın:
      > /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql setup-replication-on-master -f configFile
  5. Eski bekleme düğümünü yeniden oluşturun:
    1. 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
    2. Eski bekleme düğümündeki veri dizinini kaldırın:
      > cd /opt/apigee/data/apigee-postgresql/pgdata > rm -rf *
    3. 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
    4. 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
  6. /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.
  7. 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ındaki name alanındaki tüketici grubu adını döndürür. Ayrıca, postgres-server ve datastores 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" : {
      }
    }

  8. 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"

  9. Eski bekleme düğümünün ve yeni ana ağın IP adreslerini almak için önceki adımı tekrarlayın.
  10. 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çin datastores özelliği artık boş olmalıdır.

  11. 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ındaki postgres-server özelliği artık boş olmalıdır.

  12. 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
  13. 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.

  14. Uç Yönetim Sunucusu'nu yeniden başlatın:
    > /opt/apigee/apigee-service/bin/apigee-service edge-management-server restart
  15. Tüm Qpid sunucularını yeniden başlatın:
    > /opt/apigee/apigee-service/bin/apigee-service edge-qpid-server restart
  16. Tüm Postgres sunucularını yeniden başlatın:
    > /opt/apigee/apigee-service/bin/apigee-service edge-postgres-server restart
  17. 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.

  18. Düğümlerin senkronize olduğundan emin olmak için birkaç API isteği yaptıktan sonra önceki adımı tekrarlayın.
  19. 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:

  1. 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
  2. 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 ve msgIn=msgOut olduğunda tüm mesajlar işlenecek.

  3. 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
  4. 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
  5. 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
  6. 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
  7. Eski Qpid sunucusunu Zookeeper'dan kaldırın:
    > curl -u sysAdminEmail:password -X DELETE
      http://ms_IP:8080/v1/servers/qpid_UUID
  8. Yeni ana slayda Qpid'yi yükleyin:
    > /opt/apigee/apigee-setup/bin/setup.sh -p qs -f configFile
  9. 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
  10. 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
  11. Tüm Mesaj İşleyicileri yeniden başlatın:
    > /opt/apigee/apigee-service/bin/apigee-service edge-message-processor restart
  12. 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:

  1. Geri alma işlemini yapmak için bileşeni durdurun:
    1. 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
    2. Düğümdeki başka bir bileşeni geri alıyorsanız sadece o bileşeni durdurun:
      • > apigee-service comp stop
  2. 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
  3. Düğümde geri almak için bileşeni kaldırın:
    1. 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
    2. Düğümdeki başka bir bileşeni geri alacaksanız sadece o bileşeni kaldırın:
      > apigee-service comp uninstall
    3. Yönlendiriciyi eski haline getiriyorsanız /opt/nginx/conf.d içeriğini silmeniz gerekir:
      > cd /opt/nginx/conf.d
      > rm -rf *
  4. Bileşeni geri almak için:
    1. 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
    2. İ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 
    3. 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.

    4. apigee-setup eklentisini yükleme:
      > /opt/apigee/apigee-service/bin/apigee-service apigee-setup install
    5. 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.

    6. Qpid'yi geri alıyorsanız iptables'ı temizleyin:
      > sudo iptables -F
  5. Bileşeni 4.18.01 sürümünün belirli bir sürümüne geri almak için:
    1. İ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
    2. 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.

Eski sürüme geri dönerken sorunlarla karşılaşırsanız Apigee Edge Desteği ile iletişime geçin.