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

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

Edge 4.53.00'ı aşağıdaki küçük sürümüne geri döndürebilirsiniz:

  • Sürüm 4.52.02

Bir sürümü geri alma işlemi, yükseltmiş olabileceğiniz her bileşeni geri almayı içerir. Ayrıca, Cassandra'yı 4.52.02 sürümüne geri döndürürken özel hususları göz önünde bulundurmanız gerekir.

Geri alma işlemi yapmak isteyebileceğiniz iki senaryo vardır:

  1. Önceki bir ana veya ara sürüme geri dönme. Örneğin, 4.53.00'dan 4.52.02'ye.
  2. Aynı sürümdeki önceki bir yama sürümüne geri dönme. Örneğin, 4.53.00.01'den 4.53.00.00'a.

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 tersiyle yapılmalıdır. Ancak yönetim sunucuları Cassandra'dan sonra geri alınmalıdır.

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

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

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

  1. Tüm RMP'leri tek tek geri alma
  2. Yedekleri kullanarak Cassandra kümesinin tamamını geri alma
  3. Uç Yönetimi sunucu 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ı 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 küçü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. Alternatif olarak, bir bileşeni bir kullanıcı olarak, başka bir 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 kodu paylaşır. Bu nedenle, bir düğümdeki bu bileşenlerden herhangi birini geri almak için o düğümdeki tüm bileşenleri 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üğüme Yönetim Sunucusu, Yönlendirici ve Mesaj İşleyici'yi yüklediyseniz bunlardan herhangi birini geri almak için üçünü de geri almanız gerekir.

Cassandra'nın geri alınması

Cassandra'nın geri alınması

Belirli bir düğümde Cassandra'nın büyük bir yükseltmesi gerçekleştirildiğinde Cassandra, o düğümde depolanan verilerin şemasını değiştirir. Bu nedenle, doğrudan yerinde geri alma işlemi mümkün değildir.

Geri alma senaryoları

Private Cloud 4.53.00 için Edge ile kullanılabilen Cassandra 4.0.X, Private Cloud 4.52.02'nin diğer bileşenleriyle uyumludur.

Kullanabileceğiniz çeşitli geri alma stratejilerinin özeti için lütfen aşağıdaki tabloya bakın:

Senaryo Geri alma stratejisi
Tek veri merkezi, bazı Cassandra düğümleri yükseltildi Yedekleri kullanma
Tek veri merkezi, tüm Cassandra düğümleri yükseltildi Cassandra'yı geri sarmayın. Diğer bileşenler geri alınabilir.
Tek DC, tüm düğümler (Cassandra ve diğerleri) yükseltildi Cassandra'yı geri sarmayın. Diğer bileşenler geri alınabilir.
Birden fazla veri merkezi, bir veri merkezindeki bazı düğümler yükseltildi Mevcut DC'den yeniden oluşturma
Birden fazla veri merkezi, bazı veri merkezlerindeki tüm Cassandra düğümleri yükseltildi Mevcut DC'den yeniden oluşturma
Yükseltilen son DC'nin birden fazla DC, Cassandra düğümü Yükseltme işlemini tamamlamayı deneyin. Mümkün değilse yedekleme kullanarak 1 DC'yi geri alın. Geri alınan DC'den kalan DC'leri yeniden oluşturun.
Birden fazla DC, tüm Cassandra düğümleri yükseltildi Cassandra'yı geri sarmayın. Diğer bileşenler geri alınabilir.
Birden fazla veri merkezi, tüm düğümler (Cassandra ve diğerleri) yükseltildi Cassandra'yı geri sarmayın. Diğer bileşenler geri alınabilir.

Genel olarak dikkat edilecek noktalar

