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

Apigee, Edge for Private Cloud'ı 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 uyumluluk matrisini inceleyin.

Güncellemeyi kimler yapabilir?

Güncellemeyi çalıştıran kullanıcı, Edge'i ilk yükleyen kullanıcıyla aynı veya root olarak çalışan bir kullanıcı olmalıdır.

Edge RPM'lerini yükledikten sonra herkes bu RPM'leri 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 kurulumları desteklemez.

Önkoşulları güncelleme

Apigee Edge'i yükseltmeden önce aşağıdaki ön koşullardan emin olun:

• Tüm düğümleri yedekleme
  Güncellemeden ö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ünüze yönelik prosedürü kullanın.

  Bu sayede, yeni sürüme yapılan 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
  Aşağıdaki komutu kullanarak güncelleme işlemi sırasında Edge'in çalışır durumda olduğundan emin olun:

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

• Cassandra ön koşullarını doğrulama
  Daha önce Private Cloud için Edge'in 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ının Yükseltme sonrası adımlar 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.53.00 sürümüne yükseltme işlemine devam etmeden önce bu adımları tekrar tamamlayın.
• Private Cloud için Edge 4.53.00 sürümünde IDP anahtarlarını ve sertifikalarını yapılandırma
  

  Private Cloud için Edge 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 dahil tüm düğümlere Python 3'ün yüklenmiş olduğundan emin olun.

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

/opt/apigee/customer/application'daki .properties dosyalarını düzenleyerek herhangi bir özellik belirlediyseniz bu değerler güncelleme sırasında korunur.

Cassandra 4.0.13'e yükseltme gerekli

Private Cloud için Apigee Edge 4.53.00, Cassandra'yı 4.0.13 sürümüne yükseltir.

Yükseltmeler ve geri alma

• Cassandra 3.11.X'ten Cassandra 4.0.X'e geçiş sorunsuz bir işlemdir. Private Cloud için Edge 4.53.00 ile birlikte 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. Kopyaları veya yedekleri kullanarak geri alma işlemi karmaşık bir işlemdir ve çalışmama süresi ve/veya veri kaybına neden olabilir. Sorun giderme ve Cassandra 4.0.X'e yükseltme, geri alma işlemine tercih edilir.
• Yükseltme işlemine başlamadan önce geri alma prosedürlerini öğrenmeniz önemlidir. Uygun geri alma yollarının kullanılabilmesi için yükseltme sırasında geri alma işleminin ayrıntılarını dikkate almak çok önemlidir.

Tek veri merkezi

Cassandra'yı tek bir veri merkezinde 3.11.X sürümünden 4.0.X sürümüne yükseltmek sorunsuzdur ancak geri alma işlemi karmaşıktır ve çalışma süresinin kesintiye uğramasına ve veri kaybına neden olabilir. Üretim iş yükleri için yükseltme işlemini başlatmadan önce yeni veri merkezinde en az bir Cassandra düğümü bulunan yeni bir veri merkezi eklemeniz önemle tavsiye edilir. Bu sayede, veri kaybı veya API trafiğinizin kesintiye uğraması olmadan Cassandra'yı geri alabilirsiniz. Yükseltme işlemi tamamlandıktan veya 2. Kontrol Noktası'na ulaşıldığında bu ek veri merkezi kullanımdan kaldırılabilir.

Yeni bir veri merkezi eklemek mümkün değilse ancak geri alma özelliği yine de isteniyorsa Cassandra 3.11.X'i geri yüklemek için yedekler gerekli olacaktır. Ancak bu yöntem, hem çalışmama süresi hem de veri kaybına neden olabilir.

Birden fazla veri merkezi

Edge for Private Cloud 4.52.02 ile birden fazla veri merkezi çalıştırmak, 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 bulunması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önmemeniz gerekir. Özel Bulut 4.53.00 veya 4.52.02'nin diğer bileşenleriyle birlikte daha yeni Cassandra sürümünü kullanmaya devam etmeniz gerekir.

Önerilen yükseltme metodolojisi

