Persyaratan Penginstalan

Edge for Private Cloud v4.18.01

Persyaratan Hardware

Anda harus memenuhi persyaratan hardware minimum berikut untuk infrastruktur dengan tingkat ketersediaan tinggi di lingkungan tingkat produksi. Untuk semua skenario penginstalan yang dijelaskan dalam Topologi Penginstalan, tabel berikut mencantumkan persyaratan hardware minimum untuk komponen penginstalan.

Dalam tabel ini, persyaratan hard disk merupakan tambahan dari kapasitas hard disk yang diperlukan oleh sistem operasi. Bergantung pada aplikasi dan traffic jaringan Anda, penginstalan Anda mungkin memerlukan lebih banyak atau lebih sedikit resource daripada yang tercantum di bawah.

Selain itu, berikut adalah daftar persyaratan hardware jika Anda ingin menginstal Layanan Monetisasi:

Berikut adalah persyaratan hardware jika Anda ingin menginstal API BaaS:

Persyaratan Sistem Operasi dan software pihak ketiga

Petunjuk penginstalan ini dan file penginstalan yang disediakan telah diuji pada sistem operasi dan software pihak ketiga yang tercantum dalam Software yang didukung dan versi yang didukung.

Membuat pengguna apigee

Prosedur penginstalan membuat pengguna sistem Unix bernama 'apigee'. Direktori dan file Edge dimiliki oleh 'apigee', begitu juga dengan proses Edge. Artinya, komponen Edge berjalan sebagai pengguna 'apigee'. Jika perlu, Anda dapat menjalankan komponen sebagai pengguna lain.

Direktori penginstalan

Secara default, penginstal menulis semua file ke direktori /opt/apigee. Anda tidak dapat mengubah lokasi direktori ini. Meskipun Anda tidak dapat mengubah direktori ini, Anda dapat membuat symlink untuk memetakan /opt/apigee ke lokasi lain, seperti yang dijelaskan di bawah.

Dalam petunjuk di panduan ini, direktori penginstalan dicatat sebagai /opt/apigee.

Membuat symlink dari /opt/apigee

Sebelum membuat symlink, Anda harus membuat pengguna dan grup bernama "apigee" terlebih dahulu. Ini adalah grup dan pengguna yang sama yang dibuat oleh penginstal Edge.

Untuk membuat symlink, lakukan langkah-langkah berikut sebelum mendownload file bootstrap_4.18.01.sh. Anda harus melakukan semua langkah ini sebagai root:

1. Buat pengguna dan grup "apigee":

   groupadd -r apigee > useradd -r -g apigee -d /opt/apigee -s /sbin/nologin -c "Apigee platform user" apigee

2. Buat symlink dari /opt/apigee ke root penginstalan yang Anda inginkan:

   ln -Ts /srv/myInstallDir /opt/apigee

   dengan /srv/myInstallDir adalah lokasi file Edge yang diinginkan.

3. Ubah kepemilikan root penginstalan dan symlink ke pengguna "apigee":

   chown -h apigee:apigee /srv/myInstallDir /opt/apigee

Java

Anda memerlukan Java 1.8 versi yang didukung yang diinstal di setiap komputer sebelum penginstalan. JDK yang didukung tercantum dalam Software yang didukung dan versi yang didukung.

Pastikan JAVA_HOME mengarah ke root JDK untuk pengguna yang melakukan penginstalan.

SELinux

Bergantung pada setelan Anda untuk SELinux, Edge dapat mengalami masalah saat menginstal dan memulai komponen Edge. Jika perlu, Anda dapat menonaktifkan SELinux atau menyetelnya ke mode permisif selama penginstalan, lalu mengaktifkannya kembali setelah penginstalan. Lihat Menginstal utilitas apigee-setup Edge untuk mengetahui informasi selengkapnya.

Setelan Jaringan

Sebaiknya periksa setelan jaringan sebelum penginstalan. Penginstal mengharapkan semua mesin memiliki alamat IP tetap. Gunakan perintah berikut untuk memvalidasi setelan:

• hostname menampilkan nama mesin
• hostname -i menampilkan alamat IP untuk nama host yang dapat diakses dari mesin lain.