Geri alma işlemini değerlendirirken aşağıdakileri göz önünde bulundurun:

  • Çalışma zamanı veya yönetim bileşenlerinin geri alınması: edge-management-server, edge-message-processor gibi bileşenleri veya Cassandra dışındaki herhangi bir bileşeni Private Cloud sürüm 4.52.02'ye geri almak istiyorsanız Cassandra'yı geri ALMAMANIZ önerilir. Private Cloud 4.53.00 ile birlikte gelen Cassandra, Edge for Private Cloud 4.52.02'nin Cassandra dışındaki tüm bileşenleriyle uyumludur. Cassandra 4.0.13 sürümünde kalırken burada listelenen metodolojiyi kullanarak Cassandra dışı bileşenleri geri alabilirsiniz.
  • Cassandra kümesinin tamamı 4.0.X sürümüne yükseltildikten sonra geri alma: Özel Bulut sürümü 4.53.00'e yükseltme kapsamında Cassandra kümenizin tamamı 4.0.X sürümüne yükseltildiyse bu küme kurulumuna devam etmeniz ve Cassandra'yı GERİ ALMAMANIZ önerilir. Private Cloud 4.52.02 sürümündeki edge-management-server, edge-message-processor, edge-router gibi bileşenler Cassandra 4.0.X sürümüyle uyumludur.
  • Cassandra yükseltmesi sırasında geri alma: Cassandra yükseltmesi sırasında sorunlarla karşılaşırsanız geri alma işlemini düşünebilirsiniz. Bu makalede listelenen geri alma stratejileri, yükseltme sürecinde bulunduğunuz duruma göre uygulanabilir.
  • Yedekleri kullanarak geri alma: Cassandra 4.0.X'ten alınan yedekler, Cassandra 3.11.X'in yedekleriyle uyumlu değildir. Yedek geri yükleme kullanarak Cassandra'yı geri sarmak için yükseltme işlemini denemeden önce Cassandra 3.11.X'in yedeklerini almanız gerekir.

Yeniden oluşturma kullanarak Cassandra'yı geri alma

Ön koşullar

  • Birden fazla veri merkezinde Edge for Private Cloud 4.52.02 kümesi çalıştırıyorsunuz.
  • Cassandra'yı 3.11.X sürümünden 4.0.X sürümüne yükseltme sürecindesiniz ve yükseltme sırasında sorunlarla karşılaştınız.
  • Kümede, Cassandra'nın eski sürümünü (Cassandra 3.11.X) çalıştıran en az bir tam işlevsel veri merkeziniz var.

Bu prosedür, mevcut bir veri merkezinden gelen akış verilerine dayanır. Cassandra'da ne kadar veri depolandığına bağlı olarak bu işlem önemli ölçüde zaman alabilir. Geri alma işlemi devam ederken çalışma zamanı trafiğinizi bu veri merkezinden yönlendirmeye hazır olmanız gerekir.

Kısaca adımlar

  1. Geri yüklemek istediğiniz bir veri merkezini (kısmen veya tamamen yükseltilmiş) seçin. Çalışma zamanı trafiğini farklı bir çalışan veri merkezine yönlendirin.
  2. Veri merkezindeki başlangıç düğümünü belirleyin ve başlangıç düğümlerinden biriyle başlayın.
  3. Cassandra düğümünü durdurun, kaldırın ve temizleyin.
  4. Cassandra'nın eski sürümünü düğüme yükleyin ve gerektiği şekilde yapılandırın.
  5. Daha önce eklenen fazladan yapılandırmaları kaldırın.
  6. Veri merkezindeki tüm başlangıç düğümleri için yukarıdaki adımları tek tek tekrarlayın.
  7. Veri merkezindeki kalan tüm Cassandra düğümleri için yukarıdaki adımları tek tek tekrarlayın.
  8. Mevcut işlevsel veri merkezindeki düğümleri tek tek yeniden oluşturun.
  9. Veri merkezinde Cassandra'ya bağlı olan tüm edge-* bileşenlerini yeniden başlatın.
  10. Trafiği test edin ve tekrar bu veri merkezine yönlendirin.
  11. Bu adımları her veri merkezi için tek tek tekrarlayın.

Ayrıntılı adımlar

  1. Tüm Cassandra düğümlerinin veya bazılarının yükseltildiği bir veri merkezi seçin. Bu veri merkezindeki Cassandra düğümleri geri alınırken bu veri merkezinden gelen tüm çalışma zamanı proxy trafiğini ve yönetim trafiğini yönlendirin. nodetool ring komutu düğümlerde yürütüldüğünde tüm Cassandra düğümlerinin UN (Up/Normal) durumunda olduğundan emin olun. Belirli düğümler kapalıysa devam etmeden önce sorunu giderin ve bu düğümleri tekrar açın.

    Aşağıdaki örneği inceleyin:

    /opt/apigee/apigee-cassandra/bin/nodetool status
