Penginstalan portal Layanan Developer

Developer Services Portal v. 4.16.09

Sebelum menginstal, pastikan:

• Anda melakukan penginstalan pada versi 64-bit dari versi Red Hat Enterprise Linux, CentOS, atau Oracle yang didukung. Lihat daftar versi yang didukung di sini.
• Yum sudah diinstal.
• Anda mencadangkan penginstalan yang ada. Jika Anda telah mengubah kode apa pun di inti Drupal atau di modul non-kustom, perubahan 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. Lokasi penginstalan default adalah /var/www/html, tetapi Anda mungkin telah mengubahnya pada waktu penginstalan. Setelah melakukan langkah-langkah penginstalan yang dijelaskan di bawah, Anda dapat memulihkan penyesuaian dari cadangan.

Ikuti langkah-langkah berikut untuk menginstal portal Developer Channel Services.

1. Mendapatkan paket Layanan Channel Developer

Buka http://community.apigee.com/content/apigee-customer-support dan pilih Login to your Support Portal untuk meminta file .tar Developer Channel Services dengan salah satu dari dua cara berikut:

• Minta akses ke direktori download Edge for Private Cloud.
• Minta URL ke file .tar Developer Channel Services.

2. Menguji koneksi Anda ke Apigee Edge

Uji koneksi Anda ke server pengelolaan Edge dengan menjalankan perintah cURL berikut dari command prompt di server portal:
> curl -u {EMAIL}:{PASSWORD} https://{hostname}:8080/v1/organizations/{ORGNAME}

Dengan EMAIL dan PASSWORD adalah alamat email dan sandi administrator untuk ORGNAME.

Pastikan untuk menentukan nama host dan nomor port khusus untuk penginstalan Edge Anda. Port 8080 adalah port default yang digunakan oleh Edge. Jika Anda terhubung ke organisasi di cloud, URL permintaannya adalah: https://api.enterprise.apigee.com/v1/organizations/{ORGNAME}

Jika berhasil, perintah ini akan menampilkan respons yang mirip dengan berikut ini:
{
"createdAt" : 1348689232699,
"createdBy" : "USERNAME",
"displayName" : "cg",
"environments" : [ "test", "prod" ],
"lastModifiedAt" : 1348689232699,
"lastModifiedBy" : "foo@bar.com",
"name" : "cg",
"properties" : {
"property" : [ ]
},
"type" : "trial"
}

3. Menghapus PHP versi sebelum 7.0

Skrip penginstalan memeriksa PHP versi sebelum 7.0 di sistem sebelum memulai penginstalan. Jika ada PHP versi sebelum 7.0, pesan peringatan berikut akan ditampilkan:

The following packages present on your system conflict with software we are
about to install. You will need to manually remove each one, then re-run this install script.
php
php-cli
php-common
php-gd
php-mbstring
php-mysql
php-pdo
php-pear
php-pecl-apc
php-process
php-xml

Untuk CentOS dan Red Hat Enterprise Linux (RHEL), hapus paket PHP menggunakan perintah berikut:

yum remove <package-name>

4. Menginstal Developer Channel Services menggunakan skrip penginstalan otomatis

Gunakan salah satu prosedur berikut untuk menginstal portal berdasarkan apakah Anda menginstal di server dengan atau tanpa koneksi internet.

Di server dengan koneksi internet:

Untuk menginstal Developer Channel Services di server dengan koneksi internet:

1. Login ke server sebagai root atau superuser.
2. Buat direktori untuk file penginstalan, seperti portal.
3. CD ke direktori portal baru dan download file DeveloperServices_x.y.z.tar Layanan Channel Developer, dengan x.y.z sesuai dengan nomor versi portal.
   
   Anda dapat mendownload file dari link yang dikirimkan kepada Anda oleh Apigee di browser atau dengan menyalinnya, lalu menambahkannya ke perintah cURL berikut:
   > curl -kOL <tempel link di sini>
4. Ekstrak konten file .tar Layanan Channel Developer menggunakan perintah:
   > tar -xvf <tar file>
5. CD ke DeveloperServices-4.x.y.z.
6. Jalankan skrip penginstalan menggunakan perintah berikut:
   > ./networked-install.sh
7. Respons perintah.

Di server tanpa koneksi internet:

Pertama, buat skrip penginstalan non-jaringan di sistem yang memiliki koneksi internet:

1. Login ke sistem yang memiliki koneksi internet sebagai root atau sebagai superuser.
2. Buat direktori untuk file penginstalan, seperti portal_tar.
3. CD ke direktori portal_tar dan download file Developer Channel Services DeveloperServices_x.y.z.tar, dengan x.y.z sesuai dengan nomor versi portal.
4. Ekstrak konten file .tar Developer Channel Services menggunakan perintah:
   > tar -xvf <tar file>
