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 hataya neden olan bileşeni geri çekip güncellemeyi tekrar deneyebilirsiniz.

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 çekmeyi içerir. Ayrıca, başladığınız sürüme bağlı olarak, belirli yazılım bileşenlerini geri çekmeden önce dikkat edilmesi gereken özel noktaları dikkate almanız gerekebilir. Geri alma 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ıma özel değerlendirme
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 ile 4.52.00 arasında.
  2. Aynı sürümdeki önceki bir yama sürümüne geri dönün. Ö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 işlemi'ne bakın.

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 Bakıcısı
  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 güncelleyen kullanıcıyla 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önlendirici'nin ayrıcalıklı bağlantı noktalarına (1.000'in altındakiler gibi) erişmesi gerekiyorsa Yönlendirici'yi kök bağlantı 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 koda sahiptir. Bu nedenle, bu bileşenlerden herhangi birini bir düğümde geri çekmek için söz konusu düğümdeki tüm bu bileşenleri geri çekmeniz 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, düğümde Yönetim Sunucusu, Yönlendirici ve İleti İşlemci yüklüyse bunlardan herhangi birini geri almak için üçünü de geri almanız 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. Tüm Cassandra kümesini 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:
    • Cassandra'yı düğümde 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
    • Şu düğümden veri dizinini 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ı yürütü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: Söz konusu yedek, Cassandra yükseltmesi başlatılmadan ö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ışı 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.

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
    • Şu düğümden veri dizinini 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.
    • Cassandra'yı düğümde durdurun: 
      /opt/apigee/apigee-service/bin/apigee-service apigee-cassandra stop
    • Veri dizinini sil: 
      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 tek seferde bir onarım işlemi yapın: 
      /opt/apigee/apigee-cassandra/bin/nodetool -h <node-IP> repair -pr

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ş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. Geri çekmek için bileşeni durdurun:
    1. Düğümdeki ortak koda sahip bileşenlerden herhangi birini geri çekmek için aşağıdaki örnekte gösterildiği gibi 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 etkinleştiriyorsanız bu hizmeti 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üğümde geri dönmek için bileşeni kaldırın:
    1. Düğümdeki ortak koda sahip bileşenlerden herhangi birini 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 başka bir bileşeni geri çekmek için aşağıdaki örnekte gösterildiği gibi yalnızca o 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 grubunun yüklemesini 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.02 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 ve bağımlılıklarının 4.51.00 sürümünü yükleyin. Aşağıdaki örnekte, apigee-service öğesinin 4.51.00 sürümü yüklenmektedir: 
    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 öğesini atlarsanı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ü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 için yapılandırma dosyanızdır.

  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 bileşeni barındıran her düğümde aşağıdaki işlemleri 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 mevcut bileşen sürümlerini belirlemek için şu komutu kullanabilirsiniz: 

    yum --showduplicates list comp

    Örneğin:

    yum --showduplicates list edge-ui
  2. Bileşeni yüklemek için apigee-setup işlevini 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 durdur: 
    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