1. Tek seferde bir Cassandra veri merkezini yükseltin: Tek bir veri merkezinde Cassandra düğümlerini tek tek yükselterek başlayın. Bir sonraki veri merkezine geçmeden önce bir veri merkezindeki tüm Cassandra düğümlerinin yükseltme işlemlerini tamamlayın.
2. Duraklatıp doğrulama: Bir veri merkezini yükselttikten sonra, Özel Bulut kümenizin (özellikle de yükseltilen veri merkezinin) düzgün çalıştığından emin olmak için duraklatın.
3. Hatırlatma: Yalnızca hâlâ eski sürümü çalıştıran en az bir veri merkeziniz varsa önceki Cassandra sürümüne geri dönebilirsiniz.
4. Zaman açısından hassas: İşlevleri doğrulamak için kısa bir süre duraklatabilirsiniz (birkaç saat önerilir) ancak süresiz olarak karma sürüm durumunda kalamazsınız. Bunun nedeni, tek tip olmayan bir Cassandra kümesinin (farklı sürümlerde düğümlere sahip) işlevsel sınırlamaları olmasıdır.
5. Kapsamlı test: Apigee, 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.

İki kontrol noktası işlemi olarak geri alma

1. 1. Kontrol noktası: Tüm bileşenlerin 4.52.02 sürümünde olduğu ilk durum. En az bir Cassandra veri merkezi eski sürümde kaldığı sürece tam geri alma işlemi yapılabilir.
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 için Edge 4.52.02 sürümündedir. Her DC için üç Cassandra düğümü olduğunu varsayalım.
2. DC-1'i yükseltin: DC-1'deki üç Cassandra düğümünü tek tek yükseltin.
3. Duraklatıp doğrulama: Özellikle 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ü 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ükseltin: Yönetim, çalışma zamanı ve analiz düğümlerini her zamanki gibi tüm veri merkezlerinde tek tek yükseltin. Sorun oluşursa 4. adımdaki duruma geri dönebilirsiniz.

Cassandra yükseltmeyle ilgili ön koşullar

• Kümenin tamamı çalışır durumda ve Cassandra 3.11.16 ile tam işlevseldir.
• Sıkıştırma stratejisi LeveledCompactionStrategy olarak ayarlanmıştır (4.52.02 sürümüne yükseltme için ön koşuldur).
• 4.52.02 yükseltmesinin bir parçası olarak ilk yükseltmeden Cassandra 3.11.16'ya geçişin tüm yükseltme sonrası adımları tamamlandı. Düzelmediyse bu adımları tekrarlayın. Bu durum yalnızca eski bir sürümden Private Cloud 4.52.02 sürümüne yükselttiyseniz geçerlidir.

1. Adım: Yükseltme işlemine hazırlanın

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

1. Apigee'yi kullanarak Cassandra'yı yedekleme.
2. Mümkünse Cassandra düğümlerinin sanal makine anlık görüntülerini alın.
3. Yönetim sunucusu, mesaj işleyici, yönlendirici, Qpid ve Postgres dahil olmak üzere tüm Edge for Private Cloud bileşenlerinden, henüz yapılandırılmamışsa Cassandra düğümlerine 9042 bağlantı noktasına erişilebildiğinden emin olun. Daha fazla bilgi için Bağlantı noktası koşulları bölümüne bakın.

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

Tüm Cassandra düğümleri, her veri merkezinde tek tek 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üğümlere geçmeden önce biraz bekleyin (30 dakika ila birkaç saat). Bu süre zarfında, güncellenen veri merkezini ayrıntılı olarak inceleyin ve Apigee kümenizin işlevsel ve performans metriklerinin bozulmadığından emin olun. Bu adım, Apigee bileşenlerinin geri kalanı 4.52.02 sürümünde kalırken Cassandra'nın 4.0.X 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 yapmak 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ğıdaki gibi 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 dizileri 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 dizileri yeniden oluşturma komutlarını da çalıştırın:

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

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 İleti İşlemcisi düğümlerini tek tek yükseltin:

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

5. Adım: Private Cloud için Edge 4.53.00'daki geri kalan tüm bileşenleri 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ı

