Mengupgrade portal Layanan Developer

Portal Layanan Developer v. 4.17.05

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

Menentukan prosedur update yang benar

Prosedur yang Anda gunakan untuk memperbarui portal didasarkan pada penginstalan saat ini:

Menentukan jenis penginstalan saat ini

Jika tidak yakin dengan jenis penginstalan saat ini, gunakan perintah berikut untuk menentukannya:

  • 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 ada.
  • /opt/apigee/apigee-service/bin/apigee-all: status
    Jika menggunakan Nginx/Postgres, Anda akan melihat output berikut:

    + apigee-service apigee-drupal-devportal
    OK: apigee-drupal-devportal: OKapigee-drupal-dev portal     +service apigelbservice



  • apachectl -S
    Jika Anda menggunakan Apache/MySQL atau Apache/MariaDB, perintah ini akan menampilkan direktori utama web 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:

  • /opt/apigee/apigee-drupal (Nginx)
  • /var/www/html (Apache)

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

Jika tidak mengetahui direktori penginstalan, Anda dapat menentukannya seperti yang dijelaskan dalam Perintah Drush yang biasa digunakan.

Direktori penginstalan default baru setelah update Nginx/Postgres dari penginstalan 4.17.01 baru

Setelah mengupdate penginstalan baru 4.17.01 yang menggunakan Nginx/Postgres, direktori utama berubah dari:

/opt/apigee/apigee-drupal

menjadi:

/opt/apigee/apigee-drupal/wwwroot

Versi upgrade yang didukung

Prosedur upgrade ini didukung untuk versi portal berikut:

  • pantheon-14.02.x
  • pantheon-14.03.x
  • pantheon-14.04.x
  • pantheon-14.07.x
  • Pantheon-15-01.x
  • OPDK-15-04.x
  • OPDK-15-07.x
  • OPDK-16-01.x
  • OPDK-16-05.x
  • OPDK-16-09.x
  • OPDK-17-01.x

Untuk menentukan versi portal, buka URL berikut di browser:

http://yourportal.com/buildInfo

Sebelum memperbarui

Untuk penginstalan yang ada, jika Anda telah mengubah kode dalam inti Drupal atau dalam modul non-kustom, modifikasi tersebut akan ditimpa. Hal ini mencakup, antara lain, perubahan yang mungkin Anda lakukan pada .htaccess. Anda harus mengasumsikan bahwa apa pun di luar direktori /sites dimiliki oleh Drupal. Pengecualian untuk aturan ini adalah robots.txt; jika file ini ada di root web, file tersebut akan disimpan untuk Anda.

Sebelum melanjutkan penginstalan, cadangkan seluruh direktori root web Drupal Anda. Setelah melakukan langkah-langkah penginstalan yang dijelaskan di bawah, Anda dapat memulihkan penyesuaian dari cadangan.

