Apigee Edge 4.52.02'yi 4.53.00 sürümüne güncelleme

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

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

Güncellemeyi kimler yapabilir?

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

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

Hangi bileşenleri güncellemeniz gerekir?

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

Güncelleme ön koşulları

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

• Tüm düğümleri yedekleyin
  Güncelleme yapmadan önce güvenlik nedeniyle tüm düğümlerin tam yedeğini almanızı öneririz. Yedekleme işlemini gerçekleştirmek için Edge'in mevcut sürümüne yönelik prosedürü kullanın.

  Bu sayede, yeni sürüme güncelleme düzgün çalışmazsa yedek bir planınız olur. Yedekleme hakkında daha fazla bilgi için Yedekleme ve Geri Yükleme başlıklı makaleyi inceleyin.

• Edge'in çalıştığından emin olun
  Güncelleme işlemi sırasında Edge'in çalıştığından emin olmak için şu komutu kullanın:

  /opt/apigee/apigee-service/bin/apigee-all status

• Cassandra ön koşullarını doğrulama
  

  Daha önce Edge for Private Cloud'un eski bir sürümünden 4.52.02 sürümüne yükselttiyseniz ve şimdi 4.53.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.52.02 sürümüne yükseltme dokümanında özetlenmiş ve Cassandra yükseltmesi için ön koşullar bölümünde de belirtilmiştir. Bu adımların önceki yükseltme sırasında tamamlanıp tamamlanmadığından emin değilseniz 4.53.00 sürümüne yükseltme işlemine devam etmeden önce bu adımları tekrar tamamlayın.

• Edge for Private Cloud 4.53.00'da IdP anahtarlarını ve sertifikalarını yapılandırma
  

  Edge for Private Cloud 4.53.00'da, apigee-sso bileşeninde kullanılan IdP anahtarları ve sertifikaları artık bir anahtar deposu aracılığıyla yapılandırılıyor. Daha önce kullandığınız anahtarı ve sertifikayı bir anahtar deposuna aktarmanız gerekir. TOA bileşenini güncellemeden önce ayrıntılı adımlar için Apigee TOA'yı eski sürümlerden güncelleme adımları bölümündeki adımları uygulayın.

• Python gereksinimleri
  Yükseltme işlemine başlamadan önce Cassandra düğümleri de dahil olmak üzere tüm düğümlerde Python 3'ün yüklü olduğundan emin olun.

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

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

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

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

1. Sınır yönlendirici düğümünde en son 4.53.00 yazılımının yüklü olduğundan emin olun.

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

2. Şu anda çalıştırdığınız Nginx sürümünü kontrol etme ve doğrulama

   /opt/nginx/sbin/nginx -V

   Nginx'in eski bir sürümünü kullanıyorsanız Nginx'i yönlendirici düğümünde 1.26.X sürümüne yükseltmek için aşağıdaki adımları uygulayabilirsiniz.

3. Yönlendirici düğümünde uç yönlendirici işlemini durdurma

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

4. Yönlendirici düğümünde nginx yazılımını yükseltme

   dnf update apigee-nginx

5. Nginx sürümünün güncellendiğini doğrulayın.

   /opt/nginx/sbin/nginx -V

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

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

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

Cassandra 4.0.13'e yükseltme zorunluluğu

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

Yükseltmeler ve geri alma

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

Tek veri merkezi

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

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

Birden fazla veri merkezi

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

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

Önerilen yükseltme metodolojisi

1. Her seferinde bir Cassandra veri merkezini yükseltin: Tek bir veri merkezindeki Cassandra düğümlerini ayrı ayrı yükselterek başlayın. Bir sonraki veri merkezine geçmeden önce bir veri merkezindeki tüm Cassandra düğümlerinin yükseltmelerini tamamlayın.
2. Duraklatma ve doğrulama: Bir veri merkezini yükselttikten sonra, özellikle yükseltilen veri merkezi olmak üzere özel bulut kümenizin doğru şekilde çalıştığından emin olmak için duraklatın.
3. Unutmayın: Yalnızca eski sürümü çalıştıran en az bir veri merkeziniz varsa önceki Cassandra sürümüne geri dönebilirsiniz.
4. Zamandan bağımsız: İşlevselliği doğrulamak için kısa bir süre (birkaç saat önerilir) duraklatabilirsiniz ancak süresiz olarak karma sürüm durumunda kalamazsınız. Bunun nedeni, tek tip olmayan bir Cassandra kümesinin (farklı sürümlerdeki düğümlerle) operasyonel sınırlamaları olmasıdır.
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 işlemi iki kontrol noktasıyla yapılır.

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

