Halaman ini diterjemahkan oleh Cloud Translation API.

Mengonversi portal berbasis tar menjadi portal berbasis RPM

Edge for Private Cloud v4.18.05

Rilis 4.18.05 portal Layanan Developer Apigee (atau, portal) tidak memungkinkan Anda mengupdate portal versi berbasis tar sebelumnya. Anda hanya dapat mengupdate versi portal berbasis RPM secara langsung ke 4.18.05.

Namun, Anda dapat mengonversi versi portal berbasis tar ke instance portal berbasis RPM 4.18.05. Sebagai bagian dari proses ini, Anda akan memigrasikan MySQL/MariaDB dari portal yang ada ke database Postgres. Setelah dikonversi, portal Anda akan tetap menjadi portal berbasis RPM.

Anda dapat memigrasikan banyak versi sebelumnya dari portal berbasis tar ke portal berbasis RPM, termasuk versi 4.16.09 dan 4.17.01, bukan hanya versi 4.17.05. Satu-satunya persyaratan adalah portal menjalankan Drupal 7 atau yang lebih baru. Untuk memeriksa versi Drupal, pilih Laporan > Laporan Status di menu Drupal. Versi Drupal muncul di baris pertama output.

Langkah-langkah tingkat tinggi yang Anda gunakan untuk bermigrasi dari portal berbasis tar ke portal berbasis RPM adalah:

Instal portal versi 4.18.05 berbasis RPM di node baru.
Buat database Postgres baru di portal berbasis RPM.
Migrasikan database portal dari portal berbasis tar.
Salin semua file aksesori dari portal berbasis tar ke portal berbasis RPM.
Perbarui entri DNS agar mengarah ke portal berbasis RPM baru.
Perhatikan bahwa versi portal berbasis RPM menggunakan port 8079 secara default, sedangkan versi berbasis tar menggunakan port 80. Pastikan Anda menggunakan nomor port yang benar di entri DNS. Lihat Menetapkan port HTTP yang digunakan oleh portal untuk mengetahui informasi tentang penggunaan port yang berbeda.

Direktori penginstalan default baru setelah konversi

Setelah mengupdate penginstalan yang kini menggunakan Nginx/Postgres, direktori root berubah dari:

/opt/apigee/apigee-drupal

menjadi:

/opt/apigee/apigee-drupal/wwwroot

Prosedur konversi portal

Untuk mengonversi portal ke penginstalan berbasis RPM:

Instal portal versi 4.18.05 berbasis RPM di node yang berbeda dari portal berbasis tar Anda.
Di portal berbasis RPM, buat database Postgres baru. Kemudian, Anda memigrasikan database dari portal berbasis tar ke database baru ini:
1. Login ke psql:
```
psql -h localhost -p 5432 -U apigee
```
  Masukkan sandi Postgres Anda seperti yang ditentukan oleh properti PG_PWD dalam file konfigurasi portal.
2. Buat database Postgred baru:
```
CREATE DATABASE newportaldb;
```
3. Keluar dari psql:
```
\q
```

Di portal berbasis tar, hapus modul lama yang tidak lagi digunakan:

cd /var/www/html
drush sql-query --db-prefix "DELETE from {system} where name = 'apigee_account' AND type = 'module';"
drush sql-query --db-prefix "DELETE from {system} where name = 'apigee_checklist' AND type = 'module';"
drush sql-query --db-prefix "DELETE from {system} where name = 'apigee_sso_ui' AND type = 'module';"

Di portal berbasis tar, Instal dan konfigurasikan modul Drupal Migrator:

```
cd /tmp 
```

wget https://ftp.drupal.org/files/projects/dbtng_migrator-7.x-1.4.tar.gz

gunzip /tmp/dbtng_migrator-7.x-1.4.tar.gz

tar -xvf /tmp/dbtng_migrator-7.x-1.4.tar --directory /var/www/html/sites/all/modules

Login ke portal sebagai admin.
Pilih Modul di menu Drupal.
Aktifkan modul DBTNG Migrator.
Simpan konfigurasi.

Di portal berbasis tar, edit /var/www/html/sites/default/settings.php untuk menambahkan konfigurasi database kedua yang mengarah ke database yang baru dibuat di portal berbasis RPM. Konfigurasi database saat ini bernama "default". Beri nama konfigurasi baru Anda "kustom", seperti yang ditunjukkan dalam contoh berikut:

$databases = array (
  'default' =>
  array (
    'default' =>
    array (
      'database' => 'devportal',
      'username' => 'devportal',
      'password' => 'devportal',
      'host' => 'localhost',
      'port' => '',
      'driver' => 'mysql',
      'prefix' => '',
    ),
  ),
  'custom' =>
  array (
    'default' =>
    array (
      'database' => 'newportaldb',
      'username' => 'apigee',
      'password' => 'postgres',
      'host' => '192.168.168.100',
      'port' => '5432',
      'driver' => 'pgsql',
      'prefix' => '',
    )
  )
);

Dengan host dan port menentukan alamat IP dan port server Postgres. Postgres menggunakan port 5432 untuk koneksi.

Di portal berbasis tar, instal driver Postgres:
1. Gunakan Yum untuk menginstal driver:
```
yum install php-pdo_pgsql
```
2. Edit /etc/php.ini untuk menambahkan baris berikut di mana saja dalam file:
```
extension=pgsql.so
```
3. Mulai ulang Apache:
```
service httpd restart
```
Di portal berbasis tar, migrasikan database portal ke portal berbasis RPM:
1. Login ke portal sebagai admin.
2. Pilih Structure->Migrator di menu Drupal.
3. Pilih database asal Anda di portal berbasis tar, default, dan database tujuan, custom, berdasarkan file settings.php yang ditampilkan di atas.
4. Klik Migrasikan. Database berbasis tar dimigrasikan ke database berbasis RPM.

