Google menggunakan teknologi AI untuk menerjemahkan konten ke dalam bahasa pilihan Anda. Terjemahan AI mungkin mengandung kesalahan.

Upgrade portal

Edge for Private Cloud v4.19.01

Prosedur ini menjelaskan cara mengupgrade penginstalan lokal portal Layanan Developer Apigee (atau cukup, portal) yang ada.

Menentukan prosedur update yang benar

Prosedur yang Anda gunakan untuk mengupdate portal didasarkan pada penginstalan Anda 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 Mengonversi portal berbasis tar ke portal berbasis 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 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 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 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 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 Anda, buka URL berikut di browser:

http://yourportal.com/buildInfo

CATATAN: Jika karena alasan tertentu Anda menghapus file buildInfo, Anda dapat menentukan versi dari file profiles/apigee/apigee.info. Lokasi penginstalan default adalah /var/www/html/profiles/apigee/apigee.info, tetapi Anda mungkin telah mengubahnya pada waktu penginstalan jika menginstal portal di direktori selain /var/www/html. File apigee.info berisi baris dalam format di bawah yang berisi versi:

version = "OPDK-4.17.05"

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 RPM

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=host_IP_address --username=drupaladmin
  --password --format=c > /tmp/portal.dmp
```
Dengan:
- devportal adalah nama database seperti yang ditentukan oleh properti PG_NAME dalam 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 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 ingin memulihkan dari cadangan, gunakan perintah berikut:
```
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).
TIPS: Sebelum melakukan pencadangan, periksa apakah target pencadangan Anda adalah link simbolis ke file yang sebenarnya. Untuk melakukannya, cari jenis file l saat Anda mencantumkan konten direktori. Pada contoh berikut, direktori kedua dan keempat adalah link simbolis (jenis file ditunjukkan di awal daftar izin):
```
ls -l /opt/apigee
drwxr-xr-x. 16 apigee   apigee  195 Jan 29 15:49 edge-qpid-server-4.19.01-0.0.20013
lrwxrwxrwx.  1 apigee   apigee   41 Jan 12 08:18 edge-router -> /opt/apigee/edge-router-4.19.01-0.0.20013
drwxr-xr-x. 15 apigee   apigee  195 Jan 29 15:50 edge-router-4.19.01-0.0.20013
lrwxrwxrwx.  1 apigee   apigee   37 Jan  9 17:13 edge-ui -> /opt/apigee/edge-ui-4.19.01-0.0.20115
```
Jika target yang ingin Anda cadangkan adalah link simbolis, Anda harus mendereferensikan link untuk mencadangkan konten yang sebenarnya. Cara melakukannya bergantung pada alat yang Anda gunakan untuk melakukan pencadangan. Misalnya, jika Anda menggunakan tar, gunakan opsi -h, seperti yang ditunjukkan dalam contoh berikut:
```
tar -hcfz /etc/my-drupal-backup.tar.gz /opt/apigee/apigee-drupal
```
Buat cadangan file di /opt/apigee/data/apigee-drupal-devportal/private.
Setel Drupal ke mode pemeliharaan:
1. Pilih Configuration di menu Drupal.
2. Di halaman Configuration, pilih Maintenance mode di bagian Development.
3. Centang kotak Put site into maintenance mode.
4. Masukkan pesan yang akan dilihat pengguna selama pemeliharaan.
5. Pilih Save configuration.
Nonaktifkan SELinux seperti yang dijelaskan dalam Menginstal utilitas apigee-setup Edge.
Ubah ke direktori /opt:
```
cd /opt
```
Untuk upgrade di server dengan koneksi internet:
1. 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
```
2. 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 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.
Untuk upgrade di server tanpa koneksi internet:
1. Buat repositori 4.19.01 lokal seperti yang dijelaskan dalam Membuat repositori Apigee lokal.
  NOTE: Jika sudah memiliki repo, Anda dapat menambahkan repo 4.19.01 ke repo tersebut seperti yang dijelaskan dalam "Memperbarui repositori Apigee lokal" di Menginstal utilitas apigee-setup Edge.
2. Untuk menginstal apigee-service dari file .tar:
  1. Pada node dengan repo lokal, gunakan perintah berikut untuk mengemas repo lokal ke dalam satu file .tar bernama /opt/apigee/data/apigee-mirror/apigee-4.19.01.tar.gz:
```
/opt/apigee/apigee-service/bin/apigee-service apigee-mirror package
```
  2. Salin file .tar ke node tempat Anda ingin mengupdate Edge. Misalnya, salin ke direktori /tmp di node baru.
  3. Pada node baru, ekstrak file ke direktori /tmp:
```
tar -xzf apigee-4.19.01.tar.gz
```
    Perintah ini akan membuat direktori baru, bernama repos, di direktori yang berisi file .tar. Misalnya, /tmp/repos.
  4. Instal utilitas dan dependensi apigee-service Edge 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.
3. Untuk menginstal apigee-service menggunakan server web Nginx:
  1. Konfigurasikan server web Nginx seperti yang dijelaskan dalam "Menginstal dari repo menggunakan server web Nginx" di Menginstal utilitas apigee-setup Edge.
  2. Di node jarak jauh, download file bootstrap_4.19.01.sh Edge ke /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 node repo.
  3. Pada node jarak jauh, instal utilitas dan dependensi apigee-service Edge:
```
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 utilitas apigee-setup:

/opt/apigee/apigee-service/bin/apigee-service apigee-setup update

Jalankan utilitas update di node Postgres Anda:
```
/opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
```
Dengan configFile sebagai 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".
Jalankan utilitas update pada node Anda untuk mengupdate portal:
```
/opt/apigee/apigee-setup/bin/update.sh -c dp -f configFile
```
Dengan configFile sebagai 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://portal_IP_DNS:8079/update.php
```
Nonaktifkan mode pemeliharaan:
1. Pilih Configuration di menu Drupal.
2. Di halaman Configuration, pilih Maintenance mode di bagian Development.
3. Batalkan pilihan kotak Put site into maintenance mode.
4. Pilih Save configuration.

Perhatikan bahwa direktori root setelah update adalah:

/opt/apigee/apigee-drupal/wwwroot

Upgrade kini telah selesai. Jika utilitas update Apigee mendowngrade versi Drupal Anda, Anda mungkin perlu menjalankan ulang utilitas upgrade Drupal. Untuk mengetahui informasi selengkapnya, lihat Menjalankan ulang upgrade Drupal.

Menjalankan kembali upgrade Drupal

Jika menjalankan utilitas update Apigee untuk mengupgrade Edge for Private Cloud justru mengakibatkan downgrade versi Drupal, instal ulang upgrade Drupal. Hal ini mungkin terjadi jika Anda hanya mengupgrade Drupal di antara update Cloud Pribadi.

Contoh:

Anda menjalankan Edge for Private Cloud versi 4.18.05, yang menyertakan Drupal 7.59.
Anda mengupgrade Drupal ke 7.64 karena update keamanan yang diperlukan.
Anda kini mengupgrade cloud pribadi ke 4.19.01, yang mencakup Drupal 7.61.

Seperti yang diilustrasikan dalam kasus ini, versi Drupal yang digunakan oleh utilitas update Apigee mungkin tidak merujuk ke upgrade Drupal terbaru. Akibatnya, Anda sekarang harus menjalankan ulang upgrade Drupal untuk mengembalikan penginstalan Drupal ke versi yang lebih baru.