Mengupgrade portal Layanan Developer

Portal Layanan Developer v. 4.17.09

Prosedur ini menjelaskan cara mengupgrade Layanan Saluran Developer Apigee yang ada penginstalan lokal.

Menentukan prosedur update yang benar

Prosedur yang digunakan untuk mengupdate portal didasarkan pada penginstalan saat ini:

Menentukan jenis penginstalan Anda saat ini

Jika tidak yakin dengan jenis instalasi Anda saat ini, gunakan perintah berikut untuk menentukan hal tersebut:

  • ls /opt

    Jika menggunakan Nginx/Postgres, Anda akan melihat direktori berikut: /opt/apigee dan /opt/nginx.

    Jika Anda menggunakan Apache/MySQL atau Apache/MariaDB, direktori ini tidak boleh saat ini.

  • /opt/apigee/apigee-service/bin/apigee-all status

    Jika Anda menggunakan Nginx/Postgres, Anda akan melihat output berikut:

    + 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

    Jika Anda menggunakan Apache/MySQL atau Apache/MariaDB, perintah ini akan menampilkan server web direktori utama portal, dalam bentuk:

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

Direktori penginstalan default

Proses upgrade mengasumsikan bahwa Portal Developer diinstal di:

  • 4.17.05 dan yang lebih baru: /opt/apigee/apigee-drupal/wwwroot
  • Sebelum 4.17.05: /opt/apigee/apigee-drupal (Nginx) atau /var/www/html (Apache)

Jika Anda tidak menginstal portal di direktori default, ubah jalur dalam prosedur tersebut di bawah ini untuk menggunakan direktori penginstalan Anda.

Versi upgrade yang didukung

Prosedur upgrade ini didukung untuk versi portal berikut:

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

Untuk menentukan versi portal, buka URL berikut di browser:

http://your_portal.com/buildInfo

Sebelum mengupdate

Untuk penginstalan yang sudah ada, jika Anda telah mengubah kode di inti Drupal atau di lingkungan non-kustom , modifikasi Anda akan ditimpa. Hal ini mencakup, antara lain, setiap perubahan yang mungkin Anda lakukan pada .htaccess. Anda harus berasumsi bahwa apa pun di luar direktori /sites adalah milik Drupal. Channel pengecualian untuk aturan ini adalah robots.txt; apakah file ini ada di web {i>root<i}, nama itu akan dipertahankan untuk Anda.

Sebelum melanjutkan penginstalan, buat cadangan seluruh root web Drupal Anda saat ini. Setelah melakukan langkah penginstalan yang dijelaskan di bawah, Anda dapat memulihkan dan penyesuaian dari cadangan.

Mengupgrade portal menggunakan RPM

