Apigee Edge 4.54.00'ı geri alma

Edge 4.54.00 sürümüne 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.54.00'ı aşağıdaki ana sürüm versiyonlarından herhangi birine geri döndürebilirsiniz:

  • Sürüm 4.53.00
  • Sürüm 4.53.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 yapılmalıdır. Özel Bulut 4.54.00 için tipik bir genel geri alma sırası aşağıdaki gibi olacaktır:

  • Cassandra ve Zookeeper'ı geri alın.
  • Qpid'i, analizle ilgili diğer bileşenleri ve Postgres'i geri alın.
  • Kullanıcı arayüzünü geri alma
  • LDAP'yi geri alın.
  • Yönetim sunucusunu geri alın.
  • Yönlendiricileri ve Mesaj İşleyicileri geri alın.

Örneğin, tüm yönlendiricilerinizi ve mesaj işlemcilerinizi, tüm yönetim sunucularınızı, LDAP'yi ve birkaç kullanıcı arayüzü düğümünü 4.53.00 (veya) 4.53.01 sürümünden 4.54.00 sürümüne yükselttiğinizi ve geri almak istediğinizi varsayalım. Bu durumda, şunları yaparsınız:

  • Yükseltilmiş kullanıcı arayüzü düğümlerini geri alma
  • LDAP düğümlerini geri alma
  • Yönetim sunucusu düğümlerini tek tek geri alma
  • Tüm RMP'leri tek tek geri çekme

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ı olmalı veya root olarak çalışan bir kullanıcı 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ö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.

Cassandra'yı geri döndürme

Belirli bir düğümde Cassandra'nın önemli 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ı

Aşağıdaki tabloda, kullanabileceğiniz geri alma stratejileri özetlenmiştir:

Senaryo Geri alma stratejisi
Tek veri merkezi, bazı Cassandra düğümleri yükseltildi Yedekleri kullanma
Birden fazla veri merkezi, bir veri merkezindeki bazı düğümler yeni sürüme geçirildi 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
Birden fazla veri merkezi, son veri merkezinin Cassandra düğümleri yükseltiliyor Yükseltme işlemini tamamlamayı deneyin. Bu mümkün değilse yedeklemeyi kullanarak 1 DC'yi geri alın. Geri alınan DC'den kalan DC'leri yeniden oluşturun.

Genel olarak dikkat edilecek noktalar

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

  • Cassandra yükseltmesi sırasında Cassandra'yı geri alma: Cassandra yükseltmesi sırasında sorunlarla karşılaşırsanız geri alma işlemini düşünebilirsiniz. Yükseltme işlemi sırasında durumunuza göre bu makaledeki geri alma stratejilerini uygulayın.
  • Yedekleri kullanarak geri alma: Cassandra 5.0.X'ten alınan yedekler, Cassandra 4.0.X yedekleriyle uyumlu değildir. Yedekleme geri yükleme özelliğini kullanarak Cassandra'yı geri almak için yükseltme işleminden önce Cassandra 4.0.X'in yedeklerini almanız gerekir.

Yeniden oluşturma özelliğini kullanarak Cassandra'yı geri alma

Ön koşullar

  • Birden fazla veri merkezinde Edge for Private Cloud 4.53.00/4.53.01 kümesi çalıştırıyorsunuz.
  • Cassandra'yı 4.0.X sürümünden 5.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 4.0.X) çalıştıran en az bir tam işlevli veri merkeziniz vardır.

Bu prosedür, mevcut bir veri merkezinden gelen akış verilerine dayanır. Cassandra'da depolanan veri miktarı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 başka bir yere yönlendirmeye hazır olmanız gerekir.

Kısaca 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 çekirdek düğümü belirleyin ve çekirdek 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 şekilde yapılandırın.
  5. Daha önce eklenen ek yapılandırmaları kaldırın.
  6. Veri merkezindeki tüm temel 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 işlevsel veri merkezindeki düğümleri teker teker yeniden oluşturun.
  9. Veri merkezinde Cassandra'ya bağlı 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 tüm çalışma zamanı proxy trafiğini ve yönetim trafiğini bu veri merkezinden başka bir yere 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 çalışmıyorsa devam etmeden önce sorunu giderin ve bu düğümleri tekrar çalışır duruma getirin.

    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ğı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 merkezli bir küme ö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:
    5.0.8: [DC-1-IP1:7000, DC-1-IP2:7000, DC-1-IP3:7000]
    4.0.13: [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 çekirdek düğümleri tanımlayın: Ek bölümündeki Çekirdek düğümler nasıl tanımlanır? başlıklı bölüme bakın. Çekirdek düğümlerden birinde aşağıdaki adımları uygulayın:
  3. Cassandra düğümündeki verileri durdurun, kaldırın ve temizleyin. Bu veri merkezinde Cassandra 5 sürümündeki ilk çekirdek düğümü 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ükleyip bazı yapılandırmaları ayarlayın. Edge for Private Cloud 4.53.00/4.53.01'in önyükleme dosyasını yürütün. 
    5. # Download bootstrap of 4.53.00
curl https://software.apigee.com/bootstrap_4.53.00.sh -o /tmp/bootstrap_4.53.00.sh -u uName:pWord

# Execute bootstrap of 4.53.00
sudo bash /tmp/bootstrap_4.53.00.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 dosyanın apigee kullanıcısı tarafından okunabildiğinden emin olun: 
    chown apigee:apigee /opt/apigee/customer/application/cassandra.properties
  8. Cassandra'yı yükleme ve ayarlama:
    9. # Install cassandra version 4.0.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ün "UN" (Up/Normal) durumunda olduğunu bildirmesi gerekir: 
    /opt/apigee/apigee-cassandra/bin/nodetool status
  10. Daha önce eklenen fazla 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 ile 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ı değiştirebilirsiniz. İşlemin tamamlanma durumu için nodetool netstats adresini kontrol edin.

  14. (İsteğe bağlı) Veriler yeniden oluşturulmuyorsa Cassandra düğümünde onarım komutunu yürütü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ğrulamalar çalıştırı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.

Yedekleme özelliğini kullanarak Cassandra'yı geri alma

Ön koşullar

  1. Cassandra'yı 4.0.X sürümünden 5.0.X sürümüne yükseltme sürecindesiniz ve yükseltme sırasında sorunlarla karşılaştınız.
  2. Geri aldığınız düğüm için yedekleriniz olmalıdır. Yedekleme, 4.0.X'ten 5.0.X'e yükseltme işlemi denenmeden önce alınmıştır.

Adımlar

  1. Geri almak 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 Çekirdek düğümleri belirleme 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.53.00/4.53.01'in bootstrap dosyasını yürütün:
      • # Download bootstrap for 4.53.00
curl https://software.apigee.com/bootstrap_4.53.00.sh -o /tmp/bootstrap_4.53.00.sh -u uName:pWord

# Execute bootstrap for 4.53.00
sudo bash /tmp/bootstrap_4.53.00.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ükleyip ayarlayın:
      • # Install Cassandra version 4.0.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 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 yedeklemeleri geri yüklerken veri kaybını en aza indirebilir (veya tamamen ortadan kaldırabilirsiniz). Replika varsa yedeklemeyi geri yükledikten sonra geri yüklenen düğümde onarım işlemi çalıştırın.

Ek

Başlangıç 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 çıkışı verir. Çıkışın son satırına bakın. Son satırda listelenen IP adresleri, temel düğümlerdir. Aşağıdaki örnekte DC-1-IP1, DC-1-IP2, DC-2-IP1 ve DC-2-IP2, temel 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

ZooKeeper'ı geri alma

Geri al

Geri alma işlemi gerekirse:

  1. Geri alma adımlarını önce gözlemciler ve takipçiler üzerinde uygulayın. Gözlemcileri ve takipçileri seçmek için lütfen Lider, takipçi ve gözlemcileri belirleme bölümüne bakın.
  2. Geri döndüğünüz sürümün (4.53.00 veya 4.53.01) önyüklemesini indirip çalıştırın. İşlem, büyük olasılıkla düğümün harici bir internet bağlantısı olup olmamasına veya çevrimdışı kurulumu takip edip etmemenize bağlı olarak değişir.
  3. Düğümde çalışıyorsa Zookeeper'ı durdurun: 
      /opt/apigee/apigee-service/bin/apigee-service apigee-zookeeper stop
  4. Mevcut ZooKeeper'ı kaldırın: 
      /opt/apigee/apigee-service/bin/apigee-service apigee-zookeeper uninstall
  5. Zookeeper'ı her zamanki gibi yükleyin: 
      /opt/apigee/apigee-setup/bin/setup.sh -p zk -f <silent-config-file>
  6. Tüm takipçi ve gözlemci düğümler geri alındıktan sonra, lider düğümde 2 ila 5. adımları uygulayarak lider düğümü geri alın.
  7. Tüm düğümler geri alındıktan sonra küme durumunu doğrulayın ve kümede bir lider düğüm olduğundan emin olun.

Yedeği geri yükle

Yedekten geri yükleme başlıklı makaleyi inceleyin.

Qpid'i geri alma

Önceki bir özellik sürümüne geri dönmek için geri dönmek istediğiniz sürümün bootstrap.sh dosyasını indirdiğinizden emin olun. 4.53.00/4.53.01 sürümüne geri dönmek için bootstrap_4.53.00.sh sürümünü indirin.

Qpid'yi geri almak için tüm Qpid ana makinelerinde aşağıdaki adımları uygulayın:

  1. Mevcut Qpid aracısını durdurun: 
    apigee-service apigee-qpidd stop
  2. Güvenlik duvarı uygulayarak 5672 numaralı aracı bağlantı noktasındaki gelen trafiği tüm Mesaj İşleyicilerden engelleyin. Bu güvenlik duvarını Qpid düğüm örneği düzeyinde veya başka bir harici güvenlik duvarı/ağ bileşeni düzeyinde uygulayabilirsiniz.

    Tüm mesaj işleyici IP adresleri için aynı adımı uygulamanızı öneririz. Örneğin, IPTables kullanarak mesaj işlemcisi IP adreslerinden gelen istekleri 5672 numaralı bağlantı noktasındaki Qpid düğümüne bırakmak için aşağıdaki gibi bir komut kullanabilirsiniz:

    iptables -A INPUT -p tcp --dport 5672 -s MESSAGE_PROCESSOR_IP -j DROP
  3. Varsa mevcut mesajları boşaltmak için Qpid aracısını tekrar başlatın: 
    apigee-service apigee-qpidd start
  4. Mevcut sıraların boş olduğundan emin olun. Kontrol etmek için Qpid yönetim portalına giriş yapın: 
    http://QPID_NODE_IP:8090
  5. Kuyrukların boşaldığını doğruladıktan sonra Qpid'i durdurun ve kaldırın: 
    /opt/apigee/apigee-service/bin/apigee-service apigee-qpidd stop
/opt/apigee/apigee-service/bin/apigee-service apigee-qpidd uninstall
  6. Qpid veri dizinini silin: 
    rm -r APIGEE_ROOT/data/apigee-qpidd
  7. Qpid aracısını yeniden yükleyin: 
    /opt/apigee/apigee-setup/bin/setup.sh -p qs -f configFile
  8. Qpid aracısı yeniden yüklendikten sonra güvenlik duvarı ayarlarını kaldırın ve aşağıdaki komutları kullanarak mevcut ayarları listeleyin: 
    iptables -F
iptables -L

Postgres'i geri alma

4.54.00 sürümünden 4.53.00/4.53.01 sürümüne düşürmek için Edge bileşenlerine ek olarak Postgres güncellemenizi de geri almanız gerekir.

Postgres'i ana-yedek yapılandırmasında güncellerken Postgres güncellemesini geri almak için:

  • Yeni bekleme düğümünü Postgres ana düğümü olacak şekilde yükseltin. Yeni Postgres ana sürümü, önceki Edge kurulumunuzla aynı sürüm olacaktır.
  • Eski bekleme düğümünü yeni ana düğümün bekleme düğümü olacak şekilde yapılandırın. Eski yedek düğüm, önceki Edge yüklemenizle aynı sürümde olacaktır.
  • Yeni ana ve yedek düğümleri analiz ve tüketici gruplarına kaydedin.

Geri alma işlemi tamamlandığında eski ana düğüme artık gerek kalmaz. Daha sonra eski ana düğümün hizmetini durdurabilirsiniz.

Başlamadan önce

Postgres 18'i 17/14'e geri döndürmeden önce, max_locks_per_transaction özelliğini apigee-postgresql üzerinde güncellemek için hem yeni bekleme ana makinesinde hem de eski bekleme ana makinesinde aşağıdaki adımları uygulayın:

  1. Yoksa /opt/apigee/customer/application/postgresql.properties dosyasını oluşturun.
  2. Bu dosyanın sahipliğini apigee olarak değiştirin: 
    sudo chown apigee:apigee /opt/apigee/customer/application/postgresql.properties
  3. Dosyaya aşağıdaki özelliği ekleyin: 
    conf/postgresql.conf+max_locks_per_transaction=30000
  4. apigee-postgresql'i yapılandırın: 
    apigee-service apigee-postgresql configure
  5. apigee-postgresql'i yeniden başlatın: 
    apigee-service apigee-postgresql restart

Ayrıntılı geri alma prosedürü

  1. Yeni bekleme Postgres düğümünün çalıştığından emin olun: 
    /opt/apigee/apigee-service/bin/apigee-all status

    Postgres çalışmıyorsa başlatın:

    /opt/apigee/apigee-service/bin/apigee-all start
  2. Postgres'in eski ana düğümde ve eski bekleme düğümünde durdurulduğundan emin olun: 
    /opt/apigee/apigee-service/bin/apigee-all status

    Postgres çalışıyorsa durdurun: 

    /opt/apigee/apigee-service/bin/apigee-service edge-postgres-server stop  
/opt/apigee/apigee-service/bin/apigee-service apigee-postgresql stop
  3. Yüklüyse eski bekleme düğümünde Qpid'yi başlatın: 
    /opt/apigee/apigee-service/bin/apigee-service edge-qpid-server start
  4. Yeni bekleme düğümünü Postgres ana düğümü olarak yükseltin:
    1. Yeni bekleme düğümünü yeni ana makine olarak yükseltin: 
      apigee-service apigee-postgresql promote-standby-to-master old_master_IP

      İstenirse "apigee" kullanıcısı için Postgres şifresini girin. Bu şifre varsayılan olarak "postgres"tir.

    2. Edge'in mevcut sürümünü yüklemek için kullandığınız yapılandırma dosyasını düzenleyerek aşağıdakileri belirtin: 
      # IP address of the new master:
PG_MASTER=new_standby_IP
# IP address of the old standby node
PG_STANDBY=old_standby_IP
    3. Yeni ana anahtarı yapılandırın:
      /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql setup-replication-on-master -f configFile
  5. Eski bekleme düğümünü daha yeni sürüme zaten yükselttiyseniz öncelikle eski bekleme düğümündeki Apigee yazılımını eski sürüme geçirmeniz gerekir. Eski yedek düğümde hâlâ eski sürüm varsa bu adımı atlayıp 6. adımdan devam edebilirsiniz.
    1. Eski yedek düğümde Postgres'i durdurun: 
      apigee-service apigee-postgresql stop
apigee-service edge-postgres-server stop
    2. Postgres'i eski yedek düğümden kaldırın: 
      apigee-service apigee-postgresql uninstall
apigee-service edge-postgres-server uninstall
apigee-service edge-analytics uninstall
    3. Postgres veri dizinini eski bekleme düğümünden silin: 
      cd /opt/apigee/data/apigee-postgresql/pgdata
rm -rf *
    4. Eski bekleme düğümünde eski sürüm önyüklemesini (geri döndüğünüz Apigee sürümü için) indirip çalıştırın. Uygulanacak adımlar, internet tabanlı veya çevrimdışı yükleme kullanmanıza bağlı olarak değişiklik gösterebilir. Apigee önyüklemesinin eski sürümünü çalıştırmak, yum depolarını eski sürüm Apigee verileriyle ayarlar.
    5. Eski yedek düğümde Postgres bileşenlerini ayarlayın: 
      /opt/apigee/apigee-setup/bin/setup.sh -p ps -f configFile
    6. Eski yedek düğümdeki Postgres bileşenlerinin eski sürüme geri alındığını kontrol edin ve doğrulayın: 
      apigee-service apigee-postgresql version
apigee-service edge-postgres-server version
  6. Eski bekleme düğümünü yeniden oluşturun:
    1. Edge'in mevcut sürümünü yüklemek için kullandığınız yapılandırma dosyasını düzenleyerek aşağıdakileri belirtin: 
      # IP address of the new master:
PG_MASTER=new_standby_IP
# IP address of the old standby node
PG_STANDBY=old_standby_IP
    2. Eski bekleme düğümündeki veri dizinini kaldırın: 
      cd /opt/apigee/data/apigee-postgresql/pgdata
rm -rf *
    3. Eski bekleme düğümünü yeni ana düğümün bekleme düğümü olacak şekilde yeniden yapılandırın: 
      /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql setup-replication-on-standby -f configFile
    4. Postgres'in eski bekleme düğümünde çalıştığından emin olun: 
      /opt/apigee/apigee-service/bin/apigee-all status

      Postgres çalışmıyorsa başlatın:

      /opt/apigee/apigee-service/bin/apigee-service edge-postgres-server start
  7. Yeni ana düğümdeki /opt/apigee/apigee-postgresql/conf/pg_hba.conf dosyasını görüntüleyerek yeni bekleme düğümünün eklendiğini doğrulayın.
  8. Yönetim sunucusunda aşağıdaki komutu çalıştırarak mevcut analizleri ve tüketici grubu bilgilerini görüntüleyin: 
    curl -u sysAdminEmail:password http://ms_IP:8080/v1/analytics/groups/ax

    Bu komut, name alanında analiz grubu adını ve consumer-groups altındaki name alanında tüketici grubu adını döndürür. Ayrıca, postgres-server ve datastores alanlarında eski Postgres ana ve bekleme düğümlerinin UUID'lerini döndürür. Aşağıdaki biçimde bir çıkış görürsünüz: 

    {
  "name" : "axgroup-001",
  "properties" : {
  },
  "scopes" : [ "VALIDATE~test", "sgilson~prod" ],
  "uuids" : {
    "qpid-server" : [ "8381a053-433f-4382-bd2a-100fd37a1592", "4b6856ec-ef05-498f-bac6-ef5f0d5f6521" ],
    "postgres-server" : [
      "ab1158bd-1d59-4e2a-9c95-24cc2cfa6edc:27f90844-efab-4b32-8a23-8f85cdc9a256"
    ]
  },
  "consumer-groups" : [ {
    "name" : "consumer-group-001",
    "consumers" : [ "8381a053-433f-4382-bd2a-100fd37a1592", "4b6856ec-ef05-498f-bac6-ef5f0d5f6521" ],
    "datastores" :
      [ "ab1158bd-1d59-4e2a-9c95-24cc2cfa6edc:27f90844-efab-4b32-8a23-8f85cdc9a256" ],
      "properties" : {     }
    }
  ],
  "data-processors" : {
  }
}
  9. Eski ana düğümde aşağıdaki curl komutunu çalıştırarak eski ana düğümün UUID adresini alın: 
    curl -u sysAdminEmail:password http://node_IP:8084/v1/servers/self

    Çıkışın sonunda düğümün UUID'sini şu biçimde görürsünüz:

    "type" : [ "postgres-server" ],
"uUID" : "599e8ebf-5d69-4ae4-aa71-154970a8ec75"
  10. Eski yedek düğümün ve yeni ana düğümün IP adreslerini almak için önceki adımı tekrarlayın.
  11. Eski ana ve bekleme düğümlerini tüketici grubundan kaldırın: 
    curl -u sysAdminEmail:password -X DELETE \
  "http://ms_IP:8080/v1/analytics/groups/ax/axgroup-001/consumer-groups/consumer-group-001/datastores/masterUUID,standbyUUID" -v

    axgroup-001 ve consumer-group-001, analiz ve tüketici gruplarının varsayılan adlarıdır. masterUUID,standbyUUID, yukarıdaki mevcut analiz ve tüketici grubu bilgilerini görüntülediğinizde gösterilen sırayla gösterilir. Bunları standbyUUID,masterUUID olarak belirtmeniz gerekebilir.

    consumer-groups için datastores özelliği artık boş olmalıdır.

  12. Eski ana ve bekleme düğümlerini analiz grubundan kaldırın: 
    curl -u sysAdminEmail:password -X DELETE \
  "http://ms_IP:8080/v1/analytics/groups/ax/axgroup-001/servers?uuid=masterUUID,standbyUUID&type=postgres-server" -v

    uuids altındaki postgres-server özelliği artık boş olmalıdır.

  13. Analiz ve tüketici gruplarıyla yeni PG ana ve bekleme düğümlerini kaydedin:
    curl -u sysAdminEmail:password -X POST -H "Content-Type: application/json" -d ''
  "http://ms_IP:8080/v1/analytics/groups/ax/axgroup-001/servers?uuid=masterUUID,standbyUUID&type=postgres-server" -v
curl -u sysAdminEmail:password -X POST -H "Content-Type:application/json" -d ''
  "http://ms_IP:8080/v1/analytics/groups/ax/axgroup-001/consumer-groups/consumer-group-001/datastores?uuid=masterUUID,standbyUUID" -v
  14. Analiz grubunu doğrulayın: 
    curl -u sysAdminEmail:password http://ms_IP:8080/v1/analytics/groups/ax

    Yeni ana ve bekleme düğümlerinin UUID'lerini analiz grubunda ve tüketici grubunda listelenmiş olarak görmeniz gerekir.

  15. Edge Management Server'ı yeniden başlatın: 
    /opt/apigee/apigee-service/bin/apigee-service edge-management-server restart
  16. Tüm Qpid sunucularını yeniden başlatın: 
    /opt/apigee/apigee-service/bin/apigee-service edge-qpid-server restart
  17. Tüm Postgres sunucularını yeniden başlatın: 
    /opt/apigee/apigee-service/bin/apigee-service edge-postgres-server restart
  18. Her iki sunucuda da aşağıdaki komut dosyalarını vererek replikasyon durumunu doğrulayın. Sistem, başarılı bir replikasyon sağlamak için her iki sunucuda da aynı sonuçları göstermelidir:

    Yeni ana sunucuda şunu çalıştırın:

    /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql postgres-check-master

    Anahtar olduğunu doğrulayın. Eski yedek düğümde şu komutu çalıştırın:

    /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql postgres-check-standby

    Bekleme modunda olduğunu doğrulayın.

  19. Düğümlerin senkronize olduğundan emin olmak için birkaç API isteği yaptıktan sonra önceki adımı tekrarlayın.
  20. Eski Postgres ana düğümünü kullanımdan kaldırın:

    Alternatif olarak, Qpid'i eski ana düğümden kaldırıp yeni ana düğüme yükleyebilirsiniz. Qpid'i kaldırdıktan sonra eski ana düğümü kullanımdan kaldırabilirsiniz.

Yeni Edge kullanıcı arayüzünü geri alma

Apigee Edge for Private Cloud 4.54.00, klasik kullanıcı arayüzünün (edge-ui) yerine yeni Edge kullanıcı arayüzünü (edge-management-ui) getirir. Kullanıcı arayüzü bileşeni 4.54.00 sürümünde değiştiği için 4.53.00 veya 4.53.01 sürümüne geri dönmek için edge-management-ui sürümünü kaldırıp önceki kullanıcı arayüzü profilinizi yeniden yüklemeniz gerekir:

  • Klasik kullanıcı arayüzü (edge-ui): ui profilini yeniden yükleyin.
  • Yeni Edge kullanıcı arayüzü (edge-ui ve edge-management-ui): Hem ui hem de ue profillerini ilgili düğümlerine yeniden yükleyin.

Bir düğümdeki kullanıcı arayüzünü geri döndürmek için:

  1. 4.54.00 yeni Edge kullanıcı arayüzünü durdurup kaldırın ve geri almak için önceki sürümü yükleyin:
    1. 4.54.00 New Edge kullanıcı arayüzünü durdurun ve kaldırın (edge-management-ui): 
      /opt/apigee/apigee-service/bin/apigee-service edge-management-ui stop
/opt/apigee/apigee-service/bin/apigee-service edge-management-ui uninstall
/opt/apigee/apigee-service/bin/apigee-service edge-management-ui-static uninstall
    2. Apigee Edge for Private Cloud 4.53.00/4.53.01 için önyükleme dosyasını yürütün: 
      # Download bootstrap for 4.53.00
curl https://software.apigee.com/bootstrap_4.53.00.sh -o /tmp/bootstrap_4.53.00.sh -u uName:pWord

# Execute bootstrap for 4.53.00
sudo bash /tmp/bootstrap_4.53.00.sh apigeeuser=uName apigeepassword=pWord
    3. apigee-setup'ı 4.54.00 sürümünden önceki sürüme geri döndürme: 
      # Uninstall apigee-setup
/opt/apigee/apigee-service/bin/apigee-service apigee-setup uninstall

# Install apigee-setup
/opt/apigee/apigee-service/bin/apigee-service apigee-setup install
  2. 4.53.00/4.53.01 kullanıcı arayüzü yapılandırmalarınızı geri yükleme:
    • 4.53.00 veya 4.53.01 sürümünü yüklerken sessiz yapılandırma dosyasını yedeklediyseniz geri alma işlemi için bu yedek dosyayı kullanın. Aksi takdirde, 4.54.00 sürümündeki sessiz yapılandırma dosyanızda, yükseltme sırasında kaldırılan veya yorum satırı haline getirilen 4.53.00 ya da 4.53.01 sürümündeki kullanıcı arayüzü özelliklerini geri yükleyin veya yorum satırı olmaktan çıkarın. Referans için Kullanıcı arayüzü yükseltme bölümüne bakın.
    • /opt/apigee/customer/application/ui.properties, yükseltme sırasında silindiyse yedekleme dizininden geri yükleyin: 
      cp -rf /opt/apigee/backup/ui/customer/application/ui.properties /opt/apigee/customer/application/
chown apigee:apigee /opt/apigee/customer/application/ui.properties
  3. Önceki kullanıcı arayüzü sürümünü yeniden yükleyip yapılandırma:
    • Klasik kullanıcı arayüzüne geri dönün (edge-ui):
      1. Klasik kullanıcı arayüzünü yükleyin ve ayarlayın (Temel Kimlik Doğrulama için ek adım gerekmez): 
        /opt/apigee/apigee-setup/bin/setup.sh -p ui -f configFile
      2. TOA etkinse klasik kullanıcı arayüzünde TOA'yı yapılandırın (önce apigee-sso hizmetinin çalıştığından emin olun): 
        /opt/apigee/apigee-service/bin/apigee-service edge-ui configure-sso -f configFile
    • 4.53.00 veya 4.53.01 Yeni Edge kullanıcı arayüzüne geri dönme (edge-management-ui ve Shoehorn edge-ui):
      1. Sessiz yapılandırma dosyasında EDGEUI_ENABLE_UNIFIED_UI=y değerinin ayarlandığından emin olun, ardından ui ve ue profillerini yükleyip ayarlayın: 
        /opt/apigee/apigee-setup/bin/setup.sh -p ui -f configFile
/opt/apigee/apigee-setup/bin/setup.sh -p ue -f configFile
      2. TOA etkinse, TOA'yı her iki kullanıcı arayüzü bileşeninde de yapılandırın (önce apigee-sso'ın çalıştığından emin olun): 
        /opt/apigee/apigee-service/bin/apigee-service edge-ui configure-sso -f configFile
/opt/apigee/apigee-service/bin/apigee-service edge-management-ui configure-sso -f configFile
  4. Önceki sürüme döndürülen kullanıcı arayüzü durumunu ve sürümünü doğrulayın:
    • Klasik kullanıcı arayüzü (edge-ui) için: 
      /opt/apigee/apigee-service/bin/apigee-service edge-ui status
/opt/apigee/apigee-service/bin/apigee-service edge-ui version
    • Yeni Edge kullanıcı arayüzü (edge-management-ui) için: 
      /opt/apigee/apigee-service/bin/apigee-service edge-management-ui status
/opt/apigee/apigee-service/bin/apigee-service edge-management-ui version

OpenLDAP'ı geri çekme

Bu bölümde, Edge for Private Cloud 4.54.00'deki Symas OpenLDAP 2.6.10'u OpenLDAP 2.4.46 (Edge for Private Cloud 4.53.00) veya Symas OpenLDAP 2.6.7'ye (Edge for Private Cloud 4.53.01) geri alma işlemiyle ilgili adım adım açıklamalı bir kılavuz sunulmaktadır. Geri alma işlemini, yükseltme öncesi geçerli bir LDAP yedeğini kullanarak tüm LDAP kümesinde gerçekleştirmeniz gerekir.

Asıl amaç, tüm LDAP kümesini bilinen iyi bir yedekten tutarlı bir duruma geri döndürmektir. Bu prosedür tüm senaryolar (tek sunuculu, etkin-etkin ve etkin-pasif) için aynıdır.

Başlamadan önce

  • Yedekleme uyumsuzluğu: Yükseltme denemesinden önce apigee-service apigee-openldap backup kullanılarak alınan OpenLDAP 2.4.46 (Edge for Private Cloud 4.53.00) veya Symas OpenLDAP 2.6.7 (Edge for Private Cloud 4.53.01) sürümünden yükseltme öncesi bir yedekleme kullanın. Yükseltme işleminden sonra alınan yedekler uyumlu değildir ve kullanılamaz.
  • Management API kesinti süresi: LDAP geri alma işlemi sırasında Management API'ler kullanılamayacak. Bu durum, yönetim görevlerini etkileyebilir. LDAP geri alma işlemine devam etmeden önce tüm edge-management-server ve edge-ui örneklerini kapatın.
  • Veri kaybı riski: Geçerli ve uyumlu bir yedekleme olmadan devam etmek, geri alınamaz veri kaybına yol açabilir.
  • Geçerli yedekleme: Yükseltme öncesinde geçerli bir LDAP yedeklemesi gerekir.
  • silent.conf dosyalarının yedeği: Yeni sürüme geçme ve geri alma işlemleri sırasında yapılandırma karışıklıklarını önlemek için hem önceki hem de mevcut sürümlerdeki silent.conf dosyalarınızın yedeklerini saklayın.
  • Geri alma sırası: OpenLDAP'yi geri almadan önce Cassandra, ZooKeeper, Qpid, PostgreSQL, apigee-sso ve Edge kullanıcı arayüzü için geri alma prosedürlerini tamamlayın.

Geri alma prosedürü

  1. Yönetim sunucusunu ve kullanıcı arayüzünü kapatma: LDAP geri alma işlemine devam etmeden önce tüm edge-management-server ve edge-ui örneklerini kapatın: 
    apigee-service edge-management-server stop
apigee-service edge-ui stop
  2. Mevcut LDAP girişi sayısını kaydedin (LDAP'yi durdurmadan önce): Tüm LDAP sunucularından referans için toplam kayıt sayısını alın. YOUR_PASSWORD yerine mevcut LDAP yöneticisi şifrenizi girin. (Kayıt sayısı tüm LDAP sunucularında aynı olmalıdır.) 
    # Note: Replace 'YOUR_PASSWORD' with your current LDAP manager password.
ldapsearch -o ldif-wrap=no -b "dc=apigee,dc=com" -D "cn=manager,dc=apigee,dc=com" -H ldap://:10389 -LLL -x -w 'YOUR_PASSWORD' | wc -l
  3. Yeni LDAP 2.6'yı durdurun ve kaldırın: apigee-openldap hizmetini durdurun ve yapılandırma ile veri dizinlerini silin. Tutarlılığı sağlamak için bu adımı kümedeki her bir düğümde, birer birer tüm LDAP sunucularında uygulayın: 
    apigee-service apigee-openldap stop
apigee-service apigee-openldap uninstall
rm -rf /opt/apigee/data/apigee-openldap/*
  4. Önceki LDAP sürümü 2.4.46 veya 2.6.7'yi yükleyin:
    • Eski LDAP sürümünü yükleme: 
      /opt/apigee/apigee-setup/bin/setup.sh -p ld -f /opt/silent.conf
    • LDAP sürümünü doğrulama: 
      source ~/.bash_profile
ldapsearch -VV

# Expected output if rolled back to 4.53.00:
ldapsearch: @(#) $OpenLDAP: ldapsearch 2.4.46

# Expected output if rolled back to 4.53.01:
ldapsearch: @(#) $OpenLDAP: ldapsearch 2.6.7
    • 4. adımdaki alt adımları her bir LDAP düğümünde teker teker tekrarlayın.
  5. Kalan verileri temizleyin: Tüm LDAP sunucularında, her seferinde bir sunucu olmak üzere yeni yüklenen hizmeti durdurun ve yedeklemeden geri yüklemeye hazırlanmak için veri dizinini temizleyin: 
    apigee-service apigee-openldap stop
rm -rf /opt/apigee/data/apigee-openldap/*
  6. LDAP verilerini geri yükleme: Tek sunuculu bir kurulum için doğrudan 6b adımına geçin. Çok sunuculu kurulum için 6a adımıyla devam edin.
    1. Etkin LDAP sunucusunu belirleyin: LDAP verilerini geri yüklemeden önce şu komutu çalıştırarak etkin sunucuyu (sağlayıcı) belirleyin: 
      grep -i '^olcSyncrepl:' /opt/apigee/data/apigee-openldap/slapd.d/cn=config/olcDatabase*.ldif
    2. LDAP verilerini geri yükleyin (geri yüklemeden önce 5. adımın tüm sunucularda tamamlandığından emin olun):
      • Tek veya etkin LDAP sunucusunda (6a adımında belirlenir) yedekleme dizinine gidin ve yükseltme öncesi yedeği geri yükleyin (örneğin, 2025.07.28,13.59.00 veya yükseltme öncesi yedek, dizindeki en son yedekse zaman damgasını atlayın): 
        cd /opt/apigee/backup/openldap

# To restore a specific backup, provide the timestamp as shown below:
apigee-service apigee-openldap restore 2025.07.28,13.59.00

# Note: If no timestamp is provided, the latest available backup will be restored by default:
apigee-service apigee-openldap restore

# It is recommended to specify the backup explicitly to avoid restoring an unintended version.
      • apigee-openldap hizmetini başlatın: 
        apigee-service apigee-openldap start
  7. Kalan LDAP sunucularını başlatın: Çok sunuculu bir kurulumunuz varsa kalan LDAP sunucularının her birinde hizmeti başlatın: 
    apigee-service apigee-openldap start
  8. Son doğrulama:
    • Geri alma işleminin başarılı olduğunu ve verilerin tüm LDAP kümesinde tutarlı olduğunu doğrulayın.
    • Doğrulama komutunu tüm LDAP sunucularında çalıştırın ve YOUR_PASSWORD ifadesini mevcut LDAP yöneticisi şifrenizle değiştirin. Kayıt sayısı tüm sunucularda aynı olmalı ve 2. adımda yakaladığınız sayıyla eşleşmelidir: 
      # Note: Replace 'YOUR_PASSWORD' with your current LDAP manager password.
ldapsearch -o ldif-wrap=no -b "dc=apigee,dc=com" -D "cn=manager,dc=apigee,dc=com" -H ldap://:10389 -LLL -x -w 'YOUR_PASSWORD' | wc -l
    • Verilerin doğru ve tutarlı olduğunu onayladıktan sonra kuruluşunuzun standart prosedürüne göre edge-management-server, edge-ui ve diğer bağımlı bileşenleri başlatın.

Edge bileşenlerini geri alma

Ortak koda sahip 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 bu 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.

Ö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.53.00/4.53.01 sürümüne geri dönmek için bootstrap_4.53.00.sh/bootstrap_4.53.01.sh dosyasını indirin.
  2. Geri döndürülecek bileşeni durdurun:
    1. Düğümdeki ortak kodlu 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'yı geri alıyorsanız 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 almak için bileşeni kaldırın:
    1. Düğümde ortak koda sahip bileşenlerden herhangi birini geri almak için aşağıdaki örnekte gösterildiği gibi edge-gateway ve apigee-cassandra-client bileşen grubunu kaldırarak hepsini kaldırmanız gerekir: 
      /opt/apigee/apigee-service/bin/apigee-service edge-gateway uninstall
       
      /opt/apigee/apigee-service/bin/apigee-service apigee-cassandra-client uninstall
    2. Nginx'i geri almak için: 
      ### Find the apigee-nginx RPM
rpm -qa | grep -i "apigee-nginx"

### Remove the apigee-nginx RPM
dnf remove apigee-nginx-1.30.x
    3. Düğümdeki diğer bileşenleri geri almak 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

      component, bileşen adıdır.

    4. 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ın 4.54.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.53.00 sürümünü ve bağımlılarını yükleyin. Aşağıdaki örnekte, apigee-service uygulamasının 4.53.00 sürümü yüklenmektedir: 
    sudo bash /tmp/bootstrap_4.53.00.sh apigeeuser=uName apigeepassword=pWord

    uName ve pWord, Apigee'den aldığınız kullanıcı adı ve şifredir. pWord parametresini atlarsanız bu parametreyi 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

    component, yüklenecek bileşeni ve configFile, eski sürüm için yapılandırma dosyanızı ifade eder.

  9. Qpid'i geri alıyorsanız iptables'ı temizleyin: 
    sudo iptables -F
  10. 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ükleme: 
    apigee-service apigee-mtls install
apigee-service apigee-mtls setup -f /opt/silent.conf