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

Private Cloud için Edge v4.18.01

Bu prosedürde, mevcut Apigee Geliştirici Kanal Hizmetleri'nin nasıl yükseltileceği açıklanmaktadır. şirket içi kurulum.

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:

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 gösterir.

  • /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, web portalın kök dizini şu şekilde görünür:

    *:80
192.168.56.102 (/etc/httpd/conf/vhosts/devportal.conf:1)

Varsayılan yükleme dizini

Yeni sürüme geçme işlemi, Geliştirici Portalı'nın şurada yüklendiğini varsayar:

  • 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)

Varsayılan dizine portalı yüklemediyseniz prosedürdeki yolları değiştirin yükleme dizininizi kullanmak için aşağıdaki adımları uygulayın.

Desteklenen yükseltme sürümleri

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

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

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

http://yourportal.com/buildInfo

Güncellemeden önce

Mevcut yüklemeler için, Drupal Core'da veya özel olmayan herhangi bir üzerinde değişiklik yaptığınızda, yaptığınız değişikliklerin üzerine yazılacak. Bu, diğer hususların yanı sıra, müşteri dönüşümü .htaccess için yapmış olabileceğiniz yorumlar. /sites dizini dışındaki her şeyin Drupal'a ait olduğunu varsaymanız gerekir. bu kuralın istisnası şudur: robots.txt; Bu dosya web kök dizininde mevcutsa sizin için saklanır.

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

RPM'leri kullanarak portal yükseltme

Bir düğümdeki portal RPM'sini güncellemek için:

  1. Varsayılan olarak Drupal dizine /opt/apigee/apigee-drupal değiştirin: 
    cd /opt/apigee/apigee-drupal
  2. Drupal veritabanı örneğinizi yedekleyin. pg_dump komutu, veritabanı: 
    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üyle 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, ancak bu değeri değiştirmiş olabilirsiniz.

    Bu dizinin konumundan emin değilseniz herkese açık dosya sisteminin ve özel dosya sisteminin yolunu (sonraki adım için) belirlemek üzere 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 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 Bakım'ı seçin Geliştirme bölümünde bulabilirsiniz.
    3. Siteyi bakım moduna sok kutusunu seçin.
    4. Kullanıcıların bakım sırasında göreceği mesajı girin.
    5. Yapılandırmayı kaydet'i seçin.
  6. SELinux'u şurada açıklandığı şekilde devre dışı bırakın: Edge Apigee-setup yardımcı programını yükleyin.
  7. /opt dizinine geçin: 
    > cd /opt
  8. İnternet bağlantısı olan bir sunucuda yükseltme yapmak için:
    1. Edge 4.18.01 bootstrap_4.18.01.sh dosyasını şuraya indirin: /tmp/bootstrap_4.18.01.sh: 
      curl https://software.apigee.com/bootstrap_4.18.01.sh -o /tmp/bootstrap_4.18.01.sh
    2. Edge 4.18.01 apigee-service yardımcı programını ve bağımlılıklarını yükleyin: 
      sudo bash /tmp/bootstrap_4.18.01.sh apigeeuser=uName apigeepassword=pWord

      Burada uName:pWord, Apigee'den aldığınız kullanıcı adı ve şifredir. pWord öğesini atlarsanız girmeniz istenir.

      Yükleyici varsayılan olarak Java 1.8'in yüklü olup olmadığını kontrol eder. URL parametrelerinin Google tarafından nasıl ele alınmasını istediğinizi belirtmek için "C" seçeneğini kullanabilirsiniz.

  9. İnternet bağlantısı olmayan bir sunucuda yeni sürüme geçmek için:
    1. "Yerel Apigee deposu oluşturma" bölümünde açıklandığı şekilde yerel bir 4.18.01 deposu oluşturun. ile Edge'yi yükleme Apigee-setup yardımcı programı ile ilgili daha fazla bilgi edinin.
    2. Apigee-service'yi .tar dosyasından yüklemek için:
      1. Yerel deposunun bulunduğu düğümde, yerel deposu /opt/apigee/data/apigee-mirror/apigee-4.18.01.tar.gz adlı tek bir .tar dosyasına 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, bunu kopyalayın. yeni düğümdeki /tmp dizinine.
      3. Yeni düğümde dosyayı /tmp dizinine kaldırın: 
        tar -xzf apigee-4.18.01.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'ten yükleyin: 
        sudo bash /tmp/repos/bootstrap_4.18.01.sh apigeeprotocol="file://" apigeerepobasepath=/tmp/repos

        Depo dizininin yolunu bu komuta 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 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.18.01.sh dosyasını indirin. /tmp/bootstrap_4.18.01.sh: 
        /usr/bin/curl http://uName:pWord@remoteRepo:3939/bootstrap_4.18.01.sh
  -o /tmp/bootstrap_4.18.01.sh

        burada uName:pWord, yukarıda ayarladığınız kullanıcı adı ve şifredir remoteRepo ise deponun IP adresi veya DNS adıdır. depo düğümünü oluşturuyorum.

      3. Uzak düğümde Edge apigee-service yardımcı programını yükleyin ve dependencies: 
        sudo bash /tmp/bootstrap_4.18.01.sh apigeerepohost=remoteRepo:3939
    apigeeuser=uName apigeepassword=pWord apigeeprotocol=http://

        Burada 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. Postgre 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, yüklemek için kullandığınız yapılandırma dosyasıdır arasında yer alır. Yapılandırma dosyasındaki tek gereksinim, yapılandırmanın dosya, "Apigee" tarafından erişilebilir veya okunaklı olmalıdır belirtir.

  12. Postgres veritabanını güncelleyin: 
    /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql db_upgrade
  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, yüklemek için kullandığınız yapılandırma dosyasıdır portala giriş yapıyoruz. Yapılandırma dosyasındaki tek gereksinim, yapılandırma dosyasının "Apigee" tarafından erişilebilir veya okunaklı olmalıdır belirtir.

  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'ı bakım moduna 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ü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ı.