Apigee Edge 4.53.00 veya 4.53.01'i 4.54.00'a güncelleme

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

Uyumlu yükseltme yöntemlerine genel bakış için Edge for Private Cloud sürümleri için yükseltme uyumluluk matrisine bakın.

Güncellemeyi kimler yapabilir?

Güncellemeyi çalıştıran kişi, Edge'i ilk yükleyen kişi veya root olarak çalışan bir kullanıcı 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.

Ön okuma materyalleri

Edge for Private Cloud 4.54.00'da yapılan değişikliklerle ilgili önemli bilgiler için aşağıdaki konuları inceleyin:

• 4.54.00 sürümündeki değişiklikler: TLS ve Java Callout'ta, yükseltme işleminden önce hazırlık gerektiren değişiklikleri inceleyin. Daha fazla bilgi için 4.54.00 sürümündeki değişiklikler başlıklı makaleyi inceleyin.

• Çift Java çalışma zamanı mimarisi (Java 17 ve Java 21): 4.54.00 sürümünden itibaren Edge for Private Cloud, Java 8 desteğini kaldırır ve bileşenleri Java 17 veya Java 21'de çalıştırır. Daha fazla bilgi için 4.54.00 sürümündeki değişiklikler başlıklı makaleyi inceleyin.

• Önyükleme sırasında otomatik Java yüklemesi yok: Edge for Private Cloud 4.54.00, Java yüklemelerini keşfedebilir ve hem Java 17 hem de 21'in yüklü olduğunu doğrular.

• 4.54.00 sürümündeki yeni Edge kullanıcı arayüzü: Varsayılan yönetim arayüzü olarak yeni Edge kullanıcı arayüzüne geçiş ve klasik kullanıcı arayüzünün (edge-ui) kaldırılması hakkında bilgi edinin. Daha fazla bilgi için Yeni Edge kullanıcı arayüzü başlıklı makaleyi inceleyin.

• 4.54.00 sürümünde Apigee TOA: Güncellenen TOA mimarisini ve kimlik doğrulama için yapılandırma değişikliklerini anlayın. Daha fazla bilgi için Apigee SSO (Apigee TOA) başlıklı makaleyi inceleyin.

• 4.54.00'da Nginx 1.30: Edge yönlendiricilerde otomatik Nginx 1.30.x yükseltmesini, çalışma zamanı üzerindeki olası etkileri ve azaltma adımlarını inceleyin. Daha fazla bilgi için Nginx 1.30 Değişiklikleri başlıklı makaleyi inceleyin.

Yükseltme ön koşulları

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

• Sürüm notlarını ve yeni özellikleri inceleme

  Yükseltme sürecini başlatmadan önce Edge for Private Cloud sürüm notlarında ayrıntılı olarak açıklanan tüm yeni özellikleri, davranış değişikliklerini ve kullanımdan kaldırılan özellikleri iyice inceleyip anladığınızdan emin olun.

• Yükseltme sırasında otomatik Java ikili program keşfi ve bir arada bulunma: Java'yı standart paket yöneticileri (ör. yum) veya standart konumlar (ör. /usr/lib/jvm veya update-alternatives) kullanarak yükleyin. Sistem PATH'inde her iki sürümü de aynı anda yapılandırmanız gerekmez. Yükseltme işleminden önce Java 8'i kaldırmayın. Mevcut Edge for Private Cloud 4.53.xx hizmetlerinin güncellenene kadar kesintisiz çalışmaya devam etmesi için Java 17 ve Java 21 ile birlikte Java 8'i de yüklü tutun.

• Tüm düğümleri yedekleme

  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 mevcut Edge sürümünüzle ilgili 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.

• Sessiz yapılandırma dosyasının yedeği

  Gerekirse geri alma işlemini kolaylaştırmak için Edge for Private Cloud 4.53.00 veya 4.53.01 için sessiz yapılandırma dosyalarının yedek kopyalarının saklandığından emin olun.

• Edge'in çalıştığından emin olma

  Güncelleme işlemi sırasında Edge'in çalışır durumda olduğundan 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.53.00 (veya) 4.53.01 sürümüne yükseltme yaptıysanız ve şimdi 4.54.00 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.53.00 (veya) 4.53.01 sürümü yükseltme belgelerinde ve Cassandra yükseltme ön koşulları bölümünde açıklanmıştır. Bu adımların önceki yükseltme sırasında tamamlanıp tamamlanmadığından emin değilseniz 4.54.00 sürümüne yükseltme işlemine devam etmeden önce bu adımları tekrar tamamlayın.

• apigee-monit'i durdurun: apigee-monit düğümde çalışıyorsa yükseltme işleminden önce /opt/apigee/apigee-service/bin/apigee-service apigee-monit stop komutuyla durdurun. Bu, apigee-monit'in yükseltme sırasında bileşenleri otomatik olarak yeniden başlatmasını önler. Yükseltme tamamlandıktan sonra apigee-service apigee-monit start ile yeniden etkinleştirin.

Mülk ayarlarının otomatik olarak yayılması

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

Yönlendirici ve Mesaj İşlemci'yi yükseltme

Veri merkezlerindeki tüm yönlendirici ve mesaj işleyici düğümlerini tek tek yükseltin:

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

Yönetim sunucusunu yükseltme

Veri merkezlerindeki tüm Yönetim Sunucusu düğümlerini tek tek yükseltin:

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

OpenLDAP 2.6.10'a yükseltme

Edge for Private Cloud 4.54.00, OpenLDAP 2.6.10'u kullanıma sunar. Bu yükseltme, tüm Apigee OpenLDAP dağıtım topolojileri için geçerlidir: tek sunuculu, etkin-pasif ve etkin-etkin (çoklu ana).

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

Yeni Edge kullanıcı arayüzüne ve Apigee TOA'ya (yüklüyse) yükseltme