Gunakan prosedur berikut untuk memperbarui RPM portal pada node:

  1. Ubah ke direktori Drupal. Misalnya, /opt/apigee/apigee-drupal/wwwroot. 

    cd /opt/apigee/apigee-drupal/wwwroot

    Lihat Direktori penginstalan default untuk direktori default versi produk.

  2. Cadangkan instance database Drupal Anda. Perintah pg_dump membuat salinan basis data:
    pg_dump --dbname=devportal --host=192.168.56.101
  --username=drupaladmin --password --format=c > /tmp/portal.dmp

    dalam hal ini:

    • dbname menentukan nama database seperti yang ditetapkan oleh Properti PG_NAME di file konfigurasi penginstalan portal.
    • host menentukan alamat IP node portal.
    • username menentukan nama pengguna Postgres yang digunakan oleh portal untuk mengakses database seperti yang ditentukan oleh properti DRUPAL_PG_USER dalam file konfigurasi penginstalan portal.
    • Anda akan diminta untuk memasukkan sandi pengguna Postgres seperti yang ditentukan oleh DRUPAL_PG_PASS di file konfigurasi penginstalan portal.

    Jika nanti Anda harus memulihkan dari cadangan, gunakan perintah:

    pg_restore --clean --dbname=devportal --host=localhost  --username=apigee < /tmp/portal.dmp
  3. Cadangkan seluruh direktori root web Drupal Anda. Lokasi penginstalan default adalah /opt/apigee/apigee-drupal, tetapi Anda mungkin telah mengubahnya.
    Jika Anda tidak yakin dengan lokasi direktori ini, gunakan perintah drush status atau Konfigurasi > Media > Entri File di menu Drupal untuk menentukan lokasi sistem file publik dan jalur sistem file pribadi (untuk ).
  4. Cadangkan file di /opt/apigee/data/apigee-drupal-devportal/private.
  5. Siapkan Drupal ke mode pemeliharaan:
    1. Pilih Configuration di menu Drupal.
    2. Di halaman Configuration, pilih Pemeliharaan mode di bagian Pengembangan.
    3. Pilih kotak Masukkan situs ke mode pemeliharaan.
    4. Masukkan pesan yang akan dilihat pengguna selama pemeliharaan.
    5. Pilih Save configuration.
  6. Nonaktifkan SELinux seperti yang dijelaskan di Instal utilitas Edge apigee-setup.
  7. Ubah ke direktori /opt: 
    cd /opt
  8. Untuk upgrade di server dengan koneksi internet:
    1. Download file bootstrap_4.17.09.sh Edge 4.17.09 ke /tmp/bootstrap_4.17.09.sh: 
      curl https://software.apigee.com/bootstrap_4.17.09.sh -o /tmp/bootstrap_4.17.09.sh
    2. Instal utilitas dan dependensi apigee-service Edge 4.17.09: 
      sudo bash /tmp/bootstrap_4.17.09.sh apigeeuser=uName
  apigeepassword=pWord

      dengan uName:pWord adalah nama pengguna dan sandi yang Anda terima dari Apigee. Jika menghapus pWord, Anda akan diminta untuk memasukkannya.

      Secara default, penginstal akan memeriksa apakah Anda telah menginstal Java 1.8. Anda dapat menggunakan "C" untuk melanjutkan tanpa menginstal Java.

  9. Untuk upgrade di server tanpa koneksi Internet:
    1. Buat repo 4.17.09 lokal seperti yang dijelaskan dalam "Membuat repositori Apigee lokal" pada pukul Menginstal Edge utilitas apigee-setup.
    2. Untuk menginstal apigee-service dari file .tar:
      1. Pada node yang memiliki repositori lokal, gunakan perintah berikut untuk memaketkan repo menjadi satu file .tar bernama /opt/apigee/data/apigee-mirror/apigee-4.17.09.tar.gz: 
        /opt/apigee/apigee-service/bin/apigee-service apigee-mirror package
      2. Salin file .tar ke node tempat Anda ingin mengupdate Edge. Misalnya, salin ke direktori /tmp pada node baru.
      3. Pada node baru, untar file ke direktori /tmp:
        tar -xzf apigee-4.17.09.tar.gz

        Perintah ini membuat direktori baru, bernama {i>repos<i}, di direktori yang berisi file {i> .tar<i} . Misalnya, {i> /tmp/repos<i}.

      4. Instal utilitas apigee-service Edge dan dependensi dari /tmp/repos: 
        sudo bash /tmp/repos/bootstrap_4.17.09.sh apigeeprotocol="file://" apigeerepobasepath=/tmp/repos

        Perhatikan bahwa Anda menyertakan jalur ke direktori repos dalam perintah ini.

    3. Untuk menginstal apigee-service menggunakan server web Nginx:
      1. Konfigurasikan server web Nginx seperti yang dijelaskan di bagian "Instal dari repo menggunakan Server Web Nginx" di Menginstal Edge utilitas apigee-setup.
      2. Pada node jarak jauh, download file Edge bootstrap_4.17.09.sh untuk /tmp/bootstrap_4.17.09.sh: 
        /usr/bin/curl http://uName:pWord@remoteRepo:3939/bootstrap_4.17.09.sh
  -o /tmp/bootstrap_4.17.09.sh

        dengan uName:pWord adalah nama pengguna dan sandi yang Anda tetapkan di atas untuk repo, dan remoteRepo adalah alamat IP atau nama DNS ke node repo.

      3. Pada node jarak jauh, instal utilitas apigee-service Edge dan dependencies:code 
        sudo bash /tmp/bootstrap_4.17.09.sh apigeerepohost=remoteRepo:3939
  apigeeuser=uName apigeepassword=pWord apigeeprotocol=http://

        dengan uName:pWord adalah nama pengguna dan sandi repo.

  10. Gunakan apigee-service untuk mengupdate utilitas apigee-setup: 
    /opt/apigee/apigee-service/bin/apigee-service apigee-setup update
  11. Jalankan utilitas update pada node Anda untuk mengupdate database Postgres:
    /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile

    dengan configFile adalah file konfigurasi yang Anda gunakan untuk menginstal {i>database <i}Postgres. Satu-satunya persyaratan pada file konfigurasi adalah bahwa konfigurasi file harus dapat diakses atau dibaca oleh "apigee" .

  12. Mulai Postgres:
    /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql start
  13. Jalankan utilitas update di node Anda untuk mengupdate portal: 
    /opt/apigee/apigee-setup/bin/update.sh -c dp -f configFile

    dengan configFile adalah file konfigurasi yang Anda gunakan untuk menginstal portal. Satu-satunya persyaratan pada file konfigurasi adalah bahwa file konfigurasi harus dapat diakses atau dapat dibaca oleh "apigee" .

  14. Jalankan skrip update.php Drupal dengan membuka URL berikut di jendela browser: 
    http://portalIP_DNS:8079/update.php
  15. Menonaktifkan Drupal ke mode pemeliharaan:
    1. Pilih Configuration di menu Drupal.
    2. Di halaman Configuration, pilih Pemeliharaan mode di bagian Pengembangan.
    3. Batalkan pilihan kotak Masukkan situs ke mode pemeliharaan.
    4. Pilih Save configuration.

Perhatikan bahwa direktori utama setelah update adalah:

/opt/apigee/apigee-drupal/wwwroot

Upgrade kini telah selesai.