Apigee Edge'in 4.52.01 sürümünü geri alma

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

Edge 4.52.01 sürümünü aşağıdaki ana sürüm sürümlerine geri alabilirsiniz:

  • 4.52.00 sürümü
  • Sürüm 4.51.00

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

  1. Önceki ana veya küçük sürüme geri dönün. Örneğin, 4.52.01 - 4.52.00.
  2. Aynı uoda önceki bir yama sürümüne geri döndür sürüm ekleyebilirsiniz. Örneğin, 4.52.00.02 ile 4.52.00.01 arasında bir değerdir.

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 kod içeren 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 İşleyici)
  • 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 ana veya alt sürüme geri döndür

Önceki ana veya alt sürüme geri dönmek için bileşen:

  1. Geri yüklemek istediğiniz sürümün bootstrap.sh dosyasını indirin:

    • 4.51.00 sürümüne geri dönmek için bootstrap_4.51.00.sh uygulamasını indirin:
      curl https://software.apigee.com/bootstrap_4.51.00.sh -o /tmp/bootstrap_4.51.00.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 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
  4. Düğümde geri dönmek için bileşeni kaldırın:
    1. 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
    2. 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.

    3. Uç Yönlendirici'yi 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.52.01 sürümünü kaldırın:
    /opt/apigee/apigee-service/bin/apigee-service apigee-setup uninstall
  6. apigee-service yardımcı programının 4.51.00 sürümünü ve bağımlılıklarını yükleyin. Aşağıdaki örnekte, apigee-service:
    sudo bash /tmp/bootstrap_4.51.00.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.

Önceki bir yama sürümüne geri döndür

Bir bileşeni belirli bir yama 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, yüklenecek bileşen ve yama sürümüdür. Örneğin, örnek:

    /opt/apigee/apigee-service/bin/apigee-service edge-ui-4.51.05-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.

Postgres 10.17 güncellemesini geri alma

4.50.00 veya 4.51.00 sürümünden 4.52.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:

  • Yeni yedek düğümü, Postgres ana düğümü olacak şekilde yükseltin. 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. Ardından eski ana düğümü devre dışı bırakabilirsiniz.

  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 çalıştırı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ü yeni sürüme zaten yükselttiyseniz eski bekleme düğümünde Apigee yazılımını da eski sürüme geçirmenizi öneririz. Eski sürüm cihazınızda hâlâ eski sürüm bu adımı atlayıp 6. adımla devam edebilirsiniz.
    1. Eski bekleme düğümünde Postgres'i durdurun:
      apigee-service apigee-postgresql stop
      apigee-service edge-postgres-server stop
    2. Postgres'i eski bekleme düğümünden kaldırın:
      apigee-service apigee-postgresql uninstall
      apigee-service edge-postgres-server uninstall
    3. Eski bekleme düğümünden Postgres veri dizinini silin:
      cd /opt/apigee/data/apigee-postgresql/pgdata > rm -rf *
    4. Eski sürüm önyüklemesini indirip çalıştırın (kullandığınız Apigee sürümü için) konumuna getir) gerekir. Uygulanacak adımlar çevrimdışı veya çevrimdışı yükleme olabilir. Apigee bootstrap'inin eski sürümünü çalıştırdığınızda yum depolarını eski Apigee sürüm verileriyle oluşturma
    5. Eski bekleme düğümünde Postgres bileşenlerini ayarlayın:
      /opt/apigee/apigee-setup/bin/setup.sh -p ps -f configFile
    6. Eski bekleme düğümündeki Postgres bileşenlerini kontrol edip doğrulayın eski sürüme geri çekilmiştir:
      apigee-service apigee-postgresql version
      apigee-service edge-postgres-server version
  6. Eski bekleme düğümünü yeniden derleyin:
    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 ö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

      Postgres çalışmıyorsa şunu başlatın:

      /opt/apigee/apigee-service/bin/apigee-service edge-postgres-server start
  7. Ş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.
  8. 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" : {
      }
    }

  9. 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"
  10. Eski bekleme düğümünün ve yeni bekleme düğümünün IP adreslerini almak için önceki adımı tekrarlayın ana.
  11. 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.

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

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

  15. Edge Yönetim Sunucusunu yeniden başlatın:
    /opt/apigee/apigee-service/bin/apigee-service edge-management-server restart
  16. Tüm Qpid sunucularını yeniden başlatın:
    /opt/apigee/apigee-service/bin/apigee-service edge-qpid-server restart
  17. Tüm Postgres sunucularını yeniden başlatın:
    /opt/apigee/apigee-service/bin/apigee-service edge-postgres-server restart
  18. 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 şu komutu çalıştırın:

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

    Dosyanın ana hat 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.

  19. Düğümlerin senkronize edin.
  20. Aşağıdaki prosedürü kullanarak eski Postgres anasını görevden kaldırın Bir Postgres düğümü.

    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üğü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:

  1. Apigee'yi durdurun:
    apigee-all stop
  2. mTLS'yi durdurma:
    apigee-service apigee-mtls uninstall
  3. mTLS'yi yeniden yükleyin:
    apigee-service apigee-mtls install
    apigee-service apigee-mtls setup -f /opt/silent.conf