Edge for Private Cloud 4.19.01 sürümü
Bu prosedürde, mevcut bir Apigee Geliştirici Hizmetleri portalı (veya daha basit bir şekilde ifade etmek gerekirse portal) şirket içi kurulumunun nasıl yükseltileceği açıklanmaktadır.
Doğru güncelleme prosedürünü belirleme
Portalı güncellemek için kullanacağınız prosedür, mevcut yüklemenize bağlıdır:
- Yüklemenizde Nginx/Postgres kullanılıyorsa aşağıdaki BGBG'leri kullanarak portalı yükseltme bölümünü inceleyin.
- Yükleme işleminizde Apache/MySQL veya Apache/MariaDB kullanılıyorsa tar tabanlı bir portalı BGBG tabanlı bir portala dönüştürme konusuna bakın.
Mevcut yükleme türünüzü belirleyin
Geçerli yükleme türünüzden emin değilseniz belirlemek için aşağıdaki komutu kullanın:
ls /opt
Nginx/Postgres kullanıyorsanız şu dizinleri görürsünüz:
/opt/apigee
ve/opt/nginx
.Apache/MySQL veya Apache/MariaDB kullanıyorsanız bu dizinler mevcut olmamalıdır.
/opt/apigee/apigee-service/bin/apigee-all status
Nginx/Postgres kullanıyorsanız aşağıdaki çıkışı görürsünüz:
+ apigee-service apigee-drupal-devportal status OK: apigee-drupal-devportal is up and running + apigee-service apigee-lb status apigee-service: apigee-lb: OK + apigee-service apigee-postgresql status apigee-service: apigee-postgresql: OK
apachectl -S
Apache/MySQL veya Apache/MariaDB kullanıyorsanız bu komut, portalın web kök dizinini şu biçimde döndürecektir:
*:80 192.168.56.102 (/etc/httpd/conf/vhosts/devportal.conf:1)
Varsayılan yükleme dizini
Yükseltme işlemi, portalın şu adrese yüklendiğini varsayar:
- 4.17.05 ve sonraki sürümler:
/opt/apigee/apigee-drupal/wwwroot
- 4.17.05'ten önceki sürümler:
/opt/apigee/apigee-drupal
(Nginx) veya/var/www/html
(Apache)
Portalı varsayılan dizine yüklemediyseniz yükleme dizininizi kullanmak için aşağıdaki prosedürde yer alan yolları değiştirin.
Desteklenen yükseltme sürümleri
Bu yükseltme prosedürü, portalın aşağıdaki sürümleri için desteklenir:
- OPDK-17-01.x
- OPDK-17-05.x
- OPDK-17-09.x
- OPDK-18-01.x
- OPDK-18-05.x
Portal sürümünüzü belirlemek için aşağıdaki URL'yi bir tarayıcıda açın:
http://yourportal.com/buildInfo
Güncellemeden önce
Mevcut yüklemeler için Drupal'ın çekirdeğinde veya özel olmayan modüllerde herhangi bir kodu değiştirdiyseniz yaptığınız değişikliklerin üzerine yazılır. Diğer hususların yanı sıra, .htaccess
ürününde yapmış olabileceğiniz değişiklikler de bu kapsamdadır.
/sites
dizini dışındaki her şeyin Drupal'a ait olduğunu varsaymanız gerekir. Bu kuralın bir istisnası, robots.txt
dosyasıdır. Bu dosya web kök dizininde mevcutsa sizin için korunur.
Yükleme işlemine devam etmeden önce, Drupal web kök dizininizin tamamını yedekleyin. Aşağıda açıklanan yükleme adımlarını gerçekleştirdikten sonra, özelleştirmelerinizi yedekten geri yükleyebilirsiniz.
BGBG'leri kullanarak portalları yükseltme
Bir düğümde portal BGBG'sini güncellemek için:
- Drupal dizinine (varsayılan olarak
/opt/apigee/apigee-drupal
) geçin:cd /opt/apigee/apigee-drupal
- Drupal veritabanı örneğinizi yedekleyin.
pg_dump
komutu, veritabanının bir kopyasını oluşturur:pg_dump --dbname=devportal --host=host_IP_address --username=drupaladmin --password --format=c > /tmp/portal.dmp
Burada:
- devportal, portal yükleme yapılandırma dosyasındaki
PG_NAME
özelliği tarafından belirtilen veritabanı adıdır. - host_IP_address, portal düğümünün IP adresidir.
- drupaladmin, portal yükleme yapılandırma dosyasında
DRUPAL_PG_USER
özelliği tarafından belirtilen veritabanına erişmek için portal tarafından kullanılan Postgres kullanıcı adıdır.
Portal yükleme yapılandırma dosyasındaki
DRUPAL_PG_PASS
özelliği tarafından tanımlanan Postgres kullanıcı şifresini girmeniz istenir.Daha sonra yedekten geri yüklemek isterseniz aşağıdaki komutu kullanın:
pg_restore --clean --dbname=devportal --host=localhost --username=apigee < /tmp/portal.dmp
- devportal, portal yükleme yapılandırma dosyasındaki
- Drupal web kök dizininizin tamamını yedekleyin. Varsayılan yükleme konumu
/opt/apigee/apigee-drupal
şeklindedir, ancak bu konumu değiştirmiş olabilirsiniz.Bu dizinin konumundan emin değilseniz herkese açık dosya sisteminin ve gizli dosya sistemi yolunun konumunu (sonraki adımda) belirlemek için
drush status
komutunu veya Drupal menüsündeki Yapılandırma > Medya > Dosya girişini kullanın. /opt/apigee/data/apigee-drupal-devportal/private
klasöründeki dosyaları yedekleyin.- Drupal'ı bakım moduna ayarlayın:
- Drupal menüsünde Yapılandırma'yı seçin.
- Yapılandırma sayfasında, Geliştirme bölümündeki Bakım modu'nu seçin.
- Siteyi bakım moduna geçir kutusunu seçin.
- Kullanıcılara bakım sırasında gösterilecek bir mesaj girin.
- Save configuration'ı (Yapılandırmayı kaydet) seçin.
- SELinux'u Edge Apigee-setup yardımcı programını yükleme bölümünde açıklandığı şekilde devre dışı bırakın.
/opt
dizinine geçin:cd /opt
- İnternet bağlantısı olan bir sunucuda yükseltme işlemi için:
- Edge 4.19.01
bootstrap_4.19.01.sh
dosyasını/tmp/bootstrap_4.19.01.sh
uygulamasına indirin:curl https://software.apigee.com/bootstrap_4.19.01.sh -o /tmp/bootstrap_4.19.01.sh
- Edge 4.19.01
apigee-service
yardımcı programını ve bağımlılıklarını yükleyin:sudo bash /tmp/bootstrap_4.19.01.sh apigeeuser=uName apigeepassword=pWord
Burada uName ve pWord, Apigee'den aldığınız kullanıcı adı ve şifredir. pWord yönergesini çıkarırsanız bunu girmeniz istenir.
Varsayılan olarak yükleyici, Java 1.8'in yüklü olup olmadığını kontrol eder. Java'yı yüklemeden devam etmek için "C" seçeneğini kullanabilirsiniz.
- Edge 4.19.01
- İnternet bağlantısı olmayan bir sunucuda yükseltme işlemi için:
- Yerel Apigee deposu oluşturma bölümünde açıklandığı şekilde yerel bir 4.19.01 deposu oluşturun.
- .tar dosyasından Apigee-service'i yüklemek için:
- Yerel deponun bulunduğu düğümde, yerel depoyu
/opt/apigee/data/apigee-mirror/apigee-4.19.01.tar.gz
adlı tek bir .tar dosyası olarak paketlemek için aşağıdaki komutu kullanın:/opt/apigee/apigee-service/bin/apigee-service apigee-mirror package
- .tar dosyasını, Edge'i güncellemek istediğiniz düğüme kopyalayın. Örneğin, bunu yeni düğümdeki
/tmp
dizinine kopyalayın. - Yeni düğümde, dosyanın /tmp dizinindeki tarfını kaldırın:
tar -xzf apigee-4.19.01.tar.gz
Bu komut, .tar dosyasını içeren dizinde depo adında yeni bir dizin oluşturur. Örneğin, /tmp/repos.
- Edge
apigee-service
yardımcı programını ve/tmp/repos
kaynağından bağımlılıkları yükleyin:sudo bash /tmp/repos/bootstrap_4.19.01.sh apigeeprotocol="file://" apigeerepobasepath=/tmp/repos
Depo dizininin yolunu bu komuta eklediğinize dikkat edin.
- Yerel deponun bulunduğu düğümde, yerel depoyu
- Nginx web sunucusunu kullanarak Apigee-service yüklemek için:
- Nginx web sunucusunu, Install the Edge sınırlama-setup yardımcı programı bölümündeki "Nginx web sunucusunu kullanarak depodan yükleme" bölümünde açıklandığı şekilde yapılandırın.
- Uzak düğümde, Edge
bootstrap_4.19.01.sh
dosyasını/tmp/bootstrap_4.19.01.sh
hedefine indirin:/usr/bin/curl http://uName:pWord@remoteRepo:3939/bootstrap_4.19.01.sh -o /tmp/bootstrap_4.19.01.sh
Burada uName ve pWord, yukarıda depo için belirlediğiniz kullanıcı adı ve şifredir. remoteRepo ise depo düğümünün IP adresi veya DNS adıdır.
- Uzak düğümde Edge
apigee-service
yardımcı programını ve bağımlılıkları yükleyin:sudo bash /tmp/bootstrap_4.19.01.sh apigeerepohost=remoteRepo:3939 apigeeuser=uName apigeepassword=pWord apigeeprotocol=http://
uName ve pWord ise depo kullanıcı adı ve şifresidir.
apigee-setup
yardımcı programını güncellemek içinapigee-service
kullanın:/opt/apigee/apigee-service/bin/apigee-service apigee-setup update
- Güncelleme yardımcı programını Postgres düğümünüzde çalıştırın:
/opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
Burada configFile, Postgres veritabanını yüklemek için kullandığınız yapılandırma dosyasıdır. Yapılandırma dosyasındaki tek şart, yapılandırma dosyasının "Apigee" kullanıcısı tarafından erişilebilir veya okunabilmesidir.
- Portalı güncellemek için düğümünüzde güncelleme yardımcı programını çalıştırın:
/opt/apigee/apigee-setup/bin/update.sh -c dp -f configFile
Burada configFile, portalı yüklemek için kullandığınız yapılandırma dosyasıdır. Yapılandırma dosyasındaki tek şart, yapılandırma dosyasının "Apigee" kullanıcısı tarafından erişilebilir ve okunabilmesidir.
- Aşağıdaki URL'yi bir tarayıcı penceresinde açarak Drupal'ın
update.php
komut dosyasını çalıştırın:http://portal_IP_DNS:8079/update.php
- Bakım modunu devre dışı bırakma:
- Drupal menüsünde Yapılandırma'yı seçin.
- Yapılandırma sayfasında, Geliştirme bölümündeki Bakım modu'nu seçin.
- Siteyi bakım moduna geçir kutusunun işaretini kaldırın.
- Save configuration'ı (Yapılandırmayı kaydet) seçin.
Güncellemeden sonra kök dizinin şu özelliklere sahip olduğunu unutmayın:
/opt/apigee/apigee-drupal/wwwroot
Yükseltme işlemi tamamlandı. Apigee güncelleme yardımcı programı Drupal sürümünüzü düşürdüyse Drupal yükseltme yardımcı programını yeniden çalıştırmanız gerekebilir. Daha fazla bilgi için Drupal yükseltmesini yeniden çalıştırma bölümüne bakın.
Drupal'ı yeni sürüme geçirmeyi yeniden çalıştırma
Edge for Private Cloud'un Apigee güncelleme yardımcı programını çalıştırmak, Drupal sürümünüzün eski sürüme geçirilmesine neden oluyorsa Drupal yükseltmesini yeniden yükleyin. Private Cloud güncellemeleri arasında yalnızca Drupal'ı yükselttiyseniz bu durum söz konusu olabilir.
Örneğin:
- Drupal 7.59'u içeren Edge for Private Cloud sürümünü 4.18.05 sürümünü kullanıyordunuz.
- Gerekli bir güvenlik güncellemesi nedeniyle Drupal'ı 7.64 sürümüne yükselttiniz.
- Şu anda Private Cloud'u, Drupal 7.61'i de içeren 4.19.01 sürümüne yükseltiyorsunuz.
Bu örnekte görüldüğü gibi, Apigee güncelleme yardımcı programı tarafından kullanılan Drupal sürümü en son Drupal yükseltmesini referans almayabilir. Sonuç olarak, Drupal yüklemenizi sonraki sürüme döndürmek için Drupal yükseltmenizi yeniden çalıştırmanız gerekir.