Salin direktori sites dari server berbasis tar ke server berbasis RPM. Jalur yang ditampilkan dalam langkah-langkah berikut didasarkan pada jalur default. Ubah seperlunya untuk penginstalan Anda.

Di portal berbasis tar, gabungkan direktori /var/www/html/sites:
```
cd /var/www/html/sites
tar -cvzf /tmp/sites.tar.gz .
```
Salin /tmp/sites.tar.gz ke /opt/apigee/apigee-drupal/wwwroot/sites di server berbasis RPM.

Unbundle direktori situs, tetapi jangan menimpa file penting.

Cadangkan file settings.php:

sudo cp /opt/apigee/apigee-drupal/wwwroot/sites/default/settings.php
  /opt/apigee/apigee-drupal/wwwroot/sites/default/settings.bak.php

Cadangkan direktori files yang ada:

sudo mv /opt/apigee/apigee-drupal/wwwroot/sites/default/files
  /opt/apigee/apigee-drupal/wwwroot/sites/default/files_old

Cadangkan direktori sites yang ada:

tar -cvzf /tmp/sites_old.tar.gz /opt/apigee/apigee-drupal/wwwroot/sites

Ekstrak zip dan untar direktori sites dari server berbasis tar:

gunzip /opt/apigee/apigee-drupal/wwwroot/sites/sites.tar.gz
tar -xvf /opt/apigee/apigee-drupal/wwwroot/sites/sites.tar

Pastikan file yang disalin memiliki kepemilikan yang tepat:

chown -R apigee:apigee /opt/apigee/apigee-drupal/wwwroot/sites/

Pulihkan file settings.php:

sudo cp /opt/apigee/apigee-drupal/wwwroot/sites/default/settings.bak.php
  /opt/apigee/apigee-drupal/wwwroot/sites/default/settings.php

Memindahkan file pribadi ke lokasi baru:

cp -r /opt/apigee/apigee-drupal/wwwroot/sites/default/files/private/* /opt/apigee/data/apigee-drupal-devportal/private
rm -rf /opt/apigee/apigee-drupal/wwwroot/sites/default/files/private
chown -R apigee:apigee /opt/apigee/data/apigee-sap-drupal-devportal/private

Di portal berbasis tar, hanya jika Anda mengubah jalur ke direktori root web di portal berbasis tar dari jalur default /var/www/html: jalankan drush status dan lihat jalur files dan jalur private files:
```
cd /var/www/html
drush status
```
Jika file/file pribadi tidak berada di direktori sites, salin ke server berbasis RPM seperti yang ditunjukkan di atas.
Di portal berbasis RPM, perbarui /opt/apigee/apigee-drupal/wwwroot/sites/default/settings.php untuk menetapkan properti database default:
```
vi /opt/apigee/apigee-drupal/wwwroot/sites/default/settings.php
```
Tetapkan deskripsi database default di settings.php:
```
$databases = array (
  'default' =>
  array (
    'default' =>
    array (
      'database' => 'newportaldb',
      'username' => 'apigee',
      'password' => 'postgres',
      'host' => 'localhost', 'port' => '5432',
      'driver' => 'pgsql',
      'prefix' => '',
    )
  )
);
```
Dengan database menentukan database baru yang Anda buat, username dan password seperti yang ditentukan untuk database kustom di portal berbasis tar, dan prefix kosong.
Di portal berbasis RPM, portal versi berbasis RPM berisi lebih sedikit modul Drupal daripada versi berbasis tar. Setelah bermigrasi ke portal berbasis RPM, Anda harus memeriksa modul yang tidak ada dan menginstalnya sesuai kebutuhan.
1. Instal missing_module Drupal yang digunakan untuk mendeteksi modul yang tidak ada:
```
cd /opt/apigee/apigee-drupal/wwwroot
drush dl missing_module
drush en missing_module
```
2. Login ke portal berbasis RPM sebagai admin.
3. Pilih Laporan > Laporan status di menu Drupal dan periksa modul yang hilang.
4. Gunakan laporan tersebut untuk menginstal modul yang tidak ada, atau gunakan perintah berikut:
```
cd /opt/apigee/apigee-drupal/wwwroot
drush dl <moduleA> <moduleB> ...
drush en <moduleA> <moduleB> ...
```
5. Setelah Anda mengaktifkan semua modul, pastikan file dimiliki oleh pengguna apigee:
```
chown -LR apigee:apigee /opt/apigee/apigee-drupal/wwwroot
```
  Untuk informasi selengkapnya tentang izin file, lihat https://www.drupal.org/node/244924.
Di portal berbasis RPM, jalankan update.php di browser untuk menghapus error pada modul yang tidak ada:
1. Login ke portal berbasis RPM sebagai admin.
2. Di browser, buka URL berikut:
```
http://portal_IP_or_DNS:8079/update.php
```
  Dengan portal_IP_or_DNS adalah alamat IP atau nama domain portal berbasis RPM.
3. Ikuti perintah di layar.
Perbarui entri DNS agar mengarah ke portal berbasis RPM baru Anda.

Perhatikan bahwa versi portal berbasis RPM menggunakan port 8079 secara default, sedangkan versi berbasis tar menggunakan port 80. Pastikan Anda menggunakan nomor port yang benar di entri DNS. Lihat Menetapkan port HTTP yang digunakan oleh portal untuk mengetahui informasi tentang penggunaan port yang berbeda.

Konversi selesai.