Apigee Edge 4.52.02 sürümünü geri alma

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

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

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

Bir sürümü geri çekme işlemi, yeni sürüme geçmiş olabileceğiniz her bileşeni geri almayı içerir. Ayrıca, başladığınız sürüme bağlı olarak, belirli yazılım bileşenlerini geri almadan önce dikkat edilmesi gereken özel noktaları dikkate almanız gerekebilir. Geri alma işlemi sırasında özel adımlar gerektirebilecek çeşitli yazılımlar aşağıdaki tabloda listelenmiştir:

Sürüme geri al Yazılımlar için özellikle dikkat edilmesi gereken noktalar
4.52.01 Cassandra
4.52.00 Cassandra, Hayvanat Bahçesi, Qpid
4.51.00 Cassandra, Hayvanat Bahçesi, Qpid, Postgres

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.02 - 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 sırası

Bileşenlerin geri alınması, yükseltildikleri sırayla gerçekleştirilmelidir. Ancak yönetim sunucularının Cassandra'dan sonra geri alınması gerekir.

Private Cloud 4.52.02 için genel geri alma sırası aşağıdaki gibi görünür:

  1. Postgre'leri, Qpid'i ve analizle ilgili diğer bileşenleri geri alma
  2. Geri Alma Yönlendiriciler ve Mesaj İşlemcileri
  3. Cassandra'yı Geri Alma, Hayvanat Bahçesin Sahibi
  4. Geri Alma Yönetimi sunucusu

Örneğin, tüm Cassandra kümesini, tüm yönetim sunucularınızı ve birkaç RMP'yi 4.52.01 sürümünden 4.52.02 sürümüne yükselttiğinizi ve geri almak istediğinizi varsayalım. Bu durumda:

  1. Tüm RMP'leri tek tek geri al
  2. Yedekleri kullanarak Cassandra kümesinin tamamını geri alma
  3. Uç Yönetimi sunucu düğümlerini tek tek geri alma

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.

Cassandra'nın geri alınması

Belirli bir Cassandra düğümünde Cassandra'nın önemli bir yükseltmesi yapıldığında Cassandra, düğümde depolanan verilerin şemasını değiştirerek doğrudan geri alma işlemini olanaksız kılar. Geri alma için iki metodoloji vardır. Önceki yükseltmenin durumuna bağlı olarak bu yöntemlerden birini kullanacaksınız.

Geri alma yöntemleri

Düğümü yeniden oluşturmak için kümedeki mevcut düğümleri silin ve kullanın

Bu prosedürü, Cassandra'nın eski sürümünde (Cassandra 2.1.22) bulunan en az bir tamamen işlevsel veri merkeziniz varsa uygulanabilir. Cassandra kümesinin tamamını yeni sürüme geçirdiyseniz ve geri almak istiyorsanız Yedeklemeyi veya sanal makine anlık görüntüsünü temizleme ve geri yükleme başlıklı makaledeki adımları uygulamanız gerekir.

