Penginstalan portal Layanan Developer

Portal Layanan Developer v. 4.16.05

Ikuti langkah-langkah berikut untuk menginstal portal Layanan Saluran Developer.

Sebelum melanjutkan penginstalan, buat cadangan seluruh root web Drupal Anda saat ini. Lokasi penginstalan default adalah /var/www/html, tetapi Anda mungkin telah mengubahnya pada waktu penginstalan. Setelah melakukan langkah penginstalan yang dijelaskan di bawah, Anda dapat memulihkan dan penyesuaian dari cadangan.

1. Mendapatkan paket Layanan Saluran Developer

Buka http://community.apigee.com/content/apigee-customer-support lalu pilih Login ke Portal Dukungan untuk meminta file {i> .tar<i} Layanan Saluran Pengembang salah satu dari dua cara:

  • Minta akses ke direktori download Edge untuk Private Cloud.
  • Minta URL ke file .tar Layanan Saluran Developer.

2. Pastikan sistem Anda memenuhi sistem persyaratan

Sebelum menginstal portal, server Anda harus memenuhi persyaratan berikut:

  1. Pastikan bahwa Anda melakukan penginstalan pada versi 64-bit dari versi yang didukung Red Hat Enterprise Linux, CentOS, atau Oracle. Lihat daftar versi yang didukung di sini.
  2. Pastikan Yum telah diinstal.
  3. (Untuk penginstalan pada server tanpa koneksi internet) Anda harus mengunduh semua file yang diperlukan ke server dengan koneksi Internet sebagai satu {i>.tar.gz<i}. Anda kemudian menyalin file {i> .tar.gz<i} ke server tanpa koneksi Internet ke melakukan penginstalan.
    1. Masuk ke server dengan koneksi Internet sebagai {i>root<i} atau sebagai {i>superuser<i}.
    2. Buat direktori untuk file instal, seperti portal_tar.
    3. CD ke direktori baru dan download Layanan Saluran Developer DeveloperServices_x.y.z.tar file, dengan x.y.z sesuai dengan nomor versi portal.
    4. Ekstrak konten file .tar Developer Channel Services menggunakan perintah perintah:
      &gt; {i>tar -xvf<i} file&gt;
    5. CD ke DeveloperServices-4.x.y.z.
    6. Buat file .tar.gz portal dengan menggunakan perintah:
      &gt; ./non-networked-install.sh

      Perintah itu mengunduh semua file yang diperlukan dan menjadi satu file {i> .tar.gz<i}. Anda lalu salin file {i> .tar.gz<i} itu ke server Anda yang tidak memiliki koneksi Internet untuk menyelesaikan diinstal.
  4. Uji koneksi Anda ke server pengelolaan Edge dengan menjalankan perintah cURL berikut dari command prompt di server portal:
    &gt; {i>curl -u<i} {EMAIL}:{PASSWORD} https://{hostname}:8080/v1/organizations/{ORGNAME}

    Email dengan EMAIL dan PASSWORD adalah email alamat dan sandi administrator untuk ORGNAME.

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

    Jika berhasil, perintah ini akan menampilkan respons yang mirip dengan berikut ini:
    {
    "dibuatAt" : 1348689232699,
    "dibuatoleh" : "NAMA PENGGUNA",
    &quot;displayName&quot; : "cg",
    "lingkungan" : [ "test", "prod" ],
    "lastModifiedAt" : 1348689232699,
    "lastModifiedBy" : "foo@bar.com",
    "nama" : "cg",
    "properti" : {
    "properti" : [ ]
    },
    "jenis" : "uji coba"
    }

3. Instal Developer Layanan Saluran yang menggunakan skrip penginstalan otomatis