Mengupgrade portal menggunakan file .tar

  1. Cadangkan instance Drupal MySQL/MariaDB Anda.
    Untuk informasi selengkapnya, lihat http://www.thegeekstuff.com/2008/09/backup-and-restore-mysql-database-using-mysqldump/
    1. Opsi 1: Menggunakan Drush

      Perintah Drush sql-dump akan membuat salinan database. Dari direktori Drupal Anda, /var/www/html secara default, jalankan perintah:
      > drush sql-dump > /path/to/backup_dir/database-backup.sql

      Gunakan drush help sql-dump untuk informasi selengkapnya.
    2. Opsi 2: Gunakan MySQLdump
      Gunakan perintah mysqldump untuk membuat salinan database:
      mysqldump -u USERNAME -p'PASSWORD' DATABASENAME > /path/to/backup_dir/database-backup.sql

      Seharusnya tidak ada spasi antara opsi -p dan sandi. Tanda kutip tunggal pada sandi diperlukan jika sandi berisi karakter khusus.

      Anda menetapkan USERNAME dan DATABASENAME saat menginstal portal. Secara default, keduanya adalah devportal.
  2. Buat cadangan seluruh direktori root web Drupal Anda. Lokasi penginstalan default adalah /var/www/html, tetapi Anda mungkin telah mengubahnya saat penginstalan.
  3. Download file DeveloperServices_x.y.z.tar Layanan Saluran Developer dari ftp.apigee.com, dengan x.y.z sesuai dengan nomor versi portal. Saat diminta, masukkan kredensial yang Anda terima dari Apigee.

    Anda dapat mendownload file dari link yang dikirimkan oleh Apigee di browser atau dengan menyalinnya, lalu menambahkannya ke perintah cURL berikut:
    > curl -kOL <paste link di sini>

    Catatan: Jika portal Anda ada di server tanpa koneksi internet eksternal, lakukan langkah ini di server yang memiliki akses.

    Buka Dukungan Apigee Edge dan pilih Login ke Portal Dukungan Anda untuk meminta file .tar upgrade Layanan Saluran Developer. Jika Anda tidak memiliki akun di Portal Dukungan, pilih Login to your Support Portal, lalu pilih In a hurry? di halaman login? Ajukan tiket dukungan di sini.
  4. Untuk upgrade pada server yang memiliki koneksi Internet:
    1. Ekstrak file upgrade portal:
      > tar -xvf <tar file>

      Ekstrak perintah ini membuat direktori baru bernama DeveloperServices-4.x.y.z.
    2. Ubah ke direktori DeveloperServices-4.x.y.z.
    3. Download versi Drupal terbaru menggunakan perintah berikut:
      > drush dl drupal

      Perintah ini akan membuat direktori bernama drupal-x.y, dengan x.y sesuai dengan versi Drupal saat ini.
    4. Jalankan skrip networked-update.sh:
      > ./networked-update.sh

      Bergantung pada izin file, Anda mungkin harus menggunakan sudo untuk menjalankan perintah ini, atau menjalankannya sebagai administrator.
    5. Untuk menerima notifikasi update Drupal, pastikan modul pengelola Update Drupal diaktifkan. Dari menu Drupal, pilih Modules dan scroll ke bawah ke modul Update manager. Jika tidak diaktifkan, aktifkan.

      Setelah diaktifkan, Anda dapat melihat pembaruan yang tersedia menggunakan item menu Laporan > Pembaruan yang Tersedia.

      Gunakan item menu Laporan > Update yang Tersedia > Setelan untuk mengonfigurasi modul agar dapat mengirimkan email kepada Anda jika update tersedia dan menetapkan frekuensi untuk pemeriksaan update.
  5. Untuk upgrade pada server tanpa koneksi Internet:
    1. Di server tempat Anda mendownload file DeveloperServices_x.y.z.tar Layanan Saluran Developer, ekstrak file upgrade portal:
      > tar -xvf <tar file>

      Ekstrak perintah ini akan membuat direktori baru bernama DeveloperServices-4.x.y.z.
    2. Ubah ke direktori DeveloperServices-4.x.y.z.
    3. Jalankan skrip non-networked-update.sh:
      > ./non-networked-update.sh

      Bergantung pada izin file, Anda mungkin harus menggunakan sudo untuk menjalankan perintah ini, atau menjalankannya sebagai administrator.

      Perintah ini mendownload semua file update yang diperlukan dan memaketkannya menjadi satu file bernama devportal-update.tgz dan menulis file tersebut ke lokasi yang Anda pilih.
    4. Salin devportal-update.tgz ke server target, yaitu server yang menjalankan portal.
      Catatan: Jangan menyalin devportal-update.tgz ke root web server target.
    5. Ekstrak file devportal-update.tgz ke direktori saat ini:
      > tar -xzf /path/to/devportal-update.tgz
    6. Ubah ke direktori developer-update.
    7. Jalankan perintah berikut untuk menginstal update:
      > ./install-update.sh
    8. Jawab petunjuknya.

Upgrade kini telah selesai.

Mengupgrade portal menggunakan RPM

Gunakan prosedur berikut untuk mengupdate RPM portal pada node:

  1. Ubah ke direktori Drupal, /opt/apigee/apigee-drupal secara default:
    > cd /opt/apigee/apigee-drupal
  2. Cadangkan instance database Drupal Anda. Perintah pg_dump membuat salinan database:

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

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

    Jika nantinya Anda harus memulihkan dari cadangan, gunakan perintah:
    pg_restore --clean --dbname=devportal --host=localhost --username=apigee < /tmp/portal.dmp
  3. Buat cadangan 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 entri Configuration > Media > File di menu Drupal untuk menentukan lokasi sistem file publik dan jalur sistem file pribadi (untuk langkah berikutnya).
  4. Buat cadangan file-nya di /opt/apigee/data/apigee-drupal-devportal/private.
  5. Nonaktifkan SELinux seperti yang dijelaskan dalam Menginstal utilitas penyiapan apigee Edge.
  6. Untuk upgrade pada server yang memiliki koneksi Internet:
    1. Download file bootstrap_4.17.05.sh Edge 4.17.05 ke /tmp/bootstrap_4.17.05.sh:
      > curl https://software.apigee.com/bootstrap_4.17.05.sh -o /tmp/bootstrap_4.17.05.sh
    2. Instal utilitas dan dependensi apigee-service Edge 4.17.05:
      > sudo bash /tmp/bootstrap_4.17.05.sh apigeeuser=uName apigeepassword=pWord

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

      Secara default, penginstal akan memeriksa apakah Anda telah menginstal Java 1.8. Anda dapat menggunakan opsi "C" untuk melanjutkan tanpa menginstal Java.
  7. Untuk upgrade pada server tanpa koneksi Internet:
    1. Buat repo 4.17.05 lokal seperti yang dijelaskan dalam "Membuat repositori Apigee lokal" di Menginstal utilitas penyiapan Edge apigee.
      Catatan: Jika sudah memiliki repo 4.17.01, Anda dapat menambahkan repo 4.17.05 ke dalamnya seperti yang dijelaskan dalam "Mengupdate repositori Apigee lokal" di Menginstal utilitas apigee-setup Edge.
    2. Untuk menginstal layanan apigee dari file .tar:
      1. Pada node dengan repo lokal, gunakan perintah berikut untuk memaketkan repo lokal menjadi satu file .tar dengan nama /opt/apigee/data/apigee-mirror/apigee-4.17.05.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.05.tar.gz

        Perintah ini akan membuat direktori baru, bernama repo, di direktori yang berisi file .tar. Misalnya, /tmp/repo.
      4. Instal utilitas dan dependensi apigee-service Edge dari /tmp/repos:
        > sudo bash /tmp/repos/bootstrap_4.17.05.sh apigeeprotocol="file://" apigeerepobasepath=/tmp/repos

        Perhatikan bahwa Anda menyertakan jalur ke direktori repositori dalam perintah ini.
    3. Untuk menginstal layanan apigee menggunakan server web Nginx:
      1. Konfigurasikan server web Nginx seperti yang dijelaskan dalam "Instal dari repo menggunakan server web Nginx" pada Menginstal utilitas apigee-setup Edge.
      2. Pada node jarak jauh, download file bootstrap_4.17.05.sh Edge ke /tmp/bootstrap_4.17.05.sh:
        > /usr/bin/curl http://uName:pWord@remoteRepo:3939/bootstrap_4.17.05.sh

      3. Pada node jarak jauh, instal utilitas dan dependensi apigee-service Edge:
        > sudo bash /tmp/bootstrap_4.17.05.sh apigeerepohost=remoteRepo:3939 apigeeuser=uName apigeepassword=pWord apigeepassword=pWord apigeeprotocol=
        http://password.
  8. Gunakan apigee-service untuk mengupdate utilitas apigee-setup:
    > /opt/apigee/apigee-service/bin/apigee-service apigee-setup update
  9. 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 database Postgres. Satu-satunya persyaratan pada file konfigurasi adalah file konfigurasi harus dapat diakses atau dibaca oleh pengguna "apigee".
  10. Mulai Postgres:
    > /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql start
  11. Jalankan utilitas update pada 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 file konfigurasi harus dapat diakses atau dibaca oleh pengguna "apigee".

Perhatikan, direktori {i>root<i} setelah pembaruan sekarang menjadi:

/opt/apigee/apigee-drupal/wwwroot

Upgrade kini telah selesai.