Datacenter: dc-1
================
Status=Up/Down
|/ State=Normal/Leaving/Joining/Moving
--  Address      Load       Tokens       Owns (effective)  Host ID                               Rack
UN  DC1-1IP1  456.41 KiB  1            100.0%            78fc4ddd-2ed9-4a8c-98a2-63a38c2f1920  ra-1
UN  DC1-1IP2  870.93 KiB  1            100.0%            160db01a-64ab-43a7-b9ea-3b7f8f66d52b  ra-1
UN  DC1-1IP3  824.08 KiB  1            100.0%            21d61543-d59e-403a-bf5d-bfe7f664baa6  ra-1
Datacenter: dc-2
================
Status=Up/Down
|/ State=Normal/Leaving/Joining/Moving
--  Address      Load       Tokens       Owns (effective)  Host ID                               Rack
UN  DC2-1IP1   802.08 KiB  1            100.0%            583e0576-336d-4ce7-9729-2ae74e0abde2  ra-1
UN  DC2-1IP2   844.4 KiB   1            100.0%            fef794d5-f4c2-4a4e-bb05-9adaeb4aea4b  ra-1
UN  DC2-1IP3   878.12 KiB  1            100.0%            3894b3d9-1f5a-444d-83db-7b1e338bbfc9  ra-1

    Tüm kümenin mevcut durumunu anlamak için düğümlerde nodetool describecluster komutunu çalıştırabilirsiniz. Örneğin, aşağıda 2 veri merkezi kümesinin bir örneği gösterilmektedir. Bu örnekte, tüm DC-1 düğümleri Cassandra sürüm 4'te, tüm DC-2 düğümleri ise Cassandra sürüm 3'tedir:

    # On nodes where Cassandra is upgraded
/opt/apigee/apigee-cassandra/bin/nodetool describecluster
Cluster Information:
    Name: Apigee
    Snitch: org.apache.cassandra.locator.PropertyFileSnitch
    DynamicEndPointSnitch: enabled
    Partitioner: org.apache.cassandra.dht.RandomPartitioner
    Schema versions:
        2eadcd74-0245-309a-9992-3625afa70038: [DC-1-IP1, DC-1-IP2, DC-1-IP3]
        129dc15e-198e-3c11-b64c-701044a3a1ad: [DC-2-IP1, DC-2-IP2, DC-2-IP3]

Stats for all nodes:
    Live: 6
    Joining: 0
    Moving: 0
    Leaving: 0
    Unreachable: 0

Data Centers:
    dc-1 #Nodes: 3 #Down: 0
    dc-2 #Nodes: 3 #Down: 0

Database versions:
    4.0.13: [DC-1-IP1:7000, DC-1-IP2:7000, DC-1-IP3:7000]
    3.11.16: [DC-2-IP1:7000, DC-2-IP2:7000, DC-2-IP3:7000]

Keyspaces:
    system_schema -> Replication class: LocalStrategy {}
    system -> Replication class: LocalStrategy {}
    auth -> Replication class: NetworkTopologyStrategy {dc-2=3, dc-1=3}
    cache -> Replication class: NetworkTopologyStrategy {dc-2=3, dc-1=3}
    devconnect -> Replication class: NetworkTopologyStrategy {dc-2=3, dc-1=3}
    dek -> Replication class: NetworkTopologyStrategy {dc-2=3, dc-1=3}
    user_settings -> Replication class: NetworkTopologyStrategy {dc-2=3, dc-1=3}
    apprepo -> Replication class: NetworkTopologyStrategy {dc-2=3, dc-1=3}
    kms -> Replication class: NetworkTopologyStrategy {dc-2=3, dc-1=3}
    identityzone -> Replication class: NetworkTopologyStrategy {dc-2=3, dc-1=3}
    audit -> Replication class: NetworkTopologyStrategy {dc-2=3, dc-1=3}
    analytics -> Replication class: NetworkTopologyStrategy {dc-2=3, dc-1=3}
    keyvaluemap -> Replication class: NetworkTopologyStrategy {dc-2=3, dc-1=3}
    counter -> Replication class: NetworkTopologyStrategy {dc-2=3, dc-1=3}
    apimodel_v2 -> Replication class: NetworkTopologyStrategy {dc-2=3, dc-1=3}
    system_distributed -> Replication class: SimpleStrategy {replication_factor=3}
    system_traces -> Replication class: SimpleStrategy {replication_factor=2}
    system_auth -> Replication class: SimpleStrategy {replication_factor=1}

