Google, içerikleri tercih ettiğiniz dile çevirmek için yapay zeka teknolojisini kullanır. Yapay zeka çevirilerinde hata olabilir.

Apigee Edge'in 4.16.01/4.16.05 sürümünü 4.18.01 sürümüne güncelleyin

Edge for Private Cloud 4.18.01 sürümü

Hangi Edge sürümlerini 4.18.01'e güncelleyebilirsiniz?

Bu prosedürü kullanarak Apigee Edge 4.16.01.0x ve 4.16.05.x sürümlerini 4.18.01 sürümüne güncelleyebilirsiniz.

Edge'in 4.16.01 sürümünden önceki bir sürümüne sahipseniz önce 4.16.01 sürümüne geçmeniz, ardından 4.18.01 sürümüne güncellemeniz gerekir.

Apigee Edge 4.15.07 sürümünü 4.16.01 sürümüne taşıyabilirsiniz.
Edge'in 4.15.07 sürümünden önceki bir sürümüne sahipseniz önce 4.15.07 sürümüne, ardından 4.16.01 sürümüne geçmeniz gerekir.
- Edge 4.14.04 veya sonraki bir sürümden taşıma işlemi yapıyorsanız: Doğrudan 4.15.07 sürümüne taşıyın.
- Edge 4.14.01 sürümünden taşıma işlemi yapıyorsanız: Önce 4.14.04 sürümüne, ardından 4.15.07 sürümüne taşıma işlemi yapmanız gerekir.

Güncellemeyi kimler yapabilir?

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

Edge RPM'lerini yükledikten sonra herhangi bir kullanıcı 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.

4.16.01 sürümünden güncelleniyorsa Zookeeper'ın eski sürüme geçirilmesi

Edge for Private Cloud 4.16.01'deki ZooKeeper RPM sürümü apigee-zookeeper-3.4.5-1.0.905.noarch.rpm'dir. Edge'in sonraki sürümlerinde, Zookeeper sürümü tekrar apigee-zookeeper-3.4.5-0.0.94x olarak değiştirildi. Bu, yum'un Zookeeper'ı 4.16.01'den sonraki sürümlere yükseltmesini engeller. Bu durumu düzeltmek için Zookeeper'ı güncellemeden önce yum downgrade apigee-zookeeper komutunu çalıştırın.

Aşağıdaki komutu kullanarak Zookeeper sürümünüzü kontrol edebilirsiniz:

> rpm -qa |grep apigee-zookeeper

Bu komut, ZooKeeper sürümünü döndürürse:

apigee-zookeeper-3.4.5-1.0.905

Ardından eski sürüme geçmeniz gerekir.

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

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

Güncelleme ön koşulları

Apigee Edge'i yükseltmeden önce aşağıdaki ön koşulları yerine getirin:

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

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

Başarısız bir güncellemeyi ele alma

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

Hata nedeniyle güncellemeyi önceki sürümünüze geri almanız gerekiyorsa daha fazla bilgi için 4.18.01 Geri Alma İşlemi başlıklı makaleyi inceleyin.

Güncelleme bilgilerini günlüğe kaydetme

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

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

update.sh yardımcı programını çalıştıran kullanıcının bu dizine erişimi yoksa günlüğü /tmp dizinine update_username.log adlı bir dosya olarak yazar.

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

Java JDK 8 sürümüne yükseltme gerekiyor

Edge'in bu sürümü, tüm Edge işleme düğümlerine Java JDK 8 sürümünü yüklemenizi gerektirir. Oracle JDK 8 veya OpenJDK 8'i yükleyebilirsiniz. Java JDK 8 henüz yüklü değilse güncelleme komut dosyası sizin için yükleyebilir.

Java 8 güncellemesi kapsamında, bazı TLS şifreleri artık Oracle JDK 8'de kullanılamamaktadır. Tam liste için http://docs.oracle.com/javase/8/docs/technotes/guides/security/SunProviders.html adresindeki "Default Disabled Cipher Suites" (Varsayılan Olarak Devre Dışı Bırakılan Şifreleme Paketleri) bölümüne bakın.

