Apigee Edge 4.19.01 sürümünü geri döndür

Edge for Private Cloud 4.19.01 sürümü

Edge 4.19.01 güncellemesi sırasında hatayla karşılaşırsanız ve güncellemeyi tekrar deneyin.

Edge 4.19.01 sürümünü aşağıdaki Özellik Sürümü sürümlerine geri alabilirsiniz:

  • Sürüm 4.18.05
  • Sürüm 4.18.01
  • Sürüm 4.17.09*

* 19.01'den 4.17.09'a geri dönmek için şunları yapmalısınız: Postgres'i geri çekmenin yanı sıra her düğüm için. 4.18.01 veya 4.18.05 sürümüne geri dönerseniz Postgres'i yükseltme olarak geri çekmeniz gerekmez bir Postgres güncellemesi içermiyordu.

Geri alma işlemini uygulayabileceğiniz iki senaryo vardır:

  1. Önceki bir özellik sürümüne geri dönün. Örneğin, 4.19.01 - 18.05.
  2. Aynı sürümde önceki bir güncelleme sürümüne geri dönün. Örneğin, örnek: 4.19.01.02 - 4.19.01.01 arasında.

Daha fazla bilgi için Apigee Edge sürümüne bakın işlemi hakkında daha fazla bilgi edinin.

Geri alma işlemini kimler gerçekleştirebilir?

Geri alma işlemi gerçekleştiren kullanıcı, Edge'i ilk olarak güncelleyen kullanıcıyla aynı olmalıdır veya kök olarak çalıştırılan bir kullanıcı.

Varsayılan olarak Edge bileşenleri "Apigee" kullanıcısı olarak çalışır. Bazı durumlarda Edge'i çalıştırıyor olabilirsiniz bileşenlerine ayıralım. Örneğin, Yönlendiricinin kullanıyorsanız, Yönlendirici'yi root olarak veya bu uygulamalara erişimi olan bir kullanıcı olarak çalıştırmanız bağlantı noktaları. Alternatif olarak, bir bileşeni bir kullanıcı olarak, başka bir bileşeni başka bir kullanıcı olarak çalıştırabilirsiniz.

Ortak koda sahip bileşenler

Aşağıdaki Edge bileşenleri ortak koda sahiptir. Bu nedenle, tahminlerin herhangi birini bir düğümde yer alan tüm bu bileşenleri geri almanız gerekir.

  • edge-management-server (Yönetim Sunucusu)
  • edge-message-processor (Mesaj İşleyen)
  • edge-router (Yönlendirici)
  • edge-postgres-server (Postgres Sunucusu)
  • edge-qpid-server (Qpid Sunucusu)

Örneğin, cihazınızda Yönetim Sunucusu, Yönlendirici ve İleti İşlemci gibi herhangi birini geri çekmek için üçünü de geri çekmeniz gerekir.

Önceki Özellik Sürümüne geri çekme

19.01'den 4.17.09'a geri dönmek için şunları yapmanız gerekir: Postgres'i geri yükleme ve ayrıca her düğüm için. 4.18.01 veya 4.18.05'ten eski sürüme geri dönerseniz Postgres'i yeni sürüme geçirmeniz gerekmez bir Postgres güncellemesi içermiyordu.