Geri alma adımları

  1. Geri almak istediğiniz düğümle başlayın:
    • Düğümde Cassandra'yı durdurun:
      /opt/apigee/apigee-service/bin/apigee-service apigee-cassandra stop
    • Cassandra yazılımını düğümden kaldırın:
      /opt/apigee/apigee-service/bin/apigee-service apigee-cassandra uninstall
    • Veri dizinini düğümden kaldırın:
      rm -rf /opt/apigee/data/apigee-cassandra
    • Geri almak istediğiniz Private Cloud için Edge'in eski sürümünün önyüklemesini indirip çalıştırın.

    Örnek: 4.52.01 sürümüne geri dönmek için

    • 4.52.01 önyüklemesini indirin:
      curl https://software.apigee.com/bootstrap_4.52.01.sh -o /tmp/bootstrap_4.52.01.sh -u ‘uName:pWord’
    • 4.52.01 önyüklemesini yürütün:
      sudo bash /tmp/bootstrap_4.52.01.sh apigeeuser=uName apigeepassword=pWord

    • Cassandra'yı düğümde ayarlayın:
      /opt/apigee/apigee-setup/bin/setup.sh -p c -f configFile
    • İşlevsel veri merkezinin adını sağlayarak düğümde yeniden derlemeyi yürütün:
      /opt/apigee/apigee-cassandra/bin/nodetool rebuild -h <node-IP> <functional-dc>
    • Geri almak istediğiniz her düğüm için tek tek yukarıdaki adımları tekrarlayın.
  2. Tüm düğümler geri çekilip yeniden oluşturulduktan sonra:
    • Herhangi bir yönetim sunucusu düğümünün kurulumunu çalıştırın. Yönetim sunucusunun geri alınan sürümde olduğundan emin olun. Değilse yönetim sunucusunu da geri alın.
    • Yönetim sunucusunu durdurun:
      /opt/apigee/apigee-service/bin/apigee-service edge-management-server stop
    • Para kazanma özelliğini kullanıyorsanız para kazanma özelliğini de kaldırın:
      /opt/apigee/apigee-service/bin/apigee-service edge-mint-gateway uninstall
    • Yönetim sunucusunu kaldırın:
      /opt/apigee/apigee-service/bin/apigee-service edge-gateway uninstall
    • Eski sürümün önyüklemesini indirip yürütün. Örneğin, 4.52.01 sürümünün önyüklemesini indirip yürütmek için aşağıdaki adımları uygulayın:
      curl https://software.apigee.com/bootstrap_4.52.01.sh -o /tmp/bootstrap_4.52.01.sh -u ‘uName:pWord’
      sudo bash /tmp/bootstrap_4.52.01.sh apigeeuser=uName apigeepassword=pWord
    • Bir yönetim sunucusu düğümünün kurulumunu çalıştırın:
      /opt/apigee/apigee-setup/bin/setup.sh -p mt -f configFile

Yeniden oluşturma sonrası optimizasyon

Yukarıdaki adımlarda, düğümdeki tüm verilerin akışı, yeniden oluşturma sırasında uzak veri merkezinden aktarılır. Tüm replikalar yerel veri merkezine aktarıldıktan sonra onarım işlemini kullanarak bu işlemi optimize edebilirsiniz. Bu, DC arası akış önler ve uzak bir DC'den tüm düğümleri yeniden oluşturmaktan daha hızlı olmalıdır.

Örnek: Yerel veri merkezinde altı Cassandra düğümünüz olduğunu varsayalım. Apigee'nin çoğaltma faktörü varsayılan olarak üçtür, bu nedenle her düğümde verilerin% 50'si bulunur. Bu durumda, yukarıdaki prosedürü uygulayarak 1 ve #4 numaralı düğümleri yeniden oluşturabilirsiniz. 2, 3, #5 ve 6 numaralı düğümler için aşağıdaki adımları uygulayarak yedeği geri yükleyin ve onarım yapın.

  1. Yerel veri merkezinde replikaları yeniden oluşturmak için belgelendiği gibi altıncı adıma kadar olan prosedürü uygulayın.
  2. Kalan düğümler için, kalan her düğümde aşağıdaki adımları tek tek uygulayın.
    • Bu düğümde yakaladığınız yedeği geri yükleyin (not: Bu yedek, Cassandra yükseltmesine başlamadan önce alındığından bu yedekteki veriler eski olabilir):
      /opt/apigee/apigee-service/bin/apigee-service apigee-cassandra restore backup_file
    • Düğümün sanal makine anlık görüntüsüne sahipseniz Cassandra yedeğini geri yüklemek yerine anlık görüntüyü geri yükleyebilirsiniz.
    • Yedek geri yüklendikten sonra düğümde Cassandra hizmetini başlatın:
      /opt/apigee/apigee-service/bin/apigee-service apigee-cassandra start
    • Mevcut bir veri merkezinden en son verilerin akışla gönderilebilmesi için düğümde onarım yapın:
      /opt/apigee/apigee-cassandra/bin/nodetool -h <node-IP> repair -dc <local-dc-name>
    • Onarmak istediğiniz her düğümde üç ila altı arasındaki adımları tekrarlayın.
ziyaret edin.

Yedek/sanal makine anlık görüntüsünü temizleme ve geri yükleme

Tüm Cassandra kümesini yükselttiyseniz ve geri almak istiyorsanız yalnızca bu prosedür kullanılabilir.