Apigee Edge for Private Cloud 4.54.00'da klasik kullanıcı arayüzü (edge-ui) kaldırıldı ve yerine yeni Edge kullanıcı arayüzü (edge-management-ui) getirildi. Kurulumunuzda Apigee Tek Oturum Açma'nın (TOA) yüklü ve kullanılıyor olup olmadığına bağlı olarak aşağıdaki iki seçenekten birini uygulayın:

# Authentication mode for New Edge UI (Basic Authentication - No Apigee SSO)
AUTH_MODE=basic

# Access configuration for the New Edge UI
MANAGEMENT_UI_PORT=3001
MANAGEMENT_UI_APP_ENV=OPDK
MANAGEMENT_UI_IP=MANAGEMENT_UI_NODE_IP #Replace MANAGEMENT_UI_NODE_IP with the IP address or hostname of the UI node.
MANAGEMENT_UI_SCHEME=http

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

apigee-service apigee-sso stop

/opt/apigee/apigee-service/bin/apigee-service apigee-openldap setup-sso -f configFile

/opt/apigee/apigee-service/bin/apigee-service edge-management-ui configure-sso -f configFile

apigee-service apigee-sso uninstall

Qpid 10.0.1 sürümüne yükseltin

Bu yöntem, Edge çalışma zamanı ortamınızda kesinti olmamasını sağlar ve analiz için edinilen çalışma zamanı verilerindeki kaybı (varsa) en aza indirir.

Qpid'e yerinde, sıfır kesinti süreli bir yükseltme gerçekleştirmek için:

1. Başlamak için bir Qpid düğümü seçin.

2. Düğümde Qpid aracısını durdurun:

   apigee-service apigee-qpidd stop

3. Güvenlik duvarı uygulayarak tüm mesaj işlemcilerden gelen trafiği 5672 numaralı aracı bağlantı noktasında 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şlemci IP adreslerinden 5672 numaralı bağlantı noktasındaki Qpid düğümüne gelen istekleri DROP etmek için aşağıdaki gibi bir komut kullanabilirsiniz:

   iptables -A INPUT -p tcp --dport 5672 -s MESSAGE_PROCESSOR_IP -j DROP

4. Varsa mevcut mesajları boşaltmak için Qpid aracısını tekrar başlatın:

   apigee-service apigee-qpidd start

5. Mevcut sıraların boş olup olmadığını kontrol edin:

   /opt/apigee/apigee-qpidd/bin/qpid-stat -q

   Mesajlar, teslim edilemeyen mesajlar kuyruğunda (DLQ) (ax-q-axgroup-001-consumer-group-001-dl) takılı kalırsa teslim edilemeyen mesajlar kuyruğunda takılı kalan analiz verilerini çözme adımlarını uygulayarak kuyruğu boşaltın.

6. Eski düğümdeki sıraların boşaltıldığını doğruladıktan sonra apigee-qpidd hizmetini durdurun:

   apigee-service apigee-qpidd stop

7. Düğümde Qpid'yi yükseltin:

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

8. edge-qpid-server uygulamasını yeniden başlatın:

   apigee-service edge-qpid-server restart

9. 3. adımda uygulanan güvenlik duvarı kuralını kaldırın.

   Güvenlik duvarının uygulandığı tüm mesaj işleyici IP adresleri için aynı kaldırma adımını uygulayın. Güvenlik duvarları kaldırıldıktan sonra, mesaj işlemci IP adreslerinden 5672 numaralı bağlantı noktasındaki Qpid düğümüne gelen istekler kabul edilir. Güvenlik duvarını eklemek için iptables kullandıysanız güvenlik duvarını kaldırmak ve mevcut ayarları listelemek için aşağıdaki gibi komutlar kullanabilirsiniz:

   iptables -F
   iptables -L

10. Qpid sıralarının mesaj aldığını doğrulamak için web izlemeyi kullanın:

    http://QPID_NODE_IP:8090

11. Her Qpid düğümü için 1-9 arasındaki adımları tekrarlayın.

Postgres 18.6'ya yükseltme

Edge'in bu sürümü, Postgres 18.6'ya yükseltme içerir. Bu yükseltme kapsamında tüm Postgres verileri Postgres 18.6'ya taşınır.

Çoğu Edge üretim sistemi, birincil 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 devre dışı bırakılırken analiz verileri Qpid düğümlerine yazılmaya devam eder. Postgres düğümleri güncellenip tekrar çevrimiçi olduktan sonra analiz verileri Postgres düğümlerine aktarılır.

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 alanı 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ü kullanımdan kaldırabilirsiniz. Güncellemeyi herhangi bir nedenle geri almanız gerekirse ek Postgres bekleme düğümü gerekir. Güncellemeyi geri almanız gerekirse yeni Postgres yedek düğümü, geri alma işleminden sonra birincil Postgres düğümü olur. Bu nedenle, yeni Postgres yedek düğümünü yüklediğinizde, Edge Yükleme gereksinimleri bölümünde tanımlandığı şekilde bir Postgres sunucusunun tüm donanım gereksinimlerini 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 Postgres düğümünüz olur. Yeni bir Postgres düğümü oluşturmak zorunda kalmadan bu Postgres düğümlerini doğrudan güncelleyebilirsiniz.

• Apigee tarafından önerildiği şekilde 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 yedek düğümünün yüklenmesini ve daha sonra kullanımdan kaldırı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 yedek düğümü yükleme

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

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

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

1. Mevcut Postgres birincil sunucusunda, 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 yedek sunucusunun IP adresi ve new_standby_ip, yeni yedek düğümün IP adresidir.

2. Postgres birincil düğümünde apigee-postgresql'i yeniden başlatın:

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

3. Birincil 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. 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

