Penginstalan Edge umumnya terdiri dari komponen Edge yang didistribusikan di beberapa node. Setelah menginstal Edge pada sebuah node, Anda kemudian akan menginstal dan mengonfigurasi satu atau beberapa komponen Edge pada node tersebut.
Proses penginstalan
Menginstal Edge pada node adalah proses yang terdiri dari beberapa langkah:
- Nonaktifkan SELinux pada node atau setel ke mode permisif. Lihat Menginstal utilitas penyiapan apigee Edge untuk informasi selengkapnya.
- Tentukan apakah Anda ingin mengaktifkan autentikasi Cassandra.
- Tentukan apakah Anda ingin menyiapkan replikasi master-standby untuk Postgres.
- Pilih konfigurasi Edge Anda dari daftar topologi yang direkomendasikan. Misalnya, 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 ke/tmp/bootstrap_4.52.01.sh
. - Instal utilitas dan dependensi Edge
apigee-service
. - Instal utilitas dan dependensi Edge
apigee-setup
.Lihat Menginstal utilitas penyiapan apigee Edge untuk informasi selengkapnya.
- Download file
- Gunakan utilitas
apigee-setup
untuk menginstal satu atau beberapa komponen Edge di setiap node berdasarkan topologi yang Anda pilih. - Pada node Management Server, gunakan utilitas
apigee-setup
untuk menginstalapigee-provision
, utilitas yang Anda gunakan untuk membuat dan mengelola organisasi Edge.Lihat Mengaktivasi organisasi untuk mengetahui informasi selengkapnya.
- Mulai ulang komponen UI Klasik pada 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 merekomendasikan agar Anda menginstal UI Edge baru (yang nama komponennya adalah
edge-management-ui
), yang merupakan antarmuka pengguna yang ditingkatkan kualitasnya untuk developer dan administrator Apigee Edge untuk Private Cloud.Untuk mengetahui informasi selengkapnya, lihat Menginstal UI Edge baru.
Setelah penginstalan selesai, lihat daftar tindakan umum pasca-penginstalan ini.
Siapa yang dapat melakukan penginstalan
File distribusi Apigee Edge diinstal sebagai sekumpulan 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 menjadi root, atau pengguna dengan akses sudo penuh:
- 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 telah menggunakan
"
apigee-service install
" untuk menginstal RPM yang diperlukan. Kemudian akses root atau akses sudo penuh jika tidak diperlukan.) - Skrip update.sh untuk mengupdate komponen Edge
Selain itu, penginstal Edge akan membuat pengguna baru di sistem Anda, yang bernama "apigee". Banyak perintah Edge memanggil sudo untuk dijalankan sebagai pengguna "apigee".
Pengguna yang ingin menjalankan semua perintah selain yang ditampilkan di atas harus merupakan pengguna dengan akses sudo penuh ke pengguna "apigee". Perintah ini meliputi:
-
Perintah utilitas 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 pengguna "apigee"
Untuk mengonfigurasi pengguna agar memiliki akses sudo penuh ke pengguna "apigee", gunakan perintah "visudo" untuk mengedit file sudoers guna menambahkan:
installUser ALL=(apigee) NOPASSWD: ALL
Dengan installUser adalah nama pengguna orang yang menggunakan Edge.
Menetapkan izin pada file konfigurasi
File atau resource apa pun yang digunakan oleh perintah Edge harus dapat diakses oleh pengguna "apigee". Ini termasuk file lisensi Edge dan semua file konfigurasi.
Saat membuat file konfigurasi, Anda dapat mengubah pemiliknya menjadi "apigee:apigee" untuk memastikan bahwa file tersebut dapat diakses oleh perintah Edge:
- Buat file di editor sebagai pengguna mana pun.
chown
pemilik file menjadi "apigee:apigee" atau, jika Anda mengubah pengguna yang menjalankan layanan Edge dari pengguna "apigee", ubah file ke pengguna yang menjalankan layanan Edge.
Memisahkan tugas penginstalan Edge antara pengguna root dan non-root
Meskipun cara termudah untuk melakukan seluruh proses penginstalan Edge sebagai root atau oleh pengguna yang memiliki akses sudo penuh, hal ini tidak selalu memungkinkan. Sebagai gantinya, Anda dapat memisahkan proses menjadi tugas yang dilakukan oleh root dan tugas yang dilakukan oleh pengguna yang memiliki akses sudo penuh ke pengguna "apigee".
- Tugas yang dijalankan 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 pengguna "apigee". - Konfigurasikan pengguna agar memiliki akses sudo penuh ke pengguna "apigee" seperti yang dijelaskan dalam Membuat pengguna dengan akses sudo penuh ke pengguna "apigee".
- Instal utilitas
apigee-setup
:/opt/apigee/apigee-service/bin/apigee-service apigee-setup install
- Gunakan utilitas
apigee-setup
untuk menginstal RPM Edge pada 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 meliputi:
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 dengan akses sudo penuh ke pengguna "apigee" akan menyelesaikan proses konfigurasi:
- Gunakan utilitas
setup.sh
untuk menyelesaikan konfigurasi komponen Edge pada node. Bentuk perintah bergantung pada komponen yang Anda instal pada node. Untuk daftar lengkapnya, lihat Menginstal komponen Edge pada node.Misalnya, untuk menyelesaikan penginstalan ZooKeeper dan Cassandra, gunakan perintah berikut:
/opt/apigee/apigee-setup/bin/setup.sh -p ds -f configFile
Dengan configFile adalah file konfigurasi Edge.
Atau, untuk menjalankan 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 untuk penginstalan senyap adalah
file konfigurasi harus dapat diakses atau dibaca oleh pengguna "apigee". Misalnya, letakkan file
dalam direktori /usr/local/var
atau /usr/local/share
pada node dan
chown
ke "apigee:apigee".
Semua informasi dalam file konfigurasi diperlukan kecuali sandi administrator
sistem Edge. Jika Anda menghapus sandi, utilitas apigee-setup
akan meminta
Anda untuk memasukkannya pada command line.
Lihat Menginstal komponen Edge pada node untuk mengetahui informasi selengkapnya.
Menangani kegagalan penginstalan
Jika terjadi kegagalan selama penginstalan komponen Edge, Anda dapat mencoba memperbaiki masalah, lalu menjalankan penginstal lagi. Penginstal dirancang untuk dijalankan berulang kali jika mendeteksi kegagalan, atau jika nantinya Anda ingin mengubah atau mengupdate komponen setelah penginstalan.
Setelah menginstal atau mengupgrade, pastikan untuk memulai ulang komponen UI Edge pada setiap node tempat komponen tersebut berjalan.
Penginstalan selain internet atau internet
Untuk menginstal Edge pada sebuah node, node harus dapat mengakses repositori Apigee:
- Node dengan koneksi Internet eksternal
Node dengan koneksi internet eksternal mengakses repositori Apigee untuk menginstal RPM dan dependensi Edge.
- Node tanpa koneksi Internet eksternal
Node tanpa koneksi Internet eksternal dapat mengakses versi duplikasi repositori Apigee 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 menggunakan repositori lokal atau yang dicerminkan adalah untuk menginstal Edge pada node tanpa koneksi internet eksternal, seperti yang dijelaskan di bagian sebelumnya.
Menyelesaikan dependensi penginstalan RPM
File distribusi Apigee Edge diinstal sebagai sekumpulan file RPM, yang masing-masing dapat memiliki rantai dependensi penginstalannya sendiri. Banyak dari dependensi ini ditentukan oleh komponen pihak ketiga yang berada di luar kendali Apigee dan dapat berubah kapan saja. Oleh karena itu, dokumentasi tidak mencantumkan nomor versi eksplisit setiap dependensi.
Jika Anda melakukan penginstalan pada mesin yang memiliki akses internet, node dapat mendownload RPM dan dependensi yang diperlukan. Namun, jika menginstal dari node tanpa akses internet, Anda biasanya perlu menyiapkan repo internal yang berisi semua dependensi yang diperlukan. Satu-satunya cara untuk memastikan bahwa semua dependensi disertakan dalam repo lokal Anda adalah dengan mencoba penginstalan, mengidentifikasi dependensi yang hilang, dan menyalinnya ke repo lokal hingga penginstalan berhasil.
Perintah umum Yum
Alat penginstalan Edge untuk Linux mengandalkan Yum untuk menginstal dan mengupdate komponen. Anda mungkin harus menggunakan beberapa perintah Yum untuk mengelola penginstalan pada sebuah node.
- Bersihkan semua cache Yum:
sudo yum clean all
- Untuk mengupdate komponen Edge:
sudo yum update componentName
Contoh:
sudo yum update apigee-setup
sudo yum update edge-management-server
Struktur Sistem File
Edge akan menginstal semua file di direktori /opt/apigee
.
Dalam panduan ini dan di Panduan Operasi Edge, direktori penginstalan root dicatat sebagai:
/opt/apigee
Penginstalan ini menggunakan struktur sistem file berikut untuk men-deploy Apigee Edge untuk Private Cloud.
File Log
File log untuk apigee-setup
dan skrip setup.sh
ditulis ke
/tmp/setup-root.log
.
File log untuk setiap komponen berada dalam 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 menggunakan Nginx. Untuk log tambahan, lihat:
|
Message Processor |
/opt/apigee/var/log/edge-message-processor
|
Server Apigee Qpid |
/opt/apigee/var/log/edge-qpid-server
|
Server Apigee Postgres | /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 Apigee Qpid | /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", penginstal akan memeriksa apakah sistem memenuhi persyaratan CPU dan memori untuk komponen yang diinstal. Nilai defaultnya adalah "n" untuk menonaktifkan pemeriksaan.