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şiyle aynı olmalı veya root olarak çalışan bir kişi 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: Yükseltme işleminden önce hazırlık yapılması gereken TLS ve Java Callout değişikliklerini 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.

• Bootstrap 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: Kimlik doğrulama için güncellenen TOA mimarisini ve yapılandırma değişikliklerini öğrenin. Daha fazla bilgi için Apigee SSO (Apigee TOA) başlıklı makaleyi inceleyin.

• 4.54.00 sürümünde Nginx 1.30: Edge yönlendiricilerde otomatik Nginx 1.30.x yükseltmesini, olası çalışma zamanı etkilerini 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 işlemine başlamadan önce Private Cloud için Edge 4.54.00 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 olarak çalışmaya devam etmesi için Java 8'i Java 17 ve Java 21 ile birlikte 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'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önlendiriciyi ve Mesaj İşleyiciyi Yükseltme

Veri merkezlerindeki 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

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, tek sunuculu, etkin-pasif ve etkin-etkin (çoklu ana) olmak üzere tüm Apigee OpenLDAP dağıtım topolojileri için geçerlidir.

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ükseltme

Bu yöntem, Edge çalışma zamanı ortamınızda kapalı kalma süresi 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üğümdeki 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. Mevcut mesajları (varsa) 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'i 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 İşleyici IP adreslerinden 5672 numaralı bağlantı noktasındaki Qpid düğümüne gelen istekler kabul edilir. Güvenlik duvarını eklemek için iptables komutunu 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-yedekli çoğaltma 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ü devre dışı bırakabilirsiniz. Güncellemeyi herhangi bir nedenle geri almanız gerekirse ek Postgres bekleme düğümü gerekir. Güncellemeyi geri almanız gerekirse geri alma işleminden sonra yeni Postgres bekleme düğümü, 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'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 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 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 bekleme 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. 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.

   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ıları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 aracını 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ırın :

   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 yedek ana makinede /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 eklendi .

    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'den 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 düğümünde apigee-postgresql'i 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ünde ZooKeeper 3.8.5'e yükseltme yapılmıştır. 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ç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. Seçmen düğümleri bir lider seçer ve ardından seçmen düğümleri 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, yükseltme işlemi her düğümün yedeğini almayı 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 gerekmesi ihtimaline karşı 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 makineler kullanıyorsanız ve bu özelliğe 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

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. 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.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. Update to 4.54.00 on a node with an external internet connection (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 bootstrap'ini 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. Yukarıdaki adımları her ZooKeeper gözlemci ve takipçi düğümünde 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 yöneticisi

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, kademeli bir işlemdir.

• Cassandra 5.0.X'ten 4.0.X'e doğrudan yerinde geri alma işlemi yapılamaz. Kopyaları veya yedekleri kullanarak geri alma işlemi karmaşıktır ve hizmet kesintisi ve/veya veri kaybı içerebilir. 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ı 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 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ı olmadan veya API trafiğinizde kesinti yaşanmadan 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 isteniyorsa Cassandra 4.0.X'i geri yüklemek için yedekler gerekir. Ancak bu yöntemde hem hizmet kesintisi hem de veri kaybı yaşanma ihtimali yüksektir.

Birden fazla 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. Her seferinde bir Cassandra veri merkezini yükseltin: Tek bir veri merkezi içindeki Cassandra düğümlerini ayrı ayrı 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, yalnızca en az bir Cassandra veri merkezi eski sürümü çalıştırmaya devam ederse Cassandra geri alma işlemi yapılabilir. 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 DC'deki 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ükseltin: 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ünü Java 17 olarak ayarlayın: Cassandra 5.0.X, Java 8 desteğini kaldırır. Cassandra 5.0.X 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 durumdadır 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 drop_old_tables komutu tüm Cassandra kümesinde yürütülmüştür.

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üğü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ş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 komut, aşağıdakine benzer bir çıktı verir:

   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 yeniden oluşturma dizinleri 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.

Kapalı kalma süresi olmadan 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 kesinti süresiyle güncelleme yalnızca 5 düğümlü ve daha büyük bir yapılandırmada 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. Makine güncelleme sırası bölümünde açıklandığı gibi, kurulumunuz için makineleri 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önlendiriciye 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ğıdakilere dikkat edin:

• 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 şunları 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ükleme yapı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 bunları çalıştıran tüm düğümlerde Yeni Edge kullanıcı arayüzü bileşenlerini 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. Install the Edge apigee-setup utility (Edge apigee-setup yardımcı programını yükleme) bölümündeki "Create a local Apigee repository" (Yerel bir Apigee deposu oluşturma) başlıklı makalede 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 çıkarı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 konumuna indirin:

        /usr/bin/curl http://uName:pWord@remoteRepo:3939/bootstrap_4.54.00.sh -o /tmp/bootstrap_4.54.00.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üğüme 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. update yardımcı programını, Makine güncelleme sırası bölümünde açıklanan sırayla düğümlerinizde ç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 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

   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 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. 2, 3 ve 1 numaralı makinelerde Edge bileşenlerini güncelleyin:

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

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

   /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. 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. makinede 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ı makaleye bakın.

1. 4, 5 ve 1 numaralı makinelerdeki (yönlendirici, mesaj işlemcisi 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 numaralı 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ı makinelerde Edge bileşenlerini bu 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 numaralı 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. 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üncelleyin:

   • Veri Merkezi 1'deki 4. ve 5. 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

   • Veri Merkezi 2'deki 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