4. Yeni Postgres yedek sunucusunu yükleyin:

   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 current primary(master):
      PG_MASTER=PG_MASTER_NODE_IP
      # IP address of the new standby node
      PG_STANDBY=PG_STANDBY_NODE_IP

   2. Edge apigee-setup yardımcı programını yükleme bölümünde açıklandığı şekilde SELinux'u devre dışı bırakın.

   3. Mevcut Edge sürümünüze göre önyükleme komut dosyasını indirip çalıştırın:

      • Şu anda Edge 4.53.00 sürümünü kullanıyorsanız:

        Edge bootstrap_4.53.00.sh dosyasını /tmp/bootstrap_4.53.00.sh dizinine indirin:

        curl https://software.apigee.com/bootstrap_4.53.00.sh -o /tmp/bootstrap_4.53.00.sh

        Edge apigee-service yardımcı programını ve bağımlılıklarını yükleyin:

        bash /tmp/bootstrap_4.53.00.sh apigeeuser=uName apigeepassword=pWord

      • Şu anda Edge 4.53.01 sürümünü kullanıyorsanız:

        Edge bootstrap_4.53.01.sh dosyasını /tmp/bootstrap_4.53.01.sh dizinine indirin:

        curl https://software.apigee.com/bootstrap_4.53.01.sh -o /tmp/bootstrap_4.53.01.sh

        Edge apigee-service yardımcı programını ve bağımlılıklarını yükleyin:

        bash /tmp/bootstrap_4.53.01.sh apigeeuser=uName apigeepassword=pWord

   4. apigee-setup yardımcı programını yüklemek için apigee-service komutunu kullanın:

      /opt/apigee/apigee-service/bin/apigee-service apigee-setup install

   5. Postgres'i yükleme:

      /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 ve bekleme düğümü olduğunu doğrulayın:

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

Postgres'te yerinde yükseltme yapma

Ön adım

Postgres'e yerinde yükseltme yapmadan önce, apigee-postgresql üzerindeki max_locks_per_transaction özelliğini güncellemek için hem birincil ana makinede hem de bekleme modunda aşağıdaki adımları uygulayın:

1. Mevcut değilse /opt/apigee/customer/application/postgresql.properties dosyasını oluşturun .

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

   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ırma :

   apigee-service apigee-postgresql configure

5. apigee-postgresql'i yeniden başlatın :

   apigee-service apigee-postgresql restart

Yerinde yükseltme işlemini gerçekleştirme

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

1. Birincil ana makinede postgres'i yükseltme

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

2. Birincil ana makinede kurulum komutunu çalıştırın:

   apigee-service apigee-postgresql setup -f configFile

3. Birincil ana makinede configure komutunu çalıştırın:

   apigee-service apigee-postgresql configure

4. Birincil ana makineyi yeniden başlatın:

   apigee-service apigee-postgresql restart

5. Birincil olarak yapılandırın:

   apigee-service apigee-postgresql setup-replication-on-master -f configFile

6. Birincil düzenleyicinin başlattığından emin olun:

   apigee-service apigee-postgresql wait_for_ready

7. Bekleme modunu durdurma:

   apigee-service apigee-postgresql stop

8. Bekleme modunu yükseltin.

   Not: Bu adımda hata oluşursa veya adım başarısız olursa bu durum yoksayılabilir. update.sh, bekleme sunucusunu yanlış bir yapılandırmayla başlatmaya çalışır. Postgres yüklemesi 18'e yükseltildiyse hata yoksayılabilir.

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

9. Bekleme modunun durdurulduğundan emin olun:

   apigee-service apigee-postgresql stop

10. Eski bekleme yapılandırmasını kaldırın:

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

11. Yedek sunucuda replikasyonu ayarlayın:

    apigee-service apigee-postgresql setup-replication-on-standby -f configFile

12. Hem birincil ana makinede hem de bekleme modunda /opt/apigee/customer/application/postgresql.properties dosyasından conf/postgresql.conf+max_locks_per_transaction=30000 satırını kaldırın. Bu satır, ön adımda eklenmiştir .

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

Postgres düğümünü kullanımdan kaldırma

Güncelleme tamamlandıktan sonra yeni bekleme düğümünü kullanımdan kaldırın:

1. 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

2. 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 düğümün UUID'sini şu biçimde görürsünüz:

   "type" : [ "postgres-server" ],
   "uUID" : "599e8ebf-5d69-4ae4-aa71-154970a8ec75"

3. Yeni yedek düğümde aşağıdaki komutu çalıştırarak yeni yedek düğümü durdurun:

   /opt/apigee/apigee-service/bin/apigee-all stop

4. Postgres birincil düğümünde, yeni yedek düğümü conf_pg_hba_replication.connection öğesinden kaldırmak için /opt/apigee/customer/application/postgresql.properties öğesini düzenleyin:

   conf_pg_hba_replication.connection=host replication apigee existing_standby_ip/32 trust

5. Postgres birincil sunucusunda apigee-postgresql'yi yeniden başlatın:

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

6. Birincil düğümdeki /opt/apigee/apigee-postgresql/conf/pg_hba.conf dosyasını görüntüleyerek yeni bekleme düğümünün kaldırıldığını doğrulayın. Bu dosyada yalnızca aşağıdaki satırı görmeniz gerekir:

   host replication apigee existing_standby_ip/32 trust

7. Yönetim Sunucusu düğümünde aşağıdaki Edge Management API ç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

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

Postgres, sorgular yürütüldükçe ve autovacuum 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 birincil Postgres düğümündeki veritabanında bulunan tüm tablolarda ANALYZE komutunu çalıştırın. Alternatif olarak, aynı anda birkaç tablo için ANALYZE komutunu çalıştırabilirsiniz.

ZooKeeper 3.8.5'e yükseltme

Private Cloud için Edge'in bu sürümü, ZooKeeper 3.8.5'e yükseltme içerir. Bu yükseltme kapsamında tüm ZooKeeper verileri ZooKeeper 3.8.5'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çiminde oy kullanan seçmenler, diğerleri 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 ve 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 anlık bir gecikme veya yazma hatası olabilir. 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ı vb.) etkileyebilir. Aşağıdaki prosedür uygulanırken 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.

Genel olarak, yeni sürüme geçme işlemi her düğümün yedeğinin alınmasını içerir. Ardından tüm gözlemciler ve takipçiler, son olarak da lider düğüm yükseltilir.

