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 mengupdate portal didasarkan pada penginstalan Anda saat ini:
- Jika penginstalan Anda menggunakan Apache/MySQL atau Apache/MariaDB dari sistem yang diupdate ke 4.17.01, gunakan Mengupgrade portal menggunakan file .tar.
- Jika penginstalan Anda menggunakan Nginx/Postgres dari penginstalan 4.17.01 baru, gunakan Mengupgrade portal menggunakan RPM.
Menentukan jenis penginstalan saat ini
Jika Anda 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 status
OK: apigee-drupal-devportal is up and running
+ apigee-service apigee-lb status
apigee-service: apigee-lb: OK
+ apigee-service apigee-postgresql status
apigee-service: apigee-postgresql: OK - apachectl -S
Jika Anda menggunakan Apache/MySQL atau Apache/MariaDB, perintah ini akan menampilkan direktori root 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 untuk menggunakan direktori penginstalan Anda.
Jika tidak mengetahui direktori penginstalan, Anda dapat menentukannya seperti yang dijelaskan dalam Perintah Drush yang umum 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 root 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 Anda, buka URL berikut di browser:
http://yourportal.com/buildInfo
Sebelum Anda mengupdate
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. Setelah melakukan langkah-langkah penginstalan yang dijelaskan di bawah, Anda dapat memulihkan penyesuaian dari cadangan.
Mengupgrade portal menggunakan file .tar
- Cadangkan instance MySQL/MariaDB 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 DeveloperServices_x.y.z.tar Developer Channel Services
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 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 Dukungan Apigee Edge dan pilih Login ke Portal Dukungan Anda untuk meminta file .tar upgrade Layanan Developer Channel. 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.
Mengupgrade portal menggunakan RPM
Gunakan prosedur berikut untuk mengupdate RPM portal di node:
- Ubah ke direktori Drupal, /opt/apigee/apigee-drupal secara
default:
> cd /opt/apigee/apigee-drupal - 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
dengan:- 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 database seperti yang ditentukan oleh properti DRUPAL_PG_USER dalam file konfigurasi penginstalan portal.
- Anda akan diminta memasukkan sandi pengguna Postgres seperti yang ditentukan oleh properti DRUPAL_PG_PASS dalam file konfigurasi penginstalan portal.
Jika nanti Anda harus memulihkan dari cadangan, gunakan perintah:
pg_restore --clean --dbname=devportal --host=localhost --username=apigee < /tmp/portal.dmp - 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). - Buat cadangan file di /opt/apigee/data/apigee-drupal-devportal/private.
- Nonaktifkan SELinux seperti yang dijelaskan dalam Menginstal utilitas apigee-setup Edge.
-
Untuk upgrade di server dengan koneksi internet:
- 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 - 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 Apigee. Jika Anda menghilangkan pWord, 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.
- Download file bootstrap_4.17.05.sh Edge 4.17.05 ke
/tmp/bootstrap_4.17.05.sh:
-
Untuk upgrade di server tanpa koneksi internet:
- Buat repositori 4.17.05 lokal seperti yang dijelaskan dalam "Membuat repositori Apigee lokal" di
Menginstal utilitas apigee-setup
Edge.
Catatan: Jika sudah memiliki repo 4.17.01, Anda dapat menambahkan repo 4.17.05 ke repo tersebut seperti yang dijelaskan dalam "Memperbarui repositori Apigee lokal" di Menginstal utilitas apigee-setup Edge. -
Untuk menginstal apigee-service dari file .tar:
- Pada node dengan repo lokal, gunakan perintah berikut untuk memaketkan repo lokal ke dalam satu file .tar bernama /opt/apigee/data/apigee-mirror/apigee-4.17.05.tar.gz:
> /opt/apigee/apigee-service/bin/apigee-service apigee-mirror package - Salin file .tar ke node tempat Anda ingin mengupdate Edge. Misalnya, salin ke direktori /tmp di node baru.
- Pada node baru, untar file ke direktori /tmp:
> tar -xzf apigee-4.17.05.tar.gz
Perintah ini membuat direktori baru, bernama repos, di direktori yang berisi file .tar. Misalnya, /tmp/repos. - 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 repos dalam perintah ini.
- Pada node dengan repo lokal, gunakan perintah berikut untuk memaketkan repo lokal ke dalam satu file .tar bernama /opt/apigee/data/apigee-mirror/apigee-4.17.05.tar.gz:
-
Untuk menginstal apigee-service menggunakan server web Nginx:
- Konfigurasikan server web Nginx seperti yang dijelaskan dalam "Menginstal dari repo menggunakan server web Nginx" di Menginstal utilitas apigee-setup Edge.
- Di 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 -o /tmp/bootstrap_4.17.05.sh
dengan uName:pWord adalah nama pengguna dan sandi yang Anda tetapkan di atas untuk repo, dan remoteRepo adalah alamat IP atau nama DNS node repo. - 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 apigeeprotocol=http://
dengan uName:pWord adalah nama pengguna dan sandi repo.
- Buat repositori 4.17.05 lokal seperti yang dijelaskan dalam "Membuat repositori Apigee lokal" di
Menginstal utilitas apigee-setup
Edge.
- Gunakan apigee-service untuk
mengupdate utilitas apigee-setup:
> /opt/apigee/apigee-service/bin/apigee-service apigee-setup update - 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". - Mulai Postgres:
> /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql start - 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 bahwa direktori root setelah update sekarang adalah:
/opt/apigee/apigee-drupal/wwwroot
Upgrade kini telah selesai.