Mengupgrade portal Layanan Developer

Portal Layanan Developer v. 4.16.09

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

Direktori penginstalan default

Proses upgrade mengasumsikan bahwa Portal Developer diinstal di /var/www/html. 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.

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 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. 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: 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, dengan x.y.z sesuai dengan nomor versi portal.

    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 http://community.apigee.com/content/apigee-customer-support dan pilih Login to your Support Portal 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.