Apigee Edge 4.51.00 sürümünü geri yükle

Edge 4.51.00'a güncelleme sırasında bir hatayla karşılaşırsanız hataya neden olan bileşeni geri alıp güncellemeyi tekrar deneyebilirsiniz.

Edge 4.51.00'ı aşağıdaki özellik sürümü sürümlerine geri döndürebilirsiniz:

  • 4.50.00 sürümü
  • Sürüm 4.19.06

Geri alma işlemini gerçekleştirmek isteyebileceğiniz iki senaryo vardır:

  1. Önceki bir özellik sürümüne geri dönün. Örneğin, 4.51.00 yerine 4.50.00.
  2. Aynı sürümdeki önceki bir güncelleme sürümüne geri dönün. Örneğin, 4.50.00.02 yerine 4.50.00.01.

Daha fazla bilgi için Apigee Edge sürüm süreci başlıklı makaleyi inceleyin.

Kimler geri alma işlemi gerçekleştirebilir?

Geri alma işlemini gerçekleştiren kullanıcı, Edge'i ilk güncelleyen kullanıcıyla aynı veya root olarak çalışan bir kullanıcı olmalıdır.

Edge bileşenleri varsayılan olarak "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'den düşük olanlar gibi ayrıcalıklı bağlantı noktalarına erişmesi gerekiyorsa yönlendiriciyi root olarak veya bu bağlantı noktalarına erişimi olan bir kullanıcı olarak çalıştırmanız gerekir. Dilerseniz bir bileşeni bir kullanıcı olarak, diğer bileşeni ise başka bir kullanıcı olarak çalıştırabilirsiniz.

Ortak kod içeren bileşenler

Aşağıdaki Edge bileşenleri ortak kod paylaşır. Bu nedenle, bir düğümdeki bu bileşenlerden herhangi birini geri almak için söz konusu düğümdeki bu bileşenlerin tümünü 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, düğümde Yönetim Sunucusu, Yönlendirici ve İleti İşleyen yüklüyse bunlardan birini geri almak için üçünü de geri almanız gerekir.

Önceki bir özellik sürümüne geri dönme

Önceki bir özellik sürümüne geri dönmek için bileşeni barındıran her düğümde aşağıdakileri yapın:

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

    • 4.50.00 sürümüne geri dönmek için bootstrap_4.50.00.sh sürümünü indirin:
      curl https://software.apigee.com/bootstrap_4.50.00.sh -o /tmp/bootstrap_4.50.00.sh 
    • 4.19.06 sürümüne geri dönmek için bootstrap_4.19.06.sh dosyasını indirin:
      curl https://software.apigee.com/bootstrap_4.19.01.sh -o /tmp/bootstrap_4.19.01.sh 
  2. Bileşenin geri alınmasını durdurun:
    1. Noddaki ortak kod içeren bileşenlerden herhangi birini geri almak için aşağıdaki örnekte gösterildiği gibi hepsini 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 diğer bileşenleri geri almak için yalnızca ilgili 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 alma işlemi yapmak 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. Edge Router'ı geri almak için edge-gateway bileşen grubunu kaldırmanın yanı sıra /opt/nginx/conf.d dosyasının içeriğini de silmeniz gerekir:
      cd /opt/nginx/conf.d
      rm -rf *
  5. apigee-setup'ın 4.51.00 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.19.06 veya 4.50.00 sürümünü ve bağımlılıklarını yükleyin. Aşağıdaki örnekte, apigee-service'ın 4.50.00 sürümü yüklenir:
    sudo bash /tmp/bootstrap_4.50.00.sh apigeeuser=uName apigeepassword=pWord

    Burada uName ve pWord, Apigee'den aldığınız kullanıcı adı ve şifredir. pWord öğesini atlarsanız girmeniz istenir.

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

  7. apigee-setup'ı 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 eski sürümün yapılandırma dosyanızdır.

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

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

Bir bileşeni bir sürümün belirli bir sürümüne geri almak için bileşeni barındıran her düğümde aşağıdakileri yapın:

  1. Belirli 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 güncelleme sürümüdür. Örneğin:

    /opt/apigee/apigee-service/bin/apigee-service edge-ui-4.18.05-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'ü 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ı belirtmeniz gerektiğini, sürümü belirtmeniz gerekmediğini unutmayın.

  3. Geri aldığı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.19.06 veya 4.50.00 sürümünden 4.51.00 sürümüne yükselttiyseniz Edge bileşenlerine ek olarak Postgres güncellemenizi de geri almanız gerekir.

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

  • Yeni yedek düğümü, Postgres ana düğümü olacak şekilde yükseltin. Yeni Postgres ana makinesi, önceki Edge yüklemenizle aynı sürüm olacaktır.
  • Eski yedek düğümü yeni ana düğümün yedek düğümü olacak şekilde yapılandırın. Eski yedek düğüm, önceki Edge yüklemenizle aynı sürüm olacaktır.
  • Yeni ana ve yedek düğümleri analiz ve tüketici gruplarına kaydedin.

Geri alma işlemini tamamladığınızda eski ana düğüm artık gerekli olmaz. Ardından eski ana düğümü devre dışı bırakabilirsiniz.

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

      İstenirse "apigee" kullanıcısı için Postgres şifresini girin. Varsayılan olarak "postgres" değerini alır.

    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 sayfayı yapılandırın:
      /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql setup-replication-on-master -f configFile
  5. Eski yedek düğümü daha yeni bir sürüme yükselttiyseniz öncelikle eski yedek düğümdeki Apigee yazılımını eski bir sürüme indirmeniz gerekir. Eski bekleme düğümünde hâlâ eski sürüm varsa bu adımı atlayıp 6. adıma geçebilirsiniz.
    1. Eski yedek düğümde Postgres'i durdurun:
      apigee-service apigee-postgresql stop
      apigee-service edge-postgres-server stop
    2. Postgres'i eski yedek düğümden kaldırın:
      apigee-service apigee-postgresql uninstall
      apigee-service edge-postgres-server uninstall
    3. Eski yedek düğümden Postgres veri dizinini silin:
      cd /opt/apigee/data/apigee-postgresql/pgdata > rm -rf *
    4. Eski yedek düğümde eski sürüm bootstrap'u (geri döndüğünüz Apigee sürümü için) indirip çalıştırın. Uygulanacak adımlar, internet tabanlı veya çevrimdışı kurulum kullandığınıza bağlı olarak değişiklik gösterebilir. Eski sürüm Apigee bootstrap çalıştırıldığında yum depoları eski sürüm Apigee verileriyle ayarlanır.
    5. Eski yedek düğümde Postgres bileşenlerini ayarlayın:
      /opt/apigee/apigee-setup/bin/setup.sh -p ps -f configFile
    6. Eski yedek düğümdeki Postgres bileşenlerinin eski sürüme geri çekilip çekilmediğini kontrol edin:
      apigee-service apigee-postgresql version
      apigee-service edge-postgres-server version
  6. 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 yedek düğümdeki veri dizinini kaldırın:
      cd /opt/apigee/data/apigee-postgresql/pgdata > rm -rf *
    3. Eski yedek düğümü yeni ana düğümün yedek 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. Eski yedek düğümde Postgres'in ç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-service edge-postgres-server start
  7. Yeni ana makinedeki /opt/apigee/apigee-postgresql/conf/pg_hba.conf dosyasını görüntüleyerek yeni yedek düğümün eklendiğini doğrulayın.
  8. Yönetim sunucusunda aşağıdaki komutu çalıştırarak geçerli analiz 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 grubu adını ve consumer-groups altındaki name alanındaki tüketici grubu adını döndürür. Ayrıca, eski Postgres ana ve yedek düğümlerinin UUID'lerini postgres-server alanında ve datastores alanında döndürür. Şu çıkışı göreceksiniz:

    {
      "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. 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"
  10. Eski yedek düğümün ve yeni ana düğümün IP adreslerini almak için önceki adımı tekrarlayın.
  11. Eski ana ve yedek 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ının varsayılan adlarıdır. masterUUID,standbyUUID, mevcut analizleri ve tüketici grubu bilgilerini yukarıda görüntülediğinizde görünen sırayla Bunları standbyUUID,masterUUID olarak belirtmeniz gerekebilir.

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

  12. Eski ana ve yedek düğümleri 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 şunları çalıştırın:

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

    Ana cihaz olduğunu doğrulayın. Eski yedek düğümde:

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

    Bekleme modunda olduğunu doğrulayın.

  19. Nodların senkronize olduğundan emin olmak için birkaç API isteği yaptıktan sonra önceki adımı tekrarlayın.
  20. 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 makinesini devre dışı bırakın.

    Alternatif olarak, Qpid'i eski ana makineden kaldırıp yeni ana düğüme yükleyebilirsiniz. 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