Private Cloud için Edge 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üncellemesini her zamanki gibi gerçekleştirmeniz gerekir.

1. IdP'yi yapılandırmak için kullanılan mevcut anahtarı ve sertifikayı tanımlayın:

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

      IDP sertifika yolu için apigee-sso'yi sorgulamak üzere TOA düğümünde aşağıdaki komutu kullanın. Çıktıda 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 conf_login_service_provider_key için apigee-sso bileşenini sorgularak anahtarı alın.

      IDP anahtar yolu için apigee-sso'yi sorgulamak üzere TOA düğümünde aşağıdaki komutu kullanın. Çıktıda son satırdaki değeri bulun.

      apigee-service apigee-sso configure -search conf_login_service_provider_key

2. Anahtarı ve sertifikayı bir 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.a adımında alınan sertifika dosyasının yolu.
      • key_path: 1.b adımında alınan özel anahtar dosyasının yolu.
      • keystore_path: Sertifikayı 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: 2.a adımında oluşturulan, sertifika ve anahtarı içeren 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 anahtar aracı dokümanlarına 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 mağazası dosya yolu, şifre, anahtar mağazası türü ve takma adla 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üyle ilgili dikkat edilmesi gereken noktalar listelenmiştir. 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

Apigee, ilk yüklemeyi tamamladıktan sonra Apigee Edge for Private Cloud geliştiricileri ve yöneticileri için geliştirilmiş bir kullanıcı arayüzü olan Edge kullanıcı arayüzünü yüklemenizi önerir.

Edge kullanıcı arayüzünün, Temel kimlik doğrulamayı devre dışı bırakmanızı ve SAML veya LDAP gibi bir IDP kullanmanızı 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, kaldığınız yerden devam eder.

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

Güncelleme bilgilerini günlüğe kaydetme

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

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

update.sh yardımcı programını çalıştıran kullanıcının söz konusu dizin erişimi yoksa günlük, /tmp dizinine update_username.log adlı bir dosya olarak yazılır.

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

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

Kesintisiz güncelleme veya periyodik güncelleme, Edge'i kapatmadan Edge yüklemenizi güncellemenize olanak tanır.

Kesintisiz güncelleme yalnızca 5 ve daha fazla düğüm içeren yapılandırmalarda mümkündür.

Kesintisiz 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 bileşenleri güncelleyin ve yönlendiriciyi yük dengeleyiciye tekrar ekleyin.

1. Makineleri, Makine güncelleme sırası bölümünde açıklandığı şekilde kurulumunuza uygun doğru sırayla güncelleyin.
2. Yönlendiricileri güncelleme zamanı geldiğinde, herhangi bir yönlendiriciyi seçin ve Sunucu (Mesaj İşleyen/Yönlendirici) erişilebilirliğini etkinleştirme/devre dışı bırakma bölümünde açıklandığı gibi 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ında aynı düğümde bir Yönlendirici ve Mesaj İşleyen gösterilir.
4. Yönlendiricinin tekrar erişilebilir olmasını sağlayın.
5. Kalan yönlendiriciler için 2 ile 4 arasındaki adımları tekrarlayın.
6. Kurulumunuzda kalan makineler için güncellemeye devam edin.

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

• Birleştirilmiş Yönlendirici ve Mesaj İşleyici düğümünde:
  • Güncellemeden önce şunları yapın:
    1. Yönlendiriciye erişilemez hale getirin.
    2. Mesaj işleyiciye erişilemez hale getirin.
  • Güncellemeden sonra şunları yapın:
    1. Mesaj işleyiciye erişilebilirlik sağlayın.
    2. Yönlendiricinin erişilebilir olmasını sağlayın.
• Tek Yönlendirici düğümlerinde:
  • Güncellemeden önce yönlendiriciyi erişilemez hale getirin.
  • Güncellemeden sonra yönlendiriciyi erişilebilir hale getirin.
• Tek Mesaj İşleyen düğümlerinde:
  • Güncellemeden önce Mesaj İşlemciyi erişilemez hale getirin.
  • Güncelleme sonrasında Mesaj İşlemcisini erişilebilir hale getirin.