Yedekleme yapma

Geri alma işlemi gerekirse kullanmak üzere ZooKeeper'ın tüm düğümlerinin yedeğini alın. Geri alma işleminin, ZooKeeper'ı yedeklemenin alındığı duruma geri yükleyeceğini unutmayın.

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

Sanal makine kullanıyorsanız ve imkanınız varsa 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

1. ZooKeeper düğümünde yüklü değilse nc'yi yükleyin:

   yum install nc

2. Düğümde aşağıdaki nc komutunu çalıştırın (2181, ZooKeeper bağlantı noktasıdır):

   echo stat | nc localhost 2181

   Aşağıdakine benzer bir çıkış görürsünüz:

   Zookeeper version: 3.8.5-19f1842d4b6ee1f82cc8b05284959b26c6ae507d, built on 2025-09-03 21:35 UTC
   Clients:
    /[0:0:0:0:0:0:0:1]:40696[0](queued=0,recved=1,sent=0)
   
   Latency min/avg/max: 3/4.3333/6
   Received: 4
   Sent: 3
   Connections: 1
   Outstanding: 0
   Zxid: 0x500000005
   Mode: follower

   Düğümler için çıkışın 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) ifadesini görürsünüz.

1. Her ZooKeeper düğümünde 1. ve 2. adımları tekrarlayın.

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

Her bir gözlemci ve takipçi düğümünde ZooKeeper'ı aşağıdaki şekilde yükseltin:

1. Harici internet bağlantısı olan bir düğümde 4.54.00 sürümüne güncelleme bölümünde açıklandığı gibi Edge for Private Cloud 4.54.00'ün önyüklemesini indirip çalıştırın. Süreç, düğümün harici bir internet bağlantısı olup olmadığına veya çevrimdışı bir kurulum yapıp yapmadığınıza bağlı olarak değişebilir.

2. 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 (zk,cs profiliyle olduğu gibi) veya 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.

3. Her ZooKeeper gözlemci ve takipçi düğümünde yukarıdaki adımları tekrarlayın.

Lideri alt edin

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, proxy'lerin dağıtım işlemi veya Apigee altyapı değişiklikleri (ör. mesaj işlemcilerin eklenmesi veya kaldırılması) gibi ZooKeeper'a yazma işlemlerini etkileyebilir.

Yeni liderin seçildiğini doğrulama

Yukarıdaki Lideri, takipçileri ve gözlemcileri belirleme bölümündeki adımları uygulayarak 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.

Yükseltme lideri

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

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

Cassandra 5.0.8'e yükseltme

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

Yükseltmeler ve geri alma

• Cassandra 4.0.X'ten Cassandra 5.0.X'e yükseltme işlemi kademeli olarak gerçekleştirilir.

• Cassandra 5.0.X'ten 4.0.X'e doğrudan yerinde geri alma işlemi yapılamaz. Replika veya yedek kullanarak geri alma işlemi karmaşık bir prosedürdür ve kesinti ve/veya veri kaybına neden olabilir. Sorunları gidermek ve Cassandra 5.0.X'e yükseltmek, geri alma işlemine tercih edilir.

• Yükseltme işlemini denemeden önce geri alma prosedürlerini öğrenmeniz önemlidir. Yükseltme sırasında geri alma işleminin ayrıntılarını dikkate almak, uygun geri alma yollarının kullanılabilir olmasını sağlamak açısından çok önemlidir.

Tek veri merkezi

Cassandra'yı tek bir veri merkezinde 4.0.X'ten 5.0.X'e yükseltmek sorunsuz bir işlemdir ancak geri alma işlemi karmaşıktır ve kesinti ile veri kaybına neden olabilir. Üretim iş yükleri için, yükseltme işlemini başlatmadan önce yeni veri merkezinde en az Cassandra düğümleri bulunan yeni bir veri merkezi eklemeniz önemle tavsiye edilir. Bu sayede, veri kaybı veya API trafiğinizde kesinti olmadan Cassandra'yı geri alabilirsiniz. Yükseltme tamamlandıktan sonra bu ek veri merkezi kullanımdan kaldırılabilir.

Yeni bir veri merkezi eklemek mümkün değilse ancak geri alma özelliği hâlâ isteniyorsa Cassandra 4.0.X'i geri yüklemek için yedekler gerekir. Ancak bu yöntemde hem kesinti hem de veri kaybı yaşanabilir.

Birden çok veri merkezi

Edge for Private Cloud 4.53.00 (veya) 4.53.01 ile birden fazla veri merkezi çalıştırmak, Edge for Private Cloud 4.54.00'a yükseltme sırasında geri alma işlemleri için daha fazla esneklik sunar.

• Geri alma işlemleri için önceki Cassandra sürümünü (4.0.X) çalıştıran en az bir veri merkezi gerekir.

Önerilen yükseltme metodolojisi

1. Cassandra veri merkezlerini tek tek yükseltin: Tek bir veri merkezindeki Cassandra düğümlerini tek tek yükselterek başlayın. Bir veri merkezindeki tüm Cassandra düğümlerinin yükseltme işlemlerini tamamladıktan sonra diğer veri merkezine geçin.

2. Duraklatma ve doğrulama: Bir veri merkezini yükselttikten sonra, Private Cloud kümenizin (özellikle de yükseltilen veri merkezinin) doğru şekilde çalıştığından emin olmak için duraklatın.

3. Unutmayın: Önceki Cassandra sürümüne geri dönmek için en az bir veri merkezinde eski sürümün çalışıyor olması gerekir.

4. Zamana duyarlı: İşlevleri 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.

5. 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 kontrol noktası süreci

Tek Geri Alma Kontrol Noktası: Tüm bileşenler 4.54.00 sürümüne yükseltildiğinde, Cassandra geri alma işlemi yalnızca en az bir Cassandra veri merkezi eski sürümü çalıştırmaya devam ederse mümkün olur. Son Cassandra veri merkezi de yükseltildikten sonra Edge for Private Cloud 4.54.00'a yükseltme işlemi tamamlanır ve geri alma işlemi artık mümkün olmaz.

