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 alıp güncellemeyi tekrar deneyebilirsiniz.

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

  • Sürüm 4.52.02

Bir sürümü geri almak, yükseltmiş olabileceğiniz her bileşeni geri almanızı gerektirir. Ayrıca, Cassandra'yı 4.52.02 sürümüne geri döndürürken özel hususları dikkate almanız gerekir.

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.53.00'den 4.52.02'ye.
  2. Aynı sürümdeki önceki bir yama sürümüne geri dönebilirsiniz. Ö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 tersine göre yapılmalıdır. Yönetim sunucularının Cassandra'dan sonra geri alınması istisnadır.

Private Cloud 4.53.00 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.02 sürümünden 4.53.00 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

Cassandra'yı geri alma

Belirli bir düğümde Cassandra'da büyük bir yükseltme yapıldığında Cassandra, söz konusu düğümde depolanan verilerin şemasını değiştirir. Bu nedenle, doğrudan yerinde geri alma işlemi yapılamaz.

Geri alma senaryoları

Private Cloud için Edge 4.53.00 ile sunulan 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 DC, bazı Cassandra düğümleri yükseltildi Yedekleme kullanma
Tek DC, tüm Cassandra düğümleri yükseltildi Cassandra'yı geri alma Diğer bileşenler geri alınabilir.
Tek DC, tüm düğümler (Cassandra ve diğerleri) yükseltildi Cassandra'yı geri alma Diğer bileşenler geri alınabilir.
Birden fazla DC, bir DC'deki bazı düğümler yükseltildi Mevcut DC'den yeniden oluşturma
Birden fazla DC, bazı DC'lerdeki tüm Cassandra düğümleri yükseltildi Mevcut DC'den yeniden oluşturma
Birden fazla DC, yükseltilen son DC'nin Cassandra düğümleri Yükseltmeyi tamamlamayı deneyin. Mümkün değilse yedeklemeyi kullanarak 1 DC'yi geri alın. Geri alınan DC'den geri kalan DC'leri yeniden oluşturun.
Birden fazla DC, tüm Cassandra düğümleri yükseltildi Cassandra'yı geri alma Diğer bileşenler geri alınabilir.
Birden fazla DC, tüm düğümler (Cassandra ve diğerleri) yükseltildi Cassandra'yı geri alma Diğer bileşenler geri alınabilir.

Genel olarak dikkat edilecek noktalar

Geri alma işlemini düşünürken 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 4.52.02 sürümüne geri almak istiyorsanız Cassandra'yı geri almamanız önerilir. Private Cloud 4.53.00 ile birlikte gönderilen Cassandra, Private Cloud için Edge 4.52.02'nin Cassandra dışındaki tüm bileşenleriyle uyumludur. Cassandra 4.0.13 sürümündeyken burada listelenen metodolojiyi kullanarak Cassandra dışındaki bileşenleri geri alabilirsiniz.
  • Cassandra kümesinin tamamı 4.0.X sürümüne yükseltildikten sonra geri alma: Private Cloud 4.53.00 sürümüne yükseltme kapsamında Cassandra kümenizin tamamı 4.0.X sürümüne yükseltilirse bu küme kurulumuyla devam etmeniz ve Cassandra'yı geri almamanız önerilir. Private Cloud 4.52.02 sürümünün edge-management-server, edge-message-processor, edge-router gibi bileşenleri Cassandra 4.0.X sürümüyle uyumludur.
  • Cassandra yükseltme işlemi sırasında Cassandra'yı geri alma: Cassandra yükseltme işlemi sırasında sorunla karşılaşırsanız geri alma işlemi yapabilirsiniz. Bu makalede listelenen geri alma stratejileri, yükseltme işlemi sırasında bulunduğunuz duruma göre uygulanabilir.
  • Yedekleme kullanarak geri alma: Cassandra 4.0.X'ten alınan yedekler, Cassandra 3.11.X yedekleriyle uyumlu değildir. Yedekleme geri yükleme özelliğini kullanarak Cassandra'yı geri almak için yükseltme yapmadan önce Cassandra 3.11.X'in yedeklerini almanız gerekir.

