Developer Services Portal v. 4.16.09
Berikut adalah persyaratan hardware dan software untuk penginstalan.
Hardware |
Persyaratan |
Sistem operasi |
Petunjuk penginstalan ini dan file penginstalan yang disediakan telah diuji pada sistem operasi yang tercantum di sini: https://apigee.com/docs/api-services/reference/supported-software |
RAM |
1 GB |
Hard disk |
10 GB |
Antarmuka jaringan |
Perlu koneksi internet yang aktif. Sebagai bagian dari proses penginstalan, penginstal akan mendownload resource dari web. Jika lingkungan Anda disiapkan untuk mem-proxy permintaan HTTP dan HTTPS keluar, proxy Anda harus dikonfigurasi untuk menangani permintaan yang dialihkan yang mungkin terjadi selama download dengan benar. Misalnya, permintaan ke https://drupal.org/ akan menampilkan kode status HTTP 301 dan mengalihkan ke https://www.drupal.org/. Proxy Anda harus dikonfigurasi untuk menampilkan kode status HTTP 200 dengan konten yang diminta dari pengalihan. Untuk penginstalan SAP, jika lingkungan Anda disiapkan untuk melakukan proxy permintaan HTTPS keluar, proxy Anda harus mendukung TLSv1.0. OpenSSL 0.9.8 tidak mendukung TLSv1.1 atau TLSv1.2, hanya TLSv1.0. |
Persyaratan Database MySQL
Jika Anda memilih untuk menginstal Server MySQL di mesin yang sama dengan Layanan Developer Channel, topologi satu mesin, penginstal Layanan Developer Channel akan meminta Anda untuk memasukkan nama database dan pengguna database, lalu menginstal Server MySQL dan membuat skema database untuk Anda. Versi yang diinstal adalah versi terbaru yang tersedia untuk OS Anda.
Jika ingin Server MySQL diinstal pada sistem terpisah, Anda harus sudah menginstal Server MySQL pada sistem tersebut sebelum memulai penginstal Layanan Saluran Developer. Anda harus menginstal MySQL 5.0.15 atau yang lebih baru.
Penginstal Layanan Saluran Developer mewajibkan Server MySQL berisi database dengan skema database kosong. Penginstal Layanan Saluran Developer akan meminta nama host database, nama database, dan pengguna database. Kemudian, penginstal akan terhubung ke database untuk membuat tabel dan data database default.
Pengguna database digunakan oleh Layanan Saluran Developer untuk terhubung ke database, dan harus memiliki hak istimewa berikut: SELECT, INSERT, UPDATE, DELETE, CREATE, DROP, INDEX, ALTER, CREATE TEMPORARY TABLES, LOCK TABLES.
Misalnya, untuk membuat database bernama devportal, dan pengguna bernama devportal:
- Instal Server MySQL di sistem.
- Login ke MySQL sebagai pengguna root menggunakan perintah:
> mysql -u root -p - Masukkan sandi root saat diminta.
- Pada perintah mysql>, masukkan perintah berikut untuk membuat pengguna devportal:
mysql>create user 'devportal'@'localhost' identified by 'devportal';
mysql> grant all privileges on *.* to 'devportal'@'localhost';
mysql> flush privileges;
mysql> quit - Pada perintah sistem, buat database devportal:
> mysqladmin -u devportal -p create devportal
Masukkan sandi devportal. - Login ke MySQL dan berikan akses ke devportal dari IP server portal:
mysql> GRANT ALL ON devportal.* TO devportal@'portalIP' IDENTIFIED BY 'devportalPW';
dengan portalIP adalah alamat IP server portal, dan devportalPW adalah sandi pengguna devportal. - Edit /etc/my.cnf untuk menetapkan bind-address ke alamat IP server MySQL.
- Mulai ulang MySQL:
> /etc/init.d/mysqld restart - Pastikan port 3306 terbuka di server MySQL. Prosedur ini didasarkan pada sistem operasi Anda. Misalnya, untuk Linux, gunakan perintah:
> /sbin/iptables -A INPUT -i eth0 -p tcp --destination-port 3306 -j ASSET
Saat Anda menginstal Layanan Saluran Developer, tentukan untuk tidak menginstal Server MySQL secara lokal. Anda kemudian akan diminta untuk memasukkan alamat IP, nama pengguna, dan nama database dari database jarak jauh.
Persyaratan Red Hat Enterprise Linux (RHEL)
RHEL memiliki persyaratan tambahan karena adanya langganan yang diperlukan untuk mengakses download software dari Red Hat. Server harus dapat terhubung ke Internet untuk mendownload RPM melalui yum. Jika menggunakan RHEL, server harus terdaftar di Red Hat Network (RHN) dan terdaftar ke saluran opsional server.
Persyaratan Red Hat diperiksa selama penginstalan dan penginstal portal akan meminta Anda jika RHEL belum terdaftar. Jika sudah memiliki kredensial login Red Hat, Anda dapat menggunakan perintah berikut untuk mendaftarkan RHEL sebelum memulai proses penginstalan:
> subscription-manager register --username=my_username --password=my_password --auto-attach
Ganti my_username dan my_password dengan kredensial Red Hat Anda.
Jika memiliki RHEL versi uji coba, Anda bisa mendapatkan lisensi uji coba 30 hari. Lihat https://access.redhat.com/solutions/32790 untuk informasi selengkapnya.
Persyaratan SMTP
Secara default, portal mengirim email menggunakan fungsi mail() PHP. PHP mencoba mengirim email menggunakan sendmail di sistem lokal, yang dapat dikonfigurasi dalam file php.ini PHP.
Di lingkungan produksi, Apigee mengharuskan Anda mengonfigurasi server SMTP untuk mengirim pesan email dari portal. Oleh karena itu, Anda harus memastikan bahwa Drupal dapat mengakses port yang diperlukan di server SMTP. Untuk SMTP non-TLS, nomor port biasanya 25. Untuk SMTP yang mengaktifkan TLS, portnya sering kali 465, tetapi periksa dengan penyedia SMTP Anda.
Persyaratan Tambahan
Untuk melakukan penginstalan, pengguna yang menginstal software harus memiliki akses root.
Persyaratan Arsitektur Deployment
Layanan Saluran Developer memiliki satu antarmuka dengan Server Pengelolaan Apigee melalui REST API untuk menyimpan dan mengambil informasi tentang aplikasi pengguna. Layanan Channel Developer harus dapat terhubung ke Server Pengelolaan melalui HTTP atau HTTPS, bergantung pada penginstalan Anda.
Informasi yang Diperlukan Sebelum Anda Memulai Penginstalan
Sebelum memulai penginstalan, Anda harus memiliki informasi berikut:
- Platform mana yang Anda konfigurasi: Red Hat atau CentOS? Jika ini adalah penginstalan Red Hat, mesin harus terdaftar di Red Hat Network untuk mendownload RPM.
- Apakah Anda berencana menginstal MySQL di komputer lokal? Beberapa penginstalan HA mengharuskan MySQL berada di komputer yang berbeda dengan komputer yang menayangkan halaman web portal. Jika demikian, jangan instal MySQL secara lokal. Jika Anda menginginkan penginstalan sederhana dengan semua hal di mesin yang sama, instal MySQL secara lokal.
- Jika Anda ingin mengakses server MySQL jarak jauh, nama host, port, nama database, nama pengguna, dan sandi server MySQL jarak jauh. Server MySQL jarak jauh harus sudah dikonfigurasi sebelum Anda memulai penginstalan.
- Apa nama domain yang sepenuhnya memenuhi syarat dari server web? (Informasi ini akan ditambahkan ke /etc/hosts.) Ini harus berupa alamat IP atau nama host, seperti portalserver.example.com. Nilai defaultnya adalah localhost.
- Anda ingin menggunakan konfigurasi default Apigee untuk host virtual Apache? Satu host virtual dibuat dengan nama host yang Anda tentukan di atas pada Langkah 7.
- Ada tiga informasi yang memungkinkan portal Anda berkomunikasi dengan server pengelolaan Apigee Edge. Informasi ini sebagai berikut:
- URL Endpoint API Pengelolaan Apigee: URL ini dapat berupa nama host atau alamat IP. Ini adalah endpoint REST tempat semua panggilan dilakukan untuk membuat
aplikasi dan mendaftarkan developer untuk kunci aplikasi. Endpoint default adalah https://api.enterprise.apigee.com/v1.
Untuk penginstalan Edge for Private Cloud, URL-nya berbentuk:
http://EdgeIp:8080/v1
atau:
https://EdgeIp:SSLport/v1
Dengan EdgeIp adalah alamat IP server pengelolaan Edge dan SSLport adalah port SSL untuk API pengelolaan Edge. Misalnya, 8443. - Nama Organisasi Apigee: Ada hubungan antara portal dan organisasi Apigee Edge. Anda akan menyiapkan organisasi default saat menyiapkan Endpoint API Pengelolaan. Nilai defaultnya adalah my-org.
- Nama pengguna dan sandi untuk endpoint API pengelolaan: Panggilan dari portal ke Edge harus dilakukan oleh administrator untuk organisasi Anda.
Nama pengguna/sandi ini ditujukan untuk administrator di organisasi Anda dan hanya boleh digunakan untuk terhubung ke Edge dari portal. Misalnya, jika Anda menentukan kredensial pengguna, dan pengguna tersebut pernah dihapus di Edge, portal tidak akan dapat lagi terhubung ke Edge. Oleh karena itu, buat administrator di organisasi Anda hanya untuk koneksi ini.
Misalnya:
dc_devportal+ORGNAME@apigee.com:MyP@ssw0rd
- URL Endpoint API Pengelolaan Apigee: URL ini dapat berupa nama host atau alamat IP. Ini adalah endpoint REST tempat semua panggilan dilakukan untuk membuat
aplikasi dan mendaftarkan developer untuk kunci aplikasi. Endpoint default adalah https://api.enterprise.apigee.com/v1.