Mengupgrade portal Layanan Developer

Portal Layanan Developer v. 4.16.09

Prosedur ini menjelaskan cara mengupgrade penginstalan on-premise Layanan Saluran Developer Apigee yang ada.

Direktori penginstalan default

Proses upgrade mengasumsikan bahwa Developer Portal diinstal di /var/www/html. Jika Anda tidak menginstal portal di direktori default, ubah jalur dalam prosedur di bawah untuk menggunakan direktori penginstalan Anda.

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

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

Untuk menentukan versi portal, buka URL berikut di browser:

http://yourportal.com/buildInfo

Sebelum menginstal

Untuk penginstalan yang ada, jika Anda telah mengubah kode apa pun di inti Drupal atau dalam modul non-kustom, perubahan Anda akan ditimpa. Hal ini mencakup, antara lain, setiap 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 dipertahankan untuk Anda.

Sebelum melanjutkan penginstalan, buat cadangan seluruh direktori root web Drupal Anda. Lokasi penginstalan default adalah /var/www/html, tetapi Anda mungkin telah mengubahnya pada waktu penginstalan. Setelah melakukan langkah-langkah penginstalan yang dijelaskan di bawah, Anda dapat memulihkan penyesuaian dari cadangan.

Mengupgrade Layanan Saluran Developer Apigee ke rilis baru

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

      Perintah Drush sql-dump membuat salinan database. Dari direktori Drupal, /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: Menggunakan MySQLdump
      Gunakan perintah mysqldump untuk membuat salinan database:
      mysqldump -u USERNAME -p'PASSWORD' DATABASENAME > /path/to/backup_dir/database-backup.sql

      Tidak boleh ada spasi di antara opsi -p dan sandi. Tanda kutip tunggal di sekitar 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 pada waktu penginstalan.
  3. Download file Layanan Channel Developer DeveloperServices_x.y.z.tar, dengan x.y.z sesuai dengan nomor versi portal.

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

    Catatan: Jika portal Anda berada di server tanpa koneksi Internet eksternal, lakukan langkah ini di server dengan akses.

    Buka http://community.apigee.com/content/apigee-customer-support lalu pilih Login ke Portal Dukungan Anda untuk meminta file .tar upgrade Layanan Saluran Developer. Jika Anda tidak memiliki akun di Portal Dukungan, pilih Login ke Portal Dukungan, lalu di halaman login, pilih Terburu-buru? Ajukan tiket dukungan di sini.
  4. Untuk upgrade di server dengan koneksi Internet:
    1. 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. Download versi Drupal terbaru menggunakan perintah berikut:
      > drush dl drupal

      Perintah ini akan membuat direktori bernama drupal-x.y, di mana 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 belum aktif, aktifkan terlebih dahulu.

      Setelah diaktifkan, Anda dapat melihat update yang tersedia menggunakan item menu Laporan > Update yang Tersedia.

      Gunakan item menu Laporan > Update yang Tersedia > Setelan untuk mengonfigurasi modul agar mengirimkan email kepada Anda saat update tersedia dan menetapkan frekuensi pemeriksaan update.
  5. Untuk upgrade di 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 mengemasnya ke dalam satu file bernama devportal-update.tgz dan menulis file ke lokasi yang Anda pilih.
    4. Salin devportal-update.tgz ke server target, 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 perintah.

Upgrade kini telah selesai.