# On nodes where Cassandra is not upgraded
/opt/apigee/apigee-cassandra/bin/nodetool describecluster
Cluster Information:
    Name: Apigee
    Snitch: org.apache.cassandra.locator.PropertyFileSnitch
    DynamicEndPointSnitch: enabled
    Partitioner: org.apache.cassandra.dht.RandomPartitioner
    Schema versions:
        2eadcd74-0245-309a-9992-3625afa70038: [DC-1-IP1, DC-1-IP2, DC-1-IP3]
        129dc15e-198e-3c11-b64c-701044a3a1ad: [DC-2-IP1, DC-2-IP2, DC-2-IP3]
  2. Veri merkezindeki başlangıç düğümlerini belirleyin: Ek'teki Başlangıç düğümleri nasıl belirlenir? bölümüne bakın. Aşağıdaki adımları başlangıç düğümlerinden birinde yürütün:
  3. Cassandra düğümündeki verileri durdurma, kaldırma ve temizleme Bu veri merkezinde Cassandra sürüm 4'teki ilk çekirdek düğümü seçin. Dur. 
    # Stop Cassandra service on the node
/opt/apigee/apigee-service/bin/apigee-service apigee-cassandra stop

# Uninstall Cassandra software
/opt/apigee/apigee-service/bin/apigee-service apigee-cassandra uninstall

# Wipe out Cassandra data
rm -rf /opt/apigee/data/apigee-cassandra
  4. Düğüme eski Cassandra yazılımını yükleyin ve bazı yapılandırmaları ayarlayın. Private Cloud 4.52.02 için Edge'in bootstrap dosyasını çalıştırın. 
    5. # Download bootstrap of 4.52.02
curl https://software.apigee.com/bootstrap_4.52.02.sh -o /tmp/bootstrap_4.52.02.sh -u uName:pWord

# Execute bootstrap of 4.52.02
sudo bash /tmp/bootstrap_4.52.02.sh apigeeuser=uName apigeepassword=pWord
  5. Dosyayı oluşturun veya düzenleyin /opt/apigee/customer/application/cassandra.properties.
  6. Dosyaya aşağıdaki içerikleri ekleyin. ipOfNode, Cassandra'nın diğer Cassandra düğümleriyle iletişim kurmak için kullandığı düğümün IP adresidir: 
    conf_jvm_options_custom_settings=-Dcassandra.replace_address=ipOfNode -Dcassandra.allow_unsafe_replace=true
  7. Dosyanın apigee kullanıcısına ait olduğundan ve bu kullanıcı tarafından okunabildiğinden emin olun: 
    chown apigee:apigee /opt/apigee/customer/application/cassandra.properties
  8. Cassandra'yı yükleme ve ayarlama: 
    # Install cassandra version 3.11.X
/opt/apigee/apigee-service/bin/apigee-service apigee-cassandra install

# Setup cassandra while passing standard configuration file
/opt/apigee/apigee-service/bin/apigee-service apigee-cassandra setup -f configFile
# Ensure Cassandra version is correct and service is running
/opt/apigee/apigee-service/bin/apigee-service apigee-cassandra version
/opt/apigee/apigee-service/bin/apigee-service apigee-cassandra status
  9. Düğümün başlatıldığını doğrulayın. Bu düğümde ve kümedeki diğer düğümlerde aşağıdaki komutu kontrol edin. Düğüm, "UN" (Up/Normal) durumunda olduğunu bildirmelidir: 
    /opt/apigee/apigee-cassandra/bin/nodetool status
  10. Daha önce eklenen ekstra yapılandırmaları dosyadan kaldırın /opt/apigee/customer/application/cassandra.properties.
  11. Veri merkezindeki tüm Cassandra başlangıç düğümlerinde 3-10 arasındaki adımları tek tek tekrarlayın.
  12. Veri merkezindeki kalan tüm Cassandra düğümlerinde 3-10 arasındaki adımları tek tek tekrarlayın.
  13. Veri merkezindeki tüm düğümleri, eski Cassandra sürümünün çalıştığı bir veri merkezinden yeniden oluşturun. Bu adımı her seferinde bir düğüm olacak şekilde uygulayın: 
    /opt/apigee/apigee-cassandra/bin/nodetool rebuild -dc <name of working DC>

    Bu işlem biraz zaman alabilir. Gerekirse streamingthroughput ayarını yapabilirsiniz. İşlemin tamamlanma durumunu öğrenmek için nodetool netstats simgesini kontrol edin.

  14. (İsteğe bağlı) Veriler yeniden oluşturulmuyorsa Cassandra düğümünde onarım komutunu çalıştırın. 
    /opt/apigee/apigee-cassandra/bin/nodetool -h node-IP repair -pr
  15. Veri merkezindeki tüm edge-* bileşenlerini tek tek yeniden başlatın: 
    /opt/apigee/apigee-service/bin/apigee-service edge-message-processor restart