Örnek

İki veri merkezli (DC) bir küme düşünün:

1. Başlangıç durumu: Her iki veri merkezindeki Cassandra düğümleri 4.0.X sürümündedir. Diğer tüm düğümler, Private Cloud için Edge 4.54.00 sürümündedir. Her veri merkezinde üç Cassandra düğümü olduğunu varsayalım.

2. DC-1'i yükseltme: DC-1'deki üç Cassandra düğümünü tek tek yükseltin.

3. Duraklatma ve doğrulama: Kümenin, özellikle de DC-1'in 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.

4. DC-2'yi yükseltme: DC-2'deki kalan üç Cassandra düğümünü yükseltin. DC-2'deki tüm Cassandra düğümleri başarıyla yükseltildikten sonra Edge for Private Cloud 4.54.00 yükseltmesi tamamlanır.

Cassandra yükseltmesi için ön koşullar

Private Cloud 4.53.00 (veya) 4.53.01 için Edge ile Cassandra 4.0.X'i çalıştırıyor olmanız ve aşağıdakileri sağlamanız gerekir:

1. Sunucuda varsayılan Java sürümü olarak Java 17'yi ayarlayın: Cassandra 5.0.X, Java 8 desteğini kaldırır. Cassandra 5.0.X'i veya nodetool yardımcı programını Java 8 ile çalıştıramazsınız. Her Cassandra düğümünde Java 17'nin yüklü olduğundan emin olun ve Cassandra yükseltme adımlarını çalıştırmadan önce Java 17'yi varsayılan Java sürümü olarak ayarlayın. Böylece nodetool komutları Java 17 ile yürütülür:

   alternatives --set java JAVA_17_PATH/bin/java

   Etkin varsayılan Java sürümünün Java 17 olduğunu doğrulayın:

   java -version

2. Kümenin tamamı çalışır durumda ve Cassandra 4.0.X ile tam olarak işlevseldir.

3. Sıkıştırma stratejisi LeveledCompactionStrategy olarak ayarlanır (4.53.00 veya 4.53.01 sürümüne yükseltme için ön koşul).

4. Aşağıdaki her adımın, Edge for Private Cloud 4.53.00 (veya) 4.53.01'de Cassandra 4.0.X'in ilk yükseltme işlemi kapsamında tamamlandığını onaylayın.

   • Önceki yükseltme sırasında her Cassandra düğümünde post_upgrade komutu yürütüldü

   • Önceki yükseltme sırasında tüm Cassandra kümesinde drop_old_tables komutu yürütüldü.

Edge for Private Cloud 4.53.00 (veya) 4.53.01'i kullanırken post_upgrade ve drop_old_tables komutlarının Cassandra 4.0.X'te yürütülüp yürütülmediğinden emin değilseniz 4.54.00'e yükseltme yapmadan önce bu komutları güvenle yeniden çalıştırabilirsiniz.

1. adım: Yükseltme için hazırlık yapı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.

1. Apigee'yi kullanarak Cassandra'yı yedekleme

2. Cassandra düğümlerinin sanal makine anlık görüntülerini alın (mümkünse).

3. Henüz yapılandırılmadıysa 9042 numaralı bağlantı noktasının, Yönetim Sunucusu, Mesaj İşlemcisi, Yönlendirici, Qpid ve Postgres dahil olmak üzere tüm Edge for Private Cloud bileşenlerinden Cassandra düğümlerine erişebildiğinden emin olun. Daha fazla bilgi için Bağlantı noktası koşulları'nı inceleyin.

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ükseltme işlemleri arasında birkaç dakika bekleyin. Böylece, aynı veri merkezindeki başka bir düğümü yükseltmeye devam etmeden önce, güncellenen düğümün tamamen başlatıldığından ve kümeye katıldığından emin olabilirsiniz.

Bir veri merkezindeki tüm Cassandra düğümlerini yükselttikten sonra, bir sonraki veri merkezindeki düğümlere geçmeden ö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şlev ve performans metriklerinin bozulmadığından emin olun. Bu adım, Cassandra'nın 5.0.X sürümüne, diğer Apigee bileşenlerinin ise 4.54.00 sürümüne yükseltildiği veri merkezinin kararlılığını sağlamak için çok önemlidir.

1. 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

2. 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

3. Yukarıdaki komutun çıktısı şuna benzer:

   Cassandra version is verified - [cqlsh 6.2.0 | Cassandra 5.0.8 | CQL spec 3.4.7 | Native protocol v5]
   Metadata is verified

4. 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

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

   /opt/apigee/apigee-service/bin/apigee-service apigee-cassandra cleanup_old_index

6. 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 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 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
/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 cache cache_entries cache_entries_cache_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

Para kazanma özelliğini kullanıyorsanız para kazanma anahtar alanlarıyla ilgili aşağıdaki dizinleri yeniden oluşturma 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

Apigee mTLS ile güncelleme

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

• Apigee mTLS'yi kaldırma .

• Apigee mTLS'yi yeniden yükleme

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.

Hata nedeniyle güncellemeyi önceki sürümünüze geri almanız gerekiyorsa ayrıntılı talimatlar için 4.54.00 sürümünü geri alma başlıklı makaleyi inceleyin.

Güncelleme bilgilerini günlüğe kaydetme

Varsayılan olarak update.sh yardımcı programı, günlük bilgilerini şuraya 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üğü /tmp dizinine update_username.log adlı bir dosya olarak yazar.

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

Sıfır kesinti süreli güncelleme

Sıfır kesinti süreli güncelleme veya periyodik güncelleme, Edge kurulumunuzu Edge'i kapatmadan güncellemenize olanak tanır.

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

