Bu sayfa, Cloud Translation API ile çevrilmiştir.

Apigee Edge 4.52.02 veya 4.53.00'ı 4.53.01'e güncelleme

Apigee, Edge for Private Cloud'u doğrudan 4.52.02 veya 4.53.00 sürümünden 4.53.01 sürümüne yükseltmeyi destekler. Bu sayfada, bu tür yükseltmelerin nasıl yapılacağı açıklanmaktadır.

Uyumlu yükseltme yollarına genel bakış için Edge for Private Cloud sürümleri için yükseltme uyumluluğu matrisine bakın.

Güncellemeyi kimler yapabilir?

Güncellemeyi çalıştıran kişi, Edge'i ilk yükleyen kişiyle aynı olmalı veya root olarak çalıştırıyor olmalıdır.

Edge RPM'lerini yükledikten sonra herkes bunları yapılandırabilir.

Hangi bileşenleri güncellemeniz gerekir?

Tüm Edge bileşenlerini güncellemeniz gerekir. Edge, birden fazla sürümden bileşen içeren bir kurulumu desteklemez.

Güncelleme ön koşulları

Edge for Private Cloud 4.53.01'deki değişiklikleri inceleme

Bu sürümde çeşitli güvenlik sorunları giderildi. Bu güvenlik geliştirmeleri gerekli olsa da geriye dönük olarak uyumlu olmayan bazı değişiklikler içerir. Bu nedenle, yükseltme sırasında veya sonrasında kesinti olmaması için ek adımlar atmanız gerekir. Daha fazla bilgi için eski özel bulut sürümlerinden 4.53.01 sürümüne yükseltirken bu konuyu dikkatlice inceleyin.

Apigee Edge'i yükseltmeden önce aşağıdaki ön koşulların karşılandığından emin olun:

Tüm düğümleri yedekleyin
Güncelleme yapmadan önce güvenlik nedeniyle tüm düğümlerin tam yedeğini almanızı öneririz. Yedekleme işlemini gerçekleştirmek için Edge'in mevcut sürümüne yönelik prosedürü kullanın.
Bu sayede, yeni sürüme güncelleme düzgün çalışmazsa yedek bir planınız olur. Yedekleme hakkında daha fazla bilgi için Yedekleme ve Geri Yükleme başlıklı makaleyi inceleyin.
Edge'in çalıştığından emin olun
Güncelleme işlemi sırasında Edge'in çalıştığından emin olmak için şu komutu kullanın:
```
/opt/apigee/apigee-service/bin/apigee-all status
```
Cassandra ön koşullarını doğrulama

Daha önce Edge for Private Cloud'un eski bir sürümünden 4.52.02 sürümüne yükselttiyseniz ve şimdi 4.53.01 sürümüne yükseltmeyi planlıyorsanız Cassandra için gerekli yükseltme sonrası adımları tamamladığınızdan emin olun. Bu adımlar, 4.52.02 sürümüne yükseltme dokümanında özetlenmiş ve Cassandra yükseltmesi için ön koşullar bölümünde de belirtilmiştir. Bu adımların önceki yükseltme sırasında tamamlanıp tamamlanmadığından emin değilseniz 4.53.01 sürümüne yükseltme işlemine devam etmeden önce bu adımları tekrar tamamlayın.
Özel Bulut 4.53.01 için Edge'de IDP anahtarlarını ve sertifikalarını yapılandırma

Edge for Private Cloud 4.53.01'de, apigee-sso bileşeninde kullanılan IdP anahtarları ve sertifikaları artık bir anahtar deposu aracılığıyla yapılandırılıyor. Daha önce kullandığınız anahtarı ve sertifikayı bir anahtar deposuna aktarmanız gerekir. TOA bileşenini güncellemeden önce ayrıntılı adımlar için Apigee TOA'yı eski sürümlerden güncelleme adımları bölümündeki adımları uygulayın.
Python gereksinimleri
Yükseltme işlemine başlamadan önce Cassandra düğümleri de dahil olmak üzere tüm düğümlerde Python 3'ün yüklü olduğundan emin olun.

Yükseltme için hangi özel adımlar dikkate alınmalıdır?

Edge for Private Cloud 4.53.01 sürümüne yükseltmek için belirli yazılımları yükseltmeyle ilgili adımları uygulamanız gerekir. Gerekli adımlar, mevcut sürümünüze bağlıdır. Ek adımlar gerektiren çeşitli yazılımlar için aşağıdaki tabloya bakın ve her biriyle ilgili ayrıntılı talimatları uygulayın. Gerekli görevleri tamamladıktan sonra yükseltme işlemine devam etmek için ana yükseltme prosedürüne dönün.

Mevcut sürüm	4.53.01 sürümüne yükseltmek için özel adımlar gerektiren yazılımlar
4.52.02	LDAP, Cassandra, Zookeeper, Postgres
4.53.00	LDAP, Zookeeper, Postgres

Sürümünüze göre gerekli adımları uyguladıktan sonra devam etmek için ana yükseltme prosedürüne dönün.

Tesis ayarlarının otomatik olarak yayılması

.properties dosyalarını /opt/apigee/customer/application içinde düzenleyerek herhangi bir özellik ayarladıysanız bu değerler güncelleme tarafından korunur.

OpenLDAP 2.6'ya geçiş yapılması gerekiyor

Apigee Edge for Private Cloud'un temel LDAP hizmetini eski OpenLDAP 2.4'ten OpenLDAP 2.6'ya yükseltme prosedürünü adım adım aşağıda bulabilirsiniz. Bu yükseltme, Apigee Edge Private Cloud 4.53.01 ve sonraki sürümlerine güncelleme yapmak için zorunlu bir koşuldur. Bu yükseltme, tek sunuculu, etkin-pasif ve etkin-etkin (çoklu ana) olmak üzere tüm Apigee LDAP dağıtım topolojileri için geçerlidir.

Ön koşullar ve dikkat edilmesi gereken noktalar

LDAP yükseltme işlemi sırasında yönetim API'lerinin ve dolayısıyla Apigee kullanıcı arayüzünün tüm bölgelerde tamamen kullanılamayacağını unutmayın. Kullanıcıları, rolleri, uygulamaları ve kuruluşları yönetme gibi tüm yönetim görevleri başarısız olur ve duraklatılması gerekir. API proxy trafiğinizin işlenmesi bu durumdan etkilenmeyecek. LDAP yükseltme işlemine devam etmeden önce lütfen tüm edge-management-server ve edge-ui'yi kapattığınızdan emin olun.
Yedekleme çok önemlidir: Mevcut LDAP verilerinizin eksiksiz ve doğrulanmış bir yedeği olmazsa olmazdır. Geçerli bir yedekleme olmadan devam etmek, geri alınamaz veri kaybına neden olur. LDAP verilerinin tutarlı ve anlık bir görüntüsünü almak için yedekleme işlemi, LDAP hizmeti çalışırken başlatılmalıdır. Gerçek yükseltme işlemini gerçekleştirmek için yedekleme yapılması gerekir. Yedekleme olmadan yükseltme işlemini gerçekleştiremezsiniz ve yükseltme adımları LDAP verilerinin silinmesini içerdiğinden geri alma işlemi de yapamazsınız.

Hazırlık ve yükleme (Tüm LDAP sunucuları)

Bu bölümdeki adımlar (2. adımdan 5. adıma kadar) tüm LDAP dağıtım topolojileri için aynıdır. Bu işlemler, rolünden bağımsız olarak apigee-openldap bileşeninin yüklü olduğu her sunucuda gerçekleştirilmelidir.

LDAP yükseltme işlemine devam etmeden önce lütfen tüm edge-management-server ve edge-ui'yi kapattığınızdan emin olun.
```
apigee-service edge-management-server stop
apigee-service edge-ui stop
```
Mevcut LDAP verilerini yedekleme

