Edge for Private Cloud v4.19.01
Prosedur ini menjelaskan cara mengupgrade portal Layanan Developer Apigee yang ada (atau portal) lokal penginstalan.
Menentukan prosedur update yang benar
Prosedur yang digunakan untuk mengupdate portal didasarkan pada penginstalan saat ini:
- Jika penginstalan Anda menggunakan Nginx/Postgres, gunakan Mengupgrade portal menggunakan RPM di bawah.
- Jika penginstalan Anda menggunakan Apache/MySQL atau Apache/MariaDB, lihat Konversikan portal berbasis tar ke portal berbasis RPM.
Tentukan 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 Anda 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 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 diinstal pada:
- 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 tersebut 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
- OPDK-17-09.x
- OPDK-18-01.x
- OPDK-18-05.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 pada .htaccess
.
Anda harus berasumsi bahwa apa pun di luar direktori /sites
adalah milik Drupal. Channel
pengecualian untuk aturan ini adalah robots.txt
; jika file ini ada di {i>root web<i}, maka
disimpan 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 RPM
Untuk memperbarui RPM portal pada 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 {i>database<i}:pg_dump --dbname=devportal --host=host_IP_address --username=drupaladmin --password --format=c > /tmp/portal.dmp
Dengan keterangan:
- devportal adalah nama database seperti yang ditentukan oleh
Properti
PG_NAME
di file konfigurasi penginstalan portal. - host_IP_address adalah alamat IP node portal.
- drupaladmin adalah nama pengguna Postgres yang digunakan oleh portal untuk mengakses
database seperti yang ditentukan oleh properti
DRUPAL_PG_USER
dalam penginstalan portal file konfigurasi Anda.
Anda akan diminta untuk memasukkan sandi pengguna Postgres seperti yang ditentukan oleh
DRUPAL_PG_PASS
di file konfigurasi penginstalan portal.Jika nanti Anda ingin memulihkan dari cadangan, gunakan perintah berikut:
pg_restore --clean --dbname=devportal --host=localhost --username=apigee < /tmp/portal.dmp
- devportal adalah nama database seperti yang ditentukan oleh
Properti
- Cadangkan seluruh direktori root web Drupal Anda. Lokasi penginstalan default
adalah
/opt/apigee/apigee-drupal
, namun Anda mungkin telah mengubahnya.Jika Anda tidak yakin dengan lokasi direktori ini, gunakan perintah
drush status
atau 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
. - Siapkan Drupal ke mode pemeliharaan:
- Pilih Configuration di menu Drupal.
- Di halaman Configuration, pilih Pemeliharaan mode di bagian Development.
- Pilih kotak Masukkan situs ke mode pemeliharaan.
- Masukkan pesan yang akan dilihat pengguna selama pemeliharaan.
- Pilih Save configuration.
- Nonaktifkan SELinux seperti yang dijelaskan di Instal utilitas Edge apigee-setup.
- Ubah ke direktori
/opt
:cd /opt
- Untuk upgrade di server dengan koneksi internet:
- Download file
bootstrap_4.19.01.sh
Edge 4.19.01 ke/tmp/bootstrap_4.19.01.sh
:curl https://software.apigee.com/bootstrap_4.19.01.sh -o /tmp/bootstrap_4.19.01.sh
- Instal utilitas dan dependensi
apigee-service
Edge 4.19.01:sudo bash /tmp/bootstrap_4.19.01.sh apigeeuser=uName apigeepassword=pWord
Dengan uName dan pWord adalah nama pengguna dan sandi yang Anda terima dari 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
- Untuk upgrade di server tanpa koneksi Internet:
- Membuat repo 4.19.01 lokal seperti yang dijelaskan dalam Buat repositori Apigee lokal.
- Untuk menginstal apigee-service dari file .tar:
- Pada node yang memiliki repositori lokal, gunakan perintah berikut untuk memaketkan
repo menjadi satu file {i> .tar<i} bernama
/opt/apigee/data/apigee-mirror/apigee-4.19.01.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.19.01.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 dan dependensi Edge
apigee-service
dari/tmp/repos
:sudo bash /tmp/repos/bootstrap_4.19.01.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 {i> .tar<i} bernama
- 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.19.01.sh
untuk/tmp/bootstrap_4.19.01.sh
:/usr/bin/curl http://uName:pWord@remoteRepo:3939/bootstrap_4.19.01.sh -o /tmp/bootstrap_4.19.01.sh
Dengan uName dan pWord adalah nama pengguna dan sandi yang Anda tetapkan di atas untuk repo, dan remoteRepo adalah alamat IP atau nama DNS repo Anda.
- Pada node jarak jauh, instal utilitas
apigee-service
Edge dan dependensi:sudo bash /tmp/bootstrap_4.19.01.sh apigeerepohost=remoteRepo:3939 apigeeuser=uName apigeepassword=pWord apigeeprotocol=http://
Dengan uName dan 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 di node 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" .