Sıfır kesinti süreli yükseltmenin anahtarı, her bir yönlendiriciyi yük dengeleyiciden tek tek kaldırmaktır. Ardından, yönlendiriciyi ve yönlendiriciyle aynı makinedeki diğer bileşenleri günceller ve yönlendiriciyi tekrar yük dengeleyiciye eklersiniz.

1. Makineleri, Makine güncelleme sırası bölümünde açıklandığı şekilde kurulumunuz için doğru sırada güncelleyin .

2. Yönlendiricileri güncelleme zamanı geldiğinde, Sunucu (Mesaj İşlemcisi/Yönlendirici) erişilebilirliğini etkinleştirme/devre dışı bırakma bölümünde açıklandığı gibi herhangi bir yönlendiriciyi seçin ve erişilemez hale getirin .

3. Seçilen 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şlemcisi gösterir.

4. Yönlendiriciyi tekrar erişilebilir hale getirin.

5. Kalan yönlendiriciler için 2-4 arasındaki adımları tekrarlayın.

6. Kurulumunuzdaki diğer makineler için güncellemeye devam edin.

Güncellemeden önce ve sonra aşağıdakileri yapın:

• Birleşik Yönlendirici ve Mesaj İşleyici düğümünde:

  • Güncellemeden önce aşağıdakileri yapın:

    1. Yönlendiriciyi erişilemez hale getirin.

    2. Mesaj İşleyici'yi erişilemez hale getirin.

  • Güncellemeden sonra aşağıdaki işlemleri yapın:

    1. Mesaj İşleyici'yi erişilebilir hale getirin.

    2. Yönlendiriciyi erişilebilir hale getirme

• Tek yönlendirici düğümlerinde:

  • Güncellemeden önce yönlendiriciyi erişilemez hale getirin.

  • Güncellemeden sonra yönlendiriciyi erişilebilir hale getirin.

• Tekli Mesaj İşleyici düğümlerinde:

  • Güncellemeden önce Mesaj İşleyici'yi erişilemez hale getirin.

  • Güncellemeden sonra Mesaj İşleyici'yi erişilebilir hale getirin.

Sessiz yapılandırma dosyası kullanma

Güncelleme komutuna bir sessiz yapılandırma dosyası iletmeniz gerekir. Sessiz yapılandırma dosyası, Edge for Private Cloud 4.53.00 veya 4.53.01'i yüklemek için kullandığınız dosyaya büyük ölçüde benzer olsa da Yeni Edge kullanıcı arayüzüne ve Apigee TOA'ya (Yüklüyse) yükseltme bölümünde açıklandığı gibi kullanıcı arayüzü ve TOA gibi bileşenlerde değişiklik yapmanız gerekebilir.

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

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

1. Varsa Cassandra'da onarım işlemi gerçekleştirmek üzere yapılandırılmış cron işlerini güncelleme tamamlanana kadar devre dışı bırakın.

2. Edge RPM'lerini yüklemek için düğümünüze kök olarak giriş yapın.

   Not: RPM yüklemesi için kök erişimi gerekir ancak Edge yapılandırmasını kök erişimi olmadan gerçekleştirebilirsiniz.

3. Edge apigee-setup yardımcı programını yükleme bölümünde açıklandığı şekilde SELinux'u devre dışı bırakın .

4. AWS'ye yüklüyorsanız aşağıdaki yum-configure-manager komutlarını çalıştırın:

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

5. Şu anda Edge for Private Cloud 4.53.00 (veya) 4.53.01 sürümünü kullanıyorsanız:

   1. Edge bootstrap_4.54.00.sh dosyasını /tmp/bootstrap_4.54.00.sh dizinine indirin :

      curl https://software.apigee.com/bootstrap_4.54.00.sh -o /tmp/bootstrap_4.54.00.sh

   2. Aşağıdaki komutu çalıştırarak Edge 4.54.00 apigee-service yardımcı programını ve bağımlılıklarını yükleyin:

      bash /tmp/bootstrap_4.54.00.sh apigeeuser=uName apigeepassword=pWord

      uName:pWord, Apigee'den aldığınız kullanıcı adı ve şifredir. pWord parametresini atlarsanız bu parametreyi girmeniz istenir.

      Yükleyici, varsayılan olarak Java 17 ve 21'in yüklü olup olmadığını kontrol eder.

   3. Aşağıdaki örnekte gösterildiği gibi apigee-setup yardımcı programını güncellemek için apigee-service komutunu 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 şunları içerir:

        • edge : Yeni Edge kullanıcı arayüzü hariç tüm Edge bileşenleri: Yönetim Sunucusu, Mesaj İşlemcisi, Yönlendirici, QPID Sunucusu, Postgres Sunucusu

        • ldap : OpenLDAP

        • ue : Yeni Edge kullanıcı arayüzü

        • qpid : Apigee Qpid

        • ps : Apigee PostgreSQL

        • zk : ZooKeeper

        • cs : Cassandra

      • configFile, 4.53.00 (veya) 4.53.01 yüklemesi sırasında Edge bileşenlerinizi tanımlamak için kullandığınız yapılandırma dosyasıdır.

      Yalnızca Edge hepsi bir arada (AIO) yükleme profiliniz varsa component değerini "all" olarak ayarlayarak update.sh komutunu tüm bileşenlerde çalıştırabilirsiniz. Örneğin:

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

   7. Henüz yapmadıysanız yeni 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 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.54.00 sürümünü geri alma bölümünde açıklanan prosedürü kullanın.

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

Edge düğümleriniz bir güvenlik duvarının arkasındaysa veya başka bir şekilde Apigee deposuna internet üzerinden erişmesi yasaklanmışsa güncellemeyi Apigee deposunun yerel bir deposundan veya 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 depoya sahip 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.54.00 deposundan güncelleme yapmak için:

1. Edge apigee-setup yardımcı programını yükleme bölümündeki "Yerel Apigee deposu oluşturma" bölümünde açıklandığı şekilde yerel bir 4.54.00 deposu oluşturun.