Örnek

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

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

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

1. Kümenin tamamı çalışır durumdadır ve Cassandra 3.11.16 ile tam işlevselliktedir.
2. Sıkıştırma stratejisi, LeveledCompactionStrategy olarak ayarlanır (4.52.02 sürümüne yükseltme için ön koşuldur).
3. 4.52.02 sürümündeki Private Cloud için Edge'de Cassandra 3.11'in ilk yükseltmesi kapsamında aşağıdaki adımların tamamının uygulandığından emin olun:
   • post_upgrade komutu, önceki yükseltme sırasında her Cassandra düğümünde yürütülmüş olmalıdır.
   • drop_old_tables komutu, önceki yükseltme sırasında tüm Cassandra kümesinde yürütülmüş olmalıdır.

Önceki adımların tamamlanıp tamamlanmadığından emin değilseniz bunları güvenli bir şekilde tekrar çalıştırabilirsiniz. 4.53.00 sürümüne yükseltme denenmeden önce, Edge for Private Cloud 4.52.02 sürümünü kullanırken bu adımların Cassandra 3.11'de yürütüldüğünden emin olun:

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

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

2. Eski ve kullanılmayan tabloları Cassandra kümesinden silmek için aşağıdaki komutu çalıştırın. Bu komut yalnızca kümedeki 1 düğümde çalıştırılmalıdır:

   /opt/apigee/apigee-service/bin/apigee-service apigee-cassandra drop_old_tables -f configFile

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

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

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

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

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

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

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.0.0 | Cassandra 4.0.13 | CQL spec 3.4.5 | 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 dizinleri yeniden oluşturmak için aşağıdaki nodetool komutlarını çalıştırın:

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

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

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

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

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

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

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

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

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

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

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

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

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

1. IDP'yi yapılandırmak için kullanılan mevcut anahtarı ve sertifikayı belirleyin:

   1. TOA yükleme yapılandırma dosyasında SSO_SAML_SERVICE_PROVIDER_CERTIFICATE değerini arayarak veya apigee-sso bileşenine conf_login_service_provider_certificate için sorgu göndererek sertifikayı alın.

      Kimlik sağlayıcı sertifika yolunu apigee-sso için sorgulamak üzere TOA düğümünde aşağıdaki komutu kullanın. Çıkışta, son satırdaki değeri bulun.

      apigee-service apigee-sso configure -search conf_login_service_provider_certificate

   2. TOA yükleme yapılandırma dosyasında SSO_SAML_SERVICE_PROVIDER_KEY değerini arayarak veya apigee-sso bileşenine conf_login_service_provider_key için sorgu göndererek anahtarı alın.

      Kimlik sağlayıcı anahtar yolu için apigee-sso sorgulamak üzere TOA düğümünde aşağıdaki komutu kullanın. Çıkışta son satırdaki değeri bulun.

      apigee-service apigee-sso configure -search conf_login_service_provider_key

2. Anahtarı ve sertifikayı anahtar deposuna aktarın:
   1. Anahtarı ve sertifikayı bir PKCS12 anahtar deposuna aktarın:

      sudo openssl pkcs12 -export -clcerts -in <certificate_path> -inkey <key_path> -out <keystore_path> -name <alias>

      Parametreler:

      • certificate_path: 1.adımın a bölümünde alınan sertifika dosyasının yolu.
      • key_path: 1.adımın b bölümünde alınan özel anahtar dosyasının yolu.
      • keystore_path: Sertifika ve özel anahtarı içeren yeni oluşturulan anahtar deposunun yolu.
      • alias: Anahtar deposundaki anahtar ve sertifika çifti için kullanılan takma ad.

      Daha fazla bilgi için OpenSSL belgelerine bakın.

   2. (İsteğe bağlı) Anahtarı ve sertifikayı PKCS12'den JKS anahtar deposuna aktarın:

      sudo keytool -importkeystore -srckeystore <PKCS12_keystore_path> -srcstoretype PKCS12 -destkeystore <destination_keystore_path> -deststoretype JKS -alias <alias>

      Parametreler:

      • PKCS12_keystore_path: Sertifika ve anahtarı içeren, 2.adımın a bölümünde oluşturulan PKCS12 anahtar deposunun yolu.
      • destination_keystore_path: Sertifikanın ve anahtarın dışa aktarılacağı yeni JKS anahtar deposunun yolu.
      • alias: JKS anahtar deposundaki anahtar ve sertifika çifti için kullanılan takma ad.

   Daha fazla bilgi için keytool belgelerine bakın.

