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

Geliştirici Hizmetleri Portalı v. 4.17.05

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:

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/../../ ve /opt/nginx.

    Apache/MySQL veya Apache/MariaDB kullanıyorsanız bu dizinler mevcut olmamalıdır.
  • /opt/../..//Apigee-service/bin/become-all status
    Nginx/Postgres kullanıyorsanız aşağıdaki çıkışı görürsünüz:

    + Apigee-service Apigee-drupal-devportal durumu
    OK: qwiklabs-drupal-devportal durumu
    Katıl: Apigee-drupal-devportal durumu up and running
    + dikkatli-service Apigee-service- Güneş Kompleksi

  • apachectl -S
    Apache/MySQL veya Apache/MariaDB kullanıyorsanız bu komut, portalın web kök dizinini şu biçimde döndürür:

    *: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:

  • /opt/apigee/apigee-drupal (Nginx)
  • /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.

Yükleme dizinini bilmiyorsanız bu dizini, Sık kullanılan Fırça komutları bölümünde açıklandığı şekilde belirleyebilirsiniz.

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

Nginx/Postgres kullanan yeni 4.17.01 yüklemesinin güncellenmesinden 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ü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. Bu, diğer şeylerin yanı sıra, .htaccess dosyasında yapmış olabileceğiniz değişiklikleri içerir. /sites dizini dışındaki her şeyin Drupal'a ait olduğunu varsaymanız gerekir. Bu kuralın bir istisnası robots.txt'dir. 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.