Sessiz yapılandırma dosyası kullanma

Güncelleme komutuna sessiz yapılandırma dosyası iletmeniz gerekir. Sessiz yapılandırma dosyası, Private Cloud için Edge 4.52.02'yi yüklemek için kullandığınız dosyayla aynı 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ü uygulayın:

1. Varsa Cassandra'da onarım işlemi gerçekleştirecek şekilde 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 root olarak giriş yapın.
3. SELinux'u Edge apigee-setup yardımcı programını yükleme bölümünde açıklandığı şekilde devre dışı bırakın.
4. AWS'ye yüklü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 kullanıyorsanız:

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

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

   2. Aşağıdaki komutu yürüterek Edge 4.53.00 apigee-service yardımcı programını ve bağımlıları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 değerini atlarsanız bu değeri girmeniz istenir.

      Yükleyici varsayılan olarak Java 1.8'in yüklü olup olmadığını kontrol eder. Aksi takdirde yükleyici, sürücüyü 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 yükleyin (varsayılan).
      • C: Java yüklemeden devam edin.
      • Q: Çıkış yapın. Bu seçenekte 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. Aşağıdaki örnekte gösterildiği gibi, Yönetim Sunucusu'ndaki apigee-validate yardımcı programını güncelleyin:

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

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

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

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

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

      Bunu 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:
        • cs: Cassandra
        • edge: Edge kullanıcı arayüzü hariç tüm Edge bileşenleri: Yönetim sunucusu, Mesaj iş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 sürümünü yüklerken Edge bileşenlerinizi tanımlamak için kullandığınız yapılandırma dosyasıyla aynıdır.

      component değerini "tümü" olarak ayarlayarak update.sh'ü tüm bileşenler üzerinde çalıştırabilirsiniz. Bunun için Edge hepsi bir arada (AIO) yükleme profilinizin olması gerekir. Ö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 ç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ünü geri alma bölümünde açıklanan prosedürü uygulayı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 internet üzerinden Apigee deposuna erişmeleri başka bir şekilde yasaklanmışsa güncellemeyi Apigee deposunun yerel bir deposundan veya aynasından yapabilirsiniz.

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 .tar dosyasından Edge'i güncelleyin.
• Diğer düğümlerin erişebilmesi için yerel depoyu içeren düğüme bir web sunucusu yükleyin. Apigee, kullanabileceğiniz Nginx web sunucusunu sağlar veya kendi web sunucunuzu kullanabilirsiniz.

Yerel bir 4.53.00 deposundan güncellemek için:

1. Edge apigee-setup yardımcı programını yükleme başlıklı makalede açıklandığı şekilde yerel bir 4.53.00 deposu oluşturun.
2. apigee-service'i .tar dosyasından yüklemek için:
   1. Yerel deposunun bulunduğu düğümde, yerel deposu /opt/apigee/data/apigee-mirror/apigee-4.53.00.tar.gz adlı tek bir .tar dosyasına 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.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'ten 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, Edge apigee-setup yardımcı programını yükleme başlıklı makalenin "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.53.00.sh dosyasını /tmp/bootstrap_4.53.00.sh'e indirin:

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

      Burada uName:pWord, depo için daha önce belirlediğiniz kullanıcı adı ve şifredir, 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, deponun 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. Aşağıdaki örnekte gösterildiği gibi, Yönetim Sunucusu'ndaki apigee-validate yardımcı programını güncelleyin:

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

6. Aşağıdaki örnekte gösterildiği gibi, Yönetim Sunucusu'ndaki apigee-provision yardımcı programını güncelleyin:

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