EPEL deposunu etkinleştirmek için gereklidir.

Edge'i yüklemek veya güncellemek için Extra Packages for Enterprise Linux (veya EPEL) paketini etkinleştirmeniz gerekir. Kullanacağınız komut, RedHat/CentOS sürümünüze bağlıdır:

RedHat/CentOS 7.x için:
> wget https://dl.fedoraproject.org/pub/epel/epel-release-latest-7.noarch.rpm; rpm -ivh epel-release-latest-7.noarch.rpm
RedHat/CentOS 6.x için:
wget https://dl.fedoraproject.org/pub/epel/epel-release-latest-6.noarch.rpm; rpm -ivh epel-release-latest-6.noarch.rpm

SMTPMAILFROM yapılandırma parametresinin eklenmesi gerekir.

Edge 4.17.05, bir SMTP sunucusunu etkinleştirirken kullanılan yapılandırma dosyasına yeni bir zorunlu parametre ekledi. 4.17.01 sürümünden güncelleme yapıyorsanız SMTP sunucusunu etkinleştirirken yapılandırma dosyasında SMTPMAILFROM değerini ayarlamanız gerekir.

API BaaS 4.17.09 sürümünde SMTPMAILFROM özelliği için de destek eklendi. API BaaS'yi güncellerken yapılandırma dosyasında SMTPMAILFROM değerini ayarlamanız gerekir.

Bu parametre şu biçimdedir:

SMTPMAILFROM="My Company <myco@company.com>"

Harici kimlik doğrulama kullanılırken güncelleme yapılıyorsa gereklidir.

Harici bir dizin hizmetini mevcut bir Apigee Edge Private Cloud kurulumuna entegre edebilirsiniz. Bu özellik, Active Directory ve OpenLDAP gibi LDAP'yi destekleyen tüm dizin hizmetleriyle çalışacak şekilde tasarlanmıştır. Harici bir LDAP çözümü, sistem yöneticilerinin kullanıcı kimlik bilgilerini, bunları kullanan Apigee Edge gibi sistemlerin dışında merkezi bir dizin yönetimi hizmetinden yönetmesine olanak tanır.

Daha fazla bilgi için Harici Kimlik Doğrulama Yapılandırması başlıklı makaleyi inceleyin.

Harici kimlik doğrulama etkinleştirildiğinde çoğu müşteri, Edge OpenLDAP sunucusu tarafından kullanılan bir e-posta adresi yerine kimlik doğrulama için kullanıcı adı olarak Active Directory SAM hesap adı alanını kullanır.

Harici bir dizin hizmetiyle entegrasyon yaptıysanız Edge'i 4.18.01 sürümüne güncellerken yapılandırma dosyanıza aşağıdaki satırı ekleyin:

IS_EXTERNAL_AUTH="true"

Bu satır, Edge'i kullanıcı adı olarak e-posta adresi yerine hesap adını destekleyecek şekilde yapılandırır.

Qpid 1.35'e yükseltme zorunlu

Bu sürüm, Qpid 1.35 için gerekli bir güncelleme içerir. Bir Qpid düğümünü güncelleme kapsamında şunları yapmanız gerekir:

Qpid düğümünde 5672 numaralı bağlantı noktasını engelleyerek yönlendiricilerin ve mesaj işlemcilerin Qpid düğümüne yazmasını geçici olarak engelleyin. Qpid düğümünde bu bağlantı noktasını engellemek için aşağıdaki komutu kullanabilirsiniz:
> sudo iptables -A INPUT -p tcp --destination-port 5672 ! -s `hostname` -i eth0 -j DROP
Qpid düğümünün güncellemeden önce tüm mesajları işlediğinden emin olmak için Qpid kuyruğunun mesajlardan boşalmasını bekleyin. Qpid mesaj sırasının boş olduğundan emin olmak için aşağıdaki komutu kullanın:
> qpid-stat -q
Qpid düğümünü güncelleyin.
Yönlendiricilerden ve Mesaj İşlemcilerden erişime izin vermek için Qpid düğümünde 5672 numaralı bağlantı noktasının engellemesini kaldırın. Bu bağlantı noktasının engellemesini kaldırmak için aşağıdaki komutu kullanabilirsiniz:
> sudo iptables -F