5. CD ke DeveloperServices-4.x.y.z.
6. Buat file .tar.gz portal menggunakan perintah:
   > ./non-networked-install.sh

File .tar.gz baru untuk penginstalan non-jaringan akan dibuat.

1. Login ke server sebagai root atau superuser.
2. Buat direktori untuk file penginstalan, seperti portal.
3. CD ke direktori portal.
4. Salin file .tar.gz yang Anda buat untuk penginstalan tanpa jaringan (dalam prosedur di atas) ke direktori portal.
5. Ekstrak konten file .tar.gz menggunakan perintah:
   > tar -xvf <tar file>
6. CD ke direktori yang dibuat oleh perintah tar.
7. Tetapkan izin pada skrip install-from-rpm-bundle.sh:
   > chmod 755 install-from-rpm-bundle.sh
8. Jalankan skrip install-from-rpm-bundle.sh menggunakan perintah:
   > ./install-from-rpm-bundle.sh
9. Respons perintah.

5. Mengonfigurasi portal developer Anda

Sebagian besar konfigurasi portal dilakukan tanpa memerlukan interaksi dari Anda, seperti penginstalan modul Drupal dan pembuatan konten default. Anda akan diminta untuk menyiapkan database, mengonfigurasi endpoint Edge, dan membuat pengguna admin baru.

Untuk mengonfigurasi portal developer:

1. Buka URL server di browser, seperti:
   http://localhost. Atau, jika Anda telah mengonfigurasi IP atau DNS tertentu, buka http://IP_address atau http://DNS_name.
   
   Anda akan dialihkan ke halaman Database configuration di profil Apigee.
   
   Catatan: Biasanya, Anda sudah mengonfigurasi nama host dan mendaftarkannya ke server DNS sehingga Anda tidak perlu menggunakan http://localhost.
2. Konfigurasikan koneksi ke database. Jika database berada di mesin jarak jauh, luaskan bagian Advanced Options dan masukkan informasi koneksi ke mesin tersebut, lalu pilih Save and continue.
3. Konfigurasikan koneksi ke Endpoint Apigee dengan memasukkan informasi berikut, lalu pilih Save.
   Untuk mengetahui informasi selengkapnya tentang nilai ini, lihat "Informasi yang Diperlukan Sebelum Memulai Penginstalan" di Persyaratan portal Layanan Developer.
   1. Management API Org
   2. URL Endpoint Management API
   3. Pengguna Terautentikasi Endpoint
   4. Sandi Pengguna yang Diautentikasi
4. Konfigurasikan pengguna administrator dengan memasukkan informasi berikut, lalu pilih Simpan. Perhatikan bahwa Drupal membuat pengguna admin bernama 'admin' secara default, jadi jangan gunakan 'admin' sebagai nama pengguna.
   Jika melewati langkah ini, Anda masih dapat menggunakan Drush untuk membuat administrator seperti yang dijelaskan di bawah pada langkah 4. Membuat pengguna admin.
   1. Nama depan dan belakang developer
   2. Nama pengguna portal developer
   3. Password
   4. Alamat email
5. Setelah penginstalan selesai, tetapkan izin pada file settings.php:
   > chmod 640 /var/www/html/sites/default/settings.php
6. Buka halaman beranda portal di http://localhost/ atau ke nama DNS portal Anda.
7. Login ke portal menggunakan kredensial administrator.

6. Membuat pengguna admin (Opsional)

Gunakan Drush untuk membuat pengguna administratif untuk penginstalan Developer Channel Services Anda. Drupal otomatis membuat pengguna admin bernama 'admin' secara default, jadi jangan gunakan 'admin' sebagai nama pengguna.

1. CD ke direktori drupal_root/sites/default Anda. Lokasi standar untuk direktori root Drupal adalah /var/www/html:
   > cd <drupal_root>/sites/default
2. Pastikan Anda memiliki izin tulis pada file Drupal pribadi:
   > drush vget file_private_path
   
   Perintah ini menampilkan jalur ke file Drupal pribadi, misalnya:
   file_private_path: 'sites/default/private'
   
   Sesuai dengan /var/www/html/sites/default/private/. Gunakan perintah berikut untuk memastikan bahwa direktori ini dapat ditulis oleh pemilik dan grup:
   chmod -R g+w dirPathAndName
   chmod -R o+r dirPathAndName
3. Masukkan perintah berikut untuk membuat pengguna admin, dengan mengganti perintah dalam “< >” dengan nilai Anda:
   > drush user-create <username> --mail="<email-address>" --password="<password>"
   > drush user-add-role Administrator <username>
4. Login ke portal developer sebagai admin menggunakan nama pengguna dan sandi yang ditentukan di atas.

5. Menetapkan sandi root MySQL

Jika Anda menginstal MySQL sebagai bagian dari penginstalan portal, skrip penginstalan akan membiarkan sandi root MySQL ditetapkan ke nilai defaultnya, yaitu kosong.