Önceki bir Özellik Sürümüne geri dönmek için bileşen:

  1. Uygulamayı yayınlamak istediğiniz sürümün bootstrap.sh dosyasını indirin. geri:

    • 4.18.05 sürümüne geri dönmek için bootstrap_4.18.05.sh uygulamasını indirin:
      curl https://software.apigee.com/bootstrap_4.18.05.sh -o /tmp/bootstrap_4.18.05.sh 
    • 4.18.01 sürümüne geri dönmek için bootstrap_4.18.01.sh uygulamasını indirin:
      curl https://software.apigee.com/bootstrap_4.18.01.sh -o /tmp/bootstrap_4.18.01.sh 
    • 4.17.09 sürümüne geri dönmek için bootstrap_4.17.09.sh uygulamasını indirin:
      curl https://software.apigee.com/bootstrap_4.17.09.sh -o /tmp/bootstrap_4.17.09.sh 
  2. Geri almak için bileşeni durdurun:
    1. Ortak koda sahip bileşenlerden herhangi birini düğümünü değiştirmek için, aşağıdaki örnekte gösterildiği gibi bunların tümünü 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
    2. Düğümdeki herhangi bir başka bileşeni geri çekmek için yalnızca o bileşeni durdurun:
      • /opt/apigee/apigee-service/bin/apigee-service component stop
  3. Para kazanma özelliğini yeniden devre dışı bırakıyorsanız bu özelliği tüm Yönetim Sunucusu ve İletiler'den kaldırın. İşlemci düğümleri:
    /opt/apigee/apigee-service/bin/apigee-service edge-mint-gateway uninstall
  4. Düğümde geri dönmek için bileşeni kaldırın:
    1. Ortak koda sahip bileşenlerden herhangi birini düğümünü kaldırmak için edge-gateway bileşenini kaldırarak hepsini kaldırmanız gerekir grubu oluşturun:
      /opt/apigee/apigee-service/bin/apigee-service edge-gateway uninstall
    2. Düğümdeki başka bir bileşeni geri çekmek için sadece o bileşeni kaldırın. aşağıdaki örnek gösterilmektedir:
      /opt/apigee/apigee-service/bin/apigee-service component uninstall

      Burada component, bileşen adıdır.

    3. Uç Yönlendiriciyi geri çekmek için /opt/nginx/conf.d dosyasına ek olarak edge-gateway bileşen grubu:
      cd /opt/nginx/conf.d
      rm -rf *
  5. apigee-setup uygulamasının 4.19.01 sürümünü kaldırın:
    /opt/apigee/apigee-service/bin/apigee-service apigee-setup uninstall
  6. apigee-service ürününün 4.18.05, 4.18.01 veya 4.17.09 sürümünü yükleyin ve bağımlılıklarını öğrendiniz. Aşağıdaki örnekte, apigee-service:
    sudo bash /tmp/bootstrap_4.17.09.sh apigeeuser=uName apigeepassword=pWord

    Burada uName ve pWord, aldığınız kullanıcı adı ve şifredir oluşturuyor. pWord öğesini atlarsanız bunu girmeniz istenir.

    Hata alırsanız ilgili adımda bootstrap.sh dosyasını indirdiğinizden emin olun 1.

  7. apigee-setup uygulamasını yükleyin:
    /opt/apigee/apigee-service/bin/apigee-service apigee-setup install
  8. 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 yüklenecek bileşendir. dosyanın yapılandırma dosyasını kullanabilirsiniz.

  9. Qpid'i geri döndürüyorsanız iptables'ı temizleyin:
    sudo iptables -F
  10. Geri döndürdüğünüz bileşeni barındıran her düğüm için bu işlemi tekrarlayın.

19.01'den 4.17.09'a geri dönmek için şunları yapmanız gerekir: Postgres'i geri yükleme ve ayrıca her düğüm için. 4.18.01 veya 4.18.05'ten eski sürüme geri dönerseniz Postgres'i yeni sürüme geçirmeniz gerekmez bir Postgres güncellemesi içermiyordu.

Önceki güncelleme sürümüne geri döndür

Bir bileşeni sürümün belirli bir sürümüne geri çekmek için her düğümde aşağıdakileri yapın bileşeni içeren bir kod içerir:

  1. İlgili bileşen sürümünü indirin:
    /opt/apigee/apigee-service/bin/apigee-service component_version install

    Burada component_version bileşen bileşen ve yüklenecek sürümü belirtir. Örneğin, örnek:

    /opt/apigee/apigee-service/bin/apigee-service edge-ui-4.17.09-0.0.3749 install

    Apigee online deposunu kullanıyorsanız mevcut bileşeni belirleyebilirsiniz sürümünü kullanabilirsiniz:

    yum --showduplicates list comp

    Örneğin:

    yum --showduplicates list edge-ui
  2. Bileşeni yüklemek için apigee-setup komutunu 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üklerken bileşenin adını değil, yalnızca bileşen adını belirttiğinizi unutmayın.

  3. Geri döndürdüğünüz bileşeni barındıran her düğüm için bu işlemi tekrarlayın.

19.01'den 4.17.09'a geri dönmek için şunları yapmalısınız: Postgres'i geri yükleme ve ayrıca her düğüm için. 4.18.01 veya 4.18.05'ten eski sürüme geri dönerseniz Postgres'i yeni sürüme geçirmeniz gerekmez bir Postgres güncellemesi içermiyordu.

Postgres 9.6 güncellemesini geri alma

4.17.09 sürümünden 4.19.01 sürümüne yeni sürüme geçtiyseniz Edge bileşenlerine ek olarak Postgres güncellemesi.

Ana bekleme yapılandırmasında Postgres'i güncellerken Postgres güncellemesini geri almak için:

  • Postgres ustası olmak için yeni bekleme düğümünü tanıtın. Yeni Postgres ustası, önceki Edge yüklemenizle aynı sürüm olmalıdır.
  • Eski bekleme düğümünü, yeni ana örneğin bekleme düğümü olacak şekilde 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ına kaydedin.

