Geliştirici Hizmetleri portalını yeni sürüme geçirme

Developer Services Portal 4.17.05 sürümü

Bu prosedürde, mevcut bir Apigee Developer Channel Services ş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 kullandığınız prosedür, mevcut kurulumunuza bağlıdır:

Mevcut yükleme türünüzü belirleme

Mevcut 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ürmelidir:

    *: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 şu konumda yüklü olduğunu varsayar:

  • /opt/apigee/apigee-drupal (Nginx)
  • /var/www/html (Apache)

Portalı varsayılan dizine yüklemediyseniz aşağıdaki prosedürde yer alan yolları, yükleme dizininizi kullanacak şekilde değiştirin.

Yükleme dizinini bilmiyorsanız Yaygın olarak kullanılan Drush komutları bölümünde açıklandığı şekilde belirleyebilirsiniz.

Yeni bir 4.17.01 yüklemesinden Nginx/Postgres güncellemesinden sonraki yeni varsayılan yükleme dizini

Nginx/Postgres kullanan yeni bir 4.17.01 yüklemesini güncelledikten sonra kök dizin şu şekilde değişti:

/opt/apigee/apigee-drupal

karşılaştırma yapılacak öğe:

/opt/apigee/apigee-drupal/wwwroot

Desteklenen yükseltme sürümleri

Bu yükseltme prosedürü, portalın aşağıdaki sürümleri için desteklenir:

  • pantheon-14.02.x
  • pantheon-14.03.x
  • pantheon-14.04.x
  • pantheon-14.07.x
  • pantheon-15-01.x
  • OPDK-15-04.x
  • OPDK-15-07.x
  • OPDK-16-01.x
  • OPDK-16-05.x
  • OPDK-16-09.x
  • OPDK-17-01.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üklemelerde, Drupal çekirdeğindeki veya özel olmayan modüllerdeki herhangi bir kodu değiştirdiyseniz değişikliklerinizin üzerine yazılır. Buna, .htaccess dosyasında yapmış olabileceğiniz değişiklikler de dahildir. /sites dizini dışındaki her şeyin Drupal'a ait olduğunu varsaymanız gerekir. Bu kuralın istisnası robots.txt dosyasıdır. Web kök dizininde bu dosya varsa 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ı uyguladıktan sonra özelleştirmelerinizi yedekten geri yükleyebilirsiniz.