Yeniden oluşturma işlemini kullanarak Cassandra'yı geri alma

Ön koşullar

  • Birden fazla veri merkezinde Edge for Private Cloud 4.52.02 kümesi çalıştırıyorsanız.
  • 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) hâlâ çalıştıran en az bir tam işlevli veri merkeziniz var.

Bu işlem, mevcut bir veri merkezinden veri akışına dayanır. Bu işlem, Cassandra'da depolanan veri miktarına bağlı olarak önemli ölçüde zaman alabilir. Geri alma işlemi devam ederken çalışma zamanı trafiğinizi bu veri merkezinden başka bir yere yönlendirmeye hazır olmalısınız.

Üst düzey adımlar

  1. Geri almak 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 ana düğümü tanımlayın ve ana düğümlerden 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 gibi yapılandırın.
  5. Daha önce eklenen ekstra yapılandırmaları kaldırın.
  6. Veri merkezindeki tüm ana düğümler 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 çalışan veri merkezindeki düğümleri tek tek yeniden oluşturun.
  9. Veri merkezinde Cassandra'ya bağlı tüm edge-* bileşenlerini yeniden başlatın.
  10. Trafiği test edip bu veri merkezine yönlendirin.
  11. Adımları her veri merkezi için tek tek tekrarlayın.

Ayrıntılı adımlar

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

    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
    

    Kümenin tamamının mevcut durumunu anlamak için düğümlerde nodetool describecluster komutunu çalıştırabilirsiniz. Örneğin, aşağıdaki örnekte tüm DC-1 düğümlerinin Cassandra 4 sürümünde, tüm DC-2 düğümlerinin ise Cassandra 3 sürümünde olduğu 2 veri merkezi kümesi örneği gösterilmektedir:

    # 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 ana düğümleri tanımlama: Ek'teki Ana düğümleri tanımlama bölümüne bakın. Aşağıdaki adımları ana düğümlerden birinde uygulayın:
  3. Cassandra düğümünü durdurun, kaldırın ve düğümdeki verileri temizleyin. Bu veri merkezindeki Cassandra 4 sürümündeki ilk tohum düğümünü seçin. Durdur.
    # 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. Edge for Private Cloud 4.52.02'nin önyükleme dosyasını yürütü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
        