Ayrıca Apigee yedekleri düğüme özeldir. Bir düğümden alınan yedeği başka bir düğüme geri yüklemek mümkün değildir. Cassandra yedeklemeleri, düğüm meta verisi bilgilerini (IP adresi, zil konumu vb.) içerir.

  1. Kümede 1 Cassandra düğümüyle başlayın:
    • Düğümdeki Cassandra hizmetini durdurun:
      /opt/apigee/apigee-service/bin/apigee-service apigee-cassandra stop
    • Cassandra yazılımını düğümden kaldırın:
      /opt/apigee/apigee-service/bin/apigee-service apigee-cassandra uninstall
    • Veri dizinini düğümden kaldırın:
      rm -rf /opt/apigee/data/apigee-cassandra
    • Geri almak istediğiniz Private Cloud için Edge'in eski sürümünü indirip çalıştırın.

    Örnek: 4.52.01 sürümüne geri dönmek için

    • 4.52.01 önyüklemesini indirin:
      curl https://software.apigee.com/bootstrap_4.52.01.sh -o /tmp/bootstrap_4.52.01.sh -u ‘uName:pWord’
    • 4.52.01 önyüklemesini yürütün:
      sudo bash /tmp/bootstrap_4.52.01.sh apigeeuser=uName apigeepassword=pWord

    • Cassandra'yı düğümde ayarlayın:
      /opt/apigee/apigee-setup/bin/setup.sh -p c -f configFile
    • Yedekten geri yükleme bölümündeki prosedürü kullanarak yedeği düğüme geri yükleyin.
    • Düğümde Cassandra'yı durdurun:
      /opt/apigee/apigee-service/bin/apigee-service apigee-cassandra stop
    • Veri dizinini silin:
      rm -rf /opt/apigee/data/apigee-cassandra/data
    • Yedeği geri yükleme:
      /opt/apigee/apigee-service/bin/apigee-service apigee-cassandra restore backup_file
    • Düğümde Cassandra hizmetini başlatın:
      /opt/apigee/apigee-service/bin/apigee-service apigee-cassandra start
    • Her Cassandra düğümündeki adımları birer birer tekrarlayın.
    • Düğümlerde teker teker onarım yapın:
      /opt/apigee/apigee-cassandra/bin/nodetool -h <node-IP> repair -pr
ziyaret edin.

Zookeeper 3.8.3 güncellemesini geri alma

4.52.00 veya 4.51.00 sürümlerine geri dönüyorsanız Zookeeper'ı geri almadan önce bazı özel adımları uygulamanız gerekir. Bu adımlar Geri alma bölümünde listelenmiştir.

4.52.01 sürümüne geri dönecekseniz aşağıdaki Önceki ana veya alt sürüme geri dönme bölümünde belirtildiği gibi, herhangi bir yazılımı geri çeker gibi Zookeeper'ı geri çekin.

Qpid Geri Alma

4.52.00 veya 4.51.00 sürümlerine geri dönüyorsanız Qpid'yi geri almadan önce bazı özel adımlardan geçmeniz gerekir. Bu adımlar Geri alma bölümünde listelenmiştir.

4.52.01 sürümüne geri dönüyorsanız Önceki ana veya alt sürüme geri dönme bölümünde listelenen yazılımı geri alır gibi Qpid'i geri alma

Postgres 10.17 güncellemesini geri alma

4.51.00 sürümüne geri dönüyorsanız Postgres'i geri almadan önce bazı özel adımlara başvurmanız gerekir. Bu adımlar Geri alma bölümünde listelenmiştir.

4.52.01 veya 4.52.00 sürümüne geri dönecekseniz aşağıdaki Önceki ana veya alt sürüme geri dönme bölümünde belirtildiği gibi Postgres'i herhangi bir yazılımı geri çeker gibi geri çekin.

Ö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. Uygulamayı yayınlamak istediğiniz sürümün bootstrap.sh dosyasını indirin. geri:

    • 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 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ö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.02 sürümünü kaldırın:
    /opt/apigee/apigee-service/bin/apigee-service apigee-setup uninstall
  6. apigee-service uygulamasının 4.51.00 sürümünü yükleyin ve bağımlılıklarını öğrendiniz. 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.

mTLS'yi geri döndür

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