7. update yardımcı programını, Makine güncelleme sırası bölümünde açıklanan sırada düğümlerinizde ç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üncelleyebilirsiniz:
     • cs: Cassandra
     • edge: Edge kullanıcı arayüzü hariç tüm Edge bileşenleri: Yönetim sunucusu, Mesaj iş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 yüklemesi sırasında Edge bileşenlerinizi tanımlamak için kullandığınız yapılandırma dosyasıyla aynıdır.

   component değerini "tümü" olarak ayarlayarak update.sh'ü tüm bileşenler üzerinde çalıştırabilirsiniz. Bunun için Edge hepsi bir arada (AIO) yükleme profilinizin olması gerekir. Ö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 çalıştıran 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ünü geri alma bölümünde açıklanan prosedürü uygulayın.

Makine güncellemesinin sırası

Edge kurulumundaki 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, ileti işleyici, yönlendirici, QPID sunucusu ancak Postgres sunucusu değil) içeren makinelerde hepsini aynı anda güncellemek için -c edge seçeneğini kullanın.
• Bir adımda birden fazla makinede yapılması gerektiği belirtiliyorsa bu adımı belirtilen makine sırasına göre gerçekleştirin.
• 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.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 kurulum için aşağıdaki bileşenleri güncelleyin:

Edge topolojileri ve düğüm numaralarının listesi için Yükleme topolojileri bölümü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. makinedeki 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üncelledi:

   /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üğüm yükseltme

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

Edge topolojileri ve düğüm numaralarının listesi için Yükleme topolojileri bölümü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. makinede Postgres'i güncelleyin:

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

3. 5. 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ı makinelerdeki 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 aşağıdaki örnekte gösterildiği gibi 1. makinedeki ui bileşenini 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 makinede (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üncelledi:

   /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 (makine 1 olmayabilir) edge-management-ui bileşenini yeniden başlatın:

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

9 düğümlü küme yükseltme

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

Edge topolojileri ve düğüm numaralarının listesi için Yükleme topolojileri bölümü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ı makinelerdeki Edge bileşenlerini şu sırayla güncelleyin:

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

6. 6 ve 7 numaralı 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'u yüklediyseniz) 1. makinedeki 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 (makine 1 olmayabilir) edge-management-ui bileşenini yeniden başlatın:

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

13 düğümlü küme yükseltme

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

Edge topolojileri ve düğüm numaralarının listesi için Yükleme topolojileri bölümü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ı makinelerdeki Edge bileşenlerini aşağıdaki 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'u 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

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 numaralı makinelerde 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 numaralı 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üme yükseltme

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

Edge topolojileri ve düğüm numaralarının listesi için Yükleme topolojileri bölümü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üncelleyin:
   1. 1. Veri Merkezi'ndeki 6. Makine

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

   2. Veri Merkezi 2'deki 12 numaralı makine

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

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

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

   2. 2. Veri Merkezi'ndeki 7. Makine

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

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

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

   2. 2. Veri Merkezi'ndeki 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. 1. Veri Merkezi'ndeki 4 ve 5 numaralı makineler
      1. 4. makinede qpidd'yi güncelleyin:

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

      2. 5. makinede qpidd'yi güncelleyin:

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

   2. 2. Veri Merkezi'ndeki 10 ve 11 numaralı makineler
      1. 10 numaralı makinede qpidd güncellemesi:

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

      2. 11. makinede qpidd güncellemesi:

         /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. 1. Veri Merkezi'ndeki 1. makine:

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

   2. 2. Veri Merkezi'ndeki 7. makine:

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

7. (apigee-adminapi'u yüklediyseniz) apigee-adminapi yardımcı programını güncelleme:
   1. 1. Veri Merkezi'ndeki 1. makine:

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

   2. 2. Veri Merkezi'ndeki 7. makine:

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

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

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

   2. 2. Veri Merkezi'ndeki 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ünü (edge-management-ui) veya klasik Edge kullanıcı arayüzünü (edge-ui) bileşenini yeniden başlatın:

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

Standart olmayan yapılandırmalar 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: Qpid sunucusu, Edge Postgres sunucusu, Yönetim sunucusu, Mesaj İşleyen ve Yönlendirici'nin bulunduğu düğümler sırasıyla tüm düğümlerde "-c edge" profilidir.
6. qpidd
7. Edge kullanıcı arayüzü (klasik veya yeni)
8. apigee-adminapi
9. Apigee TOA

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.