Portalı .tar dosyası kullanarak yeni sürüme geçirme

  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: Fırçayı kullanma

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

      Daha fazla bilgi için drush yardım sql-dump'ı 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' DATABASENAME > /path/to/backup_dir/database-backup.sql

      -p şifresi ile şifre arasında boşluk olmamalıdır. Şifrede özel karakterler varsa şifrenin başında ve sonunda tek tırnak bulunması gerekir.

      Portalı yüklerken KULLANICIADI ve DATABASENAME ayarlarını yaptınız. Varsayılan olarak her ikisi de geliştirici portalıdır.
  2. Drupal web kök dizininizin tamamını yedekleyin. Varsayılan yükleme konumu /var/www/html şeklindedir, ancak 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. Buradaki x.y.z, portal sürüm numarasına karşılık gelir. İstendiğinde Apigee'den aldığınız kimlik bilgilerini girin.

    Apigee tarafından size gönderilen bağlantıdan dosya indirebilir veya dosyayı kopyalayıp aşağıdaki cURL komutuna ekleyebilirsiniz:
    > curl -kOL <paste link here>

    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 Desteği'ne gidin ve Destek Portalınıza giriş yapın'ı seçerek Geliştirici Kanal Hizmetleri'nin yükseltme .tar dosyasını isteyin. Destek Portalı'nda hesabınız yoksa Destek Portalınıza giriş yapın'ı seçin, ardından oturum açma sayfasında Aceleniz mi var? Buradan bir destek kaydı oluşturun.
  4. İnternet bağlantısı olan bir sunucuda yükseltme işlemi için:
    1. Portal yükseltme dosyasını çıkarın:
      > tar -xvf <tar file>

      Bu komut ayıklama işlemi, DeveloperServices-4.x.y.z adında yeni bir dizin oluşturur.
    2. DeveloperServices-4.x.y.z dizinine geçin.
    3. Aşağıdaki komutu kullanarak Drupal'ın en son 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 Güncelleme yönetici modülünün etkinleştirildiğinden emin olun. Drupal menüsünden Modüller'i seçin ve sayfayı aşağı kaydırarak Güncelleme yöneticisi modülüne gidin. Etkin değilse etkinleştirin.

      Etkinleştirildikten sonra Raporlar > Kullanılabilir Güncellemeler menü öğesini kullanarak mevcut güncellemeleri görebilirsiniz.

      Modülü, güncellemeler olduğunda size e-posta gönderecek şekilde yapılandırmak ve güncellemeleri kontrol etme sıklığını ayarlamak için Raporlar > Kullanılabilir Güncellemeler > Ayarlar menü öğesini kullanın.
  5. İnternet bağlantısı olmayan bir sunucuda yükseltme işlemi için:
    1. Geliştirici Kanal Hizmetleri DeveloperServices_x.y.z.tar dosyasını indirdiğiniz sunucuda, portal yükseltme dosyasını çıkarı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, devportal-update.tgz adlı tek bir dosyada paketler ve dosyayı seçtiğiniz bir konuma yazar.
    4. devportal-update.tgz dosyasını, portalı çalıştıran hedef sunucuya kopyalayın.
      Not: devportal-update.tgz dosyasını hedef sunucunun web kök dizinine kopyalamayın.
    5. devportal-update.tgz dosyasını geçerli dizinde kaldırı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ı.

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:

  1. Drupal dizinini varsayılan olarak değiştirin, /opt/apigee/apigee-drupal varsayılan olarak:
    > cd /opt/../..//become-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ında PG_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ında DRUPAL_PG_USER özelliğinde belirtildiği şekilde, portal tarafından veri tabanına erişmek için kullanılan Postgres kullanıcı adını belirtir.
    • Portal yükleme yapılandırma dosyasında 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=teslim < /tmp/portal.dmp
  3. 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 özel dosya sistemi yolunun konumunu (sonraki adımda) belirlemek için Drupal menüsündeki drush durumu komutunu veya Yapılandırma > Medya > Dosya girişini kullanın.
  4. /opt/apigee/data/apigee-drupal-devportal/private içindeki dosyaların yedeğini oluşturun.
  5. SELinux'u Edge Apigee-setup yardımcı programını yükleme bölümünde açıklandığı şekilde devre dışı bırakın.
  6. İnternet bağlantısı olan bir sunucuda yükseltme işlemi için:
    1. Edge 4.17.05 bootstrap_4.17.05.sh dosyasını /tmp/bootstrap_4.17.05.sh konumuna indirin:
      > curl https://software.impression.com/bootstrap_4.17.05.sh -o /tmp/bootstrap_4.1.
    2. Edge 4.17.05 Apigee-service yardımcı programını ve bağımlılıkları yükleyin:
      > sudo bash /tmp/bootstrap_4.17.05.sh ../../user=uName Apigeepassword=uName


      uName, Apigee'den aldığınız kullanıcı adı ve şifredir. pWord'ü çıkarırsanız bunu girmeniz istenir.

      Yükleyici, Java 1.8'in yüklü olup olmadığını varsayılan olarak 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 işlemi 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ığı gibi yerel bir 4.17.05 deposu oluşturun.
      Not: Mevcut bir 4.17.01 deponuz varsa 4.17.05 kod deposunu Edge Apigee-setup yardımcı programını yükleme bölümündeki "Yerel Apigee deposu güncelleme" bölümünde açıklandığı şekilde ekleyebilirsiniz.
    2. .tar dosyasından Apigee-service'i yüklemek için:
      1. Yerel depo bulunan düğümde, yerel repo'yu /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/impression/impression-service/bin/become-service qwiklabs-mirror paketi
      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 /tmp dizinindeki dosyanın tarlamasını kaldırın:
        > tar -xzf Apigee-4.17.05.tar.gz

        Bu komut, .tar dosyasını içeren dizinde depolar 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'dan yükleyin:
        > sudo bash /tmp/repos/bootstrap_4.17.05.sh Apigeeprotocol="file://" Apigeerepobasepath=/tmp/repos

        Bu komuta repos dizininin yolunu eklediğinize dikkat edin.
    3. Nginx web sunucusunu kullanarak Apigee-service yüklemek için:
      1. 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.
      2. Uzak düğümde, bootstrap_4.17.05.sh dosyasının (/tmp/bootstrap_4.17.05.sh) şu şekilde ayarlandığı Edge bootstrap_4.17.05.sh düğümünün bootstrapWord veya repo
        düğümünü indirin:
        > /usr/bin/curl http://uName:pWord@remoteRepo:3939/boot_strap.0.4        :3939/bootstrap.0.4.
      3. Uzak düğümde Edge Apigee-service yardımcı programını ve bağımlıları yükleyin:
        > sudo bash /tmp/bootstrap_4.17.05.sh becomerepohost=remoteRepo:3939 Apigeeuser=remoteRepo Apigeepassword=remoteRepo ../../password=remoteRepo remoteRepo

  8. Apigee-setup yardımcı programını güncellemek için Apigee-service'i kullanın:
    > /opt/../..//../../-service/bin/Apigee-service Apigee-setup güncelleme
  9. Postgres veritabanını güncellemek için düğümünüzde güncelleme yardımcı programını çalıştırın:
    > /opt/../..//Apigee-setup/bin/update.sh -c ps -f configFile

    Buradaki 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.
  10. Postgres'i başlatın:
    > /opt/../..//impression-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/../..//become-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.

Güncellemeden sonra kök dizininin şu anda aşağıdaki gibi olduğunu unutmayın:

/opt/apigee/apigee-drupal/wwwroot

Yükseltme işlemi tamamlandı.