Herhangi bir değişiklik yapmadan önce tüm LDAP sunucularındaki mevcut LDAP verilerinin tam yedeğini alın. Bu işlem, güvenli bir geri yükleme noktası oluşturur.
- Yedekleme komutunu çalıştırın. Bu işlem, /opt/apigee/backup/openldap dizininde zaman damgalı bir yedek arşiv oluşturur.
```
apigee-service apigee-openldap backup
```
- Toplam kayıt sayısını alma: Yükseltme sonrası doğrulama için dizininizdeki kayıt sayısını alın (Kayıt sayısı tüm LDAP sunucularında aynı olmalıdır). Bu bir sağlıklı çalışma kontrolü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
```
LDAP'yi durdurma ve veri dizinlerini temizleme

Bu adım tüm LDAP sunucularında gerçekleştirilmelidir. Ana sürüm değişikliği ve temel yapısal farklılıklar nedeniyle zorunludur. Temiz bir dizin, çakışma olmamasını sağlar. Tüm LDAP sunucuları durdurulduğunda Management API'lerde ve kullanıcı arayüzünde kesinti başlar.
- LDAP hizmetini durdurun.
```
apigee-service apigee-openldap stop
```
- Eski LDAP verilerini ve yapılandırma dizinlerini kalıcı olarak kaldırın.
```
rm -rf /opt/apigee/data/apigee-openldap/*
```
Yeni LDAP sürümünü yükleme ve yapılandırma

Yeni bileşen sürümünü indirmek ve yüklemek için tüm LDAP sunucularında standart Apigee komut dosyalarını kullanın.
- Yeni LDAP bileşenini yükleyin: Güncelleme komut dosyası, yapılandırma dosyanızı okur ve yeni apigee-openldap paketini yükler.
```
/opt/apigee/apigee-setup/bin/update.sh -c ldap -f /opt/silent.conf
```
- Yeni LDAP sürümünü doğrulayın: Yükleme tamamlandıktan sonra profili yeniden yükleyin ve yeni LDAP sürümünün doğru şekilde yüklendiğini doğrulayın.
```
source ~/.bash_profile
ldapsearch -VV
Expected output:
ldapsearch: @(#) $OpenLDAP: ldapsearch 2.6.7
```
Veriler geri yüklenmeden önce tüm sunucularda LDAP'yi durdurma

Bu, kritik bir senkronizasyon adımıdır. Yedeğinizi geri yüklemeden önce, yeni yüklenen LDAP hizmetinin tüm sunucularda durdurulduğundan emin olmanız gerekir. Her LDAP sunucusunda aşağıdaki komutları yürütün:
```
apigee-service apigee-openldap stop
rm -rf /opt/apigee/data/apigee-openldap/ldap/*
```
LDAP verilerini geri yükleme

Strateji, yedeklemeyi ilk etkin sunucuda geri yüklemektir. Bu sunucu daha sonra bilgi kaynağı olarak hareket eder ve verileri çok sunuculu bir kurulumda benzerlerine kopyalar.
1. Geri yükleme için ilk etkin sunucuyu belirleme
  - Tek sunuculu kurulum için: Bu, tek LDAP sunucunuzdur. Doğrudan sonraki adıma geçebilirsiniz.
  - Etkin-pasif ve etkin-etkin kurulumlar için: Her LDAP sunucusunda aşağıdaki teşhis komutunu çalıştırın:
```
grep -i '^olcSyncrepl:' /opt/apigee/data/apigee-openldap/slapd.d/cn=config/olcDatabase*\ldif
Note:
-If this command returns output, the server is a passive server.
-If it returns no output, the server is the active server.
```
2. Yedeklenen verileri geri yükleme
  
  Devam etmeden önce 5. adımın tüm LDAP sunucularında başarıyla tamamlandığını tekrar kontrol edin.
  - Yukarıda tanımladığınız ilk etkin sunucuda yedekleme dizinine gidin.
```
cd /opt/apigee/backup/openldap
```
  - restore komutunu yürütün. İstenmeyen veya eski bir sürümün geri yüklenmesini önlemek için 2. adımda tam yedekleme zaman damgasını belirtmenizi önemle tavsiye ederiz.
```
# To restore a specific backup (recommended):
apigee-service apigee-openldap restore 2025.08.11,23.34.00

# To restore the latest available backup by default:
apigee-service apigee-openldap restore
```
  - Geri yükleme işlemi başarıyla tamamlandıktan sonra ilk etkin sunucuda LDAP hizmetini başlatın.
```
apigee-service apigee-openldap start
```
Kalan LDAP sunucularını başlatma

Çok sunuculu bir kurulumunuz varsa LDAP sunucularının her birinde hizmeti başlatın:
```
apigee-service apigee-openldap start
```
Not: Bu eş sunucularda verileri manuel olarak geri yüklemeniz gerekmez. Başlatıldığında, ilk sunucuya (artık geri yüklenen verileri içerir) bağlanır ve tüm dizini replikasyon yoluyla otomatik olarak senkronize eder.
Son doğrulama

Son adım, yükseltme işleminin başarılı olduğunu ve verilerin LDAP kümesinin tamamında tutarlı olduğunu doğrulamaktır.
- Doğrulama komutunu tüm LDAP sunucularında çalıştırın. Kayıt sayısı tüm sunucularda aynı olmalı ve 2. adımda yakaladığınız sayıyla eşleşmelidir.
- Verilerin doğru ve tutarlı olduğunu onayladıktan sonra LDAP yükseltme işleminiz tamamlanır. Artık kuruluşunuzun standart yükseltme prosedürüne göre edge-management-server, edge-ui ve diğer bağımlı bileşenleri başlatma işlemine devam edebilirsiniz.

Cassandra 4.0.18'e yükseltme zorunluluğu

Apigee Edge for Private Cloud 4.53.01, Cassandra'nın 4.0.18 sürümüne yükseltilmesini içerir.

Yükseltmeler ve geri alma

Cassandra 3.11.X'ten Cassandra 4.0.X'e yükseltme işlemi sorunsuz bir şekilde gerçekleştirilir. Private Cloud 4.53.00 için Edge ile yayınlanan Cassandra 4.0.X, Private Cloud 4.52.02'nin çalışma zamanı ve yönetim bileşenleriyle uyumludur.
Cassandra 4.0.X'ten 3.11.X'e doğrudan yerinde geri alma işlemi yapılamaz. Replikalar veya yedekler kullanılarak geri alma işlemi karmaşık bir prosedürdür ve hizmet dışı kalma süresi ve/veya veri kaybı içerebilir. Sorunları gidermek ve Cassandra 4.0.X'e yükseltmek, geri dönmekten daha iyidir.
Yükseltme işlemini denemeden önce geri alma prosedürleri hakkında bilgi edinmeniz önemlidir. Yükseltme sırasında geri alma işleminin ayrıntılarını göz önünde bulundurmak, uygun geri alma yollarının kullanılabilmesini sağlamak için çok önemlidir.

Tek veri merkezi

Cassandra'yı tek bir veri merkezi içinde 3.11.X sürümünden 4.0.X sürümüne yükseltmek sorunsuz bir işlemdir ancak geri alma işlemi karmaşıktır ve hizmet kesintisine ve veri kaybına neden olabilir. Üretim iş yükleri için yükseltme başlatılmadan önce yeni veri merkezinde en az Cassandra düğümleri kullanılabilirken yeni bir veri merkezi eklemeniz önemle tavsiye edilir. Bu sayede, veri kaybı olmadan veya API trafiğinizde kesinti yaşanmadan Cassandra'yı geri alabilirsiniz. Bu ek veri merkezi, yükseltme tamamlandığında veya 2. kontrol noktasına ulaşıldığında devre dışı bırakılabilir.

Yeni bir veri merkezi eklemek mümkün değilse ancak geri alma özelliği isteniyorsa Cassandra 3.11.X'i geri yüklemek için yedeklemeler gerekir. Ancak bu yöntemde hem hizmet kesintisi hem de veri kaybı yaşanma olasılığı yüksektir.

Birden fazla veri merkezi

Edge for Private Cloud 4.52.02 ile birden fazla veri merkezi işletmek, Edge for Private Cloud 4.53.00'a yükseltme sırasında geri alma işlemleri için daha fazla esneklik sunar.

Geri alma işlemleri, eski Cassandra sürümünü (3.11.X) çalıştıran en az bir veri merkezinin olmasına bağlıdır.
Cassandra kümenizin tamamı 4.0.X sürümüne yükseltildiyse Cassandra 3.11.X sürümüne geri dönmemelisiniz. Daha yeni Cassandra sürümünü Private Cloud 4.53.00 veya 4.52.02'nin diğer bileşenleriyle birlikte kullanmaya devam etmeniz gerekir.

Önerilen yükseltme metodolojisi

Her seferinde bir Cassandra veri merkezini yükseltin: Tek bir veri merkezindeki Cassandra düğümlerini ayrı ayrı yükselterek başlayın. Bir sonraki veri merkezine geçmeden önce bir veri merkezindeki tüm Cassandra düğümlerinin yükseltmelerini tamamlayın.
Duraklatma ve doğrulama: Bir veri merkezini yükselttikten sonra, özellikle yükseltilen veri merkezi olmak üzere özel bulut kümenizin doğru şekilde çalıştığından emin olmak için duraklatın.
Unutmayın: Yalnızca eski sürümü çalıştıran en az bir veri merkeziniz varsa önceki Cassandra sürümüne geri dönebilirsiniz.
Zamandan bağımsız: İşlevselliği doğrulamak için kısa bir süre (birkaç saat önerilir) duraklatabilirsiniz ancak süresiz olarak karma sürüm durumunda kalamazsınız. Bunun nedeni, tek tip olmayan bir Cassandra kümesinin (farklı sürümlerdeki düğümlerle) operasyonel sınırlamaları olmasıdır.
Kapsamlı test: Apigee, bir sonraki veri merkezini yükseltmeden önce performans ve işlevselliğin kapsamlı bir şekilde test edilmesini önemle tavsiye eder. Tüm veri merkezleri yükseltildikten sonra önceki sürüme geri dönmek mümkün değildir.

Geri alma işlemi iki kontrol noktası olarak

1. kontrol noktası: Tüm bileşenlerin 4.52.02 sürümünde olduğu başlangıç durumu. En az bir Cassandra veri merkezi eski sürümde kaldığı sürece tam geri alma mümkündür.
2. kontrol noktası: Tüm veri merkezlerindeki tüm Cassandra düğümleri güncellendikten sonra. Bu duruma geri dönebilirsiniz ancak 1. kontrol noktasına geri dönemezsiniz.

Örnek

İki veri merkezi (DC) kümesini ele alalım:

Başlangıç durumu: Her iki DC'deki Cassandra düğümleri 3.11.X sürümündedir. Diğer tüm düğümler, Private Cloud 4.52.02 sürümü için Edge'de bulunur. DC başına üç Cassandra düğümü olduğunu varsayın.
DC-1'i yükseltme: DC-1'deki üç Cassandra düğümünü tek tek yükseltin.
Duraklatın ve doğrulayın: Özellikle DC-1 olmak üzere kümenin doğru çalıştığından emin olmak için duraklatın (performansı ve işlevselliği kontrol edin). DC-2'deki Cassandra düğümlerini kullanarak ilk duruma geri dönebilirsiniz. Karma sürümlü bir Cassandra kümesinin sınırlamaları nedeniyle bu duraklatmanın geçici olması gerektiğini unutmayın.
DC-2'yi yükseltin: DC-2'deki kalan üç Cassandra düğümünü yükseltin. Bu, yeni geri alma kontrol noktanız olur.
Diğer bileşenleri yükseltme: Yönetim, çalışma zamanı ve analiz düğümlerini her zamanki gibi tüm veri merkezlerinde, her seferinde bir düğüm ve bir veri merkezi olacak şekilde yükseltin. Sorun yaşarsanız 4. adımdaki duruma geri dönebilirsiniz.

Cassandra'yı yükseltmeyle ilgili ön koşullar

Edge for Private Cloud 4.52.02 ile Cassandra 3.11.16'yı çalıştırıyor olmanız ve aşağıdakileri yapmanız gerekir:

Kümenin tamamı çalışır durumdadır ve Cassandra 3.11.16 ile tam işlevselliktedir.
Sıkıştırma stratejisi, LeveledCompactionStrategy olarak ayarlanır (4.52.02 sürümüne yükseltme için ön koşuldur).
4.52.02 sürümündeki Edge for Private Cloud'da Cassandra 3.11'in ilk yükseltmesi kapsamında aşağıdaki adımların her birinin tamamlandığını onaylayın.
- Önceki yükseltme sırasında her Cassandra düğümünde post_upgrade komutu yürütülmüş olmalıdır.
- Önceki yükseltme sırasında drop_old_tables komutu tüm Cassandra kümesinde yürütülmüştür.
Not: Yukarıdaki adımlar (yükseltme sonrası ve kullanılmayan tabloları bırakma), kümenizi eski sürümlerden Edge for Private Cloud 4.52.02'ye yükseltirken yürütmeniz gereken standart adımların bir parçasıdır.

Edge for Private Cloud 4.52.02'yi kullanırken post_upgrade ve drop_old_tables komutlarının Cassandra 3.11'de yürütüldüğünden emin değilseniz 4.53.01'e yükseltmeyi denemeden önce bu komutları güvenli bir şekilde yeniden çalıştırabilirsiniz.

1. adım: Yükseltmeye hazırlanın

Aşağıdaki adımlar, bileşen yükseltmelerini etkinleştirmek için Apigee'nin standart yapılandırma dosyası gibi genellikle oluşturduğunuz standart dosyalara ek olarak uygulanır.

Apigee'yi kullanarak Cassandra'yı yedekleyin.
Cassandra düğümlerinin sanal makine anlık görüntülerini alın (mümkünse).
Henüz yapılandırılmamışsa 9042 numaralı bağlantı noktasının, Yönetim Sunucusu, Mesaj İşleyici, Yönlendirici, Qpid ve Postgres dahil olmak üzere tüm Edge for Private Cloud bileşenlerinden Cassandra düğümlerine erişilebilir olduğundan emin olun. Daha fazla bilgi için Bağlantı noktası koşulları'na bakın.

2. adım: Tüm Cassandra düğümlerini yükseltin

Tüm Cassandra düğümleri, her veri merkezinde tek tek ve her seferinde bir veri merkezi olacak şekilde güncellenmelidir. Bir veri merkezindeki düğümlerin yükseltilmesi arasında, güncellenen bir düğümün tamamen başlatıldığından ve kümeye katıldığından emin olmak için birkaç dakika bekleyin. Ardından aynı veri merkezindeki başka bir düğümü yükseltmeye devam edin.

Bir veri merkezindeki tüm Cassandra düğümlerini yükselttikten sonra, bir sonraki veri merkezindeki düğümlerle devam etmeden önce bir süre (30 dakika ila birkaç saat) bekleyin. Bu süre zarfında, güncellenen veri merkezini ayrıntılı bir şekilde inceleyin ve Apigee kümenizin işlevsel ve performans metriklerinin bozulmamış olduğundan emin olun. Bu adım, Cassandra'nın 4.0.X sürümüne yükseltildiği veri merkezinin kararlılığını sağlamak için çok önemlidir. Bu sırada Apigee bileşenlerinin geri kalanı 4.52.02 sürümünde kalır.

Bir Cassandra düğümünü yükseltmek için aşağıdaki komutu çalıştırın:
```
/opt/apigee/apigee-setup/bin/update.sh -c cs -f configFile
```
Bir düğüm güncellendikten sonra, devam etmeden önce bazı doğrulamaları çalıştırmak için düğümde aşağıdaki komutu çalıştırın:
```
/opt/apigee/apigee-service/bin/apigee-service apigee-cassandra validate_upgrade -f configFile
```

Yukarıdaki komut, aşağıdakine benzer bir çıktı verir:

Cassandra version is verified - [cqlsh 6.0.0 | Cassandra 4.0.18 | CQL spec 3.4.5 | Native protocol v5] 
Metadata is verified

Cassandra düğümünde aşağıdaki post_upgrade komutunu çalıştırın:

/opt/apigee/apigee-service/bin/apigee-service apigee-cassandra post_upgrade

Cassandra düğümünde dizinleri yeniden oluşturmak için aşağıdaki nodetool komutlarını çalıştırın:

/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index kms api_products api_products_organization_name_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index kms app_credentials app_credentials_api_products_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index kms app_credentials app_credentials_organization_app_id_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index kms app_credentials app_credentials_organization_name_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index kms app_end_user app_end_user_app_id_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index kms apps apps_app_family_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index kms apps apps_app_id_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index kms apps apps_app_type_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index kms apps apps_name_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index kms apps apps_organization_name_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index kms apps apps_parent_id_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index kms apps apps_parent_status_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index kms apps apps_status_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index kms maps maps_organization_name_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index kms oauth_10_access_tokens oauth_10_access_tokens_app_id_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index kms oauth_10_access_tokens oauth_10_access_tokens_consumer_key_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index kms oauth_10_access_tokens oauth_10_access_tokens_organization_name_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index kms oauth_10_access_tokens oauth_10_access_tokens_status_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index kms oauth_10_request_tokens oauth_10_request_tokens_consumer_key_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index kms oauth_10_request_tokens oauth_10_request_tokens_organization_name_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index kms oauth_10_verifiers oauth_10_verifiers_organization_name_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index kms oauth_10_verifiers oauth_10_verifiers_request_token_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index kms oauth_20_access_tokens oauth_20_access_tokens_app_id_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index kms oauth_20_access_tokens oauth_20_access_tokens_client_id_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index kms oauth_20_access_tokens oauth_20_access_tokens_refresh_token_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index kms oauth_20_authorization_codes oauth_20_authorization_codes_client_id_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index kms oauth_20_authorization_codes oauth_20_authorization_codes_organization_name_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index devconnect companies companies_name_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index devconnect companies companies_organization_name_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index devconnect companies companies_status_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index devconnect company_developers company_developers_company_name_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index devconnect company_developers company_developers_developer_email_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index devconnect company_developers company_developers_organization_name_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index devconnect developers developers_email_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index devconnect developers developers_organization_name_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index devconnect developers developers_status_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index cache cache_entries cache_entries_cache_name_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index audit audits audits_operation_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index audit audits audits_requesturi_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index audit audits audits_responsecode_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index audit audits audits_timestamp_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index audit audits audits_user_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index apimodel_v2 apis a_name
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index apimodel_v2 apis a_org_name
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index apimodel_v2 apis_revision ar_a_active_rev
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index apimodel_v2 apis_revision ar_a_def_index_template
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index apimodel_v2 apis_revision ar_a_def_method_template
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index apimodel_v2 apis_revision ar_a_latest_rev
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index apimodel_v2 apis_revision ar_a_name
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index apimodel_v2 apis_revision ar_a_uuid
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index apimodel_v2 apis_revision ar_base_url
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index apimodel_v2 apis_revision ar_is_active
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index apimodel_v2 apis_revision ar_is_latest
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index apimodel_v2 apis_revision ar_name
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index apimodel_v2 apis_revision ar_org_name
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index apimodel_v2 apis_revision ar_rel_ver
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index apimodel_v2 apis_revision ar_rev_num
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index apimodel_v2 method m_a_name
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index apimodel_v2 method m_api_uuid
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index apimodel_v2 method m_ar_uuid
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index apimodel_v2 method m_base_url
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index apimodel_v2 method m_name
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index apimodel_v2 method m_org_name
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index apimodel_v2 method m_r_name
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index apimodel_v2 method m_r_uuid
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index apimodel_v2 method m_res_path
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index apimodel_v2 method m_rev_num
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index apimodel_v2 resource r_a_name
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index apimodel_v2 resource r_api_uuid
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index apimodel_v2 resource r_ar_uuid
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index apimodel_v2 resource r_base_url
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index apimodel_v2 resource r_name
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index apimodel_v2 resource r_org_name
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index apimodel_v2 resource r_res_path
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index apimodel_v2 resource r_rev_num
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index apimodel_v2 schemas s_api_uuid
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index apimodel_v2 schemas s_ar_uuid
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index apimodel_v2 security sa_api_uuid
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index apimodel_v2 security sa_ar_uuid
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index apimodel_v2 template t_a_name
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index apimodel_v2 template t_a_uuid
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index apimodel_v2 template t_entity
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index apimodel_v2 template t_name
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index apimodel_v2 template t_org_name
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index apimodel_v2 template_auth au_api_uuid
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index dek keys usecase_index

Para kazanma özelliğini kullanıyorsanız para kazanma anahtar alanlarıyla ilgili aşağıdaki rebuild indices komutlarını da çalıştırın:

/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index mint limits limits_created_date_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index mint limits limits_id_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index mint limits limits_org_id_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index mint limits limits_updated_date_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index mint suspended_developer_products suspended_developer_products_created_date_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index mint suspended_developer_products suspended_developer_products_currency_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index mint suspended_developer_products suspended_developer_products_dev_id_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index mint suspended_developer_products suspended_developer_products_id_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index mint suspended_developer_products suspended_developer_products_limit_id_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index mint suspended_developer_products suspended_developer_products_org_id_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index mint suspended_developer_products suspended_developer_products_prod_id_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index mint suspended_developer_products suspended_developer_products_reason_code_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index mint suspended_developer_products suspended_developer_products_sub_org_id_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index mint invitations invitations_company_id_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index mint invitations invitations_created_at_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index mint invitations invitations_developer_id_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index mint invitations invitations_lastmodified_at_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index mint invitations invitations_org_id_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index taurus triggers triggers_env_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index taurus triggers triggers_job_id_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index taurus triggers triggers_org_id_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index taurus job_details job_details_job_class_name_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index taurus job_details job_details_job_group_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index taurus job_details job_details_job_name_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index taurus org_triggers org_triggers_org_id_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index taurus triggers_suite triggers_suite_group_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index taurus triggers_suite triggers_suite_name_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index taurus triggers_suite triggers_suite_suite_id_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index notification notification_service_item notification_service_item_org_id_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index notification notification_service_item notification_service_item_status_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index notification notification_service_black_list_item notification_service_black_list_item_org_id_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index notification notification_service_black_list_item notification_service_black_list_item_to_email_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index notification notification_email_template_item notification_email_template_item_name_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index notification notification_email_template_item notification_email_template_item_org_id_idx

3. adım: Tüm yönetim düğümlerini yükseltin

Tüm bölgelerdeki tüm yönetim düğümlerini tek tek yükseltin:

/opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile

4. adım: Tüm çalışma zamanı düğümlerini yükseltin

Tüm bölgelerdeki tüm yönlendirici ve mesaj işlemci düğümlerini tek tek yükseltin:

/opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile

5. adım: Geriye kalan tüm Edge for Private Cloud 4.53.01 bileşenlerini yükseltin

Tüm bölgelerdeki kalan tüm edge-qpid-server ve edge-postgres-server düğümlerini tek tek yükseltin.

Zookeeper 3.8.4'e yükseltme yapılması zorunludur

Private Cloud için Edge'in bu sürümü, Zookeeper 3.8.4'e yükseltme içerir. Bu yükseltme kapsamında tüm Zookeeper verileri Zookeeper 3.8.4'e taşınacak.

Zookeeper'ı yükseltmeden önce Zookeeper bakım kılavuzunu okuyun. Çoğu Edge üretim sistemi, birden fazla veri merkezine yayılmış bir Zookeeper düğümleri kümesi kullanır. Bu düğümlerden bazıları, Zookeeper lider seçimine katılan seçmenler olarak, geri kalanı ise gözlemciler olarak yapılandırılır. Daha fazla bilgi için Liderler, takipçiler, seçmenler ve gözlemciler hakkında başlıklı makaleyi inceleyin. Oy veren düğümler bir lider seçer. Ardından, oy veren düğümlerin kendileri takipçi olur.

Güncelleme işlemi sırasında lider düğüm kapatıldığında Zookeeper'da kısa süreli bir gecikme veya yazma hatası oluşabilir. Bu durum, Zookeeper'a yazan yönetim işlemlerini (ör. proxy'nin dağıtım işlemi) ve Apigee altyapı değişikliklerini (ör. mesaj işlemcisinin eklenmesi veya kaldırılması) etkileyebilir. Aşağıdaki prosedür izlenirken Zookeeper'ın yükseltilmesi sırasında Apigee'nin çalışma zamanı API'leri (bu çalışma zamanı API'leri yönetim API'lerini çağırmadığı sürece) etkilenmez.

Yüksek düzeyde, yükseltme işlemi her düğümün yedeğini almayı içerir. Bunu, tüm gözlemcileri ve takipçileri yükseltme, ardından da lider düğümü yükseltme işlemi izler.

Yedek alma

Geri alma işlemi gerekmesi ihtimaline karşı kullanılmak üzere Zookeeper'ın tüm düğümlerinin yedeğini alın. Geri alma işleminin, Zookeeper'ı yedekleme işlemi yapıldığı sıradaki durumuna geri yükleyeceğini unutmayın. Not: Yedekleme işleminden sonra Apigee'de yapılan tüm dağıtımlar veya altyapı değişiklikleri (bilgileri Zookeeper'da saklanır) geri yükleme sırasında kaybolur.

  /opt/apigee/apigee-service/bin/apigee-service apigee-zookeeper backup

Sanal makineler kullanıyorsanız ve bu olanağa sahipseniz geri yükleme veya geri alma (gerekirse) için sanal makine anlık görüntüleri ya da yedekleri de alınabilir.

Lideri, takipçileri ve gözlemcileri belirleme

Not: Aşağıdaki örnek komutlarda, Zookeeper'a veri göndermek için nc yardımcı programı kullanılmaktadır. Verileri Zookeeper'a göndermek için alternatif yardımcı programlar da kullanabilirsiniz.

ZooKeeper düğümüne yüklenmemişse nc'yi yükleyin:
```
  sudo yum install nc
```
Düğümde aşağıdaki nc komutunu çalıştırın. Burada 2181, ZooKeeper bağlantı noktasıdır:
```
  echo stat | nc localhost 2181
```
Aşağıdakine benzer bir çıkış alırsınız:
```
  Zookeeper version: 3.8.4-5a02a05eddb59aee6ac762f7ea82e92a68eb9c0f, built on 2022-02-25 08:49 UTC
  Clients:
   /0:0:0:0:0:0:0:1:41246[0](queued=0,recved=1,sent=0)
  
  Latency min/avg/max: 0/0.2518/41
  Received: 647228
  Sent: 647339
  Connections: 4
  Outstanding: 0
  Zxid: 0x400018b15
  Mode: follower
  Node count: 100597
```
Düğümlerin çıkışındaki Mode satırında, düğüm yapılandırmasına bağlı olarak gözlemci, lider veya takipçi (lider olmayan bir seçmen anlamına gelir) görmelisiniz. Not: Tek bir ZooKeeper düğümüyle Edge'in bağımsız kurulumunda Mode bağımsız olarak ayarlanır.
Her ZooKeeper düğümünde 1. ve 2. adımları tekrarlayın.

Gözlemci ve takipçi düğümlerinde Zookeeper'ı yükseltme

Gözlemci ve takipçi düğümlerinin her birinde Zookeeper'ı aşağıdaki şekilde yükseltin:

Harici internet bağlantısı olan bir düğümde 4.53.01 sürümüne güncelleme bölümünde açıklandığı gibi, Private Cloud 4.53.01 için Edge'in bootstrap'ini indirip çalıştırın. Bu işlem, büyük olasılıkla düğümün harici internet bağlantısı olup olmamasına veya çevrimdışı kurulum yapmanıza bağlı olarak değişir.
Zookeeper bileşenini yükseltin:
```
  /opt/apigee/apigee-setup/bin/update.sh -c zk -f <silent-config-file>
```
Not: Bu düğümlerde başka bileşenler (ör. Cassandra) yüklüyse bunları da şimdi (cs,zk profili gibi) yükseltebilir veya diğer bileşenleri daha sonra yükseltebilirsiniz. Apigee, diğer bileşenleri yükseltmeden önce yalnızca Zookeeper'ı yükseltmenizi ve kümenizin düzgün çalıştığından emin olmanızı önerir.
Yukarıdaki adımları Zookeeper gözlemci ve takipçi düğümlerinin her birinde tekrarlayın.

Lideri kapatma

Tüm gözlemci ve takipçi düğümleri yükseltildikten sonra lideri kapatın. Lider olarak tanımlanan düğümde aşağıdaki komutu çalıştırın:

  /opt/apigee/apigee-service/bin/apigee-service apigee-zookeeper stop

Bu etkinlik sırasında, yeni bir lider seçilmeden önce Zookeeper'da anlık gecikmeler veya yazma hataları olabileceğini unutmayın. Bu durum, Zookeeper'a yazma işlemleri yapan (ör. proxy'lerin dağıtım işlemi veya Apigee altyapı değişiklikleri, örneğin ileti işlemcilerinin eklenmesi ya da kaldırılması) işlemleri etkileyebilir.

Yeni liderin seçildiğini doğrulayın.

Yukarıdaki Lideri, takipçileri ve gözlemcileri belirleme bölümündeki adımları kullanarak mevcut lider durdurulduktan sonra takipçiler arasından yeni bir liderin seçildiğini doğrulayın. Liderin, mevcut liderden farklı bir veri merkezinde seçilmiş olabileceğini unutmayın.

En iyi varyantı dağıt

Yukarıdaki Gözlemci ve takipçi düğümlerinde ZooKeeper'ı yükseltme bölümünde belirtilen adımları uygulayın.

Eski lider düğüm de yükseltildikten sonra küme sağlığını doğrulayın ve bir lider düğümün olduğundan emin olun.

Edge-Router'da Nginx 1.26 sürümüne yükseltme

Önceki sürümlerden Edge for Private Cloud 4.53.01'e yükseltme işlemi, Nginx yazılımını otomatik olarak en son sürüme (1.26.x) yükseltmez. Bunun nedeni, Nginx 1.26 changes in Apigee Edge 4.53.01 (Apigee Edge 4.53.01'deki Nginx 1.26 değişiklikleri) başlıklı dokümanda belirtilen değişiklikler sonucunda yanlışlıkla çalışma zamanı yan etkilerinin oluşmasını önlemektir. Doğrulama işleminden sonra Nginx'i daha düşük ortamlarda 1.20.x sürümünden 1.26.x sürümüne manuel olarak yükseltebilirsiniz. Manuel olarak yükseltmek için:

Sınır yönlendirici düğümünde en son 4.53.01 yazılımının yüklü olduğundan emin olun.
```
/opt/apigee/apigee-service/bin/apigee-service edge-router version
```
Şu anda çalıştırdığınız Nginx sürümünü kontrol etme ve doğrulama
```
/opt/nginx/sbin/nginx -V
```
Nginx'in eski bir sürümünü kullanıyorsanız Nginx'i yönlendirici düğümünde 1.26.X sürümüne yükseltmek için aşağıdaki adımları uygulayabilirsiniz.
Yönlendirici düğümünde uç yönlendirici işlemini durdurma
```
/opt/apigee/apigee-service/bin/apigee-service edge-router stop
```
Yönlendirici düğümünde nginx yazılımını yükseltme
```
dnf update apigee-nginx
```
Nginx sürümünün güncellendiğini doğrulayın.
```
/opt/nginx/sbin/nginx -V
```

Düğümde yönlendirici işlemini başlatma

/opt/apigee/apigee-service/bin/apigee-service edge-router start

İşlemi her yönlendirici düğümünde tek tek tekrarlayın.

Postgres 17'ye Yükseltme Gerekli

Edge'in bu sürümünde Postgres 17'ye yükseltme yapılmıştır. Bu yükseltme kapsamında tüm Postgres verileri Postgres 17'ye taşınır.

Çoğu Edge üretim sistemi, ana-bekleme replikasyonu için yapılandırılmış iki Postgres düğümü kullanır. Güncelleme işlemi sırasında, Postgres düğümleri güncelleme için kapalıyken analiz verileri Qpid düğümlerine yazılmaya devam eder. PostgreSQL düğümleri güncellenip tekrar internete bağlandıktan sonra analiz verileri PostgreSQL düğümlerine gönderilir.

Postgres güncellemesini gerçekleştirme şekliniz, Postgres düğümleriniz için veri depolamayı nasıl yapılandırdığınıza bağlıdır:

Postgres düğümleriniz için yerel veri depolama kullanıyorsanız yükseltme süresi boyunca yeni bir Postgres bekleme düğümü yüklemeniz gerekir. Yükseltme tamamlandıktan sonra yeni Postgres bekleme düğümünü devre dışı bırakabilirsiniz.
Güncellemeyi herhangi bir nedenle geri almanız gerekiyorsa ek Postgres bekleme düğümü gerekir. Güncellemeyi geri almanız gerekirse yeni Postgres bekleme düğümü, geri alma işleminden sonra ana Postgres düğümü olur. Bu nedenle, yeni Postgres bekleme düğümünü yüklediğinizde, Edge Yükleme koşulları bölümünde tanımlandığı gibi, Postgres sunucusunun tüm donanım koşullarını karşılayan bir düğümde olmalıdır.

Edge'in 1 düğümlü ve 2 düğümlü yapılandırmasında, prototip oluşturma ve test için kullanılan topolojilerde yalnızca tek bir PostgreSQL düğümünüz vardır. Yeni bir Postgres düğümü oluşturmak zorunda kalmadan bu Postgres düğümlerini doğrudan güncelleyebilirsiniz.
Apigee'nin önerdiği gibi Postgres düğümleriniz için ağ depolama alanı kullanıyorsanız yeni bir Postgres düğümü yüklemeniz gerekmez. Aşağıdaki prosedürlerde, yeni bir Postgres bekleme düğümünün yüklenmesini ve daha sonra devre dışı bırakılmasını belirten adımları atlayabilirsiniz.
Güncelleme işlemine başlamadan önce, Postgres tarafından kullanılan veri deposunun ağ anlık görüntüsünü alın. Ardından, güncelleme sırasında herhangi bir hata oluşursa ve geri alma işlemi yapmanız gerekirse Postgres düğümünü bu anlık görüntüden geri yükleyebilirsiniz.

Yeni bir Postgres bekleme düğümü yükleme

Bu prosedür, yeni bir düğümde Postgres bekleme sunucusu oluşturur. Edge'in mevcut sürümü (4.52.02 veya 4.53.00) için yeni bir Postgres bekleme sunucusu yüklediğinizden emin olun. 4.53.01 sürümü için yüklemeyin.

Yükleme işlemini gerçekleştirmek için Edge'in mevcut sürümünü yüklerken kullandığınız yapılandırma dosyasını kullanın.

Yeni bir Postgres bekleme düğümü oluşturmak için:

Mevcut Postgres ana makinesinde, aşağıdaki jetonu ayarlamak için /opt/apigee/customer/application/postgresql.properties dosyasını düzenleyin. Bu dosya yoksa oluşturun:
```
conf_pg_hba_replication.connection=host replication apigee existing_standby_ip/32 trust\ \nhost replication apigee new_standby_ip/32 trust
```
Burada existing_standby_ip, mevcut Postgres bekleme sunucusunun IP adresi, new_standby_ip ise yeni bekleme düğümünün IP adresidir.

Postgres ana örneğinde apigee-postgresql hizmetini yeniden başlatın:

/opt/apigee/apigee-service/bin/apigee-service apigee-postgresql restart

Yeni bekleme düğümünün eklendiğini doğrulamak için ana sunucudaki /opt/apigee/apigee-postgresql/conf/pg_hba.conf dosyasını görüntüleyin. Bu dosyada aşağıdaki satırları görmeniz gerekir:
```
host replication apigee existing_standby_ip/32 trust
host replication apigee new_standby_ip/32 trust
```
Yeni Postgres bekleme sunucusunu yükleyin:
1. Aşağıdakileri belirtmek için Edge'in mevcut sürümünü yüklemek üzere kullandığınız yapılandırma dosyasını düzenleyin:
```
# IP address of the current master:
PG_MASTER=192.168.56.103
# IP address of the new standby node
PG_STANDBY=192.168.56.102
```
2. SELinux'u Install the Edge apigee-setup utility (Edge apigee-setup yardımcı programını yükleme) bölümünde açıklandığı şekilde devre dışı bırakın.
3. Şu anda Edge 4.52.02 sürümünü kullanıyorsanız:
  1. Edge bootstrap_4.52.02.sh dosyasını /tmp/bootstrap_4.52.02.sh konumuna indirin:
```
curl https://software.apigee.com/bootstrap_4.52.02.sh -o /tmp/bootstrap_4.51.00.sh
```
  2. Edge apigee-service yardımcı programını ve bağımlılıklarını yükleyin:
```
sudo bash /tmp/bootstrap_4.52.02.sh apigeeuser=uName apigeepassword=pWord
```
  Şu anda Edge 4.53.00 kullanıyorsanız:
  1. Edge bootstrap_4.53.00.sh dosyasını /tmp/bootstrap_4.53.00.sh konumuna indirin:
```
curl https://software.apigee.com/bootstrap_4.53.00.sh -o /tmp/bootstrap_4.53.00.sh
```
  2. Edge apigee-service yardımcı programını ve bağımlılıklarını yükleyin:
```
sudo bash /tmp/bootstrap_4.53.00.sh apigeeuser=uName apigeepassword=pWord
```
4. apigee-setup yardımcı programını yüklemek için apigee-service uygulamasını kullanın:
```
/opt/apigee/apigee-service/bin/apigee-service apigee-setup install
```
5. Postgres'i yükleyin:
```
/opt/apigee/apigee-setup/bin/setup.sh -p ps -f configFile
```
6. Yeni bekleme düğümünde aşağıdaki komutu çalıştırın:
```
/opt/apigee/apigee-service/bin/apigee-service apigee-postgresql postgres-check-standby
```
  Yedek cihaz olduğunu doğrulayın.

Postgres için yerinde yükseltme yapma

Not: Postgres'i yerinde yükseltmeden önce aşağıdaki ön adımı uygulamanız gerekir.

Ön adım

Postgres'i yerinde yükseltmeden önce hem ana makinede hem de bekleme makinesinde aşağıdaki adımları uygulayarak apigee-postgresql üzerinde max_locks_per_transaction özelliğini güncelleyin:

Dosya yoksa /opt/apigee/customer/application/postgresql.properties dosyasını oluşturun.

Bu dosyanın sahipliğini apigee olarak değiştirin:

sudo chown apigee:apigee /opt/apigee/customer/application/postgresql.properties

Dosyaya aşağıdaki özelliği ekleyin:

conf/postgresql.conf+max_locks_per_transaction=30000

apigee-postgresql ayarlarını yapılandırın:
```
apigee-service apigee-postgresql configure
```
apigee-postgresql uygulamasını yeniden başlatın:
```
apigee-service apigee-postgresql restart
```

Yerinde yükseltmeyi gerçekleştirme

Postgres 17'ye yerinde yükseltme yapmak için aşağıdaki adımları uygulayın:

Ana makinede PostgreSQL'i yükseltme

/opt/apigee/apigee-setup/bin/update.sh -c ps -f /opt/silent.conf

Ana makinede kurulum komutunu çalıştırın:

apigee-service apigee-postgresql setup -f /opt/silent.conf

Ana makinede yapılandırma komutunu çalıştırın:
```
apigee-service apigee-postgresql configure
```

Ana makineyi yeniden başlatın:

apigee-service apigee-postgresql restart

Ana örnek olarak yapılandırın:

apigee-service apigee-postgresql setup-replication-on-master -f /opt/silent.conf

Ana makinenin başlatıldığından emin olun:

apigee-service apigee-postgresql wait_for_ready

Beklemeyi durdurma:
```
apigee-service apigee-postgresql stop
```
Bekleme sunucusunu yükseltin.
Not: Bu adımda hata oluşursa veya adım başarısız olursa yoksayılabilir. update.sh, bekleme sunucusunu yanlış bir yapılandırmayla başlatmaya çalışır. Postgres kurulumu 17'ye yükseltildiyse hata yoksayılabilir.
```
/opt/apigee/apigee-setup/bin/update.sh -c ps -f /opt/silent.conf
```
Bekleme modunun durdurulduğundan emin olun:
```
apigee-service apigee-postgresql stop
```

Eski yedek yapılandırmayı kaldırın:

rm -rf /opt/apigee/data/apigee-postgresql/

Bekleme sunucusunda replikasyonu ayarlayın:

apigee-service apigee-postgresql setup-replication-on-standby -f /opt/silent.conf

conf/postgresql.conf+max_locks_per_transaction=30000 satırını hem ana makinedeki hem de yedek makinedeki /opt/apigee/customer/application/postgresql.properties dosyasından kaldırın. Bu satır, ön adımda eklendi.

Bu prosedür tamamlandıktan sonra bekleme modu başarıyla başlatılır.

Postgres düğümünü devre dışı bırakma

Güncelleme tamamlandıktan sonra yeni yedek düğümü devre dışı bırakın:

Postgres'in ç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

Yeni yedek düğümde aşağıdaki curl komutunu çalıştırarak yeni yedek düğümün UUID'sini alın:
```
curl -u sysAdminEmail:password http://node_IP:8084/v1/servers/self
```
Çıkışın sonunda, aşağıdaki biçimde düğümün UUID'sini görürsünüz:
```
"type" : [ "postgres-server" ],
"uUID" : "599e8ebf-5d69-4ae4-aa71-154970a8ec75"
```
Yeni yedek düğümde aşağıdaki komutu çalıştırarak yeni yedek düğümü durdurun:
```
/opt/apigee/apigee-service/bin/apigee-all stop
```
Postgres ana düğümünde, /opt/apigee/customer/application/postgresql.properties dosyasını düzenleyerek yeni bekleme düğümünü conf_pg_hba_replication.connection'den kaldırın:
```
conf_pg_hba_replication.connection=host replication apigee existing_standby_ip/32 trust
```

Postgres ana örneğinde apigee-postgresql'i yeniden başlatın:

/opt/apigee/apigee-service/bin/apigee-service apigee-postgresql restart

Yeni bekleme düğümünün kaldırıldığını doğrulamak için ana sunucudaki /opt/apigee/apigee-postgresql/conf/pg_hba.conf dosyasını görüntüleyin. Bu dosyada yalnızca şu satırı görmeniz gerekir:
```
host replication apigee existing_standby_ip/32 trust
```
Yönetim sunucusu düğümünde aşağıdaki Edge yönetim API'si çağrısını yaparak bekleme düğümünün UUID'sini ZooKeeper'dan silin:
```
curl -u sysAdminEmail:password -X DELETE http://ms_IP:8080/v1/servers/new_standby_uuid
```

Postgres için yükseltme sonrası adımlar

Büyük bir Postgres yükseltmesinden sonra Postgres'in dahili istatistikleri silinir. Bu istatistikler, sorguları yürütmek için en uygun dizinleri ve yolları kullanma konusunda Postgres sorgu planlayıcısına yardımcı olur.

Postgres, sorgular yürütüldükçe ve otomatik temizleme arka plan programı çalıştıkça istatistiklerini zaman içinde kademeli olarak yeniden oluşturabilir. Ancak istatistikler yeniden oluşturulana kadar sorgularınız yavaş olabilir.

Bu sorunu gidermek için ana Postgres düğümündeki veritabanında bulunan tüm tablolarda ANALYZE komutunu çalıştırın. Alternatif olarak, ANALYZE komutunu birkaç tablo için aynı anda çalıştırabilirsiniz.

NOT: ANALYZE uzun sürebilir ancak yalnızca tabloda okuma kilidi alır. Bu sayede ANALYZE çalışırken Postgres'te diğer işlemlerin yürütülmeye devam etmesine olanak tanır.

Apigee TOA'yı eski sürümlerden güncelleme adımları

Edge for Private Cloud 4.53.01'de, apigee-sso bileşeninde kullanılan IdP anahtarları ve sertifikaları artık bir anahtar deposu aracılığıyla yapılandırılıyor. Daha önce kullanılan anahtarı ve sertifikayı bir anahtar deposuna aktarmanız, yapılandırmanız ve ardından TOA güncellemesine normal şekilde devam etmeniz gerekir.

IDP'yi yapılandırmak için kullanılan mevcut anahtarı ve sertifikayı belirleyin:
1. TOA yükleme yapılandırma dosyasında SSO_SAML_SERVICE_PROVIDER_CERTIFICATE değerini arayarak veya apigee-sso bileşenine conf_login_service_provider_certificate için sorgu göndererek sertifikayı alın.
  
  Kimlik sağlayıcı sertifika yolunu apigee-sso için sorgulamak üzere TOA düğümünde aşağıdaki komutu kullanın. Çıkışta, son satırdaki değeri bulun.
```
apigee-service apigee-sso configure -search conf_login_service_provider_certificate
```
2. TOA yükleme yapılandırma dosyasında SSO_SAML_SERVICE_PROVIDER_KEY değerini arayarak veya apigee-sso bileşenine conf_login_service_provider_key için sorgu göndererek anahtarı alın.
  
  Kimlik sağlayıcı anahtar yolu için apigee-sso sorgulamak üzere TOA düğümünde aşağıdaki komutu kullanın. Çıkışta son satırdaki değeri bulun.
```
apigee-service apigee-sso configure -search conf_login_service_provider_key
```
Anahtarı ve sertifikayı anahtar deposuna aktarın:
1. Anahtarı ve sertifikayı bir PKCS12 anahtar deposuna aktarın:
```
sudo openssl pkcs12 -export -clcerts -in <certificate_path> -inkey <key_path> -out <keystore_path> -name <alias>
```
  Parametreler:
  - certificate_path: 1.adımın a bölümünde alınan sertifika dosyasının yolu.
  - key_path: 1.adımın b bölümünde alınan özel anahtar dosyasının yolu.
  - keystore_path: Sertifika ve özel anahtarı içeren yeni oluşturulan anahtar deposunun yolu.
  - alias: Anahtar deposundaki anahtar ve sertifika çifti için kullanılan takma ad.
  Daha fazla bilgi için OpenSSL belgelerine bakın.
2. (İsteğe bağlı) Anahtarı ve sertifikayı PKCS12'den JKS anahtar deposuna aktarın:
```
sudo keytool -importkeystore -srckeystore <PKCS12_keystore_path> -srcstoretype PKCS12 -destkeystore <destination_keystore_path> -deststoretype JKS -alias <alias>
```
  Parametreler:
  - PKCS12_keystore_path: Sertifika ve anahtarı içeren, 2.adımın a bölümünde oluşturulan PKCS12 anahtar deposunun yolu.
  - destination_keystore_path: Sertifikanın ve anahtarın dışa aktarılacağı yeni JKS anahtar deposunun yolu.
  - alias: JKS anahtar deposundaki anahtar ve sertifika çifti için kullanılan takma ad.
Çıkış anahtar deposu dosyasının sahibini "apigee" kullanıcısı olarak değiştirin:
```
sudo chown apigee:apigee <keystore_file>
```

Apigee TOA yapılandırma dosyasına aşağıdaki özellikleri ekleyin ve bunları anahtar deposu dosya yolu, şifre, anahtar deposu türü ve takma ad ile güncelleyin:

# Path to the keystore file
SSO_SAML_SERVICE_PROVIDER_KEYSTORE_PATH=${APIGEE_ROOT}/apigee-sso/source/conf/keystore.jks

# Keystore password
SSO_SAML_SERVICE_PROVIDER_KEYSTORE_PASSWORD=Secret123  # Password for accessing the keystore

# Keystore type
SSO_SAML_SERVICE_PROVIDER_KEYSTORE_TYPE=JKS  # Type of keystore, e.g., JKS, PKCS12

# Alias within keystore that stores the key and certificate
SSO_SAML_SERVICE_PROVIDER_KEYSTORE_ALIAS=service-provider-cert

Aşağıdaki komutu kullanarak TOA düğümündeki Apigee TOA yazılımını her zamanki gibi güncelleyin:
```
/opt/apigee/apigee-setup/bin/update.sh -c sso -f /opt/silent.conf
```

Yeni Edge kullanıcı arayüzü

Bu bölümde, Edge kullanıcı arayüzü ile ilgili dikkat edilmesi gereken noktalar listelenmektedir. Daha fazla bilgi için Özel Bulut için yeni Edge kullanıcı arayüzü başlıklı makaleyi inceleyin.

Edge kullanıcı arayüzünü yükleme

İlk yüklemeyi tamamladıktan sonra Apigee, Edge kullanıcı arayüzünü yüklemenizi önerir. Bu arayüz, Apigee Edge for Private Cloud'un geliştiricileri ve yöneticileri için geliştirilmiş bir kullanıcı arayüzüdür.

Edge kullanıcı arayüzünün, Temel kimlik doğrulamanın devre dışı bırakılmasını ve SAML veya LDAP gibi bir IDP kullanılmasını gerektirdiğini unutmayın.

Daha fazla bilgi için Yeni Edge kullanıcı arayüzünü yükleme başlıklı makaleyi inceleyin.

Apigee mTLS ile güncelleme

Apigee mTLS'yi güncellemek için aşağıdaki adımları uygulayın:

Güncellemeyi geri alma

Güncelleme başarısız olursa sorunu düzeltmeyi deneyebilir ve ardından update.sh komutunu tekrar çalıştırabilirsiniz. Güncellemeyi birden çok kez çalıştırabilirsiniz. Güncelleme, en son kaldığı yerden devam eder.

Başarısızlık nedeniyle güncellemeyi önceki sürüme geri çekmeniz gerekiyorsa ayrıntılı talimatlar için 4.53.01 sürümünü geri çekme başlıklı makaleyi inceleyin.

Günlük kaydı güncelleme bilgileri

update.sh yardımcı programı, varsayılan olarak günlük bilgilerini şu konuma yazar:

/opt/apigee/var/log/apigee-setup/update.log

update.sh yardımcı programını çalıştıran kişinin bu dizine erişimi yoksa günlük, /tmp dizinine update_username.log adlı bir dosya olarak yazılır.

Kullanıcının /tmp'ya erişimi yoksa update.sh yardımcı programı başarısız olur.

Sıfır kapalı kalma süresiyle güncelleme

Sıfır kapalı kalma süresiyle güncelleme veya periyodik güncelleme, Edge'i kapatmadan Edge yüklemenizi güncellemenize olanak tanır.

Sıfır kapalı kalma süresiyle güncelleme yalnızca 5 düğümlü ve daha büyük yapılandırmalarda mümkündür.

Sıfır kapalı kalma süresiyle yükseltmenin anahtarı, her yönlendiriciyi yük dengeleyiciden tek tek kaldırmaktır. Ardından, yönlendiriciyi ve yönlendiriciyle aynı makinedeki diğer tüm bileşenleri güncelleyip yönlendiriciyi yük dengeleyiciye geri eklersiniz.

Kurulumunuz için makineleri Makine güncelleme sırası bölümünde açıklandığı gibi doğru sırada güncelleyin.
Yönlendiricileri güncelleme zamanı geldiğinde herhangi bir yönlendiriciyi seçin ve Sunucu (mesaj işlemcisi/yönlendirici) erişilebilirliğini etkinleştirme/devre dışı bırakma bölümünde açıklandığı gibi bu yönlendiriciye erişilemez hale getirin.
Seçili yönlendiriciyi ve yönlendiriciyle aynı makinedeki diğer tüm Edge bileşenlerini güncelleyin. Tüm Edge yapılandırmaları, aynı düğümde bir yönlendirici ve mesaj işlemci gösterir.
Yönlendiriciye tekrar erişilebilir hale getirin.
Kalan yönlendiriciler için 2-4 arasındaki adımları tekrarlayın.
Yüklemenizdeki kalan makineler için güncellemeyi devam ettirin.

Güncellemeden önce ve sonra aşağıdakilere dikkat edin:

Birleştirilmiş yönlendirici ve mesaj işleyici düğümünde:
- Güncellemeden önce aşağıdakileri yapın:
  1. Yönlendiriciye erişilemez hale getirin.
  2. Mesaj İşleyici'ye erişilemez hale getirin.
- Güncellemeden sonra aşağıdakileri yapın:
  1. Mesaj İşleyici'ye ulaşılabilir hale getirin.
  2. Yönlendiriciye erişilebilir hale getirin.
Tek yönlendirici düğümlerinde:
- Güncellemeden önce yönlendiriciye erişilemez hale getirin.
- Güncellemeden sonra yönlendiriciye erişilebilir hale getirin.
Tek Mesaj İşleme düğümlerinde:
- Güncellemeden önce Message Processor'a erişilemez hale getirin.
- Güncellemeden sonra Message Processor'a erişilebilir hale getirin.

Sessiz yapılandırma dosyası kullanma

Güncelleme komutuna sessiz bir yapılandırma dosyası iletmeniz gerekir. Sessiz yapılandırma dosyası, Edge for Private Cloud 4.52.02 veya 4.53.00'ı yüklemek için kullandığınız dosya olmalıdır.

Harici internet bağlantısı olan bir düğümde 4.53.01 sürümüne güncelleme

Bir düğümdeki Edge bileşenlerini güncellemek için aşağıdaki prosedürü kullanın:

Varsa güncelleme tamamlanana kadar Cassandra'da onarım işlemi yapacak şekilde yapılandırılmış tüm cron işlerini devre dışı bırakın.
Edge RPM'lerini yüklemek için düğümünüze root olarak giriş yapın.
NOT: RPM yüklemesi için kök erişimi gerekirken Edge yapılandırmasını kök erişimi olmadan gerçekleştirebilirsiniz.
Install the Edge apigee-setup utility (Edge apigee-setup yardımcı programını yükleme) bölümünde açıklandığı şekilde SELinux'u devre dışı bırakın.

AWS'ye yükleme yapıyorsanız aşağıdaki yum-configure-managerkomutları yürütün:

yum update rh-amazon-rhui-client.noarch
sudo yum-config-manager --enable rhui-REGION-rhel-server-extras rhui-REGION-rhel-server-optional

Şu anda Edge 4.52.02 veya 4.53.00 kullanıyorsanız:
1. Edge bootstrap_4.53.01.sh dosyasını /tmp/bootstrap_4.53.01.sh konumuna indirin:
```
curl https://software.apigee.com/bootstrap_4.53.01.sh -o /tmp/bootstrap_4.53.01.sh
```
2. Aşağıdaki komutu çalıştırarak Edge 4.53.01 apigee-service yardımcı programını ve bağımlılıklarını yükleyin:
```
sudo bash /tmp/bootstrap_4.53.01.sh apigeeuser=uName apigeepassword=pWord
```
  Burada uName:pWord, Apigee'den aldığınız kullanıcı adı ve şifredir. pWord karakterini atlarsanız girmeniz istenir.
  
  Yükleyici, varsayılan olarak Java 1.8'in yüklü olup olmadığını kontrol eder. Aksi takdirde yükleyici, bu bileşeni sizin için yükler.
  
  Java yüklemesinin nasıl ele alınacağını belirtmek için JAVA_FIX seçeneğini kullanın. JAVA_FIX aşağıdaki değerleri alır:
  - I: OpenJDK 1.8'i (varsayılan) yükleyin.
  - C: Java'yı yüklemeden devam edin.
  - Q: Çıkış. Bu seçeneği kullanmak için Java'yı kendiniz yüklemeniz gerekir.
3. Aşağıdaki örnekte gösterildiği gibi apigee-setup yardımcı programını güncellemek için apigee-service kullanın:
```
/opt/apigee/apigee-service/bin/apigee-service apigee-setup update
```
4. Yönetim sunucusundaki apigee-validate yardımcı programını aşağıdaki örnekte gösterildiği gibi güncelleyin:
```
/opt/apigee/apigee-service/bin/apigee-service apigee-validate update
```
5. Yönetim sunucusundaki apigee-provision yardımcı programını aşağıdaki örnekte gösterildiği gibi güncelleyin:
```
/opt/apigee/apigee-service/bin/apigee-service apigee-provision update
```
6. Aşağıdaki komutu çalıştırarak düğümlerinizde update yardımcı programını çalıştırın:
```
/opt/apigee/apigee-setup/bin/update.sh -c component -f configFile
```
  Bu işlemi Makine güncelleme sırası bölümünde açıklanan sırayla yapın.
  
  Burada:
  - component, güncellenecek Edge bileşenidir. Olası değerler şunlardır:
    - cs: Cassandra
    - edge: Edge kullanıcı arayüzü hariç tüm Edge bileşenleri: Yönetim Sunucusu, Mesaj İşleyici, Yönlendirici, QPID Sunucusu, Postgres Sunucusu
    - ldap: OpenLDAP
    - ps: postgresql
    - qpid: qpidd
    - sso: Apigee TOA (TOA'yı yüklediyseniz)
    - ue: Yeni Edge kullanıcı arayüzü
    - ui: Klasik Edge kullanıcı arayüzü
    - zk: Zookeeper
  - configFile, 4.52.02 veya 4.53.00 kurulumu sırasında Edge bileşenlerinizi tanımlamak için kullandığınız yapılandırma dosyasıyla aynıdır.
  update.sh değerini "all" olarak ayarlayarak component değerini tüm bileşenlere karşı çalıştırabilirsiniz ancak bu yalnızca Edge all-in-one (AIO) yükleme profiliniz varsa mümkündür. Örneğin:
```
/opt/apigee/apigee-setup/bin/update.sh -c all -f ./sa_silent_config
```
7. Henüz yapmadıysanız Edge kullanıcı arayüzü bileşenlerini, bunları çalıştıran tüm düğümlerde yeniden başlatın:
```
/opt/apigee/apigee-service/bin/apigee-service [edge-management-ui|edge-ui] restart
```
8. Yüklemeyi test etme bölümünde açıklandığı gibi, Yönetim Sunucusu'nda apigee-validate yardımcı programını çalıştırarak güncellemeyi test edin.

Güncellemeyi daha sonra geri almaya karar verirseniz 4.53.01 sürümüne geri dönme başlıklı makalede açıklanan prosedürü kullanın.

Yerel bir depodan 4.53.01 sürümüne güncelleme

Edge düğümleriniz bir güvenlik duvarının arkasındaysa veya başka bir şekilde internet üzerinden Apigee deposuna erişmeleri yasaklanmışsa güncellemeyi Apigee deposunun yerel bir deposundan ya da yansısından gerçekleştirebilirsiniz.

Yerel bir Edge deposu oluşturduktan sonra, Edge'i yerel depodan güncellemek için iki seçeneğiniz vardır:

Deponun .tar dosyasını oluşturun, .tar dosyasını bir düğüme kopyalayın ve ardından Edge'i .tar dosyasından güncelleyin.
Diğer düğümlerin erişebilmesi için yerel depolu düğüme bir web sunucusu yükleyin. Apigee, kullanmanız için Nginx web sunucusunu sağlar veya kendi web sunucunuzu kullanabilirsiniz.

Yerel bir 4.53.01 deposundan güncellemek için:

"Yerel bir Apigee deposu oluşturma" bölümünde açıklandığı şekilde yerel bir 4.53.01 deposu oluşturun: Edge apigee-setup yardımcı programını yükleyin.
NOT: Mevcut bir deponuz varsa 4.53.01 deposunu Install the Edge apigee-setup utility (Edge apigee-setup yardımcı programını yükleme) bölümündeki "Update a local Apigee repository" (Yerel bir Apigee deposunu güncelleme) başlığında açıklandığı şekilde ekleyebilirsiniz.
apigee-service'i bir .tar dosyasından yüklemek için:
1. Yerel depoya sahip düğümde, yerel depoyu /opt/apigee/data/apigee-mirror/apigee-4.53.01.tar.gz adlı tek bir .tar dosyası halinde paketlemek için aşağıdaki komutu kullanın:
```
/opt/apigee/apigee-service/bin/apigee-service apigee-mirror package
```
2. .tar dosyasını, Edge'i güncellemek istediğiniz düğüme kopyalayın. Örneğin, yeni düğümdeki /tmp dizinine kopyalayın.
3. Yeni düğümde, dosyayı /tmp dizinine açın:
```
tar -xzf apigee-4.53.01.tar.gz
```
  Bu komut, .tar dosyasını içeren dizinde repos adlı yeni bir dizin oluşturur. Örneğin /tmp/repos.
4. Edge apigee-service yardımcı programını ve bağımlılıklarını /tmp/repos adresinden yükleyin:
```
sudo bash /tmp/repos/bootstrap_4.53.01.sh apigeeprotocol="file://" apigeerepobasepath=/tmp/repos
```
  Bu komuta, repos dizininin yolunu eklediğinizi unutmayın.
Nginx web sunucusunu kullanarak apigee-service'i yüklemek için:
1. Nginx web sunucusunu, Install the Edge apigee-setup utility (Edge apigee-setup yardımcı programını yükleme) bölümündeki "Install from the repo using the Nginx webserver" (Nginx web sunucusunu kullanarak depodan yükleme) başlıklı makalede açıklandığı şekilde yapılandırın.
2. Uzak düğümde, Edge bootstrap_4.53.01.sh dosyasını /tmp/bootstrap_4.53.01.sh konumuna indirin:
```
/usr/bin/curl http://uName:pWord@remoteRepo:3939/bootstrap_4.53.01.sh -o /tmp/bootstrap_4.53.01.sh
```
  Burada uName:pWord, daha önce depo için ayarladığınız kullanıcı adı ve şifre, remoteRepo ise depo düğümünün IP adresi veya DNS adıdır.
3. Uzak düğümde Edge apigee-setup yardımcı programını ve bağımlılıklarını yükleyin:
```
sudo bash /tmp/bootstrap_4.53.01.sh apigeerepohost=remoteRepo:3939 apigeeuser=uName apigeepassword=pWord apigeeprotocol=http://
```
  Burada uName:pWord, depo kullanıcı adı ve şifresidir.
Aşağıdaki örnekte gösterildiği gibi apigee-setup yardımcı programını güncellemek için apigee-service kullanın:
```
/opt/apigee/apigee-service/bin/apigee-service apigee-setup update 
```
Yönetim sunucusundaki apigee-validate yardımcı programını aşağıdaki örnekte gösterildiği gibi güncelleyin:
```
/opt/apigee/apigee-service/bin/apigee-service apigee-validate update
```
Yönetim sunucusundaki apigee-provision yardımcı programını aşağıdaki örnekte gösterildiği gibi güncelleyin:
```
/opt/apigee/apigee-service/bin/apigee-service apigee-provision update
```
Makine güncelleme sırası bölümünde açıklanan sırayla düğümlerinizde update yardımcı programını çalıştırın:
```
/opt/apigee/apigee-setup/bin/update.sh -c component -f configFile
```
Burada:
- component, güncellenecek Edge bileşenidir. Genellikle aşağıdaki bileşenleri güncellersiniz:
  - cs: Cassandra
  - edge: Edge kullanıcı arayüzü hariç tüm Edge bileşenleri: Yönetim Sunucusu, Mesaj İşleyici, Yönlendirici, QPID Sunucusu, Postgres Sunucusu
  - ldap: OpenLDAP
  - ps: postgresql
  - qpid: qpidd
  - sso: Apigee TOA (TOA'yı yüklediyseniz)
  - ue Yeni Edge kullanıcı arayüzü
  - ui: Klasik Edge kullanıcı arayüzü
  - zk: Zookeeper
- configFile, 4.52.02 veya 4.53.00 kurulumu sırasında Edge bileşenlerinizi tanımlamak için kullandığınız yapılandırma dosyasıyla aynıdır.
  NOT: Yapılandırma dosyası, "apigee" kullanıcısı tarafından okunabilir olmalıdır. Sahibi değiştirmek için aşağıdaki komutu kullanın:
```
chown apigee:apigee configFile
```
update.sh değerini "all" olarak ayarlayarak tüm bileşenlere karşı component çalıştırabilirsiniz ancak bu yalnızca Edge all-in-one (AIO) yükleme profiliniz varsa mümkündür. Örneğin:
```
/opt/apigee/apigee-setup/bin/update.sh -c all -f /tmp/sa_silent_config
```
Henüz yapmadıysanız kullanıcı arayüzü bileşenlerini, üzerinde çalıştıkları tüm düğümlerde yeniden başlatın:
```
/opt/apigee/apigee-service/bin/apigee-service [edge-management-ui|edge-ui] restart
```
Yüklemeyi test etme bölümünde açıklandığı gibi, Yönetim Sunucusu'nda apigee-validate yardımcı programını çalıştırarak güncellemeyi test edin.

Güncellemeyi daha sonra geri almaya karar verirseniz 4.53.01 sürümüne geri dönme başlıklı makalede açıklanan prosedürü kullanın.

Makine güncelleme sırası

Bir Edge kurulumunda makineleri güncelleme sırası önemlidir:

Diğer bileşenleri güncellemeden önce tüm LDAP düğümlerini güncellemeniz gerekir. LDAP'yi yükseltmek için özel adımları uygulamanız gerekir.
Tüm Cassandra ve ZooKeeper düğümlerini güncellemeniz gerekir. 4.52.02 sürümünden yükseltme yapıyorsanız Cassandra'yı yükseltmek için özel adımları uygulayın. 4.52.02 veya 4.53.00 için Zookeeper'ı yükseltmek üzere özel adımları uygulamanız gerekir.
Yönetim sunucularını ve yönlendirici ile mesaj işlemcilerini güncellemek için -c edge seçeneğini kullanarak yükseltmeniz gerekir.
Postgres'i yükseltme ile ilgili özel adımları uygulayarak tüm Postgres düğümlerini yükseltmeniz gerekir.
Tüm veri merkezlerindeki edge-qpid-server ve edge-postgres-server bileşenlerini güncellemeniz gerekir.
Tüm Qpid düğümlerini yükseltmeniz gerekir.
Edge kullanıcı arayüzü düğümlerini ve Yeni Edge kullanıcı arayüzü ile SSO düğümlerini(geçerliyse) yükseltmeniz gerekir.
Para kazanma ayarlarını güncellemek için ayrı bir adım yoktur. -c kenar seçeneğini belirttiğinizde güncellenir.

1 düğümlü bağımsız yükseltme

1 düğümlü bağımsız bir yapılandırmayı 4.53.01 sürümüne yükseltmek için:

Tüm bileşenleri güncelleyin:

/opt/apigee/apigee-setup/bin/update.sh -c all -f configFile

(apigee-adminapi'ı yüklediyseniz) apigee-adminapi yardımcı programını güncelleyin:
```
/opt/apigee/apigee-service/bin/apigee-service apigee-adminapi update
```

2 düğümlü bağımsız yükseltme

2 düğümlü bağımsız bir kurulum için aşağıdaki bileşenleri güncelleyin:

Edge topolojilerinin ve düğüm numaralarının listesi için Yükleme topolojileri'ne bakın.

1. makinede LDAP'yi güncelleyin:

/opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile

1. makinede Cassandra ve ZooKeeper'ı güncelleyin:

/opt/apigee/apigee-setup/bin/update.sh -c cs,zk -f configFile

1. makinede Edge bileşenlerini güncelleyin:

/opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile

2. makinede Postgres'i güncelleyin:

/opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile

1. makinede Edge bileşenlerini güncelleyin:

/opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile

2. makinede Qpid'i güncelleyin:

/opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile

1. makinede kullanıcı arayüzünü güncelleyin:

/opt/apigee/apigee-setup/bin/update.sh -c ui -f configFile

(apigee-adminapi yüklediyseniz) 1. makinedeki apigee-adminapi yardımcı programını güncellediyseniz:
```
/opt/apigee/apigee-service/bin/apigee-service apigee-adminapi update
```
(Apigee TOA'yı yüklediyseniz) 1. makinede Apigee TOA'yı güncelleyin:
```
/opt/apigee/apigee-setup/bin/update.sh -c sso -f sso_config_file
```
Burada sso_config_file, TOA'yı yüklerken oluşturduğunuz yapılandırma dosyasıdır.
1. makinede Edge kullanıcı arayüzü bileşenini yeniden başlatın:
```
/opt/apigee/apigee-service/bin/apigee-service edge-ui restart
```

5 düğümlü yükseltme

5 düğümlü bir yükleme için aşağıdaki bileşenleri güncelleyin:

Edge topolojilerinin ve düğüm numaralarının listesi için Yükleme topolojileri'ne bakın.

1. makinede LDAP'yi güncelleyin:

/opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile

1, 2 ve 3 numaralı makinelerde Cassandra ve ZooKeeper'ı güncelleyin:
```
/opt/apigee/apigee-setup/bin/update.sh -c cs,zk -f configFile
```
1, 2 ve 3 numaralı makinedeki Edge bileşenlerini güncelleyin:
```
/opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
```

4 numaralı makinede Postgres'i güncelleyin:

/opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile

5 numaralı makinede Postgres'i güncelleyin:

/opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile

4. ve 5. makinedeki Edge bileşenlerini güncelleyin:

/opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile

4. makinede Qpid'i güncelleyin:

/opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile

5. makinede Qpid'i güncelleyin:

/opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile

Edge kullanıcı arayüzünü güncelleme:
- Klasik kullanıcı arayüzü: Klasik kullanıcı arayüzünü kullanıyorsanız 1. makinedeki ui bileşenini aşağıdaki örnekte gösterildiği gibi güncelleyin:
```
/opt/apigee/apigee-setup/bin/update.sh -c ui -f configFile
```
- Yeni Edge kullanıcı arayüzü: Yeni Edge kullanıcı arayüzünü yüklediyseniz uygun makinedeki (1. makine olmayabilir) ue bileşenini güncelleyin:
```
/opt/apigee/apigee-setup/bin/update.sh -c ue -f /opt/silent.conf
```
(apigee-adminapi yüklediyseniz) 1. makinedeki apigee-adminapi yardımcı programını güncellediyseniz:
```
/opt/apigee/apigee-service/bin/apigee-service apigee-adminapi update
```
(Apigee TOA'yı yüklediyseniz) 1. makinede Apigee TOA'yı güncelleyin:
```
/opt/apigee/apigee-setup/bin/update.sh -c sso -f sso_config_file
```
Burada sso_config_file, TOA'yı yüklerken oluşturduğunuz yapılandırma dosyasıdır.
Kullanıcı arayüzü bileşenini yeniden başlatın:
- Klasik kullanıcı arayüzü: Klasik kullanıcı arayüzünü kullanıyorsanız aşağıdaki örnekte gösterildiği gibi 1. makinede edge-ui bileşenini yeniden başlatın:
```
/opt/apigee/apigee-service/bin/apigee-service edge-ui restart
```
- Yeni Edge kullanıcı arayüzü: Yeni Edge kullanıcı arayüzünü yüklediyseniz uygun makinede edge-management-ui bileşenini yeniden başlatın (1. makine olmayabilir):
```
/opt/apigee/apigee-service/bin/apigee-service edge-management-ui restart
```

9 düğümlü kümelenmiş yükseltme

9 düğümlü kümelenmiş bir kurulum için aşağıdaki bileşenleri güncelleyin:

Edge topolojilerinin ve düğüm numaralarının listesi için Yükleme topolojileri'ne bakın.

1. makinede LDAP'yi güncelleyin:

/opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile

1, 2 ve 3 numaralı makinelerde Cassandra ve ZooKeeper'ı güncelleyin:
```
/opt/apigee/apigee-setup/bin/update.sh -c cs,zk -f configFile
```
1, 4 ve 5 numaralı makinelerdeki (yönetim sunucusu, ileti işlemcisi, yönlendirici) Edge bileşenlerini bu sırayla güncelleyin:
```
/opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
```

8 numaralı makinede Postgres'i güncelleyin:

/opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile

9 numaralı makinede Postgres'i güncelleyin:

/opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile

6, 7, 8 ve 9 numaralı makinelerde Edge bileşenlerini bu sırayla güncelleyin:
```
/opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
```

6. ve 7. makinelerde Qpid'i güncelleyin:

/opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile

1. makinede yeni kullanıcı arayüzünü (ue) veya klasik kullanıcı arayüzünü (ui) güncelleyin:
```
/opt/apigee/apigee-setup/bin/update.sh -c [ui|ue] -f configFile
```
(apigee-adminapi'ı yüklediyseniz) 1. makinede apigee-adminapi yardımcı programını güncelleyin:
```
/opt/apigee/apigee-service/bin/apigee-service apigee-adminapi update
```
(Apigee TOA'yı yüklediyseniz) 1. makinede Apigee TOA'yı güncelleyin:
```
/opt/apigee/apigee-setup/bin/update.sh -c sso -f sso_config_file
```
Burada sso_config_file, TOA'yı yüklerken oluşturduğunuz yapılandırma dosyasıdır.
Kullanıcı arayüzü bileşenini yeniden başlatın:
- Klasik kullanıcı arayüzü: Klasik kullanıcı arayüzünü kullanıyorsanız aşağıdaki örnekte gösterildiği gibi 1. makinede edge-ui bileşenini yeniden başlatın:
```
/opt/apigee/apigee-service/bin/apigee-service edge-ui restart
```
- Yeni Edge kullanıcı arayüzü: Yeni Edge kullanıcı arayüzünü yüklediyseniz uygun makinede edge-management-ui bileşenini yeniden başlatın (1. makine olmayabilir):
```
/opt/apigee/apigee-service/bin/apigee-service edge-management-ui restart
```

13 düğümlü kümelenmiş yükseltme

13 düğümlü kümelenmiş bir yükleme için aşağıdaki bileşenleri güncelleyin:

Edge topolojilerinin ve düğüm numaralarının listesi için Yükleme topolojileri'ne bakın.

4. ve 5. makinede LDAP'yi güncelleyin:

/opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile

1, 2 ve 3 numaralı makinelerde Cassandra ve ZooKeeper'ı güncelleyin:
```
/opt/apigee/apigee-setup/bin/update.sh -c cs,zk -f configFile
```
6, 7, 10 ve 11 numaralı makinelerde Edge bileşenlerini bu sırayla güncelleyin:
```
/opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
```

8 numaralı makinede Postgres'i güncelleyin:

/opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile

9 numaralı makinede Postgres'i güncelleyin:

/opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile

12, 13, 8 ve 9 numaralı makinelerde Edge bileşenlerini bu sırayla güncelleyin:
```
/opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
```

12 ve 13 numaralı makinelerde Qpid'i güncelleyin:

/opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile

6 ve 7 numaralı makinelerde yeni kullanıcı arayüzünü (ue) veya klasik kullanıcı arayüzünü (ui) güncelleyin:
```
/opt/apigee/apigee-setup/bin/update.sh -c [ui|ue] -f configFile
```
(apigee-adminapi yüklediyseniz) 6. ve 7. makinelerdeki apigee-adminapi yardımcı programı güncellendi:
```
/opt/apigee/apigee-service/bin/apigee-service apigee-adminapi update
```
(Apigee TOA'yı yüklediyseniz) 6. ve 7. makinelerde Apigee TOA'yı güncelleyin:
```
/opt/apigee/apigee-setup/bin/update.sh -c sso -f sso_config_file
```
Burada sso_config_file, TOA'yı yüklerken oluşturduğunuz yapılandırma dosyasıdır.
Kullanıcı arayüzü bileşenini yeniden başlatın:
- Klasik kullanıcı arayüzü: Klasik kullanıcı arayüzünü kullanıyorsanız aşağıdaki örnekte gösterildiği gibi 6. ve 7. makinelerdeki edge-ui bileşenini yeniden başlatın:
```
/opt/apigee/apigee-service/bin/apigee-service edge-ui restart
```
- Yeni Edge kullanıcı arayüzü: Yeni Edge kullanıcı arayüzünü yüklediyseniz 6. ve 7. makinelerde edge-management-ui bileşenini yeniden başlatın:
```
/opt/apigee/apigee-service/bin/apigee-service edge-management-ui restart
```

12 düğümlü kümelenmiş yükseltme

12 düğümlü kümelenmiş bir kurulum için aşağıdaki bileşenleri güncelleyin:

Edge topolojilerinin ve düğüm numaralarının listesi için Yükleme topolojileri'ne bakın.

LDAP'yi güncelleme:

Veri Merkezi 1'deki Makine 1

/opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile

Veri Merkezi 2'deki 7. Makine

/opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile

Cassandra ve ZooKeeper'ı güncelleyin:
1. Veri merkezi 1'deki 1, 2 ve 3 numaralı makineler:
```
/opt/apigee/apigee-setup/bin/update.sh -c cs,zk -f configFile
```
2. Veri Merkezi 2'deki 7, 8 ve 9 numaralı makinelerde:
```
/opt/apigee/apigee-setup/bin/update.sh -c cs,zk -f configFile
```
Edge bileşenlerini güncelleme:
1. 1. Veri Merkezi'ndeki 1, 2 ve 3 numaralı makinelerde:
```
/opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
```
2. Veri Merkezi 2'deki 7, 8 ve 9 numaralı makinelerde
```
/opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
```

Postgres'i güncelleme:

Veri Merkezi 1'deki 6. Makine

/opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile

Veri Merkezi 2'deki 12. Makine

/opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile

Edge bileşenlerini güncelleme:
1. Veri Merkezi 1'deki 4, 5 ve 6 numaralı makineler
```
/opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
```
2. Veri Merkezi 2'deki 10, 11 ve 12 numaralı makineler
```
/opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
```
qpidd'yi güncelleyin:
1. Veri Merkezi 1'deki 4. ve 5. makineler
  1. 4. makinede qpidd uygulamasını güncelleyin:
```
/opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
```
  2. 5. makinede qpidd uygulamasını güncelleyin:
```
/opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
```
2. Veri Merkezi 2'deki 10 ve 11 numaralı makineler
  1. 10 numaralı makinede qpidd uygulamasını güncelleyin:
```
/opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
```
  2. 11 numaralı makinede qpidd uygulamasını güncelleyin:
```
/opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
```
Yeni kullanıcı arayüzünü (ue) veya klasik kullanıcı arayüzünü (ui) güncelleyin:
1. Veri merkezi 1'deki 1. makine:
```
/opt/apigee/apigee-setup/bin/update.sh -c [ui|ue] -f configFile
```
2. Veri Merkezi 2'deki 7. Makine:
```
/opt/apigee/apigee-setup/bin/update.sh -c [ui|ue] -f configFile
```
(apigee-adminapi yüklediyseniz) apigee-adminapi yardımcı programı güncellendi:
1. Veri merkezi 1'deki 1. makine:
```
/opt/apigee/apigee-service/bin/apigee-service apigee-adminapi update
```
2. Veri Merkezi 2'deki 7. Makine:
```
/opt/apigee/apigee-service/bin/apigee-service apigee-adminapi update
```
(Apigee TOA'yı yüklediyseniz) Apigee TOA'yı güncelleyin:
1. Veri merkezi 1'deki 1. makine:
```
/opt/apigee/apigee-setup/bin/update.sh -c sso -f sso_config_file
```
2. Veri Merkezi 2'deki 7. Makine:
```
/opt/apigee/apigee-setup/bin/update.sh -c sso -f sso_config_file
```
1 ve 7 numaralı makinelerde yeni Edge kullanıcı arayüzü (edge-management-ui) veya klasik Edge kullanıcı arayüzü (edge-ui) bileşenini yeniden başlatın:
```
/opt/apigee/apigee-service/bin/apigee-service [edge-ui|edge-management-ui] restart
```

Standart olmayan bir yapılandırma için

Standart olmayan bir yapılandırmanız varsa Edge bileşenlerini aşağıdaki sırayla güncelleyin:

LDAP
Cassandra
Zookeeper
Yönetim Sunucusu
Mesaj İşleyici
Yönlendirici
Postgres
Uç (Edge): Sırayla tüm düğümlerdeki "-c edge" profili (Qpid sunucusu olan düğümler, Edge Postgres sunucusu).
NOT: Bir düğümde hem Qpid sunucusu hem de Edge Postgres sunucusu yüklüyse "-c edge" profil adımını çalıştırın.
qpidd
Edge kullanıcı arayüzü (klasik veya yeni)
apigee-adminapi
Apigee SSO

Güncellemeyi tamamladıktan sonra, Edge kullanıcı arayüzü bileşenini çalıştıran tüm makinelerde yeniden başlattığınızdan emin olun.