Gunakan prosedur berikut untuk menginstal portal menggunakan skrip penginstalan otomatis. Ini bekerja untuk server dengan atau tanpa koneksi Internet eksternal.

  1. Masuk ke server sebagai {i>root<i} atau sebagai {i>superuser<i}.
  2. Buat direktori untuk file instal, seperti portal.
  3. Di server dengan koneksi internet:
    1. CD ke portal baru dan mendownload Layanan Saluran Developer DeveloperServices_x.y.z.tar file, 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:
      &gt; curl -kOL <tempel link here&gt;
    2. Ekstrak konten file .tar Developer Channel Services menggunakan perintah perintah:
      &gt; {i>tar -xvf<i} file&gt;
    3. CD ke DeveloperServices-4.x.y.z.
    4. Jalankan skrip penginstalan menggunakan perintah berikut:
      &gt; ./networked-install.sh
  4. Di server tanpa koneksi internet:
    1. Salin file .tar.gz yang telah Anda buat di atas di bagian 2. Pastikan sistem Anda memenuhi persyaratan sistem.
    2. Ekstrak konten file .tar.gz dengan menggunakan perintah:
      &gt; {i>tar -xvf<i} file&gt;
    3. CD ke direktori yang dibuat oleh perintah {i>tar<i}.
    4. Tetapkan izin pada skrip install-from-rpm-bundle.sh:
      &gt; Chmod 755 install-from-rpm-bundle.sh
    5. Jalankan skrip install-from-rpm-bundle.sh dengan menggunakan perintah:
      &gt; ./install-from-rpm-bundle.sh
  5. Jawab perintahnya.
  6. Setelah penginstalan selesai, buka URL server di browser, misalnya sebagai:
    http://localhost. Atau, jika Anda memiliki IP atau DNS khusus terkonfigurasi, buka http://IP_address atau http://DNS_name.

    Anda akan dialihkan ke halaman konfigurasi Database profil Apigee.

    Catatan: Biasanya, Anda sudah mengonfigurasi nama host dan mendaftarkannya dengan server DNS sehingga Anda tidak perlu menggunakan http://localhost.
  7. Konfigurasikan koneksi ke MySQL. Jika MySQL berada di komputer jarak jauh, perluas Advanced Options, masukkan informasi koneksi ke komputer tersebut, lalu Pilih Simpan dan lanjutkan.
  8. Konfigurasikan koneksi ke Endpoint Apigee dengan memasukkan informasi berikut, dan lalu pilih Save:
    Untuk informasi selengkapnya tentang nilai ini, lihat "Informasi yang Diperlukan Sebelum Anda Memulai Penginstalan" di portal Layanan Developer persyaratan layanan.
    1. Organisasi Portal Developer
    2. URL Endpoint Portal Dev
    3. Pengguna yang Diautentikasi Endpoint
    4. Pengguna yang Diautentikasi Sandi
  9. Saat diminta, pilih tombol Install Sample SmartDocs WADL untuk menginstal contoh WADL SmartDocs. Jika Anda melewati langkah ini, contoh SmartDocs API tidak akan muncul di portal Anda.
    Catatan: Jika portal Anda terhubung ke penginstalan Apigee Edge untuk Private Cloud, dan penginstalan Edge tidak memiliki koneksi internet eksternal, konfigurasi tambahan modul SmartDocs sebelum Anda dapat menggunakan SmartDocs. Untuk selengkapnya informasi terkait 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 mengetahui informasi selengkapnya, lihat http://apigee.com/docs/developer-services/content/configuring-email.
  11. Konfigurasikan pengguna administrator dengan memasukkan informasi berikut, lalu pilih {i>Save<i}. Perlu diperhatikan bahwa Drupal membuat pengguna admin bernama 'admin' secara default, jadi jangan gunakan 'admin' sebagai nama pengguna.
    Jika melewati langkah ini, Anda tetap dapat menggunakan Drush untuk membuat administrator seperti yang dijelaskan di bawah pada 4. Membuat pengguna admin.
    1. Nama depan dan belakang developer
    2. Nama pengguna portal developer
    3. Password
    4. Alamat email
  12. Setelah penginstalan selesai, setel izin pada file settings.php:
    &gt; 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 Layanan Saluran Developer Anda. Drupal otomatis membuat pengguna admin bernama 'admin' secara default, jadi jangan gunakan 'admin' sebagai nama pengguna.

  1. ke direktori {i>drupal_root/sites/default<i} Anda. Lokasi standar untuk root Drupal direktorinya adalah /var/www/html:
    &gt; cd &lt;drupal_root&gt;/sites/default
  2. Pastikan Anda memiliki izin tulis pada file Drupal pribadi:
    &gt; Drush Vget file_private_path

    Perintah ini akan 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
    {i>chmod -R o+r dirPathAndName
  3. Masukkan perintah berikut untuk membuat pengguna admin, dengan mengganti perintah di “< >” dengan nilai Anda:
    &gt; buat pengguna terpisah <nama pengguna> --mail=&quot;&lt;email-address&gt;&quot; --password=&quot;&lt;password&gt;&quot;
    &gt; drush pengguna-peran tambahan Administrator <username>
  4. Login ke portal developer sebagai admin menggunakan nama pengguna dan sandi yang ditentukan di atas.

5. Menyetel sandi root MySQL

Jika Anda menginstal MySQL sebagai bagian dari penginstalan portal, skrip penginstalan akan Sandi root MySQL ditetapkan ke nilai defaultnya, yang kosong.

Gunakan perintah berikut untuk menyetel sandi root:

> mysqladmin -u root password NEWPASSWORD

Jika sebelumnya Anda telah menyetel sandi {i>root<i} dan ingin mengubahnya, gunakan berikut:

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

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

6. Pastikan modul Update manager telah aktif

Untuk menerima notifikasi update Drupal, pastikan modul pengelola Update Drupal mengaktifkan pembuatan versi. Dari menu Drupal, pilih Modules dan scroll ke bawah ke Modul Update manager. Jika belum aktif, aktifkan terlebih dahulu.

Setelah diaktifkan, Anda dapat melihat pembaruan yang tersedia menggunakan Laporan > Tersedia Item menu Pembaruan. Anda juga dapat menggunakan perintah Drush berikut:

> drush pm-info update

Gunakan Laporan > Update yang Tersedia > Item menu Settings yang akan dikonfigurasi modul untuk mengirimkan email kepada Anda saat pembaruan tersedia dan menyetel frekuensi pemeriksaan pembaruan.

7. Opsional - Men-deploy pada produksi server

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

  1. Jalankan skrip berikut untuk mengamankan penginstalan MySQL Anda:
    &gt; /usr/bin/mysql_secure_installation

    Skrip ini menyetel sandi root dan memberi Anda opsi untuk membatasi akses root hanya ke {i>localhost<i} dan untuk menghapus {i>database<i} pengujian serta pengguna anonim yang dibuat secara {i>default<i}. Menjalankan {i>script<i} sangat disarankan untuk server produksi.
  2. Jika diperlukan oleh kebijakan perusahaan Anda, aktifkan dan konfigurasi SELinux.

8. Opsional - Mengonfigurasi Apache Solr mesin telusur

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

Jika memutuskan untuk menggunakan Solr sebagai mesin telusur, Anda harus menginstal Solr secara lokal di server lalu aktifkan dan konfigurasikan 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 Apache Solr Penelusuran.
  4. Simpan perubahan.
  5. Konfigurasikan Solr seperti yang dijelaskan di https://drupal.org/node/1999280.

9. Opsional - Instal mod_ssl ke dukungan HTTPS

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

> yum install mod_ssl

Untuk informasi selengkapnya tentang 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 memudahkan Dokumentasi API yang sepenuhnya interaktif. Namun, untuk menggunakan SmartDocs dengan portal, Anda harus terlebih dahulu menginstal SmartDocs di Edge.

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

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

11. Apa selanjutnya?

Langkah selanjutnya setelah Anda menginstal portal Layanan Developer adalah mengonfigurasi dan menyesuaikan untuk kebutuhan spesifik Anda. Dokumentasi di situs web 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 instalasi, serta menyertakan link ke dokumentasi Apigee tempat Anda dapat menemukan informasi lebih lanjut:

Tugas

Deskripsi

Menyesuaikan tema

Tema menentukan tampilan portal, termasuk warna, gaya, dan aspek visual.

Sesuaikan tampilan

Halaman beranda mencakup menu utama, pesan selamat datang, header, footer, dan judul.

Tambahkan dan mengelola akun pengguna

Proses pendaftaran mengontrol cara developer baru mendaftarkan akun di portal. Misalnya, apakah developer baru mendapatkan akses langsung ke portal, atau apakah mereka harus diverifikasi oleh administrator. Proses ini juga mengontrol cara portal administrator akan diberi tahu ketika akun baru dibuat.

Mengonfigurasi email

Portal mengirim email sebagai tanggapan terhadap peristiwa tertentu. Misalnya, ketika developer mendaftar di portal dan saat developer kehilangan sandi.

Tambahkan dan mengelola akun pengguna

Tambahkan Persyaratan & Halaman ketentuan yang harus disetujui developer sebelum diizinkan mengakses portal.

Tambahkan dan mengelola akun pengguna

Portal tersebut menerapkan model otorisasi berbasis peran. Sebelum mengizinkan pengembang untuk daftar, tentukan izin dan peran yang digunakan oleh portal.

Tambahkan blog dan postingan forum

Portal ini memiliki dukungan bawaan untuk blog dan forum berangkai. Menentukan izin diperlukan untuk melihat, menambahkan, mengedit, dan menghapus postingan blog dan forum.

Pastikan Anda melakukan pencadangan database

Pastikan Anda mencadangkan database Drupal. Perhatikan bahwa karena setiap berbeda, terserah Anda untuk menentukan cara terbaik mencadangkan di skrip untuk menyiapkan database.

Siapkan nama host

Jika Anda tidak menyiapkan nama {i>host<i} di server DNS, Anda selalu dapat mengakses situs itu melalui menggunakan alamat IP server. Jika Anda ingin menggunakan nama {i>host<i}, Anda dapat mengkonfigurasi DNS untuk server, yang seharusnya berfungsi dengan baik tanpa perlu konfigurasi lain pada pengaturan dasar.

Jika Anda menyiapkan load balancer atau mendapatkan URL yang salah di situs untuk beberapa alasan lain, Anda dapat mengatur $base_url dalam file settings.php Portal Dev, yang secara default terletak di /var/www/html/sites/default saat ini.