Halaman ini diterjemahkan oleh Cloud Translation API.

Ringkasan Pemasangan Edge

Penginstalan Edge pada umumnya terdiri dari komponen Edge yang didistribusikan di banyak node. Setelah menginstal Edge pada node, Anda kemudian menginstal dan mengonfigurasi satu atau beberapa komponen Edge pada node.

Proses penginstalan

Menginstal Edge pada node merupakan proses multi-langkah:

Nonaktifkan SELinux pada node atau setel ke mode permisif. Lihat Menginstal utilitas penyiapan Edge apigee untuk mengetahui informasi selengkapnya.
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. Misalnya, Anda dapat menginstal Edge di 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.02.sh Edge ke /tmp/bootstrap_4.52.02.sh.
- Instal utilitas dan dependensi Edge apigee-service.
- Instal utilitas dan dependensi Edge apigee-setup.
  Lihat Menginstal utilitas penyiapan Edge apigee untuk informasi selengkapnya.
Gunakan utilitas apigee-setup untuk menginstal satu atau beberapa komponen Edge pada setiap node berdasarkan topologi yang Anda pilih.
Lihat Menginstal komponen Edge pada node.
Di node Management Server, gunakan utilitas apigee-setup untuk menginstal apigee-provision, utilitas yang Anda gunakan untuk membuat dan mengelola organisasi Edge.
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 merekomendasikan agar Anda menginstal UI Edge baru (dengan nama komponennya edge-management-ui), yang merupakan antarmuka pengguna yang ditingkatkan untuk developer dan administrator Apigee Edge untuk Private Cloud.

Untuk mengetahui informasi selengkapnya, lihat Menginstal UI Edge yang baru.

Setelah penginstalan selesai, lihat daftar tindakan pasca-penginstalan umum ini.

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 pengguna yang memiliki akses sudo penuh. Untuk akses sudo penuh, artinya pengguna memiliki akses sudo untuk melakukan operasi yang sama dengan root.

Setiap pengguna yang ingin menjalankan perintah atau skrip berikut harus merupakan root, atau menjadi pengguna dengan akses sudo penuh:

Utilitas apigee-service:
- Perintah apigee-service: install, uninstall, update.
- Perintah apigee-all: install, uninstall, update.
setup.sh untuk menginstal komponen Edge (Kecuali Anda telah menggunakan "apigee-service install" untuk 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". Ada banyak perintah Edge yang memanggil sudo agar dijalankan sebagai pengguna "apigee".

Setiap pengguna yang ingin menjalankan semua perintah selain yang ditampilkan di atas harus merupakan pengguna dengan akses sudo penuh ke pengguna "apigee". Perintah-perintah ini mencakup:

Perintah utilitas apigee-service, termasuk:
- Perintah apigee-service seperti start, stop, restart, configure.
- apigee-all seperti start, stop, restart, configure.

Membuat pengguna dengan akses sudo penuh ke pengguna "apigee"

CATATAN: Anda tidak dapat melakukan langkah ini sebelum menjalankan file bootstrap_4.52.02.sh untuk membuat pengguna "apigee".

Untuk mengonfigurasi pengguna agar memiliki akses sudo penuh ke pengguna "apigee", gunakan perintah "visudo" untuk mengedit file sudoers agar menambahkan:

installUser        ALL=(apigee)      NOPASSWD: ALL

Dengan installUser adalah nama pengguna dari orang yang menangani 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 ke "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 paling sederhana adalah melakukan seluruh proses penginstalan Edge sebagai root atau oleh pengguna yang memiliki akses penuh sudo, hal itu 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 dilakukan oleh root:
1. Download dan jalankan file bootstrap_4.52.02.sh:
```
curl https://software.apigee.com/bootstrap_4.52.02.sh -o /tmp/bootstrap_4.52.02.sh
sudo bash /tmp/bootstrap_4.52.02.sh apigeeuser=uName apigeepassword=pWord
```
  Langkah ini akan menginstal utilitas apigee-service dan membuat pengguna "apigee".
2. Konfigurasikan pengguna agar memiliki akses penuh sudo ke pengguna "apigee" seperti yang dijelaskan dalam Membuat pengguna dengan akses sudo penuh ke pengguna "apigee".
3. Instal utilitas apigee-setup:
```
/opt/apigee/apigee-service/bin/apigee-service apigee-setup install
```
4. 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 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.
Setelah pengguna root menginstal RPM Edge pada node, pengguna yang memiliki akses sudo penuh ke pengguna "apigee" akan menyelesaikan proses konfigurasi:
1. Gunakan utilitas setup.sh untuk menyelesaikan konfigurasi komponen Edge pada node. Bentuk perintah bergantung pada komponen yang Anda instal pada node. Untuk mengetahui 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 melakukan penginstalan lengkap, gunakan perintah berikut:
```
/opt/apigee/apigee-setup/bin/setup.sh -p aio -f configFile
```

Lokasi file konfigurasi penginstalan

Anda harus meneruskan file konfigurasi ke utilitas apigee-setup yang berisi informasi tentang penginstalan Edge. Satu-satunya persyaratan pada penginstalan senyap adalah file konfigurasi harus dapat diakses atau dibaca oleh pengguna "apigee". Misalnya, tempatkan file di 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 di command line.

Lihat Menginstal komponen Edge pada node untuk informasi selengkapnya.

Menangani kegagalan penginstalan

Jika terjadi kegagalan selama penginstalan komponen Edge, Anda dapat mencoba memperbaiki masalah tersebut, lalu menjalankan kembali penginstal. Penginstal dirancang untuk dijalankan berulang kali jika mendeteksi kegagalan, atau jika nanti 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 dijalankan.

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 RPM dan dependensi Edge.
Node tanpa koneksi Internet eksternal
Node tanpa koneksi Internet eksternal dapat mengakses versi cerminan 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 repositori di jaringan internal.

Catatan: Apigee tidak menghosting semua dependensi pihak ketiga di repositori publik kami. Anda harus mendownload dan menginstal dependensi ini dari repositori yang dapat diakses secara publik.

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 diinstal.

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.

Catatan: Namun, ada keuntungan lain dari menggunakan repo lokal, bahkan untuk node dengan koneksi internet eksternal. Saat menginstal Edge dari repositori publik Apigee, Anda akan selalu menginstal RPM Edge terbaru. Oleh karena itu, jika Anda 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 tersebut untuk melakukan penginstalan bagi semua versi Edge.

Misalnya, Anda terlebih dahulu menggunakan repo lokal untuk menginstal lingkungan pengembangan Edge. Kemudian, ketika Anda siap beralih ke lingkungan produksi, Anda perlu menginstal Edge lagi dari repo lokal. Dengan menginstal dari repo lokal, Anda menjamin bahwa lingkungan pengembangan dan lingkungan production akan cocok.

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 memperbaruinya untuk menambahkan RPM dari berbagai versi Edge. Lihat Menginstal utilitas penyiapan Edge apigee untuk informasi selengkapnya.

Menyelesaikan ketergantungan 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 ini tidak mencantumkan nomor versi eksplisit dari setiap dependensi.

Jika Anda melakukan penginstalan pada komputer yang memiliki akses internet, node dapat mendownload RPM dan dependensi yang diperlukan. Namun, jika menginstal dari node tanpa akses internet, biasanya Anda akan menyiapkan repo internal yang berisi semua dependensi yang diperlukan. Satu-satunya cara untuk menjamin bahwa semua dependensi disertakan dalam repo lokal Anda adalah dengan mencoba penginstalan, mengidentifikasi dependensi yang hilang, lalu 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 penginstalan pada node.

Hapus 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 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 Cloud.

File Log

File log untuk apigee-setup dan skrip setup.sh ditulis ke /tmp/setup-root.log.

File log untuk setiap komponen ditaruh di direktori /opt/apigee/var/log. Setiap komponen memiliki subdirektorinya 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: `/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 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", penginstal akan memeriksa apakah sistem memenuhi persyaratan CPU dan memori untuk komponen yang sedang diinstal. Nilai defaultnya adalah "n" untuk menonaktifkan pemeriksaan.