/opt/apigee/apigee-service/bin/apigee-service edge-router restart
/opt/apigee/apigee-service/bin/apigee-service edge-management-server restart
/opt/apigee/apigee-service/bin/apigee-service edge-qpid-server restart
/opt/apigee/apigee-service/bin/apigee-service edge-postgres-server restart
  16. Trafiği doğrulayın ve bu veri merkezine yönlendirin. Bu veri merkezinde çalışma zamanı trafiği ve yönetim API'leri için bazı doğrulama işlemleri yapın ve proxy ile yönetim API'si trafiğini tekrar bu veri merkezine yönlendirmeye başlayın.
  17. Geri almak istediğiniz her veri merkezi için yukarıdaki adımları tekrarlayın.

Yedeklemeyi kullanarak Cassandra'yı geri alma

Ön koşullar

  1. Cassandra'yı 3.11.X sürümünden 4.0.X sürümüne yükseltme sürecindesiniz ve yükseltme sırasında sorunlarla karşılaştınız.
  2. Geri döndürdüğünüz düğümün yedekleri olmalıdır. Yedek, 3.11.X sürümünden 4.0.X sürümüne yükseltme denenmeden önce alınmıştır.

Adımlar

  1. Geri sarmak istediğiniz bir düğümü seçin. Bir veri merkezindeki tüm düğümleri yedeklemeleri kullanarak geri alıyorsanız önce çekirdek düğümlerle başlayın. Ek'teki "Başlangıç düğümlerini tanımlama" bölümüne bakın.

  2. Cassandra düğümünü durdurma, kaldırma ve temizleme:

    # Stop Cassandra service on the node
/opt/apigee/apigee-service/bin/apigee-service apigee-cassandra stop

# Uninstall Cassandra software
/opt/apigee/apigee-service/bin/apigee-service apigee-cassandra uninstall

# Wipe Cassandra data
rm -rf /opt/apigee/data/apigee-cassandra

  3. Düğüme eski Cassandra yazılımını yükleyin ve yapılandırın:

    • Edge for Private Cloud 4.52.02 için bootstrap dosyasını yürütün:
      • # Download bootstrap for 4.52.02
curl https://software.apigee.com/bootstrap_4.52.02.sh -o /tmp/bootstrap_4.52.02.sh -u ‘uName:pWord’

# Execute bootstrap for 4.52.02
sudo bash /tmp/bootstrap_4.52.02.sh apigeeuser=uName apigeepassword=pWord
    • Dosyayı oluşturun veya düzenleyin /opt/apigee/customer/application/cassandra.properties:
      • conf_jvm_options_custom_settings=-Dcassandra.replace_address=ipOfNode -Dcassandra.allow_unsafe_replace=true
    • Dosyanın apigee kullanıcısına ait olduğundan ve okunabilir olduğundan emin olun:
      • chown apigee:apigee /opt/apigee/customer/application/cassandra.properties
    • Cassandra'yı yükleme ve ayarlama:
      • # Install Cassandra version 3.11.X
/opt/apigee/apigee-service/bin/apigee-service apigee-cassandra install

# Set up Cassandra with the standard configuration file
/opt/apigee/apigee-service/bin/apigee-service apigee-cassandra setup -f configFile

# Verify Cassandra version and check service status
/opt/apigee/apigee-service/bin/apigee-service apigee-cassandra version
/opt/apigee/apigee-service/bin/apigee-service apigee-cassandra status

    Düğümün başlatıldığını doğrulayın. Bu düğümde ve kümedeki diğer düğümlerde aşağıdaki komutu kontrol edin. Düğümler, bu düğümün "UN" durumunda olduğunu bildirmelidir:

    /opt/apigee/apigee-cassandra/bin/nodetool status

  4. Cassandra hizmetini durdurun ve yedeği geri yükleyin. Daha fazla bilgi için yedekleme ve geri yükleme belgelerini inceleyin:

    # Stop Cassandra service on the node
/opt/apigee/apigee-service/bin/apigee-service apigee-cassandra stop

# Wipe the data directory in preparation for restore
rm -rf /opt/apigee/data/apigee-cassandra/data

