Penginstalan portal Layanan Developer

Portal Layanan Developer v. 4.16.05

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

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.

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. Pastikan sistem Anda memenuhi persyaratan sistem

Sebelum menginstal portal, server Anda harus memenuhi persyaratan berikut:

1. 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.
2. Pastikan Yum telah diinstal.
3. (Untuk penginstalan di server tanpa koneksi Internet) Anda harus mendownload semua file yang diperlukan terlebih dahulu ke server dengan koneksi Internet sebagai satu file .tar.gz. Kemudian, Anda menyalin file .tar.gz tersebut ke server tanpa koneksi Internet untuk melakukan penginstalan.
   1. Login ke server dengan koneksi Internet sebagai root atau sebagai superuser.
   2. Buat direktori untuk file penginstalan, seperti portal_tar.
   3. CD ke direktori baru dan download file DeveloperServices_x.y.z.tar Developer Channel Services, 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
      
      Perintah tersebut akan mendownload semua file yang diperlukan dan memasukkannya ke dalam satu file .tar.gz. Kemudian, salin file .tar.gz tersebut ke server yang tidak memiliki koneksi internet untuk menyelesaikan penginstalan.
4. 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. Menginstal Developer Channel Services menggunakan skrip penginstalan otomatis

Gunakan prosedur berikut untuk menginstal portal menggunakan skrip penginstalan otomatis. Prosedur ini berfungsi untuk server dengan atau tanpa koneksi internet eksternal.

1. Login ke server sebagai root atau sebagai superuser.
2. Buat direktori untuk file penginstalan, seperti portal.
3. Di server dengan koneksi internet:
   1. CD ke direktori portal baru dan download file DeveloperServices_x.y.z.tar Layanan Saluran 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>
   2. Ekstrak konten file .tar Developer Channel Services menggunakan perintah:
      > tar -xvf <tar file>
   3. CD ke DeveloperServices-4.x.y.z.
   4. Jalankan skrip penginstalan menggunakan perintah berikut:
      > ./networked-install.sh
4. Di server tanpa koneksi internet:
   1. Salin file .tar.gz yang Anda buat di atas pada bagian 2. Pastikan sistem Anda memenuhi persyaratan sistem.
   2. Ekstrak konten file .tar.gz menggunakan perintah:
      > tar -xvf <tar file>
   3. CD ke direktori yang dibuat oleh perintah tar.
   4. Tetapkan izin pada skrip install-from-rpm-bundle.sh:
      > chmod 755 install-from-rpm-bundle.sh
   5. Jalankan skrip install-from-rpm-bundle.sh menggunakan perintah:
      > ./install-from-rpm-bundle.sh
5. Jawab perintahnya.
6. Setelah penginstalan selesai, 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.
7. Konfigurasikan koneksi ke MySQL. Jika MySQL berada di mesin jarak jauh, luaskan bagian Advanced Options dan masukkan informasi koneksi ke mesin tersebut, lalu pilih Save and continue.
8. 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. Organisasi Portal Dev
   2. URL Endpoint Portal Developer
   3. Pengguna Terautentikasi Endpoint
   4. Sandi Pengguna yang Diautentikasi
9. Saat diminta, pilih tombol Install Sample SmartDocs WADL untuk menginstal contoh SmartDocs WADL. Jika Anda melewati langkah ini, contoh SmartDocs API tidak akan muncul di portal Anda.
   Catatan: Jika portal Anda terhubung ke penginstalan Apigee Edge for Private Cloud, dan penginstalan Edge tersebut tidak memiliki koneksi internet eksternal, Anda harus melakukan konfigurasi tambahan pada modul SmartDocs sebelum dapat menggunakan SmartDocs. Untuk informasi selengkapnya tentang SmartDocs, lihat http://apigee.com/docs/developer-services/content/using-smartdocs-document-apis.
10. Konfigurasikan SMTP Server Settings. Apigee mengharuskan Anda mengonfigurasi server SMTP untuk mengirim pesan email dari portal.
    Untuk informasi selengkapnya, lihat http://apigee.com/docs/developer-services/content/configuring-email.
11. 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
12. Setelah penginstalan selesai, tetapkan izin pada file settings.php:
    > chmod 640 /var/www/html/sites/default/settings.php
13. Buka halaman beranda portal di http://localhost/ atau ke nama DNS portal Anda.
14. Login ke portal menggunakan kredensial administrator.

4. Membuat pengguna admin

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. Opsional - Men-deploy di server produksi

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. Opsional - Mengonfigurasi mesin telusur Apache Solr

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. Opsional - Menginstal mod_ssl untuk mendukung HTTPS

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. Opsional - Menginstal SmartDocs

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: