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

Edge 4.52.02'ye 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.52.02'yi aşağıdaki ana sürümlere geri döndürebilirsiniz:

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

Bir sürümü geri almak, yükseltmiş olabileceğiniz her bileşeni geri almanızı gerektirir. Ayrıca, başladığınız sürüme bağlı olarak belirli yazılım bileşenlerini geri almadan önce özel hususları dikkate almanız gerekebilir. Aşağıdaki tabloda, geri alma sırasında özel adımlar gerekebilecek çeşitli yazılımlar listelenmiştir:

Sürüme geri alma Yazılımla ilgili dikkat edilmesi gereken noktalar
4.52.01 Cassandra
4.52.00 Cassandra, Zookeeper, Qpid
4.51.00 Cassandra, Zookeeper, Qpid, Postgres

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

  1. Önceki bir büyük veya küçük sürüme geri dönebilirsiniz. Örneğin, 4.52.02 yerine 4.52.00.
  2. Aynı sürümdeki önceki bir yama sürümüne geri dönebilirsiniz. Örneğin, 4.52.00.02 yerine 4.52.00.01.

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

Geri alma sırası

Bileşenlerin geri alınması, yükseltildikleri sıranın tersine göre yapılmalıdır. Yönetim sunucularının Cassandra'dan sonra geri alınması istisnadır.

Private Cloud 4.52.02 için tipik genel geri alma sırası aşağıdaki gibidir:

  1. Postgres, Qpid ve analizlerle ilgili diğer bileşenleri geri alma
  2. Yönlendiricileri ve Mesaj İşleyicileri Geri Alma
  3. Cassandra, Zookeeper'ı geri alma
  4. Geri alma yönetim sunucusu

Örneğin, Cassandra kümesinin tamamını, 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 alma
  2. Yedeklemeleri kullanarak Cassandra kümesinin tamamını geri alma
  3. Edge Management sunucusu düğümlerini tek tek geri alma

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.

Cassandra'yı geri alma

Belirli bir Cassandra düğümünde Cassandra'da büyük bir yükseltme yapıldığında Cassandra, düğümde depolanan verilerin şemasını değiştirerek doğrudan geri alma işlemini imkansız hale getirir. Geri alma işleminin iki yöntemi vardır. Geri aldığınız yükseltmenin durumuna bağlı olarak bu metodolojilerden birini kullanırsınız.

Geri alma metodolojileri

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

Kümede, Cassandra'nın eski sürümünü (Cassandra 2.1.22) kullanan en az bir tam işlevli veri merkeziniz varsa bu prosedürü uygulayabilirsiniz. Cassandra kümesinin tamamını yükselttiyseniz ve geri almak istiyorsanız Yedekleme veya sanal makine anlık görüntüsünü silme ve geri yükleme bölümündeki adımları uygulamanız gerekir.

Geri alma adımları

  1. Geri almak istediğiniz düğümden 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 sürümünün ö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'in önyüklemesini yürütün: 
      sudo bash /tmp/bootstrap_4.52.01.sh apigeeuser=uName apigeepassword=pWord

    • Düğümde Cassandra'yı ayarlayın: 
      /opt/apigee/apigee-setup/bin/setup.sh -p c -f configFile
    • İşlevsel veri merkezinin adını sağlayarak düğümde yeniden oluşturma işlemini yürütün: 
      /opt/apigee/apigee-cassandra/bin/nodetool rebuild -h <node-IP> <functional-dc>
    • Geri almak istediğiniz her düğümde yukarıdaki adımları tek tek 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ümden olduğundan emin olun. Aksi takdirde 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 bu özelliği 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 çalıştırı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 işleminden sonra optimizasyon

Yukarıdaki adımlarda, yeniden oluşturma işlemi sırasında düğümdeki tüm veriler uzak veri merkezinden aktarılır. Tüm kopyalar yerel veri merkezine aktarıldıktan sonra bir onarım kullanarak bu süreci optimize edebilirsiniz. Bu işlem, DC'ler arası akıştan kaçınır ve tüm düğümleri uzak bir DC'den yeniden oluşturmaktan daha hızlıdır.

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

  1. Yerel veri merkezinde kopyaları yeniden oluşturmak için dokümanlar bölümünde belirtilen altı adıma kadar olan prosedürü uygulayın.
  2. Kalan düğümler için aşağıdaki adımları her bir düğümde tek tek uygulayın.
    • Bu düğümde yakaladığınız yedeklemeyi geri yükleyin (not: Cassandra yükseltmesini başlatmadan önce alındığı için bu yedekte muhtemelen eski veriler bulunur): 
      /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.
    • Yedekleme 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 aktarılabilmesi için düğümde bir onarım gerçekleştirin: 
      /opt/apigee/apigee-cassandra/bin/nodetool -h <node-IP> repair -dc <local-dc-name>
    • Onarmak istediğiniz her düğümde üç ile altı arasındaki adımları tekrarlayın.

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

Cassandra kümesinin tamamını yükselttiyseniz ve geri almak istiyorsanız kullanabileceğiniz tek prosedür budur.

Ayrıca Apigee yedeklemeleri 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 veri bilgilerini (ör. IP adresi, halka konumu vb.) içerir.

  1. Kümede 1 Cassandra düğümüyle başlayın:
    • Düğümde 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 dönmek 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 sürümünün ö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'in önyüklemesini yürütün: 
      sudo bash /tmp/bootstrap_4.52.01.sh apigeeuser=uName apigeepassword=pWord

    • Düğümde Cassandra'yı ayarlayın: 
      /opt/apigee/apigee-setup/bin/setup.sh -p c -f configFile
    • Yedekten geri yükleme bölümündeki prosedürü uygulayarak yedeklemeyi düğüme geri yükleyin.
    • Düğümde Cassandra'yı durdurun: 
      /opt/apigee/apigee-service/bin/apigee-service apigee-cassandra stop
    • Veri dizinlerini silme: 
      rm -rf /opt/apigee/data/apigee-cassandra/data
    • Yedeklemeyi 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
    • Adımları her Cassandra düğümünde tek tek tekrarlayın.
    • Onarımı düğümlerde tek tek çalıştırı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 döndürmeden ö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önüyorsanız Zookeeper'ı, aşağıdaki Önceki bir ana veya küçük sürüme geri dönme bölümünde listelenen herhangi bir yazılımı geri döndürdüğünüz gibi geri döndürün.

Qpid'i geri alma

4.52.00 veya 4.51.00 sürümlerine geri dönüyorsanız Qpid'i geri döndürmeden ö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önüyorsanız Qpid'i, Önceki bir büyük veya küçük sürüme geri dönme bölümünde listelenen herhangi bir yazılımı geri döndürdüğünüz gibi geri döndürün.

Postgres 10.17 güncellemesini geri alma

4.51.00 sürümüne geri dönüyorsanız Postgres'i geri döndürmeden önce bazı özel adımları uygulamanı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önüyorsanız Postgres'i, aşağıdaki Önceki bir ana veya küçük sürüme geri dönme bölümünde listelenen herhangi bir yazılımı geri döndürdüğünüz gibi geri döndürün.

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

Önceki bir büyük 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 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 sürümü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ını durdurun:
    1. Düğümdeki 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'in 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 4.51.00 sürümünü ve bağımlılıklarını yükleyin. Aşağıdaki örnekte, apigee-service'ın 4.51.00 sürümü yüklenir: 
    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 girmeniz istenir.

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

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

  9. Qpid'i geri alıyorsanı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 yama sürümüne geri dönme

Bir bileşeni belirli bir yama 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

    Buradaki 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'ü 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.

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 durdurma: 
    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