Portal Layanan Developer v. 4.17.09
Prosedur ini menjelaskan cara mengupgrade penginstalan lokal Layanan Saluran Developer Apigee yang ada.
Menentukan prosedur update yang benar
Prosedur yang Anda gunakan untuk memperbarui portal didasarkan pada penginstalan saat ini:
- Jika penginstalan Anda menggunakan Nginx/Postgres, gunakan Mengupgrade portal menggunakan RPM di bawah.
- Jika penginstalan menggunakan Apache/MySQL atau Apache/MariaDB, lihat Mengonversi portal berbasis tar menjadi portal berbasis RPM.
Menentukan jenis penginstalan saat ini
Jika 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 utama 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:
- 4.17.05 dan yang lebih baru:
/opt/apigee/apigee-drupal/wwwroot
- Sebelum 4.17.05:
/opt/apigee/apigee-drupal
(Nginx) atau/var/www/html
(Apache)
Jika Anda tidak menginstal portal di direktori default, ubah jalur dalam prosedur di bawah ini untuk menggunakan direktori penginstalan Anda.
Versi upgrade yang didukung
Prosedur upgrade ini didukung untuk versi portal berikut:
- OPDK-17-01.x
- OPDK-17-05.x
Untuk menentukan versi portal, buka URL berikut di browser:
http://your_portal.com/buildInfo
Sebelum memperbarui
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 dalam root
web, file tersebut akan disimpan untuk Anda.
Sebelum melanjutkan penginstalan, cadangkan seluruh direktori root web Drupal Anda. Setelah melakukan langkah-langkah penginstalan yang dijelaskan di bawah, Anda dapat memulihkan penyesuaian dari cadangan.
Mengupgrade portal menggunakan RPM
Gunakan prosedur berikut untuk mengupdate RPM portal pada node:
-
Ubah ke direktori Drupal. Misalnya,
/opt/apigee/apigee-drupal/wwwroot
.cd /opt/apigee/apigee-drupal/wwwroot
Lihat Direktori penginstalan default untuk direktori default versi produk Anda.
- 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
dalam hal ini:
dbname
menentukan nama database seperti yang ditentukan oleh propertiPG_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 propertiDRUPAL_PG_USER
dalam file konfigurasi penginstalan portal.- Anda akan diminta untuk memasukkan sandi pengguna Postgres seperti yang ditetapkan 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 perintahdrush 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
. - Setel Drupal ke mode pemeliharaan:
- Pilih Configuration di menu Drupal.
- Di halaman Configuration, pilih Maintenance mode di bagian Development.
- Centang kotak Put site into pemeliharaan mode.
- Masukkan pesan yang akan dilihat pengguna selama pemeliharaan.
- Pilih Save configuration.
- Nonaktifkan SELinux seperti yang dijelaskan dalam Menginstal utilitas apigee-setup Edge.
- Ubah ke direktori
/opt
:cd /opt
-
Untuk upgrade pada server yang memiliki koneksi Internet:
- Download file
bootstrap_4.17.09.sh
Edge 4.17.09 ke/tmp/bootstrap_4.17.09.sh
:curl https://software.apigee.com/bootstrap_4.17.09.sh -o /tmp/bootstrap_4.17.09.sh
- Instal utilitas dan dependensi
apigee-service
Edge 4.17.09:sudo bash /tmp/bootstrap_4.17.09.sh apigeeuser=uName apigeepassword=pWord
dengan uName:pWord adalah nama pengguna dan sandi yang Anda terima dari Apigee. Jika menghapus pWord, Anda akan diminta untuk memasukkannya.
Secara default, penginstal memeriksa untuk melihat bahwa Anda telah menginstal Java 1.8. Anda dapat menggunakan opsi "C" untuk melanjutkan tanpa menginstal Java.
- Download file
-
Untuk upgrade pada server tanpa koneksi Internet:
- Buat repo 4.17.09 lokal seperti yang dijelaskan dalam "Membuat repositori Apigee lokal" di bagian Menginstal utilitas penyiapan apigee Edge.
-
Untuk menginstal apigee-service dari file .tar:
- Pada node dengan repo lokal, gunakan perintah berikut untuk memaketkan repo lokal menjadi satu file .tar dengan nama
/opt/apigee/data/apigee-mirror/apigee-4.17.09.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:
tar -xzf apigee-4.17.09.tar.gz
Perintah ini membuat direktori baru, yang bernama repo, di direktori yang berisi file .tar. Misalnya, /tmp/repo.
- Instal utilitas dan dependensi Edge
apigee-service
dari/tmp/repos
:sudo bash /tmp/repos/bootstrap_4.17.09.sh apigeeprotocol="file://" apigeerepobasepath=/tmp/repos
Perhatikan bahwa Anda menyertakan jalur ke direktori repositori dalam perintah ini.
- Pada node dengan repo lokal, gunakan perintah berikut untuk memaketkan repo lokal menjadi satu file .tar dengan nama
-
Untuk menginstal layanan apigee menggunakan server web Nginx:
- Konfigurasikan server web Nginx seperti yang dijelaskan dalam "Instal dari repo menggunakan server web Nginx" pada Menginstal utilitas apigee-setup Edge.
- Pada node jarak jauh, download file Edge
bootstrap_4.17.09.sh
ke/tmp/bootstrap_4.17.09.sh
:/usr/bin/curl http://uName:pWord@remoteRepo:3939/bootstrap_4.17.09.sh -o /tmp/bootstrap_4.17.09.sh
dengan uName:pWord adalah nama pengguna dan sandi yang Anda tetapkan di atas untuk repo, dan remoteRepo adalah alamat IP atau nama DNS dari node repo.
- Pada node jarak jauh, instal utilitas dan dependensi
Edge
apigee-service
:kodesudo bash /tmp/bootstrap_4.17.09.sh apigeerepohost=remoteRepo:3939 apigeeuser=uName apigeepassword=pWord apigeeprotocol=http://
dengan uName:pWord adalah nama pengguna dan sandi repo.
- Gunakan
apigee-service
untuk mengupdate utilitasapigee-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".
- Jalankan skrip
update.php
Drupal dengan membuka URL berikut di jendela browser:http://portalIP_DNS:8079/update.php
- Nonaktifkan Drupal ke mode pemeliharaan:
- Pilih Configuration di menu Drupal.
- Di halaman Configuration, pilih Maintenance mode di bagian Development.
- Batalkan pilihan kotak Masukkan situs ke mode pemeliharaan.
- Pilih Save configuration.
Perhatikan, direktori utama setelah pembaruan adalah:
/opt/apigee/apigee-drupal/wwwroot
Upgrade kini telah selesai.