Developer Services Portal 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 untuk menggunakan direktori penginstalan Anda.
Jika tidak mengetahui direktori penginstalan, Anda dapat menentukannya seperti yang dijelaskan dalam Perintah Drush yang umum 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 Anda, 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 di modul non-kustom, modifikasi Anda akan ditimpa. Hal ini mencakup, antara lain, perubahan apa pun yang mungkin telah Anda buat pada .htaccess. Anda harus berasumsi 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 Kanal Developer Apigee ke rilis baru
- Cadangan instance MySQL Drupal Anda.
Untuk informasi selengkapnya, lihat http://www.thegeekstuff.com/2008/09/backup-and-restore-mysql-database-using-mysqldump/- Opsi 1: Menggunakan Drush
Perintah Drush sql-dump 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. - 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 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.
- Opsi 1: Menggunakan Drush
- Buat cadangan seluruh direktori root web Drupal Anda. Lokasi penginstalan default adalah /var/www/html, tetapi Anda mungkin telah mengubahnya pada saat penginstalan.
- Download file Developer Channel Services 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 <tempel link di sini>
Catatan: Jika portal Anda berada 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 Developer Channel Services. 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. -
Untuk upgrade di server dengan koneksi internet:
- Ekstrak file upgrade portal:
> tar -xvf <tar file>
Ekstrak perintah ini akan membuat direktori baru bernama DeveloperServices-4.x.y.z. - Ubah ke direktori DeveloperServices-4.x.y.z.
- Download versi Drupal terbaru menggunakan perintah berikut:
> drush dl drupal
Perintah ini membuat direktori bernama drupal-x.y, dengan x.y sesuai dengan versi Drupal saat ini. - 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. - Untuk menerima notifikasi update Drupal, pastikan modul Drupal Update manager diaktifkan. Dari menu Drupal, pilih Modules dan scroll ke bawah ke modul Update manager. Jika belum diaktifkan, aktifkan.
Setelah diaktifkan, Anda dapat melihat update yang tersedia menggunakan item menu Laporan > Update yang Tersedia.
Gunakan item menu Reports > Available Updates > Settings untuk mengonfigurasi modul agar mengirimkan email kepada Anda saat update tersedia dan untuk menetapkan frekuensi pemeriksaan update.
- Ekstrak file upgrade portal:
-
Untuk upgrade di server tanpa koneksi internet:
- Di server tempat Anda mendownload file DeveloperServices_x.y.z.tar Developer Channel Services,
ekstrak file upgrade portal:
> tar -xvf <tar file>
Ekstrak perintah ini akan membuat direktori baru bernama DeveloperServices-4.x.y.z. - Ubah ke direktori DeveloperServices-4.x.y.z.
- 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 akan mendownload semua file update yang diperlukan dan memaketkannya ke dalam satu file bernama devportal-update.tgz dan menulis file tersebut ke lokasi yang Anda pilih. - Salin devportal-update.tgz ke server target, yang menjalankan portal.
Catatan: Jangan salin devportal-update.tgz ke root web server target. - Ekstrak file devportal-update.tgz ke direktori saat ini:
> tar -xzf /path/to/devportal-update.tgz - Ubah ke direktori developer-update.
- Jalankan perintah berikut untuk menginstal update:
> ./install-update.sh - Jawab perintahnya.
- Di server tempat Anda mendownload file DeveloperServices_x.y.z.tar Developer Channel Services,
ekstrak file upgrade portal:
Upgrade kini telah selesai.