Diğer kurallar için iptables kullanıyorsanız belirli bir değişikliği geri almak için -D seçeneğini kullanabilirsiniz:
> sudo iptables -D INPUT -p tcp --destination-port 5672 ! -s `hostname` -i eth0 -j DROP

Bu işlem, her bir Edge topolojisi için aşağıda ayrıntılı olarak açıklanmıştır.

Postgres 9.6'ya zorunlu yükseltme

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

Güncelleme işlemi sırasında Postgres düğümleri güncelleme için devre dışı bırakılırken analiz verileri Qpid düğümlerine yazılmaya devam eder. Postgres düğümleri güncellenip tekrar çevrimiçi olduktan sonra analiz verileri Postgres düğümlerine aktarılır.

Güncellemeyi herhangi bir nedenle geri almanız gerekirse ek Postgres bekleme düğümü gerekir. Güncellemeyi geri almanız gerekirse yeni Postgres bekleme düğümü, geri alma işleminden sonra ana Postgres düğümü olur. Bu nedenle, yeni Postgres yedek düğümünü yüklediğinizde, Edge Yükleme Şartları'nda tanımlandığı şekilde bir Postgres sunucusunun tüm donanım şartlarını karşılayan bir düğümde olması gerekir.

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

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

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

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

Mevcut Postgres ana sunucusunda, aşağıdaki jetonu ayarlamak için /opt/apigee/customer/application/postgresql.properties dosyasını düzenleyin. Bu dosya yoksa oluşturun:

conf_pg_hba_replication.connection=host replication apigee existing_slave_ip/32 trust\ \nhost replication apigee new_slave_ip/32 trust

Burada existing_slave_ip, mevcut Postgres bekleme sunucusunun IP adresidir ve new_slave_ip, yeni bekleme düğümünün IP adresidir.
Postgres ana sunucusunda apigee-postgresql'yi yeniden başlatın:
> /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql restart
Ana düğümdeki /opt/apigee/apigee-postgresql/conf/pg_hba.conf dosyasını görüntüleyerek yeni bekleme düğümünün eklendiğini doğrulayın. Bu dosyada aşağıdaki satırları görmeniz gerekir:
host replication apigee existing_slave_ip/32 trust
host replication apigee new_slave_ip/32 trust
Yeni Postgres yedek sunucusunu yükleyin:
1. Edge'in mevcut sürümünü yüklemek için kullandığınız yapılandırma dosyasını düzenleyerek aşağıdakileri belirtin:
  
  # IP address of the current master:
  PG_MASTER=192.168.56.103
  # IP address of the new standby node
  PG_STANDBY=192.168.56.102
2. Edge apigee-setup yardımcı programını yükleme bölümünde açıklandığı şekilde SELinux'u devre dışı bırakın.
3. Edge bootstrap_4.16.05.sh dosyasını /tmp/bootstrap_4.16.05.sh dizinine indirin:
  > curl https://software.apigee.com/bootstrap_4.16.05.sh -o /tmp/bootstrap_4.16.05.sh
  
  Not: 4.16.01 sürümünden güncelleme yapıyorsanız Edge bootstrap.sh dosyasını indirin.
4. Edge apigee-service yardımcı programını ve bağımlılıklarını yükleyin:
  > sudo bash /tmp/bootstrap_4.16.05.sh apigeeuser=uName apigeepassword=pWord
5. apigee-setup yardımcı programını yüklemek için apigee-service'i kullanın:
  > /opt/apigee/apigee-service/bin/apigee-service apigee-setup install
