Portal Layanan Developer v. 4.17.05
Prosedur ini menjelaskan cara mengupgrade Layanan Saluran Developer Apigee yang ada penginstalan lokal.
Menentukan prosedur update yang benar
Prosedur yang digunakan untuk mengupdate portal didasarkan pada penginstalan saat ini:
- Jika penginstalan Anda menggunakan Apache/MySQL atau Apache/MariaDB dari sistem diupdate ke versi 4.17.01, lalu gunakan Upgrade portal menggunakan file .tar.
- Jika penginstalan Anda menggunakan Nginx/Postgres dari versi 4.17.01 penginstalan, lalu gunakan Mengupgrade portal menggunakan RPM.
Menentukan jenis penginstalan Anda saat ini
Jika tidak yakin dengan jenis instalasi Anda saat ini, gunakan perintah berikut untuk menentukan hal tersebut:
- 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 saat ini. - /opt/apigee/apigee-service/bin/apigee-all
status
Jika menggunakan Nginx/Postgres, Anda akan melihat output berikut:
+ apigee-service status apigee-drupal-devportal
Oke: apigee-drupal-devportal aktif dan berjalan
+ status apigee-service apigee-lb
apigee-service: apigee-lb: Oke
+ status apigee-service apigee-postgresql
apigee-service: apigee-postgresql: Oke - apachectl -S
Jika Anda menggunakan Apache/MySQL atau Apache/MariaDB, perintah ini akan menampilkan server web direktori utama 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 tersebut 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.
Baru direktori instalasi {i>default<i} setelah pembaruan Nginx/Postgres dari versi 4.17.01 penginstalan
Setelah memperbarui instalasi baru 4.17.01 yang menggunakan Nginx/Postgres, direktori {i>root<i} diubah 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, buka URL berikut di browser:
http://yourportal.com/buildInfo
Sebelum mengupdate
Untuk penginstalan yang sudah ada, jika Anda telah mengubah kode di inti Drupal atau di lingkungan non-kustom , modifikasi Anda akan ditimpa. Hal ini mencakup, antara lain, setiap perubahan yang mungkin Anda lakukan di .htaccess. Anda harus berasumsi bahwa apa pun di luar direktori /sites adalah milik Drupal. Channel pengecualian untuk aturan ini adalah robots.txt; apakah file ini ada di web {i>root<i}, nama itu akan dipertahankan untuk Anda.
Sebelum melanjutkan penginstalan, buat cadangan seluruh root web Drupal Anda saat ini. Setelah melakukan langkah penginstalan yang dijelaskan di bawah, Anda dapat memulihkan dan penyesuaian dari cadangan.
Mengupgrade portal menggunakan file .tar
- Cadangkan instance Drupal MySQL/MariaDB Anda.
Untuk informasi selengkapnya, lihat http://www.thegeekstuff.com/2008/09/backup-and-restore-mysql-database-using-mysqldump/- Opsi 1: Gunakan Drush
Perintah Drush sql-dump membuat salinan {i>database<i}. Dari direktori Drupal Anda, /var/www/html secara default, jalankan perintah:
> {i>drush sql-dump<i} > /path/to/backup_dir/database-backup.sql
Gunakan drush help sql-dump untuk informasi selengkapnya. - Opsi 2: Menggunakan MySQLdump
Menggunakan perintah mysqldump untuk membuat salinan database:
mysqldump -u NAMA PENGGUNA -p'SANDI' DATABASENAME > /path/to/backup_dir/database-backup.sql
Tidak boleh ada spasi antara opsi -p dan sandi. Lajang tanda kutip di sekitar {i>password<i} diperlukan jika {i> password<i} mengandung karakter khusus.
Anda menetapkan USERNAME dan DATABASENAME saat Anda menginstal portal. Secara default, keduanya adalah devportal.
- Opsi 1: Gunakan Drush
- Cadangkan seluruh direktori root web Drupal Anda. Lokasi penginstalan default adalah /var/www/html, tetapi Anda mungkin telah mengubahnya pada waktu penginstalan.
- Mendownload Layanan Saluran Developer DeveloperServices_x.y.z.tar
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 dan lalu menambahkannya ke perintah cURL berikut:
> curl -kOL <tempel link here>
Catatan: Jika portal Anda berada di server tanpa koneksi Internet eksternal, melakukan langkah ini pada server yang memiliki akses.
Buka Apigee Edge Support dan pilih Login ke Portal Dukungan untuk meminta Saluran Developer File .tar upgrade layanan. Jika Anda tidak memiliki akun di Portal Dukungan, pilih Login ke Portal Dukungan, lalu di halaman login, pilih Di cepat? Berikan tiket dukungan di sini. -
Untuk upgrade di server dengan koneksi internet:
- Ekstrak file upgrade portal:
> {i>tar -xvf<i} file>
Ekstrak perintah ini akan membuat direktori baru bernama DeveloperServices-4.x.y.z. - Ubah ke DeveloperServices-4.x.y.z saat ini.
- Download versi Drupal terbaru menggunakan perintah berikut:
> drush dl drupal
Perintah ini membuat direktori bernama {i> drupal-x.y<i}, di mana x.y sesuai dengan versi Drupal. - Jalankan skrip networked-update.sh:
> ./networked-update.sh
Tergantung pada izin akses file, Anda mungkin harus menggunakan {i> sudo <i}untuk menjalankan perintah ini, atau menjalankannya sebagai administrator. - Untuk menerima notifikasi update Drupal, pastikan pengelola Drupal Update
diaktifkan. Dari menu Drupal, pilih Modules dan scroll ke bawah untuk
modul Update manager. Jika belum aktif, aktifkan terlebih dahulu.
Setelah diaktifkan, Anda dapat melihat pembaruan yang tersedia dengan menggunakan Laporan > Tersedia Item menu Pembaruan.
Gunakan Laporan > Update yang Tersedia > Setelan untuk item menu konfigurasikan modul untuk mengirimkan email saat pembaruan tersedia dan menyetel frekuensi memeriksa pembaruan.
- Ekstrak file upgrade portal:
-
Untuk upgrade di server tanpa koneksi Internet:
- Di server tempat Anda mendownload file DeveloperServices_x.y.z.tar Layanan Saluran Developer,
ekstrak file upgrade portal:
> {i>tar -xvf<i} file>
Ekstrak perintah ini akan membuat direktori baru bernama DeveloperServices-4.x.y.z. - Ubah ke DeveloperServices-4.x.y.z saat ini.
- Jalankan skrip non-networked-update.sh:
> ./non-networked-update.sh
Tergantung pada izin akses file, Anda mungkin harus menggunakan {i> sudo <i}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 ke lokasi yang Anda pilih. - Salin devportal-update.tgz ke target
server, yaitu server yang
menjalankan portal.
Catatan: Jangan salin devportal-update.tgz ke root web server target. - Ekstrak file devportal-update.tgz ke
direktori saat ini:
> {i>tar -xzf<i} /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 Layanan Saluran Developer,
ekstrak file upgrade portal:
Upgrade kini telah selesai.
Mengupgrade portal menggunakan RPM
Gunakan prosedur berikut untuk memperbarui RPM portal pada node:
- Ubah ke direktori Drupal, /opt/apigee/apigee-drupal dengan
default:
> cd /opt/apigee/apigee-drupal - Cadangkan instance database Drupal Anda. Perintah pg_dump membuat salinan instance
{i>database<i}:
pg_dump --dbname=devportal --host=192.168.56.101 --username=drupaladmin --password --format=c > /tmp/portal.dmp
dalam hal ini:- dbname menentukan nama database seperti yang ditentukan oleh properti PG_NAME di portal file konfigurasi penginstalan.
- host menentukan IP ke alamat node portal.
- username menentukan nama pengguna Postgres yang digunakan oleh portal untuk mengakses basis data seperti yang ditentukan DRUPAL_PG_USER di file konfigurasi penginstalan portal.
- Anda akan diminta memasukkan sandi pengguna Postgres seperti yang ditentukan oleh properti DRUPAL_PG_PASS di bagian 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 - Cadangkan 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 perintah Konfigurasi > Media > Entri di menu Drupal untuk menentukan lokasi sistem file publik dan jalur sistem file pribadi (untuk ). - Cadangkan file di /opt/apigee/data/apigee-drupal-devportal/private.
- Nonaktifkan SELinux seperti yang dijelaskan dalam Menginstal utilitas Edge apigee-setup.
-
Untuk upgrade di server dengan koneksi internet:
- Download file bootstrap_4.17.05.sh Edge 4.17.05 untuk
/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 apigee-service Edge 4.17.05 dan
dependensi:
> {i>sudo bash<i} /tmp/bootstrap_4.17.05.sh apigeeuser=uName apigeepassword=pWord
dengan uName:pWord adalah nama pengguna dan sandi yang Anda terima Apigee. Jika menghapus pWord, Anda akan diminta untuk memasukkannya.
Secara default, penginstal akan memeriksa apakah Anda telah menginstal Java 1.8. Anda dapat menggunakan "C" untuk melanjutkan tanpa menginstal Java.
- Download file bootstrap_4.17.05.sh Edge 4.17.05 untuk
/tmp/bootstrap_4.17.05.sh:
-
Untuk upgrade di server tanpa koneksi Internet:
- Buat repo 4.17.05 lokal seperti yang dijelaskan dalam "Membuat repositori Apigee lokal" pada pukul
Menginstal penyiapan apigee Edge
utilitas.
Catatan: Jika sudah memiliki repositori 4.17.01, Anda dapat menambahkan 4.17.05, seperti yang dijelaskan di "Mengupdate repositori Apigee lokal" di Menginstal utilitas Edge apigee-setup. -
Untuk menginstal apigee-service dari file .tar:
- Pada node yang memiliki repositori lokal, gunakan perintah berikut untuk memaketkan
repo menjadi 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 pada node baru.
- Pada node baru, untar file ke direktori /tmp:
> {i>tar -xzf<i} apigee-4.17.05.tar.gz
Perintah ini membuat direktori baru, bernama {i>repos<i}, di direktori yang berisi file {i> .tar<i} . Misalnya, {i> /tmp/repos<i}. - Instal utilitas apigee-service Edge dan
dependensi dari /tmp/repos:
> {i>sudo bash<i} /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 yang memiliki repositori lokal, gunakan perintah berikut untuk memaketkan
repo menjadi 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 di bagian "Instal dari repo menggunakan Server Web Nginx" di Menginstal Edge utilitas apigee-setup.
- Pada node jarak jauh, download file Edge bootstrap_4.17.05.sh untuk
/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 ke node repo. - Di node jarak jauh, instal utilitas apigee-service Edge dan
dependensi:
> {i>sudo bash<i} /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 repo 4.17.05 lokal seperti yang dijelaskan dalam "Membuat repositori Apigee lokal" pada pukul
Menginstal penyiapan apigee Edge
utilitas.
- Menggunakan apigee-service untuk
mengupdate apigee-setup
utilitas:
> /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 {i>database <i}Postgres. Satu-satunya persyaratan pada file konfigurasi adalah bahwa konfigurasi file harus dapat diakses atau dibaca oleh "apigee" . - Mulai Postgres:
> /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql start - Jalankan utilitas update di 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 bahwa file konfigurasi harus dapat diakses atau dapat dibaca oleh "apigee" .
Perhatikan bahwa direktori utama setelah update sekarang adalah:
/opt/apigee/apigee-drupal/wwwroot
Upgrade kini telah selesai.