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

Geliştirici Hizmetleri Portalı 4.17.09 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 kurulum türünüzü belirleme

Mevcut yükleme türünüzü bilmiyorsanız 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 bulunmamalı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 konuma yüklendiğini varsayar:

  • 4.17.05 ve sonraki sürümler: /opt/apigee/apigee-drupal/wwwroot
  • 4.17.05'ten önce: /opt/apigee/apigee-drupal (Nginx) veya /var/www/html (Apache)

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

Desteklenen yükseltme sürümleri

Bu yükseltme prosedürü, portalın aşağıdaki sürümlerinde desteklenir:

  • OPDK-17-01.x
  • OPDK-17-05.x

Portal sürümünüzü belirlemek için bir tarayıcıda aşağıdaki URL'yi açın:

http://your_portal.com/buildInfo

Güncellemeden önce

Mevcut kurulumlarda, Drupal çekirdeğinde veya özel olmayan modüllerde herhangi bir kodu değiştirdiyseniz değişikliklerinizin üzerine yazılır. Buna, .htaccess'te yapmış olabileceğiniz değişiklikler de dahildir. /sites dizininin dışındaki her şeyin Drupal'a ait olduğunu varsaymanız gerekir. Bu kuralın istisnası robots.txt dosyasıdır. Web kökünde bulunan bu dosya sizin için korunur.

Yüklemeye 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.

RPM'leri kullanarak portal yükseltme

Bir düğümdeki portal RPM'sini güncellemek için aşağıdaki prosedürü uygulayı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ında 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 değer, portal kurulum yapılandırma dosyasında DRUPAL_PG_USER mülkü tarafından belirtilir.
    • Portal kurulum yapılandırma dosyasında DRUPAL_PG_PASS mülkü tarafından tanımlandığı şekliyle 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ı yedekleyin. Varsayılan yükleme konumu /opt/apigee/apigee-drupal'dır ancak bunu değiştirmiş olabilirsiniz.
    Bu dizinin konumundan emin değilseniz herkese açık dosya sisteminin ve özel dosya sisteminin yolunu belirlemek için drush status komutunu veya Drupal menüsündeki Yapılandırma > Medya > Dosya girişini kullanın (sonraki adım için).
  4. /opt/apigee/data/apigee-drupal-devportal/private içindeki dosyaların yedeğini alın.
  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ünden Bakım modu'nu seçin.
    3. Siteyi bakım moduna al kutusunu işaretleyin.
    4. Kullanıcıların bakım sırasında gördüğü mesajı girin.
    5. Yapılandırmayı kaydet'i seçin.
  6. Edge apigee-setup yardımcı programını yükleme bölümünde açıklandığı şekilde SELinux'u devre dışı bırakın.
  7. /opt dizinine geçin: 
    cd /opt
  8. İnternet bağlantısı olan bir sunucuda yükseltme yapmak için:
    1. Edge 4.17.09 bootstrap_4.17.09.sh dosyasını şuraya indirin: /tmp/bootstrap_4.17.09.sh: 
      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 değerini atlarsanız 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.

  9. İnternet bağlantısı olmayan bir sunucuda yükseltme yapmak için:
    1. Edge'nin Apigee-setup yardımcı programını yükleme sayfasındaki "Yerel Apigee deposu oluşturma" bölümünde açıklandığı şekilde bir yerel 4.17.09 deposu oluşturun.
    2. apigee-service'i .tar dosyasından yüklemek için:
      1. Yerel deposunun bulunduğu düğümde, yerel deposu /opt/apigee/data/apigee-mirror/apigee-4.17.09.tar.gz adlı tek bir .tar dosyasında 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 dizininde aç:
        tar -xzf apigee-4.17.09.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ını /tmp/repos'den yükleyin: 
        sudo bash /tmp/repos/bootstrap_4.17.09.sh apigeeprotocol="file://" apigeerepobasepath=/tmp/repos

        Bu komuta repos dizininin yolunu eklediğinizi unutmayın.

    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 başlıklı makalenin "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'e indirin: 
        /usr/bin/curl http://uName:pWord@remoteRepo:3939/bootstrap_4.17.09.sh
  -o /tmp/bootstrap_4.17.09.sh

        Burada uName:pWord, yukarıda depo için belirlediğiniz kullanıcı adı ve şifredir ve remoteRepo, 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ını yükleyin:code 
        sudo bash /tmp/bootstrap_4.17.09.sh apigeerepohost=remoteRepo:3939
  apigeeuser=uName apigeepassword=pWord apigeeprotocol=http://

        Burada uName:pWord, deponun 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

    Burada configFile, Postgres veritabanını kurmak 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.

  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ıyla ilgili tek şart, yapılandırma dosyasının "apigee" kullanıcısı tarafından erişilebilir veya okunabilir olmasıdır.

  14. Aşağıdaki URL'yi tarayıcı penceresinde açarak Drupal'ın update.php komut dosyasını çalıştırın: 
    http://portalIP_DNS:8079/update.php
  15. Drupal'u bakım moduna alarak devre dışı bırakma:
    1. Drupal menüsünde Yapılandırma'yı seçin.
    2. Yapılandırma sayfasında Geliştirme bölümünde Bakım modu'nu seçin.
    3. Siteyi bakım moduna al kutusunun seçimini kaldırın.
    4. Yapılandırmayı kaydet'i seçin.

Güncellemeden sonraki kök dizinin şu özelliklere sahip olduğuna dikkat edin:

/opt/apigee/apigee-drupal/wwwroot

Yükseltme işlemi tamamlandı.