Bergantung pada jenis dan versi sistem operasi, Anda mungkin harus mengedit /etc/hosts dan /etc/sysconfig/network jika nama host tidak ditetapkan dengan benar. Lihat dokumentasi untuk sistem operasi spesifik Anda guna mendapatkan informasi selengkapnya.

Jika server memiliki beberapa kartu antarmuka, perintah "hostname -i" akan menampilkan daftar alamat IP yang dipisahkan spasi. Secara default, penginstal Edge menggunakan alamat IP pertama yang ditampilkan, yang mungkin tidak benar dalam semua situasi. Sebagai alternatif, Anda dapat menetapkan properti berikut dalam file konfigurasi penginstalan:

ENABLE_DYNAMIC_HOSTIP=y

Dengan properti tersebut ditetapkan ke "y", penginstal akan meminta Anda memilih alamat IP yang akan digunakan sebagai bagian dari penginstalan. Nilai defaultnya adalah "n". Lihat Referensi File Konfigurasi Edge untuk mengetahui informasi selengkapnya.

TCP Wrapper

TCP Wrapper dapat memblokir komunikasi beberapa port dan dapat memengaruhi penginstalan OpenLDAP, Postgres, dan Cassandra. Pada node tersebut, periksa /etc/hosts.allow dan /etc/hosts.deny untuk memastikan tidak ada batasan port pada port OpenLDAP, Postgres, dan Cassandra yang diperlukan.

iptables

Pastikan tidak ada kebijakan iptables yang mencegah konektivitas antar-node pada port Edge yang diperlukan. Jika perlu, Anda dapat menghentikan iptables selama penginstalan menggunakan perintah:

sudo/etc/init.d/iptables stop

Di CentOS 7.x:

systemctl stop firewalld

Memastikan Router Edge dapat mengakses /etc/rc.d/init.d/functions

Node Router Edge dan Portal BaaS menggunakan router Nginx dan memerlukan akses baca ke /etc/rc.d/init.d/functions.

Jika proses keamanan mengharuskan Anda menetapkan izin di /etc/rc.d/init.d/functions, jangan tetapkan ke 700 atau router akan gagal dimulai. Izin dapat ditetapkan ke 744 untuk mengizinkan akses baca ke /etc/rc.d/init.d/functions.

Cassandra

Semua node Cassandra harus terhubung ke ring. Cassandra menyimpan replika data di beberapa node untuk memastikan keandalan dan fault tolerance. Strategi replikasi untuk setiap keyspace Edge menentukan node Cassandra tempat replika ditempatkan. Untuk mengetahui informasi selengkapnya,lihat Tentang Faktor Replikasi dan Tingkat Konsistensi Cassandra.

Cassandra secara otomatis menyesuaikan ukuran heap Java-nya berdasarkan memori yang tersedia. Untuk mengetahui informasi selengkapnya, lihat Menyesuaikan resource Java. Jika terjadi penurunan performa atau konsumsi memori yang tinggi.

Setelah menginstal Edge untuk Private Cloud, Anda dapat memeriksa apakah Cassandra telah dikonfigurasi dengan benar dengan memeriksa file /opt/apigee/apigee-cassandra/conf/cassandra.yaml. Misalnya, pastikan skrip penginstalan Edge for Private Cloud menetapkan properti berikut:

• cluster_name
• initial_token
• partitioner
• seeds
• listen_address
• rpc_address
• snitch

Database PostgreSQL

Setelah menginstal Edge, Anda dapat menyesuaikan setelan database PostgreSQL berikut berdasarkan jumlah RAM yang tersedia di sistem Anda:

conf_postgresql_shared_buffers = 35% of RAM      # min 128kB
conf_postgresql_effective_cache_size = 45% of RAM
conf_postgresql_work_mem = 512MB       # min 64kB

Untuk menetapkan nilai ini:

1. Edit file postgresql.properties:

   vi /opt/apigee/customer/application/postgresql.properties

   Jika file tidak ada, buat file tersebut.

2. Tetapkan properti yang tercantum di atas.
3. Simpan hasil edit Anda.
4. Mulai ulang database PostgreSQL:

   /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql restart

Batas sistem