Geri alma işlemini bitirdiğinizde eski ana düğüme artık gerek kalmaz. Şunları yapabilirsiniz: Ardından eski ana düğümü devre dışı bırakın.

  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 şunu 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'i başlatın:
    /opt/apigee/apigee-service/bin/apigee-service edge-qpid-server start
  4. Yeni bekleme düğümünü Postgres ana ustası olarak tanıtın:
    1. Yeni bekleme düğümünü yeni ana düğüm olarak tanıtın:
      apigee-service apigee-postgresql promote-standby-to-master new_standby_IP

      İstenirse 'Apigee' için Postgres şifresini girin (varsayılan olarak etkindir) "postgres".

    2. Edge'in geçerli sürümünü yüklemek için kullandığınız yapılandırma dosyasını düzenleyerek şu:
      # 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 derleyin:
    1. Edge'in geçerli sürümünü yüklemek için kullandığınız yapılandırma dosyasını düzenleyerek şu:
      # 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 örneğin 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. Şunu görüntüleyerek yeni bekleme düğümünün eklendiğini doğrulayın: Yeni ana slaytta /opt/apigee/apigee-postgresql/conf/pg_hba.conf dosyası var.
  7. Aşağıdaki komutu çalıştırarak analizleri ve tüketici grubu bilgilerini görüntüleyin Yönetim Sunucusu'nda:
    curl -u sysAdminEmail:password http://ms_IP:8080/v1/analytics/groups/ax

    Bu komut, name alanındaki Analytics grubu adını ve consumer-groups altındaki name alanında tüketici grubu adını girin. Aynı zamanda postgres-server alanına ve datastores alanına girilmelidir. Burada şu şekilde çıktı:

    {
      "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. Aşağıdaki curl komutunu çalıştırarak eski ana örneğin UUID adresini alın yeni ana düğüme gidin:
    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"
  9. Eski bekleme düğümünün ve yeni bekleme düğümünün IP adreslerini almak için önceki adımı tekrarlayın ana.
  10. Eski ana düğümleri ve beklemedeki 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ı. masterUUID,standbyUUID, kendileriyle aynı sırada Yukarıdaki mevcut analiz ve tüketici grubu bilgilerini görüntülediğinizde yukarıda göründüğünü fark ettiniz. Siz bunları standbyUUID,masterUUID olarak belirtmesi gerekebilir.

    consumer-groups için datastores özelliği artık şu şekilde olmalıdır: boştur.

  11. Eski ana düğümleri 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ına yeni PG ana ve bekleme düğümleri 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

    Analiz grubunda yeni ana düğüm ve bekleme düğümlerinin UUID'lerinin listelendiğini göreceksiniz ve tüketici grubu temel alınır.

  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ı çalıştırarak çoğaltma durumunu doğrulayın. Sistem Çoğaltmanın başarılı olmasını sağlamak için her iki sunucuda da aynı sonuçları görüntülemelidir:

    Yeni ana slaytta şu komutu çalıştırın:

    /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql postgres-check-master

    Bunun ana sayfa olduğunu doğrulayın. Eski bekleme düğümünde:

    /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql postgres-check-standby

    Cihazın bekleme modunda olduğunu doğrulayın.

  18. Düğümlerin senkronize edin.
  19. Aşağıdaki prosedürü kullanarak eski Postgres anasını görevden kaldırın Apigee Edge'i güncelleyin 4.16.01/4.16.05 ila 4.17.09.

    Alternatif olarak, Qpid'i eski ana makineden kaldırabilir ve Qpid'i yeni ana düğüme yükleyin. Qpid'i kaldırdıktan sonra, eski ana düğüme gidin.

Qpid'i eski ana makineden kaldırın ve Qpid'i yeni ana makineye yükleyin

Qpid'i eski ana slayttan kaldırmak ve yeni ana makineye yüklemek için:

  1. İleti İşleyenlerin, eski ana makine üzerindeki Qpid bağlantı noktası 5672'ye erişimini şu şekilde engelleyin: tüm İleti İşlemcilerinde aşağıdaki komutu çalıştırarak:
    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. Yapamayacağınız işlemler: bekleyen tüm iletileri işleyene kadar Qpid'i kaldırın:
    qpid-stat -q

    Bu komut, msg, msgIn, and msgOut için sayı içeren bir tablo gösterir. Şu durumlarda tüm iletiler işlenecek: msg=0, ve msgIn=msgOut.

  3. Aşağıdaki komutu aşağıdaki komutu çalıştırarak eski ana makinedeki Qpid sunucusunun UUID'sini belirleyin: tekrarlamanız gerekir. Bu bilgileri, prosedürün sonraki aşamalarında kullanmak üzere kaydedin:
    curl -u sysAdminEmail:password http://node_IP::8083/v1/servers/self
  4. Eski ana öğede Qpid'i 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 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
  7. Eski Qpid sunucusunu Zookeeper'dan kaldırın:
    curl -u sysAdminEmail:password -X DELETE \
      http://ms_IP:8080/v1/servers/qpid_UUID
  8. Qpid'i yeni ana öğeye yükleyin:
    /opt/apigee/apigee-setup/bin/setup.sh -p qs -f configFile
  9. Aşağıdaki komutu aşağıdaki komutu çalıştırarak yeni ana makinedeki Qpid sunucusunun UUID'sini belirleyin: yeni ana öğreteceğim. Bu bilgileri, prosedürün sonraki aşamalarında kullanmak üzere kaydedin:
    curl -u sysAdminEmail:password
      http://node_IP::8083/v1/servers/self
  10. 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
  11. Tüm Mesaj İşleyicilerini 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

    Şundan emin olun: msg, msgIn ve msgOut Qpid sunucusu iletileri işlerken güncellenir.

Eski sürüme dönerken sorun yaşarsanız Apigee Edge Destek Ekibi ile iletişime geçin.