.tar dosyası kullanarak portalı yükseltme

  1. Drupal MySQL/MariaDB örneğinizi yedekleyin.
    Daha fazla bilgi için http://www.thegeekstuff.com/2008/09/backup-and-restore-mysql-database-using-mysqldump/ adresini ziyaret edin.
    1. 1. seçenek: Drush kullanma

      Drush komutu sql-dump, veritabanının bir kopyasını oluşturur. Drupal dizininizden (varsayılan olarak /var/www/html) şu komutu çalıştırın:
      > drush sql-dump > /path/to/backup_dir/database-backup.sql

      Daha fazla bilgi için drush help sql-dump komutunu kullanın.
    2. 2. seçenek: MySQLdump kullanın
      Veritabanının bir kopyasını oluşturmak için mysqldump komutunu kullanın:
      mysqldump -u KULLANICIADI -p'ŞİFRE' VERİTABANIADI > /path/to/backup_dir/database-backup.sql

      -p seçeneği ile şifre arasında boşluk olmamalıdır. Şifre özel karakterler içeriyorsa şifrenin tek tırnak içine alınması gerekir.

      USERNAME ve DATABASENAME değerlerini portalı yüklerken ayarlarsınız. Varsayılan olarak her ikisi de devportal'dır.
  2. Drupal web kök dizininizin tamamının yedeğini alın. Varsayılan yükleme konumu /var/www/html olsa da yükleme sırasında bu konumu değiştirmiş olabilirsiniz.
  3. ftp.apigee.com adresinden Geliştirici Kanalı Hizmetleri DeveloperServices_x.y.z.tar dosyasını indirin. x.y.z, portal sürüm numarasını temsil eder. İstendiğinde Apigee'den aldığınız kimlik bilgilerini girin.

    Apigee tarafından size gönderilen bağlantıdaki dosyayı bir tarayıcıda indirebilir veya bağlantıyı kopyalayıp aşağıdaki cURL komutuna ekleyebilirsiniz:
    > curl -kOL <bağlantıyı buraya yapıştırın>

    Not: Portalınız harici internet bağlantısı olmayan bir sunucudaysa bu adımı erişimi olan bir sunucuda gerçekleştirin.

    Apigee Edge Destek sayfasına gidin ve Geliştirici Kanalı Hizmetleri yükseltme .tar dosyasını istemek için Destek Portalı'na giriş yapın'ı seçin. Destek Portalı'nda hesabınız yoksa Destek Portalı'na giriş yapın'ı seçin ve ardından oturum açma sayfasında Aceleniz mi var? Buradan destek kaydı oluşturabilirsiniz.
  4. İnternet bağlantısı olan bir sunucuda yükseltme yapmak için:
    1. Portal yükseltme dosyasını ayıklayın:
      > tar -xvf <tar file>

      Bu komut ayıklama işlemi, DeveloperServices-4.x.y.z adlı yeni bir dizin oluşturur.
    2. DeveloperServices-4.x.y.z dizinine geçin.
    3. Aşağıdaki komutu kullanarak en son Drupal sürümünü indirin:
      > drush dl drupal

      Bu komut, drupal-x.y adında bir dizin oluşturur. Burada x.y, Drupal'ın mevcut sürümüne karşılık gelir.
    4. networked-update.sh komut dosyasını çalıştırın:
      > ./networked-update.sh

      Dosya izinlerine bağlı olarak, bu komutu çalıştırmak için sudo kullanmanız veya yönetici olarak çalıştırmanız gerekebilir.
    5. Drupal güncellemeleriyle ilgili bildirim almak için Drupal Update Manager modülünün etkinleştirildiğinden emin olun. Drupal menüsünden Modules'ü (Modüller) seçin ve Update manager (Güncelleme yöneticisi) modülüne gidin. Etkinleştirilmemişse etkinleştirin.

      Etkinleştirildikten sonra, Raporlar > Mevcut Güncellemeler menü öğesini kullanarak mevcut güncellemeleri görebilirsiniz.

      Modülü, güncellemeler kullanıma sunulduğunda size e-posta gönderecek ve güncellemeleri kontrol etme sıklığını ayarlayacak şekilde yapılandırmak için Raporlar > Kullanılabilir Güncellemeler > Ayarlar menü öğesini kullanın.
  5. İnternet bağlantısı olmayan bir sunucuda yükseltme yapmak için:
    1. Geliştirici Kanalı Hizmetleri DeveloperServices_x.y.z.tar dosyasını indirdiğiniz sunucuda portal yükseltme dosyasını ayıklayın:
      > tar -xvf <tar file>

      Bu komut ayıklama işlemi, DeveloperServices-4.x.y.z adlı yeni bir dizin oluşturur.
    2. DeveloperServices-4.x.y.z dizinine geçin.
    3. non-networked-update.sh komut dosyasını çalıştırın:
      > ./non-networked-update.sh

      Dosya izinlerine bağlı olarak, bu komutu çalıştırmak için sudo kullanmanız veya yönetici olarak çalıştırmanız gerekebilir.

      Bu komut, gerekli tüm güncelleme dosyalarını indirir ve bunları devportal-update.tgz adlı tek bir dosyada paketler ve dosyayı seçtiğiniz bir konuma yazar.
    4. devportal-update.tgz dosyasını hedef sunucuya (portalı çalıştıran sunucu) kopyalayın.
      Not: devportal-update.tgz dosyasını hedef sunucunun web köküne kopyalamayın.
    5. devportal-update.tgz dosyasını geçerli dizine açın:
      > tar -xzf /path/to/devportal-update.tgz
    6. developer-update dizinine geçin.
    7. Güncellemeyi yüklemek için aşağıdaki komutu çalıştırın:
      > ./install-update.sh
    8. İstemleri yanıtlayın.

Yükseltme işlemi tamamlandı.

RPM'leri kullanarak portalı yükseltme