Pastikan Anda telah menetapkan batas sistem berikut pada node Cassandra dan Message Processor:

• Di node Cassandra, tetapkan batas memlock, nofile, dan ruang alamat (as) soft dan hard untuk pengguna penginstalan (defaultnya adalah “apigee") di /etc/security/limits.d/90-apigee-edge-limits.conf seperti yang ditunjukkan di bawah:

  apigee soft memlock unlimited
  apigee hard memlock unlimited
  apigee soft nofile 32768
  apigee hard nofile 65536
  apigee soft as unlimited
  apigee hard as unlimited

• Pada node Message Processor, tetapkan jumlah maksimum deskriptor file terbuka ke 64K di /etc/security/limits.d/90-apigee-edge-limits.conf seperti yang ditunjukkan di bawah:

  apigee soft nofile 32768
  apigee hard nofile 65536

  Jika perlu, Anda dapat menaikkan batas tersebut. Misalnya, jika Anda memiliki sejumlah besar file sementara yang terbuka pada satu waktu.

jsvc

"jsvc" adalah prasyarat untuk menggunakan API BaaS. Versi 1.0.15-dev diinstal saat Anda menginstal API BaaS.

Network Security Services (NSS)

Network Security Services (NSS) adalah serangkaian library yang mendukung pengembangan aplikasi klien dan server yang mendukung keamanan. Anda harus memastikan bahwa Anda telah menginstal NSS v3.19, atau yang lebih baru.

Untuk memeriksa versi saat ini:

yum info nss

Untuk mengupdate NSS:

yum update nss

Lihat artikel ini dari RedHat untuk mengetahui informasi selengkapnya.

Menonaktifkan pencarian DNS di IPv6 saat menggunakan NSCD (Name Service Cache Daemon)

Jika Anda telah menginstal dan mengaktifkan NSCD (Name Service Cache Daemon), Message Processor akan melakukan dua pencarian DNS: satu untuk IPv4 dan satu untuk IPv6. Anda harus menonaktifkan pencarian DNS di IPv6 saat menggunakan NSCD.

Untuk menonaktifkan pencarian DNS di IPv6:

1. Di setiap node Message Processor, edit /etc/nscd.conf
2. Tetapkan properti berikut:

   enable-cache hosts no

Menonaktifkan IPv6 di Google Cloud Platform untuk RedHat/CentOS 7

Jika Anda menginstal Edge di RedHat 7 atau CentOS 7 di Google Cloud Platform, Anda harus menonaktifkan IPv6 di semua node Qpid.

Lihat dokumentasi RedHat atau CentOS untuk versi OS spesifik Anda guna mengetahui petunjuk cara menonaktifkan IPv6. Misalnya, Anda dapat:

1. Buka /etc/hosts di editor.
2. Sisipkan karakter "#" di kolom satu pada baris berikut untuk menjadikannya sebagai komentar:

   #::1 localhost localhost.localdomain localhost6 localhost6.localdomain6

3. Simpan file.

AWS AMI

Jika Anda menginstal Edge di Amazon Machine Image (AMI) AWS untuk Red Hat Enterprise Linux 7.x, Anda harus menjalankan perintah berikut terlebih dahulu:

yum-config-manager --enable rhui-REGION-rhel-server-extras rhui-REGION-rhel-server-optional

Alat

Penginstal menggunakan alat UNIX berikut dalam versi standar seperti yang disediakan oleh EL5 atau EL6.

ntpdate

Sebaiknya sinkronkan waktu server. Jika belum dikonfigurasi, utilitas ntpdate dapat digunakan untuk tujuan ini, yang memverifikasi apakah server disinkronkan waktunya. Anda dapat menggunakan yum install ntp untuk menginstal utilitas. Hal ini sangat berguna untuk mereplikasi penyiapan OpenLDAP. Perhatikan bahwa Anda menyiapkan zona waktu server dalam UTC.

openldap 2.4

Penginstalan lokal memerlukan OpenLDAP 2.4. Jika server Anda memiliki koneksi Internet, skrip penginstalan Edge akan mendownload dan menginstal OpenLDAP. Jika server Anda tidak memiliki koneksi internet, Anda harus memastikan bahwa OpenLDAP sudah diinstal sebelum menjalankan skrip penginstalan Edge. Di RHEL/CentOS, Anda dapat menjalankan yum install openldap-clients openldap-servers untuk menginstal OpenLDAP.

Untuk penginstalan 13 host, dan penginstalan 12 host dengan dua Pusat Data, Anda memerlukan replikasi OpenLDAP karena ada beberapa node yang menghosting OpenLDAP.

Firewall dan Host Virtual

Istilah virtual biasanya digunakan secara berlebihan di bidang IT, begitu juga dengan deployment Apigee Edge untuk Private Cloud dan host virtual. Untuk memperjelas, ada dua penggunaan utama istilah virtual:

• Virtual machine (VM): Tidak diperlukan, tetapi beberapa deployment menggunakan teknologi VM untuk membuat server terisolasi bagi komponen Apigee mereka. Host VM, seperti host fisik, dapat memiliki antarmuka jaringan dan firewall.
• Host virtual: Endpoint web, yang serupa dengan host virtual Apache.

Router di VM dapat mengekspos beberapa host virtual (selama berbeda satu sama lain dalam alias host atau port antarmukanya).

Sebagai contoh penamaan, satu server fisik A mungkin menjalankan dua VM, bernama "VM1" dan "VM2". Mari kita asumsikan "VM1" mengekspos antarmuka Ethernet virtual, yang diberi nama "eth0" di dalam VM, dan yang diberi alamat IP 111.111.111.111 oleh mesin virtualisasi atau server DHCP jaringan; lalu asumsikan VM2 mengekspos antarmuka Ethernet virtual yang juga bernama "eth0" dan diberi alamat IP 111.111.111.222.

Kita mungkin memiliki router Apigee yang berjalan di setiap VM. Router mengekspos endpoint host virtual seperti dalam contoh hipotetis ini:

Router Apigee di VM1 mengekspos tiga host virtual di antarmuka eth0-nya (yang memiliki beberapa alamat IP tertentu), api.mycompany.com:80, api.mycompany.com:443, dan test.mycompany.com:80.

Router di VM2 mengekspos api.mycompany.com:80 (nama dan port yang sama dengan yang diekspos oleh VM1).

Sistem operasi host fisik mungkin memiliki firewall jaringan; jika demikian, firewall tersebut harus dikonfigurasi untuk meneruskan traffic TCP yang terikat untuk port yang diekspos pada antarmuka virtual (111.111.111.111:{80, 443} dan 111.111.111.222:80). Selain itu, setiap sistem operasi VM dapat menyediakan firewall-nya sendiri pada antarmuka eth0-nya dan firewall ini juga harus mengizinkan traffic port 80 dan 443 untuk terhubung.

Jalur dasar adalah komponen ketiga yang terlibat dalam perutean panggilan API ke berbagai proxy API yang mungkin telah Anda deploy. Paket proxy API dapat berbagi endpoint jika memiliki jalur dasar yang berbeda. Misalnya, satu jalur dasar dapat ditentukan sebagai http://api.mycompany.com:80/ dan jalur dasar lainnya ditentukan sebagai http://api.mycompany.com:80/salesdemo.

Dalam hal ini, Anda memerlukan load balancer atau traffic director tertentu yang memisahkan traffic http://api.mycompany.com:80/ di antara dua alamat IP (111.111.111.111 di VM1 dan 111.111.111.222 di VM2). Fungsi ini khusus untuk penginstalan tertentu, dan dikonfigurasi oleh grup jaringan lokal Anda.

Jalur dasar ditetapkan saat Anda men-deploy API. Dari contoh di atas, Anda dapat men-deploy dua API, mycompany dan testmycompany, untuk organisasi mycompany-org dengan host virtual yang memiliki alias host api.mycompany.com dan port yang ditetapkan ke 80. Jika Anda tidak mendeklarasikan jalur dasar dalam deployment, router tidak akan mengetahui API mana yang akan dikirimi permintaan masuk.

Namun, jika Anda men-deploy API testmycompany dengan URL dasar /salesdemo, pengguna akan mengakses API tersebut menggunakan http://api.mycompany.com:80/salesdemo. Jika Anda men-deploy API mycompany dengan URL dasar /, pengguna Anda akan mengakses API tersebut melalui URL http://api.mycompany.com:80/.

Persyaratan port edge

Kebutuhan untuk mengelola firewall tidak hanya terbatas pada host virtual; firewall VM dan host fisik harus mengizinkan traffic untuk port yang diperlukan oleh komponen agar dapat saling berkomunikasi.

Gambar berikut menunjukkan persyaratan port untuk setiap komponen Edge:

Catatan tentang diagram ini:

• * Port 8082 pada Message Processor hanya harus terbuka untuk akses oleh Router saat Anda mengonfigurasi TLS/SSL antara Router dan Message Processor. Jika Anda tidak mengonfigurasi TLS/SSL antara Router dan Message Processor, konfigurasi default, port 8082 masih harus terbuka di Message Processor untuk mengelola komponen, tetapi Router tidak memerlukan akses ke port tersebut.
• Port yang diawali dengan "M" adalah port yang digunakan untuk mengelola komponen dan harus terbuka pada komponen dan harus terbuka pada komponen untuk akses oleh Server Pengelolaan.
• Komponen berikut memerlukan akses ke port 8080 di Server Pengelolaan: Router, Message Processor, UI, Postgres, dan Qpid.
• Pemroses Pesan harus membuka port 4528 sebagai port pengelolaannya. Jika Anda memiliki beberapa Pemroses Pesan, semuanya harus dapat mengakses satu sama lain melalui port 4528 (ditunjukkan oleh panah loop dalam diagram di atas untuk port 4528 pada Pemroses Pesan). Jika Anda memiliki beberapa Pusat Data, port harus dapat diakses dari semua Message Processor di semua Pusat Data.
• Meskipun tidak wajib, Anda dapat membuka port 4527 di Router untuk akses oleh Message Processor apa pun. Jika tidak, Anda mungkin akan melihat pesan error di file log Message Processor.
• Router harus membuka port 4527 sebagai port pengelolaannya. Jika Anda memiliki beberapa Router, semuanya harus dapat saling mengakses melalui port 4527 (ditunjukkan oleh panah loop dalam diagram di atas untuk port 4527 di Router).
• Edge UI memerlukan akses ke Router, pada port yang diekspos oleh proxy API, untuk mendukung tombol Send di alat rekaman aktivitas.
• Server Pengelolaan memerlukan akses ke port JMX pada node Cassandra.
• Akses ke port JMX dapat dikonfigurasi untuk memerlukan nama pengguna/sandi. Lihat Cara Memantau untuk mengetahui informasi selengkapnya.
• Anda dapat mengonfigurasi akses TLS/SSL untuk koneksi tertentu, yang dapat menggunakan port yang berbeda. Lihat TLS/SSL untuk mengetahui informasi selengkapnya.
• Jika mengonfigurasi dua node Postgres untuk menggunakan replikasi master-standby, Anda harus membuka port 22 di setiap node untuk akses ssh. Secara opsional, Anda dapat membuka port pada setiap node untuk mengizinkan akses ssh.
• Anda dapat mengonfigurasi Server Pengelolaan dan UI Edge untuk mengirim email melalui server SMTP eksternal. Jika ya, Anda harus memastikan bahwa Server Pengelolaan dan UI dapat mengakses port yang diperlukan di server SMTP. Untuk SMTP non-TLS, nomor port biasanya adalah 25. Untuk SMTP yang mengaktifkan TLS, portnya sering kali adalah 465, tetapi tanyakan kepada penyedia SMTP Anda.

Tabel di bawah menunjukkan port yang perlu dibuka di firewall, berdasarkan komponen Edge:

curl -v http://routerIP:15999/v1/servers/self/reachable

Tabel berikutnya menampilkan port yang sama, yang tercantum secara numerik, dengan komponen sumber dan tujuan:

Pemroses pesan membuat kumpulan koneksi khusus tetap terbuka ke Cassandra, yang dikonfigurasi agar tidak pernah kehabisan waktu. Jika firewall berada di antara pemroses pesan dan server Cassandra, firewall dapat menghentikan koneksi. Namun, pemroses pesan tidak dirancang untuk membuat ulang koneksi ke Cassandra.

Untuk mencegah situasi ini, Apigee merekomendasikan agar server Cassandra, pemroses pesan, dan router berada di subnet yang sama sehingga firewall tidak terlibat dalam deployment komponen-komponen ini.

Jika firewall berada di antara router dan pemroses pesan, dan memiliki waktu tunggu tcp tidak ada aktivitas yang ditetapkan, rekomendasi kami adalah:

1. Tetapkan net.ipv4.tcp_keepalive_time = 1800 di setelan sysctl pada OS Linux, dengan 1800 harus lebih rendah dari waktu tunggu tcp tidak ada aktivitas firewall. Setelan ini akan menjaga koneksi dalam status aktif sehingga firewall tidak memutuskan koneksi.
2. Di semua Message Processor, edit /opt/apigee/customer/application/message-processor.properties untuk menambahkan properti berikut. Jika file tidak ada, buat file tersebut.

   conf_system_cassandra.maxconnecttimeinmillis=-1

3. Mulai ulang Message Processor:

   /opt/apigee/apigee-service/bin/apigee-service edge-message-processor restart

4. Di semua Router, edit /opt/apigee/customer/application/router.properties untuk menambahkan properti berikut. Jika file tidak ada, buat file tersebut.

   conf_system_cassandra.maxconnecttimeinmillis=-1

5. Mulai Ulang Router:

   /opt/apigee/apigee-service/bin/apigee-service edge-router restart

Jika Anda menginstal konfigurasi cluster 12 host dengan dua Pusat Data, pastikan node di kedua Pusat Data dapat berkomunikasi melalui port yang ditunjukkan di bawah:

Persyaratan port API BaaS

Jika Anda memilih untuk menginstal API BaaS, Anda akan menambahkan komponen API BaaS Stack dan API BaaS Portal. Komponen ini menggunakan port yang ditampilkan pada gambar di bawah:

Catatan tentang diagram ini:

• Portal API BaaS tidak pernah membuat permintaan langsung ke node BaaS Stack. Saat developer login ke Portal, aplikasi Portal akan didownload ke browser. Aplikasi Portal yang berjalan di browser kemudian membuat permintaan ke node Stack BaaS.
• Penginstalan produksi API BaaS menggunakan load balancer antara node Portal API BaaS dan node Stack API BaaS. Saat mengonfigurasi Portal, dan saat melakukan panggilan API BaaS, Anda menentukan alamat IP atau nama DNS load balancer, bukan node Stack.
• Semua node Stack harus membuka port 2551 untuk akses dari semua node Stack lainnya (ditunjukkan oleh panah loop dalam diagram di atas untuk port 2551 pada node Stack). Jika Anda memiliki beberapa Pusat Data, port harus dapat diakses dari semua node Stack di semua Pusat Data.
• Anda harus mengonfigurasi semua node Baas Stack untuk mengirim email melalui server SMTP eksternal. Untuk SMTP non-TLS, nomor port biasanya adalah 25. Untuk SMTP yang mendukung TLS, portnya sering kali adalah 465, tetapi tanyakan kepada penyedia SMTP Anda.
• Node Cassandra dapat dikhususkan untuk API BaaS, atau dapat digunakan bersama dengan Edge.

Tabel di bawah menunjukkan port default yang perlu dibuka di firewall, berdasarkan komponen:

Pemberian Lisensi

Setiap penginstalan Edge memerlukan file lisensi unik yang Anda dapatkan dari Apigee. Anda harus memberikan jalur ke file lisensi saat menginstal server pengelolaan, misalnya /tmp/license.txt.

Penginstal akan menyalin file lisensi ke /opt/apigee/customer/conf/license.txt.

Jika file lisensi valid, server pengelolaan akan memvalidasi masa berlaku dan jumlah Message Processor (MP) yang diizinkan. Jika salah satu setelan lisensi sudah tidak berlaku, Anda dapat menemukan log di lokasi berikut: /opt/apigee/var/log/edge-management-server/logs. Dalam hal ini, Anda dapat menghubungi Dukungan Apigee Edge untuk mengetahui detail migrasi.

Jika Anda belum memiliki lisensi, hubungi bagian penjualan Apigee.