Portalı yükseltme

Edge for Private Cloud 4.18.05 sürümü

Bu prosedürde, şirket içindeki mevcut bir Apigee Developer Services portalının (veya portalın) nasıl yükseltileceği açıklanmaktadır. teşekkür ederiz.

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:

• Kurulumunuzda Nginx/Postgres kullanılıyorsa Aşağıdaki BGBG'leri kullanarak portalları yeni sürüme geçirme hakkında daha fazla bilgi edinin.
• Kurulumunuzda Apache/MySQL veya Apache/MariaDB kullanılıyorsa aşağıdaki adımları uygulayın: Bir tar tabanlı portala geçiş yapabilirsiniz.

Belirleniyor mevcut kurulum türünüz

Mevcut yükleme türünüzden emin değilseniz aşağıdaki komutu kullanarak şunları sağlar:

• 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 devam eder.

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

Yükseltme işlemi, portalın şu konuma yüklendiğini varsayar:

• 17.05 ve sonraki sürümler: /opt/apigee/apigee-drupal/wwwroot
• 17.05.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 prosedürü, portalın aşağıdaki sürümlerinde desteklenir:

• OPDK-17-01.x
• OPDK-17-05.x
• OPDK-17-09.x
• OPDK-18-01.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ünüzün tamamını yedekleyin dizin. Aşağıda açıklanan yükleme adımlarını gerçekleştirdikten sonra, özelleştirmeleri yapabilirsiniz.

BGBG'leri kullanarak portalları yeni sürüme geçirme

Bir düğümde portal BGBG'sini güncellemek için:

1. Drupal dizinine (/opt/apigee/apigee-drupal) şu şekilde geçin: varsayılan:

   cd /opt/apigee/apigee-drupal

2. Drupal veritabanı örneğinizi yedekleyin. pg_dump komutu, veritabanı:

   pg_dump --dbname=devportal --host=host_IP_address --username=drupaladmin
     --password --format=c > /tmp/portal.dmp

   Bu örnekte:

   • devportal PG_NAME mülkü ekleme.
   • host_IP_address, portal düğümünün IP adresidir.
   • drupaladmin, portala erişmek için portal tarafından kullanılan Postgres kullanıcı adıdır. portal kurulumundaki DRUPAL_PG_USER özelliği tarafından belirtilen veritabanı yapılandırma dosyası.
   • DRUPAL_PG_PASS özelliğini kullanmanız gerekir.

   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 drush status komutunu veya Yapılandırma > Medya > Drupal menüsündeki "Dosya" girişi herkese açık dosya sisteminin ve özel dosya sisteminin yolunun (sonraki adımı).

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 Bakım modu'nu 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 bir 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 yeni sürüme geçmek için:
   1. Edge 4.18.05 bootstrap_4.18.05.sh dosyasını indirin. /tmp/bootstrap_4.18.05.sh:

      curl https://software.apigee.com/bootstrap_4.18.05.sh -o /tmp/bootstrap_4.18.05.sh

   2. Edge 4.18.05 apigee-service yardımcı programını ve bağımlılıklarını yükleyin:

      sudo bash /tmp/bootstrap_4.18.05.sh apigeeuser=uName apigeepassword=pWord

      Burada uName ve pWord, aldığınız kullanıcı adı ve şifredir oluşturuyor. pWord öğesini atlarsanız bunu 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 kullanarak Java'yı yüklemeden devam edebilirsiniz.

9. İnternet bağlantısı olmayan bir sunucuda yeni sürüme geçmek için:
   1. Şurada açıklandığı gibi yerel bir 4.18.05 deposu oluşturun: Yerel bir Apigee deposu oluşturun.
   2. Apigee-service'yi .tar dosyasından yüklemek için:
      1. Yerel depo bulunan düğümde, yerel verileri paketlemek için aşağıdaki komutu kullanın: depo olarak ayarlayabilirsiniz. /opt/apigee/data/apigee-mirror/apigee-4.18.05.tar.gz:

         /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.05.tar.gz

         Bu komut, .tar dosyasını içeren dizinde depo adı verilen yeni bir dizin oluşturur dosyası olarak kaydedebilirsiniz. Örneğin, /tmp/repos.

      4. Edge apigee-service yardımcı programını ve bağımlılıklarını şuradan yükleyin: /tmp/repos:

         sudo bash /tmp/repos/bootstrap_4.18.05.sh apigeeprotocol="file://" apigeerepobasepath=/tmp/repos

         Depo dizininin yolunu bu komuta eklediğinize dikkat edin.

   3. Nginx web sunucusunu kullanarak Apigee-service'yi yüklemek için:
      1. Nginx web sunucusunu, " Nginx web sunucusu" Chrome'u yükleme Apigee-setup yardımcı programı ile ilgili daha fazla bilgi edinin.
      2. Uzak düğümde Edge bootstrap_4.18.05.sh dosyasını indirin. /tmp/bootstrap_4.18.05.sh:

         /usr/bin/curl http://uName:pWord@remoteRepo:3939/bootstrap_4.18.05.sh
           -o /tmp/bootstrap_4.18.05.sh

         Burada uName ve pWord, belirlediğiniz kullanıcı adı ve şifredir üstünü açar (remoteRepo kısmı da deponun IP adresi veya DNS adıdır) depo düğümüne bakın.

      3. Uzak düğümde Edge apigee-service yardımcı programını yükleyin ve ve bağımlılıkları vardır:

         sudo bash /tmp/bootstrap_4.18.05.sh apigeerepohost=remoteRepo:3939
           apigeeuser=uName apigeepassword=pWord apigeeprotocol=http://

         Burada uName ve 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üncelleme:

    /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://portal_IP_DNS:8079/update.php

15. Drupal'ı bakım moduna alma özelliğini devre dışı bırakın:
    1. Drupal menüsünde Yapılandırma'yı seçin.
    2. Yapılandırma sayfasında Bakım modu'nu seçin. Geliştirme bölümünde bulabilirsiniz.
    3. Siteyi bakım moduna sok 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ı.