3. Çıkış anahtar deposu dosyasının sahibini "apigee" kullanıcısı olarak değiştirin:

   sudo chown apigee:apigee <keystore_file>

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

   # Path to the keystore file
   SSO_SAML_SERVICE_PROVIDER_KEYSTORE_PATH=${APIGEE_ROOT}/apigee-sso/source/conf/keystore.jks
   
   # Keystore password
   SSO_SAML_SERVICE_PROVIDER_KEYSTORE_PASSWORD=Secret123  # Password for accessing the keystore
   
   # Keystore type
   SSO_SAML_SERVICE_PROVIDER_KEYSTORE_TYPE=JKS  # Type of keystore, e.g., JKS, PKCS12
   
   # Alias within keystore that stores the key and certificate
   SSO_SAML_SERVICE_PROVIDER_KEYSTORE_ALIAS=service-provider-cert 

5. Aşağıdaki komutu kullanarak TOA düğümündeki Apigee TOA yazılımını her zamanki gibi güncelleyin:

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

Yeni Edge kullanıcı arayüzü

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

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

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

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

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

Apigee mTLS ile güncelleme

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

• Apigee mTLS'yi kaldırın.
• Apigee mTLS'yi yeniden yükleyin.

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üme geri döndürmeniz gerekiyorsa ayrıntılı talimatlar için 4.53.00 sürümünü geri döndürme başlıklı makaleyi inceleyin.

Günlük kaydı güncelleme bilgileri

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

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

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

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

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

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

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

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

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

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

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

Sessiz yapılandırma dosyası kullanma

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

Harici internet bağlantısı olan bir düğümde 4.53.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 güncelleme tamamlanana kadar Cassandra'da onarım işlemi yapacak şekilde yapılandırılmış tüm cron işlerini devre dışı bırakın.
2. Edge RPM'lerini yüklemek için düğümünüze root olarak giriş yapın.
3. 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.
4. AWS'ye yükleme yapıyorsanız aşağıdaki yum-configure-managerkomutları yürütün:

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