Gunakan perintah berikut untuk menetapkan sandi root:

> mysqladmin -u root password NEWPASSWORD

Jika Anda sebelumnya telah menetapkan sandi root dan ingin mengubahnya, gunakan perintah berikut:

> mysqladmin -u root -p'OLDPASSWORD' password NEWPASSWORD

Anda juga harus memperbarui sandi di file /var/www/html/sites/default/settings.php.

6. Pastikan modul Update manager diaktifkan

Untuk menerima notifikasi update Drupal, pastikan modul Drupal Update manager diaktifkan. Dari menu Drupal, pilih Modules dan scroll ke bawah ke modul Update manager. Jika belum diaktifkan, aktifkan.

Setelah diaktifkan, Anda dapat melihat update yang tersedia menggunakan item menu Reports > Available Updates. Anda juga dapat menggunakan perintah Drush berikut:

> drush pm-info update

Gunakan item menu Reports > Available Updates > Settings untuk mengonfigurasi modul agar mengirim email kepada Anda saat update tersedia dan untuk menetapkan frekuensi pemeriksaan update.

7. Men-deploy di server produksi (Opsional)

Jika men-deploy portal di server produksi, Anda harus melakukan langkah-langkah keamanan tambahan, termasuk:

1. Jalankan skrip berikut untuk mengamankan penginstalan MySQL Anda:
   > /usr/bin/mysql_secure_installation
   
   Skrip ini menetapkan sandi root dan memberi Anda opsi untuk membatasi akses root hanya ke localhost dan menghapus database pengujian serta pengguna anonim yang dibuat secara default. Menjalankan skrip ini sangat direkomendasikan untuk server produksi.
2. Jika diwajibkan oleh kebijakan perusahaan Anda, aktifkan dan konfigurasi SELinux.

8. Mengonfigurasi mesin telusur Apache Solr (Opsional)

Secara default, modul Drupal yang terhubung ke mesin telusur Apache Solr dinonaktifkan saat Anda menginstal portal. Sebagian besar portal menggunakan mesin telusur Drupal internal, sehingga tidak memerlukan modul Solr Drupal.

Jika Anda memutuskan untuk menggunakan Solr sebagai mesin telusur, Anda harus menginstal Solr secara lokal di server Anda, lalu mengaktifkan dan mengonfigurasi modul Drupal Solr di portal.

Untuk mengaktifkan modul Drupal Solr:

1. Login ke portal Anda sebagai pengguna dengan hak istimewa admin atau pembuatan konten.
2. Pilih Modules di menu Drupal.
3. Aktifkan modul Apache Solr Framework dan modul Apache Solr Search.
4. Simpan perubahan.
5. Konfigurasikan Solr seperti yang dijelaskan di https://drupal.org/node/1999280.

9. Menginstal mod_ssl untuk mendukung HTTPS (Opsional)

Modul mod_ssl digunakan oleh Server HTTP Apache untuk menyajikan halaman web melalui HTTPS. Jika Anda ingin menggunakan HTTPS, gunakan perintah berikut untuk menginstal mod_ssl:

> yum install mod_ssl

Untuk mengetahui informasi selengkapnya tentang cara mengonfigurasi portal agar menggunakan SSL, lihat http://apigee.com/docs/developer-services/content/using-ssl-portal.

10. Menginstal SmartDocs (Opsional)

SmartDocs memungkinkan Anda mendokumentasikan API di portal Layanan Developer dengan cara yang membuat dokumentasi API sepenuhnya interaktif. Namun, untuk menggunakan SmartDocs dengan portal, Anda harus menginstal SmartDocs di Edge terlebih dahulu.

• Jika Anda menghubungkan portal ke penginstalan Edge Cloud, SmartDocs sudah diinstal dan tidak diperlukan konfigurasi lebih lanjut.
• Jika Anda menghubungkan portal ke penginstalan Edge for Private Cloud, Anda harus memastikan bahwa SmartDocs diinstal di Edge. Untuk mengetahui informasi selengkapnya tentang cara menginstal Edge dan SmartDocs, lihat Menginstal SmartDocs.

Untuk mengetahui informasi selengkapnya tentang SmartDocs, lihat Menggunakan SmartDocs untuk mendokumentasikan API.

11. Apa langkah berikutnya?

Langkah berikutnya setelah menginstal portal Layanan Developer adalah mengonfigurasi dan menyesuaikannya untuk kebutuhan spesifik Anda. Dokumentasi di situs Apigee berisi semua informasi tentang cara mengonfigurasi, menata gaya, dan mengelola portal. Akses dokumentasi di http://apigee.com/docs/developer-services/content/what-developer-portal.

Tabel berikut mencantumkan beberapa tugas paling umum yang Anda lakukan setelah penginstalan, dan menyertakan link ke dokumentasi Apigee tempat Anda dapat menemukan informasi selengkapnya: