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

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

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

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

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

  1. Önceki bir ana veya küçük sürüme geri dönme. Örneğin, 4.52.01 ile 4.52.00 arasındadır.
  2. Aynı sürümdeki önceki yama sürümüne geri dönün. Örneğin, 4.52.00.02 ile 4.52.00.01 arası.

Daha fazla bilgi için Apigee Edge sürüm süreci bölümüne bakın.

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

Geri alma işlemini gerçekleştiren kullanıcı, Edge'i ilk 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 1000'in altındaki bağlantılar gibi ayrıcalıklı bağlantı noktalarına 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, 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 kodu paylaşır. Bu nedenle, bir düğümde bu bileşenlerden herhangi birini geri çekmek için söz konusu düğümde bulunan tüm bu bileşenleri geri çekmeniz 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 İşlemci yüklüyse bunlardan herhangi birini geri almak için üçünü de geri çekmeniz gerekir.

Önceki bir ana veya küçük sürüme geri dönme

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

  1. Geri almak istediğiniz sürüm için bootstrap.sh dosyasını indirin:

    • 4.51.00 sürümüne geri dönmek için bootstrap_4.51.00.sh dosyasını indirin:
      curl https://software.apigee.com/bootstrap_4.51.00.sh -o /tmp/bootstrap_4.51.00.sh 
  2. Bileşenin geri alınması için durdurun:
    1. Düğümde ortak koda sahip bileşenleri geri çekmek için bunları aşağıdaki örnekte gösterildiği gibi 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 other bileşenini geri çekmek için yalnızca söz konusu bileşeni durdurun:
      • /opt/apigee/apigee-service/bin/apigee-service component stop
  3. Para Kazanma özelliğini eski sürüme geri döndürüyorsanız tüm Yönetim Sunucusu ve Mesaj İşleyici düğümlerinden kaldırın:
    /opt/apigee/apigee-service/bin/apigee-service edge-mint-gateway uninstall
  4. Düğüm üzerinde geri alınacak bileşeni kaldırın:
    1. Düğümde ortak koda sahip bileşenleri geri çekmek için aşağıdaki örnekte gösterildiği gibi edge-gateway bileşen grubunu kaldırarak tümünü kaldırmanız gerekir:
      /opt/apigee/apigee-service/bin/apigee-service edge-gateway uninstall
    2. Düğümdeki diğer herhangi bir bileşeni geri çekmek için aşağıdaki örnekte gösterildiği gibi yalnızca söz konusu 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 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 ürünü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 örnek, apigee-service öğesinin 4.51.00 sürümünü yükler:
    sudo bash /tmp/bootstrap_4.51.00.sh apigeeuser=uName apigeepassword=pWord

    Burada uName ve pWord, Apigee'den aldığınız kullanıcı adı ve şifredir. pWord parametresini çıkarırsanız bunu girmeniz istenir.

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

  7. apigee-setup uygulamasını yükleme:
    /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şendir. configFile ise eski sürüm için yapılandırma dosyanızdır.

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

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

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

  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:

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

    Bileşeni yüklerken yalnızca bileşen adını belirttiğinizi, sürümü belirtmediğinizi unutmayın.

  3. Geri almakta olduğunuz bileşeni barındıran her düğüm için bu işlemi tekrarlayın.

Postgres 10.17 güncellemesini geri çekme

4.50.00 veya 4.51.00 sürümünden 4.52.01 sürümüne yükseltme yaptıysanız Edge bileşenlerine ek olarak Postgres güncellemenizi de geri çekmeniz gerekir.

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

  • Postgres ustası olmak için 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ına kaydedin.

Geri alma işlemini bitirdiğinizde, eski ana düğüm artık gerekli olmayacaktır. Ardından eski ana düğümü geçersiz kılabilirsiniz.

  1. Yeni bekleme 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'i 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. Edge'in mevcut sürümünü yüklemek için kullandığınız yapılandırma dosyasını aşağıdakileri belirtmek için düzenleyin:
      # 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 yükselttiyseniz öncelikle eski bekleme düğümündeki Apigee yazılımını eski sürüme geçirmeniz gerekir. Eski bekleme düğümünde eski sürüm hâlâ varsa bu adımı atlayıp 6. adımla devam edebilirsiniz.
    1. Postgres'i eski bekleme düğümünde 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. Postgres veri dizinini eski bekleme düğümünden silin:
      cd /opt/apigee/data/apigee-postgresql/pgdata > rm -rf *
    4. Eski bekleme düğümünde eski sürüm önyüklemesini (geri döndüreceğiniz Apigee sürümü için) indirip çalıştırın. Uygulanacak adımlar, internet tabanlı veya çevrimdışı yükleme kullanmanıza bağlı olarak değişiklik gösterebilir. Eski Apigee önyükleme sürümünün çalıştırılması, yum depolarını eski sürüm Apigee verileriyle ayarlar.
    5. Eski bekleme düğümünde Postgres bileşenlerini kurun:
      /opt/apigee/apigee-setup/bin/setup.sh -p ps -f configFile
    6. Eski bekleme düğümündeki Postgres bileşenlerinin eski sürüme geri döndürüldüğünü kontrol edin:
      apigee-service apigee-postgresql version
      apigee-service edge-postgres-server version
  6. Eski bekleme düğümünü yeniden oluşturun:
    1. Edge'in mevcut sürümünü yüklemek için kullandığınız yapılandırma dosyasını aşağıdakileri belirtmek için düzenleyin:
      # 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

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

      /opt/apigee/apigee-service/bin/apigee-service edge-postgres-server start
  7. /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.
  8. 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ında analiz grubu adını, consumer-groups altındaki name alanında da 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" : {
      }
    }

  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

    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"
  10. Eski bekleme düğümlerinin ve yeni ana düğümün IP adreslerini almak için önceki adımı tekrarlayın.
  11. Eski ana düğüm 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, mevcut analiz ve tüketici grubu bilgilerini görüntülediğinizde yukarıda göründüğü sırada yer almaktadır. Bunları standbyUUID,masterUUID olarak belirtmeniz gerekebilir.

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

  12. Eski ana düğüm 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. 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
  14. Analiz grubunu doğrulayın:
    curl -u sysAdminEmail:password http://ms_IP:8080/v1/analytics/groups/ax

    Yeni ana düğüm ve bekleme düğümlerinin UUID'lerinin analiz grubu ve tüketici grubunda listelendiğini görmeniz gerekir.

  15. Uç Yönetim Sunucusu'nu 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. Aşağıdaki komut dosyalarını her iki sunucuda da yayınlayarak çoğaltma durumunu doğrulayın. Çoğaltmanın başarılı olması için sistemin her iki sunucuda da aynı sonuçları görüntülemesi gerekir:

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

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

    Bunun ana öğe 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 olduğundan emin olmak için birkaç API isteğinde bulunduktan sonra önceki adımı tekrarlayın.
  20. Postgres düğümünü geçersiz kılma bölümündeki prosedürü kullanarak eski Postgres ana düğümünü kullanımdan kaldırın.

    Alternatif olarak, Qpid'yi eski ana düğümden kaldırıp yeni ana düğüme yükleyebilirsiniz. Qpid'yi kaldırdıktan sonra, eski ana düğümü geçersiz kılabilirsiniz.

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ükleme:
    apigee-service apigee-mtls install
    apigee-service apigee-mtls setup -f /opt/silent.conf