# Restore the backup taken before the upgrade attempt
/opt/apigee/apigee-service/bin/apigee-service apigee-cassandra restore backupFile

  5. Yedekleme geri yüklendikten sonra ek yapılandırmaları kaldırın:

    Daha önce eklenen yapılandırmayı dosyadan kaldırın /opt/apigee/customer/application/cassandra.properties.

  6. Düğümde Cassandra hizmetini başlatın:

    /opt/apigee/apigee-service/bin/apigee-service apigee-cassandra start

  7. Yedekleri kullanarak geri sarmak istediğiniz her Cassandra düğümünde adımları tek tek tekrarlayın.

  8. Tüm Cassandra düğümleri geri yüklendikten sonra, tüm edge-* bileşenlerini tek tek yeniden başlatın:

    /opt/apigee/apigee-service/bin/apigee-service edge-message-processor restart
/opt/apigee/apigee-service/bin/apigee-service edge-router restart
/opt/apigee/apigee-service/bin/apigee-service edge-management-server restart
/opt/apigee/apigee-service/bin/apigee-service edge-qpid-server restart
/opt/apigee/apigee-service/bin/apigee-service edge-postgres-server restart

Yedekleme optimizasyonları (gelişmiş seçenek)

En son verileri içeren kopyalarınız varsa yedeklemeleri geri yüklerken veri kaybını en aza indirebilir (veya tamamen ortadan kaldırabilirsiniz). Kopyalar varsa yedekleme geri yüklendikten sonra geri yüklenen düğümde onarım gerçekleştirin.

Ek

Başlangıç düğümleri nasıl belirlenir?

Bir veri merkezindeki herhangi bir Cassandra düğümünde aşağıdaki komutu çalıştırın:

/opt/apigee/apigee-service/bin/apigee-service apigee-cassandra configure -search conf_cassandra_seeds

Komut birden fazla satır çıkışı verir. Çıkışın son satırını bulun. Son satırda listelenen IP adresleri, başlangıç düğümleridir. Aşağıdaki örnekte DC-1-IP1, DC-1-IP2, DC-2-IP1 ve DC-2-IP2, başlangıç düğümü IP'leridir:

Found key conf_cassandra_seeds, with value, "127.0.0.1", in /opt/apigee/apigee-cassandra/token/default.properties

Found key conf_cassandra_seeds, with value, 127.0.0.1, in /opt/apigee/apigee-cassandra/token/application/cassandra.properties

Found key conf_cassandra_seeds, with value, "DC-1-IP1, DC-1-IP2, DC-2-IP1, DC-2-IP2", in /opt/apigee/token/application/cassandra.properties
apigee-configutil: apigee-cassandra: # OK

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

Önceki bir 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 dönmek istediğiniz sürümün bootstrap.sh dosyasını indirin:

    • 4.52.02 sürümüne geri dönmek için bootstrap_4.52.02.sh sürümünü indirin: 
      curl https://software.apigee.com/bootstrap_4.52.02.sh -o /tmp/bootstrap_4.52.02.sh
  2. Geri alma işlemi için bileşeni 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 İşleme 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 kodlu bileşenlerden herhangi birini geri almak için aşağıdaki örnekte gösterildiği gibi edge-gateway bileşen grubunu kaldırarak hepsini kaldırmanız gerekir: 
      /opt/apigee/apigee-service/bin/apigee-service edge-gateway uninstall
    2. Nginx'i aşağıdaki gibi geri döndürmek için: 
      ###Find the apigee-nginx RPM 
rpm -qa | grep -i "apigee-nginx"

###Remove the apigee-nginx RPM
dnf remove apigee-nginx-1.26.x
    3. 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.

    4. Edge yönlendiriciyi 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 uygulamasının 4.53.00 sürümünü kaldırın: 
    /opt/apigee/apigee-service/bin/apigee-service apigee-setup uninstall
  6. apigee-service aracının 4.52.02 sürümünü ve bağımlılıklarını yükleyin. Aşağıdaki örnekte apigee-service uygulamasının 4.52.02 sürümü yükleniyor: 
    sudo bash /tmp/bootstrap_4.52.02.sh apigeeuser=uName apigeepassword=pWord

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

    Hata mesajı 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 alıyorsanız iptables'ı temizleyin: 
    sudo iptables -F
  10. Geri almayı gerçekleştirdiğiniz 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 döndürmek için bileşeni barındıran her düğümde aşağıdakileri yapın:

  1. Belirli bir 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.53.00-0.0.20254 install

    Apigee online deposunu kullanıyorsanız aşağıdaki komutu kullanarak kullanılabilir 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üklerken yalnızca bileşen adını belirtirsiniz, sürümü değil.

  3. Geri almayı gerçekleştirdiğiniz bileşeni barındıran her düğüm için bu işlemi tekrarlayın.

mTLS'yi geri çekme

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