6. Postgres'i yükleyin:
  > /opt/apigee/apigee-setup/bin/setup.sh -p ps -f configFile
7. Yeni bekleme düğümünde aşağıdaki komutu çalıştırın:
  > /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql postgres-check-standby
  
  Bekleme düğümü olduğunu doğrulayın.

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

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

Postgres'in çalıştığından emin olun:
> /opt/apigee/apigee-service/bin/apigee-all status

Postgres çalışmıyorsa başlatın:
> /opt/apigee/apigee-service/bin/apigee-all start
Yeni yedek düğümde aşağıdaki cURL komutunu çalıştırarak yeni yedek düğümün UUID'sini alın:
> curl -u sysAdminEmail:password http://<node_IP>:8084/v1/servers/self

Çıkışın sonunda düğümün UUID'sini şu biçimde görürsünüz:
"type" : [ "postgres-server" ],
"uUID" : "599e8ebf-5d69-4ae4-aa71-154970a8ec75"
Yeni yedek düğümde aşağıdaki komutu çalıştırarak yeni yedek düğümü durdurun:
> /opt/apigee/apigee-service/bin/apigee-all stop
Postgres ana düğümünde /opt/apigee/customer/application/postgresql.properties dosyasını düzenleyerek yeni bekleme düğümünü conf_pg_hba_replication.connection'dan kaldırın:
conf_pg_hba_replication.connection=host replication apigee existing_slave_ip/32 trust
Postgres ana sunucusunda apigee-postgresql'i yeniden başlatın:
> /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql restart
Ana düğümdeki /opt/apigee/apigee-postgresql/conf/pg_hba.conf dosyasını görüntüleyerek yeni bekleme düğümünün kaldırıldığını doğrulayın. Bu dosyada yalnızca aşağıdaki satırı görmeniz gerekir:
host replication apigee existing_slave_ip/32 trust
Yönetim Sunucusu düğümünde aşağıdaki Edge yönetim API'si çağrısını yaparak bekleme düğümünün UUID'sini ZooKeeper'dan silin:
> curl -u sysAdminEmail:password -X DELETE http://<ms_IP>:8080/v1/servers/<new_slave_uuid>

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

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

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

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

Makineleri, kurulumunuz için doğru sırada güncelleyin. Bu sıra, aşağıda "Makine güncelleme sırası" bölümünde açıklanmıştır.
Yönlendiricileri güncelleme zamanı geldiğinde, Sunucu (Mesaj İşleyici/Yönlendirici) Erişilebilirliğini Etkinleştirme/Devre Dışı Bırakma bölümünde açıklandığı gibi herhangi bir yönlendiriciyi seçin ve erişilemez hale getirin.
Seçilen yönlendiriciyi ve yönlendiriciyle aynı makinedeki diğer tüm Edge bileşenlerini güncelleyin. Tüm Edge yapılandırmaları, aynı düğümde bir yönlendirici ve mesaj işlemcisi gösterir.
Yönlendiriciyi tekrar erişilebilir hale getirin.
Kalan yönlendiriciler için 2-4 arasındaki adımları tekrarlayın.
Kurulumunuzdaki diğer makineler için güncellemeye devam edin.

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

Birleşik yönlendirici ve mesaj işleyici düğümünde:
- Güncellemeden önce aşağıdakileri yapın:
  1. Yönlendiriciyi erişilemez hale getirin.
  2. Mesaj İşleyici'yi erişilemez hale getirin.
- Güncellemeden sonra aşağıdakileri yapın:
  1. Mesaj İşleyici'yi erişilebilir hale getirin.
  2. Yönlendiriciyi erişilebilir hale getirin.
Tek bir yönlendirici düğümünde:
- Güncellemeden önce yönlendiriciyi erişilemez hale getirin.
- Güncellemeden sonra yönlendiriciyi erişilebilir hale getirin.
Tek bir Mesaj İşleyici düğümünde:
- Güncellemeden önce Mesaj İşleyici'yi erişilemez hale getirin.
- Güncellemeden sonra Mesaj İşleyici'yi erişilebilir hale getirin.

