Edge for Private Cloud v. 4.17.05
Penginstalan Edge pada umumnya terdiri dari komponen Edge yang didistribusikan di banyak node. Setelah menginstal Edge pada node, Anda kemudian menginstal dan mengonfigurasi {i>node<i}.
Proses penginstalan
Menginstal Edge pada node merupakan proses multi-langkah:
- Nonaktifkan SELinux di node atau tetapkan ke mode permisif. Lihat Menginstal utilitas Edge apigee-setup untuk lainnya.
- Tentukan apakah Anda ingin mengaktifkan autentikasi Cassandra.
- Putuskan apakah Anda ingin menyiapkan replikasi master-standby untuk Postgres.
- Pilih konfigurasi Edge Anda dari daftar topologi yang direkomendasikan. Sebagai contoh, Anda dapat menginstal Edge pada satu node untuk pengujian, atau pada 13 node untuk produksi. Lihat Topologi Penginstalan untuk informasi selengkapnya.
- Di setiap node dalam topologi yang dipilih, instal utilitas apigee-setup Edge:
- Download file bootstrap_4.17.05.sh Edge untuk /tmp/bootstrap_4.17.05.sh.
- Instal utilitas dan dependensi apigee-service Edge.
- Instal utilitas dan dependensi apigee-setup Edge.
Lihat Menginstal utilitas penyiapan apigee Edge untuk mengetahui informasi selengkapnya.
- Gunakan utilitas apigee-setup untuk menginstal satu atau beberapa komponen Edge di setiap node berdasarkan topologi yang Anda pilih.
Lihat Menginstal komponen Edge di node di node. - Di node Management Server, gunakan utilitas apigee-setup untuk menginstal apigee-Provisioning,
utilitas yang Anda gunakan untuk membuat dan mengelola organisasi Edge.
Lihat Melakukan aktivasi organisasi untuk mengetahui informasi selengkapnya.
Siapa yang dapat melakukan penginstalan
File distribusi Apigee Edge diinstal sebagai serangkaian RPM dan dependensi. Untuk menginstal, meng-uninstal, dan mengupdate RPM Edge, perintah harus dijalankan oleh pengguna root atau oleh pengguna yang memiliki akses sudo penuh. Untuk akses sudo penuh, artinya pengguna memiliki akses sudo untuk melakukan operasi yang sama seperti root.
Setiap pengguna yang ingin menjalankan perintah atau skrip berikut harus memiliki akses root, atau menjadi pengguna dengan akses sudo penuh:
-
Utilitas apigee-service:
- Perintah apigee-service: install, uninstall, update.
- Perintah apigee-all: install, uninstall, update.
- skrip setup.sh untuk menginstal komponen Edge (Kecuali jika Anda sudah menggunakan "penginstalan layanan apigee" dapat menginstal RPM yang diperlukan. Kemudian root atau akses sudo penuh jika tidak diperlukan.)
- Skrip update.sh untuk memperbarui komponen Edge
Selain itu, penginstal Edge membuat pengguna baru di sistem Anda, bernama "apigee". Banyak perintah Edge memanggil sudo untuk dijalankan sebagai pengguna "apigee".
Setiap pengguna yang ingin menjalankan semua perintah selain yang ditampilkan di atas harus merupakan pengguna akses sudo penuh ke "apigee" . Perintah-perintah ini mencakup:
-
apigee-service, termasuk:
- Perintah apigee-service seperti mulai, berhenti, mulai ulang, konfigurasi.
- Perintah apigee-all seperti mulai, berhenti, mulai ulang, konfigurasi.
Membuat pengguna dengan akses sudo penuh ke "apigee" nama
Untuk mengonfigurasi pengguna agar memiliki akses sudo penuh ke "apigee" gunakan perintah "visudo" perintah ke edit file sudoers untuk menambahkan:
installUser ALL=(apigee) NOPASSWD: ALL
dengan installUser adalah nama pengguna milik orang yang bekerja dengan Edge.
Menyetel izin aktif file konfigurasi
Setiap file atau resource yang digunakan oleh perintah Edge harus dapat diakses oleh "apigee" . Ini menyertakan file lisensi Edge dan semua file konfigurasi.
Saat membuat file konfigurasi, Anda dapat mengubah pemiliknya menjadi "apigee:apigee" untuk memastikan bahwa dapat diakses menggunakan perintah Edge:
- Buat file di editor sebagai pengguna mana pun.
- Ubah pemilik file menjadi "apigee:apigee" atau, jika Anda mengubah pengguna yang menjalankan Edge layanan dari "apigee" pengguna, ubah file ke pengguna yang menjalankan Edge layanan.
Memisahkan Tugas penginstalan edge antara pengguna root dan non-root
Meskipun cara yang paling sederhana adalah melakukan seluruh proses instal Edge sebagai {i>root<i} atau oleh pengguna yang memiliki akses {i>sudo penuh<i}, hal itu tidak selalu memungkinkan. Sebagai gantinya, Anda dapat memisahkan menjadi tugas yang dilakukan oleh {i>root <i}dan tugas yang dilakukan oleh pengguna dengan akses sudo penuh ke "apigee" .
- Tugas yang dilakukan oleh root:
- Download dan jalankan file bootstrap_4.17.05.sh:
> curl https://software.apigee.com/bootstrap_4.17.05.sh -o /tmp/bootstrap_4.17.05.sh
> sudo bash /tmp/bootstrap_4.17.05.sh apigeeuser=uName apigeepassword=pWord
Langkah ini akan menginstal utilitas apigee-service dan membuat "apigee" . - Mengonfigurasi pengguna agar memiliki akses sudo penuh ke "apigee" pengguna seperti yang dijelaskan di atas.
- Instal utilitas apigee-setup:
> /opt/apigee/apigee-service/bin/apigee-service apigee-setup install - Gunakan utilitas apigee-setup untuk menginstal
RPM Edge di node:
> /opt/apigee/apigee-service/bin/apigee-service compName install
RPM Edge yang Anda instal di node bergantung pada topologi Anda. Daftar yang tersedia komponen meliputi: apigee-Provisioning, apigee-validate, apigee-zookeeper, apigee-cassandra, apigee-openldap, edge-ui, {i>edge-management-server<i}, {i>edge-ui<i}, {i>edge-router<i}, edge-message-processor, apigee-postgresql, apigee-qpidd, edge-postgres-server, edge-qpid-server.
- Download dan jalankan file bootstrap_4.17.05.sh:
-
Setelah pengguna root menginstal RPM Edge di node, pengguna dengan akses sudo penuh ke "apigee" pengguna menyelesaikan proses konfigurasi:
- Menggunakan setup.sh
untuk menyelesaikan konfigurasi
komponen Edge pada {i>node<i}. Bentuk dari
bergantung pada komponen yang
Anda instal pada {i>node<i}. Untuk daftar lengkapnya, lihat
Instal komponen Edge pada node.
Misalnya, untuk menyelesaikan penginstalan ZooKeeper dan Cassandra, gunakan perintah berikut perintah:
> {i>/opt/apigee/apigee-setup/bin/setup.sh -p ds -f<i} configFile
dengan configFile adalah file konfigurasi Edge.
Atau, untuk melakukan penginstalan lengkap, gunakan perintah berikut:
> {i>/opt/apigee/apigee-setup/bin/setup.sh -p aio -f<i} configFile
- Menggunakan setup.sh
untuk menyelesaikan konfigurasi
komponen Edge pada {i>node<i}. Bentuk dari
bergantung pada komponen yang
Anda instal pada {i>node<i}. Untuk daftar lengkapnya, lihat
Instal komponen Edge pada node.
Lokasi konfigurasi penginstalan file
Anda harus meneruskan file konfigurasi ke utilitas apigee-setup yang berisi informasi tentang penginstalan Edge. Satu-satunya persyaratan pada instalasi senyap adalah bahwa file konfigurasi harus dapat diakses atau dibaca oleh "apigee" . Misalnya, tempatkan file di direktori /usr/local/var atau /usr/local/share di node dan chown ke "apigee:apigee".
Semua informasi dalam file konfigurasi diperlukan kecuali untuk sistem Edge {i>password<i} administrator. Jika Anda menghilangkan sandi, utilitas apigee-setup akan meminta Anda untuk memasukkannya pada baris perintah.
Lihat Menginstal komponen Edge pada node untuk lainnya.
Menangani kegagalan penginstalan
Jika terjadi kegagalan selama pemasangan komponen Edge, Anda dapat mencoba memperbaiki masalah, dan kemudian jalankan {i>installer<i}-nya lagi. {i>Installer<i} dirancang untuk dijalankan berulang kali di saat mendeteksi kegagalan, atau jika nanti Anda ingin mengubah atau memperbarui komponen setelah penginstalan.
Internet atau penginstalan non-Internet
Untuk menginstal Edge pada node, node harus dapat mengakses repositori Apigee:
- Node dengan koneksi Internet eksternal
Node dengan koneksi internet eksternal mengakses repositori Apigee untuk menginstal Edge RPM dan dependensi. - Node tanpa koneksi Internet eksternal
Node tanpa koneksi Internet eksternal dapat mengakses versi duplikasi Apigee repositori yang Anda siapkan secara internal. Repositori ini berisi semua RPM Edge, tetapi Anda harus memastikan bahwa Anda memiliki semua dependensi lain yang tersedia dari repo di jaringan internal.
Untuk membuat repositori Apigee internal, Anda memerlukan node dengan akses internet eksternal agar dapat mendownload RPM dan dependensi Edge. Setelah membuat repo internal, Anda dapat memindahkannya ke node lain atau membuat node tersebut dapat diakses oleh node Edge untuk penginstalan.
Menggunakan repositori Edge lokal untuk mempertahankan versi Edge Anda
Salah satu alasan untuk menggunakan repositori lokal, atau yang dicerminkan, adalah untuk menginstal Edge di node tanpa koneksi internet eksternal, seperti yang dijelaskan di bagian sebelumnya.
Namun, ada keuntungan lain dari menggunakan repo lokal, bahkan untuk node dengan koneksi internet. Saat menginstal Edge dari repositori publik Apigee, Anda selalu menginstal RPM Edge terbaru. Oleh karena itu, jika ingin mendownload dan menyimpan RPM Edge untuk versi Edge tertentu, Anda harus membuat repo lokal untuk versi Edge tersebut. Anda kemudian dapat menggunakan repo lokal untuk melakukan instalasi pada semua versi Edge.
Misalnya, Anda terlebih dahulu menggunakan repo lokal untuk menginstal lingkungan pengembangan Edge. Lalu: ketika Anda siap untuk pindah ke lingkungan produksi, Anda kembali menginstal Edge dari ke dalam repositori tambahan. Dengan menginstal dari repo lokal, Anda menjamin bahwa pengembangan dan produksi lingkungan sesuai.
Repositori yang dicerminkan sangat fleksibel. Misalnya, Anda dapat membuat repo yang dicerminkan dari RPM Edge terbaru atau dari versi Edge tertentu. Setelah membuat repo, Anda juga dapat mengupdatenya untuk menambahkan RPM dari berbagai versi Edge. Lihat Menginstal utilitas Edge apigee-setup untuk lainnya.
Menyelesaikan ketergantungan penginstalan RPM
File distribusi Apigee Edge diinstal sebagai serangkaian file RPM, yang masing-masing dapat memiliki rantai dependensi instalasinya sendiri. Banyak dari dependensi ini ditentukan oleh pihak ketiga yang komponen yang berada di luar kendali Apigee dan dapat berubah kapan saja. Oleh karena itu, dokumentasi tidak mencantumkan nomor versi eksplisit dari setiap dependensi.
Jika Anda melakukan instalasi pada komputer yang memiliki akses internet, {i>node<i} dapat mengunduh RPM dan ketergantungan yang diperlukan. Namun, jika Anda menginstal dari node tanpa internet Anda biasanya menyiapkan repo internal yang berisi semua dependensi yang diperlukan. Satu-satunya cara untuk menjamin bahwa semua dependensi disertakan dalam repo lokal Anda adalah dengan mengidentifikasi dependensi yang hilang, dan menyalinnya ke repo lokal hingga penginstalan berhasil.
Perintah Yum yang umum
Alat penginstalan Edge untuk Linux mengandalkan Yum untuk menginstal dan mengupdate komponen. Anda mungkin harus menggunakan beberapa perintah Yum untuk mengelola instalasi pada sebuah {i>node<i}.
- Bersihkan semua cache Yum:
sudo yum clean all - Untuk mengupdate komponen Edge:
sudo yum update componentName
Misalnya:
sudo yum update apigee-setup
sudo yum update edge-management-server
Struktur Sistem File
Edge menginstal semua file di direktori /opt/apigee.
Dalam panduan ini dan dalam Panduan Operasi Edge, direktori penginstalan root telah dicatat sebagai:
/opt/apigee
Penginstalan menggunakan struktur sistem file berikut untuk men-deploy Apigee Edge untuk Private yang dihosting di Google Cloud.
File Log
File log untuk apigee-setup dan skrip setup.sh kini ditulis ke /tmp/setup-root.log.
File log untuk setiap komponen ada di direktori /opt/apigee/var/log. Setiap komponen memiliki subdirektori sendiri. Misalnya, log untuk Server Pengelolaan ada di direktori:
/opt/apigee/var/log/edge-management-server
Tabel berikut mencantumkan lokasi file log:
|
Komponen |
Lokasi |
|---|---|
|
Server Pengelolaan |
/opt/apigee/var/log/edge-management-server |
|
Router |
/opt/apigee/var/log/edge-router Router Edge diimplementasikan dengan menggunakan Nginx. Untuk log tambahan, lihat: /opt/apigee/var/log/edge-router/nginx /opt/nginx/logs |
|
Message Processor |
/opt/apigee/var/log/edge-message-processor |
|
Server Qpid Apigee |
/opt/apigee/var/log/edge-qpid-server |
|
Server Postgres Apigee |
/opt/apigee/var/log/edge-postgres-server |
|
UI Edge |
/opt/apigee/var/log/edge-ui |
|
ZooKeeper |
/opt/apigee/var/log/apigee-zookeeper |
|
OpenLDAP |
/opt/apigee/var/log/apigee-openldap |
|
Cassandra |
/opt/apigee/var/log/apigee-cassandra |
|
Qpidd |
/opt/apigee/var/log/apigee-qpidd |
|
Database PostgreSQL |
/opt/apigee/var/log/apigee-postgresql |
Data
|
Komponen |
Lokasi |
|---|---|
|
Server Pengelolaan |
/opt/apigee/data/edge-management-server |
|
Router |
/opt/apigee/data/edge-router |
|
Message Processor |
/opt/apigee/data/edge-message-processor |
|
Agen Qpid Apigee |
/opt/apigee/data/edge-qpid-server |
|
Agen Postgres Apigee |
/opt/apigee/data/edge-postgres-server |
|
ZooKeeper |
/opt/apigee/data/apigee-zookeeper |
|
OpenLDAP |
/opt/apigee/data/apigee-openldap |
|
Cassandra |
/opt/apigee/data/apigee-cassandra/data |
|
Qpidd |
/opt/apigee/data/apigee-qpid/data |
|
Database PostgreSQL |
/opt/apigee/data/apigee-postgres/pgdata |
Tugas setelah penginstalan
Setelah penginstalan selesai, Anda dapat melakukan tindakan tambahan pada komponen Edge.
Mengonfigurasi Edge komponen setelah penginstalan
Untuk mengonfigurasi Edge setelah penginstalan, Anda menggunakan kombinasi file .properties dan utilitas Edge. Sebagai misalnya, untuk mengonfigurasi TLS/SSL di UI Edge, Anda dapat mengedit file .properties untuk menyetel properti yang diperlukan. Perubahan pada file .properties mengharuskan Anda memulai ulang komponen Edge yang terpengaruh.
File .properties terletak di direktori /opt/apigee/customer/application. Setiap komponen memiliki file .properties sendiri di direktori tersebut. Misalnya, router.properties dan management-server.properties.
Untuk menetapkan properti bagi komponen, edit file .properties yang sesuai, lalu mulai ulang komponen:
> /opt/apigee/apigee-service/bin/apigee-service component restart
Contoh:
> /opt/apigee/apigee-service/bin/apigee-service edge-router restart
Saat Anda mengupdate Edge, file .properties di direktori /opt/apigee/customer/application akan dibaca. Artinya, update akan mempertahankan properti apa pun yang Anda tetapkan pada komponen.
Lihat Cara Mengonfigurasi Edge untuk informasi selengkapnya tentang Konfigurasi Edge.
Memanggil perintah di Edge komponen
Edge menginstal utilitas pengelolaan di /opt/apigee/apigee-service/bin yang dapat Anda gunakan untuk mengelola penginstalan Edge. Misalnya, Anda dapat menggunakan utilitas apigee-all untuk memulai, menghentikan, memulai ulang, atau menentukan status semua komponen Edge pada node:
/opt/apigee/apigee-service/bin/apigee-all stop|start|restart|status|version
Gunakan utilitas apigee-service untuk mengontrol dan mengonfigurasi setiap komponen. Utilitas apigee-service memiliki bentuk:
/opt/apigee/apigee-service/bin/apigee-service component action
Misalnya, untuk memulai ulang Router Edge:
/opt/apigee/apigee-service/bin/apigee-service edge-router restart
Anda dapat menentukan daftar komponen yang diinstal pada node dengan memeriksa direktori /opt/apigee. Direktori tersebut berisi subdirektori untuk setiap komponen Edge yang diinstal pada node. Setiap subdirektori diawali oleh:
- apigee - komponen pihak ketiga yang digunakan oleh Edge. Misalnya, apigee-cassandra.
- edge - komponen Edge dari Apigee. Misalnya, edge-management-server.
- edge-mint - Monetisasi komponen. Misalnya, edge-mint-management-server.
- baas - BaaS API komponen. Misalnya baas-usergrid.
Daftar lengkap tindakan untuk suatu komponen bergantung pada komponen itu sendiri, tetapi semua komponen mendukung tindakan berikut:
- mulai, hentikan, mulai ulang
- status, versi
- pencadangan, pemulihan
- instal, uninstal