5. Şu anda Edge 4.52.02 sürümünü kullanıyorsanız:

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

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

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

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

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

      Yükleyici, varsayılan olarak Java 1.8'in yüklü olup olmadığını kontrol eder. Aksi takdirde yükleyici, bu bileşeni sizin için yükler.

      Java yüklemesinin nasıl ele alınacağını belirtmek için JAVA_FIX seçeneğini kullanın. JAVA_FIX aşağıdaki değerleri alır:

      • I: OpenJDK 1.8'i (varsayılan) yükleyin.
      • C: Java'yı yüklemeden devam edin.
      • Q: Çıkış. Bu seçeneği kullanmak için Java'yı kendiniz yüklemeniz gerekir.
   3. Aşağıdaki örnekte gösterildiği gibi apigee-setup yardımcı programını güncellemek için apigee-service kullanın:

      /opt/apigee/apigee-service/bin/apigee-service apigee-setup update

   4. Yönetim sunucusundaki apigee-validate yardımcı programını aşağıdaki örnekte gösterildiği gibi güncelleyin:

      /opt/apigee/apigee-service/bin/apigee-service apigee-validate update

   5. Yönetim sunucusundaki apigee-provision yardımcı programını aşağıdaki örnekte gösterildiği gibi güncelleyin:

      /opt/apigee/apigee-service/bin/apigee-service apigee-provision update

   6. Aşağıdaki komutu çalıştırarak düğümlerinizde update yardımcı programını çalıştırın:

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

      Bu işlemi Makine güncelleme sırası bölümünde açıklanan sırayla yapın.

      Burada:

      • component, güncellenecek Edge bileşenidir. Olası değerler şunlardır:
        • cs: Cassandra
        • edge: Edge kullanıcı arayüzü hariç tüm Edge bileşenleri: Yönetim Sunucusu, Mesaj İşleyici, Yönlendirici, QPID Sunucusu, Postgres Sunucusu
        • ldap: OpenLDAP
        • ps: postgresql
        • qpid: qpidd
        • sso: Apigee TOA (TOA'yı yüklediyseniz)
        • ue: Yeni Edge kullanıcı arayüzü
        • ui: Klasik Edge kullanıcı arayüzü
        • zk: Zookeeper
      • configFile, 4.52.02 kurulumu sırasında Edge bileşenlerinizi tanımlamak için kullandığınız yapılandırma dosyasıyla aynıdır.

      update.sh değerini "all" olarak ayarlayarak component değerini tüm bileşenlere karşı çalıştırabilirsiniz ancak bu yalnızca Edge all-in-one (AIO) yükleme profiliniz varsa mümkündür. Örneğin:

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

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

      /opt/apigee/apigee-service/bin/apigee-service [edge-management-ui|edge-ui] restart

   8. Yüklemeyi test etme bölümünde açıklandığı gibi, Yönetim Sunucusu'nda apigee-validate yardımcı programını çalıştırarak güncellemeyi test edin.

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

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

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

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

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

Yerel bir 4.53.00 deposundan güncellemek için:

1. Install the Edge apigee-setup utility bölümündeki "Yerel bir Apigee deposu oluşturma" başlıklı makalede açıklandığı şekilde yerel bir 4.53.00 deposu oluşturun.
2. apigee-service'i bir .tar dosyasından yüklemek için:
   1. Yerel depoya sahip düğümde, yerel depoyu /opt/apigee/data/apigee-mirror/apigee-4.53.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.53.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:

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

      Bu komuta, repos dizininin yolunu eklediğinizi unutmayın.

3. Nginx web sunucusunu kullanarak apigee-service'i yüklemek için:
   1. Nginx web sunucusunu, Install the Edge apigee-setup utility (Edge apigee-setup yardımcı programını yükleme) bölümündeki "Install from the repo using the Nginx webserver" (Nginx web sunucusunu kullanarak depodan yükleme) başlıklı makalede açıklandığı şekilde yapılandırın.
   2. Uzak düğümde, Edge bootstrap_4.53.00.sh dosyasını /tmp/bootstrap_4.53.00.sh konumuna indirin:

      /usr/bin/curl http://uName:pWord@remoteRepo:3939/bootstrap_4.53.00.sh -o /tmp/bootstrap_4.53.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üğümde Edge apigee-setup yardımcı programını ve bağımlılıklarını yükleyin:

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

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

4. Aşağıdaki örnekte gösterildiği gibi apigee-setup yardımcı programını güncellemek için apigee-service kullanın:

   /opt/apigee/apigee-service/bin/apigee-service apigee-setup update 

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

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

7. Makine güncelleme sırası bölümünde açıklanan sırayla düğümlerinizde update yardımcı programını çalıştırın:

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

   Burada:

   • component, güncellenecek Edge bileşenidir. Genellikle aşağıdaki bileşenleri güncellersiniz:
     • cs: Cassandra
     • edge: Edge kullanıcı arayüzü hariç tüm Edge bileşenleri: Yönetim Sunucusu, Mesaj İşleyici, Yönlendirici, QPID Sunucusu, Postgres Sunucusu
     • ldap: OpenLDAP
     • ps: postgresql
     • qpid: qpidd
     • sso: Apigee TOA (TOA'yı yüklediyseniz)
     • ue Yeni Edge kullanıcı arayüzü
     • ui: Klasik Edge kullanıcı arayüzü
     • zk: Zookeeper
   • configFile, 4.50.00 veya 4.51.00 kurulumu sırasında Edge bileşenlerinizi tanımlamak için kullandığınız yapılandırma dosyasıyla aynıdır.

   update.sh değerini "all" olarak ayarlayarak tüm bileşenlere karşı component çalıştırabilirsiniz ancak bu yalnızca Edge all-in-one (AIO) yükleme profiliniz varsa mümkündür. Örneğin:

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

8. Henüz yapmadıysanız kullanıcı arayüzü bileşenlerini, üzerinde çalıştıkları tüm düğümlerde yeniden başlatın:

   /opt/apigee/apigee-service/bin/apigee-service [edge-management-ui|edge-ui] restart

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

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

Makine güncelleme sırası

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

• Diğer düğümleri güncellemeden önce tüm Cassandra ve ZooKeeper düğümlerini güncellemeniz gerekir.
• Birden fazla Edge bileşeni (Yönetim Sunucusu, İleti İşleyici, Yönlendirici, QPID Sunucusu ancak Postgres Sunucusu değil) olan tüm makinelerde, hepsini aynı anda güncellemek için -c edge seçeneğini kullanın.
• Bir adımın birden fazla makinede gerçekleştirilmesi gerektiği belirtiliyorsa bu adımı belirtilen makine sırasına göre gerçekleştirin.
• Para kazanma ayarlarını 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.53.00 sürümüne yükseltmek için:

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

   /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'ne bakın.

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

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

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

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

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

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

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

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

5. 2. makinede Qpid'i güncelleyin:

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

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

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

7. (apigee-adminapi yüklediyseniz) 1. makinedeki apigee-adminapi yardımcı programını güncellediyseniz:

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

8. (Apigee TOA'yı yüklediyseniz) 1. makinede Apigee TOA'yı güncelleyin:

   /opt/apigee/apigee-setup/bin/update.sh -c sso -f sso_config_file

   Burada sso_config_file, TOA'yı yüklerken oluşturduğunuz yapılandırma dosyasıdır.

9. 1. makinede Edge kullanıcı arayüzü bileşenini yeniden başlatın:

   /opt/apigee/apigee-service/bin/apigee-service edge-ui restart

5 düğümlü yükseltme

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

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

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

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

2. 4 numaralı makinede Postgres'i güncelleyin:

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

3. 5 numaralı makinede Postgres'i güncelleyin:

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

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

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

5. 4, 5, 1, 2, 3 numaralı makinelerde Edge bileşenlerini güncelleyin:

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

6. 4. makinede Qpid'i güncelleyin:

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

7. 5. makinede Qpid'i güncelleyin:

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

8. Edge kullanıcı arayüzünü güncelleme:
   • Klasik kullanıcı arayüzü: Klasik kullanıcı arayüzünü kullanıyorsanız 1. makinedeki ui bileşenini aşağıdaki örnekte gösterildiği gibi güncelleyin:

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

   • Yeni Edge kullanıcı arayüzü: Yeni Edge kullanıcı arayüzünü yüklediyseniz uygun makinedeki (1. makine olmayabilir) ue bileşenini güncelleyin:

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

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

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

10. (Apigee TOA'yı yüklediyseniz) 1. makinede Apigee TOA'yı güncelleyin:

    /opt/apigee/apigee-setup/bin/update.sh -c sso -f sso_config_file

    Burada sso_config_file, TOA'yı yüklerken oluşturduğunuz yapılandırma dosyasıdır.

11. Kullanıcı arayüzü bileşenini yeniden başlatın:
    • Klasik kullanıcı arayüzü: Klasik kullanıcı arayüzünü kullanıyorsanız aşağıdaki örnekte gösterildiği gibi 1. makinede edge-ui bileşenini yeniden başlatın:

      /opt/apigee/apigee-service/bin/apigee-service edge-ui restart

    • Yeni Edge kullanıcı arayüzü: Yeni Edge kullanıcı arayüzünü yüklediyseniz uygun makinede edge-management-ui bileşenini yeniden başlatın (1. makine olmayabilir):

      /opt/apigee/apigee-service/bin/apigee-service edge-management-ui restart

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

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

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

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

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

2. 8 numaralı makinede Postgres'i güncelleyin:

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

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

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

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

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

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

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

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

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

7. 1. makinede yeni kullanıcı arayüzünü (ue) veya klasik kullanıcı arayüzünü (ui) güncelleyin:

   /opt/apigee/apigee-setup/bin/update.sh -c [ui|ue] -f configFile

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. (Apigee TOA'yı yüklediyseniz) 1. makinede Apigee TOA'yı güncelleyin:

   /opt/apigee/apigee-setup/bin/update.sh -c sso -f sso_config_file

   Burada sso_config_file, TOA'yı yüklerken oluşturduğunuz yapılandırma dosyasıdır.

10. Kullanıcı arayüzü bileşenini yeniden başlatın:
    • Klasik kullanıcı arayüzü: Klasik kullanıcı arayüzünü kullanıyorsanız aşağıdaki örnekte gösterildiği gibi 1. makinede edge-ui bileşenini yeniden başlatın:

      /opt/apigee/apigee-service/bin/apigee-service edge-ui restart

    • Yeni Edge kullanıcı arayüzü: Yeni Edge kullanıcı arayüzünü yüklediyseniz uygun makinede edge-management-ui bileşenini yeniden başlatın (1. makine olmayabilir):

      /opt/apigee/apigee-service/bin/apigee-service edge-management-ui restart

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

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

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

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

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

2. 8 numaralı makinede Postgres'i güncelleyin:

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

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

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

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

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

5. 12, 13, 8, 9, 6, 7, 10 ve 11 numaralı makinelerde Edge bileşenlerini bu sırayla güncelleyin:

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

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

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

7. 6 ve 7 numaralı makinelerde yeni kullanıcı arayüzünü (ue) veya klasik kullanıcı arayüzünü (ui) güncelleyin:

   /opt/apigee/apigee-setup/bin/update.sh -c [ui|ue] -f configFile

8. (apigee-adminapi yüklediyseniz) 6. ve 7. makinelerdeki apigee-adminapi yardımcı programı güncellendi:

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

9. (Apigee TOA'yı yüklediyseniz) 6. ve 7. makinelerde Apigee TOA'yı güncelleyin:

   /opt/apigee/apigee-setup/bin/update.sh -c sso -f sso_config_file

   Burada sso_config_file, TOA'yı yüklerken oluşturduğunuz yapılandırma dosyasıdır.

10. Kullanıcı arayüzü bileşenini yeniden başlatın:
    • Klasik kullanıcı arayüzü: Klasik kullanıcı arayüzünü kullanıyorsanız aşağıdaki örnekte gösterildiği gibi 6. ve 7. makinelerdeki edge-ui bileşenini yeniden başlatın:

      /opt/apigee/apigee-service/bin/apigee-service edge-ui restart

    • Yeni Edge kullanıcı arayüzü: Yeni Edge kullanıcı arayüzünü yüklediyseniz 6. ve 7. makinelerde edge-management-ui bileşenini yeniden başlatın:

      /opt/apigee/apigee-service/bin/apigee-service edge-management-ui restart

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

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

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

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

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

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

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

2. Postgres'i güncelleme:
   1. Veri Merkezi 1'deki 6. Makine

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

   2. Veri Merkezi 2'deki 12. Makine

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

3. LDAP'yi güncelleme:
   1. Veri Merkezi 1'deki Makine 1

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

   2. Veri Merkezi 2'deki 7. Makine

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

4. Edge bileşenlerini güncelleme:
   1. Veri Merkezi 1'deki 4, 5, 6, 1, 2, 3 numaralı makineler

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

   2. Veri Merkezi 2'deki 10, 11, 12, 7, 8, 9 numaralı makineler

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

5. qpidd'yi güncelleyin:
   1. Veri Merkezi 1'deki 4. ve 5. makineler
      1. 4. makinede qpidd uygulamasını güncelleyin:

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

      2. 5. makinede qpidd uygulamasını güncelleyin:

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

   2. Veri Merkezi 2'deki 10 ve 11 numaralı makineler
      1. 10 numaralı makinede qpidd uygulamasını güncelleyin:

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

      2. 11 numaralı makinede qpidd uygulamasını güncelleyin:

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

6. Yeni kullanıcı arayüzünü (ue) veya klasik kullanıcı arayüzünü (ui) güncelleyin:
   1. Veri merkezi 1'deki 1. makine:

      /opt/apigee/apigee-setup/bin/update.sh -c [ui|ue] -f configFile

   2. Veri Merkezi 2'deki 7. Makine:

      /opt/apigee/apigee-setup/bin/update.sh -c [ui|ue] -f configFile

7. (apigee-adminapi yüklediyseniz) apigee-adminapi yardımcı programı güncellendi:
   1. Veri merkezi 1'deki 1. makine:

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

   2. Veri Merkezi 2'deki 7. Makine:

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

8. (Apigee TOA'yı yüklediyseniz) Apigee TOA'yı güncelleyin:
   1. Veri merkezi 1'deki 1. makine:

      /opt/apigee/apigee-setup/bin/update.sh -c sso -f sso_config_file

   2. Veri Merkezi 2'deki 7. Makine:

      /opt/apigee/apigee-setup/bin/update.sh -c sso -f sso_config_file

   Burada sso_config_file, TOA'yı yüklerken oluşturduğunuz yapılandırma dosyasıdır.

9. 1 ve 7 numaralı makinelerde yeni Edge kullanıcı arayüzü (edge-management-ui) veya klasik Edge kullanıcı arayüzü (edge-ui) bileşenini yeniden başlatın:

   /opt/apigee/apigee-service/bin/apigee-service [edge-ui|edge-management-ui] restart

Standart olmayan bir yapılandırma için

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

1. ZooKeeper
2. Cassandra
3. ps
4. LDAP
5. Edge: Sırayla tüm düğümlerdeki "-c edge" profili (Qpid sunucusu, Edge Postgres sunucusu, yönetim sunucusu, ileti işlemcisi ve yönlendirici içeren düğümler).
6. qpidd
7. Edge kullanıcı arayüzü (klasik veya yeni)
8. apigee-adminapi
9. Apigee SSO

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