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

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:

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:

  1. 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.

  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

    Bu örnekte:

    • 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 yükleme yapılandırma dosyasındaki DRUPAL_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
  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 konumunu ve özel dosya sistemi yolunu (sonraki adımda) belirlemek için drush status komutunu veya Drupal menüsündeki Yapılandırma > Medya > Dosya girişini kullanın.
  4. /opt/apigee/data/apigee-drupal-devportal/private klasöründeki dosyaları yedekleyin.
  5. Drupal'ı bakım moduna ayarlayın:
    1. Drupal menüsünde Yapılandırma'yı seçin.
    2. Yapılandırma sayfasında, Geliştirme bölümündeki Bakım modu'nu seçin.
    3. Siteyi bakım moduna geçir kutusunu seçin.
    4. Kullanıcılara bakım sırasında gösterilecek bir mesaj girin.
    5. Save configuration'ı (Yapılandırmayı kaydet) seçin.
  6. SELinux'u Edge Apigee-setup yardımcı programını yükleme bölümünde açıklandığı şekilde devre dışı bırakın.
  7. /opt dizinine geçin:
    cd /opt
  8. İnternet bağlantısı olan bir sunucuda yükseltme işlemi için:
    1. 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
    2. 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.

  9. İ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.09 deposu oluşturun.
    2. .tar dosyasından Apigee-service'i yüklemek için:
      1. 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
      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, 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.

      4. 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.

    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, 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.

      3. 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ükleyin

        uName:pWord, depo kullanıcı adı ve şifresidir.

  10. apigee-setup yardımcı programını güncellemek için apigee-service kullanın:
    /opt/apigee/apigee-service/bin/apigee-service apigee-setup update
  11. 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.

  12. Postgres'i başlatın:
    /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql start
  13. 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.

  14. 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
  15. Drupal'dan bakım modunu devre dışı bırakın:
    1. Drupal menüsünde Yapılandırma'yı seçin.
    2. Yapılandırma sayfasında, Geliştirme bölümündeki Bakım modu'nu seçin.
    3. Siteyi bakım moduna geçir kutusunun işaretini kaldırın.
    4. 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ı.