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 pada node atau setel ke mode permisif. Lihat Instal utilitas apigee-setup Edge untuk banyak lagi.
- 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 mengetahui informasi selengkapnya.
- Pada setiap node dalam topologi yang Anda pilih, instal utilitas
apigee-setup
Edge:- Download file
bootstrap_4.52.01.sh
Edge untuk/tmp/bootstrap_4.52.01.sh
. - Instal utilitas dan dependensi Edge
apigee-service
. - Instal utilitas dan dependensi Edge
apigee-setup
.Lihat Menginstal Edge apigee-setup utilitas untuk mempelajari lebih lanjut.
- Download file
- Gunakan utilitas
apigee-setup
untuk menginstal satu atau beberapa komponen Edge di setiap komponen berdasarkan topologi yang Anda pilih. - Pada node Management Server, gunakan utilitas
apigee-setup
untuk menginstalapigee-provision
, utilitas yang Anda gunakan untuk membuat dan mengelola Edge tidak di organisasi lain.Lihat Aktivasi organisasi untuk mengetahui informasi selengkapnya.
- Mulai ulang komponen UI Klasik di setiap node setelah penginstalan selesai,
seperti yang ditunjukkan contoh berikut:
/opt/apigee/apigee-service/bin/apigee-service edge-ui restart
(Direkomendasikan) Setelah menyelesaikan penginstalan awal, Apigee menyarankan Anda untuk menginstal UI Edge baru (yang nama komponennya
edge-management-ui
), yang merupakan antarmuka pengguna developer dan administrator Apigee Edge untuk Private Cloud.Untuk mengetahui informasi selengkapnya, lihat Menginstal UI Edge yang baru.
Setelah instalasi selesai, lihat daftar tindakan umum pasca-penginstalan.
Siapa yang dapat melakukan penginstalan
File distribusi Apigee Edge diinstal sebagai serangkaian RPM dan dependensi. Kepada menginstal, meng-uninstal, dan mengupdate RPM Edge, perintah harus dijalankan oleh pengguna root atau oleh pengguna yang memiliki akses penuh {i>sudo<i}. Untuk akses {i>sudo penuh<i}, itu berarti pengguna memiliki akses {i>sudo<i} untuk melakukan operasi yang sama seperti {i>root<i}.
Setiap pengguna yang ingin menjalankan perintah atau skrip berikut harus menjadi {i>root<i}, atau menjadi pengguna dengan akses {i>sudo penuh<i}:
- Utilitas apigee-service:
- Perintah apigee-service:
install, uninstall, update
. - Perintah apigee-all:
install, uninstall, update
.
- Perintah apigee-service:
- skrip setup.sh untuk menginstal komponen Edge (Kecuali jika Anda sudah menggunakan
apigee-service install
" untuk menginstal RPM yang diperlukan. Kemudian {i>root<i} atau {i>full sudo<i} akses 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 panggil sudo untuk dijalankan sebagai "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
start, stop, restart, configure
. - apigee-all seperti
start, stop, restart, configure
.
- Perintah apigee-service seperti
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 dari orang yang menangani Edge.
Menetapkan izin pada 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.
chown
pemilik file ke "apigee:apigee" atau, jika Anda mengubah pengguna menjalankan layanan Edge dari "apigee" pengguna, ubah file ke pengguna yang menjalankan layanan Edge.
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.52.01.sh
:curl https://software.apigee.com/bootstrap_4.52.01.sh -o /tmp/bootstrap_4.52.01.sh
sudo bash /tmp/bootstrap_4.52.01.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 dalam Membuat pengguna dengan akses sudo penuh ke "apigee" .
- Instal utilitas
apigee-setup
:/opt/apigee/apigee-service/bin/apigee-service apigee-setup install
- Gunakan utilitas
apigee-setup
untuk menginstal Edge RPM di node:/opt/apigee/apigee-service/bin/apigee-service compName install
RPM Edge yang Anda instal pada node bergantung pada topologi Anda. Daftar komponen yang tersedia mencakup:
apigee-provision, apigee-validate, apigee-zookeeper, apigee-cassandra, apigee-openldap, edge-management-server, edge-ui, edge-router, edge-message-processor, apigee-postgresql, apigee-qpidd, edge-postgres-server, edge-qpid-server
.
- Download dan jalankan file
- Setelah pengguna root menginstal RPM Edge pada node, pengguna yang memiliki akses sudo penuh ke
"apigee" pengguna menyelesaikan proses konfigurasi:
- Gunakan utilitas
setup.sh
untuk menyelesaikan konfigurasi Edge komponen pada node. Bentuk perintah tergantung pada komponen yang Anda yang diinstal pada node. Untuk daftar lengkapnya, lihat Instal komponen Edge pada node.Misalnya, untuk menyelesaikan penginstalan ZooKeeper dan Cassandra, gunakan perintah berikut berikut:
/opt/apigee/apigee-setup/bin/setup.sh -p ds -f configFile
Dengan configFile adalah file konfigurasi Edge.
Atau, untuk melakukan penginstalan lengkap, gunakan perintah berikut:
/opt/apigee/apigee-setup/bin/setup.sh -p aio -f configFile
- Gunakan utilitas
Lokasi file konfigurasi penginstalan
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, letakkan file
di direktori /usr/local/var
atau /usr/local/share
pada 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 izin
Anda untuk memasukkannya
pada baris perintah.
Lihat Menginstal komponen Edge pada node untuk informasi selengkapnya.
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.
Setelah menginstal atau mengupgrade, pastikan untuk memulai ulang komponen UI Edge pada setiap node tempat aplikasi tersebut sedang berjalan.
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 pastikan Anda memiliki semua dependensi lain yang tersedia dari repositori jaringan.
Untuk membuat repositori Apigee internal, Anda memerlukan node dengan internet eksternal akses untuk dapat mendownload RPM dan dependensi Edge. Setelah Anda membuat repo internal, Anda dapat memindahkannya ke node lain atau membuat node tersebut dapat diakses oleh Edge {i>node<i} untuk instalasi.
Menggunakan repositori Edge lokal untuk mempertahankan versi Edge Anda
Salah satu alasan menggunakan repositori lokal atau yang dicerminkan adalah untuk menginstal Edge pada node tanpa koneksi internet eksternal, seperti yang dijelaskan di bagian sebelumnya.
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 {i>cache<i} Yum:
sudo yum clean all
- Untuk memperbarui komponen Edge:
sudo yum update componentName
Contoh:
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 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
ditulis ke
/tmp/setup-root.log
.
File log untuk setiap komponen berada di /opt/apigee/var/log
saat ini. Setiap komponen memiliki subdirektorinya sendiri. Misalnya, log untuk tim manajemen
Server 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 menggunakan Nginx. Untuk log tambahan, lihat:
|
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 klasik (bukan UI Edge baru, yang nama komponennya adalah
edge-management-ui ) |
/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/system.log |
Qpidd | /opt/apigee/var/log/apigee-qpidd |
Database PostgreSQL | /opt/apigee/var/log/apigee-postgresql |
apigee-monit |
/opt/apigee/var/log/apigee-monit |
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 |
apigee-monit |
/opt/apigee/data/apigee-monit |
Aktifkan pemeriksaan sistem saat penginstalan
File konfigurasi penginstalan Edge mendukung properti berikut:
ENABLE_SYSTEM_CHECK=y
Jika Anda menetapkan properti ini ke "y", {i>installer<i} akan memeriksa apakah sistem telah memenuhi CPU dan persyaratan memori untuk komponen yang akan diinstal. Nilai defaultnya adalah "n" menonaktifkan .