Upgrade Drupal

Edge for Private Cloud v4.18.05

Dalam penginstalan Edge for Private Cloud di portal Layanan Developer Apigee (atau, portal), Anda mungkin mendapatkan pemberitahuan bahwa Drupal versi baru tersedia. Versi baru dapat berarti rilis fitur Drupal, patch, update keamanan, atau jenis update Drupal lainnya. Jika ada update keamanan, sebaiknya upgrade penginstalan Drupal sesegera mungkin untuk memastikan situs Anda tetap aman.

Prosedur di bawah menjelaskan cara mengupdate penginstalan Drupal 7.x.y di Private Cloud ke versi minor lainnya (misalnya Drupal 7.54 ke 7.56).

Harap perhatikan hal berikut:

  • Prosedur ini hanya mengupdate penginstalan Drupal Anda. Tindakan ini tidak akan mengupdate software Apigee yang dikirimkan sebagai bagian dari portal. Untuk informasi tentang cara mengupgrade software portal Apigee, lihat Mengupgrade portal.

  • Anda harus menjalankan perintah Drush dari direktori utama situs portal. Secara default, portal diinstal di:
    • /opt/apigee/apigee-drupal/wwwroot (Nginx)
    • /var/www/html (Apache)
    Prosedur di bawah mengasumsikan penginstalan server Nginx di lokasi default di atas.

Menentukan versi Drupal saat ini

Sebelum memulai update Drupal, Anda dapat menentukan versi Drupal saat ini dengan menjalankan perintah berikut dari folder penginstalan Drupal. Secara default, Drupal diinstal di /opt/apigee/apigee-drupal/wwwroot:

cd /opt/apigee/apigee-drupal/wwwroot
drush status | grep 'Drupal version'

Anda akan melihat output dalam bentuk:

Drupal version          :  7.54

Jika Anda menginstal Drupal di direktori selain /opt/apigee/apigee-drupal/wwwroot, pastikan untuk beralih ke direktori tersebut sebelum menjalankan perintah drush.

Mengupdate versi Drupal

Bagian ini menjelaskan cara menggunakan Drush (Drupal Shell) dari command line untuk mengupdate versi Drupal Anda. Lihat juga, Memperbarui Drupal Menggunakan Drush dalam dokumentasi Drupal.

Untuk mengupdate penginstalan Drupal:

  1. Ubah ke direktori /opt/apigee/apigee-drupal/wwwroot, atau direktori tempat Anda menginstal portal.
  2. Buat cadangan penuh semua file, direktori, dan database. Simpan cadangan di lokasi di luar penginstalan Drupal. Untuk mengetahui petunjuk lengkapnya, lihat Mencadangkan portal.

    Jika Anda melakukan perubahan pada file seperti .htaccess, robots.txt, atau defaults.settings.php (di direktori sites), Anda harus menerapkan kembali perubahan tersebut setelah update. Anda juga harus menerapkan ulang penyesuaian apa pun yang dibuat di direktori sites/all.

  3. Aktifkan mode pemeliharaan di situs Anda: 
    drush vset --exact maintenance_mode 1
    drush cache-clear all
  4. Instal versi Drupal yang diinginkan menggunakan perintah berikut: 
    drush pm-update drupal-7.56

    Atau, Anda dapat menjalankan drush pm-update drupal untuk mengupdate ke versi core Drupal terbaru. Anda dapat menjalankan drush pm-updatestatus untuk mencantumkan update minor yang tersedia ke project inti dan kontrib Drupal.

  5. Terapkan kembali perubahan apa pun yang dilakukan pada .htaccess, robots.txt, atau defaults.settings.php (di direktori sites).
  6. Terapkan kembali perubahan apa pun yang dilakukan pada direktori sites/all .
  7. Menonaktifkan situs Anda dari mode pemeliharaan: 
    drush vset --exact maintenance_mode 0
    drush cache-clear all

Bagaimana jika saya mengalami masalah selama update?

Pulihkan situs Anda ke status sebelumnya menggunakan file cadangan yang Anda buat. Hubungi perwakilan dukungan Apigee Anda dan sampaikan pesan error yang dilaporkan selama update.