Sessiz yapılandırma dosyası kullanma

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

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

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

Şu anda Postgres ana-yedek replikasyonu kullanıyorsanız yukarıda Yeni bir Postgres yedek düğümü yükleme bölümünde açıklandığı gibi yeni bir Postgres yedek düğümü yükleyin.
Varsa Cassandra'da onarım işlemi gerçekleştirmek üzere yapılandırılmış tüm CRON işlerini güncelleme tamamlanana kadar devre dışı bırakın.
Edge RPM'lerini yüklemek için düğümünüze kök olarak giriş yapın.
Not: RPM yüklemesi için kök erişimi gerekir ancak Edge yapılandırmasını kök erişimi olmadan gerçekleştirebilirsiniz.
yum-utils ve yum-plugin-priorities paketlerini yükleyin:
> sudo yum install yum-utils
> sudo yum install yum-plugin-priorities
Edge apigee-setup yardımcı programını yükleme bölümünde açıklandığı şekilde SELinux'u devre dışı bırakın.
EPEL deposunu yukarıda açıklandığı şekilde etkinleştirin.
Oracle 7.x'e yüklüyorsanız aşağıdaki komutu çalıştırın:
> sudo yum-config-manager --enable ol7_optional_latest
AWS'ye yüklüyorsanız aşağıdaki yum-configure-manager komutlarını çalıştırın:
> yum update rh-amazon-rhui-client.noarch
> sudo yum-config-manager --enable rhui-REGION-rhel-server-extras rhui-REGION-rhel-server-optional
Edge 4.18.01 bootstrap_4.18.01.sh dosyasını /tmp/bootstrap_4.18.01.sh konumuna indirin:
> curl https://software.apigee.com/bootstrap_4.18.01.sh -o /tmp/bootstrap_4.18.01.sh
Edge 4.18.01 apigee-service yardımcı programını ve bağımlılıkları yükleyin:
> sudo bash /tmp/bootstrap_4.18.01.sh apigeeuser=uName apigeepassword=pWord

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

Yükleyici, varsayılan olarak Java 1.8'in yüklü olup olmadığını kontrol eder. Yüklü değilse sizin için yükler. Java kurulumunun nasıl yapılacağını belirtmek için JAVA_FIX seçeneğini kullanın. JAVA_FIX şu değerleri alır:

I = OpenJDK 1.8'i yükle (varsayılan)
C = Java'yı yüklemeden devam et
Q = Çık. Bu seçenek için Java'yı kendiniz yüklemeniz gerekir.
apigee-setup yardımcı programını güncellemek için apigee-service'i kullanın:
1. Edge 4.15.07.0x sürümünü yükselterek 4.16.01 sürümünü yüklediyseniz apigee-setup yardımcı programını yüklemeniz gerekir:
  > /opt/apigee/apigee-service/bin/apigee-service apigee-setup install
  
  Bu komut, update.sh yardımcı programını /opt/apigee/apigee-setup/bin dizinine yükler.
  
  apigee-setup yardımcı programını zaten yüklediyseniz güncelleyin:
  > /opt/apigee/apigee-service/bin/apigee-service apigee-setup update
2. 4.16.01'i doğrudan yüklediyseniz (yani 4.15.07.0x'ten yükseltme yapmadıysanız) apigee-setup yardımcı programını güncellemeniz gerekir:
  > /opt/apigee/apigee-service/bin/apigee-service apigee-setup update
  
  apigee-service'e yapılan bu güncelleme, /opt/apigee/apigee-setup/bin dizinine update.sh yardımcı programını yükler.
3. 4.16.05 sürümünü doğrudan veya güncelleyerek yüklediyseniz apigee-setup yardımcı programını güncellemeniz gerekir:
  > /opt/apigee/apigee-service/bin/apigee-service apigee-setup update
  
  apigee-service için yapılan bu güncelleme, update.sh yardımcı programını /opt/apigee/apigee-setup/bin dizinine yükler.
