Geliştirici Hizmetleri Portalı v. 4.17.09
Bu prosedürde, mevcut bir Apigee Geliştirici Kanal Hizmetleri ş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ükleme işleminizde 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.
Geçerli yükleme türünüzü belirleme
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, Geliştirici Portalı'nın şurada 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
Portal sürümünüzü belirlemek için aşağıdaki URL'yi bir tarayıcıda açın:
http://your_portal.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. robots.txt
bu kuralın bir istisnası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 portalı yeni sürüme geçirme
Bir düğümdeki portal BGBG'sini güncellemek için aşağıdaki prosedürü kullanın:
-
Drupal dizinine geçin. Örneğin,
/opt/apigee/apigee-drupal/wwwroot
.cd /opt/apigee/apigee-drupal/wwwroot
Ürün sürümünüzün varsayılan dizini için Varsayılan yükleme dizini bölümüne bakın.
- Drupal veritabanı örneğinizi yedekleyin.
pg_dump
komutu, veritabanının bir kopyasını oluşturur:
pg_dump --dbname=devportal --host=192.168.56.101 --username=drupaladmin --password --format=c > /tmp/portal.dmp
Bu örnekte:
dbname
, portal yükleme yapılandırma dosyasındakiPG_NAME
özelliği tarafından belirtilen veritabanı adını belirtir.host
, portal düğümünün IP adresini belirtir.username
, portal yükleme yapılandırma dosyasındakiDRUPAL_PG_USER
özelliğinde belirtilen şekilde, portal tarafından veritabanına erişmek için kullanılan Postgres kullanıcı adını belirtir.- 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üklemeniz gerekirse şu komutu kullanın:
pg_restore --clean --dbname=devportal --host=localhost --username=apigee < /tmp/portal.dmp
- 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 konumunu ve özel dosya sistemi yolunu (sonraki adımda) belirlemek içindrush 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.17.09
bootstrap_4.17.09.sh
dosyasını/tmp/bootstrap_4.17.09.sh
hedefine indirin:curl https://software.apigee.com/bootstrap_4.17.09.sh -o /tmp/bootstrap_4.17.09.sh
- Edge 4.17.09
apigee-service
yardımcı programını ve bağımlılıklarını yükleyin:sudo bash /tmp/bootstrap_4.17.09.sh apigeeuser=uName apigeepassword=pWord
Burada uName: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.17.09
-
İnternet bağlantısı olmayan bir sunucuda yükseltme işlemi için:
- Edge Apigee-setup yardımcı programını yükleme bölümündeki "Yerel Apigee deposu oluşturma" bölümünde açıklandığı gibi yerel bir 4.17.09 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.17.09.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, yeni düğümdeki /tmp dizinine kopyalayın.
- Yeni düğümde, dosyanın /tmp dizinindeki tarlamasını kaldırın:
tar -xzf apigee-4.17.09.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 bağımlılıkları/tmp/repos
üzerinden yükleyin:sudo bash /tmp/repos/bootstrap_4.17.09.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.17.09.sh
dosyasını/tmp/bootstrap_4.17.09.sh
hedefine indirin:/usr/bin/curl http://uName:pWord@remoteRepo:3939/bootstrap_4.17.09.sh -o /tmp/bootstrap_4.17.09.sh
Burada uName:pWord, depo için yukarıda belirlediğiniz kullanıcı adı ve şifre, 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ı.kodu (sudo bash /tmp/bootstrap_4.17.09.sh apigeerepohost=remoteRepo:3939 apigeeuser=uName apigeepassword=pWord apigeeprotocol=http://
) yükleyinuName:pWord, 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
- Postgres veritabanını 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 ps -f configFile
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.
- Postgres'i başlatın:
/opt/apigee/apigee-service/bin/apigee-service apigee-postgresql start
- 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://portalIP_DNS:8079/update.php
- Drupal'dan bakım modunu devre dışı bırakı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 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ı.