2. Aşağıdaki yöntemlerden birini kullanarak hedef düğümlere apigee-service yükleyin:

   • 1. seçenek: apigee-service'i bir .tar dosyasından yükleme

     1. Yerel depoya sahip düğümde, yerel depoyu /opt/apigee/data/apigee-mirror/apigee-4.54.00.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.54.00.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:

        bash /tmp/repos/bootstrap_4.54.00.sh apigeeprotocol="file://" apigeerepobasepath=/tmp/repos

        Bu komutta, depolar dizininin yolunu eklediğinize dikkat edin.

   • 2. seçenek: Nginx web sunucusunu kullanarak apigee-service'i yükleme

     1. Nginx web sunucusunu, Edge apigee-setup yardımcı programını yükleme bölümündeki "Nginx web sunucusunu kullanarak depodan yükleme" bölümünde açıklandığı şekilde yapılandırın.

     2. Uzak düğümde, Edge bootstrap_4.54.00.sh dosyasını /tmp/bootstrap_4.54.00.sh dizinine indirin:

        /usr/bin/curl http://uName:pWord@remoteRepo:3939/bootstrap_4.54.00.sh -o /tmp/bootstrap_4.54.00.sh

        uName:pWord, depo için daha önce 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-service yardımcı programını ve bağımlılıklarını yükleyin:

        bash /tmp/bootstrap_4.54.00.sh apigeerepohost=remoteRepo:3939 apigeeuser=uName apigeepassword=pWord apigeeprotocol=http://

        uName:pWord, depo kullanıcı adı ve şifresidir.

3. Aşağıdaki örnekte gösterildiği gibi apigee-setup yardımcı programını güncellemek için apigee-service komutunu 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. Düğümlerinizde update yardımcı programını Makine güncelleme sırası bölümünde açıklanan sırayla çalıştırın:

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

   Burada:

   • component, güncellenecek Edge bileşenidir. Olası değerler şunları içerir:

     • edge : Yeni Edge kullanıcı arayüzü hariç tüm Edge bileşenleri: Yönetim Sunucusu, Mesaj İşlemcisi, Yönlendirici, QPID Sunucusu, Postgres Sunucusu

     • ldap : OpenLDAP

     • ue : Yeni Edge kullanıcı arayüzü

     • qpid : Apigee Qpid

     • ps : Apigee PostgreSQL

     • zk : ZooKeeper

     • cs : Cassandra

   • configFile, 4.53.00 (veya) 4.53.01 yüklemesi sırasında Edge bileşenlerinizi tanımlamak için kullandığınız yapılandırma dosyası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

   Yalnızca Edge hepsi bir arada (AIO) yükleme profiliniz varsa component değerini "all" olarak ayarlayarak update.sh komutunu tüm bileşenlerde çalıştırabilirsiniz. Örneğin:

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

7. Henüz yapmadıysanız kullanıcı arayüzü bileşenlerini çalıştıran tüm düğümlerde bu bileşenleri yeniden başlatın:

   /opt/apigee/apigee-service/bin/apigee-service edge-management-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.54.00 sürümünü geri alma bölümünde açıklanan prosedürü uygulayın.

Makine güncelleme sırası

Edge kurulumunda makineleri güncelleme sıranız önemlidir. Bileşenlerinizi aşağıdaki sırayla yükseltin.

1. -c edge seçeneğini kullanarak tüm veri merkezlerindeki tüm yönlendirici ve mesaj işleyici düğümlerini yükseltin.

2. -c edge seçeneğini kullanarak tüm veri merkezlerindeki tüm Yönetim Sunucusu düğümlerini yükseltin.

3. Tüm veri merkezlerindeki tüm LDAP düğümlerini yükseltin. Edge for Private Cloud 4.53.00'dan yükseltme yapıyorsanız LDAP yükseltmesinin özel adımları için ek adımları uygulamanız gerekir.

4. Tüm veri merkezlerinde kullanıcı arayüzünü ve Apigee TOA'yı (yüklüyse) yükseltin:

   1. apigee-sso yüklü değilse: Yeni Edge kullanıcı arayüzüne yükseltmek için 1. Seçenek: Kullanıcı arayüzünü yükseltme (Apigee TOA olmadan) bölümündeki adımları uygulayın.

   2. apigee-sso yüklüyse: Yeni Edge kullanıcı arayüzüne ve Apigee TOA'ya yükseltmek için 2. Seçenek: Kullanıcı arayüzünü yükseltme (Apigee TOA ile) bölümündeki adımları uygulayın.

5. Qpid'nin özel adımlarını uygulayarak tüm veri merkezlerindeki tüm Qpid ve edge-qpid-server bileşenlerini yükseltin.

6. Postgres'in özel adımlarını uygulayarak tüm veri merkezlerindeki tüm Postgresql ve edge-postgres-server bileşenlerini yükseltin.

7. Zookeeper yükseltmesinin özel adımlarını uygulayarak tüm veri merkezlerindeki tüm Zookeeper bileşenlerini yükseltin.

8. Cassandra yükseltme işleminin özel adımlarını uygulayarak tüm veri merkezlerindeki tüm Cassandra bileşenlerini yükseltin.

9. Para kazanma özelliğini güncellemek için ayrı bir adım yoktur. -c edge 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.54.00 sürümüne yükseltmek için:

Edge for Private Cloud 4.53.00'dan yükseltme yaparken tüm bileşenlerin yükseltme işlemine başlamadan önce 4.53.00'dan 4.54.00'a yükseltme adımlarını uygulayarak LDAP'yi yükseltmeniz gerekir.

1. Tüm bileşenleri güncelleme:

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

2. (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 başlıklı makaleyi inceleyin.

1. 1. makinedeki Edge bileşenlerini güncelleyin:

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

2. 1. makinede LDAP'yi güncelleme:

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

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

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

4. 2. makinedeki Edge bileşenlerini güncelleyin:

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

5. 2. makinede Qpid'yi güncelleme:

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

6. 2. makinede Postgres'i güncelleyin:

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

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

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

8. (apigee-adminapi yüklediyseniz) 1. makinede apigee-adminapi yardımcı programını güncelleyin:

   /opt/apigee/apigee-service/bin/apigee-service apigee-adminapi update

5 düğümlü yükseltme

5 düğümlü 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 başlıklı makaleyi inceleyin.

1. 2, 3, 1 numaralı makinelerdeki Edge bileşenlerini güncelleyin:

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

2. 1. makinede LDAP'yi güncelleme:

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

3. 1. makinede yeni Edge kullanıcı arayüzünü güncelleme:

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

4. 4 ve 5 numaralı makinelerdeki Edge bileşenlerini güncelleyin:

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

5. 4 ve 5 numaralı makinelerde Qpid'yi güncelleyin:

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

6. 4 ve 5 numaralı makinelerde Postgres'i güncelleyin:

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

7. 1, 2 ve 3 numaralı makinelerde Cassandra ve ZooKeeper'ı güncelleyin:

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

8. (apigee-adminapi yüklediyseniz) 1. makinede apigee-adminapi yardımcı programını güncelleyin:

   /opt/apigee/apigee-service/bin/apigee-service apigee-adminapi update

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

9 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 başlıklı makaleyi inceleyin.

1. 4, 5 ve 1 numaralı makinelerdeki (yönlendirici, mesaj işleyici ve yönetim sunucusu) Edge bileşenlerini şu sırayla güncelleyin:

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

2. 1. makinede LDAP'yi güncelleme:

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

3. 1. makinede yeni Edge kullanıcı arayüzünü güncelleme:

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

4. 6, 7, 8 ve 9 numaralı makinelerdeki Edge bileşenlerini sırayla güncelleyin:

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

5. 6 ve 7 numaralı makinelerde Qpid'yi güncelleyin:

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

6. 8. makinede Postgres'i güncelleyin:

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

7. 9 numaralı makinede Postgres'i güncelleyin:

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

8. 1, 2 ve 3 numaralı makinelerde Cassandra ve ZooKeeper'ı güncelleyin:

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

9. (apigee-adminapi yüklediyseniz) 1. makinede apigee-adminapi yardımcı programını güncelleyin:

   /opt/apigee/apigee-service/bin/apigee-service apigee-adminapi update

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 başlıklı makaleyi inceleyin.

1. 10, 11, 6 ve 7 numaralı makinelerdeki Edge bileşenlerini şu sırayla güncelleyin:

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

2. 4 ve 5 numaralı makinelerde LDAP'yi güncelleyin:

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

3. 6 ve 7 numaralı makinelerde yeni Edge kullanıcı arayüzünü güncelleme:

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

4. 12, 13, 8 ve 9 numaralı makinelerdeki Edge bileşenlerini şu sırayla güncelleyin:

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

5. 12 ve 13 numaralı makinelerde Qpid'yi güncelleyin:

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

6. 8. makinede Postgres'i güncelleyin:

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

7. 9 numaralı makinede Postgres'i güncelleyin:

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

8. 1, 2 ve 3 numaralı makinelerde Cassandra ve ZooKeeper'ı güncelleyin:

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

9. (apigee-adminapi yüklediyseniz) 6 ve 7 numaralı makinelerde apigee-adminapi yardımcı programını güncelleyin:

   /opt/apigee/apigee-service/bin/apigee-service apigee-adminapi update

12 düğümlü küme yükseltmesi

12 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 başlıklı makaleyi inceleyin.

1. Edge (Yönlendirici ve Mesaj İşlemcisi) bileşenlerini güncelleme:

   • Veri Merkezi 1'deki 2 ve 3 numaralı makinelerde:

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

   • Veri Merkezi 2'deki 8 ve 9 numaralı makinelerde:

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

2. Edge (Yönetim Sunucusu) bileşenlerini güncelleme:

   • Veri Merkezi 1'deki 1. makinede:

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

   • Veri Merkezi 2'deki 7 numaralı makinede:

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

3. LDAP'yi güncelleme:

   • 1. Veri Merkezi'ndeki 1. Makine:

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

   • 2. veri merkezindeki 7. makine:

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

4. Yeni Edge kullanıcı arayüzü bileşenlerini güncelleme:

   • Veri Merkezi 1'deki 1. makinede:

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

   • Veri Merkezi 2'deki 7 numaralı makinede:

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

5. Edge bileşenlerini güncelleme:

   • 1 numaralı veri merkezindeki 4, 5 ve 6 numaralı makineler:

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

   • Veri Merkezi 2'deki 10, 11, 12 numaralı makineler:

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

6. qpidd'yi güncelleme:

   • Veri Merkezi 1'deki 4 ve 5 numaralı makineler:

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

   • Veri Merkezi 2'deki 10 ve 11 numaralı makineler:

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

7. Postgres'i güncelleme:

   • Veri Merkezi 1'deki 6. makine:

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

   • 2. veri merkezindeki 12. makine:

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

8. Cassandra ve ZooKeeper'ı güncelleyin:

   • Veri merkezi 1'deki 1, 2 ve 3 numaralı makineler:

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

   • Veri Merkezi 2'deki 7, 8 ve 9 numaralı makinelerde:

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

9. (apigee-adminapi yüklediyseniz) apigee-adminapi yardımcı programını güncelleyin:

   • 1. Veri Merkezi'ndeki 1. Makine:

     /opt/apigee/apigee-service/bin/apigee-service apigee-adminapi update

   • 2. veri merkezindeki 7. makine:

     /opt/apigee/apigee-service/bin/apigee-service apigee-adminapi update

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:

1. Yönlendirici

2. Mesaj İşleyici

3. Yönetim Sunucusu

4. LDAP

5. Kullanıcı arayüzü (klasik kullanıcı arayüzü veya yeni kullanıcı arayüzü)

6. TOA (varsa)

7. Qpid ve edge-qpid-server

8. Postgres ve edge-postgres-server

9. ZooKeeper

10. Cassandra

11. apigee-adminapi