Cassandra yapılandırmalarını ayarlama

  1. /opt/apigee/customer/application/cassandra.properties dosyasını oluşturun veya düzenleyin.
  2. Dosyaya aşağıdaki içeriği 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
  3. Dosyanın apigee kullanıcısına ait olduğundan ve bu kullanıcı tarafından okunabilir olduğundan emin olun:
    chown apigee:apigee /opt/apigee/customer/application/cassandra.properties
  4. Cassandra'yı yükleme ve ayarlama:
    • Cassandra 3.11.X sürümünü yükleyin:
      /opt/apigee/apigee-service/bin/apigee-service apigee-cassandra install
    • Standart yapılandırma dosyasını ileterek Cassandra'yı ayarlayın:
      /opt/apigee/apigee-service/bin/apigee-service apigee-cassandra setup -f configFile
    • Cassandra 3.11.X'in yüklü ve hizmetin çalıştığından emin olun:
      /opt/apigee/apigee-service/bin/apigee-service apigee-cassandra version
      /opt/apigee/apigee-service/bin/apigee-service apigee-cassandra status
  5. Düğümün başladığını doğrulayın. Bu düğümde ve kümedeki diğer düğümlerde aşağıdaki komutu kontrol edin. Düğüm, "UN" (Yüksek/Normal) durumunda olduğunu bildirmelidir:
    /opt/apigee/apigee-cassandra/bin/nodetool status
  6. Daha önce eklenen ek yapılandırmaları /opt/apigee/customer/application/cassandra.properties dosyasından kaldırın.
  7. Veri merkezindeki tüm Cassandra tohum düğümlerinde 3 ile 6 arasındaki adımları tek tek tekrarlayın.
  8. Veri merkezindeki kalan tüm Cassandra düğümlerinde 3 ile 6 arasındaki adımları tek tek tekrarlayın.
  9. Eski Cassandra sürümünü çalıştıran bir veri merkezinden veri merkezindeki tüm düğümleri yeniden oluşturun. Bu adımı birer birer düğüm gerçekleştirin:
    /opt/apigee/apigee-cassandra/bin/nodetool rebuild -dc <name of working DC>
    Bu işlem biraz zaman alabilir. Gerekirse streamingthroughput değerini ayarlayabilirsiniz. Durumu şu şekilde kontrol edebilirsiniz:
    /opt/apigee/apigee-cassandra/bin/nodetool netstats
  10. 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
  11. Trafiği doğrulayın ve bu veri merkezine geri yönlendirin. Bu veri merkezinde çalışma zamanı trafiği ve yönetim API'leri için bazı doğrulamalar çalıştırın ve proxy ile yönetim API'si trafiğini bu veri merkezine yönlendirmeye başlayın.
  12. Geri almak istediğiniz her veri merkezi için yukarıdaki adımları tekrarlayın.

Yedekleme 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 yüklediğiniz düğümün yedekleri varsa. Yedekleme, 3.11.X sürümünden 4.0.X sürümüne yükseltme denemesi yapılmadan önce alınmıştır.

Adımlar

  1. Geri almak istediğiniz bir düğümü seçin. Yedeklemeleri kullanarak bir veri merkezindeki tüm düğümleri geri alıyorsanız önce ana düğümlerden başlayın. Ekteki "Tohum Düğümlerini Tanımlama" bölümüne bakın.

  2. Cassandra düğümünü durdurun, kaldırın ve temizleyin:

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

    • Özel Bulut için Edge 4.52.02 önyükleme 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
      
    • /opt/apigee/customer/application/cassandra.properties dosyasını oluşturun veya düzenleyin:
    • 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ükleyip 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şladığı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 yedeklemeyi geri yükleyin. Daha fazla bilgi için yedekleme ve geri yükleme belgelerine bakın:

    # 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ı /opt/apigee/customer/application/cassandra.properties dosyasından kaldırın.

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

    /opt/apigee/apigee-service/bin/apigee-service apigee-cassandra start
  7. Yedeklemeleri kullanarak geri almak 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 yedekleri geri yüklerken veri kaybını en aza indirebilir (veya ortadan kaldırabilirsiniz). Yedek kopya varsa yedeklemeyi geri yükledikten sonra, geri yüklenen düğümde bir onarım çalıştırın.

Ek

Tohum düğümlerini belirleme

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 çıktısı verir. Çıktının son satırını bulun. Son satırda listelenen IP adresleri, ana düğümlerdir. Aşağıdaki örnekte DC-1-IP1, DC-1-IP2, DC-2-IP1 ve DC-2-IP2, ana 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 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.52.02 sürümüne geri dönmek için bootstrap_4.52.02.sh dosyasını indirin:
      curl https://software.apigee.com/bootstrap_4.52.02.sh -o /tmp/bootstrap_4.52.02.sh 
  2. Bileşenin geri alınmasını durdurun:
    1. Noddaki 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'ın 4.53.00 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.52.02 sürümünü ve bağımlılıklarını yükleyin. Aşağıdaki örnekte, apigee-service'ın 4.52.02 sürümü yüklenir:
    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 öğesini atlarsanız girmeniz istenir.

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

  7. apigee-setup'ı 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ü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.53.00-0.0.20254 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 durdurun:
    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