Edge'in mevcut sürümüne bağlı olarak Yönetim Sunucusu'na apigee-validate yardımcı programını yüklemeniz veya güncellemeniz gerekir.
1. Şu anda Edge 4.16.05 kullanıyorsanız: Yönetim Sunucusu'ndaki apigee-validate yardımcı programını güncelleyin:
  > /opt/apigee/apigee-service/bin/apigee-service apigee-validate update
2. Şu anda Edge 4.16.01 kullanıyorsanız: Yönetim Sunucusu'na apigee-validate yardımcı programını yükleyin:
  > /opt/apigee/apigee-service/bin/apigee-service apigee-validate install
  
  Not: 4.16.01 sürümünü yüklerken bir Mesaj İşleyici düğümüne apigee-validate yardımcı programını yüklediyseniz bu düğümde aşağıdaki komutu kullanarak yardımcı programı güncelleyebilirsiniz:
  > /opt/apigee/apigee-service/bin/apigee-service apigee-validate update
  
  Ancak 4.16.05 ve sonraki sürümlerde Apigee, Yönetim Sunucusu'na apigee-validate yardımcı programını yükleyip çalıştırmanızı önerir.
3. 4.16.01 sürümünden yükseltme yapıyorsanız: apigee-validate yardımcı programına iletilen yapılandırma dosyasını düzenleyin. 4.16.01 Edge sürümünde, apigee-validate tarafından kullanılan yapılandırma dosyası aşağıdaki özellikleri gerektiriyordu:
  APIGEE_ADMINPW=sysAdminPword
  MP_POD=gateway
  REGION=dc-1
  
  Bu sürümde, yapılandırma dosyası yalnızca APIGEE_ADMINPW özelliğini gerektirir. Diğer iki özelliği dosyadan kaldırabilirsiniz.
apigee-provision yardımcı programını güncelleyin:
> /opt/apigee/apigee-service/bin/apigee-service apigee-provision update
Güncelleme yardımcı programını, düğümlerinizde aşağıdaki "Makine güncelleme sırası" bölümünde açıklanan sırayla çalıştırın:
> /opt/apigee/apigee-setup/bin/update.sh -c component -f configFile

Yapılandırma dosyasıyla ilgili tek şart, yapılandırma dosyasının "apigee" kullanıcısı tarafından erişilebilir veya okunabilir olmasıdır.

Güncellenecek bileşeni belirtmek için "-c" seçeneğini kullanın. Olası bileşenlerin listesi şunları içerir:
ldap = OpenLDAP
cs = Cassandra
zk = Zookeeper
qpid = qpidd
ps = postgresql
edge =Edge kullanıcı arayüzü hariç tüm Edge bileşenleri: Yönetim Sunucusu, Mesaj İşlemcisi, Yönlendirici, QPID Sunucusu, Postgres Sunucusu
ui = Edge kullanıcı arayüzü
all = Makinedeki tüm bileşenleri güncelleyin (yalnızca Edge aio yükleme profili veya API BaaS asa yükleme profili için kullanın)
e = ElasticSearch
b = API BaaS Stack
p = API BaaS Portalı
ebp = Aynı düğümde ElasticSearch, API BaaS Stack ve API BaaS Portalı
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.
Yeni bir Postgres yedek düğümü yüklediyseniz yukarıdaki Postgres düğümünü kullanımdan kaldırma bölümünde açıklandığı şekilde düğümü kullanımdan kaldırın.

Güncellemeyi daha sonra geri almak için 4.18.01 Geri Alma İşlemi bölümünde açıklanan prosedürü kullanın.

Yerel bir depodan 4.18.01 sürümüne güncelleme prosedürü

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

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

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

Yerel bir 4.18.01 deposundan güncelleme yapmak için:

Şu anda Postgres ana-yedek replikasyonu kullanıyorsanız yukarıda Yeni bir Postgres yedek düğümü yükleme bölümünde açıklandığı gibi yeni bir Postgres yedek düğümü yükleyin.
Edge apigee-setup yardımcı programını yükleme bölümündeki "Yerel Apigee deposu oluşturma" başlığı altında açıklandığı şekilde yerel bir 4.18.01 deposu oluşturun.
Not: Mevcut bir 4.16.01 veya 4.16.05 deponuz varsa 4.18.01 deposunu, Edge apigee-setup yardımcı programını yükleme bölümündeki "Yerel Apigee deposunu güncelleme" bölümünde açıklandığı şekilde ekleyebilirsiniz.
apigee-service'i bir .tar dosyasından yüklemek için:
1. Yerel depoya sahip düğümde, yerel depoyu /opt/apigee/data/apigee-mirror/apigee-4.18.01.tar.gz adlı tek bir.tar dosyasında 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.18.01.tar.gz
  
  Bu komut, .tar dosyasını içeren dizinde repos adlı yeni bir dizin oluşturur. Örneğin, /tmp/repos.
4. Edge apigee-service yardımcı programını ve bağımlılıklarını /tmp/repos dizininden yükleyin:
  > sudo bash /tmp/repos/bootstrap_4.18.01.sh apigeeprotocol="file://" apigeerepobasepath=/tmp/repos
  
  Bu komuta repos dizininin yolunu eklediğinize dikkat edin.
Nginx web sunucusunu kullanarak apigee-service'i yüklemek için:
1. Nginx web sunucusunu, Edge apigee-setup yardımcı programını yükleme sayfasındaki "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.18.01.sh dosyasını /tmp/bootstrap_4.18.01.sh dizinine indirin:
  > /usr/bin/curl http://uName:pWord@remoteRepo:3939/bootstrap_4.18.01.sh -o /tmp/bootstrap_4.18.01.sh
  
  Burada uName:pWord, depo için yukarıda ayarladığınız kullanıcı adı ve şifre, remoteRepo ise depo düğümünün IP adresi veya DNS adıdır.
3. Uzak düğümde Edge apigee-service yardımcı programını ve bağımlılıklarını yükleyin:
  > sudo bash /tmp/bootstrap_4.18.01.sh apigeerepohost=remoteRepo:3939 apigeeuser=uName apigeepassword=pWord apigeeprotocol=http://
  
  Burada uName:pWord, depo kullanıcı adı ve şifresidir.
apigee-setup yardımcı programını güncellemek için apigee-service'i kullanın:
1. Edge 4.15.07.0x sürümünü yükselterek 4.16.01 sürümünü yüklediyseniz apigee-setup yardımcı programını yüklemeniz gerekir:
  > /opt/apigee/apigee-service/bin/apigee-service apigee-setup install
  
  Bu komut, update.sh yardımcı programını /opt/apigee/apigee-setup/bin dizinine yükler.
  
  apigee-setup yardımcı programını zaten yüklediyseniz güncelleyin:
  > /opt/apigee/apigee-service/bin/apigee-service apigee-setup update
2. 4.16.01'i doğrudan yüklediyseniz (yani 4.15.07.0x'ten yükseltme yapmadıysanız) apigee-setup yardımcı programını güncellemeniz gerekir:
  > /opt/apigee/apigee-service/bin/apigee-service apigee-setup update
  
  apigee-service'e yapılan bu güncelleme, update.sh yardımcı programını /opt/apigee/apigee-setup/bin dizinine yükler.
3. 4.16.05 sürümünü doğrudan veya güncelleyerek yüklediyseniz apigee-setup yardımcı programını güncellemeniz gerekir:
  > /opt/apigee/apigee-service/bin/apigee-service apigee-setup update
  
  apigee-service için yapılan bu güncelleme, update.sh yardımcı programını /opt/apigee/apigee-setup/bin dizinine yükler.