Bir düğümdeki portal RPM'sini güncellemek için aşağıdaki prosedürü kullanın:

  1. Varsayılan olarak Drupal dizinine (/opt/apigee/apigee-drupal) geçin:
    > cd /opt/apigee/apigee-drupal
  2. 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

    Burada:
    • dbname, portal yükleme yapılandırma dosyasındaki PG_NAME özelliği tarafından belirtilen veritabanı adını belirtir.
    • host, portal düğümünün IP adresini belirtir.
    • username, portalın veritabanına erişmek için kullandığı Postgres kullanıcı adını belirtir. Bu ad, portal yükleme yapılandırma dosyasındaki DRUPAL_PG_USER mülkü tarafından belirtilir.
    • Portal yükleme yapılandırma dosyasındaki DRUPAL_PG_PASS özelliği tarafından tanımlanan Postgres kullanıcı şifresi istenir.

    Daha sonra yedekten geri yüklemeniz gerekirse şu komutu kullanın:
    pg_restore --clean --dbname=devportal --host=localhost --username=apigee < /tmp/portal.dmp
  3. Drupal web kök dizininizin tamamının yedeğini alın. Varsayılan yükleme konumu /opt/apigee/apigee-drupal olsa da bunu değiştirmiş olabilirsiniz.

    Bu dizinin konumundan emin değilseniz herkese açık dosya sisteminin ve özel dosya sistemi yolunun konumunu belirlemek için (sonraki adımda) drush status komutunu veya Drupal menüsündeki Configuration > Media > File (Yapılandırma > Medya > Dosya) girişini kullanın.
  4. /opt/apigee/data/apigee-drupal-devportal/private dizinindeki dosyaların yedeğini alın.
  5. Edge apigee-setup yardımcı programını yükleme bölümünde açıklandığı şekilde SELinux'u devre dışı bırakın.
  6. İnternet bağlantısı olan bir sunucuda yükseltme yapmak için:
    1. Edge 4.17.05 bootstrap_4.17.05.sh dosyasını /tmp/bootstrap_4.17.05.sh dizinine indirin:
      > curl https://software.apigee.com/bootstrap_4.17.05.sh -o /tmp/bootstrap_4.17.05.sh
    2. Edge 4.17.05 apigee-service yardımcı programını ve bağımlılıklarını yükleyin:
      > sudo bash /tmp/bootstrap_4.17.05.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. Java'yı yüklemeden devam etmek için "C" seçeneğini kullanabilirsiniz.
  7. İnternet bağlantısı olmayan bir sunucuda yükseltme yapmak için:
    1. Edge apigee-setup yardımcı programını yükleme bölümündeki "Yerel Apigee deposu oluşturma" bölümünde açıklandığı şekilde yerel bir 4.17.05 deposu oluşturun.
      Not: Mevcut bir 4.17.01 deponuz varsa 4.17.05 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.
    2. apigee-service'i bir .tar dosyasından yüklemek için:
      1. Yerel depoya sahip düğümde, yerel depoyu /opt/apigee/data/apigee-mirror/apigee-4.17.05.tar.gz adlı tek bir.tar dosyası halinde paketlemek için aşağıdaki komutu kullanın:
        > /opt/apigee/apigee-service/bin/apigee-service apigee-mirror package
      2. .tar dosyasını Edge'i güncellemek istediğiniz düğüme kopyalayın. Örneğin, yeni düğümdeki /tmp dizinine kopyalayın.
      3. Yeni düğümde, dosyayı /tmp dizinine açın:
        > tar -xzf apigee-4.17.05.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ı /tmp/repos dizininden yükleyin:
        > sudo bash /tmp/repos/bootstrap_4.17.05.sh apigeeprotocol="file://" apigeerepobasepath=/tmp/repos

        Bu komutta repos dizininin yolunu eklediğinize dikkat edin.
    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 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.17.05.sh dosyasını /tmp/bootstrap_4.17.05.sh dizinine indirin:
        > /usr/bin/curl http://uName:pWord@remoteRepo:3939/bootstrap_4.17.05.sh -o /tmp/bootstrap_4.17.05.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.
      3. Uzak düğümde Edge apigee-service yardımcı programını ve bağımlılıkları yükleyin:
        > sudo bash /tmp/bootstrap_4.17.05.sh apigeerepohost=remoteRepo:3939 apigeeuser=uName apigeepassword=pWord apigeeprotocol=http://

        Burada uName:pWord, depo kullanıcı adı ve şifresidir.
  8. apigee-setup yardımcı programını güncellemek için apigee-service'i kullanın:
    > /opt/apigee/apigee-service/bin/apigee-service apigee-setup update
  9. 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

    Burada configFile, Postgres veritabanını yüklemek için kullandığınız yapılandırma dosyasıdır. 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.
  10. Postgres'i başlatın:
    > /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql start
  11. 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ıyla ilgili tek şart, yapılandırma dosyasının "apigee" kullanıcısı tarafından erişilebilir veya okunabilir olmasıdır.

Güncellemeden sonra kök dizinin artık şu şekilde olduğunu unutmayın:

/opt/apigee/apigee-drupal/wwwroot

Yükseltme işlemi tamamlandı.