Edge'in mevcut sürümüne bağlı olarak Yönetim Sunucusu'na apigee-validate yardımcı programını yüklemeniz veya güncellemeniz gerekir.
1. Şu anda Edge 4.16.05 kullanıyorsanız: Yönetim Sunucusu'ndaki apigee-validate yardımcı programını güncelleyin:
  > /opt/apigee/apigee-service/bin/apigee-service apigee-validate update
2. Şu anda Edge 4.16.01 kullanıyorsanız: Yönetim Sunucusu'na apigee-validate yardımcı programını yükleyin:
  > /opt/apigee/apigee-service/bin/apigee-service apigee-validate install
  
  Not: 4.16.01 sürümünü yüklerken bir Mesaj İşleyici düğümüne apigee-validate yardımcı programını yüklediyseniz bu düğümde aşağıdaki komutu kullanarak yardımcı programı güncelleyebilirsiniz:
  > /opt/apigee/apigee-service/bin/apigee-service apigee-validate update
  
  Ancak 4.16.05 ve sonraki sürümlerde Apigee, Yönetim Sunucusu'na apigee-validate yardımcı programını yükleyip çalıştırmanızı önerir.
3. 4.16.01 sürümünden yükseltme yapıyorsanız: apigee-validate yardımcı programına iletilen yapılandırma dosyasını düzenleyin. 4.16.01 Edge sürümünde, apigee-validate tarafından kullanılan yapılandırma dosyası aşağıdaki özellikleri gerektiriyordu:
  APIGEE_ADMINPW=sysAdminPword
  MP_POD=gateway
  REGION=dc-1
  
  Bu sürümde, yapılandırma dosyası yalnızca APIGEE_ADMINPW özelliğini gerektirir. Diğer iki özelliği dosyadan kaldırabilirsiniz.
apigee-provision yardımcı programını güncelleyin:
> /opt/apigee/apigee-service/bin/apigee-service apigee-provision update
Güncelleme yardımcı programını, düğümlerinizde aşağıdaki "Makine güncelleme sırası" bölümünde açıklanan sırayla çalıştırın:
> /opt/apigee/apigee-setup/bin/update.sh -c component -f configFile

Yapılandırma dosyasıyla ilgili tek şart, yapılandırma dosyasının "apigee" kullanıcısı tarafından erişilebilir veya okunabilir olmasıdır.

Güncellenecek bileşeni belirtmek için "-c" seçeneğini kullanın. Olası bileşenlerin listesi şunları içerir:
ldap = OpenLDAP
cs = Cassandra
zk = Zookeeper
qpid = qpidd
ps = postgresql
edge =Edge kullanıcı arayüzü hariç tüm Edge bileşenleri: Yönetim Sunucusu, Mesaj İşlemcisi, Yönlendirici, QPID Sunucusu, Postgres Sunucusu
ui = Edge kullanıcı arayüzü
all = Makinedeki tüm bileşenleri güncelleyin (yalnızca Edge aio yükleme profili veya API BaaS asa yükleme profili için kullanın)
e = ElasticSearch
b = API BaaS Stack
p = API BaaS Portalı
ebp = Aynı düğümde ElasticSearch, API BaaS Stack ve API BaaS Portalı
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.
Yeni bir Postgres yedek düğümü yüklediyseniz yukarıdaki Postgres düğümünü kullanımdan kaldırma bölümünde açıklandığı şekilde düğümü kullanımdan kaldırın.

Güncellemeyi daha sonra geri almak için 4.18.01 Geri Alma İşlemi bölümünde açıklanan prosedürü kullanın.

Makine güncelleme sırası

Edge kurulumunda makineleri güncelleme sıranız önemlidir. Güncelleme yaparken dikkat edilmesi gereken en önemli noktalar şunlardır:

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, Mesaj İşlemcisi, Yönlendirici, QPID Sunucusu ancak Postgres Sunucusu değil) bulunan 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 özelliğini güncellemek için ayrı bir adım yoktur. "-c edge" seçeneğini belirttiğinizde güncellenir.